前言¶

用 DeepSeek Harness（DSH）做长对话时，理解往往散落在多轮消息里：概念关系、拆解结构、项目草稿很难在同一份可编辑画布上持续积累。常见做法是另开笔记或文档，再在聊天里复制粘贴，人和模型各维护一份副本，切换会话后上下文也容易断档。

DSH-board 是 DSH 的本地插件，在原生对话右侧（布局上为左侧白板、右侧对话）提供一张持久化共同白板，人和 AI 维护同一份草稿；界面与模型能力基于上游 draft-board，由维护者 MYming-yue 单独维护宿主集成。当前为 0.1.5 早期试用版，尚未发布到 npm。

这是什么¶

DSH-board 定位是「DSH 的持久化共同白板插件」：完整白板在左、DSH 原生对话在右。对话用来提问、讨论与纠正；白板保留理解、结构与成果。学概念、拆产品或长期打磨项目时，新开或切换聊天仍可继续同一张白板，直到主动「新建」或「打开」另一份草稿。

插件通过 upstream.json 固定上游 draft-board 提交构建，不维护两套白板代码；已构建的安装包可独立安装，无需相邻的 draft-board 仓库。

核心功能¶

下面介绍 README 中已说明、且与 DSH 工具链对接的能力。

布局与白板能力¶

• 完整白板在左，DSH 原生对话在右；对话可展开／收起，分隔线可拖动调整宽度。
• 保留 Markdown、LaTeX、图片、卡片备注、关系、集合、布局、结构视图、历史和撤销／重做。

对话与卡片关联¶

• 选中卡片后在右侧发消息，AI 知道本条回复所指的对象；不改写用户回复，不自动附上卡片全文。
• 在「设置 → DSH-board 白板」可管理启用与「发送时关联选中的卡片」；关闭功能保留草稿，恢复完整聊天区并暂停白板工具。

AI 维护白板¶

AI 通过 draft_board_read／draft_board_apply 主动维护白板，复用原子批次、版本校验与整轮撤销。AI 仍使用 DSH 原有模型、工具和审批流程；插件不增加模型 API 配置，不管理账户，也不添加云同步。

保存与上下文¶

• 草稿位于 $DSH_HOME/dsh-board/（未设置 DSH_HOME 时默认 ~/.dsh），包含图片与历史；current.json 指向当前草稿。
• 原生「打开」「保存」「另存为」继续可用；选项和待处理关联保存在 plugin-state.json。
• 浏览器约每 750ms 与宿主同步。当前没有自动合并、多任务白板管理、多人协作、AI 图片解析或完整消息／批次追溯。

兼容范围¶

布局和消息提交依赖 DSH 当前接口，升级宿主后需重新验证。README 记载的已验证范围如下：

其他 DSH 版本和操作系统的完整宿主集成尚未确认。

安装与启用¶

先做环境确认：DSH web profile 能正常启动。安装使用 GitHub Releases 中的已构建包 dsh-board-0.1.5.tgz，不需要 Git、编译工具或 draft-board 源码。

以下为 README 中的 PowerShell 示例（可用 GitHub CLI 下载；也可浏览器下载后把最后一行改为安装包绝对路径）：

$dshHomePath = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' }
$pluginDir = Join-Path $dshHomePath 'local-plugins'
New-Item -ItemType Directory -Force $pluginDir | Out-Null
gh release download v0.1.5 --repo MYming-yue/dsh-board --pattern 'dsh-board-0.1.5.tgz' --dir $pluginDir
dsh plugin --profile web add ("file:" + (Join-Path $pluginDir 'dsh-board-0.1.5.tgz'))

安装后重启 DSH Web Host 并重新载入页面。在设置中找到「DSH-board 白板」，确认共同白板已启用。更新时下载新版本安装包后再次执行 add 并重启；不要将插件装到另一个 profile 或 home。

卸载：

dsh plugin --profile web remove dsh-board

重启宿主后生效；卸载不会删除 $DSH_HOME/dsh-board/ 中的草稿。

第一次体验¶

按 README 建议顺序试一遍：

1. 在白板上双击创建一张卡片。
2. 选中它，在右侧发送「给这张卡片补充解释」。
3. 观察 AI 工具记录与画布更新，点击「撤销最新一轮」回退该批次。
4. 新开聊天，确认仍然是当前白板。

适用场景与注意¶

适合谁： 需要在 DSH web 宿主里把结构化思考留在画布上、并与同一对话里的模型协同改稿的开发者；分类上属于 DSH 社区目录中的「工作流」类插件。

权限与安全： 插件以当前 DSH 进程权限运行，可读写 $DSH_HOME/dsh-board/ 等路径；安装前应阅读 源码与 MIT 许可证，并理解其通过 Cordis patch 注入 web 客户端（cordis.patch.yml）。

生态说明： DSH 理念是「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。

局限： 并行修改冲突时保留双方内容、暂停镜像；另存为后需明确选择继续维护的版本。从源码构建、贡献规范见仓库 AGENTS.md 与 docs/spec.md。

链接¶

• 社区目录：MYming-yue/dsh-board
• 源码与说明：github.com/MYming-yue/dsh-board