DSH Mindmap：持久化协作 Excalidraw 画布

前言¶

在使用 DeepSeek Harness（DSH）时，让多个智能体在同一个画布上协作是常见需求。传统方式下，要么需要手动管理多个会话，要么难以直观展示智能体之间的分工与协作关系。DSH Mindmap 插件为 DSH Web GUI 提供了一个持久化的 Excalidraw 画布，让智能体能够以可视化的方式与用户一起绘制和讨论。

插件定位¶

DSH Mindmap 是一个为 DSH 提供持久化协作 Excalidraw 画布的插件，由 aur3l14no 维护。它将画布中的每个框（使用 Excalidraw 的 Frame 工具绘制）分配给一个智能体队友，并由一个画布负责人统一协调。插件依赖 DSH 0.2.x 版本的 Agent Teams 插件。

核心功能¶

画布与负责人¶

每个画布对应一个 DSH Session，显示在画布下方。这个 Session 作为画布负责人的智能体团队，负责协调其下的队友智能体工作。

智能框¶

框是 Excalidraw 的 Frame（按 F 键绘制）。框覆盖的元素属于该框。用户可以绘制一个框并说明它应该包含的内容，一个负责人的队友会接管该框并锁定它。

锁定机制¶

锁定的框及其包含的所有元素只能由持有者（用户或某个智能体）修改。框可以重叠，重叠区域内的元素同时被两个持有者锁定。

智能体工具¶

每个拥有画布的 Session 获得三个工具：

canvas_read：查询画布上谁在画布上、框的所有者和锁定持有者、以及元素的紧凑 Excalidraw JSON（画布、单个框或指定 ID）。
canvas_view：生成画布、框、ID 或区域的 PNG 图片，带有可选坐标网格。
canvas_write：执行原子批量创建、部分更新（通过 id）、整体移动和复制（放置、缩放和旋转）、重新堆叠（above/below）、删除和框锁定（"lock": true/false）。

安装与启用¶

前置条件¶

确保 DSH 版本为 0.2.x，并启用 Agent Teams 插件。

通过插件页面安装¶

在 DSH Web 或 Desktop 的侧边栏打开 Plugins。
打开 Agent Teams 插件。
选择 Add plugin，粘贴以下地址并安装：

https://github.com/aur3l14no/dsh-mindmap/releases/download/v0.1.0/dsh-mindmap-0.1.0.tgz

通过终端安装（CLI Web Profile）¶

dsh plugin --profile web add @deepseek-ai/dsh-experimental-agent-team-profile@$(dsh --version)
dsh plugin --profile web add https://github.com/aur3l14no/dsh-mindmap/releases/download/v0.1.0/dsh-mindmap-0.1.0.tgz
dsh web

通过智能体安装¶

在 DSH（Creator 模式）、Claude Code、Codex 或任何编码智能体中粘贴以下指令：

Install the DSH plugin dsh-mindmap by following
https://raw.githubusercontent.com/aur3l14no/dsh-mindmap/HEAD/docs/install.md

安装完成后，在侧边栏打开 Mindmap，选择一个工作区并创建画布。

典型用法¶

与负责人对话¶

在画布下方的对话中与负责人交谈。拖动对话框顶部边缘可以调整大小。

分配框给智能体¶

按 F 键，拖动绘制一个框。
输入框应该包含的内容，按 Enter（Esc 会保留普通框）。
一个负责人的队友会接管该框并锁定它。

与框的智能体对话¶

选择框或点击框上的标签。
对话会切换到该队友。对话框顶部的标签可切换回负责人。
与智能体对话可以引导它的行为：你在画布上的绘制保持为你的内容，不会被当作指令或移动，智能体会在下一次查看时感知你对其框或附近框的修改。
停止智能体、删除其工作或解除锁定是负责人尊重的决定。

观察智能体工作¶

每个正在工作的智能体会在其最后读取或绘制的位置显示协作光标，说明它正在做什么或对队友说的话。思考时会显示圆点，刚刚修改的内容会有轮廓高亮。点击右上角的头像可以跳转到该智能体的位置。

锁定控制¶

选择框并点击 Lock 可以锁定框，阻止智能体修改。
点击锁定标签可以解除任何锁定（包括用户或智能体的锁定）。

适用场景与注意¶

适用场景¶

需要将复杂任务拆解为多个子任务并分配给不同智能体。
需要直观展示智能体之间的分工、依赖关系和协作流程。
需要在开发过程中进行可视化记录和实时讨论。

注意事项¶

插件以当前 DSH 进程的权限运行，请确保安装前检查源码和许可证。
依赖智能体之间的依赖、中继和冲突解决机制由负责人和其队友通过 Agent Teams（消息、任务板）协商，调度由 DSH 的自动化任务管理。
刷新页面或重启 DSH 会恢复画布、框、锁和负责人及其团队；不会重放历史记录。

配置¶

在配置文件的 mindmap 条目下设置以下选项：

- id: mindmap
  config:
    fontFiles: [/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc]

选项	默认值	说明
`fontFiles`	`[]`	智能体在图片中使用的字体文件，如中文字体。留空则使用第一个已安装的中文字体。Excalidraw 默认字体在绘制中文时使用 Xiaolai。
`teammateProvider`	`spawn`	框的智能体队友启动时使用的子智能体提供者，与 Agent Teams 对新智能体的使用方式一致。

生态背景¶

DSH 的理念是「一切皆插件」，社区目录是一个独立站点，与 DeepSeek / 幻方无官方从属关系。本文介绍的插件来自社区开发者，使用前请确保理解其功能和许可。

参考资料¶

插件目录页：https://www.skillhub.cn/plugins/aur3l14no/dsh-mindmap
GitHub 仓库：https://github.com/aur3l14no/dsh-mindmap