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 伺服器要從專案裡直接啟動
- 內建 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 伺服器,用 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 伺服器。
- 需要 Node ≥ 22.12;計算核心本身完全在本機,不需連線、不需 API Key。
05相容性、維護與安全提醒
- 兩個套件都還沒發佈到 npm:README 說 `dsh plugin --profile web add xuanxue-dsh` 要在發佈之後才能裝,在那之前只能從專案副本直接啟動 stdio 伺服器。
- 需要 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 伺服器,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 個值得優先安裝的外掛,涵蓋各個分類。
