跳到主内容

DSH-Plugins-Marketplace 使用指南

DSH Web GUI 内的第三方插件与通用 Skills 市场：自动收录 GitHub 全部 dsh-plugin / agent-skills / claude-skills 标签仓库，在设置页提供浏览、一键安装、版本检测与已安装识别。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

DSH-Plugins-Marketplace

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-plugin-marketplace

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装完成后为什么必须重启 DSH？

是的。DSH 的 Web profile 关闭了配置热重载（cordis.patch.yml 注册或插件代码改动后 HMR 不生效），必须重新运行 dsh web 才能加载新插件；这是宿主行为，市场本身只负责把条目写进补丁文件。

浏览插件列表会消耗我的 GitHub API 配额吗？

不会。列表由仓库 GitHub Actions 每 2 小时构建一次静态索引（registry.json），用户通过 jsDelivr CDN 读取，零 API 调用、零限流；只有手动点「刷新」且 CDN / raw.githubusercontent 两个源都不可用时才会回退搜索 API，此时未认证限流 10 次/分钟。

一个仓库能被识别成哪几种形态？

共四种：cordis 插件（含 package.json，装到 web profile）、技能（含 SKILL.md，装到 ~/.dsh/skills/）、agent 预设（含 preset.yml + agent.cordis.yml，装到 ~/.dsh/.agent-presets/）、安装脚本（install.sh/install.ps1）。插件作者要按 STANDARD.md 写对应标记，才能被正确识别。

需要 API Key 的插件会怎么处理？

装到第 3 步时会扫描 README、.env 示例和 install 脚本，发现形如 API_KEY / TOKEN / SECRET / PASSWORD 的环境变量会自动暂停，弹窗请你填写或跳过；填的值只作为本次安装的环境变量传入子进程，不写入任何持久化文件。

已装插件的 API Key 填错了怎么办？

已安装卡片有「编辑」按钮，列出该插件扫描到的环境变量键名（值不回显，已配置项会标记），可补填、修改或手动添加新键；保存后写入 ~/.dsh/.env 并合并进 envs.json，重启 DSH 后生效。

为什么有的已安装插件没有「卸载」按钮？

卸载依赖本市场维护的 installed.json 安装记录。只对「通过本市场安装」的插件提供卸载按钮，会一并删除安装目录、cordis.patch.yml 注册条目与安装记录；手动预装或第三方 CLI 装入的插件只能识别为「已安装」，需手动删除目录。

本插件市场自己怎么升级？

设置页检测到新版后会出现「v旧 → v新」横幅与「立即更新」按钮；点击后服务端克隆最新仓库、校验 staging 完整性、原子替换本体目录（失败自动回滚），完成后重启 DSH 生效；与安装共用全局互斥锁，进行中重复点击会返回 409。

局域网里其他电脑能用这个市场吗？

局域网可浏览（读端点对所有可信 Host 放行），但安装 / 卸载等写操作默认只允许本机回环；如需在 LAN 上执行写操作，需在 ~/.dsh/marketplace/config.json 中设置 {"lanWrite": true}，并在请求里带上页面注入的会话 token（x-dsh-marketplace-token 头）。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明（适配目标为 DSH web profile，依赖 cordis、webServer、slots、locale、tapIndex 等宿主服务；install.sh 头部要求 dsh CLI 与 pnpm）
  • Node: 未声明（lib/index.js 大量使用 node:child_process / node:fs/promises / node:crypto / node:zlib 等内置模块，建议跟随 DSH 宿主版本）
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则

DSH-Plugins-Marketplace 使用指南