# PROGRESS：太阳返照时刻对齐（出生太阳同参考系 + 保留秒）— 2026-10-03

- 任务书：`docs/tasks/TASK-annual-return-frame-20261003.md`。执行方：Claude 直接执行（产品负责人 2026-10-03 晚确认）。
- 分支 `codex/annual-return-frame-20261003`，工作树 `.worktrees/annual-return-frame-20261003`，基线 `origin/staging` = `3c27c38e`（第三批已合入，含 BUG-1216～1219）。
- 上游参照：`yinduzhanxing` `7cc6425d`、`46ed9399`（只读）。
- BUG 编号：开工时最大号 BUG-1219；本单 BUG-1220。
- 预检：`scripts/pre_work_check.py` → `status: pass`。磁盘余 44G。

## 结论

| 任务 | 结果 |
| --- | --- |
| T1 出生太阳与求解器同参考系 | 完成。PyJHora 对照 3 例：0.000 / 0.021 / 0.006 分钟（门槛 0.5） |
| T2 年盘保留秒 | 完成。年盘时刻与返照差 < 1 秒 |
| T3 下游与 golden | 咨询两份 golden 用真实引擎重采，逐字节不变；243 张年盘对比见下 |
| T4 记录 | BUG-1220、ERR-109 复发说明、CHANGELOG、本文件、README |

## 改动

- `scripts/solar_return.py:calc_solar_return_chart`：
  - 目标经度 = `_get_sun_lon_jd(birth_jd_ut)`，拿不到才退回出生盘 `degree_raw`；
  - `solar_return.target_sun_frame` 标明用了哪一种；
  - 起年盘传 `second=sr_dt_ut.second`。
- 新测试 `tests/test_solar_return_frame.py`（5 条）。换回旧代码时 5 条全部失败。
- 未搬：上游 `position_mode`、`solar_return_time_offset_seconds`、`node_longitude_offset_arcseconds`、`annual_house_system_for_sahams`（研究回放参数）。

## PyJHora 对照（只存数字，Lahiri）

| 例 | PyJHora 返照 JD（UT） | 本站修后 | 差（分钟） | 修前差（分钟） |
| --- | --- | --- | --- | --- |
| Rath 标准盘 2025 | 2460895.0424092 | 2460895.0424094 | 0.000 | −6.3 |
| 乔布斯 2012 | 2455983.2569387 | 2455983.2569242 | −0.021 | +7.2 |
| 齐达内 2002 | 2452449.2759534 | 2452449.2759490 | −0.006 | +6.3 |

## 243 张年盘前后对比

9 位公开名人（`tests/test_pancha_mahapurusha_main_detector.py:FIGURES`）× 2000–2026 年，Lahiri，年主与 Mudda 用第三批的产品函数。

| 指标 | 变化 |
| --- | --- |
| 返照时刻最大偏移 | 7.2 分钟 |
| 年盘上升星座 | 13/243 |
| 昼夜判定 | 0/243 |
| 年主 | 11/243 |
| Mudda 起运星 | 0/243（第三批后与年盘无关，作为回归证据） |

| 名人 | 年 | 时刻偏移（分钟） | 年盘上升 | 年主 |
| --- | --- | --- | --- | --- |
| 乔布斯 | 2012 | −7.2 | 金牛 → 白羊 | 金星 → 太阳 |
| 乔布斯 | 2015 | −7.2 | 摩羯 → 射手 | 金星 → 太阳 |
| 乔布斯 | 2024 | −7.2 | 双子 → 金牛 | 土星 → 金星 |
| 奥巴马 | 2009 | +3.4 | 金牛 → 双子 | 月亮 → 水星 |
| 奥巴马 | 2024 | +3.4 | 双鱼 → 白羊 | 月亮 → 土星 |
| 梦露 | 2007 | +7.1 | 白羊 → 金牛 | 月亮 → 火星 |
| 琵雅芙 | 2009 | −4.9 | 射手 → 天蝎 | 土星（不变） |
| 琵雅芙 | 2021 | −4.9 | 摩羯 → 射手 | 火星 → 木星 |
| 卡罗 | 2001 | +6.5 | 狮子 → 处女 | 水星 → 月亮 |
| 卡罗 | 2012 | +6.5 | 双子 → 巨蟹 | 土星 → 金星 |
| 小布什 | 2007 | +6.8 | 摩羯 → 水瓶 | 月亮 → 太阳 |
| 小布什 | 2023 | +6.8 | 双鱼 → 白羊 | 土星（不变） |
| 齐达内 | 2002 | −6.3 | 射手 → 天蝎 | 木星 → 金星 |

## 验收

| 项 | 结果 |
| --- | --- |
| 新测试 + 年运相关定向（`test_solar_return_frame`、`test_solar_return_timezone`、`test_annual_tajika_pack`） | 26 passed |
| `test_report_english_dictionary` + Tajika / Mudda / 年主四个文件 | 208 passed |
| 快速门 Python 段 | 1047 passed、1 skipped、0 failed |
| 前端 `npm test`（Node 22.14） | 4931 个，fail 24、cancelled 0；失败名单与基线 `3c27c38e` 逐条相同 |
| v5 77 例 | 三段结果（分钟级打分、候选范围宽度、采集无效停止回放）与基线 `3c27c38e` 逐项相同，只有耗时字段不同 |
| `tsc` / lint / build | 未跑：本单没有前端源码改动，只有前端 golden 重采且逐字节不变 |
| 历史报告可打开 | 不涉及：旧报告存的是生成时结果，不重算；未改迁移与 Skill 版本 |

## 环境缺口

- 名人生平回测：本机无模型凭据，未跑（本单不改提示词）。
- 真机：部署后在 staging 打开一张年运数据卡或参考版报告，看年运段能出；数值变化只影响约 5% 的年份，不另立真机清单。