前言¶
在 DeepSeek Harness（DSH）裏看官方文檔或側邊欄文件時，常會碰到要在原位置改幾行代碼、補一段 Markdown、或對 JSON 配置做小改的需求。若只能把內容複製到外部編輯器再貼回，上下文切換成本高，也容易和磁盤上的最新版本不同步。下面介紹的 dsh-file-editor 由維護者 wv-y 提供，歸類爲客戶端插件，目標是在 DSH 右側欄就地完成文本編輯、保存與預覽，並與可選的 dsh-better-sidebar 文件樹入口配合使用。
這是什麼¶
dsh-file-editor 是面向 DSH 右側欄的文本編輯器插件：行號、語法高亮、代碼摺疊、Git 改動標記、自動保存、查找替換，以及 Markdown 預覽。當前 npm 包名爲 dsh-file-editor，版本 1.0.0，MIT 許可證；運行要求 DSH ≥ 0.2.2-rc.1、Node ≥ 20。插件在 DSH 客戶端（Web 平臺）側加載，與 DSH「一切皆插件」的擴展方式一致；社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係，安裝前仍建議自行查看源碼與許可證。
兩種使用入口¶
插件支持兩條路徑，可單獨或同時使用：
- 官方文檔預覽：在預覽頁標題欄點「編輯」，右側欄展開編輯面板，寬度跟隨右側欄；改完後保存回磁盤。
- dsh-better-sidebar（可選）：安裝該插件後，本插件會註冊 file viewer；在文件樹中打開
.ts、.tsx、.js、.md、.json等文本文件時由本插件渲染。未安裝 better-sidebar 時該入口不會註冊，文檔預覽側的編輯能力不受影響。
核心功能¶
以下能力均來自項目 README 說明：
- 編輯體驗：行號；60+ 種語言的語法高亮；代碼摺疊。
- 保存：停手約 0.8s 自動寫盤；
⌘S手動保存；切換或關閉前會刷盤。中文輸入法拼寫期間會暫停自動保存。 - 與磁盤同步：外部改動採用三方合併；無衝突則自動合併保存；有衝突時可選「採用磁盤版本」或「覆蓋保存」。
- Git：改動色條區分新增 / 修改 / 刪除；點擊可查看該處 diff，並支持回滾單塊改動。
- 查找與替換：
⌘F、⌘H；支持區分大小寫、上一個 / 下一個、全部替換；命中行內高亮，當前項爲亮黃。 - Markdown：默認進入預覽；點「預覽」會先保存再渲染。
安裝與啓用¶
在對應 profile 下執行以下其一（命令摘自官方 README）：
dsh plugin --profile <profile> add dsh-file-editor # 從 npm 安裝
dsh plugin --profile <profile> add github:wv-y/dsh-file-editor # 直接從 GitHub 安裝
裝完後刷新頁面；Desktop 用戶建議用 ⌘R 硬刷新。dsh-better-sidebar 爲可選依賴，僅影響文件樹入口是否註冊。
典型用法¶
在文檔預覽裏改內容：打開官方文檔預覽 → 標題欄「編輯」→ 在右側欄修改 → 依賴自動保存或 ⌘S 寫回磁盤。
在側邊欄文件樹裏改源碼（需 better-sidebar）：安裝 dsh-better-sidebar 與本插件 → 在樹中打開支持的文本後綴 → 編輯、使用 Git 色條查看 diff 或回滾局部改動 → 需要時用查找替換批量改字符串。
Markdown 寫作：在編輯器中編寫；需要渲染時點「預覽」（會先保存）。
適用場景與注意¶
適合經常在 DSH 內改文檔、配置或前端腳本的開發者，尤其是希望減少「跳出 DSH 再同步文件」的場景。
使用時請注意：插件以當前 DSH 進程的權限讀寫本地文件；安裝與啓用前請閱讀倉庫源碼與 MIT 許可。合併衝突時務必在「採用磁盤版本」與「覆蓋保存」之間按實際需求選擇，避免誤覆蓋他人或外部工具的改動。
結尾¶
dsh-file-editor 把常用 IDE 能力收攏到 DSH 右側欄，並與文檔預覽、可選文件樹打通。更多元信息與分類見社區目錄：SkillHub 插件頁；源碼與完整說明見 GitHub：wv-y/dsh-file-editor。
