dootask/resources/ai-kb/zh/howto/appstore/install.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.install.howto	安装一个插件	howto	appstore	admin	zh	装插件 安装应用 启用功能 怎么开通审批 怎么开 AI install plugin		application	需要系统管理员权限 服务器能连接外网（拉取 Docker 镜像）或已预置离线镜像	安装过程要拉 Docker 镜像，依赖网络速度 不支持仅给单个用户安装（影响全员） 安装失败一般是网络 / 镜像源问题，看 appstore.cannot-install.faq	v1.7.90

安装一个插件

入口

桌面端：左侧栏「应用」→ 顶部分组「管理员」→「应用商店」→ 在列表里选要装的插件。 对应实现：微应用 appstore，注册位置 application/admin，URL appstore/internal。

操作步骤

1. 进入应用商店，浏览插件列表（左侧分类：官方 / 社区）
2. 点击想装的插件，看说明、版本号、作者、依赖资源
3. 点「安装」按钮，AppStore 微服务后台拉镜像并启动容器
4. 等待状态从「安装中」变成「已安装」（时间从十秒到数分钟，取决于镜像大小）
5. 安装完成后到「应用」页刷新，对应入口出现

安装做了什么

• 在 docker/appstore/config/{appId}/ 写入 config.yml，包含 status: installed、install_at、install_version、params
• 把对应 docker-compose.yml 起动；新容器与 DooTask 共享网络
• 部分插件会通过 menu_items 注册微应用入口到普通成员的「应用」页

安装成功验证

• 应用商店里该插件标记为「已安装」
• 普通成员的「应用」菜单看到对应入口
• 后端 App\Module\Apps::isInstalled('xxx') 返回 true

常见可装插件

ai、approve、checkin、face、office、drawio、minder、okr、search、fileview、community_kuaifan_memos、community_kuaifan_kpi 等。

不支持

• 不支持手动改 config.yml 后立即生效（要走 AppStore 流程，否则缓存与状态不一致）
• 不支持选择历史版本安装（除非通过升级）

装不上时

见 appstore.cannot-install.faq。