实时写作面板 MathieuPortmann/dsh-edit-panel

dsh-edit-panel

为 DeepSeek Harness（DSH）实时写入文本文件：AI 把文本或 Markdown 文件逐节写进右侧边栏的编辑器，你可以同时在同一个文件里打字。

维护：尽力而为。 Issue 可能无人回复；欢迎 fork。

新增内容

- 五个工具供模型使用，每个对话都可用：
- edit_begin(path, outline, title?) 创建文件并写入标题，同时打开面板；
- edit_write_section(section, content) 写入一节，立即保存到磁盘；
- edit_status() 说明已写了什么、你改了什么、下一步做什么；
- edit_finish() 结束草稿；
- edit_open(path) 在面板中显示已有文件，不做修改。
- 面板（右侧边栏标签页，Live writing）：每节一个小型文字处理器编辑器（加粗、斜体、标题、列表、引用、链接、撤销；以 Markdown 读写）。你输入的内容在短暂停顿后保存，你正在某节打字时 AI 无法覆盖该节。
- 用提议代替覆盖：AI 重写已有文字的节时，文件不变；面板逐词显示它的提议（新增为绿色，删除为红色删除线），你可以逐条保留或拒绝，也可以全部保留或全部拒绝。
- 已有文件安全：已有文件先写入 <file>.draft，只有你按 Finish 才替换原文件（原文件先复制到备份文件夹）；Cancel 丢弃草稿。用 edit_open 打开的文件先备份，再原地编辑。
- 就某段文字问 AI：选中文字，点 ✦ Ask the AI 胶囊按钮（或 Ctrl+K），这段文字连同所在节一起放进消息框，并附快捷操作（缩短、改写、修正、翻译）。
- 对话的文档：消息框上方的抽屉列出本对话打开过的文件，点一下即可重新打开。点击对话中的文本文件链接 name，会在面板中打开它。
- 你给每节的指令和你的决定会作为运行时上下文回传给模型，压缩后依然保留。

支持文件：.md、.markdown、.txt、.text、.tex、.org、.rst、.qmd、.rmd，位于你的主目录内，且不在隐藏文件夹中。Markdown 文件中，节就是 ## 标题。

界面为英文；DSH 语言为法语时显示法语（client.js 顶部的 en 和 fr 表）。

安装

dsh plugin --profile web add github:MathieuPortmann/dsh-edit-panel

之后重启配置档。需要 Node ^22.19.0 || >=24 和 DSH >=0.2.0-rc.2 <0.3.0（见兼容性）。包发布到 npm 后，dsh plugin --profile web add dsh-edit-panel 也可用。

配置

edit-panel 行的选项：

| 选项 | 默认值 | 含义 |
| dataDir | <DSH_HOME>/edit-panel | 草稿状态（每个会话一个 JSON）和文档列表 |
| backupDir | <DSH_HOME>/backups/edit-panel | 文件被替换或打开前的副本 |
| announce | true | 在每个会话里加一行，告诉模型文本文件通过面板写入；设为 false 则只在被要求时使用工具 |

工作原理

- lib/draft.js 管理草稿：按分节渲染文件，再读回来查看你改了什么（每节一个指纹），让提案排队等待，在你输入时锁定某一节 30 秒，替换或恢复文件时带上备份。lib/docs.js 维护文档列表。两者都是纯 Node.js，由 tests/ 覆盖。
- index.js（宿主侧）注册工具，把草稿状态作为运行时上下文发送，并通过 /edit-api/<method> 上的 RPC 通道提供面板，位于 DSH 自身的连接检查之后。
- client.js（页面侧）绘制标签页、抽屉和编辑器。编辑器本身（web/editor.js）是 ProseMirror 和 markdown-it 的打包产物，由 web-src/editor.js 构建；页面从宿主接收它，只加载一次。

兼容性

| 组件 | 支持范围 |
| Node.js | ^22.19.0 \|\| >=24.0.0（engines.node） |
| DSH | >=0.2.0-rc.2 <0.3.0；声明为 @deepseek-ai/dsh-tools 和 @deepseek-ai/schemastery 上的可选 peerDependencies，这是宿主侧唯一导入的 DSH 包 |
| 平台 | Linux（已测试）；纯 JavaScript，无原生插件 |
| 页面 | 带右侧边栏的 DSH Web UI；抽屉通过可编辑区域定位消息框，页面变化时可能需要更新 |

已在 Node 22.23 上用 DSH 0.2.0-rc.2 测试（见验证）。

权限与外部服务

插件能触及的一切，以及失败时的表现：

| 能力 | 位置 | 用途 | 失败时 |
| 文件 | lib/draft.js、lib/docs.js | 写入模型起草的文本文件，以及你在面板中打开的文件，仅限你的主目录内，绝不在隐藏文件夹中，仅限上述文本扩展名；<file>.draft 工作副本；backupDir 中的备份副本；dataDir 中的状态 | 工具或面板显示错误；不写入任何内容 |
| 网络 | 无 | 数据不离开本机 | 不适用 |
| 命令 | 无 | 不启动子进程，不调用 shell | 不适用 |
| 供模型使用的工具 | index.js | edit_open、edit_begin、edit_write_section、edit_status、edit_finish（见上文） | 向模型返回错误文本 |
| HTTP 路由 | index.js（ctx.webServer.register） | 面板使用的 POST /edit-api/<method>，位于 ctx.connection.admit()（DSH 的 Host/Origin 防护和 token）之后；仅接受 JSON 请求体，上限 1 MiB | 未通过校验的请求返回 401/403；其他错误在 RPC 信封中返回 |
| 动态模块加载 | index.js（importFromDsh） | 从运行插件的 DSH 安装中加载 @deepseek-ai/dsh-tools 和 @deepseek-ai/schemastery。不下载任何内容 | 插件加载失败 |
| 页面内代码求值 | client.js（loadLib） | 宿主从本包的 web/editor.js 读取编辑器 bundle，用 new Function 转成代码，只执行一次（或在严格内容策略下，作为 blob 脚本加载）。除此之外不再求值任何文本，也不从网络获取任何内容 | 面板显示「Editor unavailable」，各区块以纯文本显示 |
| 界面 | client.js | 右侧边栏标签页、消息框上方的抽屉、会话中文本文件链接的点击处理器、保存在浏览器 localStorage 中的字体选择；向 DSH 的 locale 服务注册法语词典和语言条目 | 无面板 |

验证

在一次性配置档上验证过（DSH_HOME 指向临时文件夹，绝不触碰真实配置档）：

npm pack
dsh plugin --profile t add file:$PWD/dsh-edit-panel-0.1.0.tgz # install
dsh t --port 3095 --no-open # start: plugin loads, no error
dsh plugin --profile t remove dsh-edit-panel # uninstall

npm test 运行 9 个独立测试（草稿：新建和已有文件、用户的编辑、锁、保留的提案、合并或拒绝、原地打开、取消、重复标题、路径规则；文档列表），无需安装 DSH。

web/editor.js 可复现：cd web-src && npm ci && npm run build 会逐字节重建它，版本锁定在 web-src/package-lock.json 中（esbuild 0.28.2）。打包的库及其许可证列在 THIRD_PARTY_NOTICES.md。

开发

npm test
cd web-src && npm ci && npm run build # after changing web-src/editor.js

许可证

本插件采用 MIT。打包的库保留各自的许可证（MIT，entities 为 BSD-2-Clause），见 THIRD_PARTY_NOTICES.md。