dsh-mindmap-live

DSH（DeepSeek Harness）Web 插件：基于 mind-elixir-core 内核的实时双向思维导图。Agent 与用户通过 session projection（mindmap 投影）和 Connection RPC 通道（/mindmap）实时共编同一棵树。

功能

• 侧边栏底部按钮唤出思维导图；
• 自动唤起：agent 在当前会话中创建思维导图时，若面板处于关闭状态，停靠面板会自动弹出一次（仅"创建"触发——刷新页面、切换到已有导图的会话、以及对已有导图的后续修改都不会自动打开）；
• 下载图片：面板/全屏标题栏一键把当前导图渲染成 PNG 并下载（基于官方 @mind-elixir/export-mindmap 插件内置的 SCST 引擎，SVG foreignObject + Canvas 管线，按根节点主题命名文件）；
• 在桌面应用打开：一键通过官方 @mind-elixir/open-desktop 插件唤起 Mind Elixir Desktop（mind-elixir:// 协议 + 本地服务 127.0.0.1:6595），把当前导图直接送进桌面端；未安装应用时自动打开下载页；
• 界面多语言：全部界面文案接入 DSH 的 locale 注册表（命名空间 mindmap.live），跟随界面当前语言实时显示中文/英文（设置 → 通用 → Language 可切换，导图文案即时刷新）；
• 两种视图（同一时刻只渲染一个画布）：
  • 停靠面板：常驻右侧，边聊天边看/编辑导图，聊天列自动让位，拖拽左缘分界线自由调整宽度（双击分界线恢复默认宽度）；
  • 全屏模式：专注编辑；
• 会话级实时同步：agent 的修改、你在画布上的编辑、以及其它打开同一会话的客户端，全部通过投影即时互相同步（用户编辑会作为 mindmap/update 事件写入会话日志）。

环境要求

• 已安装 DSH（npx @deepseek-ai/dsh）并能正常启动 dsh web；
• Node.js ≥ 18、pnpm ≥ 8（dsh plugin 命令会把参数转发给 pnpm）。

安装

A. npm（推荐）

npx @deepseek-ai/dsh plugin --profile web add dsh-mindmap-live

B. Git 仓库

npx @deepseek-ai/dsh plugin --profile web add git+https://github.com/SSShooter/dsh-mindmap-live.git

lib/ 随仓库一起提交，git 安装开箱即用，不会触发 pnpm 的构建脚本审批。

C. 文件夹 / tarball（离线分享）

npx @deepseek-ai/dsh plugin --profile web add C:\下载路径\dsh-mindmap-live-0.1.0.tgz
# 或解压后的文件夹（建议绝对路径；相对路径以执行命令时所在目录为基准解析）：
npx @deepseek-ai/dsh plugin --profile web add C:\下载路径\dsh-mindmap-live

激活

安装即激活，无需手动操作。

从旧版升级：如果之前在 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 里手动添加过 loader 入口，升级后请删除该条目——新版会随包自动插入同 id 条目，两份并存可能重复加载。

启动验证

npx @deepseek-ai/dsh web

打开 Web 界面后，侧边栏底部出现思维导图按钮即安装成功；点击可在停靠/全屏两种视图间切换。

从源码构建

lib/ 已预构建（内联 MindElixir 内核与样式）并随仓库一起提交——npm / git 方式安装后开箱即用，无需任何构建。

如需修改 src/ 后重建，在本目录内：

npm install     # 或 pnpm install --ignore-workspace
pnpm build      # 等价于 node build.mjs，读取 node_modules/mind-elixir/dist

MindElixir 内核来自 devDependencies 中的 npm 包 mind-elixir：升级时改版本号 → 重跑构建 → 发布新版插件，即可同步上游更新。「下载图片」「在桌面应用打开」两个功能同理，来自 @mind-elixir/export-mindmap 与 @mind-elixir/open-desktop（构建时内联其 UMD 产物）。

目录说明

路径	用途
lib/index.js	Host 侧插件：注册 mindmap 投影与 /mindmap RPC 通道
lib/client.js	浏览器侧 bundle（ModuleLoader factory 格式，已内联 MindElixir）
dsh.bundle.patch.yml	随包 profile patch：安装时自动插入 loader 入口（配合 package.json 的 dsh.bundle 声明）
src/client/index.js	客户端源码
build.mjs	构建脚本
tests/check-i18n-dicts.mjs	i18n 校验：中英词典键值平衡、模板参数一致、apply() 注入接线（纯 Node，无需浏览器）
tests/verify-auto-open.mjs	验证"agent 创建导图时自动弹出面板"（含刷新/编辑不弹出的反例）
tests/verify-export-open.mjs	验证"下载图片"与"在桌面应用打开"两个插件按钮（mock 桌面端本地服务）
tests/verify-*.mjs	其余开发期验证脚本（Playwright，需对着运行中的 dsh web 执行），使用时无需关心

发布

# 1. 修改 src/ 后，在本插件所属的 mind-elixir-core 仓库内重新构建：
pnpm build

# 2. 提交 lib/ 与源码，升 package.json 版本号，然后发布：
npm login
npm publish

npm 包只含 files 声明的内容（lib/、dsh.bundle.patch.yml、README、LICENSE）；完整源码以 GitHub 仓库为准。发布前无需额外打包步骤，lib/ 是随仓库提交的产物。

License

MIT（见 LICENSE）。内嵌的 MindElixir 内核同样以 MIT 授权（Copyright (c) 2019 DjZhou）。