dootask/resources/ai-kb/zh/howto/appstore/uninstall.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.uninstall.howto	卸载一个插件	howto	appstore	admin	zh	卸载插件 删除应用 关闭功能插件 怎么停掉 AI 删掉审批 uninstall plugin		application	需要系统管理员权限	卸载会停容器并标记 status，但不一定立刻删数据卷 不支持卸载 `appstore` 本身（强制保留） 卸载后用户在「应用」页对应入口立即消失，正在使用的会话可能报错	v1.7.90

卸载一个插件

入口

桌面端：左侧栏「应用」→「应用商店」（仅管理员）→ 找到目标插件 →「卸载」按钮。

操作步骤

1. 进入应用商店，定位到已安装的插件
2. 点击「卸载」按钮
3. 确认弹窗：通常会提示「卸载后相关数据如何处理」
4. 等待 AppStore 微服务停容器、改 config.yml 状态为非 installed
5. 刷新「应用」页，对应菜单消失

卸载做了什么

• 在 docker/appstore/config/{appId}/config.yml 更新 status 字段（非 installed）
• 调 docker compose down 停掉对应容器
• 触发主程序缓存失效：RequestContext::save('app_installed_xxx', false)
• 之后所有对该插件的后端调用会被 Apps::isInstalledThrow() 拦截，抛 ApiException

卸载会影响的数据

取决于插件实现：

• 多数官方插件停容器但保留 docker/appstore/apps/{appId}/data/ 数据目录
• 重新安装通常能恢复数据
• 若要彻底删数据，需要手动到服务器删 data/ 目录（不可逆，做之前先备份）

卸载前建议

1. 先把该插件相关业务数据导出（如审批数据 data-export.approve.howto、签到 data-export.checkin.howto）
2. 通知使用该插件的成员
3. 重要数据先做服务器侧备份

不支持

• 不支持仅对部分用户隐藏（卸载即全员失效）
• 不支持「停用但保留菜单」中间态
• 不支持卸载 appstore 自身