DeepSeek Harness 的插件管理器：发现社区在 dsh-plugin GitHub topic 下发布的插件，检查其内容，并通过规范的 dsh plugin 包管理路径完成安装 / 移除 / 更新——可以在 Web UI 的「插件市场」标签页中操作，也可以通过 agent 工具完成。

功能

设置 → 插件 → 插件市场（Web UI）
- 发现：搜索带 dsh-plugin 标签的 GitHub 仓库（最佳匹配 / 最多 Star / 最近更新），打开仓库查看 Star、topics、许可证、README（内置安全渲染： Markdown 标题 / 代码块 / 表格 / 列表 / 链接 / 图片，外加白名单净化的 HTML 标签——<div align> 徽章墙、<img>、<sup>、<details> 等； script / iframe / 事件属性 / javascript: URL 一律剥离；相对图片自动改写为 raw.githubusercontent.com 地址），以及关键信息—— 其 package.json 是否声明了 dsh.bundle（可激活的 bundle 层）、是否含 prepare 脚本（git 安装会从源码构建）。
- 一键安装：点击「申请安装」后由插件管理器直接执行 dsh plugin add（宿主进程发起，不经 agent、无需审批——这是你本人在本地界面发起的操作），页面实时滚动显示命令输出，成功 / 失败即时反馈，可随时取消。「已安装」页的更新 / 移除同样直接执行。
- 详情弹窗：仓库详情以模态弹窗展示（点击卡片立即弹出，带入场动效；Esc / 点击遮罩 / 关闭按钮均可关闭），无需滚动到页面顶部； README 在弹窗内独立滚动阅读，头部、徽章与安装区保持固定。
- 一键重启：安装 / 更新 / 移除成功后，任务面板提供「重启 DSH 并刷新页面」按钮——自定义确认弹窗（不使用浏览器原生对话框）确认后，宿主按当前启动方式拉起替代进程后退出，页面轮询等待服务恢复并自动刷新（含超时兜底提示）。
- 安装源智能解析：github:owner/repo 源会先查证该仓库同名包是否已发布到 npm 注册表——若已发布则自动改用 npm 包安装（npm 包自带预构建产物）；未发布则经 HTTPS 从 codeload.github.com 下载源码 tarball （自动走代理配置），解压到 $DSH_HOME/.plug-manager-src/ 后按本地路径安装。全程不使用 git，彻底避开 pnpm 把 github: 转成 git+ssh 导致无 SSH key 机器安装失败的问题。源码包若声明了运行时依赖，会先在源码目录内执行 npm install（目录依赖按真实路径解析裸导入，依赖必须装在源码目录里），避免「装完一重启就 ERR_MODULE_NOT_FOUND」；依赖安装失败时直接中止，不把坏组合装入 profile。
- 安装后校验：安装成功后回读并输出实际包名（源码安装的包名常与仓库名不同）、依赖登记与 bundle 层注册状态；若包未声明 dsh.bundle.patch 会明确警告「DSH 不会加载它，可考虑移除」，杜绝「装成功但悄悄不生效」。
- 彻底移除：移除 = 删除本地插件相关文件且系统不再加载。除 pnpm 卸载依赖、CLI 自动对账清理 bundle 层外，还会回读验证移除结果（残留即警告），并同步删除插件管理器下载的本地源码目录（.plug-manager-src/<owner>--<repo>）。
- pnpm 兼容兜底：pnpm 7 在较新 Node 上抓取注册表会报 ERR_INVALID_THIS；检测到此错误时自动改用 npm 完成安装，并手动登记 bundle 层（复刻 dsh CLI 的 reconcile 逻辑）。
- GitHub 代理：直连 GitHub 受限时，可在页面上直接配置代理并测试连通性（见下文「代理配置」）。
- 已安装：列出 $DSH_HOME/profiles 下每个 profile 的 bundle 栈与已安装依赖，以与「发现」一致的卡片样式展示（版本 / 许可证 / 安装源 / bundle 层徽章），支持按名称 / 安装源 / 描述搜索。点卡片打开详情弹窗：除本地信息外，若插件关联 GitHub 仓库，还会展示仓库星标 / topics / README；卡片与弹窗均可一键「GitHub ↗」直达仓库，并提供「更新 / 移除」操作。
- 插件社区：标签栏右侧「插件社区 ↗」按钮，新窗口打开社区站点 https://casually.github.io/dsh-plug-hub/。
Agent 工具（模型侧入口，执行前按沙箱策略征询审批）
- plug_install — dsh plugin --profile <name> add <spec> （npm 包名、github:owner/repo[#ref]、git+<url>、.tgz URL 或路径）
- plug_remove — dsh plugin --profile <name> remove <package>
- plug_update — dsh plugin --profile <name> update [package]
本地 JSON API（仅回环地址，由运行中的 web 服务器提供）： /plug-mgr/search、/plug-mgr/repo、/plug-mgr/profiles、 /plug-mgr/request（启动安装 / 更新 / 移除任务）、 /plug-mgr/job（查询 / 取消任务）、/plug-mgr/restart（重启 DSH 服务，页面自动等待恢复并刷新）、/plug-mgr/pending（agent 工具待审批队列）、/plug-mgr/proxy、/plug-mgr/proxy-test。

代理配置

GitHub 发现功能访问 api.github.com 与 raw.githubusercontent.com。出厂部署不挂载平台级 fetch provider，本插件自行发起请求：默认直连（Node fetch）； 配置代理后经系统 curl 发出，因此支持 http / https / socks5 / socks5h / socks4（Clash 的混合端口与 SOCKS 端口都可用）。

代理来源按优先级生效：

持久设置（UI「GitHub 代理」栏输入后点「应用」）——写入 DSH 主目录/plug-manager.json，立即生效且重启后保留；点「清除」移除；
插件配置——在 profile 的 cordis.patch.yml 中为本插件加 config.proxy（持久生效）：
```
- id: plug-manager
  name: dsh-plug-manager
  config:
    proxy: http://127.0.0.1:7890
```
环境变量——DSH_PLUG_MANAGER_PROXY，或标准的 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY（大小写均可），在启动 DSH 的 shell 中设置：
```
export HTTPS_PROXY=http://127.0.0.1:7890
dsh web
```

UI 的「测试连接」会请求 api.github.com/zen 验证当前生效通道并报告延迟。特殊值 direct 可强制直连（同样会被持久保存）。

注意：代理只影响本插件的 GitHub 发现请求；dsh plugin 安装操作走 pnpm，其代理由 pnpm/npm 自己的配置管理。

安装兜底：当 pnpm 与当前 Node 不兼容（如 pnpm 7 在新版 Node 上的 ERR_INVALID_THIS 注册表抓取错误）时，插件会自动改用 npm 完成安装并手动登记 bundle 层。profile 里 pnpm 专有的 link: 依赖会临时改写为语义等价的 file:，安装完成后还原，不影响原有符号链接。

安全模型

两条执行路径，两种信任模型：

UI 直接执行：Marketplace 页面里的安装 / 更新 / 移除由你在本地界面亲手点击触发，宿主进程直接执行 dsh plugin（等同于你自己敲命令），不经过 agent，也不额外审批。操作输出实时回显，可随时取消。
Agent 工具：plug_* 工具由模型调用。profile 目录位于 $DSH_HOME/profiles、所有会话工作区之外，因此工具会先解析会话的常驻沙箱策略；当它窄于 danger-full-access 时，会在执行任何命令之前通过 harness 审批服务征询用户；拒绝或无人应答都会失败关闭，不会执行任何操作。

无论哪条路径，请把安装当作它本来的含义：允许该包的代码在你的机器上执行（git 类型的安装源在安装时可能执行包的 prepare 脚本）。只安装你信任源码的插件；git 安装源建议锁定到具体 commit。

安装

要求 PATH 中有 pnpm（dsh plugin 命令会转发给它）；使用代理功能还要求宿主有 curl（macOS / 主流 Linux 自带）。profile 本身是 pnpm workspace 根目录，add 必须带 -w。

# npm 安装（推荐：预构建产物，版本齐全）
dsh plugin --profile web add -w dsh-plug-manager

# 锁定版本
dsh plugin --profile web add -w dsh-plug-manager@0.6.6

# GitHub 源码（最新 main；也可 #vX.Y.Z 锁 tag）
dsh plugin --profile web add -w github:Casually/deepseek-harness-plugs-manage

# 本地目录（开发自用，在本目录的父目录下执行）
dsh plugin --profile web add -w ./dsh-plug-manager

经 dsh plugin 命令安装后重启 DSH（dsh web）以组合新 bundle。

手动安装（不经 dsh CLI）

# 1. 进入 DSH 插件目录（web profile 目录）
cd ${DSH_HOME:-~/.dsh}/profiles/web

# 2. 安装社区插件发现管理插件
#    （较老的 pnpm 拒绝向 workspace 根目录直接 add 时，改用 pnpm add -w dsh-plug-manager）
pnpm add dsh-plug-manager

在 package.json 的 dsh.profile.bundles 字段中添加 "dsh-plug-manager" （bundle 层栈决定加载顺序；经 dsh plugin 命令安装会自动登记，手动安装需自行添加）：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-plug-manager"
      ]
    }
  }
}

重启 DSH 服务使其生效。

安装完成后，「插件市场」标签页会出现在设置 → 插件下；plug_* 工具对该 profile 的所有 agent 可用。

卸载

dsh plugin --profile web remove dsh-plug-manager

重启 DSH 以移除该层。

开发说明

零运行时依赖：宿主插件是纯 ESM，通过 ctx.get 读取 Cordis 服务，服务缺失时优雅降级；代理请求经由系统 curl，无需额外 npm 依赖。
浏览器端以预构建形式交付（client.js，window.__ModuleLoader__ 格式），仅依赖平台的 react wire 模块。
GitHub 抓取在本地强制限制：30 秒超时、5 MB 响应上限、10 万字符文本上限。
给你自己的插件仓库打上 dsh-plugin topic 标签，即可出现在「发现」中。