dsh-plugin-registry 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-plugin-registry 兼容性怎么样？

基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-plugin-registry 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-plugin-registry 还在维护吗？

GitHub 5 星。最近一次上游提交在 2026/8/17。

插件市场 beancookie/dsh-plugin-registry

Q: dsh-plugin-registry 是什么插件？

在会话或设置页检索并一键安装精选插件

DeepSeek Harness

beancookie77 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

在会话或设置页检索并一键安装精选插件

32.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/27 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add beancookie/dsh-plugin-registry

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · market

装得上吗

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 77 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-plugin-registry（未发布到 npm，仅可源码安装）

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/21 14:33:40

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求

查看扫描证据（共 6 处，展示前 6 条）

发起网络请求
lib/client.js:323
return fetch(path, init).then(async (res) => {
读取本地文件
lib/profile.js:228
if (existsSync(corepackJs)) {
读取本地文件
lib/profile.js:262
if (existsSync(join(candidate, 'package.json')))
读取本地文件
lib/profile.js:273
const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
读取本地文件
lib/registry.js:11
return JSON.parse(readFileSync(path, 'utf8'));
发起网络请求
lib/registry.js:19
const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(4000) });

扫描于 2026/11/2（1 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh-app-boot@deepseek-ai/cordis@deepseek-ai/dsh-home-paths@deepseek-ai/dsh-tools

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

1 张 · 点击查看大图

功能亮点

检索精选插件
一键安装插件

README

由 DeepSeek 最新模型翻译生成

dsh-plugin-registry 一个 DeepSeek Harness（DSH）插件：在会话内直接检索并安装 awesome-dsh-plugin 精选列表中的插件。 - search_dsh_plugins — 按关键词/分类检索精选 registry，返回双语描述与安装命令。 - install_dsh_plugin — 真正把插件装进当前 profile（corepack pnpm add + 同步 dsh.profile.bundles，HMR 热加载，无需重启）。 - 可视化页面 — Web 设置页新增「插件市场」分区：搜索框 + 分类过滤 + 已安装/未安装状态过滤 + 一键安装/卸载（带确认弹窗），无需对话即可浏览/管理。数据源：https://raw.githubusercontent.com/beancookie/awesome-dsh-plugin/main/docs/plugins.json（离线时回退到内置快照 data/registry-snapshot.json）。

展开完整文档（README 剩余 1 节）

dsh-plugin-registry

一个 DeepSeek Harness（DSH）插件：在会话内直接检索并安装 awesome-dsh-plugin 精选列表中的插件。

- search_dsh_plugins — 按关键词/分类检索精选 registry，返回双语描述与安装命令。
- install_dsh_plugin — 真正把插件装进当前 profile（corepack pnpm add + 同步 dsh.profile.bundles，HMR 热加载，无需重启）。
- 可视化页面 — Web 设置页新增「插件市场」分区：搜索框 + 分类过滤 + 已安装/未安装状态过滤 + 一键安装/卸载（带确认弹窗），无需对话即可浏览/管理。

数据源：https://raw.githubusercontent.com/beancookie/awesome-dsh-plugin/main/docs/plugins.json（离线时回退到内置快照 data/registry-snapshot.json）。

安装

dsh plugin --profile web add github:beancookie/dsh-plugin-registry

安装完成后直接启动：

dsh web

使用

推荐：页面安装 —— 启动 dsh web 后，打开设置 → 插件 → 插件市场，可搜索、按分类/状态筛选、一键安装/卸载，无需对话：

插件市场

备选：对话安装 —— 直接对 agent 说：

- 「帮我找一个微信通知的插件」
- 「有什么终端 TUI 插件？」
- 「安装 dsh-pet」

agent 会依次调用 search_dsh_plugins 检索、install_dsh_plugin 安装。所有插件均为第三方代码，安装前 agent 会先向你确认。

卸载

dsh plugin --profile web remove dsh-plugin-registry

技术方案

整体架构

插件由「宿主侧」（Node，随 DSH 主进程运行）与「客户端侧」（浏览器 bundle，随 Web UI 运行）两部分组成，通过 /api/dsh-plugin-registry/* 自注册 HTTP 接口衔接。

dsh-plugin-registry
├── src/ 宿主侧源码（tsc → lib/） │ ├── index.ts 入口：装配唯一的 ProfileStore，注册工具 + HTTP 路由 │ ├── registry.ts 远端 registry 拉取/缓存/检索/spec 归一化/ref 解析 │ ├── profile.ts ProfileStore：profile 目录发现、manifest 读写、pnpm 执行、bundles 对账 │ ├── market.ts searchHits：检索 + 附加安装状态（HTTP 与工具共用视图） │ ├── tools.ts DSH 工具：search_dsh_plugins / install_dsh_plugin │ ├── api.ts HTTP 路由：/search /installed /install /uninstall │ └── types.ts 共享类型 ├── client/client.tsx 客户端源码（esbuild → lib/client.js）：「插件市场」设置页 ├── scripts/build-client.mjs esbuild 打包 + __ModuleLoader__ 包装 └── data/registry-snapshot.json 离线回退快照（275 插件 / 11 分类）

核心设计原则：安装状态只有单一事实源 —— 持久化的 profile 清单（package.json 的 dependencies + dsh.profile.bundles）。HTTP API 与 DSH 工具共享同一个 ProfileStore，刻意忽略 loader/HMR，保证「已安装」徽标与卸载行为完全一致。

关键模块

| 模块 | 职责 |
| registry.ts | loadRegistry（1h TTL 内存缓存 + 4s 超时 fetch + 快照回退）、searchPlugins、installSpec、describe、resolvePlugin |
| profile.ts | ProfileStore：dir() 目录发现、manifest() 读写、pnpm() 执行、install()/uninstall()、reconcileBundles() 对账、normalizeSpec() 等辅助函数 |
| api.ts | 单个 prefix 路由 /api/dsh-plugin-registry，按 pathname+method 分发 |
| tools.ts | 通过 @deepseek-ai/dsh-tools 的 defineTool 注册两个 agent 工具 |
| client.tsx | 在 settings.plugins.tab 槽位（id market）注册 React 页面 |

数据流

检索（search）

1. loadRegistry()：TTL 内直接返回内存缓存；否则 fetch 远端（4s 超时），校验 plugins 非空，失败则回退旧缓存或内置快照。
2. searchPlugins()：把查询串按空白拆成多关键词，每个关键词都必须在 name/owner/双语 description 中命中；可选按分类过滤；名称命中 +2 分、其余字段 +1 分，按总分降序取前 N 条。
3. searchHits()：为每条结果附加 profile.installedEntries() 算出的安装状态（以 URL 为唯一身份），产出统一的 SearchHit 视图 —— 工具（渲染为纯文本）与 HTTP（JSON）共用。

安装（install）
1. resolvePlugin()：把用户给的 ref 依次按 URL → name → owner/repo 解析为唯一 registry 条目，重名返回「歧义」错误，未命中返回「not found」。
2. installSpec()：从 registry 的 install 命令提取 pnpm spec，兼容 github:owner/repo/tree/... 无效形态（重建为 github:owner/repo#path:/sub）、npm 包名、以及裸 github:owner/repo。
3. ProfileStore.install()：串行队列执行 —— 读清单 → matchInstalledDep() 判重（已装则直接返回）→ pnpm add → findAddedDependency() 从依赖 diff 定位真实包名 → reconcileBundles() 对账插件层 → isBundle() 判断是否声明 dsh.bundle → 返回结果。
4. reconcileBundles() 镜像官方 dsh plugin add/remove：把声明 dsh.bundle 的新依赖加入 dsh.profile.bundles，把已移除/不再是 bundle 的条目移出。

卸载（uninstall）

matchInstalledDep() 命中依赖则 pnpm remove 并重新对账；未命中但存在插件层陈旧条目时，按候选名（npm/name/spec）清理 dsh.profile.bundles。

关键设计细节

- spec 归一化：pnpm 对同一仓库会写成 github:owner/repo 或 git+https://github.com/owner/repo.git 等不同形态，normalizeSpec() 统一成 owner/repo 的小写形式，避免已装状态漏判。
- 客户端 bundle 注册：scripts/build-client.mjs 用 esbuild 打包（react/react/jsx-runtime 作为外部依赖），并把产物包装进 window.__ModuleLoader__.load({ id: "dsh-plugin-registry", factory })；配合 package.json 的 dsh.client 清单 + exports["./client"] 由 dsh-client-modules 按包名发现加载。
- Windows pnpm 执行：.cmd shim 无法被 execFile，故通过 node corepack/dist/corepack.js 执行，回退 cmd.exe /c corepack pnpm …；stdio 设为 ['ignore', 'pipe', 'pipe']，避免非交互 pnpm 读 stdin 永久阻塞。
- 无头兼容：HTTP 路由注册在 ctx.inject(['webServer'], …) 之下，无 webServer 的 headless profile 仍可正常使用工具，该子 fiber 保持 PENDING。
- 离线容错：远端不可用时回退内置快照，保证检索功能始终可用。

开发

安装依赖
pnpm install

编译 TypeScript 到 lib/，并打包客户端 bundle 到 lib/client.js
pnpm build

把本地包按名链接进 web profile（pnpm add 本地目录 → 符号链接）
dsh plugin --profile web add .

启动（无需 --patch）
dsh web

- 客户端 bundle 由 dsh-client-modules 按包名从 profile 的 node_modules 解析（require.resolve("dsh-plugin-registry/package.json")），所以必须用 dsh plugin add . 让本包可解析；--patch（dev.cordis.patch.yml）只能加载宿主侧（工具 + HTTP 路由），不会触发 Web UI。
- 改 client/client.tsx 后执行 pnpm build，HMR 会按 rev 重载 bundle；改 src/ 后重启 dsh web。

许可

MIT