merge full-data parity (三) independent annual method reference into staging (issue #93, BUG-1430/1431 renumbered to 1442/1443)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LutgzyJqNhPpZy1nFsJtN3
2026-10-26 22:28:00 +08:00
parent d0cf53c45a 19379fbb41
commit 24d6c9414d
29 changed files with 1739 additions and 57 deletions
@@ -17149,6 +17149,7 @@
 - 修复版本：本分支 `codex/special-lagnas-native-20261008`
 - Claude 验收（2026-10-08，Linux）：屏蔽 `jhora` 导入后跑 `cmd_full_reading`，乔布斯、奥巴马、虚构盘 × Lahiri / Raman 共 6 组，8 个点全部 `computed`、`source` 为 `native_special_lagna`，与 `fb8277bf` 调 PyJHora 的结果最大差 0°。Python 全量 62 条失败，与 `2df6ee72` 逐名相同；快速门通过；`tests/test_runtime_jhora_import_scan.py` 在快速门内，人为在 `native_special_lagnas.py` 加一行 `from jhora ...` 后该测试失败（变异检查）。年运资料包屏蔽 `jhora` 前后逐字节相同。
 - 待问占星师：Vighati 上升按每分钟 15° 计（与 PyJHora 一致）；按字面「每个 vighati 一个星座」应为每分钟 75°。
+- 决策推翻（2026-10-22，issue #93，不改本条状态）：产品决定生产镜像可以安装 PyJHora，但只给完整数据版最后一章「独立年度方法参考」用。调用放在单独的子进程里，父进程不加载它。八个特殊上升点仍走本条的本机算法，不改回进程内 PyJHora。AGPL 由产品接受。见 BUG-1427、BUG-1428。

 ## BUG-1274 | 中文报告把 Bhava Bala 译成年龄状态，并把 Planets 译成行星s

@@ -19350,6 +19351,38 @@
 - 复发自：无
 - 修复版本：分支 `codex/full-data-parity-1-20261021`。

+## BUG-1427 | 装上 PyJHora 后，对话交叉验证会在接口进程里加载它
+
+- 状态：resolved
+- 首次发现：2026-10-23
+- 最近更新：2026-10-23
+- 影响面：对话编排里的外部引擎交叉验证。完整数据版最后一章不走这条路径。
+- 用户现象：生产镜像一旦装上 PyJHora，对话在同一进程里探测并加载它。岁差和星历路径会被改掉，同一时刻的月亮经度不再稳定。
+- 触发条件：镜像含 PyJHora，且对话走到交叉验证。
+- 根因：产品路径用「能不能导入 jhora」决定要不要调用。装上之后探测成功，接着在接口进程里导入。
+- 修复：产品报告固定写成今天没装 PyJHora 时的结果，不探测、不导入。命令行诊断工具仍按原样报告是否可用。
+- 验证：`tests/test_pyjhora_annual_method_reference.py` 把探测函数换成会失败的替身，产品报告仍不调用它。`tests/test_unified_consultation_orchestrator.py` 的适配器状态仍是缺少 jhora 模块。`tests/test_pyjhora_adapter_diagnostics.py` 命令行行为不变。
+- 防复发：上面几条。产品路径再调用探测，测试会失败。
+- 相关记录：issue #93。BUG-1273、BUG-1428。
+- 复发自：无
+- 修复版本：分支 `codex/full-data-parity-3-20261022`。
+
+## BUG-1428 | 装上 PyJHora 后，校正三引擎包会在接口进程里加载它
+
+- 状态：resolved
+- 首次发现：2026-10-23
+- 最近更新：2026-10-23
+- 影响面：校正用的三引擎对照包里的 PyJHora 一行。生时校正打分本身不走这条路径。
+- 用户现象：生产镜像一旦装上 PyJHora，这行对照在接口进程里导入它，星盘其余数字可能被带着变。
+- 触发条件：镜像含 PyJHora，且组装三引擎对照包。
+- 根因：这一行直接导入 PyJHora。没装时得到「没有这个模块」；装上之后导入成功，计算发生在父进程。
+- 修复：产品路径固定抛出「没有这个模块」，不执行导入。对照行仍是今天没装时的那一行。
+- 验证：`tests/test_pyjhora_annual_method_reference.py` 检查这段源码没有导入语句，调用时得到模块缺失。封存合同测试 `tests/test_sealed_holdout_contract_freshness.py` 与 `tests/test_rectification_validation_integrity_gate.py` 仍通过。
+- 防复发：上述源码断言。再写回进程内导入，测试会失败。
+- 相关记录：issue #93。BUG-1273、BUG-1427。
+- 复发自：无
+- 修复版本：分支 `codex/full-data-parity-3-20261022`。
+
 ## BUG-1429 | 1970 年以前的研究章日出在 Windows 上把整份报告打崩

 - 状态：resolved
@@ -19561,4 +19594,35 @@
 - 修复版本：分支 `codex/gate-birth-journey-contract-20261025`。
 - 断言三栏：原值是渲染后等 10 毫秒就开始数帧，失败只印 `1 !== 0`；新值是先载入拖拽名单和账户菜单，侧栏安静后再数，失败时写明哪一个计数；原因是第一次补画不是流式帧。期望值没有放宽，60 帧内注册和提交仍是 0。

+## BUG-1442 | 独立年度方法参考不进结果指纹，重算对不上
+
+- 状态：resolved
+- 首次发现：2026-10-23
+- 最近更新：2026-10-24
+- 影响面：完整数据版资料包的结果指纹。阅读页正文不直接显示这串指纹。
+- 用户现象：报告里已经有「独立年度方法参考」，按同一份资料包重算指纹却对不上。防篡改核对会把这份报告看成被改过。
+- 触发条件：完整数据版组装资料包时挂上这一章，绑定指纹之前先把这一章摘掉，绑定后再放回去。
+- 根因：指纹故意不算这一章。允许排除的只有三类字段，这一章不在其中。重算时本章还在，所以两边不一致。
+- 修复：删掉摘除再放回的做法，恢复直接绑定。这一章算进指纹。标准版在已经知道版本之后才决定要不要算这一章，避免标准版白起一次计算；完整数据版仍在绑定之前挂上，指纹才算得到它。
+- 验证：`tests/test_pyjhora_annual_method_reference.py` 中两个不同标记的指纹不再相同。`tests/test_calculation_profile_contract.py` 仍要求绑定写在净化之后。`tests/test_report_reference_perf.py` 重算指纹与包上的指纹一致。
+- 防复发：上面三条。再把本章摘出指纹，标记不同却指纹相同的测试会失败，重算也对不上。
+- 相关记录：BUG-693、BUG-694。issue #93 第 1 次打回。本分支曾写成 BUG-1429；该号已由 staging 的研究章日出记录使用，合并时改为 1430。
+- 复发自：无
+- 修复版本：分支 `codex/full-data-parity-3-20261022`。
+
+## BUG-1443 | 完整数据版新选项没接到两处测试替身
+
+- 状态：resolved
+- 首次发现：2026-10-24
+- 最近更新：2026-10-24
+- 影响面：只影响测试。报告计算和阅读页没有改。
+- 用户现象：无。验收时两条测试报 `TypeError: unexpected keyword argument 'include_annual_method_reference'`。
+- 触发条件：组装报告时把这个选项传给资料包函数，测试却用只收位置参数的替身换掉了原函数。
+- 根因：上一轮有 4 个替身加了 `**_kwargs`，漏了阅读附录语言测试和报告密度测试里的两个。
+- 修复：这两处替身同样加上 `**_kwargs`。不改报告计算，不改原有断言。
+- 验证：`tests/test_reader_appendix_language.py::test_public_boundary_only_leaves_internal_renderer_and_json_unchanged` 与 `tests/test_report_density_facts.py::test_full_golden_shared_markdown_is_byte_identical_and_reader_copy_is_clean`。
+- 防复发：`tests/` 里替换这个函数的替身都要能接收额外关键字。再漏一处，同样的类型错误会让测试失败。
+- 相关记录：issue #93 第 2 次打回。BUG-1442。
+- 复发自：无
+- 修复版本：分支 `codex/full-data-parity-3-20261022`。

@@ -0,0 +1,159 @@
+# PROGRESS — 完整数据版独立年度方法参考（#93）
+
+基线是已合入 #91 的 `origin/staging` `85e8adddbc9c14e31c687c91ad8666afe3290e64`。#92 没有合入 staging。没有收到「照上游原样」，D6 用默认：当地时间，Patyayini / Tajika 用「年龄 + 1 年」，Mudda 仍用年龄。
+
+## 做了什么
+
+完整数据版报告最后多了一章「独立年度方法参考」。这一章在单独的子进程里用 PyJHora 算请求年及后两年。父进程不加载 PyJHora。对话卡、校正和前面的本机年运仍按没装 PyJHora 时的结果。标准报告没有这一章。
+
+某一年某一张表算不出来时，该表写「未获得结果」，不把内部原因印进报告。
+
+## 换路径开关
+
+| 编号 | 处理 |
+| --- | --- |
+| S1 | 产品路径不启动子进程，仍返回原来的年运结果。研究脚本明确要求时才计算。测试里的旧替身只有 4 个参数，不会把整章打成未判定。 |
+| S2 | 对话交叉验证不探测、不导入。命令行诊断仍可报告是否装了。 |
+| S3 | 校正三引擎对照固定返回「没有这个模块」，不在接口进程里导入。 |
+| S4 | 部署文件不设置 `JYOTISH_YEAR_LORD_PYJHORA_REFERENCE`。Dockerfile 与工作流没改。 |
+| S5 | 没有新增被禁止的那两个模块。 |
+| S6 | 诊断脚本会显示 PyJHora 可用。它们不在产品路径上，没改。 |
+| S7 | 见下面的测试。装上之后这些用例会真跑，不再跳过。 |
+
+## 装与不装
+
+同一进程里，虚构盘 0 连续 5 次：去掉本章后的中文、英文各自哈希不变。父进程没有加载 jhora。英文汉字为 0。
+
+把「找不到 jhora」的拦截放进子进程后，再用同一个进程哈希种子重跑虚构盘 0、1、9：去掉本章后的中文和英文与装上时逐字相同。资料包去掉新键、生成时刻和缓存时刻后，只剩报告引用号。引用号来自结果指纹。结果指纹现在不把这一章算进去，所以装与不装的引用号一致。
+
+不固定哈希种子时，虚构盘 0 的太阳相位力量会差 0.01，虚构盘 1 的第一条王者格句子会换成另一条。这是既有代码用集合遍历，顺序随进程变化，不是这一章引入的。同一进程里的 5 次中文哈希相同。本轮没有改那两处旧代码。
+
+开工前的「改代码之前」对照没有量成。当时的测量停在星历下载，不能当作装与不装的差异清单。上面是改完之后的对照。
+
+## 两种年份口径（虚构盘）
+
+文档口径是本轮采用的默认。上游口径是世界时、并且年份不加 1。只列回归时刻和 Mudda 第一段起点，没有出生资料。小数小时已折成秒。
+
+| 虚构盘 | 岁差回读 | 交点 | 文档口径回归 | 上游口径回归 | 文档口径 Mudda 起点 | 上游口径 Mudda 起点 | 这次子进程秒数 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 0 | RAMAN，一致 | 平交点 | 2026-07-19 08:55:02 | 2025-07-18 23:19:06 | 2026-07-08 02:01:59 | 2026-07-10 19:12:54 | 50.057 |
+| 1 | LAHIRI，一致 | 平交点 | 2026-07-01 06:18:58 | 2025-06-30 21:05:13 | 2026-06-17 18:10:07 | 2026-06-21 00:36:03 | 52.986 |
+| 9 | RAMAN，一致 | 平交点 | 2026-05-08 23:36:33 | 2025-05-09 00:22:13 | 2026-04-29 06:01:58 | 2026-04-23 10:30:48 | 50.567 |
+
+这三次为了对照多算了一遍上游口径，所以比正式出报告的那一次更慢。虚构盘 0 上，正式计算复用同一次年盘，三次复用都与再算一次相同（此前已测）。
+
+## 时长（Windows，虚构盘 0，5 次）
+
+中文先渲染会把中文句子写进资料包，接着的英文会被判成有汉字而整份撤回。计时已改成英文使用渲染前的副本。下表是改完之后的数。第一次作废的英文时长不采用。
+
+| 项目 | 中位 | 最大 |
+| --- | --- | --- |
+| 只出中文 | 54.873 秒 | |
+| 只出英文（含同一次排盘） | 47.344 秒 | |
+| 中英一起 | 57.034 秒 | 59.013 秒 |
+
+排盘约 45.183 秒，中文排版 9.690 秒，英文排版 2.161 秒。中文约 821290 字，英文约 1358880 字。本章中文约 38313 字，英文约 44551 字。
+
+虚构盘 1 中英一起 78.568 秒，虚构盘 9 为 85.168 秒。三张都低于 180 秒。Linux 是否仍低于 180 秒由 Claude 复测。
+
+## 镜像
+
+本地镜像 `jyotisha-api:parity3-20261023`，`docker image inspect` 的 Size 为 932044815 字节。本机没有更早的 `jyotisha-api` 镜像，无法写增量。`docker history` 里安装依赖的那一层约 345MB。容器内可以导入 jhora、swisseph、geocoder、geopy。`pip show pyswisseph` 为 2.10.3.2。`pip check` 无冲突。Dockerfile 没改。
+
+`docker stats` 按让步没测。子进程工作集在这台 Windows 上的采样一直停在约 4.4MB，空进程也是这个数，不能当成峰值。峰值留给 Linux 复测。
+
+## 改过的断言
+
+| 测试 | 原值 | 新值 | 原因 |
+| --- | --- | --- | --- |
+| 阅读页三处泄漏检查 | 全文不得出现 PyJHora | 先去掉「独立年度方法参考」再查 | 这一章必须写来源 |
+| 英文泄漏检查 | 英文全文不得出现 PyJHora | 先去掉 Independent Annual Method Reference 再查 | 同上 |
+
+## 本轮跑过的检查
+
+- 结果指纹不包含这一章：通过。
+- 四参数替身仍能接到年运，不把整章打成未判定：通过。
+- 阅读页、英文版、完整数据章、子进程门禁：在加上结果指纹排除之前已通过（约 291 秒那一轮，外加更早的三张盘真算约 288 秒）。
+- 封存合同与校正完整性：在四参数修复之前的那一轮通过。本轮没重跑。
+- 全量 pytest 和快速门没跑，留给 Claude。
+- 隐私标记、导入扫描、结果指纹，以及 S7 的 Ashtakavarga 与三份大运对照：退出码 0，约 33 秒。
+
+## 偏离
+
+- T0 到 T6 放在同一次提交。章节标题测试要等渲染和依赖同时在，拆开会红。
+- 没装的环境用启动时拦截 `jhora`，没有另建一套虚拟环境。
+- 子进程超时是 120 秒。45 秒会在这台机器上把已经算完的三年掐掉。
+- 没做容器内存曲线。
+- 开工前的基线对照没有形成可用数字。
+
+## 第 1 次打回（2026-10-23）
+
+合并了当时的 `origin/staging`（含修复单 `4d0e398ab`）。没有重做上一轮已经通过的隔离和三年表。
+
+这一章现在算进结果指纹。不再先摘掉、绑定后再放回去。两份只差这一章内容的资料包，指纹不再相同。报告里有这一章时，按同一份资料包重算，能对上。
+
+比较「去掉这一章之后，装与不装是否逐字相同」时，先把下面两行换成同一个占位符 `FINGERPRINT`，再比：
+
+- `- 报告 ID: \`...\``
+- `- 计算结果摘要: \`...\``
+
+这两行来自结果指纹。指纹把这一章算进去之后，它们本来就会变。其余行不抹。
+
+标准版在已经知道「不是完整数据版」之后，不再去算这一章。完整数据版仍在写入指纹之前挂上这一章，所以指纹里有它。直接生成完整数据资料包的旧入口默认仍会算，阅读页和扫描不变。
+
+部署说明不再写出年主对照开关的变量名，只说不要打开这个开关。
+
+子进程超时仍是 120 秒。这是上限，不是目标。前端整份报告最多等 180 秒；120 秒加上其余排盘和排版，在 Linux 上实测整份约 20 秒，没有顶到 180 秒。这台 Windows 电脑上中英一起最高约 59 秒，也没有顶到。
+
+### 改过的断言
+
+| 测试 | 原值 | 新值 | 原因 |
+| --- | --- | --- | --- |
+| 结果指纹是否包含这一章 | 两个标记的指纹相同 | 两个标记的指纹不同，本章仍留在资料包里 | 交付包里有这一章时，重算必须对得上（BUG-1442；1429 已由研究章日出占用） |
+
+编号：BUG-1442。本分支原先写成 BUG-1429，合并 staging 时改号。
+
+## 这一轮跑过的检查
+
+| 检查 | 命令 | 结果 |
+| --- | --- | --- |
+| 修复单点名的测试，去掉两次真算 PyJHora | 指纹、合同、阅读页、英文版、年主、Tajika、增长、卫生等 | 退出码 0，约 460 秒 |
+| 三张虚构盘真算 PyJHora，以及父进程月亮位置不变 | 两个隔离测试 | 退出码 0，129 秒 |
+| 200 张英文扫描 | 扫描里不启动 PyJHora 子进程 | 退出码 0，1362 秒 |
+| 全量 pytest 和快速门 | 未跑 | 留给验收 |
+| 前端 | 本轮没改页面 | 没跑 |
+
+依赖的 staging 提交是合并进来的 `4d0e398ab`。
+
+## 第 2 轮（2026-10-24）
+
+产品选 B。合并了当时的 `origin/staging`（`0f66d92d4`）。没有重做上一轮已经通过的隔离和三年表，也没有改报告计算。
+
+两处测试替身补上 `**_kwargs`，和已经改过的 4 处一样：
+
+- `tests/test_reader_appendix_language.py`
+- `tests/test_report_density_facts.py`
+
+`tests/` 里其余替换这个函数的替身，本来就能接收额外参数，没有再改。原有断言没有改。
+
+合并之后，研究章仍在六章后面、口径替换前面。独立年度方法参考仍在口径替换后面，避免来源那一行被删掉。六章测试同时认这两段后加的标题。
+
+### 改过的断言
+
+| 测试 | 原值 | 新值 | 原因 |
+| --- | --- | --- | --- |
+| 六章后面的二级标题 | 本分支只认六章再加最后的年度方法参考 | 六章之后先是研究章，最后仍是年度方法参考 | 合并 #92 后研究章插在中间 |
+
+编号：BUG-1443。指纹那条改为 BUG-1442，因为 BUG-1429 已是研究章在 1970 年以前的日出记录。
+
+## 第 2 轮跑过的检查
+
+| 检查 | 命令 | 结果 |
+| --- | --- | --- |
+| 两条打回的测试 | `pytest` 点名这两条 | 2 通过，退出码 0 |
+| 六章、年度方法参考、计算合同、阅读页泄漏、结果性能 | 同上五个测试文件，阅读页只跑泄漏相关两条 | 72 通过，3 跳过，退出码 0。3 条跳过是计算合同里原有的「产品树未附带」，不是本轮新跳过 |
+| 200 张英文扫描 | `pytest tests/test_report_english_sweep.py::test_two_hundred_fictional_charts_have_clean_english` | 1 通过，退出码 0。扫描不真起 PyJHora |
+| 全量 pytest 和快速门 | 未跑 | 留给验收 |
+| 前端 | 本轮没改页面 | 没跑 |
+
+依赖的 staging 提交是 `0f66d92d4d6545972202f209c63c87959d44b87e`。
@@ -528,8 +528,8 @@
 | `TASK-full-data-parity-2-fix-20261023.md` | `PROGRESS-full-data-parity-2-20261021.md` | **#92 第 1 次打回**：其余全过（Linux 生成约 18 秒、英文汉字 0）；T5 已用 10 张虚构盘做完离线对照，不一致的体系在标题下写明差在哪一类 | 已合入 staging | `codex/full-data-parity-2-20261021` |
 | `TASK-goel-jaimini-strength-20261022.md` | `PROGRESS-goel-jaimini-strength-20261022.md` | #94 搬上游公开的 Goel Jaimini 强度与 Brahma / Maheshwara / Rudra（4 个上游原样文件，按 #81 决策 A 先例根目录预算 448→452；来源串改书目引用）；只做计算、不改报告；冻结身份不变 | 已合入 staging | `codex/goel-jaimini-strength-20261022` |
 | `TASK-chart-subject-table-fix-20261022.md` | `PROGRESS-chart-subject-table-fix-20261022.md` | **#86 第 1 次打回**：报告所有表被强制单行（打印跑出纸面）；保存他人复制了档案页代码且已分叉；点编辑框内边距会丢修改 | 已合入 staging | `codex/chart-subject-table-20261021` |
-| `TASK-full-data-parity-3-20261022.md` | — | #93 完整数据版补齐（三）：「独立年度方法参考」正式环境调 PyJHora（子进程隔离；装上后其余输出逐字节不变，7 个换路径开关钉死）；输入默认用本地时间与正确年份（D6 待产品确认） | 待领取（等 #91 合入） | `codex/full-data-parity-3-20261022` |
-| `TASK-full-data-parity-3-fix-20261023.md` | `PROGRESS-full-data-parity-3-20261022.md` | **#93 第 1 次打回**：功能、隔离、速度都过（Linux 约 20 秒，worker 约 60 MB）；结果指纹排除本章致重算对不上（违反 D2）、源码合同测试没跟改、自己的新测试与 deploy README 打架 | 待执行 | `codex/full-data-parity-3-20261022` |
+| `TASK-full-data-parity-3-20261022.md` | `PROGRESS-full-data-parity-3-20261022.md` | #93 完整数据版补齐（三）：「独立年度方法参考」正式环境调 PyJHora（子进程隔离；装上后其余输出逐字节不变，7 个换路径开关钉死）；输入默认用本地时间与正确年份（D6 默认，未收到「照上游原样」） | 已合入 staging | `codex/full-data-parity-3-20261022` |
+| `TASK-full-data-parity-3-fix-20261023.md` | `PROGRESS-full-data-parity-3-20261022.md` | **#93 第 2 次打回**：两处测试替身补上额外参数（BUG-1443）。指纹记录在合并后改称 BUG-1442 | 已合入 staging | `codex/full-data-parity-3-20261022` |
 | `TASK-synastry-staging-fix-fix-20261022.md` | `PROGRESS-synastry-staging-fix-fix-20261022.md` | **#85 第 1 次打回**（T7～T11 主体通过）：新地址没登记进路由清单致快速门红；CHANGELOG 与 T11 矛盾；侧栏点亮测试是空断言 | 已合入 staging | `codex/synastry-staging-fix-20261021` |
 | `TASK-report-english-han-leak-fix-20261022.md` | `PROGRESS-report-english-han-leak-fix-20261022.md` | **#89 第 1 次打回**：改了冻结的校正打分文件 `jaimini.py`；测试的 PyJHora 屏蔽没传到子进程（测的不是生产那份报告，也是慢的原因）；缺英文时留空藏住漏洞 | 已合入 staging | `codex/report-english-han-leak-20261021` |
 | `TASK-full-data-parity-1-fix-20261022.md` | `PROGRESS-full-data-parity-1-fix-20261022.md` | **#91 A 段第 1 次打回**：新六章 69 节里 16 节在三张虚构盘上整节「未判定」，其中 12 节数据在资料包里、是读错了字段；测试抓不到整节未判定；新六章绕过了报告口径替换；中文附录悄悄丢列和瑜伽条目要量出来 | 已合入 staging | `codex/full-data-parity-1-20261021` |
@@ -0,0 +1,11 @@
+# 完整数据版「独立年度方法参考」真机验收
+
+用虚构盘或公开名人盘。不要把真实出生资料写进记录。
+
+1. 打开一份完整数据版报告，翻到最后。最后一章标题是「独立年度方法参考」。
+2. 这一章有请求年、后一年、再后一年。每年都能看到来源是 PyJHora，以及 Mudda 两张表、Patyayini、Tajika。
+3. 某一格算不出来时，那一格写「未获得结果」，整份报告仍然能打开。
+4. 切换到英文。同一章标题是 Independent Annual Method Reference。英文里没有汉字。来源行是 Source: PyJHora。
+5. 导出 `.md`。最后一章仍在文件末尾。
+6. 打开一份这次更新之前生成的旧报告。它仍然能从列表打开，内容不因为这章而打不开。
+7. 打开一份标准报告（不是完整数据版）。没有「独立年度方法参考」这一章。