## 0.62.1（2026-11-04，待发布） > 本版主题：全项目复查补漏——星座/生命数字的日期尺与全插件统一、非法 action 不再静默落默认、次级入口的 null 守卫。 - **星座 / 生命数字日期尺统一到 1600–2400**（`engine/star.js`、`engine/numerology.js`）：两套各自卡 1900–2100，同一份生日在八字/紫微/黄历可排，到星座/生命数字却被拒；现与 `parseDateTime` / `assertCivil` 同一把尺（越界由日期解析层报 `E_RANGE`），并补 1600 / 2400 / 1599 / 2401 边界断言。 - **非法 action 不再静默落默认分支**（`engine/index.js`、`engine/fengshui.js`、`engine/name.js`）：`fengshui action:'nope'` 以前照样按 natal 排、`name action:'nope'` 照样按 assess 评名；现在直接 `E_INPUT` 并列出合法值（不传仍按默认）。 - **次级入口 null 守卫**（`engine/trend.js`、`engine/mbti.js`、`engine/qimen.js`）：`buildTrend(null)` / `buildMbti(null)` / `buildQimen(null)` / `buildSnapshot(null)` 不再抛裸 TypeError，统一 `E_INPUT`。 - **回归锁**：`test/guard-inputs.test.mjs` ⑲–㉑ 新增 14 条；`test/chunks.test.mjs` 的起名参数从旧别名 `evaluate` 改为 schema 支持的 `assess`。 - 基线：**154 文件 / 7894 条断言**（7880 → 7894，全为新增）。 ## 0.62.0（2026-11-04，已发布） > 已发布：npm `dsh-metaphysics@0.62.0`，shasum `b9563b742dd7ef0f394e8f19b0a69934f6910f01`，101 个文件；tag `v0.62.0` 与 GitHub release 已建。 - **复查报告 50 项：排盘口径、输入守卫与提示层**（`engine/*`、`index.js`、`src/panel-kit.js`、`test/*`）： - P0 · 紫微晚子时（`engine/index.js`、`engine/ziwei.js`）：`lateZi` 与紫微历史参数名 `lateZishi` 不互通，revise 回执「已应用」但盘仍按 current-day 排；现统一映射（`lateZi:false` → `current-day`），回执与盘面同源。`hourUnknown` 的过去盘也改为按正午占位，与主盘落在同一张盘上。 - P1 · 档案两个开关（`src/panel-kit.js`、`index.js`）：`profClean` 白名单漏掉 `trueSolar / lateZi`，存卡时被剥掉、载入时又按默认「都开」；现无条件落盘，旧档案缺字段仍按默认处理。 - P1 · 紫微合盘丢主星（`engine/ziwei-hepan.js`）：星型标签是中文字面量 `主星`，旧过滤拿 `main` 比对，主星永远进不了合盘；现按 `主星 / 吉星 / 煞星` 取。 - P1 · 奇门健康用神（`engine/qimen-interpret.js`）：天芮在中宫寄坤后被统一改名「禽芮」，按原名定位不到；驿马只存在 `r.ma.gong` 而不在 `palaces[].star`；主用神缺位时又被次级候选掩盖。现加星名别名、驿马单列、主用神缺位写入 `unresolved`，不再只剩一句「若以死门为用神」。 - P1 · 梅花时间起卦（`engine/meihua.js`、新增 `engine/datetime.js`）：原先自带一份宽松解析器，`1990-02-30`、13 月、25:00 都能过；现与八字/紫微共用 `parseDateTime`（1600–2400、逐日校验），数字起卦的动爻 `changing` 只收 1–6 整数，非法直接 `E_INPUT`。 - P1 · 大六壬三传（`engine/daliuren.js`）：遥克改为先全盘找蒿矢、没有再找弹射（不再逐课先到先得）；昴星按阳日虎视取地盘酉上神、阴日冬蛇取天盘酉下神，中末传按阴阳日分别取支上/干上；八专按阳顺阴逆数三神；伏吟初传自刑时中传换另一上神、仍自刑取冲。三传不再整盘套通用递推。 - P1 · 生时校正 10 年窗口（`engine/bazi.js`、`engine/index.js`、`engine/rectify.js`）：流年窗口新增 `liunianTo`，几十年前的事件可以逐年对账；候选按「日柱+时柱」合并（真太阳时会把相邻整点并进同一时辰），结果里报告合并掉了几个输入整点；虚岁改按公历年算，与趋势页同口径。 - P1 · 工具层参数（`index.js`）：`hour / date` 只给 `chenggu / xiaoliuren`，别的体系传了直接报错（原先收了不看，用户以为改了时刻）；`partner2` 也做地址长度校验；带句柄再换地址时丢掉上一轮派生的 `longitude / geo`，新地址真正重新解析；三方盘也按出生地解析经度；`system` 缺失时才在 `run()` 报错，schema 仍不写 `required`（只给 handle 的追问是主推用法）。 - P2 · 三奇入墓（`engine/qimen.js`）：按《玄机赋》阴干逆行取墓改为 乙→戌/乾六、丙→戌/乾六、丁→丑/艮八；原表把乙放未/坤二、丁放戌/乾六。 - P2 · 奇门时旬空（`engine/qimen.js`）：空亡改按**时柱所在旬**取（如甲子旬空戌亥），不再拿日旬顶替；补注释说明五鼠遁晚子时口径。 - P2 · 紫微亮度「闲」（`engine/ziwei-words.js`）：五档亮度表含「闲」，词库缺这一档会被当成庙旺；补 `闲地 / neutral / 可用的力不多`，测试锁定该档。 - P2 · 紫微魁钺流派（`engine/ziwei.js`、`engine/diff.js`、`index.js`）：删除与 qs1 同表的「network」选项，schema / 差异标签 / 测试同步，避免选了「网络派」实际按另一派排。 - P2 · 塔罗张数（`engine/tarot.js`）：`count` 只收 1 / 3 / 5，`2 / 4 / 0 / 7 / 3.5` 直接 `E_INPUT`；原先静默折成 3 张，牌阵与用户要求不符。 - P2 · 六爻爻值（`engine/liuyao.js`）：`lines` 必须正好 6 个、每个 6/7/8/9；空参数、缺爻、非法值统一 `E_INPUT`，不再在深处抛裸 TypeError。 - P2 · 输入标量（`engine/index.js`、`engine/fengshui.js`、`engine/trend.js`）：`verifyPast` 必须是 1–10 整数（6.5 / "6" 不再静默当没传、11 不再截成 10）；`fortuneYear` 必须是整数年份；`toAge` 必须是 10–100 整数；经度只收 number 与十进制数字串（`true / [] / " "` 不再按 1°/0° 静默算真太阳时）；`mode` 按体系分组校验，跨组直接报错；`asOf` 按同一日期尺归一，只给日期 / 带空格 / ISO 三种写法出同一张盘。 - P2 · 地支关系取句（`engine/bazi-words.js`）：半合/拱合、半会/拱会各自成句，不再落进泛泛的「合」；自刑仍优先于刑。 - P2 · 风水阴阳遁（`engine/fengshui.js`）：飞星补上 `forward` 方向，阴遁逆飞不再按顺飞排；`fortuneYear` 非整数报错而不是当没给。 - P2 · 称骨晚子时（`engine/chenggu.js`）：23:00–23:59 与八字/六壬/奇门同口径按次日取农历日与日柱，并在 `input` 里标 `lunarDateShifted`。 - P2 · 公农历范围（`engine/convert.js`）：与 `assertCivil` 统一到 1600–2400，非法日期与超范围年份改 `E_INPUT`，不再抛裸 Error 或把 1600 年说成 1900。 - P2 · 追问兜底（`engine/followup.js`）：12 个不产 `interpret.sections` 的体系，改为按 `summary` / 神煞分组回答，不再一律回「没有可追问的分节」。 - P2 · ΔT 低年段（`engine/calendar.js`）：1600–1900 改用 Meeus 多项式（1600 年约 120s）；原先整段取 1900 常数，1600 年误差 123s，与函数注释自相矛盾。 - P3 · 地址解析（`engine/geo.js`）：同名区县（中山区→大连、朝阳区按省份/默认北京）不再被同名城市抢走；「中山路」这类全国路名缺城市线索时返回未匹配并提示补城市；「河北区」不再按河北省会算。 - P3 · 联网 UA（`engine/geo.js`）：`User-Agent` 去掉版本号，只保留应用名与仓库地址，避免发版漏改造成失联（OSM 政策只要求可识别）。 - P3 · 产物与死代码（`engine/lunar.js`、`dst.js`、`yingqi.js`、`tiaohou.js`）：删掉未使用的 `cursorStart / monthStartJd / withDstNote / monthTone / monthSameBranches`，`YINGQI_RULE_IDS` 直接指向 `RULE_ORDER`；合并句柄增量时用无原型对象承接 `__proto__`，派生 `geo` 不进影子盘指纹；调候表重复的 `热` 键清理。 - P3 · 共用日期尺（`engine/datetime.js`、`engine/zeri.js`、`engine/index.js`）：日期校验收成一套 `parseYmd / parseDateTime`，择日与小六壬不再各写一份正则；空参数统一 `E_INPUT`（星座/生命数字/姓名/择日/小六壬/风水等）。 - P3 · 文案与文档：八字缺时柱的说明改为「旺衰、格局、用神、调候暂以正午时柱估算」，不再声称时柱不参与任何判定；日期 tab 默认今天确认为有意行为，不改代码。 - 回归锁：`test/tarot.test.mjs`、`test/tool-geo.test.mjs`、`test/qimen-rules.test.mjs`、`test/guard-inputs.test.mjs`、`test/verify.test.mjs`、`test/ziwei-words.test.mjs`、`test/ziwei-schools.test.mjs` 同步到新口径；地址同名/路名 8 条、奇门时旬空 6 条、fortuneYear 与引擎入参守卫 12 条为新增断言。 - **复查收尾时又查出的「修了但没生效」四处**（`engine/index.js`、`engine/tarot.js`、`index.js`、`test/*`）： - `lateZi` 只改到了八字 / 大六壬 / 紫微，`compute()` 往称骨、小六壬、梅花传参时仍把它漏在门外——引擎各自支持、工具层却收不到，用户关掉晚子时，这三套仍按换日排。三处分支补齐透传，并加断言锁「同一时刻开 / 关晚子时得到不同结果」。 - `verifyPast` 的数字串整形写在 `computeRaw()`，而「摊开过去流年」的代码在它上游的 `compute()` 里先跑了：`verifyPast:'6'` 先被当成没传、整形再也没机会执行。整形前移到 `compute()` 调用点之前，`'6'` 与 `6` 等价，非法值统一 `E_INPUT`。 - 塔罗全盘解读遇到缺 `position` 的牌会拼出「（undefined·正位）」；改为按牌在阵中的序位回退（`第 N 张`）。 - 三方合盘的第三方地址此前只做长度校验、没有走联网解析，出生地填了但真太阳时仍按 0° 算；第三方与主方 / 对方同一条解析路径。 - **构建链补齐 `datetime` 与 `ziwei-words`**（`tools/build-client.mjs`）：`parseDateTime` 抽到 `engine/datetime.js` 后没进 `ORDER`，浏览器产物里会报 `parseDateTime is not a function`；`ziwei.js` 引用 `ziwei-words` 的 `SHA_STAR` 时，模块顺序又排在 `ziwei` 之后。两处都补进 `ORDER` / `COMMON`，18 个分块与单包重新生成，`layout / security / chunks / client-bundle / standalone` 恢复全绿。 - **第二轮复测 16 项：本轮修复自己引入的回归，与上一轮没修到底的边角**（`engine/*`、`index.js`、`README.md`、`test/*`）： - P2 · 调候「热且湿」被翻档（`engine/tiaohou.js`）：`judgeClimate` 里 `hot` 先短路，`hot && damp >= 0.8` 那条湿滞分支从未命中；上一轮为了接通它把热+湿并进「湿滞」，3.4% 的盘由「温热 / 需壬水」变成「湿滞 / 需丙火」——闷蒸之局判成「加火来蒸」，等于往蒸笼底下添柴，还顺手把 `favor` 首位换掉。现单列 `湿热` 一档（取水 / 壬 / 忌火），`KIND_NAME`、`DAY_FEEL` 五株日主同步；不热之湿（湿滞取丙火）一字未动。同一处旁白不再按「档名含不含寒」猜忌神（`湿滞` 会念成「要的不是更多的火，而是丙火」），改取 `NEED[kind].avoid`。回归锁：`test/tiaohou.test.mjs` 锁档位与取用、报告点名的两张盘（1935-06-06 / 1995-06-12）喜用仍含水、火没被顶到首位、水没被删成忌神、旁白忌神与 `avoidElement` 逐档对拍、档表三处不许留空。 - P2 · 奇门「最终倾向」7/7 方向恒不判决策（`engine/qimen-interpret.js`）：`用神有 N 个候选` 也算未决项，而 YONG_SHEN 每个方向本就是「主用神 + 一两个辅用神」、辅用神必然落宫 ⇒ `unresolved` 恒非空，上一轮加的倾向分支一次也没跑过；主用神缺位时又被死门这类次级候选撑住，「用神未上盘」永不触发。现只看主用神是否上盘（缺位写 `主用神X未上盘`），`primary` 优先取主用神行，辅用神同盘不再算未决、候选清单仍在 ④ 逐条列出。回归锁：`test/qimen.test.mjs` 锁七个方向都出倾向、未决项为空、措辞仍是条件式；把开门从盘上摘掉，career 仍须退回未决并点名缺哪个。 - P2 · `hour` 守卫把 `name` 自己宣传的生辰路径封死（`index.js`）：0.61.2 把 `hour` 限给 `chenggu / xiaoliuren`，而 name 的 schema 明写「年/月/日 + 时/分」，`{ system:"name", year, month, day, hour }` 被宿主当场拦下。白名单补 `name`，`minute` 单列只给 name；其它体系传 `hour / minute / date` 仍报错（收了不看会静默排出另一张盘）。回归锁：`test/args.test.mjs`。 - P2 · 句柄里的 `hour / date / mode` 让「带 handle 换 system」直接报错（`engine/handle.js`、`index.js`）：文档主推 `{ handle, system:"ziwei" }`，而称骨与小六壬的句柄必带 `hour`、convert / 梅花 / 小六壬必带 `mode`；并回参数后宿主按「用户本轮误传」拦下——上一张盘的输入挡住了这一张盘。新增 `SYSTEM_KEYS` 与 `pruneForeignKeys(merged, owned)`：换体系时剔掉新体系不读、本轮又没显式重给的键（`hour / minute / date / mode / action`），显式重给的照旧拦。顺带把联网解析的 `geo` 详情排除出句柄（`display_name` 换个语种就换一把句柄），只留 `longitude`。回归锁：`test/handle.test.mjs` 锁换体系后的新句柄不带上一张盘的 `hour`、一句话改参换体系同一条尺，`test/shadow.test.mjs` 锁 geo 文案不同而经度相同仍是同一张影子盘。 - P2 · schema 漏 `upper`，梅花数字起卦在工具面不可表达（`index.js`）：引擎读 `args.upper`，schema 只有 `lower / changing`，模型照 schema 组参永远起不出数字卦，而 `mode` 的说明还在教「数字起卦需 upper/lower」。补 `upper` 并写明与 `lower` 成对；同处加一条清单断言——从 `engine/index.js` 逐个扫 `args.*`，凡用户参数都必须在 schema 里声明（`geo / shadowVersion / schools` 三个宿主内部键单列），并给扫描设条数下限，防止「扫不到键」反而空过。回归锁：`test/guard-inputs.test.mjs` ⑭ 与「按 schema 组参能起出数字卦」「数字卦与引擎直连同卦」。 - P3 · geo 为挡「中山区」把 `县` 一起拉黑（`engine/geo.js`）：`长沙县 / 乌鲁木齐县 / 承德县` 整条解析失败，真太阳时被静默取消，摘要还写「未提供出生地或经度」。`NOT_CITY_AFTER` 去掉 `县`（县名多与辖它的市同名、县城就在城区边上，按本市经度估算比判「未匹配」准得多），`区` 与 `镇 / 乡 / 路` 仍挡（重庆开州区真有一个长沙镇）；命中县档时 `level` 写「区县」、`note` 说明借用城区经度。回归锁：`test/tool-geo.test.mjs` ⑦ 四条县名 + note 文案 + 工具层「长沙县」拿到 112.94 并进摘要、不再说「没查到」。 - P2 · `parseYmd` 没有年份闸（`engine/datetime.js`、`engine/validate.js`、`engine/zeri.js`）：`parseDateTime` 早就有 1600–2400，`parseYmd` 只查月/日，于是小六壬 `date:'0000-01-01' / '1500-01-01' / '2500-06-01' / '9999-12-31'` 静默出盘；择日越界虽然报错，文案却甩锅「黄历 的 year 超出支持范围」（`2400-12-30` 起算 +3 天也这样）。`parseYmd` 复用同一对 `MIN_YEAR / MAX_YEAR`，择日改用自己的 `who` 与字段名。回归锁：`test/guard-inputs.test.mjs` ⑮ 逐值 `E_RANGE`、两端点仍可排、闸的边界等于 `validate` 的常量、择日文案点名 `startDate` 且不再提黄历。 - P2 · 晚子时换日越过 1600–2400 边界（`engine/meihua.js`、`engine/xiaoliuren.js`、`engine/chenggu.js`、新增 `assertShifted`）：`2400-12-31T23:30` 通过入参校验后被整体搬到 2401 出盘，而直接填 `2401-01-01T00:30` 会被 `E_RANGE` 拒——同一张盘「换日就通、直填就拒」。三处换日统一走 `assertShifted`，报错点名是换日所致。回归锁：`test/guard-inputs.test.mjs` ⑮ 逐体系 `E_RANGE` 且文案含「晚子时按次日归后」。 - P2 · 三奇入墓换表后知识库与 README 仍教旧表（`engine/interpret-knowledge.js`、`README.md`）：盘面说「乙阴木墓于戌，戌在乾六宫」，同一页知识库说「乙木墓未（坤二）」，而且已经打进分块与单文件页、用户直接可见。词条改成辛/戌（乾六）、丁/丑（艮八）并写明「阴干取墓」口径，README 两处同步。回归锁：`test/interpret-knowledge.test.mjs` 的期望值由 `LIUYI_RU_MU` / `ruMuOf` 现推，改表不改文案立刻挂。 - P3 · 次级入口仍抛裸 TypeError、六爻 `lines` 非数组仍静默随机（`engine/liuyao.js`、`engine/tarot.js`、`engine/name.js`、`engine/convert.js`）：上一轮只修了 7 个 `build*` 主入口。`yongshenOf(r, null)` 一路走到读 `opts.direction`，`hexBody(null)`、name / convert 的空参数同样炸；更坏的是 `lines` 传字符串或对象时被当成「没给」，悄悄换成随机摇卦——用户以为排的是自己那六爻。八处次入口统一 `assertObject` / 显式报错，爻值这一族的码统一 `E_LINES`（长度不对不再改随机）。回归锁：`test/guard-inputs.test.mjs` ⑯ 11 组坏形状逐个 `E_INPUT`、文案既说「收到什么」也说「该传什么」、四条正常路径照旧出盘、留空 `lines` 仍走随机摇卦；`test/args.test.mjs` 从工具面走四个坏形状，两侧码一致（同一个错换个入口进来不能换码）。 - P3 · 影子盘 `asOf` 归一不彻底（`engine/index.js`、`engine/ziwei.js`）：`asOf:'2030-01-01'`（补 12:00）与 `'2030-01-01T12:00'` 出的盘逐字段相同、`baseId` 与句柄却各一套；首尾空格仍 `E_ASOF`（`datetime` 是 trim 的）；`shadowParams` 仍吞自有 `__proto__` 键（`canonicalJson` 已避过这个坑）。新增 `normalizeAsOf`（trim → `asOfParts` → 只给日期补 12:00），排盘、句柄、影子盘指纹与 `checkAsOf` 共用这一把尺；`asOfParts` 与 datetime 一样 trim；没给 `asOf` 时一个键都不加（`null` 整段进句柄等于给所有旧深链换身份）；`shadowParams` 一律 `defineProperty` 写键。回归锁：`test/shadow.test.mjs` ⑨ 三种写法同句柄同 `baseId`、整张盘 JSON 全等，反向锁 `00:00 / 12:30 / 次日 / 不钉 asOf` 各得不同身份，句柄回放同盘、纯空格按「没钉」处理、`__proto__` 不再撞指纹。深链那一侧不需要新断言：`test/bridge.test.mjs` 的「句柄原样进链接」与「参数往返一致」就是这条的探针——归一化最初写错位置（放进 `computeRaw` 而影子盘尾巴在 `compute`）时，就是这里先变红的。 - P3 · 六壬伏吟自刑兜底没换到「另一个」（`engine/daliuren.js`）：有克伏吟的初传常常就是第 1 课上神，兜底再取干上神 ⇒ 218 盘自刑伏吟里 74 盘（34%）中传 == 初传（`2026-01-01T01:30` → 辰/辰/戌）。兜底改为在干上 / 支上两个候选里取与初传不同的那个，仍无解才回退。回归锁：`test/daliuren.test.mjs` 锁点名盘不再辰/辰/戌、末传取冲，并扫 400 天 × 12 时辰（4800 盘）自刑伏吟零撞车。 - P3 · 生时校正两条（`engine/rectify.js`）：`[{year:1601},{year:2399}]` 是合法输入却跑 1267ms——窗口按事件年份逐年排盘，每个候选排 799 年流年（30 年跨度只要 9ms）。加 `MAX_SPAN = 120` 上限，报错里写清实算区间；另一条是出生前的事件此前照样进窗口并计分（`age` 为负），出生 1990 报 1985 会污染排名，现早于出生年直接 `E_INPUT`。回归锁：`test/guard-inputs.test.mjs` ④ 锁两条报错、120 年整窗仍放行、合法调用不再跑到秒级、窗口文案与实算区间同源。 - P3 · 数字串形式的显式经度被联网解析顶掉（`index.js`、`engine/index.js`）：`{ address, geocode:'online', longitude:'87.6' }` 解析成 121.5，改成 number 才正常——上一轮「保留用户 longitude」只保护了 number 类型，而解析前的判定读的是 `typeof === 'number'`。宿主在地址解析之前先调 `normalizeLongitudes`（`'87.6'` → 87.6；非十进制或超范围当场 `E_RANGE`，且不发网络请求）。回归锁：`test/tool-geo.test.mjs` ⑧ 锁数字串与数字两条路同盘、显式经度在场时零次联网、没给经度时联网解析照旧生效。 - 体积：这两轮的守卫与 geo 新增的 23 个地级市坐标（286 → 309）随 `COMMON` 进每一块，`bazi / hepan / ziwei` 由 223.9 / 223.1 / 219.8KB 涨到 228.5 / 227.4 / 223.9KB（gzip）⇒ `test/chunks.test.mjs` 的分块线 228 → 232KB，注释里写明抬的是守卫与坐标表、不是新库，下一次再往这三块塞引擎就得拆块；CI 侧 `check-bundle.mjs` 的 260KB 单块硬墙与 2.75MB 总量墙不变。 - **回归锁与基线**（`test/*`、`test/assertion-baseline.json`）：塔罗测试从「非法张数静默折 3」改为「非法张数逐值报 `E_INPUT`」，那 4 组行为断言是有意替换、不是删除；两轮修复落地后基线更新为 **154 个文件 / 7880 条断言**（7718 → 7865 → 7880，全是新增的行为断言，没有删除或注释掉的旧断言）。 - **发版前复查又抓到两处边界**（`engine/bazi.js`、`engine/daliuren.js`、`engine/qimen.js`、`engine/ziwei.js`、`engine/convert.js`、`test/guard-inputs.test.mjs`、`test/fuzz.test.mjs`）： - 晚子时换日跨出 1600–2400：`2400-12-31T23:30` 在八字 / 大六壬 / 奇门（`lateZiHourMode:'next-day'`）/ 紫微（`lateZishi:'next-day'`）会被整体搬到 2401 继续出盘，而直填 `2401-01-01` 早被 `E_RANGE` 拒——同一张盘两套资格。四处统一走 `assertShifted`，报错点名「晚子时按次日归后落到 2401-01-01」；`22:30`、显式 `lateZi:false`、奇门 same-day、紫微 current-day 照旧可排。 - 农历 2400 年末（腊月 1–29 日）换算到公历 2401 时，原先一路走到 `buildAlmanac` 才抛「黄历 的 year 超出支持范围」（`E_INPUT`），把目标越界说成黄历的错；现 `convert` 在换算后先校验目标公历，报 `E_RANGE` 并点名「农历 2400 年腊月29日换算得到的公历日期 2401-02-12 超出可计算范围（1600–2400）」。 - 回归锁：`test/guard-inputs.test.mjs` ⑰⑱ 共 15 条（四体系越界文案、三套不换日照旧、convert 越界与边界内）；`test/fuzz.test.mjs` 边界日期改用 22:59，越界行为由 guard 测试单独钉住。 ## 0.61.2（2026-11-03，已发布） > 本版主题：输入与状态 bug 批——跨盘残留、历史漏参、生时校正跟错盘、K 线出生地失效等 13 处，全部有真机回归锁；排盘引擎与历算口径一字未动。 > 已发布：npm `dsh-metaphysics@0.61.2`，shasum `cd9281c6a9f9fbb9c3879b075877a3486f8c2257`，100 个文件；tag `v0.61.2` 已推，GitHub release 已建，tarball 已下载核对。 - **0.61.1 之后又查出的一批输入与状态 bug**（`src/app.js`、`src/web-ui.js`、`src/panel-kit.js`、`test/date-input.test.mjs`、`test/features.test.mjs`、`tools/e2e-dom.mjs`、`tools/e2e-panel.mjs`）： - 现象一（面板 · 日期被截断）：0.61.1 把日期框改成受控输入后，打字过程中一解析出合法日期就 `props.onChange`，父组件回写 `value` 把草稿冲掉——敲 `1990-05-12`，中途 `1990-05-1` 被补成 `1990-05-01`，再敲 `2` 丢位，最终**静默排成 1 日**。`page.fill` 一次写整串测不出来，真实键盘逐字输入必现。 - 现象二（独立页 · 藏起来的字段还在拦人）：塔罗、人格两个体系把日期框隐藏了，但 `run()` 仍拿 `usesTimeInput()` 校验日期——日期框一旦为空，点「抽牌」就被「请填写公历日期」挡住，且无从下手。 - 现象三（独立页 · 跨盘残留）：验前事的自评、贴合度与生时校正的候选时辰是模块级变量，换一张盘只重绘不清空，旧候选时辰会贴在另一张盘下面。 - 现象四（面板 · 历史记成上一张盘）：切体系 / 看示例 / 载入档案都是「同一个 handler 里先 `setState` 再 `run`」，历史条目读的却是渲染闭包里的旧 `date/time/gender/address`；「时辰未知」的三柱盘重放后被当成正午出生；`localStorage` 里旧版本或半截写入的坏条目会让 `x.date.slice` 抛错，整块面板白屏。 - 现象五（面板 · 生时校正跟错盘）：反推候选时辰时用的是表单此刻的日期/性别/出生地，而不是屏幕上这张盘的值；档案没存出生地时会沿用上一个地址。 - 现象六（独立页 · 小六壬）：时刻框被清空时 `Number('') === 0`，悄悄按子时起课，而不是退回正午。 - 现象七（面板 · 合盘重放排成另一个人）：合盘历史只记主方生日，没记对方（及第三方）的生日、性别、出生地；点旧条目时 `run()` 读的是表单里此刻的对方资料，排出来的已不是当初那张盘。更隐蔽的是两条「主方相同、对方不同」的合盘会被 `sameEntry` 当成重复条目，短的一条被直接顶掉。 - 现象八（独立页 · 生时校正跟错盘）：排完盘后只改表单的性别 / 出生地 / 真太阳时 / 晚子时（不重新排盘），再点「计算候选时辰」，`doRectify()` 读的是表单此刻的值，候选时辰会按另一套输入反推，与屏幕上这张盘对不上。 - 现象九（独立页 · 档案把上一个地址带进来）：档案允许不填出生地，但「载入」与「改名读回」只在字段非空时才写回输入框；上一张盘的地址留在框里，这张档案随即按别人的地方算真太阳时。点「改名」再「更新」还会把那个错地址存进档案，从此固定下来。 - 现象十（面板 · 历史漏记两个开关）：真太阳时与晚子时都会改变时柱，历史条目却只记生日 / 时刻 / 性别 / 出生地。排完盘再拨动开关、点回旧条目，重放会跟着表单此刻的勾选重算；两条只差开关的盘还会被 `sameEntry` 当成重复条目顶掉。 - 现象十一（人生K线 · 出生地不起作用）：K 线页是出生盘，表单给着性别、出生地、真太阳时与晚子时，但 `run()` 只对八字 / 紫微 / 合盘传地址，K 线拿不到经度——出生地填了等于没填，真太阳时开关也跟着失效；同一份输入在八字页与 K 线页可能算出不同的时柱。 - 现象十二（档案 · 两个开关没入档）：命盘档案只存了生日 / 时刻 / 性别 / 出生地，真太阳时与晚子时没存。存卡时关着这两个开关，过几天载入，重排却跟着表单此刻的勾选走；档案层 `profFromForm` 也没把开关带出来（面板、独立页两端同时缺）。旧档案因此永远按「都开」的默认处理，而不是表单此刻的状态。 - 现象十三（面板 · 历史漏记各体系自己的输入）：历史条目只记了各体系共用的生日 / 时刻 / 性别 / 出生地，奇门流派与晚子时、择日事项 / 天数 / 属相 / 候选日、小六壬起课方式与三个数、K 线算到几岁、风水看什么 / 坐向 / 运、起名方式 / 姓 / 名 / 候选数、公农历转换方向 / 农历日 / 闰月，全都没进条目。点回旧条目时按表单此刻的值重算，看到的已不是当初那张；`sameEntry` 也没比这些参数与六爻方向 / 张数、梅花动爻，两条输入不同的盘会被当成重复条目顶掉。 - 改法：面板日期框打字只写草稿，提交只发生在失焦 / 回车（并补真机逐字输入断言）；独立页的日期显隐与校验共用 `usesTimeInput()` 一处判断；每次新盘成功落盘前清空 `pastMarks / pastFit / rectOut`；历史条目改记本次实际生效的输入（覆盖值 `dt/genderV/addressV`），新增 `hourUnknown` 字段并纳入去重与重放，读入时过滤非对象条目，渲染对缺失字段做兜底；生时校正改用 `result.at / result.gender / result.address / trueSolar / lateZi` 快照（面板与独立页各一套，独立页把这几项一并存进 `last`）；档案载入与改名读回都把 `date / time / gender / address` 无条件写回输入框（空出生地按空字符串覆盖，面板此前已经是这个口径）；小六壬按 `HH:` 正则取小时，取不到退回 12；历史条目补记 `trueSolar / lateZi` 并在 `sameEntry` 里按「缺字段＝默认开」比对，`replay` 时一并还原（旧条目缺字段则保持表单现状）；人生K线并入出生盘分支，与八字共用同一段「性别 + 出生地 → 经纬度 → 真太阳时」透传（面板与独立页各一处，`cross` 仍只给八字 / 紫微）；合盘历史把 `hpChart / partnerDate / partnerTime / partnerGender / partnerAddress / thirdOn / p2Date / p2Time / p2Gender / p2Address` 一并存下，`sameEntry` 比对它们，`replay` 逐项还原（旧条目缺字段时不动当前值）；档案层 `profFromForm` 落 `trueSolar / lateZi`，面板存卡、载入（含 `run` 覆盖参数）与独立页载入 / 存卡都带上这两个开关，旧档案缺字段按默认「都开」；各体系自己的输入（奇门流派 / 晚子时、择日事项 / 天数 / 属相 / 候选日、小六壬方式与三个数、K 线岁数、风水模式 / 运 / 坐向、起名模式 / 姓 / 名 / 候选数、转换方向 / 农历日 / 闰月）一并存入历史并进 `sameEntry`，`replay` 按条目类型逐项还原（旧条目缺字段则不动表单）；六爻 `direction / count` 与梅花 `changing` 也进去重比对。 - 回归锁：`test/date-input.test.mjs` 新增 19 条口径断言（打字不提交、显隐与校验同源、清空模块状态、历史参数、坏条目过滤、独立页校正按 `last` 快照、档案空地址清残留、K 线并入出生盘分支等）；`test/features.test.mjs` 新增 14 条历史与档案断言（合盘条目带对方信息、去重比对对方信息、重放逐项还原、两个开关入历史 / 入去重 / 入重放、各体系参数入条目 / 入去重 / 入重放、档案层与两端都存两个开关）；`e2e-dom` 新增 15 项真机断言（逐字输入、日期空着抽塔罗、换盘清候选、改出生地不重排时候选不跟着换、无地址档案载入/改名不被上一张盘的地址带偏、K 线换地址结果随之变化）；`e2e-panel` 新增 19 项（含「看示例」历史条目必须是示例盘自己的参数；合盘换对方后两条历史并存，点回旧条目对方生日与时刻复原；两个开关重放复原；K 线的出生地生效；择日「开业 / 嫁娶」各占一条历史，点回旧条目事项与候选日复原）。把任一修复回退，对应断言都会转红——已逐条验过。 - 随 0.61.2 发布；引擎与排盘口径未动，同一份输入出的盘与 0.61.1 逐字节相同。 - **自动发布还有一处同类漏口**（`tools/autopublish.mjs`、`test/autopublish.test.mjs`）： - 现象：0.61.1 的发布回写只改 CHANGELOG 与文档，源码指纹没变；主流程在「指纹与上次一致」处直接 return，连「本地是否领先远端」都没查——那一类假成功刚修完，更早的一处仍在积压永不推送的提交。 - 改法：把领先数抽成 `aheadCount()`（`origin/main..HEAD` 全仓库只有这一处实现），指纹未变时也先查它：为 0 才报「无改动，跳过」，不为 0 就记「指纹未变（…），但本地领先远端 N 个提交，继续推送」并走同一条推送路径；`--dry-run` 的 reason 同步区分「源码/配置有改动」与「本地领先远端，只推送已提交的 commit」，日志不再把未变的指纹说成「检测到改动」。 - 回归锁：新增 4 条源码级断言（指纹分支查领先、只有不领先才 return、领先时继续推、日志两种说法都在）＋1 条「`origin/main..HEAD` 只许有一份实现」的结构锁；把指纹分支回退成直接 return，前两条立刻转红。 - 只动工具链，不进 npm 包（发版清单里没有它），排盘与页面产物一字未改。 ## 0.61.1（2026-11-03，已发布） > 已发布：npm `dsh-metaphysics@0.61.1`，shasum `0254c8a0d40ea443d9abe006c141a470234f6c04`，100 个文件；tag `v0.61.1` 指向发版提交 `3799db4` 并已推，GitHub release 已建，tarball 已下载核对。 > 本版主题：输入层与自证层——出生日期不再跟着浏览器区域翻顺序，产物自己说得出「这一版之后又改了什么」，顺带修掉自动发布的假成功。 - **排盘日期框固定成「年-月-日」**（`src/app.js`、`src/web-ui.js`、`tools/build-html.mjs`、新增 `test/date-input.test.mjs`）： - 现象：出生日一直用原生 ``，显示顺序由**浏览器区域**决定——中文环境给 `年/月/日`，一旦被切成 en-US 就变成 `月/日/年`，独立页与面板都跟着翻。用户按习惯填「5 月 12 日」，引擎收到的是 5 月 12 日还是 12 月 5 日，取决于宿主区域设置，排错盘还很难归因。 - 改法：删掉原生 date 控件，改成文本输入 + 自制掩码（`maskDateText` / `normalizeDateText` / `isoDateOk` 三件套，面板与独立页各一份、口径逐字对齐）。输入时只留数字并自动补连字符（`19900512` → `1990-05-12`），同时认 `1990/5/12`、`1990年5月12日` 这类粘贴写法；失焦或回车才补零成 `YYYY-MM-DD` 并往引擎提交，非法值不提交。 - 为什么中间态不补零：刚敲下 `1990-05-1` 就补成 `-01`，下一个 `2` 会拼成 `012` 被截掉，看起来「吞键」。掩码只放行 `^\d{0,4}(-\d{0,2}){0,2}$` 这种半成品，把补零推迟到失焦——这是真机逐字敲出来的 bug，不是假想。 - 非法兜底：输入过程中非法就 `aria-invalid` 转红（模板加了对应 CSS），失焦时非法值**退回最近一次有效值**而不是留一个引擎不认的串；独立页点「排盘」时日期不合法直接给出「按年-月-日填写，例如 1990-05-12」并中止，面板则把同样的话写进提示区。合盘/三方/紫微飞星的四字段时间输入一并改。 - 验证：`test/date-input.test.mjs` 用 `new Function` 把两处辅助函数从源码里取出来独立求值，13 条用例 × 2 入口 + 7 条「面板与独立页结果一致」+ 6 条模板守卫（`type="text"`、占位符写明顺序、全页不得再出现 `type="date"`）。断言基线 7524 → 7565（152 → 153 个文件）。Playwright 在真 Edge 里跑过逐字输入、带连字符输入、非法月日回退三条路径；`e2e-dom` 137 项通过。 - 引擎、历算、口径一律未动：这是纯输入层修复，同一份 `YYYY-MM-DD` 进去，出的盘与改动前逐字节相同。桌面版 exe 里的 HTML 已随这次一并重建。 - **不发版本号，也要能自证改了什么**（新增 `tools/unreleased.mjs`、`test/unreleased.test.mjs`；接线 `tools/build-html.mjs`、`tools/build-client.mjs`、`src/app.js`）： - 起因就是上一条：日期输入的修复不动版本号，npm 仍是 0.61.0。于是用户手上的单文件页与桌面 exe——带没带这个修复——左上角都写着 `v0.61.0`，谁也没法回答「我这版到底新不新」。 - 改法：把 CHANGELOG 的「未发布」段做成唯一数据源，构建时读出顶层粗体条目标题（遇到下一个 `##` 即止，嵌套子条目不算一条），三处消费：① 版本徽标旁加一枚小牌「另含 N 项未发版改动」，悬停 `title` 逐条列出；②「方法与验证」新增一段「本版之后又改了什么（版本号未变）」，逐条列出并指回 CHANGELOG；③ 面板错误边界的环境行在版本号后追加「未发版改动 N 项」，报错截图自带新旧判断。 - 刻意不留第二份手写清单：清单为空时小牌与整段都不渲染（不会出现「另含 0 项」这种话）；窄屏 ≤640px 藏掉小牌，方法段的完整清单仍在，横向溢出 0px。 - 顺手修掉一个够不到 AA 的新增文本：小牌是 11px 字，压在 `--panel2` 上，用 `--dim` 浅色档只有 4.41:1；改 `--ink2` 后浅 10.19:1 / 深 10.60:1，两条对比度断言一并进闸。 - 验证：34 条断言（解析口径 7 条含 CRLF / null / 段末收口，渲染 11 条含转义与空清单，真 CHANGELOG 4 条，产物接线与对比度若干）。把小牌与方法段从 `build-html` 里摘掉，4 条立刻转红。 - 引擎与排盘口径未动；`client.js` 285KB / gzip 87KB（+1KB，多的是那份 JSON 清单）。 - **自动发布修掉「假成功」**（`tools/autopublish.mjs`、`test/autopublish.test.mjs`）： - 现象：发版提交只落在本地时，autopublish 看到「允许清单内没有改动」就直接返回，主流程却照样打印「完成：已推送 main」。远端整整落后一个版本，日志仍是绿的。 - 改法：无改动时先查 `git rev-list --count origin/main..HEAD`——本地领先就继续走 push，不领先才报「本轮不推送」；`commitAndPush` 返回布尔，主流程按实际结果分别记录「已推送」与「无改动可推送」。 - 回归锁：新增 6 条源码级断言（领先检查、继续推送、`return false`、`return true`、分别报告、不再无条件打印）；把修复回退回事故版本，前五条都会红。 - 只动工具链，不进 npm 包（发版清单里没有它），只随本版一并记录。 ## 0.61.0（2026-11-03，已发布） > 已发布：npm `dsh-metaphysics@0.61.0`，shasum `5498dde08a729076a69b77c3e33eb62262cf0950`，100 个文件；tag `v0.61.0` 已推（指向发版提交 `8644f6b`，其后为自动发布修复与文档回写），tarball 已下载核对。 > 本版主题（续）：择日不再只数建除宜忌——按《协纪辨方书》卷十一「用事」的逐条神煞计分，再按卷十「宜忌」的六等与德神制化定轻重，起法逐条可回溯。随 0.61.0 发布。 - **择日神煞宜忌层**（新增 `engine/zeri-shensha.js`，约 15KB）： - 数据分两层：卷十一「用事」16 条事项的宜／忌神煞名单逐字照录；起法分散在卷四（建除十二神、月建、月厌、厌对、阴阳不将）、卷五（天德、月德、天德合、月德合、月空、天恩、天赦、天愿、母仓、月恩、四相、时德、王官守相民日、四击、九空、五墓、四耗、四废、四忌四穷、九坎九焦、五虚、八风触水龙、宝义制专伐日、八专、无禄、重日五合五离、解神、复日、鸣吠、鸣吠对）、卷六（三合、临日、驿马、劫煞、灾煞、月煞、月刑、月害、大时、游祸、天吏、六合、兵吉、五富、天仓、天贼、要安、玉宇、金堂、敬安、普护、福生、圣心、益后、续世、阳德、阴德、天马、兵禁、地囊、土符、大煞、归忌、往亡、月忌日）与卷九「立成」。 - 27 个择日事项全部映射到卷十一的 16 条事项；无对应条的走建除简表，映射依据写在 `ZERI_SHENSHA_BASIS`。 - 没有可靠起法的条目（土王用事后、血忌、伏社日、八风、气往亡、专日、伐日、四离、四绝、上朔）逐日 `shensha.unsupported` 列出，不猜、不计分。 - 条件神煞按原文条件：天狗只作「申月戌日」；阴阳不将按十二月逐支表；归忌按孟仲季月；三合按局；解神按冲月建（与紫微按月安的解神区分）。 - **打分口径**（`engine/zeri.js`）： - 建除宜 +2、建除忌 −2；神煞宜每颗 +2（单类封顶 +4）；神煞忌、日忌、农历日忌各每颗 −2（各封顶 −4）；当事人属相逢冲 −2 并径直排除。 - 结果逐日新增 `shensha`（月支、建除神、当日神煞名单、宜／忌分组、未实现条目），顶层新增 `shenshaRef`（底本、卷次、未实现清单）。 - `meta.scope` 与 `disclaimer` 明写：六等判词与德神制化取自卷十，吉／凶权重与比值阈值是本仓校准（不是古籍常数），等第表未逐格数字化。 - **接线（全链路）**：`engine/index.js` 摘要加「神煞依据／起法／未实现起法」一行；`src/panel-kit.js` 择日面板同步显示；`index.js` 工具描述改写为「宜忌依卷十一逐条」。 - **闸门**（新增 `test/zeri-shensha.test.mjs` 11 条 + `test/fixtures/zeri-sources.json`）： - 原文锁：夹具里的卷十一原文按最长优先词典切词，逐条等于 `SHENSHA_LISTS` 的宜／忌数组——表被「顺手补齐」即红；夹具条数与库的条目数必须一致。 - 27 事项映射完整性；2026-10-29（戌月丙子，满／民日／灾煞）、12-01（亥月己酉，开／灾煞）、12-15（子月癸亥，闭／四穷）、12-22（子月庚午，破／月破／大耗、冲鼠）四组逐日落星；天狗只申月戌日；土王用事后只进未实现清单。 - 打分锁见下条「卷十」；`compare.best` 落在 12-01。 - **审查修掉一个展示 bug**：余忌命中时 `verdictOf` 把对象数组直接 `join`，逐日断语渲染成「…的余忌之列（[object Object]）」；改为取神煞名，并补两条回归断言（点名「灾煞」、全文无 `[object Object]`）。 - 断言基线 7496 → 7518（151 → 152 个文件；新增 22 条卷十测试）。 - **卷十「宜忌」六等与德神制化**（继续 `engine/zeri-shensha.js`）： - 六等判词逐字取卷十 4853 行：上（吉足胜凶）、上次（吉足抵凶，遇德从宜、不遇从宜亦从忌）、中（吉不抵凶，遇德则吉胜，不遇从忌）、中次（凶胜于吉，遇德始相抵）、下（凶又逢凶，遇德从忌、不遇诸事皆忌）、下下（凶叠大凶，遇德仍诸事皆忌），另立「平」（吉凶相抵）。原文「参」在底本误作「防」，`GRADE_TEXT` 按文义还字，夹具注明。 - 德神制化按卷十各条按语分三类：`keJie` 德神可解（月建、满日、闭日、劫煞、灾煞、月煞、月刑、月害、月厌、大时、天吏、厌对、复日）、`buJie` 德神犹忌（月破、天狗、游祸、四忌、四穷、往亡）、`wuShe` 与德义不相属（九坎、九焦、土符、地囊、归忌、血忌）。「止忌……」的余忌按事项落回 `residualEntries`（灾煞等止忌求医疗病、月厌止忌婚嫁出行等、月建止忌兴造破土）。 - 月日条件按原文：满日值守日／相日、闭日值王日／官日、劫煞／灾煞／大时／天吏按孟仲季月值某建除、月刑「巳月值平日」、月害「卯酉月值除日守日、丑未月值执日大时」、月厌「寅申月值成日、丑未月值开日」。德神名单不满足条件或不在名单内，仍按不遇德处理。 - 月厌叠月破或灾煞时直接判下下·诸事皆忌，遇德也不解。 - 输出：逐日新增 `grade`（等第、判词、宜忌方向、德神、吉／凶合分、比值、可解／仍忌／犹忌清单、是否叠凶），顶层 `shenshaRef` 新增 `juan10`；`meta.scope` 与 `disclaimer` 明写权重／阈值是本仓校准、等第表未逐格数字化。 - 接线：`engine/index.js` 摘要逐日附「卷十等第·宜忌方向」并新增一行卷十依据；`src/panel-kit.js` 候选表新增「卷十等第」列与依据脚注；`test/fixtures/zeri-juan10.json` 存判词与 25 条德神制化关键词。 - 评分锁随六等改写：10-29 开业 +4 推荐·上、12-01 +3 推荐·上、12-08 0 平平·平、12-15 −5 回避·下·诸事皆忌、12-22 排除；灾煞遇德对开业可解，对求医仍落余忌。 > 本版主题：紫微的杂曜不再只有 49 颗简盘——十二颗缺的星按安星诀逐颗落地，诀文一并交给使用者和别家模型。随 0.61.0 发布。 - **杂曜安星库**（新增 `engine/ziwei-zuoyao.js`，11KB）： - 补上通行简盘长期缺的十二颗：解神、天巫、天月、阴煞（按生月）；天官、天福、天厨（按生年干）；蜚廉（按生年支）；天德、年解（按生年支起宫顺／逆）；天才（命宫＋生年支）、天寿（身宫＋生年支）。八颗走十干／十二月明表，四颗走起宫顺逆公式；分类为吉星 7、煞星 3、杂曜 2。 - 三条硬口径：**至少两处独立站点同表才收**（37 条链接去重后 9 个来源，每颗都有 ≥2 个不同站点）；**诀文照录不改写**，转抄例子与自家诀文相抵时以诀文为准（天才一例三源同诀、转抄却写「巳宫安天才」，判为笔误）；**同名异星绝不合并**——蜚廉（年支）≠ 博士十二神的飞廉、按年安的天德 ≠ 岁前十二神的天德、年解 ≠ 按月安的解神（月解），三组在盘上各处其位。 - 龙德、月德刻意不入表，`ZUOYAO_SKIPPED` 逐颗写明 20 字以上理由（与岁前十二神同名同宫、并入即重复安星），面板与复制提问都看得到这份「没收清单」。 - **新开关 `zuoyaoSchool`（默认 `minimal`，盘面一字不变）**（`engine/ziwei.js`、`engine/index.js`、`index.js`、`engine/diff.js`）： - `minimal` 仍是通行简盘 49 颗；`full` 按上面的诀补入十二颗，共 61 颗。默认不排的理由写在开关表注释里：星数一变，旧盘的宫位句柄与已存命盘会静默变盘。 - 结果新增 `zuoyao` 层：`mode / starTotal / placed[]`（星名、地支、宫名、定宫依据、基本义、入庙标记）`/ verses`（一行一颗的诀文块）`/ skipped`；`rules.schools` 并列入杂曜口径，`rules.zuoyao` 两档各给一句该怎么打开。 - 口径并排（紫微 12 → 13 组）新增「杂曜：49 颗简盘 / 61 颗全表」；`【流派】` 行只在显式改动时出现。 - **修掉一个真 bug**：`zuoyaoBranch` 的公式曜原先只挡命宫／身宫，缺生年支时 `fix(NaN)` 照样返回「一个宫」，天德、年解会带着 NaN 落宫被塞进盘里（面板宫名渲染成空）。现在四颗公式曜都先验生年支，并对非有限值兜底返回 null——缺依据就整颗不排，绝不安到默认宫。 - **接线（全链路）**：`engine/followup.js` 复制提问在全表盘后附「紫微杂曜安星诀」段（本盘落宫 + 诀文 + 未另立清单，并明写属通行说、不是《全书》原文），简盘不塞这段；`src/panel-kit.js` 宫位与详情两处加「庙」标，盘下方新增可折叠的诀文块，默认档另给一句白话说明怎么开全表；独立页 `命理排盘.html` 同源带出。 - **口径落成知识卡**（`engine/interpret-knowledge.js` 新增 `ziwei-zaoyao`）：挂 `overall / work / health`——`overall` 已被三方四正、破格、四化三张占满（每维最多 3 张），而天官、天福、天厨主贵显与俸禄（事业／公职），天月、解神、阴煞主病符与消灾（疾厄），落宫实质就落在这两维。`engine/citations.js` 记为 `general`（通行说）：维基文库本《紫微斗数全书》卷一是赋文与格局、卷二是安身命例，未见这套安星诀，故不署《全书》原文。 - **体积**：杂曜库随紫微引擎进 `ziwei / bazi / hepan` 三块（+11KB 源码 / +6.5KB gzip），三块原本就贴着 220KB 的 gzip 分块线（最紧一块 213KB），加完变 219.6 / 223.7 / 222.9KB → `test/chunks.test.mjs` 的上限抬到 228KB，并把「再加库就该拆块」写进注释；入口 `client.js` 不受影响。18 块合计 gzip 2.38MB。 - **闸门**（新增 `test/ziwei-zuoyao.test.mjs` 96 条）： - 期望值全部由诀文里的地支字重导（`byBranch`），不复制引擎表内数字——表被人「顺手补齐」就红；解神另用第二式（月建对冲）逐月独立互核；新库反过来反查旧表（破碎／华盖／咸池三组三合位）。 - 面板不靠源码 grep 交差：用 `vm` 把真 `src/panel-kit.js` 载进沙箱、拿真 `compute` 渲两档盘，逐条数「已排 12 颗／12 个 chip／入庙标记／诀文折叠且写明属通行说／11 行诀文／龙德月德未另立／简盘无诀文块／全页无 `undefined`·`NaN`」；撤掉模板里的 `${zyHTML}` 即 4 条红。 - `placeZuoyao` 缺依据整颗跳过（12／8／9／11／0 五档）、入庙标记只在庙地名单内出现、诀文块一行一颗；开关默认与两档盘面（49 vs 61、简盘星名必为全表子集、盘上落宫 = 库复算落宫）、三组同名异星并存不合并。 - **新增「接线漏检锁」**（`test/ziwei-schools.test.mjs`）：每个流派开关都必须同时出现在工具 schema、`compute` 平铺透传与口径并排三处——本轮先只加了引擎侧，正是这条能拦住「AI 传了参数但服务端不认」；开关计数由「10」改为键名清单，规则行由「列全九项」改为十一类逐条。 - 连带更新：`citations.test.mjs` 通行说计数 7 → 8（有意设的锁），并按 `npm run build:citations` 重建 `docs/citations.html`。断言基线 7350 → 7496（150 → 151 个文件）。 > 本版主题（续）：起名字库从「够用」扩到「常见姓名基本不缺字」。随 0.61.0 发布。 - **字库扩容：391 → 1062 字**（`engine/name-extra.js`、`engine/name.js`、`engine/name-data.js`）： - 新增 671 个常用名用字，按五行分组：木 210、火 89、土 89、金 143、水 140；原 391 字一字未删，`CHAR_LIB` 与 `READING` 用展开合并，原有调用方与数据形状不变。 - 补上此前大面积缺字的真实姓名常用字：伟、杰、军、强、丽、娜、秀、英、敏、娟、凯、豪、虎、兵、仪、喆、靖、翊、芯等；`李伟杰`、`王丽娜`、`王秀英`、`张建国` 这类名字不再出现「未收录」。 - 读音与康熙笔画由 Unihan `kRSUnicode` + 康熙部首笔画 + `kTraditionalVariant` 复算，不是手敲；繁体映射会串义的字按人名通行取法覆盖：千 3、才 3、发 12（發）、钟 17（鍾）、苏 22（蘇）、采 8、万 15、镌 18；长/兴/种按人名读法取 chang2/xing1/zhong4。 - 未收录字仍不猜五行；扩库只增加「可判断」的字，不改变任何五行归类口径。 - **候选排序加「常用字优先」**（`engine/name.js`）： - 字库变大后，笔画讨巧的生僻字可能挤进候选；排序在「合喜用 → 两字异行」之后新增常用字档（两字都常用 > 一字常用 > 都不常用），再看五格与性别倾向。`suggestFor` 给未收录字的替换建议同样先挑常用字。 - 常用字集合只用于加权排序，不参与五行判定；`notes` 里的排序说明同步改写。 - **闸门**（`test/names.test.mjs`、`test/name-wuge.test.mjs`）： - 字库规模改为 1000–1200 字双边界；新增 50 个真实姓名样本的覆盖率门槛（逐字查，缺字率 ≤5%，当前 123/123）。 - 新增扩充字笔画锚点（千/才/发/钟/苏/采/万/镌/伟/丽/杰/凯/娟）与长/兴/种的读音锚点，防生成脚本回退。 > 本版主题（续）：六爻与梅花不再只有白话大意，盘面直接给出《周易》经文原文。 - **《周易》经文原文库**（`engine/yijing-text.js`）：64 卦辞 + 384 爻辞 + 乾用九 / 坤用六，共 386 条爻辞。 - 原文照录，不改写、不意译；〔一作…〕标出 20 处古籍异文，只在原句后加括注，不动正文。 - 三份公开底本互校生成（npm `@freizl/yijing`、npm `iching-shifa`、GitHub `liujuntao123/yijing`），逐条折叠简繁异体后投票：三源一致直采，两源一致取多数，三源互异与已知讹字逐条裁定，裁定只用《周易》本书互证（《彖》《小象》《系辞》引文）与通行注疏本，不引外书。 - 投票确实抓到底本自身的错：`@freizl/yijing` 姤九五整句重复一次、大有九二误置同人六二「同人于宗，吝」；`iching-shifa` 把大有九二的爻题标成「六二」。爻题因此不抄底本，一律由卦画推出。 - 取辞按京房体系：动爻取该爻爻辞，六爻皆变且为乾坤时补用九 / 用六，无动爻只给卦辞并写明「六爻皆静」。 - **六爻 / 梅花结果新增「经文原文」节**（`engine/liuyao.js`、`engine/meihua.js`、`engine/interpret.js`）：本卦卦辞 → 动爻爻辞 → 互卦卦辞（梅花）→ 变卦卦辞，排在白话大意之后、「落到生活里」之前；面板逐行转义渲染，无需新增样式，CLI 摘要（`interpretText`）自动带上。 - **复制提问把原文一起带走**（`engine/followup.js`）：交给别家模型的那段话里，盘面摘要之后新增「《周易》经文原文」段——只读结果里已算好的 `jing`，ASK 栈不多背这 12KB；非卦象体系不多塞一段。 - **体积**：这张表只进 `client.liuyao.js` 一块（gzip +12KB，该块 178KB），不进解释栈；其余 17 块体积不变，分块合计 2.33MB。 - **闸门**（`test/yijing-text.test.mjs` 64 条、`tools/check-bundle.mjs`）： - 结构自证：384 爻的爻题「九 / 六」逐位比对引擎卦画，爻题写法（初/上位在前、二三四五题在前）全部合京房例；386 条爻辞正文与 64 条卦辞两两不同——大车型错置永远回不来。 - 接线：跑构建产物 `client.liuyao.js` 的 factory 出盘，锁住「漏配 `tools/build-client.mjs` 时分块静默没有经文」这一类；再加体积锁（表 ≤40KB、不得混进无关分块）。 - 新闸门「模块顺序」：打包按 `ORDER` 顺序执行 IIFE，被依赖的模块必须排在前，否则取到 `undefined` 且不报错——本次踩到两次，现在由 `check-bundle` 拦。断言基线 7146 → 7213。 > 本版主题（续）：姓氏库从 129 姓扩到 998 姓 + 82 复姓，生僻姓的五格不再整块「算不了」。 - **姓氏库扩容**（新增 `engine/surname-data.js`，`engine/name-data.js` 改为从它摊开）： - 单姓 129 → **998**，复姓 13 → **82**；每行是「字 + 康熙笔画 + 拼音 + 声调」，`SURNAME_STROKES / SURNAME_READING / DOUBLE_SURNAMES` 三个旧出口的形状与调用方一字未改，`engine/name.js` 与面板不需要跟着改。 - 笔画不是手敲：三份独立资料互证（康熙笔画表 / 起名用字表 / 姓氏词典），都缺时用 Unihan 的康熙部首结构值（部首本字画数 + 剩余画数）复算，两条独立路径对上才收；三份资料与旧表四票不一致时逐字人工裁定，理由写进模块头部注释（温 13、万 15（繁体萬）、赖 16（貝部九画，旧表作 20 是错的）、钟 17、迟 19、沈 8、岳 8、板 8、御 11 等 25 字）。瓮（瓮／甕差 10 画）取不定，宁缺不猜。 - 71 个姓只给得出笔画、给不出唯一读法（乐 Lè/Yuè、查 Zhā/Chá、区 Ōu/Qū 这类多音），拼音一律留空——音韵检查照旧落空并点名缺哪个字，不拿一个可能错的读音去判「顺口」。覃/蔚/隗/柏/乐/能/查/石/尉九个姓另存又读，主读照算，盘面与摘要并列显示「姓又读 覃tan2」。 - 复姓读音同样由姓氏词典连写（万俟 mòqí、单于 chányú、尉迟 yùchí、澹台 tántái、乐正 yuèzhēng），笔画按逐字康熙值：旧表 诸葛[15,15]、令狐[5,8]、慕容[14,10] 三处按资料改为 [16,15] / [5,9] / [15,10]。 - **修掉一个真 bug**：`phonetics(fullName)` 原先只把全名第一个字当姓，复姓的第二字（诸葛的「葛」、尉迟的「迟」）走起名用字库，字库没有就整体报「没有读音数据」。现在 `phonetics(fullName, surnameLen)` 由调用方给出姓的字数，复姓逐字都能从姓氏表取读。 - **接线**：`engine/index.js` 摘要的【音韵】行带出又读；面板名字卡音韵行同样并列（`src/panel-kit.js`）；`tools/build-client.mjs` 把 `surname-data` 排在 `name-data` 之前、只挂进 `name` 一块（该块 gzip 143KB，其余 17 块体积不变）。 - **闸门**（新增 `test/name-surname-lib.test.mjs` 48 条）： - **常见姓覆盖 100%**：把三份姓氏资料并集里的 521 个常见姓**冻结成测试内的锚点串**（不拿本轮抓取结果当标准答案），逐个要求入表；扩容失败或日后删表都会红。 - 形状与取值：4 列、笔画 1–40、拼音只含小写字母、**拼音为空 ⇔ 声调为 0**、无重复字；又读必须与主读不同且该姓已有主读。 - 康熙笔画与读音锚点各一组（含被推翻的旧值 赖 20），复姓逐字笔画齐全、`万俟=moqi`、`单于=chanyu` 锚点。 - 症状回归锁：撒/蹇/冼/戏/蒉/訾/昝/厍 这些原先五格「算不了」的姓现在都排得出天格 = 姓画 + 1；`compute` 端到端（生僻姓出五格、摘要带又读、候选按五格排序）。断言基线 7213 → 7261。 > 本版主题（续）：塔罗从「78 个名字 + 几个关键词」补成一套有底本、有出处、敢留空的牌义库。 - **78 张牌义库**（新增 `engine/tarot-cards.js`，16KB）： - 底本声明为 Rider-Waite-Smith（1909）系，牌义按黄金黎明一脉（Liber 777 公开对应表）取，三处独立资料互核；三源一致才入库，不一致的逐条裁定并把理由写进模块头注释。不同体系的牌义（托特／马赛）不并进同一句话。 - 每张牌七个字段：英文名、牌面图像（中文白描 15–60 字，78 张全）、核心寓意（小阿卡纳 56 张各写一句，不复用通用句式）、元素、行星、星座、生命树源质。大阿卡纳 22 张全部给行星＋星座，小牌 2–10 共 36 张按三分相定星座（权杖＝白羊/狮子/射手，圣杯＝巨蟹/天蝎/双鱼，宝剑＝天秤/水瓶/双子，星币＝摩羯/金牛/处女）：2-4、5-7、8-10 依次落进这三个星座，同组三张各占该星座的第一／二／三旬，旬主星按迦勒底连续序（白羊一旬起火星）落定（例：权杖二＝火星在白羊第一旬，权杖四＝金星在白羊第三旬，圣杯九＝木星在双鱼第二旬）。 - **三处明写的「不给」**：四张首牌只归源质不配单一星座；16 张宫廷牌不给占星对应——公开资料里两套映射（国王＝本位宫一派 vs 黄金黎明四元素层级一派）在多数花色上把国王与王后对调，本插件不合并两派，只给元素与角色定位（学徒与消息 / 推进与风格 / 滋养与吸引 / 掌控与承担）；22 条希伯来字母路径层整体不录入，因为它与牌义无关却最容易被抄错。 - 占星对应全部由规则表算出（`SUIT_SIGNS` / `DECAN_PLANETS` / `SEPHIROTH` / `DECAN_CN`），不逐张手敲；手写的只有中文图像与核心寓意。生成脚本收进 `tools/gen-tarot-cards.mjs`，`node tools/gen-tarot-cards.mjs` 一条命令重生成，Temp 目录不再是这份数据的一部分底稿。 - **接线（全链路）**：`engine/tarot.js` 牌库与抽牌结果逐张带出新字段；`engine/index.js` 摘要每张牌补 `[英文名]` 与「牌面：…」一行；`engine/plain-summary.js` 顶部人话总结带出牌面图像与占星对应（宫廷牌改说「它在盘上顶的是「…」那个角色」）；`engine/event-prompt.js` 与 `engine/followup.js` 复制提问把核心义、占星对应／牌位角色、牌面图像一并带走；`src/panel-kit.js` 面板卡新增英文名牌与牌面白描段（配套两条样式）；`engine/interpret.js` 逐牌解读改写为「牌面上…，它对应的占星位置是…／它在这里顶的是「…」那个角色」。 - **口径落成知识卡**（`engine/interpret-knowledge.js` 新增 `tarot-correspondence`，`engine/citations.js` 同步收录）：塔罗解析文末「这套规则有多稳」会点名本盘涉及的旬位取法与「宫廷牌两派冲突故留空」，状态标签「文本·各家有异说」；`engine/tarot.js` 的 `systemNote` 同步说明，`engine/followup.js` 的追问骨架改为「逐牌（正逆/牌面/元素对应）」。 - **体积**：逐张牌库只挂在 `client.tarot.js` 一块（该块 gzip 176KB，未触 260KB 上限），不进公共解释栈——其余体系不背这 16KB。18 块合计 gzip 2.36MB。 - **闸门**（新增 `test/tarot-cards.test.mjs` 86 条）： - 数据自证：78 行形状、英文名纯 ASCII、图像 15–60 字、小牌核心 8–30 字且 **56 句互不相同**（防止回退成套话）、花色与元素逐张对 `SUITS` 一致。 - 规则闸门：36 张小牌的星座／旬主星逐个按 `SUIT_SIGNS × DECAN_PLANETS` 反算比对，**旬位标注另用一张手抄的迦勒底旬主星表（12 星座 × 3 旬）独立反查**——牌上的行星在该星座实际主第几旬，标注就必须是第几旬；首牌与宫廷牌的「留空」本身是断言（配了星座就红）；22 张大牌的行星与星座逐张过庙旺规则（守护星落在本命宫）。另有 30 条冻结锚点（权杖四＝金星在白羊第三旬、圣杯九＝木星在双鱼第二旬等）与 5 条英文名、3 条源质锚点——换底本或改表都会红。 - **修掉一个自相矛盾的标注**：旬位原先按「二三四→第一旬、五六七→第二旬、八十→第三旬」分组算，于是权杖三（太阳）与权杖二（火星）同标「白羊座第一旬」——而白羊第一旬的旬主是火星。实际口径是同组三张分居该星座的一／二／三旬，改为按组内序号取模；三源互核的是行星与星座，这一层错的只是标注文案。 - 端到端：`compute` 摘要两行格式、`brief.sections`、逐牌解读文案、`buildEventPrompt`、面板 HTML（`vm` 里跑）五处都验；`systemNote` 必须提到宫廷牌。 - 连带更新：`citations.test.mjs` 的通行说计数 6 → 7（这条计数是有意设的锁，新增卡片要显式改），并按 `npm run build:citations` 重建 `docs/citations.html`。断言基线 7261 → 7350。 ## 0.60.0（2026-11-02，已发布） > 已发布：npm `dsh-metaphysics@0.60.0`，shasum `6e126e8d84348f10945faa5e5759b454858d8f59`，94 个文件；tag `v0.60.0` 已推（指向发版提交 `3c92da1`，其后仅文档回写），GitHub release 已建。 > 本版主题：从「算得对」推进到「用得顺」。新增**我的命盘**（本机档案）与**复制提问**两条日常路径，并把历算、输入守卫、异步竞态、发布闸门里查出来的问题逐条修掉。新增能力不改变既有排盘口径；同一输入、同一 asOf 仍产出同一张盘。 - **我的命盘：一次录入，下次点卡出盘**（`src/panel-kit.js`、`src/app.js`、`src/web-ui.js`）： - 面板与离线单页共用一套实现与同一个存储键 `dsh-metaphysics/profiles-v1`：存的是出生日期、时刻、性别、出生地这些**输入**，不是结果；只落本机，不上传。 - 卡片照市面排盘 App 的命盘列表：一张卡一个人，点卡直接出盘；改名、置顶、删除收在卡片右上角，悬停或键盘聚焦才出现，触屏常驻。置顶在前，其余按最近排过排序；最多 24 张，超出时淘汰最久没排的那张。 - 档案来自 localStorage，按外部输入对待：逐字段验一遍，日期要真过日历，坏条目整条丢弃，不把 `undefined` 渲染进卡片；同 id 只留第一条。 - 删除点两次才算；改名会把原称呼读回输入框，改完点「更新这张档案」覆盖原档，创建时间、使用次数与置顶状态不变。 - 写入失败不再假装成功：`profilesPut` 报失败，删除／置顶／记次数也回滚到存储里的真实状态；浏览器完全没有 localStorage 时同样按失败回报——否则卡片从界面消失、下次进来又复活。 - 旧版本或手改存储留下的「有日期没时刻」卡不再拿表单里现成的时刻顶上（那会排成另一个人），而是提示先补时刻；这种卡也不算「排过一次」。 - 称呼框是裸 DOM：面板重绘与单页重绘都先把已输入的字存起来，翻置顶、切视图不会把称呼抹掉。 - **复制提问：把盘面和问题整理成一段话，交给任意 AI**（`engine/followup.js`、`engine/bridge.js`、`src/app.js`、`src/web-ui.js`）： - 追问框优先于「所问之事」：只读主问题时，命盘类没有这个输入框，复制出去的「所问」会永远是默认开场句。 - 包里带上面板已算好的开场结论（直答／说人话），别的模型开场沿用同一口径；盘面摘要与回答骨架一并带上。 - 打包失败时按钮给出「暂无可复制内容」并自动复原，不再毫无反应；切方向 / 重绘结果时追问框里已经输入的字保留。 - **输入守卫：坏参数不再静默变成另一张盘**（`engine/index.js`、`index.js`、`engine/handle.js`）： - 经度统一整形并校验：数字串转数字；非有限值或超出 −180…180 报 `E_RANGE`，不再走到真太阳时里炸成裸异常，也不再静默少一次修正。 - 地址、问题、revise、ask、姓名等自由文本设长度上限——这些串会整段进句柄，不设限等于允许一次调用把结果撑到几百 KB。 - `datetime` 的秒位真正校验；`asOf` 的小时与分钟必须在范围内，非法值不再被折回另一天。 - 句柄增量拒绝 `__proto__` / `constructor` / `prototype` 键，避免改掉结果对象的原型。 - 联网解析失败不写缓存：不会连着六小时把「解析失败」当成答案；风水不再请求出生地解析（经度对盘面没有影响，发给第三方是纯外泄）。 - `detail` 只接受 `full` / `lean`，写了别的值不再被当成缺省静默放过。 - **历算修正**（`engine/calendar.js`、`engine/lunar.js`、`engine/dst.js`、`engine/ziwei.js`、`engine/trend.js`、`engine/random.js`、`engine/rectify.js`、`engine/zeri.js`）： - `jdToParts` 的分钟进位会让 23:59:45 塌回「当日 00:00」，日柱退一天；改为先归到整秒再向下取整分，拆出的那一天永远就是这一刻所在的那一天。 - 农历的节气时刻被移了两次时（净偏移约 −12 分），节气落在午夜前后十几分钟内会少算一天，置闰整月错位；修正后 1917 年由「闰三」回到真历表「闰二」、1922 年由「闰六」回到「闰五」。 - 夏令时换表日给出明确说明：起算日 02:00–03:00 的钟面读数在当年不存在，终止日 01:00–02:00 同一读数对应两个真实时刻——按哪种读法折算写进提示。 - 紫微流年改用调用方的 `asOf` 作基准年，同一句柄跨年不再排出不同的流年表；人生 K 线按交运年份切段，与虚岁轴对齐，不再整条线提前一年。 - 随机种子把高位与小数位折进状态：相差 2^32 的种子（如隔 49.7 天的毫秒时间戳）不再摇出同一卦。 - 生时校正的事件限 200 条、年份限 1600–2400、候选时辰去重后最多 24 个；择日事项错误统一带 `E_INPUT`，`days` 的数字串会被规范化，越界或非数字一律报错，不再静默改成 30 天。 - **输出档位与上下文**（`engine/index.js`、`index.js`、`engine/handle.js`）： - 新增 `detail: "lean"`：只给结论、所问方向那一条与三张表，长论述与「规则·出处」折成一行指针（省约一半文本）；盘面、句柄与解析对象不变，影子盘与口径对照也不会把档位当成盘面差异。 - 工具 schema 把梅花与小六壬的 `mode` 合并进同一个字段并写明三组取值，避免同名字段被后定义覆盖。 - **客户端稳定性**（`src/engine-lazy.js`、`src/app.js`）： - 分块在途请求去重：并发打开两个体系共享同一次下载；失败也清掉在途记录，一次网络抖动不会把分块永久钉在「正在加载」。 - 面板连续排盘 / 连点 tab 时用序号丢弃过期结果：旧请求不再覆盖新盘，也不再在 await 之后把 tab 拨回去。 - **闸门与发布**（`tools/`）： - `check-html-sinks` 重写：逐插值判定，补上四类旧版漏检（裸变量赋值、一个 `esc(` 救全条、`insertAdjacentHTML` 的第二个实参、`dangerouslySetInnerHTML`），并带可自证的漏检用例。 - 发布脚本不再 `git add -A`：按目录白名单与扩展名逐路径暂存，点开头的运行痕迹不收，重命名记录正确跳过来源路径。 - 新增凭据扫描、对拍报告新鲜度校验、分块体积预算（单块 gzip ≤260KB、18 块合计 ≤2.75MB）。 - `npm test` 现有 147 个测试文件 / 7139 条断言；新测试覆盖档案存储、分块预算、客户端竞态、细节档位、DST 歧义、输入守卫、HTML 注入面、凭据闸。新增断言均通过「把旧实现改回去必须变红」的反向验证。 - **真机回归**：`e2e-dom` 137 项、`e2e-panel` 89 项全过，覆盖档案存入/回填/改名/置顶/两次删除/缺时刻拦截、复制提问的所问与开场结论、切方向后追问框保留、深色与窄屏布局、全程无 JS 报错。 ## 0.59.1（2026-11-02，已发布） > 已发布：npm `dsh-metaphysics@0.59.1`，shasum `43817f74d114121bbbe947c91abc10a825a287b9`，94 个文件。 > 本版主题：把「先说结论」从八字／紫微推到全部九个体系，并且堵住三个会让第一屏**说错话**的坑。不新增断法，不改算法；改的是「第一屏能不能读、说的是不是真的」。 - **九个体系都有第一屏了**（`engine/plain-summary.js`、`engine/index.js`、`src/panel-kit.js`）： - 之前只有八字与紫微在盘面上方给一段人话；六爻、梅花、六壬、奇门、塔罗、合盘、走势七个体系点开就是一整屏术语。 - 现在每个体系一个 `xxxSummary`，统一返回 `{title,chips,lead,sections,advice,caveat,footer}`；`plainSummary()` 分派，`compute()` 统一挂在 `r.brief` 上（生成失败只记 `briefError`，绝不拖垮排盘）。面板侧收成一个 `pp.briefHTML(r)`，九个盘面都只写一行前缀，不再各自判一次、也不会漏一个。 - 各体系讲各自的结构：六爻讲世应／用神／月日／卦体，梅花讲体用，六壬讲三传（起手—转折—落点），奇门讲日干宫与时干宫的门星神，塔罗逐张给位置义，合盘讲日主关系／夫妻宫／五行互补，走势讲「这一步的基调、最亮最闷、怎么用」。 - 证据：`test/plain-summary.test.mjs` 从 63 条扩到 149 条。新增一组「七体系×五项」：给得出、字段里不许漏 `undefined`、每段有实质、至少一条可做的事、结尾写明不是断语、问事的要回显用户那句话。渲染侧另测九个盘面：方框在最前、只渲染一次、带免责尾句、结果无 `undefined`。 - **六爻停在「综合」：没有用神也给第一屏，并说清为什么**（`engine/plain-summary.js`）： - 问题：用神由「询问方向」定，而方向默认是「综合」。默认状态下卡片一片空白——恰好是大多数第一次点开六爻的人看到的样子。 - 改法：走「世应版」——只讲与问题无关的世爻、应爻、卦体（六冲／六合／伏吟／反吟）与动爻，并在补充说明里写明「不是算不出来，是取用神要先知道问什么」，第一条建议就是让用户补选方向。选定方向后自动切回用神版，两种版本不会同时出现。 - 顺带修一句措辞：动爻原来写「4、5、6 爻动」，会被读成「六个爻都在动」；改成「第 4、5、6 爻动」，标签里的「3 爻动」是数量。 - **修：选「财运／学业」时，建议那一段是空的**（`engine/plain-summary.js`）：命盘的「询问方向」是 wealth/career/love/health/study/travel/general 七档，问事提示的六类是 career/love/business/action/day/other，两套键只有两个重合。不转这一道，「财运」取不到现实核对清单。新增 `DIR2KIND` 映射（财运→生意、学业→工作、健康→其他、出行→推进）。 - **修：合盘标签渲染成 `undefinedundefined × undefinedundefined`**（`engine/plain-summary.js`）：合盘结果里 `dayMaster` 是「丁火」这样一整串，不是 `{stem,element}` 对象——两种写法现在都接住。 - **修：紫微同一段里既说「成」又说「破」**（`engine/plain-summary.js`）：被判冲破的格局原先同时出现在「结构上成的是…」与「被冲破的格局有…」两句里，读的人只会觉得自相矛盾。被冲破的一律不计入「成」，措辞也从「被判为被冲破」改成「冲不等于毁，说的是它不如完好时那么顶用」。 - **修：奇门宫位写「6宫」**（`engine/plain-summary.js`）：读奇门的人认的是乾宫、巽宫，不是阿拉伯数字。宫名从 `PALACE_FIELD` 释义里取，并补上方位（乾宫（西北））；中宫仍按寄宫说明。 - **修：塔罗的「关节牌」取得随机**（`engine/plain-summary.js`）：原来取「第一张逆位」，同一副牌换个抽牌顺序结论就换位置。改成取「现在／现况／核心／建议」那一张，没有就取中间一张；标签里也去掉重复的「3 张」。 - **走势不再读挂钟**（`engine/trend.js`、`engine/index.js`、`engine/plain-summary.js`、`src/core.js`、`src/app.js`、`src/web-ui.js`）： - 原来 `trendSummary` 用 `new Date().getFullYear()` 找「你现在在哪一步」，过了元旦同一条线会自己改口，也过不了 `check-patterns` 的时间约定。 - 改成：`buildTrend` 接受 `nowYear`，`compute` 从 `asOf` 取年，写进 `meta.nowYear`；引擎侧一律不读挂钟。界面（面板与离线页）用 `Core.todayStamp()` 传当天，内嵌在八字页里的 K 线也带上。没给 `asOf` 时不假装知道现在，改说「没给当前日期，所以不标现在在第几步」。 - 顺带多给一句有用的：「走到这一步的第 N 年，再过 M 年换下一步」。 - **修（最严重的一条）：新增模块漏进分块构建，八个体系的产物里静默变成 `briefError`**（`tools/build-client.mjs`）： - `plain-summary` 只挂在八字／紫微的栈上。另外八个分块（六爻、奇门、六壬、塔罗、黄历、择日、称骨、起名…）里 `plainSummary` 是 `undefined`，`compute` 一调就抛，被 try/catch 收进 `briefError`——源码测试全绿，打包后第一屏直接消失。这正是 0.59.0 记过的同一个坑（`limits` 那次）。 - 改法：抽出 `BRIEF` 组，所有会调 `compute` 的分块都带上。`chunks.test.mjs` 的 19 体系逐字节比对当场抓到（报压缩名 `Fe is not a function`）。 - **修：八字页会同时出现两个「先说结论」**（`src/panel-kit.js`、`src/app.js`、`src/web-ui.js`）：K 线随八字页渲染时也带上了自己的人话方框，两个方框抢第一屏。`trendHTML(r, { brief:false })` 用于内嵌，单独看走势时仍然保留。 - **口径对照不把「人话总结」当盘面差异**（`engine/diff.js`）：`brief` 是从盘面派生的叙述，换一档口径必然改写；不剔掉的话，奇门晚子时那一项会从「1 处差异」变成 3 处。 - **时辰未知：八字三柱模式，紫微/合盘阻断，趋势降级**（`engine/bazi.js`、`engine/index.js`、`src/app.js`、`src/web-ui.js`、`tools/build-html.mjs`）： - 问题：没填时刻就按页面默认时刻排盘，时柱、紫微命宫、起运日照常出现——**看起来像算过，实际是拿占位值算的**。这比算错更糟：错得看不出来。 - 做法：`buildBazi` 接受 `hourUnknown`，内部仍按「正午」跑完整条管线（大运、旺衰要有个基准），但对外把不该被当成已知的东西全部收回——`pillars.hour = null`、命宫/身宫置空（依赖生时支）、输入回显不带钟点、`civilText`/`trueSolarText` 只留日期、大运与交运去掉时刻并标 `precision: 'day'`、五行不含时柱重算、只落在时柱上的神煞整条去掉。**全文不出现 `12:00`**，内部只用语义标记 `provisionalHour: 'noon'`。 - 下游分三类处理：紫微（命宫由生月+生时支定，时支未知整盘不成立）与合盘（夫妻宫、大运依赖时支）→ `HOUR_UNKNOWN` 阻断并给一句可执行引导；趋势 → 降级，顶层带 `hourPrecision: 'day'` 且首行写明「起运按日估算」。 - 摘要第一行固定句：「时柱按正午暂算，涉及时柱的结论仅供参考」——用户先看到「这不是一张完整盘」，才不会被下面的时柱/命宫误导。 - 界面：八字与人生 K 线的时间框旁多一个「时辰未知」勾选（勾上即收起时刻框），面板与独立页同一套行为；紫微/合盘不提供这个勾选，因为给了等于诱导出一个假盘。 - 证据：`test/hour-unknown.test.mjs` 47 条。三条硬断言——全文（JSON + 渲染文本 + 摘要）不得出现 `12:00`；时柱及依赖项必须为空且不得写成已知；提示必须是摘要第一行（无出生地、远期 ΔT 精度提示都不得把它挤到第二行）；工具 schema 必须暴露 `hourUnknown`；面板 `pp-warn` 必须逐字含固定句。另有五条守下游：紫微/合盘必须抛 `HOUR_UNKNOWN`、趋势必须带按日标记、默认路径逐字节不变。 - **修：无地址时固定提示被挤到第二行**（`engine/index.js`、`test/hour-unknown.test.mjs`）：地警告与 ΔT 精度提示也在往摘要最前插——固定句先插、后警告再插，「时柱按正午暂算…」就被压到第二行（命中精度提示时第三行）。改为最后再插固定句，并补「无出生地」「2150 远期盘」两条断言：现在无论有没有地址、精度如何，首行都是它。 - **补：工具 schema 也支持 `hourUnknown`**（`index.js`、`test/hour-unknown.test.mjs`）：原先只有面板与离线页能勾三柱，`metaphysics_chart` 的 schema 里没这个参数，Agent 要不到。补上布尔参数与说明（八字三柱、趋势按日、紫微/合盘阻断），并加断言防回退。 - **面板三柱提示改用固定句**（`src/panel-kit.js`）：`pp-warn` 文案统一为「时柱暂缺：只排年/月/日三柱，起运与交运按日估算。时柱按正午暂算，涉及时柱的结论仅供参考。」，与摘要首行逐字一致（有断言）。 - **证据与门禁**：`test:ci` 138 文件全过，断言基线 6737 条（0.59.0 为 6620）；真机回归 `e2e-dom` 103 项、`e2e-panel` 43 项（含「方框只渲染一次」）；`stress` 200 盘 14 项（p95 2ms、堆增长 +0.46MB）。 ## 0.59.0（2026-11-01，已发布） > 已发布：npm `dsh-metaphysics@0.59.0`，shasum `4712088541c06b112792c9249fe64d0dbe0dd38d`，93 个文件。 > 本版主题：把「算得更准」这条路主动停下，改走「不骗人」。三件事——知识标签不再冒充「已验证」、分歧按「本盘涉及」分组、新增「本插件不回答什么」清单。都不碰算法：0.58.0 的应期回测已经说明，51.7% 对 29.6% 的随机基线，靠调规则优先级补不上来；能补上来的是「别让用户以为它比实际更可靠」。 - **知识标签不再冒充「已验证」**（`engine/interpret-knowledge.js`、`engine/interpret.js`、`src/panel-kit.js`）： - 问题：三个标签原写作「诸家一致 / 各家有异说 / 待核实」。前两个在用户眼里约等于「可靠」，而实际含义只是「各书都这么写」。「文本里一致」和「世界里成立」共用一个词，是产品在无意中骗人。 - 改法：标签写全为「文本·诸家一致 / 文本·各家有异说 / 文本·未录入」，前两个强制带前缀；知识区块末尾加一句统一声明——「以上标签只说明典籍文本的一致程度，不表示该技法经过验证；本插件不对任何技法的预测效度作保证」，全报告只出现一次（挂在最后一个带知识卡的维度下，逐维重复反而会被跳过不看）。 - 证据：`test/interpret-knowledge.test.mjs` 新增 4 条，其中一条是**防止被改回去**的——任何标签不以「文本·」开头即失败；另三条盯声明本身（存在、点明「不表示经过验证」、点明「不作保证」）。 - **分歧按「本盘涉及」分组**（`engine/interpret.js`）： - 问题：文末「这套规则有多稳」把本盘踩到的分歧和「这派别来就吵的」混成一锅，八字一张盘能列十几条，用户看不出哪几条跟自己有关。 - 改法：按 `seen` 分成两组——先列「本盘涉及 N 处」（只留条目名，正文里已展开过），再列「本体系另有 M 处通行分歧（本盘未涉及，附原注备查）」；两者都没有时写明「本盘未踩到，结论是按一派一路算下来的」。开头与结尾各一句把这层定性钉死：这是**文本层**的分歧，不是谁对谁错的判定，插件不替它们裁决。 - 证据：`test/interpret-knowledge.test.mjs` 新增 2 条——分组标记必须存在；「本盘涉及」里列出的条目必须真在这张盘的知识卡里出现过（防虚标）。 - **新增「本插件不回答什么」清单**（`engine/limits.js`、`engine/interpret.js`、`engine/index.js`、`src/panel-kit.js`）： - 为什么不做成免责声明：「可能不准」这种句子没有信息量，用户看完还是不知道该信哪部分。有用的写法是——这条为什么做不到、做到哪一步就停了、依据是什么。 - 通用三条：技法效度未经检验（能复核的只有形式层）、同盘不同命（模型硬缺陷，不是样本不够）、不给医疗法律投资建议。按体系各 1–3 条：六爻不给公历日期且用神两现不代选、八字不预测具体年份事件且旺衰是分档不是评分、紫微飞星层只报路径不判吉凶、梅花不取外应、大六壬应期未做、奇门八门九星入墓未做、塔罗只给通行牌义。 - 走公共收尾 `withReportMeta` 注入，所以奇门那条不经过正文组装的支路也带得上。面板在报告最末折叠显示（与免责声明分工不同：免责声明是「别全当真」，这里是「具体哪几件不答、为什么」）；对话侧全量输出给调用方，不截成标题——模型知道「为什么不答」，才不会自己补一个答案。 - 证据：`test/limits.test.mjs` 27 条（字段完整 / id 不重复 / 文案 ≥40 字且有实质 / 无绝对化用词 / 七个体系都有专属条目 / 通用三条覆盖三个死穴 / 八字不带六爻条目 / 奇门支路也带上）。其中最关键一条是**清单不能和实现矛盾**：既然写着「应期不给公历日期」，六爻解析全文就不得匹配出 `YYYY年M月D日`；哪天有人在应期里加了日期，这条会先挂。 - **修：新增引擎模块漏进构建清单，打包后静默变成 `undefined`**（`tools/build-client.mjs`）：`limits` 初版只加了 `import`，没进 `ORDER` 与 `INTERPRET` 栈，源码跑得通、打出来的分块里 `limitsFor is not a function`。表现是 `chunks.test.mjs` 七个体系逐字节比对失败（报 `Qn is not a function` 这类压缩名）、`security.test.mjs` 直接抛错。已把 `limits` 插到 `interpret-knowledge` 之后、并列入 `INTERPRET` 组。**教训写在这里：engine 下新增文件，除了 import 还要进 `ORDER` 和它所属的模块组，否则源码测试全绿、产物静默坏掉。** - **B1 六爻应期收尾：规则顺序纠错 + 补统计显著性**（`engine/yingqi.js`、`tools/backtest-yingqi.mjs`、`test/yingqi.test.mjs`）： - **发现一个实质错误**：代码里规则的排列几乎是把原文倒过来排的，而注释声称「状态互斥优先级照应期总注的排列：空 → 破 → 动 → 墓 → 太旺 → 衰绝 → 静」。把《各門類應期總注章第又二十六》19 条逐条对下来，真实次序是「静 → 动 → 太旺 → 衰绝 → 入墓 → 六合 → 月破 → 旬空 → 大象吉受克 → 大象凶受克 → 元神总纲 → 化进 → 化退 → 独发独静 → 变爻动爻 → 远近当分 → 再占 → 世空元动 → 世衰元静」。**那句「空 → 破 → … → 静」原文里没有，是编的。** - 改法：新增 `RULE_ORDER` 照原文罗列次序，`primary` 重新定义为「按原文次序第一条生效的规则」，不再是「最可能应验的那条」。同时把 `yingqiState` 上那句「状态互斥优先级」的错注释删掉——那里没有选择逻辑，各项独立计算。 - **对拍补了二项单尾检验，把「百分比」变成「结论」**（`tools/backtest-yingqi.mjs`）：并集 15/29＝51.7%，随机基线 29.6%，**p=0.0102（显著）**；主规则 8/29＝27.6%，按主规则自身支数算基线 17.0%，**p=0.1047（不显著）**。两者一正一反说明：规则集合确实覆盖了原文所记的应验支，但条文之间没有可用的优先次序——这正是面板继续不出日期的依据。 - **逐规则统计**（新增）：`liuhe-xiang-ji`（六合宜相击）7 例中 6，85.7%，p≈1.3×10⁻⁴，过 12 条规则的 Bonferroni 校正（α=0.0042），是本批数据里唯一站得住的单项；`rumu-chong-kai`（入墓喜冲开）6 例 0 中、`jing-zhi-chong`（静而逢值逢冲）7 例 1 中，都低于自身基线。**但这只是报告，不据此调规则**——按这些数字重排就是拿对拍集调参，命中率会变成自己喂出来的。脚本头部与测试注释都写死了这条边界。 - 新增能力边界 `liuyao-liuyue`：不推演流月推进后的二次变化。依据是一条实占反例（用神伏藏、本可靠日辰冲开，进入下月建后一冲解掉原月建对制它之爻的合，制者复起，出伏失败），这类跨月推演还没做，所以应期只能作「该留意哪几支」。 - 证据：`test/yingqi.test.mjs` 28 条（+3）。新增两条是防回归的关键——「规则顺序照原文罗列」把 15 个 id 的顺序钉死，改排序必须给原文依据；「同时命中按原文次序取主规则」用「入墓 5 < 月破 7」的用例验证排序真的生效。另修正两个旧用例的日辰（原来取辰，正好是水墓，会把「入墓」拉进来抢主位，测的就不是月破/旬空了）。 - **真机回归：用本机浏览器把 19 个 tab 逐个点一遍**（`tools/e2e-dom.mjs`、`package.json`）： - 补的是最后一层：冒烟测试跑在 node 里，测得到引擎与渲染函数，测不到事件绑定、表单显隐、勾选后的重渲染、深链落地。这一层用 Chrome 真开页面点。 - 19 个 tab 各查：切得到、有主按钮、能出结果、结果无脏串、**全程无 JS 报错**（监听 `pageerror` 与 `console.error`）。共 103 项断言。 - 另测三条只有真浏览器能测的：① 八字勾「时辰未知」后，结果里必须出现「时柱暂缺」且不含 `12:00`；② 深链 `#mp=…` 直接打开能自动落地出结果；③ 深色主题下扫描全页文字对比度（含渐变背景取平均色）、390px 窄屏无横向溢出且能出结果。 - 用 `playwright-core` + 本机已装的 Chrome/Edge，**不下载浏览器**；找不到浏览器时打印跳过并返回 0，不会把 CI 弄红。 - 过程中修掉两处**误报**（不是产品问题，但值得记）：渐变背景只读 `backgroundColor` 会拿到透明、把「浅底深字」判成同色；父容器（`button.tool`）的文字都在子节点里，拿父容器的 `color` 算对比度必然误判——改成只看「直接含文字节点的元素」且渐变取平均色。 - **全体系稳定性复查：新增冒烟 + 修掉 K 线 id 不稳定**（`test/smoke-all.test.mjs`、`tools/smoke-all.mjs`、`src/panel-kit.js`）： - 为什么加：单测各自盯一块，但整页能出结果的路径有几十条，一条崩就是白屏——上次「时辰未知」崩在 `p.stemTenGod`，引擎 6253 条断言全绿、页面全崩。这次把 19 个 tab 的 36 个用例逐个跑「排盘 → 渲染 → 文本 → 解析」四条链，共 300 条断言。 - 每项查五件事：不抛异常；成品里不留 `undefined / NaN / null / [object Object]`；**同一张盘渲染两次必须字节一致**；关键结构词在（四柱/命宫/值符/世爻/宜忌…）；无 `