SuperAPI AI 工具集

diagnosing-plugins

部署与运维

查看项目

更新于 10-23 22:28

技能介绍

用途:帮助排查并修复 ZCode 客户端中的插件与市场问题,适用于以下情况:插件未出现在列表中,添加市场或安装失败,插件已启用但其技能或命令不可用,内置插件禁用或卸载后仍然出现,清单解析报错,插件名不合法,依赖无法解析或跨市场依赖失败,版本显示 0.0.0 或检测不到更新,敏感配置项无法填写,以及文件系统/内置来源报“不支持”。

主要能力:该技能按“将问题归因到单一具体修复”的思路组织排查。它说明插件在 Settings → Plugin Management 中管理:Installed 页可启用/禁用、查看详情、配置、卸载;Discover 页可浏览、安装,并通过 + 按钮添加市场。关键事实包括:启用/禁用状态保存在 ~/.zcode/cli/config.json 的 plugins 下;官方市场为 zcode-plugins-official;克隆代理仓库时 ZCode 只读取 ZCODE_HTTP_PROXY,不读取裸 http_proxy。插件发现来源按优先级依次为内联目录、内置官方插件、官方插件缓存、市场安装插件,整个子系统受 plugins.enabled 总开关控制。清单路径按 .zcode-plugin/plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 顺序探测,插件身份为 <name>@<marketplace>。

使用方式:资料给出五步本地化排查流程:先确认 plugins.enabled 是否开启;再在 Installed 页确认插件是否存在、是否启用,并打开详情查看来源、组件和警告;然后按“完全缺失/存在但禁用/启用但运行异常”分类定位;内置插件问题则比对抑制列表与官方市场提供项,并确认插件缓存是否最新;安装与网络问题需设置代理后复现克隆过程,确认 ZCODE_HTTP_PROXY 与可重试错误特征;若列表显示启用但会话中能力缺失,则按发现路径问题处理,检查 Settings → Skills 与 / 菜单中技能和命令是否实际出现。

适用场景:ZCode 插件日常排障、市场接入与安装失败定位、插件清单编写校验、内置插件抑制状态核对、代理环境下克隆市场仓库、跨市场依赖问题处理。

限制:资料未提供该技能的其他平台支持、价格或效果数据;敏感配置值当前无法在界面输入或持久化到配置文件,因为尚无安全凭据存储;npm 和 pip 类型的插件源不受支持;agents、channels、lspServers、outputStyles、settings 仅记录但不执行;组件路径为绝对路径或逃逸插件根目录会被判为无效。