[Bug] Linux 3.10.1: 官方插件改名 zcode-cua → computer-use 后 enabledPlugins 旧名不迁移,插件静默不加载、无任何报错
Nobody has claimed this yet.
- 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 桌面版,全部可直接复验):
- 插件缓存里同时存在新旧两版,且
.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/
- 工作目录
~/.zcode/cli/plugins/marketplaces/zcode-plugins-official/marketplace.json(13 个插件)只含新名computer-use,旧名zcode-cua已从目录消失; - 但用户配置
~/.zcode/cli/config.json的enabledPlugins里仍然是旧名:"zcode-cua@zcode-plugins-official": true——客户端没有把它迁移成新名,也没有把已缓存的新名插件自动启用; - 结果:新名插件文件就躺在缓存里,却不加载;旧名指向目录中已不存在的插件,被静默跳过。重启会话后 Computer Use 技能与 MCP 均不出现,无任何提示。
复现步骤 · Steps to reproduce
- 在旧目录/旧版本上启用官方
zcode-cua插件(写入enabledPlugins); - 客户端更新,内置插件目录中该插件改名为
computer-use(旧名移除); - 重启 ZCode / 新开会话。
期望表现 · Expected behavior
二选一(建议都做):
- 改名自动迁移:marketplace.json / plugin.json 支持
replaces/alias字段,客户端加载时把enabledPlugins里的旧名自动映射到新名,老用户无感切换; - 可见告警:加载阶段发现
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.json中enabledPlugins的键改为"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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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