Repository marketplace resolution ignores .zcode-plugin/marketplace.json and picks .claude-plugin/marketplace.json first
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 83/100
- Issue 类型
- 缺陷
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- typescript
调研方向
阅读 apps/zcode-cli/packages/adapters/src/plugins/marketplace.ts,重点查看 findMarketplaceManifestPath 以及 findPluginManifestPath 中候选项的顺序。按照 issue 中描述的顺序,将 ZCode marketplace manifest 加入查找,然后检查 repository 的 marketplace 查找测试。完成标准是:同时包含 ZCode 和 Claude manifest 的 repository 会解析出 ZCode manifest,而仅包含 Claude manifest 的 repository 仍会解析出该 manifest。
由索引模型根据 Issue 内容生成。
描述
问题 / Problem
如果一个仓库同时为多个 Agent 提供插件,zcode plugins marketplace add <owner>/<repo>(或 Git URL)总会读到 Claude Code 的清单。ZCode 用户装上的就是 Claude Code 的插件包,而不是 ZCode 的。
When one repository ships plugins for several agents, zcode plugins marketplace add <owner>/<repo> (or a Git URL) always reads the Claude Code marketplace manifest. ZCode then installs the Claude Code bundle, not the ZCode one.
原因 / Cause
ZCode v3.18.2 (fec97590), apps/zcode-cli/packages/adapters/src/plugins/marketplace.ts:
function findMarketplaceManifestPath(rootPath: string, explicitPath?: string): string | null {
const candidates = [
...(explicitPath ? [explicitPath] : []),
CLAUDE_MARKETPLACE_FILE, // .claude-plugin/marketplace.json
MARKETPLACE_FILE, // marketplace.json
];
插件清单的查找会先找 ZCode 自己的文件(findPluginManifestPath:.zcode-plugin/plugin.json → .claude-plugin/plugin.json → .codex-plugin/plugin.json),但市场清单的候选里没有 .zcode-plugin/marketplace.json。marketplace add 也没有参数能指定读哪个清单文件:--sparse 只决定检出哪些文件,source.path 也不会从命令行输入里填。
Plugin manifest lookup prefers ZCode's own file (.zcode-plugin/plugin.json first), but marketplace lookup has no .zcode-plugin/marketplace.json candidate. marketplace add also cannot point at another manifest: --sparse only limits the checkout, and source.path is never filled from the CLI input.
复现 / Reproduce
zcode plugins marketplace add EvoMap/evolver-agent-plugin --json
# registers "evolver-agent-plugin" from .claude-plugin/marketplace.json, which lists the Claude Code bundle (dist/claude-code)
该仓库为 Claude Code、Codex、Grok、Qoder、Cursor、WorkBuddy 等 Agent 各提供一份带命名空间的清单,现在也加了 .zcode-plugin/marketplace.json。
The repository has a namespaced manifest per agent (.claude-plugin/, .agents/plugins/, .grok-plugin/, .qoder-plugin/, .cursor-plugin/, .codebuddy-plugin/), and now .zcode-plugin/marketplace.json.
建议 / Proposal
在 findMarketplaceManifestPath 中把 .zcode-plugin/marketplace.json 放在第一位,与插件清单的查找顺序保持一致:
Put .zcode-plugin/marketplace.json first, matching the plugin-manifest order:
const ZCODE_MARKETPLACE_FILE = join(".zcode-plugin", "marketplace.json");
const candidates = [
...(explicitPath ? [explicitPath] : []),
ZCODE_MARKETPLACE_FILE,
CLAUDE_MARKETPLACE_FILE,
MARKETPLACE_FILE,
];
只放一份 .claude-plugin/marketplace.json 的仓库,行为不受影响。
Repositories with only .claude-plugin/marketplace.json behave as before.
目前的绕行方式 / Current workaround
通过原始 URL 登记 ZCode 专用清单(URL 来源会直接读取该文件),它的条目用 git-subdir 来源指向 dist/zcode。已在 ZCode 3.18.2 / CLI 0.17.1 上验证:
Register the ZCode-only manifest by its raw URL; a URL source reads that file directly, and its entry uses a git-subdir source for dist/zcode. Verified on ZCode 3.18.2 / CLI 0.17.1:
zcode plugins marketplace add https://raw.githubusercontent.com/EvoMap/evolver-agent-plugin/main/.zcode-plugin/marketplace.json
zcode plugins install evolver-plugin@evomap --scope user
上面的改动合入后,直接执行 marketplace add EvoMap/evolver-agent-plugin 就能正常工作。
With the change above, plain marketplace add EvoMap/evolver-agent-plugin would work directly.
- 主要语言
- Python
- 星标
- 152
- 派生
- 137
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
zai-org/zcode-plugins 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 76/100
zai-org/zcode-plugins#107 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 85/100
zai-org/zcode-plugins#106 ·
维护者通常 1 天内回复
-
video-agent-kit (0.4.3): hooks invoke python3, which doesn't exist on Windows — SessionStart/UserPromptSubmit/Stop hooks fail on every trigger可能已有人在做 @dvd233 于 57 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 85/100
zai-org/zcode-plugins#14 ·
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 25/100
zai-org/zcode-plugins#194 ·
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 28/100
zai-org/zcode-plugins#193 · 2 条评论 ·
维护者通常 1 天内回复
查看 zai-org/zcode-plugins 的全部 Issue
相似的 Issue
-
opensubtitlescom: provider rejects pt-PT even though its own converter maps it可能已有人在做 @paulo-0308 今天认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
Diaoul/subliminal#1405 ·
-
Internal Error未关闭bug
难度 2/5 1-3 小时 新手友好度 66/100
frappe/frappe_docker#2071 ·
维护者通常 1 天内回复
-
bug python
难度 2/5 1-3 小时 新手友好度 76/100
traceloop/openllmetry#4717 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
The-Pocket/PocketFlow#161 ·
-
comp/desktop P2 type/bug
难度 2/5 1-3 小时 新手友好度 78/100
NousResearch/hermes-agent#157702 ·
维护者通常 1 天内回复