hh719509125/dsh-preview-editor ↗★ 5
@local/dsh-plugin-document-editor
Edit text documents in place inside the Sidebar document preview, saving through an authenticated Host route. 适合需要在侧边栏直接修改代码、JSON或文本,无需切换外部编辑器的用户。
설치
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:hh719509125/dsh-preview-editor使用
还没装?见下面的安装。
装好、并刷新一次页面之后:
- 打开文件。 在右侧栏按
Ctrl+P(桌面默认快捷键,打开「文件」树),点一个.txt/ 代码 /.json/.yaml文件;它会在右侧栏作为一个标签打开。从对话里的文件引用、或交付文件卡片点开也一样。 - 直接改。 这些后缀的文件打开时就是这个编辑器,不再是只读预览——光标点进去就能打字。
- 保存。 按
Ctrl+S,或点工具条上的「保存」。 - 想切回只读预览:用标签工具条上的渲染器下拉,选「纯文本」。

上图就是编辑中的样子。注意三点:
- 第二行的窄工具条是本插件加的:文件路径 · 状态点 · 保存 · 撤销改动
- 状态点是黄色、写着「有未保存改动」——还没写盘
- 图里正在用输入法打字(可以看到候选词条),说明中文输入法在编辑器里正常工作
工具条上一眼能看到状态:
| 指示 | 含义 |
|---|---|
| 绿点 · 已保存 | 缓冲区与磁盘一致 |
| 黄点 · 有未保存改动 | 还没写盘;此时关标签或关页面会拦一下 |
| 保存中… | 正在写盘 |
还有几个顺手的:
Tab缩进两格(不跳出编辑区)- 「撤销改动」把缓冲区退回磁盘上的版本
- 关标签/关页面时若有未保存改动会拦一下
.md默认仍然是渲染好的 Markdown,编辑器在下拉的「编辑源码」里——它不抢 Markdown 的默认位置

上图是 .md 文件的渲染器下拉:打勾的仍是 Markdown(默认),「编辑源码」是本插件新增的选项。
所以打开 .md 不会失去渲染视图,想改源码时从下拉里切过去即可。
各种情况下的表现
| 情况 | 表现 |
|---|---|
| 保存时文件已被别处改动 | 提示「文件已在磁盘上变化,未覆盖」,并给两个选择:用我的覆盖 / 放弃我的改动并重新载入。默认绝不覆盖 |
| 编辑期间磁盘上又变了 | 提示条出现「载入磁盘版本」,你的缓冲区不会被自动替换 |
| 文件被删掉了 | 保存返回 404 并说明,不会把文件重新创建出来 |
| 文件大过一页预览 | 保存停用并说明原因:预览是一次一页读的,回写会把后面的内容截断,所以宁可不让存 |
| 工作区外的文件 | 读得到,写会被沙箱拦下(除非该会话是 full-access) |
.docx / .xlsx / .pptx | 不适用——预览是转 PDF,浏览器里没有可编辑文档模型 |
配置
都在 cordis.patch.yml 的 document-editor 那一行:
| 字段 | 默认 | 说明 |
|---|---|---|
extensions | 65 个后缀 | 哪些后缀默认进编辑器。刻意不含 md/html/svg/csv/图片/PDF —— 它们各自有更好用的内置渲染器 |
markdown | true | 是否为 .md 额外提供「编辑源码」渲染器(不改变 Markdown 仍是默认这一事实) |
maxBytes | 8388608 | 单次保存的 UTF-8 字节上限,超过返回 413 |
Host 会把这份配置注入页面(__DSH_DOC_EDITOR_CONFIG__),改完刷新页面生效。