dsh-xuanji

dsh plugin --profile web add dsh-xuanji

<div align="center">

dsh-xuanji · 玄机阁

DeepSeek Harness（DSH）玄学算命插件

八字 · 紫微斗数 · 梅花易数 · 六爻纳甲 · 大六壬 · 奇门遁甲 · 黄历 · 称骨 · 星座 · 择日 · 风水（八宅+玄空） · 起名 · 合婚 · 生命数字 · 人生K线 · 塔罗78牌 · 小六壬 · MBTI

全部由本地确定性引擎计算——干支、星曜、卦象、骨重零模型推演，模型只负责解读。



![tests]()

[English](./README_EN.md) · 简体中文

</div>

预览 · Preview

八字排盘 · 六爻纳甲 · 塔罗

 ·  · 

更多页面截图见 [screenshots.json](./screenshots.json) 声明的清单（人生K线 / 黄历 / 称骨 / 快占）。

---

安装

# 从 npm 安装（推荐——已发版，拉取无需任何凭据）
dsh plugin --profile web add npm:dsh-xuanji

# 从 GitHub 公开仓库（⚠️ github: 简写经 pnpm 走 SSH——机器要配好 GitHub SSH key
# 且 ~/.ssh/known_hosts 里有 github.com 主机指纹，否则更新报 Host key verification failed；
# 没配 SSH 就用上面的 npm 源，公共仓库拉取无需任何凭据）
dsh plugin --profile web add github:huangziyuan-general/dsh-xuanji

# 本地开发（符号链接，改码即生效）
dsh plugin --profile web add link:/path/to/dsh-xuanji

要求 Node.js ≥ 20。

设计原则

• 模型不推演数值：一切确定性事实（干支 / 星曜 / 卦象 / 骨重 / 牌面）来自本地引擎的确定性计算，模型不心算、不改盘；
• 四层输出：排盘事实 → 传统解读 → 现实行动建议 → 免责声明，四层缺一不可（由 systemPrompt 纪律段强制）；
• 缺输入先问不猜：生辰 / 性别 / 时辰缺失时必须询问用户，绝不允许模型代填猜测值；
• 断语出处标注：每条断语区分「传统原文 / 传统通行口径 / 简化判定 / 白话自撰 / 自建字库」五级出处，工具未覆盖的如实说明，不臆断补全。

工具面（18 个 xuanji_* 工具）

工具 · 用途 · 关键输入

xuanji_bazi · 八字排盘：四柱（纳音/藏干/十神/每柱旬空/星运十二长生与自坐）、地支刑冲合会、五行旺衰、《穷通宝鉴》调候用神（与旺衰喜用互补）、胎元命宫身宫、常用神煞 21 种、起运与交运岁数、大运（含起止年份与干支十神）、流年 · 生辰（公历/农历）+ 时辰（可选）+ 性别（+ city/longitude 真太阳时）

xuanji_ziwei · 紫微斗数：十二宫安星、十四主星亮度与生年四化（禄权科忌）、命主身主五行局；运限层（action=fortune）含大限/流年/小限三环与四化 · 生辰 + 时辰 + 性别

xuanji_meihua · 梅花易数：时间起卦 / 报数起卦，本互变卦、动爻、体用生克断吉凶 · mode + 时刻或两个报数

xuanji_almanac · 每日黄历：农历干支、宜忌、冲煞、喜神/财神/福神/阳贵/阴贵方位、节气（上一/下一）、节日、值神、星宿、彭祖百忌 + 每日一卦（同日同卦） · 日期（缺省今天）

xuanji_chenggu · 袁天罡称骨：年月日时骨重求和，分档白话批语 · 生辰 + 时辰

xuanji_zeri · 择日：事项 × 黄历宜忌 × 建除十二神 × 冲煞排除，逐日打分排序出推荐日/回避日 · 事项 + 日期区间 + 属相（可选）

xuanji_fengshui · 风水：八宅命卦（东四/西四命 + 大游年四吉四凶方位，立春界）+ 流年九宫飞星（年家紫白）；action=advise 推宅卦八星盘与门主灶厕布局倾向 + 命宅配；action=xuankong 玄空飞星（三元九运运盘/山盘/向盘/宅命盘 + 旺山旺向等格局判定） · 出生年月日 + 性别；advise/xuankong 需坐山或向山

xuanji_name · 起名：评估（八字喜用神对照内置常用字五行字库 241 字逐字打分，未收录如实标注）+ 候选生成（action=generate，按喜用与性别倾向从自建字库组合候选名，确定性排序附字义） · 评估：姓 + 名；生成：姓 + 生辰 + 性别

xuanji_star · 星座档案 + 当日四维基调（日期哈希确定性生成，同日同星座同结果） · 日期（缺省今天）

xuanji_trend · 人生K线：大运×流年十神确定性计分，1–100 岁逐年 OHLC + 大运分段 ASCII 迷你图 + 顺位/谨慎年份 · 生辰 + 性别（时辰可省）

xuanji_tarot · 塔罗：每日一牌（同日同牌同正逆位）/ 三牌阵（过去现在未来）/ 五牌阵，78 张全牌库（22 大阿卡纳 + 56 小阿卡纳四花色，可切 22 牌简库）通行释义 · mode + deck；三/五牌阵需所问何事

xuanji_xiaoliuren · 小六壬马前课：农历月日时或报三数掐指落宫，六宫吉凶断语 · mode（time/number）

xuanji_match · 八字合婚/合盘：属相关系（六合三合六冲六害相刑）+ 日主生克/天干五合 + 年命纳音 + 简化分档，冲刑害只讲「摩擦点」 · 双方出生年月日（时辰可选）

xuanji_numerology · 生命数字（西方数字学）：生命路径数/生日数/态度数（11/22/33 主数保留）+ 白话数义，与八字紫微不同口径 · 公历出生年月日

xuanji_qimen · 奇门遁甲（时家转盘·拆补法）：阳遁/阴遁、节气三元局数、符头、值符值使、旬空、九宫地盘仪奇/天盘星(携仪)/八门落宫；进阶指标逐宫标注——六仪击刑、三奇六仪入墓、门迫、干宫生克、十干克应（通行口诀子集），并汇总盘面隐患宫位；时辰必填 · 日期 + 时辰（公历/农历）

xuanji_liuyao · 六爻纳甲（京房）：摇卦成卦 → 八宫归属、世应、纳甲干支、六亲、六神、旺相休囚死、旬空、月破/日破/暗动、动爻与变卦（回头生克）；给 question 时按问事性质定用神并给应期启发式，无问句则提示先问；摇卦必须由用户完成，引擎不代摇 · 六个爻象数（6/7/8/9，自下而上）或六次三枚铜钱记录（背/字）+ 起卦日（缺省今天）+ 所问何事（可选）

xuanji_mbti · MBTI 十六型人格：24 题四维问卷（E/I、S/N、T/F、J/P），首次调用返回问卷，收齐 24 个 0/1 再调出类型与维度倾向；平票按 E/S/T/J 落档并如实标注 · answers（24 个 0/1）；无 answers 返回问卷

xuanji_daliuren · 大六壬（实验性）：天地盘（月将加时）、四课、贼克法三传；⚠️ 三传九宗门其余八法未做经典对拍校准，结果标注实验性、不可当定论 · 公历生日 + 占时（hour 或 hourZhi），或直给日干支+月建+占时

历法与紫微安星由开源确定性计算库承担（见 package.json 依赖清单），六十四卦表内置并经完整性与《观梅占》复原双重校验。

工程可信度（可核验性基建）

• 公开对拍验证：docs/verification.html —— 全部锚点采用「独立重算」口径（预期值由最原始的干支原语在本地重推，不引用被测常量，避免「测试抄实现」导致的全绿但错），与 CI 闸门同源（npm run verify / node scripts/verification.mjs）；
• 引文索引：断语出处五级制（传统原文/通行口径/简化判定/白话自撰/自建字库）落地为 lib/engine/citations.js——收录《滴天髓》《子平真诠》《三命通会》《穷通宝鉴》可考条目与调候用神提要，绝不冒充典籍原文；
• 口径可追溯：引擎层内置 trace（逐计算步记录规则与输入）、shadow-id（同参同哈希 LY-xxxxxxxx）、caliber diff（口径变体对照）三件套（lib/engine/trace.js / shadow-id.js / caliber.js）；
• 离线单页：docs/offline.html —— 单文件零外链快照（工具目录 + 排盘纪律全文 + 对拍结果），node scripts/generate-offline-page.mjs 再生；
• CI 闸门（test/gates.test.mjs）：性能（单次排盘 <200ms）、HTML 注入（页面零内联脚本/事件属性、用户字段全转义）、产物体积上限、问/改/纠交互三态（缺输入 fail-fast 引导先问 · 同参重跑逐字节一致 · 口径纠偏留痕）。

问 / 改 / 纠（交互三态）

• 问（ask）：缺时辰、缺性别、缺问句一律 fail-fast，报错措辞引导模型向用户提问，绝不代填（闸门测试盯死）；
• 改（revise）：同参数重跑结果逐位一致——用户改口重问不算「新盘」，可复算可对比；
• 纠（rectify）：口径修正（夏令时、真太阳时、晚子时流派）全部写进 meta.notes，纠偏前后盘面差异可追溯，不静默改盘。

右侧栏面板（十二页）

插件自带右侧栏 client 面板（「玄机阁」tab），十二个视图全部只读、零 token。数据来自 /api/xuanji/（与 xuanji_ 工具同引擎，只读确定性计算）；缺输入一律 fail-fast 可见，绝不代填。

<div align="center">

八字 · 黄历

<img src="assets/panel-bazi.png" width="380" alt="八字面板：四柱竖卡 + 命盘概要 + 五行分布"> · <img src="assets/panel-almanac.png" width="380" alt="黄历面板：今日 + 宜忌两列 + 吉神方位 + 节气">

人生K线 · 称骨

<img src="assets/panel-trend.png" width="380" alt="人生K线：逐年蜡烛图 + 均线 + 峰谷标注 + 大运分段"> · <img src="assets/panel-chenggu.png" width="380" alt="称骨面板：总骨重 + 四柱明细 + 档位批语">

快占 · 塔罗

<img src="assets/panel-quick.png" width="380" alt="快占：小六壬报三数掐指落宫"> · <img src="assets/panel-tarot.png" width="380" alt="塔罗：三牌阵翻牌 + 牌意解读">

六爻 ·

<img src="assets/panel-liuyao.png" width="380" alt="六爻：逐爻摇卦 + 本卦变卦 + 纳甲六亲六神排盘"> ·

</div>

• 八字：四柱竖卡（干支/十神/纳音/星运/旬空/藏干）+ 命盘概要 + 五行计数条 + 刑冲合会徽章 + 神煞 chips，出生城市选填（真太阳时）；
• 黄历：进入自动查今天——农历干支、宜忌两列、冲煞、喜神/财神/福神/阳贵/阴贵方位五格、节气、每日一卦卡；
• 人生K线：SVG 蜡烛图逐年绘制（收阳红/收阴绿、5/10 年均线、峰谷标注、大运交替色带、悬停看干支分值）；
• 称骨：生辰 + 十二时辰下拉 → 总骨重盘 + 四柱骨重明细 + 档位批语；
• 快占：小六壬报三数 / 梅花易数报两数（随口报数 + 所问何事，秒级出落宫/卦象与体用断语）；
• 塔罗：每日一牌 / 三牌阵（所问何事输入框常驻），CSS 3D 翻牌动画；
• 奇门：日期 + 时辰下拉 → 阳遁/阴遁局数、值符、旬空 + 九宫格（地_天_门，吉门着色），时家转盘确定性计算；
• 风水：八宅命卦（东四/西四 + 四吉四凶方位）+ 流年九宫飞星（年家紫白，fyYear 单独可查）+ 玄空飞星子表单（坐山/向山

…(truncated)