前言¶
在使用 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 中查看和修改配置文件或代码的开发者。
