在 DeepSeek Harness (DSH) 環境中進行智能體開發時,對話窗口往往不足以滿足代碼查看、文件管理和版本控制的需求。DSH Editor 插件在 DSH 或 ACRYL Desktop 的運行時環境中提供了一個 VS Code 風格的代碼編輯器視圖。
這是一個由 cordisplugins 維護的 DSH 插件,通過標準的 dsh plugin add 命令安裝,爲會話主區域增加了一個 Files 選項卡。
核心功能¶
該插件集成了文件瀏覽、代碼編輯、搜索替換和文檔預覽等能力:
- 文件樹:瀏覽工作區目錄,支持展開/摺疊。文件列表旁會顯示 Git 狀態徽章(如
M、A、??),點擊徽章可查看差異。 - Monaco 編輯器:支持多文件標籤頁、語法高亮、小地圖、可配置的換行/字體大小/縮進,以及自定義快捷鍵。
- 跨文件搜索:基於 ripgrep 實現,支持流式加載結果、虛擬滾動(可處理 20,000 條結果)、正則/全字匹配切換、包含/排除過濾以及跨文件替換。
- Markdown 預覽:支持源碼/預覽/分屏視圖,渲染 Mermaid 圖表、KaTeX 數學公式和任務列表。
- 快速打開:按下
Ctrl+P(Mac 爲Cmd+P),通過模糊匹配相對路徑快速打開文件。 - 對話路徑跳轉:在對話的行內代碼片段中點擊文件路徑,可直接跳轉到 Files 選項卡並打開對應文件。
- 主題同步:編輯器、高亮庫和圖表會跟隨 DSH 的淺色/深色主題實時切換。
安裝與啓用¶
安裝前請確保環境滿足以下要求:
- Node.js 版本
>= 20 ripgrep已安裝在系統 PATH 中(用於跨文件搜索,缺失時功能降級)git已安裝在系統 PATH 中(用於狀態徽章和差異查看,可選)
在 DSH Web / ACRYL Web 上安裝¶
使用官方推薦命令添加插件:
dsh plugin --profile web add acryl-dsh-editor-plugin-web
安裝完成後,重啓 DSH 或 ACRYL Web(dsh web --profile web),主界面會新增一個 Files 選項卡。
在 ACRYL Desktop 上安裝¶
ACRYL Desktop 內置了 DSH 插件運行時,可直接使用以下命令(無需 --profile web):
dsh plugin add acryl-dsh-editor-plugin-web
重啓 ACRYL Desktop 以加載插件模塊。
典型用法¶
- 瀏覽與 Git 管理:在 Files 選項卡中展開項目目錄,查看文件變更狀態。點擊
M(修改)或A(新增)徽章即可在編輯器中查看具體的代碼差異。 - 快速定位:忘記文件名時,使用
Ctrl+P輸入部分文件名,插件會通過模糊匹配快速定位。 - 上下文跳轉:在對話中看到一行代碼引用了
src/utils/helpers.js,直接點擊該路徑字符串,編輯器會自動跳轉到 Files 選項卡並打開該文件。
注意事項¶
插件已棄用。官方推薦的通用包爲 acryl-dsh-editor-plugin(無後綴),該包通過 dsh.client.platform: "web" 配置即可同時支持 Web 和 Desktop,不再需要 -web 後綴。
- 插件生效:修改插件列表後,必須重啓 DSH 或 ACRYL Desktop 才能生效。
- 動態安裝:插件源碼提供了
src/host.js和src/client.js,可通過cordis_define和cordis_run工具在當前會話中動態加載,無需修改配置文件。
生態鏈接¶
- GitHub 倉庫:https://github.com/cordisplugins/acryl-dsh-editor-plugin-web
- 官方目錄:https://www.skillhub.cn/plugins/cordisplugins/acryl-dsh-editor-plugin-web