docs: functional v2 wrap-up — BUG-1158 resolved, BUG-1180～1182, ERR-114, backtest round 5, progress

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N4f2nya58RoRu4yEmJgRGE

docs/BUG_HISTORY.md

@@ -15577,7 +15577,7 @@
 
 ## BUG-1158 | 功能吉凶层把命主一律标成 yogakaraka，10 宫主太阳在天蝎上升标中性
 
-- 状态：investigating（部分修复：yogakaraka 定义已改并合入 `codex/consult-career-yoga-functional-20261002`；吉凶分组仍是 v1 公式，BPHS 第 34 章全表待占星顾问）
+- 状态：resolved（2026-10-02 产品采纳上游功能吉凶 profile v2，见本条末「决策日志（第三次）」；生时校正算法身份随之升到 scoring-10，见 BUG-1181）
 - 首次发现 / 最近更新：2026-10-01 / 2026-10-02
 - 影响面：`scripts/functional_benefics.py` `derive_functional_benefic_malefic`（`SOURCE = strict_functional_benefic_malefic_v1`，2026-06-28 `09817b96` 引入）；所有读功能吉凶的地方（数据卡、Technique Audit、报告）。
 - 现象：泰勒盘（天蝎上升）火星（1、6 宫主）标 yogakaraka、太阳（10 宫主）标中性；同一规则下奥巴马（摩羯上升）土星（1、2 宫主）、乔布斯（处女上升）水星（1、10 宫主）也是 yogakaraka。
@@ -15590,7 +15590,9 @@
 - 复发自：无
 - 决策日志（2026-10-02）：产品 D1（`TASK-consult-career-yoga-functional-20261002`）推翻 `strict_functional_benefic_malefic_v1`：yogakaraka 只认同时主角宫（4、7、10）与三方宫（5、9）的单颗星；12 个上升按 BPHS 第 34 章逐上升写死。实现 `1d039429`（分支 `codex/consult-career-yoga-functional-t1-20261002`）：`BPHS_CH34_TABLE` + `SOURCE = bphs_ch34_table_v1`，每格带出处（公开英文译本 + 梵文逐词对照，第 13、19–44 颂），14 个格保留公式值标 `formula_fallback`，12 上升全格由 `tests/test_functional_benefics_bphs_table.py` 锁住。生时校正 v5 77 例评测（硬红线 3）：±10 引擎头名 0.1818 → 0.1688、六题回放头名 0.6364 → 0.5974、线上区间回放头名 0.6753 → 0.6364，±30 六题回放 0.4935 → 0.4675，覆盖全部不变，±60 上升；超过 1 个百分点，按红线停在 T1，未合入。逐格旧值 / 新值 / 出处与歧义清单见 `docs/tasks/PROGRESS-consult-career-yoga-functional-20261002.md`。
 - 决策日志（2026-10-02 第二次）：产品看了 T1 回归数字后决定只合入 yogakaraka 一条：yogakaraka 须同时主 4/7/10 之一与 5/9 之一，1 宫不计入此判定，吉 / 凶 / 中性分组不变（命主仍为吉）。实现 `ffafa28b`，`SOURCE = strict_functional_benefic_malefic_v2`；变化：白羊火星、金牛 / 天秤金星、双子 / 处女水星、天蝎火星、射手 / 双鱼木星、摩羯 / 水瓶土星不再是 yogakaraka，分组逐格与 v1 相同。生时校正 v5 77 例改前 / 改后（`81f6e513` / `ffafa28b`）三档头名、覆盖、宽度逐项相同（±10 先验 0.1818、六题回放 0.6364、线上区间回放 0.6753，覆盖 0.987），未触发红线。验证：`tests/test_functional_yogakaraka_kendra_trikona.py`。BPHS 全表与 15 个待复核格见 T1 分支 `docs/research/bphs_ch34_functional_table_review_2026_10_02.md`（`c66c122a`）。另：协调方随后要求移植上游 `yinduzhanxing` `e9beae6b` 的功能吉凶文件，本会话的自动权限判定拒绝了从另一仓库原样拷入代码，未执行，需用户授权后再做。
-- 修复版本：部分：`codex/consult-career-yoga-functional-20261002` `ffafa28b`（yogakaraka）；全表在未合入分支 `codex/consult-career-yoga-functional-t1-20261002`
+- 决策日志（2026-10-02 第三次，产品授权）：改为采用上游 Skill 仓同日的功能吉凶 profile v2（`bphs_ch34_general_with_sign_exceptions_v2`）：BPHS 第 34 章总则（三方宫主吉；3/6/11 宫主与有条件的 8 宫主凶；只管 12 宫的星是条件性的，不自动判凶；日月管 8 宫按例外；只管角宫或只管 2 宫的星判中性）+ 逐上升明文例外（`ROLE_OVERRIDES`：白羊火星中性、金牛金星凶 / 太阳吉、双子木星凶、处女木星凶、天秤金星中性 / 火星凶、天蝎火星中性 / 太阳吉、射手木星与水星中性、摩羯月亮凶、水瓶火星凶 / 水星中性、双鱼水星凶）；yogakaraka 维持严格定义（同时管 4/7/10 之一与 5/9 之一，1 宫不计两次）。每颗星带 `role_basis`，`rule_reference` 指向 `references/functional-role-profile.md`。瑜伽引擎 `yoga_engine.py` 的 `functional_malefics()` / `functional_benefics()` 改读同一函数（第一次决策日志第 9 条「两套口径」随之消除）。本条推翻第二次决策日志里的「吉凶分组不变」与 T1 分支的逐格对照表方案；T1 分支 `codex/consult-career-yoga-functional-t1-20261002` 不再合入。生时校正 v5 77 例（PM 在 `57782aea` 前后同法实测）：引擎先验头名 ±10/30/60 0.1818/0.0779/0.0649 → 0.1818/0.0909/0.0779；六题回放 0.6364/0.4935/0.2597 → 0.6364/0.4935/0.3117；线上区间回放 0.6753/0.4935/0.3247 → 0.6623/0.5584/0.4026；覆盖 0.987/0.987/0.974 → 0.987/0.987/0.987。五格上升、一格（区间回放 ±10）−1.3 pp（一例），产品接受。
+- 验证（第三次）：`tests/test_functional_yogakaraka_kendra_trikona.py`（`57782aea` 改写）；两份普通对话 golden 用 capture 脚本重生成（`PYTHONHASHSEED=0 JYOTISH_API_CHART_CACHE_TTL_SECONDS=0`，两次逐字节相同，只有功能吉凶字段变化）；`frontend/tests/consult-upstream-functional-v2-20261002.test.ts` 锁 golden 的 profile 与天蝎、处女两个上升的分组；`consult-card-affliction-data-20261001.test.ts` 乔布斯太阳 `malefic` → `neutral`（三栏在测试注释）。Python 全量失败名单与基线逐条相同。
+- 修复版本：`57782aea`（移植）+ `codex/consult-upstream-functional-v2-20261002`（golden、算法身份、测试；未推送）。早先部分修复 `ffafa28b` 已被取代。
 
 ## BUG-1159 | 数据卡瑜伽清单是规则候选全集，大格局（Sasa、落陷取消、Gajakesari）进不来
 
@@ -15702,6 +15704,7 @@
 - 相关记录：BUG-1164、BUG-1070
 - 复发自：无
 - 修复版本：`codex/consult-no-presupposition-backtest-20261001`（已部署 staging `f361365a`，2026-10-02 health 核对、/api/account 401）
+- 复发（2026-10-02）：同一类「示例里的读法被照抄」在父母题复发——是非题与父母题 Good 例保留的「4 宫主落 10 宫 → 心力放在你的前途上 / 离你近、上心」被梦露盘（4 宫主正落 10 宫、母亲受冲两个以上）照抄；另有一处把逆行写成「拖出来」。见 BUG-1182。
 
 ## BUG-1166 | 用户纠正盘上判断时，追问轮没有「先认下、不辩护」的写法
 
@@ -15827,7 +15830,8 @@
 - 相关记录：BUG-1168、BUG-1162、BUG-1167
 - 复发自：无
 - 决策日志（2026-10-02 第二次）：第三轮回测行业对 3/18 后，产品决定事业题不猜行业：删掉「行业看星的本性」「公众 / 幕后要有依据」两行与「先讲一生事业形态：公众型还是幕后型」，改为 `CAREER_FIELD_ASK_RULE`（只讲力量、阻力、时间；不断定行业与公众 / 幕后；不写人人适用的话；事业段末问一句实际做什么，算全篇唯一请求），定义在 `consultation-thinking-plan.ts`、事业清单引用；追问轮加 `CAREER_FOLLOW_UP_RULE`（用户说了工作就按工作读，不编依据）。AL 一行去掉「落 10 宫 = 公众形象就是事业」。提交 `6a02e5e9`。第四轮回测：请问一句 18/18、事业追问 6/6 按真实职业读；但 9/18 仍在主线里写「不是站台式 / 不在台面上 / 往深处做」，多由 A10、AL、太阳、10 宫主落 4/6/8/12 宫直接推出；严重冲突合计 12/72（≤ 5 未达）。
-- 修复版本：`codex/consult-career-yoga-functional-20261002`（文本层）
+- 第五轮（2026-10-02，产品批准本轮修第四轮残留）：`CAREER_FIELD_ASK_RULE` 加一句「A10、AL、太阳、10 宫主落 4、6、8、12 宫只说这条线的阻力或代价（要经手、要绕路、来得晚），不翻成『不在台前』『不在台面上』『不靠曝光』『幕后』『不是站台式』『往深处做』，也不把落宫翻成行业（8 宫不等于研究、账目，12 宫不等于海外、幕后工作）」，仍只定义在 `consultation-thinking-plan.ts`；`frontend/tests/consult-upstream-functional-v2-20261002.test.ts` 锁句。第五轮回测：行业 / 类型与生平冲突 9/18 → 5/18（乔布斯 r2「靠一门本事坐实，不是靠一阵热闹」〔边界〕、泰勒 r1「不是靠人缘和曝光速成」、梦露 r1 / r2「不跟着曝光走」「经手别人的事…不是靠曝光」、布什 r2「靠能扛事，不是靠场面」），通过线 ≤ 1 未达；段末问一句 17/18（奥巴马 r1 只问了受冲那一句）。剩下 5 份里 4 份的推法是「10 宫主 / D10 落 6 宫或 8 宫 → 经手、担责 → 不靠曝光」，规则点了名的说法换成同义词（「不靠场面」「不是一阵热闹」）再出现。事业追问（足球运动员 / 演员 / 政治家 × 2）6/6 按真实职业读，泰勒、齐达内两份主动认下上一轮读偏。状态维持 investigating。
+- 修复版本：`codex/consult-career-yoga-functional-20261002`（文本层）；第五轮规则 `codex/consult-upstream-functional-v2-20261002`（未推送）
 
 ## BUG-1177 | 开场「第一句就是结论」不受受冲规则约束，对照组被开场下了「距离感明显」一类结论
 
@@ -15873,3 +15877,48 @@
 - 复发自：无
 - 修复版本：`codex/rectification-post-adopt-verify-20261001`。
 
+## BUG-1180 | Pancha Mahapurusha 检测把火星、土星自己算作「凶星合相」，Ruchaka / Shasha 永远判失效
+
+- 状态：resolved（修复随上游移植 `57782aea`，本轮补回归测试）
+- 首次发现 / 最近更新：2026-10-02 / 2026-10-02
+- 影响面：`scripts/pancha_mahapurusha.py` `_has_malefic_aspect` / `detect_pancha_mahapurusha`；读它的 `scripts/jyotish_api_server.py` `_detect_yogas`（排盘自带瑜伽，只收 `is_valid` 的五大人格格局）与 `/api/pancha_mahapurusha`（`assess_pmc_strength`）。
+- 现象：火星在白羊 / 天蝎 / 摩羯坐角宫（Ruchaka）、土星在天秤 / 摩羯 / 水瓶坐角宫（Shasha），即使同宫没有任何别的凶星，也被标「受凶星合相: Mars / Saturn — Yoga部分失效」，`is_valid = False`，排盘自带瑜伽里永远不出现这两个格局。
+- 触发条件：任何 Ruchaka / Shasha 候选。
+- 根因（已核实代码）：`_has_malefic_aspect(planet_sign, all_planets)` 用 `pn == planet_sign` 跳过自身——把行星名和星座名比较，永远不等；火星、土星本身在 `NATURAL_MALEFICS` 里，于是自己与自己同宫就算一次「凶星合相」。木星、水星、金星不是自然凶星，不受影响。
+- 修复：函数加 `planet` 参数，按 `pn == planet` 跳过本星（上游 `e9beae6b` 原样移植，`57782aea`）。别的凶星同宫仍判失效。
+- 验证：新增 `tests/test_pancha_mahapurusha_self_conjunction.py`（火星独坐白羊 1 宫 → Ruchaka 成立、无失效原因；土星天秤 10 宫 → Shasha 成立；同宫另有土星仍失效且只点名土星；木星与火星同宫仍失效）。用 `57782aea^` 的旧文件跑同一输入：Ruchaka `is_valid = False`（红），新文件为真（绿）。两份普通对话 golden 重生成后瑜伽字段无变化（九位名人没有触发这两个格局的独坐配置）。
+- 防复发：回归测试锁「自身不算合相」；跳过自身必须按行星名比较。
+- 相关记录：BUG-1159、BUG-1174、BUG-1175（传统格局栏读的是规则引擎结果，不经本模块）。
+- 复发自：无
+- 修复版本：`57782aea`；测试 `codex/consult-upstream-functional-v2-20261002`（未推送）。
+
+## BUG-1181 | 功能吉凶 v2 改了生时校正打分，算法身份没跟着升：旧分数会被当作当前结果复用；「日期窗合同」写死只认 scoring-9
+
+- 状态：resolved（代码与测试；部署、迁移与真机为待办）
+- 首次发现 / 最近更新：2026-10-02 / 2026-10-02
+- 影响面：`scripts/rectification/scoring_service.py` `ALGORITHM_VERSION`；前端 `v9EngineVersion()` 缺省串、`engine-client.ts`（score / diagnostics 的 `dated` 判定）、`tool-service.ts`（候选行解析、legacy 段选择判定）、`score-persist.ts`（是否先补日期窗）、`rectification-candidate-result.ts`；数据库函数 `validate_dated_rectification_candidate`。
+- 现象：`57782aea` 之后 `tests/test_rectification_engine_memoization.py` 8 项失败（同一输入候选 12:00 的分数 8.6274 → 8.4977）。功能吉凶分组经 `*_functional_benefic_auxiliary` / `*_functional_malefic_auxiliary` 规则进入事件矩阵，同输入出不同分；而 `ALGORITHM_VERSION` 仍是 scoring-9，`cachedEngineScoreIsReusable` 按算法身份 + 证据指纹判断能否复用，证据未变的历史 Case 会把旧分组算出的分数当作当前结果。
+- 触发条件：任何功能吉凶分组变化的上升（v2 改了 10 个上升的至少一颗星）且证据未变的校正 Case。
+- 根因：一，先例规定「打分语义变化必须 bump `ALGORITHM_VERSION`」（`TASK-rectification-engine-convergence-20260901` 硬红线 3；跨午夜修复 7→8→9 同此办理，BUG-981～985），功能吉凶移植时未同步。二，前端五处、数据库一处用 `=== "rectification-v5-matrix-scoring-9"` 判断「这是带日期窗合同的结果」：直接升到 scoring-10，新结果会被当成旧的同日结果解析（跨午夜候选丢日期），数据库的防伪守卫也会对 scoring-10 失效。
+- 决策记录：按先例升到 `rectification-v5-matrix-scoring-10`（同输入分数变了就升，策略版本 `rectification-candidate-policy-v3` 与输入合同 v5 不变；不改 Skill、不重标历史结果）。「日期窗合同」改为按代数判断（≥ 9），避免下一次升版再踩同一处。
+- 修复：Python 常量升到 scoring-10；前端新增 `isDatedScoringAlgorithmVersion`（`core/candidate-window.ts`，正则取代数 ≥ 9），五处字面量判断全部改用它，`v9EngineVersion()` 缺省串同步；迁移 `20261002010000_rectification_dated_algorithm_generation.sql` 只重建 `validate_dated_rectification_candidate` 函数体，守卫改为 `~ '^rectification-v5-matrix-scoring-(9|[1-9][0-9]+)$'`，其余逐字节与 `20260920020000` 相同（不动表、列、权限、历史行）。按 ERR-110 重新冻结校正研究记录（标签 `functional_v2_2026_10_02`）：`sealed_holdout_rerun.py` / `reported_offset_sweep.py` 指向新记录，`PRODUCTION_FILES` 补 `scripts/functional_benefics.py`（ERR-114：它不在冻结身份里，`57782aea` 改分数时门禁没红），`references/rectification_sealed_holdout.v1.json` 的 current / previous 照 09-29 先例轮换，旧记录逐字节保留。影子 20 例与 09-29 逐条相同（指标不变）；原生 reported-offset 900 例 230 例变化，窗口内平均头名不变（±15/30/60：0.0636/0.06/0.05），交付覆盖 0.9864/0.99/1.0 → 0.9955/0.9967/1.0。
+- 验证：记忆化 golden 按文件自带 `write_golden` 新写 `tests/golden/rectification_engine_memoization_v2.json`（scoring-10，源码 `57782aea`），v1（scoring-8）保持逐字节不变并以 sha256 钉住，新增测试证明当前分数已偏离 v1；文件 22 项全过。前端：新增 `rectification-dated-algorithm-generation-20261002.test.ts`（代数判定 9/10/11/100 真、8/09/空/非字符串假；源码里不再有 `=== "…scoring-N"`；SQL 守卫；scoring-9 历史结果在 scoring-10 下打开为只读并给「重新比较」、候选仍带日期）；真实引擎新生成 scoring-10 跨午夜 golden（`midnight_date_anchor_regression.py --golden`，同机 A/B 3×7 字段逐位相等）并让跨午夜贯穿测试对 scoring-9 / scoring-10 两份 golden 都跑；把判定临时改回字面量，scoring-10 那一份即红。数据库：本机 PG17 + docker 替身跑 `database-adopted-birth-date`（scoring-10 / 11 去掉日期合同被拒、scoring-8 仍按旧同日结果返回空）；去掉迁移文件即红 2 项、恢复后绿。`npm run test:db` 全量 80 项：基线 `57782aea` 与本分支都是 74 过 / 6 败，失败名单逐条相同（替身不支持的 pg_dump、部署脚本等）。重新冻结后 `test_rectification_validation_integrity_gate.py` 等 8 项转绿，`rectification-confirmation-gate.test.ts` 改读新报告（三栏在注释）。历史打开：`rectification-*.test.ts` 1,872 项（含 BUG-621 历史打开、BUG-984 只读与重新比较）0 失败。
+- 防复发：打分语义变化必须升 `ALGORITHM_VERSION`，记忆化 golden 新增版本文件、旧文件冻结，校正研究记录按 ERR-110 重新冻结；`test_functional_roles_are_part_of_the_production_identity` 锁功能吉凶文件在冻结身份里；「是否带日期窗合同」只能用 `isDatedScoringAlgorithmVersion` / SQL 正则判断，源码扫描测试拦字面量比较。
+- 待办：部署前核实 staging / 生产环境没有设置 `RECTIFICATION_ENGINE_VERSION` / `RECTIFICATION_ALGORITHM_VERSION` 锁旧身份（`deploy/`、`.gitea/` 未设）；迁移在部署前自动应用，对当前已部署代码向后兼容（只放宽到 ≥ 9 的守卫）。
+- 相关记录：BUG-1158、BUG-621、BUG-733、BUG-981、BUG-982、BUG-983、BUG-984、BUG-985；错误台账 ERR-110、ERR-114。
+- 复发自：无（跨午夜那次升版同时引入了「日期窗合同」，当时只有 scoring-9 一个代，字面量判断没有暴露）。
+- 修复版本：`codex/consult-upstream-functional-v2-20261002`（未推送）。
+
+## BUG-1182 | 第四轮回测残留：受冲两个以上的母亲被写成「在管、在安排、近」，逆行被写成「拖出来」，全篇两处请求
+
+- 状态：resolved（文本层；第五轮回测父母严重冲突 3 → 0、禁句 1 → 0、两处请求 3 → 0）
+- 首次发现 / 最近更新：2026-10-02 / 2026-10-02
+- 影响面：`frontend/src/lib/consultation-thinking-plan.ts` `AFFLICTION_RANGE_RULE`；`frontend/src/lib/consultation-condensed-checklist.ts` 通用读法第 5 行；`frontend/src/mastra/product-voice.ts` 不揣测一条、父母题与是非题 Good 例；`frontend/docs/VOICE.md`。
+- 现象：第二～四轮回测，梦露父母 ×2「把心力压在你的前途上，方式是安排、催」「妈妈这条有实际照顾的一层」、琵雅芙父母 ×1「她这条线的重心是管和安排」——三份都已写出受冲范围，又在同一段或「他们怎么对待我」一段把母亲写成在场、在管；行动写「给妈妈打电话」「挑一件事去问爸爸」。琵雅芙健康 r2 出现「8 宫那颗土星还是逆行的，意思也偏『拖出来的问题』」；三份答案全篇两处请求。
+- 根因（已核实）：一，系统提示里有三处把「4 宫主落 10 宫」直接配上「母亲的注意力在你的前途上 / 离你近、上心」（不揣测一条、父母题 Good 例、是非题 Good 例），梦露盘 4 宫主正落 10 宫，模型照抄；BUG-1165 修示例时只去掉了「逆行」，这条读法留着。二，`AFFLICTION_RANGE_RULE` 只禁「有分量」「关系稳」这类安慰词，没有禁「拿宫主落宫、宫里的吉星去描写这个人在做什么」，也没有管行动建议。三，通用读法只写了「逆行不等于反复、打回来」，模型换成「拖出来」。四，`AFFLICTION_RANGE_RULE` 要求「这一段末尾」请用户说一句，和事业段末的那一问在同一篇里叠加。
+- 修复：`AFFLICTION_RANGE_RULE` 加「不拿宫主落哪一宫、宫里有吉星去描写这个人对你做什么（『在管』『在安排』『心思在你的前途上』『照顾是实的』都预设人在身边，宫主落宫和吉星只说这条线另有支撑的迹象），这一方的行动建议也不写给他打电话、去问他」与「问过之后别的段落不再另问」；三处示例括号改为「（母亲这条线没有受冲；4 宫主落 10 宫）」/「盘上有证据、且这条线没有受冲时可以写……」；通用读法第 5 行改为「逆行不等于『反复、打回来』，也不等于『拖得久、拖出来』，推论里不拿逆行当理由（依据里可以列）」。都是单一定义处的文字，不加任何对模型输出的正则后处理。
+- 验证：`frontend/tests/consult-upstream-functional-v2-20261002.test.ts` 锁四句；改动的既有断言（`consult-no-presupposition-20261001.test.ts` 的 `AFFLICTION_RANGE_TEXT` 与是非题例、`consultation-voice-contract.test.ts` 两处）三栏写在测试注释。第五轮回测：父母 18 份严重冲突 0（梦露、琵雅芙四份母亲段只写「迹象 + 范围 + 另有支撑的迹象」，「他们怎么对待我」写「盘上看不出谁具体怎么对你」）；禁句 0；72 份每份恰好一处请求。残留：琵雅芙父母 r2 行动「挑一件他们习惯替你做决定的小事」仍预设父母在场（记通过·弱）。
+- 防复发：示例括号不得放「宫位 → 人物行为」的对应；受冲规则覆盖开场、正文、「他们怎么对待我」与行动四处；名人回测父母项。
+- 相关记录：BUG-1164、BUG-1165、BUG-1177、BUG-1176。
+- 复发自：BUG-1165（示例读法被照抄）。BUG-1165 的合同测试只白名单了「逆行」一词，没有检查示例括号里「宫位 → 行为」的读法，所以未拦住。
+- 修复版本：`codex/consult-upstream-functional-v2-20261002`（未推送）。