Merge remote-tracking branch 'origin/codex/rect-purpose-layers-20261117' into codex/rect-purpose-layers-20261117
This commit is contained in:
@@ -0,0 +1,94 @@
|
||||
# 生时纠正用途扫描:补齐缺生产器的层(2026-11-17,Claude)
|
||||
|
||||
Bug 编号:BUG-1953(#307)。关联 BUG-1932(#297)、BUG-1938(#304)。后续 BUG-1962(用途政策 v2,排队)。
|
||||
|
||||
## 背景
|
||||
|
||||
#297 的用途扫描对事业、钱财、婚恋给不出「够用」,因为问题路由要求的一批层没有生产器,一律 `blocked`。#304 已经用算法性质给 Arudha、Vimshottari、Narayana 补了覆盖依据。
|
||||
|
||||
占星师 11-17 裁定:各用途所需层以仓内已有清单(`references/technique_registry.json` 的 routes、`scripts/consultation_plan_contract.py` 的 `required_layers`)为起点,再补上实际参与断言的层:分盘里的行星位置、功能性吉凶星、宫主与尊贵、相位、Yoga、力量与 Ashtakavarga、Jaimini 征象星、行运、年度盘。只列进清单不算执行;某层算不了时只限制依赖它的断言。
|
||||
|
||||
**本单只做生产器和覆盖判定**(每层「在这个出生时间范围内会不会变、在哪一秒变」)。用途政策(哪个用途要哪些层、按断言分组、时间粒度怎么判)留给 BUG-1962,本单不改 `scope._policy`,只让新层可以被政策引用。
|
||||
|
||||
## 一、要补的层
|
||||
|
||||
每层在 `scripts/rectification_purpose_gate/native.py` 的 `compute` 里给出输出值,在 `providers.py` 里给出边界提供器。层名固定如下(政策引用用这些名字):
|
||||
|
||||
| 层名 | 输出值 | 出生时间通过什么影响它 |
|
||||
|---|---|---|
|
||||
| `house_lords` | 12 个宫的宫主(D1) | 只随 D1 上升星座变 |
|
||||
| `lord_placements` | 12 个宫主各自落在 D1 的哪一宫 | D1 上升星座、宫主所在星座 |
|
||||
| `planet_signs` | 九曜在 D1 的星座 | 各行星换座时刻 |
|
||||
| `planet_vargas:D9` / `:D10` / `:D2` / `:D11` | 九曜在该分盘的星座 | 各行星在该分盘的换座时刻(月亮最快) |
|
||||
| `functional_roles` | 现行功能性吉凶星档案下各星的角色 | 先读 `scripts/functional_benefics.py`:至少依赖上升星座;PVR 档案还依赖月相(日月距角),把实际输入全部列出 |
|
||||
| `venus_jupiter` | 金星、木星的 D1 宫位与星座、尊贵级别 | 上升星座、两星换座 |
|
||||
| `aspects` | D1 星座相位(Rasi drishti)关系表 | 只随星座变 |
|
||||
| `chara_karakas` | 七/八征象星分配(AK…DK,含 AmK、DK) | 各行星**星座内度数的先后顺序**,月亮最快;用 `scripts/jaimini.py` 的现有函数,按仓内默认的 7 或 8 征象星设置 |
|
||||
| `ashtakavarga` | BAV 与 SAV 各宫分数 | 先读 `scripts/ashtakavarga.py::calc_ashtakavarga` 确认只用星座位置 |
|
||||
| `wealth_yogas` / `raj_yogas` | 命中的 Yoga 名单 | 用现有检测器;先读它依赖什么(星座、宫位、宫主,还是度数、燃烧、合相容许度) |
|
||||
| `transit_relations` | 本次预测窗内行运相对本命的关系(从上升、从月亮数宫;若现有行运模块还用本命度数,一并列出) | 本命上升星座、月亮星座(及模块实际用到的本命度数) |
|
||||
| `annual_chart` | 预测窗内每个年度盘的年度上升星座与 Muntha 星座 | 先读现有年度盘模块(`scripts/annual_tajika_pack.py` / `solar_return.py` / `muntha.py`):年度盘时刻取决于本命太阳度数,出生时间差 1 小时太阳约差 2.5 角分,年度上升可能整座改变 |
|
||||
| `strength_shadbala` | 不计算 | 见第三节 |
|
||||
|
||||
产出值一律复用仓内现有计算函数,不新写占星算法。现有函数需要的输入从 `_chart` 已算出的结果里取,不重复排盘。
|
||||
|
||||
## 二、覆盖依据
|
||||
|
||||
和 #304 一样:只有能从代码证明「这层只在某些时刻会变」的,才给 `policy_covered`,并写 `basis`;证明不了的给 `sampled_only`,不硬套。
|
||||
|
||||
1. **只随星座变的层**(`house_lords`、`lord_placements`、`planet_signs`、`venus_jupiter`、`aspects`、`ashtakavarga` 若确认只用星座):边界只能出现在上升或行星换座时刻。复用 #304 的 `_sign_layout_factory`(上升 + 九曜换座枚举),在每个候选时刻前后一秒取值,变了的才记为边界;每段中点抽查。`basis` 写 `depends_on_signs_only`。
|
||||
2. **分盘行星位置**(`planet_vargas:*`):每颗行星在分盘的换座时刻 = 该行星黄经跨过 `30°/n` 整数倍的时刻。按 `_sector_provider` 的办法求(分钟网格找跨界、二分到秒),逆行两个方向都认。`basis` 写 `varga_sign_from_planet_longitude`。
|
||||
3. **功能性吉凶**:若代码确认只依赖上升星座(和月相),边界 = 上升换座 ∪ 日月距角跨 0°/180° 的时刻(后者按 2 的办法求)。`basis` 写 `functional_roles_from_lagna_and_paksha`。代码依赖更多时降为 `sampled_only` 并在 PROGRESS 写明。
|
||||
4. **征象星**:分配只随「星座内度数的大小顺序」变。边界 = 任意两颗参与排序的行星星座内度数相等的时刻(月亮与其他星最常见)。用分钟网格看排序是否改变、二分到秒;相邻网格点之间各行星度数变化区间若会交叉,加密网格。证明成立给 `policy_covered`,`basis` 写 `karaka_order_from_in_sign_degrees`;否则 `sampled_only`。
|
||||
5. **Yoga**:检测器只用星座/宫位/宫主时按第 1 条;用到度数或容许度的,`sampled_only`,`reason` 写具体依赖。
|
||||
6. **行运关系**:行运本身与出生时间无关。若代码确认它对出生时间的依赖只有本命上升星座和月亮星座(和列明的本命度数),这层的边界 = 这些量的边界(复用现有上升、月亮星座提供器)。`basis` 写 `transit_relations_from_natal_lagna_moon`。
|
||||
7. **年度盘**:没有解析边界的,`sampled_only`;用分钟网格发现变化后二分到秒,回执写明「网格发现 + 二分」,不声称排除了分钟内的往返变化。
|
||||
|
||||
所有提供器沿用 #297 的回执格式和 `_receipt` 的降级规则,不放宽。
|
||||
|
||||
## 三、力量层(Shadbala)
|
||||
|
||||
占星师 11-17:网站本地 Shadbala 在她验收前只能作「方法待核」的参考,不得用于校时排除或确定性判断。同时 BUG-1961(另一窗口)在隐藏没有出处的强弱档位。
|
||||
|
||||
本单:`strength_shadbala` 层不计算,回执固定为 `state = incomplete`、`reason = method_unresolved`、`method_id = shadbala_pending_review`。政策引用它时,只会限制依赖它的断言(BUG-1962 处理分组)。**不改** `scripts/` 下任何 Shadbala 计算文件。
|
||||
|
||||
## 四、扫描器与已知缺陷的修正
|
||||
|
||||
占星师对 BUG-1932 的三处意见,本单一并处理:
|
||||
|
||||
1. 文档里「出生时间差 1 分钟,Vimshottari 边界约移动 3.8 天」这句通用比例删掉(`docs/research/rect-purpose-scan-20261116.md` 和相关 PROGRESS 中出现的地方),改成「漂移量取决于出生时月亮的运动和所在星宿的大运年数,由引擎重算,不用常数」。代码里若有用这个常数做容差的,改为不用。
|
||||
2. 分盘上升的边界不等于分盘的全部输出边界——本单的 `planet_vargas:*` 就是为此补的;在 `docs/research/rect-purpose-scan-20261116.md` 末尾追加一段说明这一点和现在的覆盖范围。
|
||||
3. 采样点之间的最早最晚不等于全区间包络:检查 `timing.py::period_envelopes`,确认只有在该层 `policy_covered` 时才把结果称为包络、否则只叫「各采样点的范围」;补一条测试锁住。另补测试:240 分钟分段的接缝处、跨午夜的范围、多段范围、不同岁差/交点参数分支,各一条,确认没有漏检。
|
||||
|
||||
## 五、测试
|
||||
|
||||
新文件 `tests/test_rectification_purpose_layers.py`:
|
||||
|
||||
- 每个新层:一条确定性假函数的反例(星座没变但值变了 → 不给覆盖;排序在两网格点之间交叉 → 被检出);一条真实引擎的逐秒对照(4 分钟合成范围,每类至少有一条真实边界,提供器的边界与逐秒扫描完全一致)。
|
||||
- 月亮在 D9/D10 的分盘换座、月亮与另一星度数交叉改变 DK/AmK、月相跨 180° 改变功能角色,各至少一条真实引擎用例(找不到合适的合成时刻就写明在 PROGRESS,不要伪造)。
|
||||
- `strength_shadbala` 回执固定为方法待定。
|
||||
- 第四节第 3 条的四条扫描器测试。
|
||||
- `tests/test_rectification_purpose_scan.py`、`test_rectification_purpose_binding.py`、`test_rectification_purpose_coverage.py`、`test_active_rectification_candidates.py`、`test_rectification_purpose_gate.py` 照旧通过,不删改旧断言。
|
||||
|
||||
命令行核对:用 `python -m scripts.rectification_purpose_gate --input <json>` 跑一个 ±30 分钟、月粒度、把本单全部新层列为所需层的合成输入(测试里直接改 `scope["policy"]["required_layers"]`,不改政策),把各层状态、`basis`、计算次数写进 PROGRESS;计算次数不超过默认预算 4000,超过就写明并说明原因。
|
||||
|
||||
## 六、不做的事
|
||||
|
||||
- 不改 `scope._policy` 和用途政策表(BUG-1962)。
|
||||
- 不接任何生产入口(API、页面、聊天都不导入新代码)。
|
||||
- 不改 `scripts/chart_choice/`、`frontend/`、`scripts/report_render/`、`references/`。
|
||||
- 不改任何现有占星计算函数的结果;发现现有函数有错,写进 PROGRESS,不在本单修。
|
||||
- 不计算、不使用 Shadbala。
|
||||
|
||||
## 七、文档
|
||||
|
||||
- `docs/BUG_HISTORY.md` 在 BUG-1953 一节记录(没有就新增;只在自己那一节内编辑;不写姓名、出生资料、邮箱、ID)。
|
||||
- `CHANGELOG.md` 一行;`docs/tasks/PROGRESS-rect-purpose-layers-20261117.md`:每层一行,写「代码依据(文件和函数)→ 依赖的输入 → 覆盖方法 → 状态 → 反例测试名」。
|
||||
- `docs/research/rect-purpose-coverage-20261117.md` 末尾追加新层的覆盖依据,用普通话写,会转给占星师审。
|
||||
|
||||
## 验收
|
||||
|
||||
- `PATH=<venv>/bin:$PATH python scripts/run_quality_gate.py --profile quick --skip-frontend-runtime` 通过;
|
||||
- 新测试全部通过,每个新层至少一条反例和一条逐秒对照;
|
||||
- `cd frontend && npx eslint .` 0 错误(本单不应有前端改动);
|
||||
- 没有任何生产入口导入 `scripts/rectification_purpose_gate`(验收时会 grep);diff 不含第六节列出的路径。
|
||||
Reference in New Issue
Block a user