dsh-client-ui-board

維護狀態: 活躍

laoqianwocao/dsh-client-ui-board

DSH Web 展板外掛：會話檢視第三標籤，多層白板 + 錨點連線

前往 GitHub

$ dsh plugin add dsh-client-ui-board

安裝

dsh 沒有統一的安裝指令 —— 把該外掛 README（見下方）中的設定行加入你的 profile / patch 設定，然後重啟即可。

查看安裝教學

星數

Fork

TypeScript

語言

2026-08-22

建立於

2026-08-23

README

@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/）