返回目錄

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 伺服器要從專案裡直接啟動
  • 內建 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 伺服器,用 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 伺服器。
  • 需要 Node ≥ 22.12;計算核心本身完全在本機,不需連線、不需 API Key。

05相容性、維護與安全提醒

  • 兩個套件都還沒發佈到 npm:README 說 `dsh plugin --profile web add xuanxue-dsh` 要在發佈之後才能裝,在那之前只能從專案副本直接啟動 stdio 伺服器。
  • 需要 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 伺服器,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 外掛,絕不濫發。