DSH 插件总览（逃咪）：以表格视图管理已安装插件，支持状态过滤、HMR 热生效的启停开关、配置查看/复制、卸载与 npm 更新提醒。
中文 | English
版本：v1.3.2 · 更新记录见 CHANGELOG.md（English）
一个更好用的 DSH 插件列表：表格视图、状态过滤、启用/停用开关（热生效）、卸载、更新提醒、配置查看与复制、中英文界面自动切换。 入口在 设置 → 逃咪-插件总览（设置左侧导航，英文环境显示 Runcat Plugin Overview）。
| 能力 | 说明 |
|---|---|
| 表格视图 | 4 列固定比例：名称 36% / 状态 15% / 来源 21% / 操作 28%（名称占最多） |
| 入口位置 | 直接注册在 设置 → 逃咪-插件总览（左侧导航，紧跟"插件"之后） |
| 多语言 | 内置简体中文 / English 双语，界面语言跟随 DSH 环境（设置 → 通用 → Language / 浏览器语言）自动切换；本插件自身的描述也随语言切换 |
| 运行状态 | 已启用/已停用 + Cordis 状态（已挂载 / 等待依赖 / 加载中 / 挂载失败 / 未挂载 / 卸载中） |
| 描述 / 版本 | 从各包 package.json 读取；描述全文在展开行内查看（点"详情"） |
| 来源 | 仅本插件显示仓库主页地址（https://github.com/runcat-tommy/dsh-plugin-runcat-inventory）；其余插件按安装方式显示（本地链接 / 本地路径 / GitHub / npm / 内置） |
| 详情展开 | 有描述或有配置才显示"详情"按钮；展开后行内查看描述全文 + 配置 JSON，配置可一键复制 |
| 启用 / 停用 | 编辑 profile 的 cordis.patch.yml（用户覆盖层），HMR 热生效，无需重启 |
| 卸载 | 操作列"卸载"按钮 + 二次确认；从 profile 移除依赖与 bundle 层，重启 Web UI 生效；不可卸载自身与内置包；卸载后的行在列表中标记"已卸载"（置灰、操作禁用），避免重复操作 |
| 更新提醒 | 检测 npm registry 的 latest 版本（分批扫描：每批 4 个、批间 200ms、1 小时缓存）；本插件自身有新版本时在面板最上方显示醒目卡片；其他插件在版本列显示 vX → vY 高亮 + 行内"更新"按钮 + 顶部横幅；更新时把目标版本写进命令（add <name>@<latest>）并复核版本 |
| 更新结果 | 进度与结果显示在列表行内（确认弹窗点下去就关，不挡界面）：成功→「已生效」或「重启 DSH 后使用」；失败→「更新失败」+「原因」（错误码/命令/退出码/stderr）；更新成功后会调 DSH 自带 HMR 热应用，能应用就不必重启 |
| 批量与重启 | 顶部横幅两个按钮：更新全部插件（串行、逐行进度、完成汇总）、重启 DSH（CLI 宿主可直接重启并等页面自恢复；桌面端由外壳管理宿主，会提示手动重开） |
| 更新边界 | link: / file: / workspace: 这类本地链接依赖不提供更新（点更新会明确拒绝：装 npm 版本会丢掉开发链接）；本地版本已 ≥ npm latest 时报"已是最新"而不是失败；只有"确实比目标旧"才算 VERSION_MISMATCH（npm 源未同步，稍后重试） |
| 搜索过滤 | 关键字（联合搜索名称/id/描述/来源/版本）+ 状态筛选 |
| 排序 | 配置顺序（默认）/ 名称 ↑ / 名称 ↓ |
| 宽度优化 | 无粘性固定列；键盘 ←/→ 横向滚动；窄屏自动隐藏"来源"列 |
dsh-plugin-runcat-inventory/ # git clone 后的本地文件夹名（与仓库同名）
├── package.json # dsh.bundle.patch + dsh.client 声明
├── cordis.patch.yml # 补丁层：把本插件条目 insert 进根 entry 列表
├── lib/
│ ├── index.js # Host 半端：loader 清单 + /runcat-api 路由 + patch 文件编辑
│ └── client.js # 浏览器半端：ModuleLoader bundle，表格 UI
├── test/
│ └── mock-test.mjs # host 半端单元测试（node test/mock-test.mjs，5 用例）
├── assets/
│ ├── preview-zh.png # 中文界面效果图
│ └── preview-en.png # 英文界面效果图
├── CHANGELOG.md # 更新记录（中文）
├── CHANGELOG.en.md # 更新记录（英文）
├── README.md # 中文说明
└── README.en.md # 英文说明
| 依赖 | 必需？ | 说明 |
|---|---|---|
| Node.js | ✅ 必需 | DSH 本身是 Node 程序，必须安装 Node.js（建议 20+ 或最新 LTS，无严格版本下限要求） |
| DSH CLI | ✅ 必需 | npm i -g @deepseek-ai/dsh |
| pnpm | ✅ 必需 | dsh plugin 命令是 pnpm 的转发器，未安装会报 pnpm not found on PATH；npm i -g pnpm |
| Git | ⚠️ 视安装方式 | 方法 B（GitHub 源）/ 方法 C（本地开发）需要；方法 A（npm 安装）不需要 |
| 网络 | ⚠️ 视环境 | 方法 A 需要能访问 npm registry；方法 B/C 需要能访问 GitHub，直连不通时可为 git 配置代理，如 git config --global http.https://github.com.proxy http://127.0.0.1:7897 |
本插件自身零依赖：host 半端只用 Node 内置模块（外加惰性解析 profile 里的 js-yaml），浏览器半端手写 ModuleLoader bundle，无需额外安装任何包。
装进 web profile（如果用的是其他 profile，把 web 换成实际名字）。
dsh plugin --profile web add dsh-plugin-runcat-inventory
直接从 npm registry 拉取，包已发布： https://www.npmjs.com/package/dsh-plugin-runcat-inventory （若你的 npm/pnpm 配置了镜像，等待镜像同步后即可安装。）
dsh plugin --profile web add github:runcat-tommy/dsh-plugin-runcat-inventory
pnpm 直接从 GitHub 拉取；本插件无构建脚本，无需配置 allowBuilds。
git clone https://github.com/runcat-tommy/dsh-plugin-runcat-inventory.git
cd dsh-plugin-runcat-inventory
dsh plugin --profile web add .
dsh plugin add .会把本目录以link:方式装进 profile——本地开发 友好：改代码后重启 Web UI 即生效，无需重复安装。
dsh --profile web --dump-config 末尾应出现条目——id 为
runcat-inventory、name 为 dsh-plugin-runcat-inventory。
然后重启 Web UI，进入 设置 → 逃咪-插件总览（左侧导航，英文环境显示
Runcat Plugin Overview）。
ctx.loader.entries()（与官方 inventory 相同），
fiber 状态映射自 FiberState；描述/版本读各包 package.json；来源读
profile 的 package.json 依赖声明。~/.dsh/profiles/web/cordis.patch.yml 写入
{id, name, disabled: true} 补丁（停用）或移除该补丁（启用）。
该文件被 DSH 通过 HMR 监听（watchUserPatches），改动自动热应用到
loader —— 插件立即停用/启用，无需重启。/runcat-api 路由；路由带 loopback
信任校验（防远程网站 CSRF）。dsh plugin --profile web remove dsh-plugin-runcat-inventory
cordis.patch.yml 含 !!js 表达式，启用/停用开关会提示失败（不
会破坏文件，仅无法自动编辑）。{id, name, disabled: true} 精确匹配移除；与用户手写内容
冲突时以"恰好三个键"为准。完整变更历史见 CHANGELOG.md（English）。
YAML_UNAVAILABLE），补丁文件一个字节都没写。启用/停用改成纯文本编辑：
追加/删除带标记的 - id/name/disabled: true 项，其余字节（注释、!!js、排版、
结尾换行）原样保留，不再依赖任何 YAML 解析器。dsh 根本不在宿主进程
PATH 里：新增 CLI 解析（RUNCAT_DSH_CLI / 宿主 exe + asar 内 cli.js /
PATH / 常见安装位置），找不到时返回 DSH_CLI_NOT_FOUND；② 补丁层里有
!!js 时启用/停用整片失败：注册 !!js 类型并做占位符往返，原始代码
一字不改写回；③ 写回不再丢用户注释。add <name>@<latest>），不再出现"pnpm 空转 exit 0 → 自检判成更新失败"；
本地链接依赖（link/file/workspace）明确拒绝更新；"已是最新"与"更新失败"
分开显示，返回体带 from_version → to_version。② 补齐宿主 peer 声明
（locale + runtime + ui-settings 三件套），市场判定从 unknown 变为
compatible。@deepseek-ai/dsh-client-runtime 不在桌面端宿主清单内，市场仍判 unknown
（已在 v1.2.2 修正）。vX → vY 高亮 +
行内"更新"按钮 + 顶部横幅；分批扫描（4/批、200ms 间隔、1h 缓存）；
更新后标记"重启生效"；支持更新本插件自身。package.json 增加 dsh.marketplace 声明
（供 dsh-plugin-marketplace 扫描器分类）。assets/ 目录）。CHANGELOG.en.md，两份 CHANGELOG 互加语言切换链接。README.en.md，中英文文档顶部互加语言切换链接。dsh-plugin-runcat-inventory（与 GitHub 仓库名一致）；新增"前置条件"
章节（Node.js / DSH / pnpm / Git / 网络）。word-break: break-all），
长 URL 不再溢出到"操作"列。repository），本插件显示 https://github.com/runcat-tommy/dsh-plugin-runcat-inventory。把文件系统与 bash 提供者换成 mirage 虚拟工作区：文件工具与 shell 命令作用于挂载的资源（RAM、S3、Redis、Slack、Gmail、Notion、Postgres）而非宿主磁盘，支持按挂载点设置读/写/执行模式、按命令选择沙箱（进程内 monty、pyodide、quickjs；远程 docker、e2b、daytona），并可在虚拟终端中安装 CLI（git、gh、slack、linear、ntn、gws，或自行注册的程序树）作为命令头词。
在工具执行前后以及尝试结束当前轮次时运行项目 OMA 检查。随插件安装 OMA CLI 依赖，并在首次使用时初始化未配置的项目。需要 Node.js 22+；首次初始化需要网络连接和项目目录写入权限。
Matt Pocock 技能套件的 DSH 控制面板：右侧 details 列打开；含 wayfinder 决策地图、issue 行级 triage / 修复 / 讨论 / 执行按钮、9 项核心套件探测 + 20 个技能雷达、环境检查、跨会话 handoff 交接。
