CodeWave IDE

Appearance

功能规格说明：插件更新策略 ​

规格文件：docs/specs/ui/plugin-updates.md创建日期：2026-08-10

本规格定义 VS Code 扩展（packages/vscode）与 JetBrains 插件（packages/jetbrains）的版本更新策略：插件不内置更新检查（不查询 GitHub Releases、不查询企业 manifest、不自动下载安装），更新完全由官方市场机制负责（VS Code 扩展自动更新 / JetBrains Marketplace 插件更新）。桌面应用（packages/desktop）是独立 Electron 应用，走 electron-updater 自有机制，不在本规格范围。CLI 的 wave update 命令见 Update 命令。

用户场景与测试 （必填） ​

用户故事：插件更新由官方市场机制管理（优先级：P1） ​

作为使用 VS Code 扩展或 JetBrains 插件的用户，我希望插件版本的检查与更新完全由官方市场机制负责，插件自身不内置更新检查逻辑，以便更新体验与官方渠道一致，且插件不依赖平台内部 API。

为什么是这个优先级：JetBrains Marketplace 审核禁止插件使用平台内部 API（PluginInstaller 等无公开替代品），自建更新检查同时带来双端行为漂移；移除后插件完全复用官方更新通道。

独立测试：安装从市场发布的插件版本，确认插件运行期间不产生任何自建更新检查的网络请求；发布新版本到市场后，IDE/VS Code 通过其原生机制提示更新。

验收场景：

  1. 假设 VSCE 扩展从 VS Code Marketplace 安装，当新版本发布到市场时，则 VS Code 按扩展自动更新设置完成更新，插件自身不发起任何更新检查。
  2. 假设 JetBrains 插件从 JetBrains Marketplace 安装，当新版本发布到市场时，则 IDE 按其插件更新设置提示并完成更新，插件自身不发起任何更新检查。
  3. 假设 VSCE 扩展或 JetBrains 插件启动，当插件运行时，则插件不向 GitHub Releases API 或企业下载 manifest 端点发起更新检查请求。

用户故事：状态对话框不再提供手动检查更新（VSCE/JB）（优先级：P1） ​

作为 VS Code 扩展或 JetBrains 插件用户，我希望状态对话框只展示版本信息、不提供「检查更新」按钮，因为插件更新统一由官方市场管理。

为什么是这个优先级：手动检查入口依赖与自建更新检查相同的自更新链路；移除入口使插件不再有任何更新检查路径，同时保持对话框信息展示功能不变。

独立测试：在 VS Code 与 IntelliJ 中打开状态对话框，确认版本行无「检查更新」按钮；在桌面应用中打开状态对话框，确认按钮仍存在且可用。

验收场景：

  1. 假设 用户在 VS Code 或 JetBrains IDE 中打开状态对话框，当对话框渲染版本行时，则不显示「检查更新」按钮。
  2. 假设 用户在桌面应用中打开状态对话框，当对话框渲染版本行时，则仍显示「检查更新」按钮，点击触发桌面应用自身的更新检查（electron-updater）。

边界情况 ​

  • 非市场渠道安装（内网手动下载 zip 安装）怎么办？ 插件不内置更新检查；新版本通过官方渠道发布后，由用户自行获取新版本安装包手动更新（IDE 只对从市场安装的插件执行自动更新）。
  • JetBrains 插件从市场安装后仍被 verifier 报告内部 API 使用怎么办？ 本规格移除 UpdateChecker（唯一使用 PluginInstaller / IdeaPluginDescriptorImpl 的代码）后，重新构建并上传，verifier 不应再报告内部 API 使用。