在 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