xuanxue-dsh

English summary. xuanxue-dsh is a DeepSeek Harness (dsh) plugin bundle. It is a thin shell over xuanxue-mcp: the bundle patch mounts dsh's built-in MCP client to run xuanxue-mcp over stdio (tools mcp__xuanxue__bazi / ziwei / qimen / astro / calendar), and the plugin registers the four reading guides as dsh skills, because dsh's MCP client does not support MCP prompt templates. Everything runs locally. Requires dsh ≥ 0.2.2-rc.1 (Node ≥ 24.9).

它做什么

把八字、紫微斗数、奇门遁甲、西洋星盘的确定性排盘引擎接进 DeepSeek Harness。本包不含引擎代码，只是一层薄壳：

组合包行（`cordis.patch.yml`）	作用
`xuanxue-mcp`	用 dsh 自带的 `@deepseek-ai/dsh-mcp-client` 以 stdio 启动 `npx -y xuanxue-mcp@`。模型看到的工具名是 `mcp__xuanxue__bazi`、`mcp__xuanxue__ziwei`、`mcp__xuanxue__qimen`、`mcp__xuanxue__astro`、`mcp__xuanxue__calendar`。
`xuanxue-skills`	本包 `index.js`，把 4 份解读守则注册为 skill：`xuanxue-bazi`、`xuanxue-ziwei`、`xuanxue-qimen`、`xuanxue-astro`。正文与 xuanxue-mcp 的 MCP prompts 同源，并在开头补一段工具名对照。

dsh 的 MCP 客户端不支持 MCP prompt 模板，所以守则改走 skill：模型在命中八字、紫微等话题时按需加载，平时不占上下文。

工具参数、输出外层与隐私承诺见 xuanxue-mcp 的 README。

安装

需要 DeepSeek Harness 0.2.2-rc.1 或更高版本（Node ≥ 24.9）。

dsh plugin --profile web add xuanxue-dsh
dsh --profile web --dump-config | grep -A8 xuanxue   # 应能看到 xuanxue-mcp 与 xuanxue-skills 两行
dsh web

首次启动时 npx 会下载 xuanxue-mcp，之后走缓存。

也可以从 GitHub 安装（无需构建）：dsh plugin --profile web add github:oceanjustinlin/xuanxue-dsh。推荐 npm 版本。

自定义

在 profile 的 cordis.patch.yml（$DSH_HOME/profiles//cordis.patch.yml）里按 id 覆盖。例如改用本地仓库里的 server（开发调试，或不想走 npx）：

- id: xuanxue-mcp
  config:
    serverName: xuanxue
    transport: stdio
    command: node
    args: ['/绝对路径/qimen/packages/xuanxue-mcp/src/server.mjs']
    failOnStartupError: true

注意：覆盖 config 会替换整段配置，serverName 和 transport 要一起写上；serverName 改了之后 skill 里的工具名对照会对不上，建议保持 xuanxue。

dsh-mcp-client 默认 failOnStartupError: false：server 启动失败时 harness 照常运行，只是没有 mcp__xuanxue__* 工具（stderr 会有一条错误）。排查时可像上面那样打开它。

源码与开发

源码在 qimen 仓库的 packages/xuanxue-dsh，npm 包也从那里发布。独立仓库 oceanjustinlin/xuanxue-dsh 是导出的副本（dsh 社区目录要求插件位于仓库根目录），请到 qimen 仓库提 issue 或 PR。

测试：qimen 仓库根目录 npm test（含 packages/xuanxue-dsh/test/plugin.test.mjs）。
cordis.patch.yml 里 xuanxue-mcp@ 钉的是 packages/xuanxue-mcp/package.json 的版本，测试会检查两者一致；xuanxue-mcp 升版时同步改这里。
prepack 把 ../xuanxue-mcp/prompts/ 复制进本包的 prompts/（在 qimen 里已 gitignore）。开发时 index.js 自动退回读取仓库里的那份。
同步独立仓库：node packages/xuanxue-dsh/scripts/export-repo.mjs ，再在那边提交推送。
本地联调：dsh plugin --profile add /packages/xuanxue-dsh 会以 link: 方式安装，再按上面的“自定义”把 server 指向本地 server.mjs。

发布

见 qimen 仓库的 RELEASING.md。必须先发布 xuanxue-mcp，再发布本包。

许可

MIT

xuanxue-dsh

同名パッケージの別リポジトリ

インストール

ドキュメント

xuanxue-dsh

它做什么

安装

自定义

源码与开发

发布

许可