dootask/resources/ai-kb/zh/howto/appstore/update.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
appstore.update.howto	更新一个插件	howto	appstore	admin	zh	更新插件 升级插件 怎么升级 AI 插件有新版本 update plugin 升级应用		application	需要系统管理员权限 服务器能拉取新镜像	更新会触发容器重建，期间该插件功能短暂不可用 不支持回滚到旧版本（除非自行管理镜像） 不支持自动升级（每次需要管理员手动确认）	v1.7.90

更新一个插件

入口

桌面端：左侧栏「应用」→「应用商店」（仅管理员）→ 已安装的插件如果有新版本，会显示「更新」按钮。

操作步骤

1. 进入应用商店，看到有新版本提示（红点 / 数字）
2. 点击插件 → 「更新」
3. 阅读更新日志，确认无破坏性变更
4. 点「确认更新」
5. AppStore 微服务拉新镜像 → 停旧容器 → 起新容器
6. config.yml 的 install_version 更新

更新期间会发生什么

• 该插件提供的接口短暂返回 502 / 不可用（几秒到一分钟）
• 微应用入口仍在「应用」页，但点开可能加载失败
• 与该插件交互的 AI 工具、机器人会失败（前端通常会重试）

更新失败怎么办

• 多数因为新镜像拉取失败（网络、镜像源），先看 appstore.cannot-install.faq 的网络部分
• 容器起不来：服务器 docker logs 看日志
• 状态卡在「更新中」：到 docker/appstore/config/{appId}/config.yml 检查状态字段
• 必要时卸载重装

更新前建议

1. 浏览插件官方说明，确认有无破坏性变更（DB 迁移、参数改名等）
2. 业务高峰期之外操作
3. 关键插件（AI / 审批 / 签到）先备份对应数据
4. 提前通知使用方

不支持

• 不支持选择目标版本号升级（只能升到最新）
• 不支持自动定时升级
• 不支持回滚（除非自己留旧镜像 + 手动改 docker-compose）