zai-org / zai-org/feedback

[Bug] Linux 3.10.1: 官方插件改名 zcode-cua → computer-use 后 enabledPlugins 旧名不迁移,插件静默不加载、无任何报错

Open
#480 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

提交前确认 · Pre-submission checklist
  • 我已搜索过现有 issue,确认这不是重复 / I searched existing issues and confirmed this isn't a duplicate。(相近的 #405 / #414 / #394 都是 computer-use 插件运行时问题;本 issue 是插件管理/目录层问题:插件改名后配置不迁移、加载静默失败)
  • 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.
问题类别 · Category

插件系统 / 插件管理 · Plugin / marketplace management

涉及的 Agent 框架 · Agent framework

ZCode Agent(自研)

严重程度 · Severity

影响体验 · Major(核心功能静默不可用,且全程零用户可见报错)

复现频率 · Reproducibility

必现 · Always

问题描述 · Description

官方 Computer Use 内置插件从 zcode-cua(0.5.12)改名为 computer-use(0.5.13)之后,旧用户的启用状态没有被迁移,插件静默不再加载:技能列表和 MCP 列表里都不会出现 Computer Use,也没有任何日志/设置页告警,用户几乎无法自助排查。

本机证据(Linux 桌面版,全部可直接复验):

  1. 插件缓存里同时存在新旧两版,且 .zcode-plugin/plugin.json 的描述逐字一致("Computer Use: automate desktop apps with mouse, keyboard, and UI element control."),确认为同一插件的改名延续:
    • ~/.zcode/cli/plugins/cache/zcode-plugins-official/zcode-cua/0.5.12/
    • ~/.zcode/cli/plugins/cache/zcode-plugins-official/computer-use/0.5.13/
  2. 工作目录 ~/.zcode/cli/plugins/marketplaces/zcode-plugins-official/marketplace.json(13 个插件)只含新名 computer-use,旧名 zcode-cua 已从目录消失;
  3. 但用户配置 ~/.zcode/cli/config.jsonenabledPlugins 里仍然是旧名:"zcode-cua@zcode-plugins-official": true——客户端没有把它迁移成新名,也没有把已缓存的新名插件自动启用;
  4. 结果:新名插件文件就躺在缓存里,却不加载;旧名指向目录中已不存在的插件,被静默跳过。重启会话后 Computer Use 技能与 MCP 均不出现,无任何提示。
复现步骤 · Steps to reproduce
  1. 在旧目录/旧版本上启用官方 zcode-cua 插件(写入 enabledPlugins);
  2. 客户端更新,内置插件目录中该插件改名为 computer-use(旧名移除);
  3. 重启 ZCode / 新开会话。
期望表现 · Expected behavior

二选一(建议都做):

  1. 改名自动迁移:marketplace.json / plugin.json 支持 replaces / alias 字段,客户端加载时把 enabledPlugins 里的旧名自动映射到新名,老用户无感切换;
  2. 可见告警:加载阶段发现 enabledPlugins 指向目录中不存在的插件时,至少在 设置 → 插件管理 和会话日志给出提示(例如「zcode-cua 已不在目录中,可能已更名为 computer-use,点击启用」),而不是静默跳过。
实际表现 · Actual behavior

静默跳过,无任何用户可见诊断;插件能力完全不可用,且新版本文件其实已下载到缓存。

ZCode 版本 · ZCode version

3.10.1(desktop,Linux x64)

设备 / 系统 / 浏览器 · Device / OS / Browser

Ubuntu 24.04(GNOME 46,X11 会话),Lenovo 笔记本;不涉及浏览器

截图 / 录屏 / 日志 · Screenshots / Recordings / Logs

无报错日志可贴——这正问题所在:~/.zcode/v2/logs/ 与设置页对该失效启用项全程沉默。

补充两点:

  • 临时解决办法(已验证):手动把 config.jsonenabledPlugins 的键改为 "computer-use@zcode-plugins-official": true,重启会话后即可加载;
  • 顺带想确认的相关设计:内置插件(browser-use / document-skills / computer-use 等 8 个)与 CDN 目录(cdn-marketplace.json 当前快照 5 个,线上已扩到 16 个且含一批金融类插件)走的是合并逻辑。想确认今后 CDN 刷新时内置集是否始终保留——避免内置插件也出现「目录里没有了 → 静默不加载」的同款问题。

— GLM-5.3 in ZCode

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the enabledPlugins entry in ~/.zcode/cli/config.json and the plugin entries in marketplace.json, then trace how renamed or missing plugins are discovered and loaded. Reproduce the zcode-cua to computer-use transition and add coverage for the chosen migration or warning behavior; done means the renamed plugin loads for existing users or the stale entry produces a visible diagnostic.

Written by the indexing model from the issue text.

Assessment

Domain
tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.