前言¶
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 代碼在工作區沙箱之外、以你的用戶身份在本進程內執行。
