dootask/resources/ai-kb/zh/howto/micro-app/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
micro-app.install.howto	安装微应用	howto	micro-app	admin	zh	怎么安装微应用 装插件 安装应用 应用市场怎么用 装 OKR 装思维导图		application	需要系统管理员权限 主程序能访问应用市场镜像源（默认走 kuaifan 官方仓库）	普通成员不能安装微应用，入口对其隐藏 安装过程依赖 Docker 拉镜像，未联网或镜像源不通时安装会一直卡在「下载中」 不能离线导入插件包（无 manual upload 入口）	v1.7.90

安装微应用

入口

• 桌面端：左侧栏「应用」→ 管理员分区的「应用商店」卡片（也叫应用市场）→ 选择应用 →「安装」
• 移动端：竖屏底部 Tabbar「应用」→「应用商店」卡片
• 「应用商店」卡片仅系统管理员（userIsAdmin = true）可见，普通成员没有安装入口

操作步骤

1. 进入应用商店，按分类或搜索找到想装的应用（插件）
2. 点击「安装」，等待镜像拉取与容器启动（包大小决定时长，10MB 以上插件可能需要数分钟）
3. 安装成功后插件状态变为 installed，应用卡片出现在所有用户的应用面板，无需重启主程序
4. 部分插件首次进入需配置（如 office 的 Doc 服务器、ai 的模型 Key）

验证安装成功

• 应用商店该插件按钮变为「卸载」/「更新」
• 应用中心「常用」分区出现新卡片
• 普通成员需刷新页面或重新登录才能看到（缓存）

失败排查

• 镜像源不通：检查服务器到镜像源网络
• 端口冲突：检查 docker/appstore/apps/<id>/docker-compose.yml
• 详细排查模板见 okr.cannot-install.faq

不支持

• 普通成员不能安装微应用，「应用商店」对其隐藏
• 单次只能装一个插件，无批量安装
• 不能选指定版本（始终装应用商店推荐的版本）