dsh-mindmap-live

Readme

# dsh-mindmap-live

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

![dsh-mindmap-live 界面截图](https://github.com/SSShooter/dsh-mindmap-live/raw/main/screenshot.jpg)

## 功能

- 侧边栏底部按钮唤出思维导图；
- **自动唤起**：agent 在当前会话中创建思维导图时，若面板处于关闭状态，停靠面板会自动弹出一次（仅"创建"触发——刷新页面、切换到已有导图的会话、以及对已有导图的后续修改都不会自动打开）；
- **下载图片**：面板/全屏标题栏一键把当前导图渲染成 PNG 并下载（基于官方 [@mind-elixir/export-mindmap](https://github.com/mind-elixir/plugins/tree/main/packages/export-mindmap) 插件内置的 SCST 引擎，SVG foreignObject + Canvas 管线，按根节点主题命名文件）；
- **在桌面应用打开**：一键通过官方 [@mind-elixir/open-desktop](https://github.com/mind-elixir/plugins/tree/main/packages/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（推荐）**

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

**B. Git 仓库**

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

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

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

```powershell
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 条目，两份并存可能重复加载。

## 启动验证

```powershell
npx @deepseek-ai/dsh web
```

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

## 从源码构建

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

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

```powershell
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` 执行），使用时无需关心 |

## 发布

```powershell
# 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）。