Skip to content

Releases

v0.3.0 — 干支事实层

Choose a tag to compare

@xuemian168 xuemian168 released this 30 Oct 04:04
d4c5304

本版新增干支事实层:五行生克、十神、纳音这类有唯一正确答案的事实,一律由代码查表得出,模型只引用结果,不再凭记忆推。

背景

模型很少把"癸是水"说错,真正出错的是几步推导叠在一起的地方:生克方向说反,十神同时看五行和阴阳时算错,60 甲子的纳音记错,刑冲合害漏算或多算,还有算不出某一天是什么日柱。

此前 SKILL.md 已经规定纳音、关系矩阵、流日干支必须由代码计算,但 skill 本身没有提供任何实现。结果是这些事实要么标成 evidence_gap,要么被模型自己推出来。

核心机制

  • scripts/ganzhi/table.json:干支静态事实的唯一数据源,内容包括:

    • 十干的阴阳、五行,大小俗称(如癸为小水、丙为大火),通俗意象;
    • 十二支的五行、生肖、藏干;
    • 60 甲子纳音;
    • 生克两条循环,月令下的旺相休囚死;
    • 天干五合、四冲;
    • 地支六合、半合、三合、三会、冲、刑、害、破、自刑;
    • 五鼠遁,日柱推算锚点。
  • scripts/ganzhi_facts.py:输入命盘四柱,可选加大运、流年、流月、--date(流日)、--hour-branch(流时),输出:

    • 每柱的纳音,天干和藏干的十神;
    • 月令下的旺相休囚死;
    • 原局五行计数,"干支本身不见"和"连藏干也不见"分开写,防止随口判"缺火";
    • 柱间生克,统一写成"水 克 火"这种主语在前的格式,杜绝方向说反;
    • 全部刑冲合害。

    支持文本或 --json 输出。零依赖,仅用标准库。

python3 scripts/ganzhi_facts.py --chart 庚申 己丑 癸卯 壬子 --liunian 丙午 --liuyue 戊戌 --date today

工作流接入

  • SKILL.md 新增路由:问到生克、十神、阴阳大小、纳音、藏干、旺相休囚死、刑冲合害,或"今天对我怎样"时,先跑脚本,把输出放进证据包。不准凭记忆推,也不准拿着表格自己推理。
  • 主理规划师:四柱已确认、但缺纳音或关系矩阵时,改为调用脚本,不再标 evidence_gap。
  • 纳音、刑冲合害两位大师:认可脚本输出算作代码计算的事实。位置权重和关系强弱仍由大师判断。
  • bazi-domain-reference.md:明确它是给人读的版本,以 JSON 为准。

可靠性保证

  • 7 个日期的日柱和 60 甲子纳音,已和宿主项目使用的 lunar-javascript 逐一对照,全部一致。
  • tests/test_ganzhi_doc_sync.py 保证 bazi-domain-reference.md 里的表格与 JSON 一致,两份数据不会慢慢跑偏。
  • 另有测试核对表格本身的完整性:生克循环自洽,旺相休囚死能由规则推出,藏干本气的五行与地支五行一致。
  • 测试共 195 个(原有 166 个,新增 29 个),全部通过。

流派口径(写在表里,并随脚本输出)

  • 午未合记为土;合化是否成立属于解读,表里只记录"合"这个事实。
  • 半合只收含中神(子午卯酉)的两支,不收拱合。
  • 辰戌丑未整月按土旺计。
  • 日柱按 00:00 换日;晚子时的归属只在说明里标注,不替你选边。

如果你的流派习惯不同,改 table.json 一处即全局生效。

明确不做

  • 不计算年柱、月柱,因为它们依节气交接;也不计算大运和真太阳时。这些仍由宿主项目算好后通过参数传入。
  • 不把身强身弱、"大水还是小水"的整体判断写死进表格。"大/小"俗称只表示阳干阴干的质地,旺衰仍由旺衰派大师判断。

v0.2.0 — 古籍知识层

Choose a tag to compare

@xuemian168 xuemian168 released this 10 Sep 23:43

本版新增古籍知识层 —— 让典籍引用可被机器核对,而不是装饰。同时补上仓库此前缺失的 LICENSE。

背景

此前 skill 的知识层是空的:八个流派大师 prompt 的 "Knowledge Slice" 全部标注为「distilled from 项目自身文档」,知识来源自我循环;三个文件写着「不要装饰性引用书名」,但那条规则写于无书可引之时,实际等同于全面禁止引用。

结果是大师的推理形式受约束(不许重算、不许编造事实),但知识内容不受约束 —— 任何一句「此造身弱用印」都无法被追溯、核对或反驳。

核心机制

卡片声称某句原文位于 corpus/<文件>#L<起>-L<止>,由代码证明这件事。

  • scripts/validate_citations.py —— --cards 卡片库自检;--answer 校验大师输出 / 主理官综合 / 报告是否正当地使用了引用
  • scripts/search_classics.py —— 零依赖检索(中文 2-gram + TF 加权,不引 jieba)
  • references/classics/ —— 三向路由索引(主题 / 流派 / 典籍)、卡片契约、层级定义

零第三方依赖,仅标准库,166 个测试。

引用三层可见

层 机制
大师 citations / citation_fit 必填字段
主理官 四项审计义务 + 典籍进入源层级
报告 固定的「依据索引」章节

主理官源层级中,典籍被拆成两档分置于「方法适配」两侧 —— 核心论断压过方法适配,例证级低于方法适配。这是为了避免退化成「引了本书就赢」。

两层依据,分工不同

与既有的 references/xiangfa-system/ 并存而非替代:

  • 条文卡片:引文逐字对语料核验
  • 象法规则切片:带溯源,不做引文级核验

两者是不同字段(citations 对 supporting_evidence),不是二选一。架构图已按三种取用路径区分:卡片进证据包,象法切片由象法大师按需加载不进证据包,语料原文底库仅主理官核对引文时经 search_classics.py 触及。

经对抗性测试确认会被拒绝

输入 结果
引文在文件第 5 行、卡片声称第 3 行 拒绝(验的是行范围,不是「文件里有没有」)
引文差一个字 拒绝
引文只差标点 通过(正规化的用途)
语料被篡改但引文仍匹配 拒绝(sha256 独立于引文核对)
原文: …… 正规化后为空的占位符 拒绝
pattern_call: formal_pattern 仅靠「例证」级卡片支撑 拒绝,提示降级为 pattern_tendency

许可

新增 Apache-2.0,并在 NOTICE 中划出例外:

  • 古籍原文属公有领域,不在许可范围内 —— 本项目既不主张也不授予任何权利
  • 卡片的白话、适用前提、反例边界、层级判定,以及 references/ 提示词与 scripts/ 代码,均为原创,受许可覆盖
  • 现代整理本的标点、校勘、注释、译文属他人著作权,未纳入本仓库

本版范围

卡片库与语料目录按设计为空。 真实语料入库与卡片编纂属后续版本,本版先把校验链路跑通 —— 空库是合法状态(cards: 0 / VALID),当前所有大师的正确答案都是 no_classical_basis。

no_classical_basis 与真实引用同等合法、零惩罚。必填 citations 的意图是逼出「有没有依据」这个显式回答,不是逼出引用 —— 否则会诱发牵强引用,反而更不可靠。

明确不做

  • 不声称提高预测准确率。 命理判断不可证伪;本版可交付的是可追溯、可反驳、边界清楚。
  • 不为盲派象法伪造典籍支撑 —— 象法有自己的 xiangfa-system 溯源层,但那不是可逐字核验的典籍原文,两者不混为一谈。
  • 「孤证不立」不实现为脚本检查 —— 事件级判断无法从自由文本可靠分类,会漏判的检查制造虚假信心。它是 prompt 规则,orchestrator.md 明写「不由脚本检查」。
  • 不生成 PDF(沿用既有约束)。

已知缺口

  • pattern_call 分隔符类未穷尽:formal_pattern:正官格 等约六种装饰仍能绕过层级门禁
  • 大师输出若在 markdown 围栏里引用报告模板,仍会被误判为报告型输入并丢掉 citations 要求;checks_answer.py 中相关注释声称已覆盖此情形,实际没有
  • 引用契约目前覆盖 16 个大师中的 8 个 —— 上游后加的 6 个流派大师与规划师尚未接入
  • 典籍 字段仍是自由文本,未做校验(卡片前缀与语料文件已绑定)