MIT 的 JavaScript 插件,把 qimen 的术数引擎装进 DeepSeek Harness:5 个 MCP 工具加 4 份解读守则 skill,时家奇门、四柱八字、紫微斗数与西洋星盘都由本地 Node 脚本算完,再交给模型解读。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-16
许可证
MIT
01它能帮你完成什么?
在 DSH 会话里问一件具体的事——这个 offer 要不要接、面试能不能成、项目推不推得动、丢的东西找不找得回——直接拿到一盘时家奇门,而不是去网页上点表单
脚本排出的九宫盘面(甲子隐遁、符头定位、九星、八门、八神飞布),以及态势评分、风险信号、破局节点、有利方位与有利时间,和可执行的行动建议
已经把 DSH 当成决策对话对象、希望盘面与评分来自确定性脚本而不是模型心算的人
用阳历、农历或四柱反查三种方式录入出生信息,看四柱八字的命局结构与长期趋势
四柱干支、十神、藏干、十二长生、纳音、旬空亡、神煞与特殊格局,再加本地规则引擎对日主强弱、喜忌神与格局的判断——与网页端同一套引擎
希望会话里的解读和网页端的结论对得上、并且要求结果可复现的用户
用同一份出生档案开紫微斗数盘,看十二宫、星曜亮度、四化与大限流年流月
十二宫主星、辅星、杂曜与亮度,命主 / 身主、五行局、身宫与生年四化
想在八字之外再对照一套盘、或需要两套体系交叉验证的 DSH 用户
用同一份出生数据排西洋本命盘:行星落座落宫与逆行、上升天顶、宫位与五种主相位
本命盘的行星落座落宫与逆行、上升与天顶、宫位、五种主相位、元素模式分布、日夜盘与命主星
想拿西方盘和东方的奇门、八字对照,或者只需要西洋星盘的人
02如何接入 DeepSeek Harness?
前置条件
- Node.js 22.12 以上——引擎通过 `require(esm)` 复用 `src/utils` 下的函数
- 一份仓库副本:`xuanxue-mcp` 与 `xuanxue-dsh` 都还没发布到 npm,MCP server 要从仓库里直接启动
- 带内置 MCP 客户端的 dsh——薄壳靠它接入 5 个工具
安装步骤
- 01
在仓库根目录执行 `npm install`
$ npm install
- 02
本地起开发服务器:`npm run dev`;构建:`npm run build`
$ npm run dev
- 03
本地跑后端:先 `cd worker`,再 `npx wrangler dev`,服务起在 http://localhost:8787,前端会把 `/api/*` 转发过去
$ npx wrangler dev
- 04
dsh:等包发布后执行 `dsh plugin --profile web add xuanxue-dsh`,README 注明目前尚未发布到 npm
$ dsh plugin --profile web add xuanxue-dsh
- 05
其他 MCP 客户端:`claude mcp add xuanxue -- node <仓库绝对路径>/packages/xuanxue-mcp/src/server.mjs`
验证接入成功
- `npm test`——README 说它分两段:先跑全部单元与 e2e 测试,再单独串行跑 MCP 打包冒烟测试(这一项需要联网装一次依赖)
- `scripts/bazi_cli.test.cjs` 是锁定「封装 == 引擎、无损」的 parity 冒烟测试,已挂进 `npm test`
03DSH 适配与能力边界
dsh 插件薄壳 `xuanxue-dsh`(`packages/xuanxue-dsh`)——包装 `xuanxue-mcp` 这层 stdio server,用 dsh 自带的 MCP 客户端接入 5 个工具(`bazi` / `ziwei` / `qimen` / `astro` / `calendar`),并把 4 份解读守则注册成 dsh skill(dsh 不支持 MCP prompts);安装命令为 `dsh plugin --profile web add xuanxue-dsh`(尚未发布到 npm)
5 个 stdio 工具共用一套 CLI 契约
每次调用返回同一种 JSON 外层,含 `chart` / `judgments` / `evidence` / `confidence` / `limitations` / `warnings` / `conventions`;另有历法 CLI 负责公农历转换、真太阳时与节气
4 份解读守则以 dsh skill 的形式落地
时家奇门盘面引擎
四柱八字盘面引擎
紫微斗数盘面引擎
西洋星盘排盘引擎
04适合谁?何时不该用?
适合
- 已经把 DSH 当成决策对话对象、希望盘面与评分来自确定性脚本而不是模型心算的人
- 希望会话里的解读和网页端的结论对得上、并且要求结果可复现的用户
- 想在八字之外再对照一套盘、或需要两套体系交叉验证的 DSH 用户
- 想拿西方盘和东方的奇门、八字对照,或者只需要西洋星盘的人
不适合
- 两个包都还没发布到 npm:README 说 `dsh plugin --profile web add xuanxue-dsh` 要在发布之后才能装,在那之前只能从仓库副本直接启动 stdio server。
- 需要 Node ≥ 22.12;计算内核本身纯本地,不联网、无需 API Key。
05兼容性、维护与安全提示
- 两个包都还没发布到 npm:README 说 `dsh plugin --profile web add xuanxue-dsh` 要在发布之后才能装,在那之前只能从仓库副本直接启动 stdio server。
- 需要 Node ≥ 22.12;计算内核本身纯本地,不联网、无需 API Key。
- 解读要完整的出生信息:时辰必填,八字与紫微还需性别;奇门技能以「问事当下」起局,v1 不做多时辰择时。
- README 只保留项目形态与本地开发说明,不提供公开部署教程、密钥配置或自建实例步骤——线上服务是作者的个人网站。
MIT · 尚无发布 · 仍在活跃提交(最后推送 2026-11-13),dsh 薄壳尚未发布到 npm
06常见问题
怎么把它装进 DeepSeek Harness?
插件本体是仓库里的 `packages/xuanxue-dsh`,安装命令为 `dsh plugin --profile web add xuanxue-dsh`。README 说明这条命令要在发布之后才可用,且两个包目前都还没发布到 npm;在此之前直接从仓库副本启动 stdio server,README 给的 MCP 客户端写法是 `claude mcp add xuanxue -- node <仓库绝对路径>/packages/xuanxue-mcp/src/server.mjs`。
会话里会出现哪些工具和技能?
5 个 MCP 工具——`bazi`、`ziwei`、`qimen`、`astro`、`calendar`——外加 `packages/xuanxue-mcp/prompts/` 里的 4 份解读守则。因为 dsh 不支持 MCP prompts,薄壳把这 4 份守则注册成 dsh skill;SKILL.md 与 MCP prompt 共用同一份正文。
在 DSH 里使用需要 API Key 或联网吗?
不需要。README 明确计算内核纯本地、不联网、无需 API Key,接进来的 Agent 自己充当负责解读的大模型。真正需要的是 Node ≥ 22.12——引擎通过 `require(esm)` 复用 `src/utils` 下的函数。
一次解读需要准备哪些输入?
出生信息走统一的 `lib/birthInput.cjs` 契约:时辰必填,八字与紫微另需性别,传出生地可换算真太阳时。西洋星盘是例外——不需要性别、不做真太阳时,按出生地时区换算 UTC,缺出生时间返回 `TIME_REQUIRED`。奇门技能以「问事当下」起局,v1 不做多时辰择时。
网页端自己也能跑吗?
可以,但只限本地开发:`npm install`、`npm run dev`、`npm test`,后端另外用 `cd worker` 加 `npx wrangler dev` 起在 http://localhost:8787。README 明确说这是作者维护的个人网站,不提供公开部署教程、密钥配置或自建实例步骤。
07相关的 DSH 工作流
dsh-baton
作者 jialaoliu
通过 MCP 在 Claude Code 或 Codex 与本地 DeepSeek Harness 之间移交任务,并将结果带回原会话。
dsh-crew
作者 zseven-w
从 Claude Code / Codex 向 DSH 智能体派发任务的插件,支持原生子智能体进度、分层工作会话与多模态桥接。
dsh-mcp-apps-host
作者 oriliz
DeepSeek Harness 的 MCP Apps 托管插件:在沙箱 iframe 中渲染 MCP _meta.ui 交互式 HTML 卡片,并通过 postMessage 桥接 MCP 工具调用与资源读取。
eac-design-world
作者 ebony-vinyl
DeepSeek Harness 本地视频制作与设计插件:多轨剪辑、模板与设计体系、原生预览画布和真实文件导出
08数据与来源
**DeepSeek Harness(dsh)插件**:[`packages/xuanxue-dsh`](./packages/xuanxue-dsh/) 是包装 xuanxue-mcp 的薄壳组合包,用 dsh 自带的 MCP 客户端接入…
发布后用 `dsh plugin --profile web add xuanxue-dsh` 安装;同样尚未发布到 npm。
│ └── xuanxue-dsh/ # DeepSeek Harness 插件(薄壳:MCP 接入配置 + 解读守则 skill)
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
