前言¶
DeepSeek Harness（DSH）是「一切皆插件」的智能体开发框架，开发者可以按需组合各类工具。对于想拓展趣味场景的插件作者，算命是一个典型的细分领域：它既需要精确的排盘计算，又需要模型做人文解读。传统做法要么依赖在线 API（依赖外部服务、隐私顾虑），要么把算命逻辑写在 Prompt 里（不可靠、不透明）。玄机阁（dsh-xuanji）通过本地确定性引擎解决了这两点：排盘数据由本地计算得出，模型只负责解读，断语出处可追溯。
下面介绍这个插件的结构、安装方式以及典型用法。
这是什么¶
dsh-xuanji 是 DeepSeek Harness 的玄学算命插件，由维护者 huangziyuan-general 开发，在 SkillHub 社区目录收录。它内置 16 个 xuanji_* 工具，覆盖八字、紫微斗数、梅花易数、六爻、黄历、称骨、择日、风水、起名、合婚、生命数字、人生 K 线、塔罗、小六壬等。所有排盘数据由本地确定性引擎计算（干支、星曜、卦象、骨重等），模型只负责解读，输出包含四层：排盘事实 → 传统解读 → 现实行动建议 → 免责声明。
插件还附带右侧栏 client 面板，提供八字、黄历、人生K线、称骨、快占、塔罗、奇门、风水、合婚、六爻等十个只读视图，数据来自 /api/xuanji/* 接口，支持公历/农历输入，内置夏令时与真太阳时校正。
核心能力¶
16 个 xuanji_* 工具¶
| 工具 | 用途 | 关键输入 |
|---|---|---|
xuanji_bazi |
八字排盘：四柱、纳音、藏干、十神、旬空、星运十二长生、地支刑冲合会、五行旺衰、胎元命宫身宫、21 种神煞、起运与大运、流年 | 生辰（公历/农历）+ 时辰（可选）+ 性别（+ city/longitude 真太阳时） |
xuanji_ziwei |
紫微斗数：十二宫安星、十四主星亮度与生年四化（禄权科忌）、命主身主五行局、运限层（大限/流年/小限） | 生辰 + 时辰 + 性别 |
xuanji_meihua |
梅花易数：时间起卦 / 报数起卦，本互变卦、动爻、体用生克断吉凶 | mode + 时刻或两个报数 |
xuanji_almanac |
每日黄历：农历干支、宜忌、冲煞、喜神/财神/福神/阳贵/阴贵方位、节气、节日、值神、星宿、彭祖百忌 + 每日一卦 | 日期（缺省今天） |
xuanji_chenggu |
袁天罡称骨：年月日时骨重求和，分档白话批语 | 生辰 + 时辰 |
xuanji_zeri |
择日：事项 × 黄历宜忌 × 建除十二神 × 冲煞排除，逐日打分排序推荐日/回避日 | 事项 + 日期区间 + 属相（可选） |
xuanji_fengshui |
风水：八宅命卦（东四/西四命 + 大游年四吉四凶方位）+ 流年九宫飞星（年家紫白）；action=advise 推宅卦八星盘与门主灶厕布局倾向 + 命宅配（24 山坐向） | 出生年月日 + 性别；advise 需坐山或向山 |
xuanji_name |
起名：评估（八字喜用神对照内置常用字五行字库 241 字逐字打分）+ 候选生成（action=generate，按喜用与性别倾向组合候选名） | 评估：姓 + 名；生成：姓 + 生辰 + 性别 |
xuanji_star |
星座档案 + 当日四维基调（日期哈希确定性生成，同日同星座同结果） | 日期（缺省今天） |
xuanji_trend |
人生K线：大运×流年十神确定性计分，1–100 岁逐年 OHLC + 大运分段 ASCII 迷你图 + 顺位/谨慎年份 | 生辰 + 性别（时辰可省） |
xuanji_tarot |
塔罗：每日一牌（同日同牌同正逆位）/ 三牌阵（过去现在未来），22 大阿卡纳通行释义 | mode；三牌阵需所问何事 |
xuanji_xiaoliuren |
小六壬马前课：农历月日时或报三数掐指落宫，六宫吉凶断语 | mode（time/number） |
xuanji_match |
八字合婚/合盘：属相关系 + 日主生克/天干五合 + 年命纳音 + 简化分档（冲刑害只讲摩擦点） | 双方出生年月日（时辰可选） |
xuanji_numerology |
生命数字（西方数字学）：生命路径数/生日数/态度数（11/22/33 主数保留）+ 白话数义 | 公历出生年月日 |
xuanji_qimen |
奇门遁甲（时家转盘·拆补法简化口径）：阳遁/阴遁、节气局数、符头、时干支、值符、旬空、八宫九星/八门落宫 | 日期 + 时辰（公历/农历） |
xuanji_liuyao |
六爻纳甲（京房）：摇卦成卦 → 八宫归属、世应、纳甲干支、六亲、六神、旺相休囚死、旬空、月破/日破/暗动、动爻与变卦 | 六个爻象数（6/7/8/9）或六次三枚铜钱记录 + 起卦日（缺省今天） |
设计原则¶
- 模型不推演数值：一切确定性事实（干支、星曜、卦象、骨重、牌面）来自本地引擎的确定性计算，模型不心算、不改盘。
- 四层输出：排盘事实 → 传统解读 → 现实行动建议 → 免责声明，由 systemPrompt 纪律段强制。
- 缺输入先问不猜：生辰、性别、时辰缺失时必须询问用户，绝不允许模型代填猜测值。
- 断语出处标注：每条断语区分「传统原文 / 传统通行口径 / 简化判定 / 白话自撰 / 自建字库」五级出处，工具未覆盖的如实说明。
日期与时间处理¶
- 所有吃日期的入口支持
calendar=solar|lunar（缺省 solar），农历侧再带isLeapMonth。 - 农历年份以正月初一为界，不是公历年；闰月不是每年都有（2023 闰二月、2025 闰六月、2026 无闰月）。
- 中国夏令时（1986–1991）默认自动校正；真太阳时通过
city（内置 57 城经度表）或longitude校正；晚子时（23:00–24:00）通过宿主配置ziShi切换。 - 所有口径调整都写进返回值的
meta.notes。
右侧栏面板¶
插件自带右侧栏「玄机阁」tab，提供十个只读视图：八字、黄历、人生K线、称骨、快占、塔罗、奇门、风水、合婚、六爻。面板数据来自 /api/xuanji/*，缺输入时 fail-fast，绝不代填。面板支持深浅主题自适应，无需配置。
安装与启用¶
安装前确保 Node.js ≥ 20。从 npm 安装（推荐）：
dsh plugin --profile web add npm:dsh-xuanji
从 GitHub 公开仓库安装（需要配置 GitHub SSH key 并将 github.com 加入 known_hosts）：
dsh plugin --profile web add github:huangziyuan-general/dsh-xuanji
本地开发时可用符号链接方式：
dsh plugin --profile web add link:/path/to/dsh-xuanji
安装后可在 DSH 中使用 xuanji_* 工具或通过右侧栏面板查看结果。
典型用法¶
八字排盘示例¶
使用 xuanji_bazi 工具排盘，模型会基于本地排盘结果进行解读。典型输入示例：
用户：帮我算一下 1990-08-16 14:30（公历）男命
工具会返回四柱、纳音、藏干、十神、旬空、星运十二长生、地支刑冲合会、五行旺衰、胎元命宫身宫、21 种神煞、起运与大运、流年等信息，模型随后给出传统解读与现实行动建议。
起名示例¶
使用 xuanji_name 工具进行起名评估或候选生成：
用户：帮我评估名字"张伟"，按八字喜用神打分
工具会返回喜用神对照打分结果，未收录的字如实标注。
用户：帮我按喜用神和性别生成几个候选名
工具会按喜用与性别倾向从内置字库组合候选名，并附字义与确定性排序。
快占示例¶
使用 xuanji_meihua 或 xuanji_xiaoliuren 工具进行快速占卜：
用户：梅花易数起卦，报两个数 7 和 9，问什么时候能找到合适的工作
工具返回本互变卦、动爻、体用生克断语，模型据此给出解读。
择日示例¶
使用 xuanji_zeri 工具择日：
用户：2026 年要结婚，帮我查一下 6–8 月的宜忌日，避开属虎的冲煞
工具返回逐日打分排序的推荐日/回避日列表，模型结合宜忌、冲煞给出建议。
适用场景与注意¶
适合在 DSH 中搭建玄学解读类智能体，如八字解读、紫微斗数咨询、择日顾问、起名助手、风水建议、塔罗占卜等场景。插件以当前 dsh 进程权限运行，模型解读受限于插件提供的排盘数据与设计原则，不做医疗、投资、法律断言，恐吓性断语被 systemPrompt 明确禁止。
使用前建议检查源码与许可证（MIT），确认本地计算逻辑与输出格式符合预期。若需定制面板样式，可修改 src/client/ 代码并运行 npm run build 重新生成 lib/client.js。
结语¶
玄机阁通过本地确定性引擎把算命工具链从在线 API 转向本地计算，降低了外部依赖，提高了数据可控性。模型只负责解读，断语出处可追溯，适合需要在 DeepSeek Harness 中拓展玄学场景的开发者。插件在 SkillHub 社区目录收录，源码托管在 GitHub，可通过 npm 或 GitHub 仓库安装使用。
- 技术介绍：https://www.skillhub.cn/plugins/huangziyuan-general/dsh-xuanji
- 源码仓库：https://github.com/huangziyuan-general/dsh-xuanji
