Repository marketplace resolution ignores .zcode-plugin/marketplace.json and picks .claude-plugin/marketplace.json first

Offen Anfängerfreundlich
#202 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
83/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
typescript
Bereich
cli, devtools

Rechercherichtung

Lies apps/zcode-cli/packages/adapters/src/plugins/marketplace.ts, insbesondere findMarketplaceManifestPath und die Reihenfolge der Kandidaten in findPluginManifestPath. Nimm das ZCode-Marketplace-Manifest entsprechend der im Issue beschriebenen Reihenfolge in die Suche auf und prüfe anschließend die Marketplace-Lookup-Tests des Repositorys. Fertig ist die Änderung, wenn bei einem Repository mit ZCode- und Claude-Manifest das ZCode-Manifest aufgelöst wird und bei einem Repository, das nur das Claude-Manifest enthält, weiterhin dieses aufgelöst wird.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

问题 / 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.

Vorherrschende Sprache
Python
Sterne
152
Forks
137
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus zai-org/zcode-plugins

Alle Issues in zai-org/zcode-plugins

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.