前言¶
DeepSeek Harness（DSH）把對話、工具與擴展收進同一桌面殼裏。若你已經在本機部署了 ziwei-doushu 這類 Next.js 排盤應用，平時仍要單獨開瀏覽器標籤或自己記啓動命令，和 Harness 裏的 Agent 工作流是割裂的。dsh-ziwei-doushu 是維護者 XuanCenXuKe 發佈的客戶端類伴生插件：不打包應用本體，而是把已部署的本地應用嵌進側欄，並由 Host 半在後臺探測、必要時自動拉起服務。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-ziwei-doushu（倉庫 XuanCenXuKe/dsh-ziwei-doushu，當前 package 版本 2.0.1，MIT 許可）一句話定位：在 DSH 主區域 iframe 內嵌本地 ziwei-doushu，排盤、十二宮、四化、大限、AI 命理解讀、合盤與古籍庫與上游應用一致。插件不讀取、不存儲、不上傳任何 API Key；模型 Key 只在你本地應用的 .env.local 裏配置。
社區目錄頁：skillhub.cn 插件條目（與 DeepSeek / 幻方無官方從屬，僅爲社區收錄）。
核心功能¶
經 README 覈實，能力如下：
- 側欄入口：左側欄新增「紫微斗數」圖標（安裝後約第 20 位，位於「定時任務」與「Mnemon」之間），點擊後在主區域打開完整應用。
- 功能對齊上游：排盤、十二宮、四化、大限、AI「命理解讀」、合盤分析、古籍庫均走本地已構建的應用，升級應用時插件通常無需改代碼。
- Host 守護本地服務：默認每 30 秒探測一次；服務未運行時會嘗試用
next start拉起（可通過環境變量關閉自動拉起）。 - 面板工具欄：連接狀態、重新加載、新窗口打開；服務不可用時顯示原生部署提示頁（含手動啓動命令、重試、仍要加載）。
應用默認只監聽 127.0.0.1:3000，數據與 Key 留在本機。
前置條件與部署應用¶
這是伴生插件：必須先在本機部署 ziwei-doushu。需要 Node.js ≥ 20.9（macOS / Linux；Windows 建議 WSL）。
官方提供一鍵腳本（下載應用、npm ci、生成 .env.local、npm run build）：
curl -fsSL https://raw.githubusercontent.com/XuanCenXuKe/dsh-ziwei-doushu/main/install-ziwei.sh -o install-ziwei.sh
bash install-ziwei.sh
若 raw 地址不可用，可用鏡像：
curl -fsSL https://ghproxy.net/https://raw.githubusercontent.com/XuanCenXuKe/dsh-ziwei-doushu/main/install-ziwei.sh -o install-ziwei.sh
也可按 README 手動部署（節選）：
git clone https://github.com/Renhuai123/ziwei-doushu.git ~/ziwei-doushu
cd ~/ziwei-doushu
npm ci
cp .env.example .env.local
npm run build
啓用 AI 解讀時，在 ~/ziwei-doushu/.env.local 中自行填寫模型 Key，例如：
# DEEPSEEK_API_KEY=sk-...
插件按順序查找應用目錄（首個含 node_modules/next/dist/bin/next 的路徑生效）：
- 環境變量
ZIWEI_APP_DIR ~/ziwei-doushu~/Documents/ziwei-doushu~/Documents/deepseek-harness/default-workspace/ziwei-doushu
Node 可執行文件查找順序：ZIWEI_NODE_BIN → 應用目錄同級 tools/node-*/bin/node → Homebrew → PATH。
安裝與啓用¶
完成應用構建後，在 DSH 中可對 Agent 說「安裝 dsh-ziwei-doushu 插件」，或在 dshfind 廣場（Discover）搜索「紫微斗數」一鍵安裝。
從 GitHub 安裝時使用 README 給出的可復現命令（勿自行拼接未在文檔出現的 CLI 形式）：
plugin_manager install_bundle(target='github:XuanCenXuKe/dsh-ziwei-doushu')
安裝前建議自行查看倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，會代表你啓動本機 Node 服務。
可選配置¶
| 變量 | 默認 | 說明 |
|---|---|---|
ZIWEI_APP_DIR |
自動探測 | ziwei-doushu 部署目錄 |
ZIWEI_NODE_BIN |
自動探測 | Node 可執行文件路徑 |
ZIWEI_AUTO_START |
1 |
設爲 0 關閉自動拉起（自行管理服務時） |
典型用法¶
經過上面的步驟，日常使用可以按下面順序操作：
- 點擊左側欄「紫微斗數」圖標。
- 首次可能顯示「連接中…」，Host 半會在約 30 秒內探測並嘗試拉起本地服務。
- 連通後即可使用完整應用；頂部工具欄可「重新加載」或「新窗口打開」。
- 若服務未啓動，面板會顯示部署提示頁，可按提示手動啓動後重試。
適用場景與限制¶
適合：已在或願意在本機部署 ziwei-doushu，並希望在 DSH 同一界面裏排盤、解讀，而不反覆切換瀏覽器。
需要注意：
- 面板通過 iframe 內嵌本地應用，主題不完全跟隨 Harness token（與 Harness 自帶「瀏覽器」側欄標籤同類做法）。
- 想讓
next start徹底停下時，需先禁用或卸載本插件，否則默認約 30 秒內會被再次拉起。 - 極少數瀏覽器安全策略會導致 iframe 空白，可使用「新窗口打開」。
- 本插件與 ziwei-doushu 上游無隸屬關係；應用許可見上游倉庫。
結尾¶
dsh-ziwei-doushu 把本地紫微斗數應用接進 DSH 側欄，並用 Host 半減輕「記得開服務」的負擔；AI Key 仍只由本地 .env.local 管理。進一步瞭解可訪問 GitHub 倉庫 與 社區目錄頁。
