前言¶
在使用 DeepSeek Harness (DSH) 的終端界面 (acryl-cli) 時，進行文件操作通常需要脫離當前的 TUI 環境。acryl-dsh-editor-plugin-cli 提供了原生的 /files 命令，允許用戶直接在終端界面中瀏覽、查看和編輯文件，無需切換上下文。這是 acryl-dsh-editor-plugin-web 的 TUI 原生實現版本。
插件簡介¶
該插件由 cordisplugins 維護，屬於 DSH 生態的一部分。它基於 acryl-cli 的 tuiCommands 擴展點（spec 034 T009 或更高版本）註冊命令。與 Web 插件不同，CLI 插件直接在同一個進程中運行，沒有 Host/Client 的拆分，因此插件代碼通過 apply(ctx) 直接註冊命令並讀寫文件，無需設計額外的通信協議。
核心功能¶
- 文件樹瀏覽：支持從根目錄瀏覽，目錄優先排序，支持
..返回上級目錄。 - 導航方式：支持 Vim 風格的
h/j/k/l鍵配合方向鍵進行導航。 - 目錄過濾：按下
/鍵可開啓增量、不區分大小寫的名稱過濾。 - 文件查看器：支持滾動查看，顯示行號。
- 內聯編輯：在查看模式下按
e進入編輯，支持光標移動、字符增刪、換行，按ctrl+s保存。保存機制採用臨時文件重命名，防止寫入中斷導致文件損壞。 - 返回導航：
Escape鍵可逐級返回目錄，或在查看/編輯/搜索模式下退出。
安裝與啓用¶
通過 dsh CLI 安裝插件：
dsh plugin --profile <name> add acryl-dsh-editor-plugin-cli
安裝完成後，重啓 acryl tui，在提示符處輸入 /files 即可啓動。
系統要求與限制¶
- 環境要求：需要 Node.js >= 20。
- 依賴環境：
acryl-cli必須支持tuiCommands(spec 034 T009 或更高版本)。 - 兼容性：在 Web 或 Desktop 等不支持
tuiCommands的表面上，插件行保持不活躍，不會導致崩潰。 - 已知缺失：跨文件/遞歸搜索、git diff、Markdown 渲染、語法高亮。
總結¶
該插件爲 DSH 終端界面提供了基礎的文件管理能力，適合需要頻繁在 TUI 中查看和修改配置文件或代碼的開發者。
