# 紫炁：固定软件约定与独立实现来源台账

实现日期：2026-10-02。独立模块版本：1.0.0。

## 范围和来源层级

本项复现的是指定软件版本的一条人工均匀运行约定。它不是现代天文学中的实际天体，也不证明该历元、初值及日行度来自某一历史朝代或为所有七政流派公认。规则文字、程序组织、数据结构、UI、坐标旋转和测试均独立编写。

仅把源文件作为只读的算法与常量证据；没有执行源 Python 模块、复制上游程序或注释、安装 Swiss Ephemeris、导入源软件运行环境，也没有搬运七政全套资料或判词。四个地支宫状态是明确限定的条件事实映射，全部解释文字重新写作。上游仓库声明 AGPL-3.0-only；本项未将其实现或文字作为运行资产打包，这不是对未来任意复制的许可判断。

固定仓库：

- https://github.com/Horace-Maxwell/Horosa-Web-App-comprehensively-improved-Windows
- 核验提交：`daab60ce05c8f0e78cc51b5e7974120f81aed79c`
- 以下相对路径共同前缀：`local/workspace/Horosa-Web-55c75c5b088252fbd718afeffa6d5bcb59254a0c/`

| 来源路径 | 位置／SHA-256 | 本项采用的事实 | 不据此推断的内容 |
|---|---|---|---|
| `astropy/astrostudy/qizheng_election_scan.py` | 157–161；`ace6c794e6796560eb1961b998ddc98f0e575ffc2ff6542ddf43132fc1574054` | 紫炁黄经：188.6849°初值，JD2451543.5，10226.78132日一周；速度360/周期 | 不同于月孛，不引入源软件扫描框架 |
| `flatlib-ctrad2/flatlib/ephem/tools.py` | 43–49；`b4287196e3b59a5cde75d8e07dca81348d9e523f1f60d9de038036a562a6137c` | 同一紫炁黄经公式，地理位置和flags参数不参与其公式 | 不据函数参数存在声称公式有地平或恒星黄道校正 |
| `astropy/astrostudy/guolao_const.py` | 67–75；`630839b71c0c2e95838091e61d52bddf28437cf9ba3f4ceb01bb72a28711a5fb` | 资料层紫炁日行0.03520、周期28年、立成锚JD2451545.0 | 不用资料层常数覆盖真正执行的公式 |
| `flatlib-ctrad2/flatlib/ephem/eph.py` | 52–67；`d588ad15c7f832d7a8531bc5a13a206bac69711b01444e00095c6c46a7aa1ca4` | 紫炁以黄纬0°转赤道坐标；对象里的速度为0 | 不将对象占位速度0当成均匀运动的真实导数 |
| `flatlib-ctrad2/flatlib/utils.py` | 91–93；`ea4d087124c0ef00478923164c0cf8f42928d84be4f94f3d6c305f31673da191` | 坐标转换调用固定黄赤交角，不使用日期 | 不把此RA误认为当日真赤道RA |
| `flatlib-ctrad2/flatlib/const.py` | 620–621；`6461f14b02fa3e1902be74f10d7e25f02e2e0a3096932cfc047d84762bc31a4d` | 黄道到赤道的转换角绝对值23.44° | 不把固定值替代Astronomy Engine当日真黄赤交角 |
| `astropy/astrostudy/qizheng_election_scan.py` | 62–64、179–183；同上哈希 | 回归黄经每30°一宫，依次戌酉申未午巳辰卯寅丑子亥 | 不是地平宫、命宫或RA分宿 |
| `astropy/astrostudy/guolao_const.py` | 96–109，尤其107；同上哈希 | 紫炁在申标“庙”，丑和亥标“旺”，戌标“喜” | 未列宫不等于平、吉、凶；未继承七政整表与全部命理 |

## 实际可执行公式

令J为该软件公式使用的民用UT式儒略日参数：

λ = [188.6849 + 360 × (J − 2451543.5) / 10226.78132] mod 360

本实现使用JavaScript Date的UTC民用日：`J = timestampMs / 86400000 + 2440587.5`。这与项目现有日期处理保持一致，仍须公开指出没有DUT1修正，也没有把闰秒作为独立长日建模。不能将TT儒略日直接传入。所有Date输入须先在调用层确定时区。

- 公式历元JD2451543.5 = 1999-12-31T00:00:00Z，初值188.6849°。
- 资料立成锚JD2451545.0是2000-01-01T12:00:00Z；在这个时刻，真正公式给188.737702537093850756…°。
- 因而不能直接把188.6849°挂在JD2451545.0上。若只是把公式重新锚定到J2000，必须同步把初值改为188.737702537093850756…°。
- 日行率始终为360/10226.78132。0.03520只是资料中的舍入值；28年也不能替代这个具体日数。
- `eph.py`在生成紫炁对象时把`lonspeed`设为0；扫描模块明确返回公式导数。本扩展把导数记入`speed`，并记录上述差异，不照搬占位0。
- 符号黄经是“软件定义的回归黄经”。源公式没有说明平/真春分点的细粒度口径；不能仅凭同一数值推断它有章动、岁差或高精度观测含义。

## 两种主结果与一个诊断值

### 1. 黄经模式：默认推荐

可用λ、正向日行率及黄经地支宫。主结果`latitude/raDegrees/declination/mansion`全部为null。其独立的`referenceDiagnostic`保留源软件零黄纬、固定23.44°投影，用于解释和数值对照；绝不拿该诊断RA去查现有真赤道宿界。

### 2. 零黄纬、日期真黄道投影：明确可选

这是本应用公开的新坐标解释，不标为上游RA完全复现：

1. 采用源软件零黄纬假设β=0。
2. 将公式λ解释为日期真黄道／真春分点黄经；不额外加章动黄经或另作岁差。
3. 构造单位向量(cos λ, sin λ, 0)，用当前已安装的Astronomy Engine 2.1.19 `Rotation_ECT_EQD`旋到日期真赤道。
4. 只有输入盘宿界坐标、真赤道frame、历元都相符时，才把该RA交给本应用现有`mansionOf`。输出宿度带`conditional:true`。

方向点没有实物距离，所以不声称有物理视差、像差或折射。它和恒星宿界采用同一赤道坐标基底，但不能由此说紫炁是真实天体。来源诊断、投影扩展及全部假设同时保存到结构化结果。

## 有界条件解释

本扩展只实现紫炁的四条软件表事实：申→庙、丑→旺、亥→旺、戌→喜。

每条均输出明确的地支宫条件、当前是否命中、来源ID和重新撰写的条件解释。十二地支宫采用上述黄经30°等分，左闭右开；不使用RA来替代黄经，也不按实际地平宫位或ASC分宫。其它宫显示`not-listed`，不能推断为“平”“无凶煞”等。没有综合分数、成功概率、财富／健康结论，亦没有借此宣称完成全套果老格局。

## 未扩大的范围

没有其它紫炁位置公式必须与本项绑定。现有七政、升降交点及月球远地点已有独立明确定义，继续使用本应用现有计算；不为了源软件外观一致而改动它们。古制宿钤、命身宫、神煞、会照格局、洞微限运等继续保留原未覆盖项。古籍中的约28年周期只能提供粗粒度背景，不能为这个精确软件历元背书。

## 核验边界

- 32个Node测试组通过：历元、资料与执行常数差异、正负周期及绕回、1800–2200历日、时区、UTC与TT、速度、固定角诊断、坐标框架、条件宿度、所有既有点不变、规则分支、UI安全和DOM结构。
- 8个50位Decimal独立公式算例通过。它们是独立算术复核，不是外部星历认证，也不是执行源软件的parity证明。
- 现有20个七政回归测试通过。
- UI验证为linkedom DOM层；没有启动浏览器，没有宣称真实浏览器渲染或截图验证。