返回目录

qimen

精选清单收录维护状态: 活跃

oceanjustinlin/qimen

基于AI的奇门遁甲在线起局,局势分析,定论分析和可视化

前往 GitHub项目主页
$ npm install

28

星标

12

Fork

JavaScript

语言

MIT

许可证

2026-02-26

创建于

2026-11-19

最近推送

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 个工具

安装步骤

  1. 01

    在仓库根目录执行 `npm install`

    $ npm install

  2. 02

    本地起开发服务器:`npm run dev`;构建:`npm run build`

    $ npm run dev

  3. 03

    本地跑后端:先 `cd worker`,再 `npx wrangler dev`,服务起在 http://localhost:8787,前端会把 `/api/*` 转发过去

    $ npx wrangler dev

  4. 04

    dsh:等包发布后执行 `dsh plugin --profile web add xuanxue-dsh`,README 注明目前尚未发布到 npm

    $ dsh plugin --profile web add xuanxue-dsh

  5. 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 适配原生运行时

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)

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 只保留项目形态与本地开发说明,不提供公开部署教程、密钥配置或自建实例步骤——线上服务是作者的个人网站。
2026-02-262026-11-13作者未说明

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 明确说这是作者维护的个人网站,不提供公开部署教程、密钥配置或自建实例步骤。

08数据与来源

  • 作者声明github.comfb89987675ff…

    **DeepSeek Harness(dsh)插件**:[`packages/xuanxue-dsh`](./packages/xuanxue-dsh/) 是包装 xuanxue-mcp 的薄壳组合包,用 dsh 自带的 MCP 客户端接入…

  • 作者声明github.comfb89987675ff…

    发布后用 `dsh plugin --profile web add xuanxue-dsh` 安装;同样尚未发布到 npm。

  • 作者声明github.comfb89987675ff…

    │ └── xuanxue-dsh/ # DeepSeek Harness 插件(薄壳:MCP 接入配置 + 解读守则 skill)

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。