Marketplace 详细示例
这页补充用户侧更完整的 plugin marketplace 配置示例,适合你已经确定要把 Claude Code 插件接进项目时参考。
注意:这里的 marketplaces 只描述 Claude Code 这类 adapter 原生插件市场。知识库「技能 -> 市场」使用的是 skillRegistries[],不在本页范围内。
示例:接入 Superpowers Marketplace
如果你想直接使用 Superpowers 维护的 Claude marketplace,可以这样配:
yaml
marketplaces:
superpowers-marketplace:
type: claude-code
enabled: true
syncOnRun: true
plugins:
superpowers:
scope: superpowers
superpowers-chrome:
enabled: false
options:
source:
source: github
repo: obra/superpowers-marketplace
ref: main然后安装:
bash
oneworks plugin --adapter claude add superpowers@superpowers-marketplace
oneworks plugin --adapter claude add superpowers-developing-for-claude-code@superpowers-marketplace
oneworks plugin --adapter claude add private-journal-mcp@superpowers-marketplace如果你还想装浏览器插件,也可以继续装:
bash
oneworks plugin --adapter claude add superpowers-chrome@superpowers-marketplace前提是这个 plugin 名字已经存在于该 marketplace 的 marketplace.json 里。
示例:项目内联一个最小 Marketplace
如果你不想依赖整个外部 marketplace,也可以只在项目里声明你真正要用的几个插件:
yaml
marketplaces:
superpowers:
type: claude-code
enabled: true
plugins:
superpowers:
scope: superpowers
superpowers-chrome:
enabled: false
options:
source:
source: settings
plugins:
- name: superpowers
source:
source: github
repo: obra/superpowers
ref: main
- name: superpowers-chrome
source:
source: github
repo: obra/superpowers-chrome
ref: main
- name: private-journal-mcp
source:
source: github
repo: obra/private-journal-mcp
ref: main然后安装:
bash
oneworks plugin --adapter claude add superpowers@superpowers
oneworks plugin --adapter claude add superpowers-chrome@superpowers
oneworks plugin --adapter claude add private-journal-mcp@superpowers说明:
source: settings适合把项目依赖锁到你自己指定的仓库和 ref。- 这种内联 catalog 里的
plugins[].source必须写显式对象,不能写相对路径字符串。 - 相对路径插件源只适用于目录型 marketplace,因为只有目录型 marketplace 才有本地 root 可解析。
自动同步行为
如果你在 marketplaces.<name>.plugins 里声明了插件:
- 第一次
oneworks创建新会话时,One Works 会自动补装缺失插件。 syncOnRun: true时,每次创建新会话前都会按 marketplace 重新同步一次。resume不会重新同步,避免同一会话中途漂移。