cordisplugins/acryl-dsh-editor-plugin-web

DSH 编辑器（已弃用——见下文）

已弃用。 acryl-dsh-editor-plugin（无后缀）现在是通用的：dsh.client.platform: "web" 完全一致地同时覆盖 ACRYL Web 和 ACRYL Desktop，因为 Desktop 的客户端与 Web 一样由 Chromium 渲染。这个 -web 分支的存在只是为了绕过 dsh-client-connection 的 RPC 注册 bug，该 bug 同样影响了裸包；现在该 bug 也已在裸包中修复（acryl-dsh-editor-plugin@0.2.7+）。请改为安装裸包：

dsh plugin --profile web add acryl-dsh-editor-plugin

此分支已在 npm 上弃用，不再接收任何更新。

一个运行在 DeepSeek Harness (DSH) 内部的 VS Code 风格代码编辑器——因此也运行在托管相同 DSH 插件运行时的 ACRYL Desktop 内部。它在会话主区域添加一个 Files 标签页，包含文件树、Monaco 编辑器、跨文件搜索/替换、Markdown 预览以及 Git 状态/差异。

该插件是一个标准的 Cordis 插件（npm 包）。它通过一条 dsh plugin add 命令安装，并在重启后依然保留。

功能

- 文件树——浏览工作区目录，展开/折叠文件夹，显示 Git 状态徽章（M/A/??……）；点击徽章查看差异。
- Monaco 编辑器——多文件标签页、语法高亮、可配置的自动换行 / 迷你地图 / 字体大小 / 制表符宽度、可自定义的快捷键绑定。
- 跨文件搜索——由 ripgrep 驱动：流式增量结果、匹配高亮、虚拟滚动（最多 20,000 条结果）、大小写/全词/正则切换、包含/排除 glob、搜索历史、跨文件替换。
- Markdown 预览——源码 / 预览 / 分屏视图；使用 marked + DOMPurify 净化渲染，支持 highlight.js、mermaid 图表、KaTeX 数学公式以及任务列表复选框。
- 快速打开——Ctrl+P，对相对路径进行模糊匹配。
- 对话路径跳转——Ctrl+click（macOS 上为 Cmd+click）对话中内联代码片段里的文件路径，可直接跳转到 Files 标签页并打开它。
- 主题同步——跟随 DSH 的浅色/深色主题；Monaco、highlight.js 和 mermaid 实时切换。

要求

- Node.js >= 20
- 已安装 DSH（或 ACRYL Desktop），且 dsh CLI 可用
- 跨文件搜索需要 PATH 中有 ripgrep（没有它编辑器会优雅降级）
- 状态徽章和差异需要 PATH 中有 git（可选）

安装

从 npm 安装（推荐）

dsh plugin --profile web add acryl-dsh-editor-plugin-web

从 GitHub 安装

dsh plugin --profile web add git+https://github.com/acryldev/acryl-dsh-editor-plugin-web.git

从本地目录安装

dsh plugin --profile web add file:/path/to/acryl-dsh-editor-plugin-web

安装后，重启 DSH（dsh web --profile web）。会话主区域会出现一个 Files 标签页。

安装到 ACRYL Desktop
ACRYL Desktop 承载着相同的 DSH 插件运行时，因此同一条命令在其内置终端中同样可用——省略 profile 标志，将使用 Desktop 当前激活的 profile：

dsh plugin add acryl-dsh-editor-plugin-web

或者在开发时从本地检出目录安装：

dsh plugin add file:/path/to/acryl-dsh-editor-plugin-web

Desktop 通过其可恢复的安装边界来路由 dsh plugin add：先对当前激活的 profile 做快照，然后安装包，成功后将其协调写入 dsh.profile.bundles。之后请重启 ACRYL Desktop，以便重新扫描客户端模块表并挂载 Files 标签页。

安装的工作原理

dsh plugin add 会将包追加到 dsh.profile.bundles。在 profile 启动时，DSH 会合并该包的 bundle 补丁（cordis.patch.yml）——即对 dsh-editor 宿主行的一次 insert——与手动编写 cordis.patch.yml 挂载行完全一致，并加载该包 dsh.client 字段下声明的浏览器端部分。客户端模块表的扫描结果会在进程内缓存，因此插件集合的变更需要重启 DSH 才能生效。

架构

一个 DSH 浏览器 UI 插件由两部分组成，通过 npm 包的 dsh 字段声明：

- 宿主部分（lib/index.js）——Node 进程中的一个标准 Cordis 插件。注入 fs、subprocess 和 connection；在 /editor 连接通道上提供编辑器私有的 JSON RPC：
- fs:init、fs:stat-path、fs:project-root、fs:list、fs:read、fs:write、fs:files
- fs:search-start / fs:search-poll / fs:search-cancel（ripgrep 任务）、fs:search-replace
- git:status、git:diff
- 客户端部分（lib/client.js）——由 DSH 客户端运行时加载的浏览器模块。渲染 React UI（文件树、标签页、Monaco、搜索、预览），通过 /editor 通道与宿主通信，并注册 Files 会话视图以及 Editor 设置区块。

两部分在启动时完成接线：package.json 声明 dsh.bundle.patch → cordis.patch.yml（宿主）以及 dsh.client → ./lib/client.js（客户端）。无需编辑任何 profile 文件。

动态一次性安装（无需安装即可试用）

src/host.js 和 src/client.js 是同一个编辑器，以动态 Cordis 插件函数体的形式打包。它们可以在单个 DSH 会话内通过 cordis_define 工具定义，并用 cordis_run 激活——无需修改 profile，但进程重启后它们就会消失。参见 install/INSTALL.md。

目录结构

acryl-dsh-editor-plugin-web/
├── lib/
│   ├── index.js           # 宿主部分（Node：fs/git/ripgrep 后端 + /editor RPC）
│   └── client.js          # 客户端部分（浏览器：UI、Monaco、搜索、通过 /editor RPC 预览）
├── src/
│   ├── host.js            # 宿主部分的动态插件函数体（参考 / 快速试用）
│   └── client.js          # 客户端部分的动态插件函数体
├── cordis.patch.yml       # dsh.bundle.patch：将宿主插件行插入到 profile 中
├── package.json           # dsh.bundle.patch + dsh.client 声明
├── install/INSTALL.md     # 安装与迁移指南
├── README.md
└── LICENSE

收录位置

- DSH Store（精选示例）： https://acryl.dev/store/packages/acryl-dsh-editor-plugin-web — 位于目录顶部精选展示，并作为发布指南中的完整示例。
- npm： https://www.npmjs.com/package/acryl-dsh-editor-plugin-web — 标记为 dsh-plugin + acryl-package，商店和 DSH Desktop 市场目录正是通过这种方式发现它。
- 发布指南： https://acryl.dev/store/publishing — 如何发布你自己的 DSH 插件，以本仓库作为参考。

许可证

MIT