dsh-ziwei

紫微斗数工作台 · Zi Wei Dou Shu Workbench

> 一个 DSH（DeepSeek Harness）插件：确定性紫微斗数排盘 + 面板内直接解读。

> 前面看盘，后面直接聊。排盘走独立引擎，解读走 Harness 会话模型。

English summary: A single-package plugin for DeepSeek Harness that computes Zi Wei

Dou Shu (Purple Star Astrology) charts deterministically from raw birth data

(date / clock time / gender / birth-place longitude, with true-solar-time correction)

and renders a 12-palace workbench inside the DSH web UI. It exposes four host tools

(ziwei_paipan, ziwei_check, ziwei_templates, ziwei_context) and an SSE route that

streams interpretations through the user's own configured model provider — no API key is

stored in the browser. Licensed MIT; third-party notices in

[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). This is a community plugin, not an

official DeepSeek product.

---

界面预览

真实 DSH 宿主截图（macOS，浅色主题，1280×820 窗口 @2x）。

本命盘工作台：确定性排盘 + 左栏命主信息 / 命盘库，右侧十二宫与宫位详情。

紫微师 · 直接聊：命盘自动带入，用已配置的模型回答；示例问「这个大限要注意什么」。

侧栏入口（DSH 左侧栏中的「紫微斗数 Pro」）：

> 深色主题与四档宽度的渲染预览见 [docs/design/assets/](docs/design/assets/)；

> 截图规范见 [docs/assets/README.md](docs/assets/README.md)。

功能

• 格局摘要：左栏命主信息下方直接显示检测到的格局（名称/等级/一句话，最多 4 条），

「查看全部」进入完整格局分析页；窄屏仍走顶部入口。

• 手动检查更新：设置弹层显示当前版本与「检查更新」；只在点击时经 Host 路由请求 npm registry

一次，不后台轮询、不记录生辰数据。

• 四柱月柱默认按节气（八字通行口径），可在「排盘设置 → 月柱」切回「农历月」；

命宫、星曜、四化与十二宫始终按农历月计算，不受该设置影响。

• 排盘只有一个来源：工作台引擎（src/engine-core.js → engine-built.js）是

独立实现，结果与来源产品逐字段对齐验证（20 个跨世纪 / 立春 / 早晚子时 /

极端经度 / 男女用例）。排盘只接原始四要素（日期 / 钟表时间 / 性别 / 出生地经度），

真太阳时校正与时辰索引全在内部完成，严禁手工排盘。

• 4 个 agent 工具 + 一段系统提示词：ziwei_paipan（确定性排盘）、ziwei_check

（黄金用例四断言自检）、ziwei_templates（紫微师方法论：人设 / 九诀 / 鲲鹏 14 部分 /

红线 / 交付前自检）、ziwei_context（读取面板最近一次交接的盘）。提示词把铁律写进每个

会话：工具失败必须停手、缺参先追问、报告文末必附免责声明。

• 面板内直接聊：解读从「一次性输出」升级为多轮对话。走 Host 的 /ziwei/interpret

SSE 通道与 Harness llm 服务，不需要在浏览器里另配 API Key。速览解读

（800–1200 字）与鲲鹏报告（完整 14 部分 + 致命主书 + 十二字心法）两种模式。

• 流式收尾有明确语义：只有收到 done 才算写完；命中 max-tokens、整体超时、

连接中断都会保留已生成部分并给「继续生成」，不会再把半截正文当完整结果。

• 界面 v2 / v2.1：盘面优先的自适应布局（ResizeObserver 实测面板宽度分三档）、

宫格字号随盘宽缩放、出盘自动收起生辰表单、「专注看盘」；解读改为面板内右侧阅读抽屉，

设置改为面板内弹层，顶栏按钮分层。

• 「新会话解读」：一键用 Host sessionController 真开新会话，把命盘与已有解读

灌成首条消息，长报告交给会话 / 子代理跑。

• 隐私：生辰与命盘只在本地浏览器 / 本机 Host 路由 / 你配置的模型 provider 之间流转；

浏览器 localStorage 只存偏好与命盘库，不存 API Key（旧版遗留键会在启动时清理）。

安装

三种方式（本地 link / plugin_manager install_bundle 绝对目录或 tarball / npm + 插件索引）

和排障都在 [docs/INSTALL.md](docs/INSTALL.md)。最短路径：

# 从 npm 安装（推荐给普通用户）
dash plugin --profile  add dsh-ziwei@1.3.1

# 开发者：把本地插件目录装进一个 profile（也可在 DSH Web Plugins 页添加）
dash plugin --profile  add "/绝对路径/到/ziwei-workbench"

> 更新：dsh plugin --profile update dsh-ziwei（或 add dsh-ziwei@）；

> 插件不会自动更新，也不会后台检查更新。

> Host 半（工具 / 提示词 / 路由）装完或更新后必须手动重启 DSH；只改浏览器半