dsh-plugin-marketplace

为什么使用它？

能力	说明
🔍 自动发现	每两小时扫描一次 topic:dsh-plugin archived:false
✅ Registry 验证	检查 manifest、bundle patch、loader entry、运行产物和精确安装来源
🧩 dsh-std 预检	读取可选 dsh-plugin.json，验证 Community v0.15 与 dsh-TUI v0.15 的静态准入闭包
⚡ 一键安装	仅对全部自动安装条件均通过的插件开放
🤖 Agent 安装	为需要构建、生命周期脚本或人工判断的插件创建受约束的安装 Agent
🧭 安装 Skill	Agent 强制加载内置安全工作流，自动选择精确来源、隔离构建或停止路径
🧱 Agent 工作区	默认使用市场专属工作区，也可选择已有目录，避免污染项目工作区
⌨️ 手动命令安装/更新	安全解析官方 DSH GitHub 命令，验证后安装或更新当前 Profile
🧰 安装管理	按更新/启停状态筛选，单独或批量更新、卸载、启用、停用，并可安全重启 DSH
📈 插件发现	支持分类、搜索、Star 排序和最近 7 天增长趋势
🔄 市场自更新	直接检查本仓库版本，并将更新来源固定到解析后的精确 commit

使用自建 Registry

默认中心 Registry：

https://raw.githubusercontent.com/YELEBAI/dsh-plugin-marketplace/main/registry/plugins.json

可以通过环境变量覆盖：

$env:DSH_PLUGIN_REGISTRY_URL = 'https://raw.githubusercontent.com/OWNER/REPOSITORY/main/registry/plugins.json'
dsh --profile web

也可以在插件配置中设置 registryUrl。远程内容默认在内存中缓存 15 分钟并支持 ETag；刷新失败时先使用最近一次有效内容，再回退到包内快照。缓存时间可通过 registryCacheMinutes 调整；Registry 与安装时 GitHub 请求的超时统一由 registryRequestTimeoutMs 控制。

显式检查更新会绕过缓存时间，但保留 ETag 和最近有效快照；并发检查会合并为一次请求。核心 Registry 返回 304 时仍会刷新分类与 Star 增长数据，可选发现数据暂时不可用时保留已有值。首屏优先读取包内 快照；快照缺失或损坏时会尝试远端。

自建 Registry 可以不提供 discovery.json 和 guided-audit.json：

• 缺少 discovery.json 时，插件仍可搜索和安装，但分类显示为“其他”，Star 增长为 0；
• 缺少 guided-audit.json 时，Agent 仍会依据核心 Registry 的精确 commit 做只读核验，但没有扫描器的辅助审计信息。

除默认开发依赖回归外，使用目标发布版本的真实运行接口检查临时 Profile。

node --import ./scripts/use-installed-dsh.mjs --experimental-strip-types scripts/profile-test.ts

本机可复用现有 Chromium/Edge；CI 明确安装 Playwright Chromium。上述安装命令只用于准备工具，普通 `build`、`typecheck` 和 `ui:test` 不会下载依赖或浏览器。

发布前需要更新版本、重新生成 Registry、构建 `lib/`，然后提交产物并创建版本标签。

> [!NOTE]
> 市场 Remote 方法使用 `marketplace/installPlugin`。不要改回 `marketplace/install`：`install` 是 DSH Remote namespace service 的内部生命周期方法名，会与客户端 API 冲突。

## License

[MIT](https://github.com/YELEBAI/dsh-plugin-marketplace/blob/645954031e7a0e18e6ffe9384ea2e0e55602d32f/LICENSE) © YELEBAI