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

快速上手

dsh-plugin-marketplace

— 源: plugin_wiki.wiki_content

安装与验证

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

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

— 源: plugins.install

关键要点

• 全量分页 — 完整 topic 按页拉取（默认 50 / 最大 100），UI 带"加载更多"按钮。不再有"只看 50 个"的硬限制：total 反映真实的 total_count。
• 搜索 — 关键词搜索走 GitHub 自己的 q（所以是在整个 topic 里搜，而不是只在已加载的页里过滤），UI 搜索框和 market_search 工具都用它。
• Agent 工具（Host 侧通过 ctx.tools.register 注册）：
• • market_search(q?, page?, perPage?) — 返回 topic 仓库的 JSON 列表（full name、star、语言、简介、URL）。
• • market_install(spec) — 通过 dsh plugin --profile web add -w <spec> 安装到 web profile。执行前会校验 spec 是否含 shell 元字符；完成后提示需要重启 harness。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装这个插件后需要重启 harness 吗？

需要。本插件属于永久（bundle）插件，安装/更新/卸载后必须重启 DSH harness，新装或变更的插件才会被 Loader 实际加载。

市场上为什么只看到「第三方」插件，内置的去哪了？

「已安装」标签页只展示你后装进 dependencies 的第三方插件；harness 自带的内置插件在 dsh.profile.bundles 模板里，不能关闭或卸载，页面顶部有声明。

装某个插件一直停在「解析依赖 8%」不动怎么办？

默认 120 秒无进度会被停滞看门狗自动中止进程并直接重连一次；若仍卡死会快速失败。可调环境变量 DSH_MARKET_STALL_MS 拉长阈值，或检查网络、改用「让 agent 安装」。

「让 agent 安装」按钮是干什么的？

直装失败时的兜底：插件市场会确保一个专属工作区目录、在该工作区新开一个对话并切过去，把安装任务发给那个新会话；runtime 服务不可用时回退到发给当前会话。

这个插件会把自己的 npm 名误解析成别人的同名包吗？

不会。dsh-plugin-marketplace 这个名字在 npm registry 另有他人持有，本插件显式用自己 package.json 里声明的 GitHub 仓库来检查和更新自己，避免拉到无关包。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: 未声明
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则