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

Abierto Apto para principiantes
#202 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
83/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
typescript
Área
cli, devtools

Línea de trabajo

Lee apps/zcode-cli/packages/adapters/src/plugins/marketplace.ts, especialmente findMarketplaceManifestPath y el orden de candidatos en findPluginManifestPath. Añade el manifiesto de marketplace de ZCode a la búsqueda en el orden descrito en el issue y luego revisa las pruebas de búsqueda de marketplace del repositorio. El trabajo está terminado cuando un repositorio con manifiestos de ZCode y Claude resuelve el manifiesto de ZCode, mientras que uno que solo tiene el manifiesto de Claude sigue resolviéndolo.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
Python
Estrellas
152
Forks
137
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de zai-org/zcode-plugins

Todos los issues de zai-org/zcode-plugins

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.