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或文本,无需切换外部编辑器的用户。

패키지
@local/dsh-plugin-document-editor
호환성
미검증
버전
1.0.0
라이선스
MIT
최근 업데이트
2026. 10. 8.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:hh719509125/dsh-preview-editor

使用

还没装?见下面的安装。

装好、并刷新一次页面之后:

  1. 打开文件。 在右侧栏按 Ctrl+P(桌面默认快捷键,打开「文件」树),点一个 .txt / 代码 / .json / .yaml 文件;它会在右侧栏作为一个标签打开。从对话里的文件引用、或交付文件卡片点开也一样。
  2. 直接改。 这些后缀的文件打开时就是这个编辑器,不再是只读预览——光标点进去就能打字。
  3. 保存。 按 Ctrl+S,或点工具条上的「保存」。
  4. 想切回只读预览:用标签工具条上的渲染器下拉,选「纯文本」。

正在编辑一个 .txt:工具条显示「有未保存改动」,右侧是保存与撤销改动按钮

上图就是编辑中的样子。注意三点:

  • 第二行的窄工具条是本插件加的:文件路径 · 状态点 · 保存 · 撤销改动
  • 状态点是黄色、写着「有未保存改动」——还没写盘
  • 图里正在用输入法打字(可以看到候选词条),说明中文输入法在编辑器里正常工作

工具条上一眼能看到状态:

指示含义
绿点 · 已保存缓冲区与磁盘一致
黄点 · 有未保存改动还没写盘;此时关标签或关页面会拦一下
保存中…正在写盘

还有几个顺手的:

  • Tab 缩进两格(不跳出编辑区)
  • 「撤销改动」把缓冲区退回磁盘上的版本
  • 关标签/关页面时若有未保存改动会拦一下
  • .md 默认仍然是渲染好的 Markdown,编辑器在下拉的「编辑源码」里——它不抢 Markdown 的默认位置

Markdown 文件的渲染器下拉里多出「编辑源码」一项,默认仍是 Markdown

上图是 .md 文件的渲染器下拉:打勾的仍是 Markdown(默认),「编辑源码」是本插件新增的选项。 所以打开 .md 不会失去渲染视图,想改源码时从下拉里切过去即可。

各种情况下的表现

情况表现
保存时文件已被别处改动提示「文件已在磁盘上变化,未覆盖」,并给两个选择:用我的覆盖 / 放弃我的改动并重新载入。默认绝不覆盖
编辑期间磁盘上又变了提示条出现「载入磁盘版本」,你的缓冲区不会被自动替换
文件被删掉了保存返回 404 并说明,不会把文件重新创建出来
文件大过一页预览保存停用并说明原因:预览是一次一页读的,回写会把后面的内容截断,所以宁可不让存
工作区外的文件读得到,写会被沙箱拦下(除非该会话是 full-access)
.docx / .xlsx / .pptx不适用——预览是转 PDF,浏览器里没有可编辑文档模型

配置

都在 cordis.patch.yml 的 document-editor 那一行:

字段默认说明
extensions65 个后缀哪些后缀默认进编辑器。刻意不含 md/html/svg/csv/图片/PDF —— 它们各自有更好用的内置渲染器
markdowntrue是否为 .md 额外提供「编辑源码」渲染器(不改变 Markdown 仍是默认这一事实)
maxBytes8388608单次保存的 UTF-8 字节上限,超过返回 413

Host 会把这份配置注入页面(__DSH_DOC_EDITOR_CONFIG__),改完刷新页面生效。