前言¶
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 仓库 与 社区目录页。
