cordisplugins/acryl-dsh-editor-plugin-cli

DSH 编辑器（CLI）

为 DeepSeek Harness (DSH) 的
终端界面（acryl-cli）提供的原生 /files 命令——无需离开
TUI 即可浏览、查看和编辑文件。

这是
acryl-dsh-editor-plugin-web
的 TUI 原生姊妹项目，专为 acryl-cli 自身的展示槽扩展点
（tuiCommands，规范 034 T009）而构建，而非浏览器客户端包。这里
没有 Host/Client 拆分：CLI 及其 Cordis Loader 树共享同一个
进程，因此本插件自身的 apply(ctx) 既注册 /files
命令，又直接读写文件——无需设计任何通信协议。

功能（v2）

- 文件树——从你的主目录开始浏览，目录优先
排序，.. 返回上级。Vim 风格的 h/j/k/l 与方向键
同样可用。
- 过滤——/ 会在当前目录的列表上启动一个增量式、
不区分大小写的名称过滤器。
- 文件查看器——可滚动，带行号。
- 编辑器——查看文件时按 e 即可就地编辑：光标
移动、字符插入/删除、换行拆分，以及 ctrl+s
保存。保存通过同目录临时文件再重命名完成，因此
写入中途失败绝不会在磁盘上留下写了一半的文件。
- 返回导航——Escape（或 ←/h）一次后退一级目录，
将你的选择恢复到当初进入的位置，
直到你回到起点后才最终关闭浮层。
Escape 同样会以相同方式退出搜索、查看和编辑模式。

刻意仍未构建的功能：跨文件/递归搜索、git diff、
Markdown 渲染、语法高亮。语法高亮尤其
经过了评估并被刻意跳过——原因见
lib/index.js 文件顶部的注释（它需要与本插件
所遵循的普通 pi-tui Component 契约不同的渲染模型）。

安装

dsh plugin --profile  add acryl-dsh-editor-plugin-cli

（每个 profile 都是其自身的单包 pnpm 工作区，目前
需要 -w 来满足 pnpm 自身的工作区根安全检查：
dsh plugin --profile  add acryl-dsh-editor-plugin-cli -w。）

安装后，重启 acryl tui。在提示符处输入 /files。

要求

- Node.js >= 20
- 带有 tuiCommands 的 acryl-cli（规范 034 T009 或更高版本）——即本插件
所注册的扩展点。在没有该扩展点的界面（Web、Desktop）上安装此插件，
只会让插件的行处于非活动状态，而不会崩溃：
tuiCommands 是硬性 inject 要求，因此 Fiber 在那里根本不会
激活。

架构

DSH TUI 插件通过 npm 包的 dsh 字段声明自身
（dsh.bundle.patch -> cordis.patch.yml，后者插入该行）——这与
每个 DSH 插件使用的约定相同。与 Web 插件不同，这里没有
dsh.client 字段：lib/index.js 是一个标准的 Cordis Host 插件，其
apply(ctx) 调用 ctx.tuiCommands.register({command, description, open})，
其中 open({tui, close}) 返回一个真正的 pi-tui Component，该组件完全由本包构建并拥有。

许可证

MIT