前言¶
DeepSeek Harness（DSH）的内置文档预览是只读的，其 README 明确列出了“Preview, not editing”这一取舍。同时，workspaceFiles 这个 Remote 也没有提供写入方法。本插件补上了这条缺失的写入通路，并把编辑器注册成预览自己的一个渲染器，因此不需要替换任何内置渲染器。
核心功能¶
- 在文档预览中就地编辑文本文件。
- 支持 Ctrl+S 快捷键保存。
- 冲突保护（保存时检测磁盘变化）。
- 逐字节保留行尾（CRLF/LF）。
- 编辑 Markdown 源码。
- 工具栏显示保存状态（已保存/未保存/保存中）。
安装¶
插件由 agent 安装（plugin_manager 是 agent 工具，用户不直接调用）。把这条规格发给你的 DSH agent：
plugin_manager { action: "install_bundle", target: "github:hh719509125/dsh-preview-editor" }
安装后需要刷新页面。
使用¶
- 打开文件。按
Ctrl+P打开文件树，点击.txt、代码或.yaml文件；也可以从对话里的文件引用或交付文件卡片打开。 - 直接编辑。这些后缀的文件打开时即为编辑器，不再是只读预览。
- 保存。按
Ctrl+S，或点击工具条上的保存按钮。 - 切换视图。在渲染器下拉菜单中选择「纯文本」或「编辑源码」。
工具条上的状态指示如下：
- 绿点 · 已保存：缓冲区与磁盘一致。
- 黄点 · 有未保存改动：还没写盘；此时关闭标签或页面会提示。
- 保存中…：正在写盘。
注意事项¶
- 内置预览是只读的，需通过此插件启用写入。
- 需刷新页面生效。
.docx/.xlsx/.pptx不适用（预览为 PDF）。- 大文件保存被禁用（超过一页）。
- 工作区外文件可读但写被沙箱拦。
- 需要危险权限（danger-full-access）。
技术实现¶
插件通过 cordis.patch.yml 配置 extensions（默认支持 65 个后缀）和 markdown（是否提供编辑源码选项）。Host 代码在工作区沙箱之外、以你的用户身份在本进程内执行。
