会话展板 LaoQianwocao/dsh-client-ui-board

@deepseek-ai/dsh-client-ui-board — DSH Web 展板

为 DeepSeek Harness Web GUI 开发的展板插件，作为会话视图里与 对话 / 轨迹 并列的第三个标签「展板」。发布为 DSH 客户端插件（dsh.client），支持 GitHub / npm / tarball 分发。

本插件是「展板」，在对话过程中把项目的各层结构（界面层 / 代码层 / 功能层…）用多层白板和连线画成一张可随时查看的思维导图。绑定到当前会话的项目（workspace 路径），同一项目内的所有会话共享同一块展板，方便随时梳理与回顾。

核心模型

- 盒子（BoardNode）承载文字，属于一个或多个图层（layerIds）。连接线（BoardEdge）连接两个锚点（Anchor），自带文字和样式。
- Anchor 要么是节点侧端口（{kind:'node', nodeId, side}），要么是
某条连接线上的一点（{kind:'edge', edgeId, t}），因此一条连接线可以从另一条
线上分叉/汇入。连接线始终在目标端画出箭头。
- 图层切换是一个复选框滤镜：元素在任一勾选图层即显示。

模型体验（AI interop）

展板文档就是 src/client/board.model.ts 里的 BoardDocument JSON。
AI 视图标签渲染序列化的 JSON 并提供 Copy；agent 可用文件系统工具读/写项目级 .dsh-board.json。normalizeDocument 兼容旧版单 layerId / 纯节点 id 结构（且永不抛错）；validateDocument 报告问题。

最小文档：

{
"version": 1,
"title": "我的项目", "activeLayerId": "L1",
"layers": [ { "id": "L1", "name": "通用", "color": "#5b86e6" } ],
"nodes": [
{ "id": "n1", "x": 60, "y": 60, "w": 180, "h": 64, "text": "界面层",
"layerIds": ["L1"],
"style": { "fill": "#e6faed", "stroke": "#1fc27e", "textColor": "#1f2733", "shape": "round", "fontSize": 15, "bold": true } }
],
"edges": [
{ "id": "e1",
"from": { "kind": "node", "nodeId": "n1", "side": "right" },
"to": { "kind": "node", "nodeId": "n2", "side": "left" },
"layerIds": ["L1"], "label": "",
"style": { "color": "#8494a4", "width": 2, "curve": 40, "dashed": false, "arrow": true, "labelColor": "#5f6368" } }
]
}

从另一条连接线分叉用 "from": { "kind":"edge","edgeId":"e1","t":0.5 }；汇入另一条线则在 "to" 上用同样写法。

关键源码

| 文件 | 作用 |
| src/client/index.ts | 插件入口，把展板注册进会话视图的 conversation.view 槽位（第三标签） |
| src/client/BoardView.tsx | 展板画布组件（绘制盒/线、图层切换、AI 视图） |
| src/client/board.model.ts | 数据模型与几何（BoardDocument、锚点/连线、归一化/校验） |
| src/client/locales.ts | 国际化的中文/英文文案 |
| src/invariant.ts | 包级权重伴侣的不可变声明 |

安装

要求已安装 dsh CLI（dsh --help 存在）。

从 GitHub 安装（推荐）

dsh plugin add github:LaoQianwocao/dsh-client-ui-board

第一次安装若 pnpm 提示需要允许构建脚本，把打印出的包 key 填入 profile 的 pnpm-workspace.yaml 的 allowBuilds，然后重跑 add。

从本地 tarball 安装

pnpm pack
dsh plugin add ./dsh-client-ui-board-*.tgz

手动注册（无 bundle 时的兜底）

在 profile 的 cordis.patch.yml 中插入：

- insert:
- id: ui-board
name: '@deepseek-ai/dsh-client-ui-board'

之后无需改动任何官方文件，重启 dsh web 服务并刷新浏览器页面，会话视图即出现「展板」标签。

在 dshfind.com 上被发现

本仓库打上 GitHub topic：dsh-plugin（在仓库 Settings → Topics 添加），即可被 dshfind.com 收录 —— 它索引 topic 为 dsh-plugin 的公开仓库。

结构

- package.json — 声明 dsh.client（platform: web）与 dsh.bundle（自注册行）
- cordis.patch.yml — 注册本插件的宿主端行（plugin row）
- src/ — 源码（board.model.ts / BoardView.tsx / locales.ts / invariant.ts）
- lib/ — 预构建产物（index.js / invariant.js / client.js / types/）