软件商店
软件商店集中管理 Agent 应用、运行环境和辅助工具。这里的“免费”指面板提供安装与管理入口，不代表第三方软件、模型 API 或云服务一定免费。
软件商店中的应用、状态和操作入口开始前准备
认识页面
| 区域 | 用途 |
|---|---|
| 一键部署 | 查看面板可直接管理的应用与运行环境 |
| 官方应用 / 第三方应用 | 按来源浏览组件；第三方应用需要额外确认权限和费用 |
| 全部 / 已安装 / 运行环境 / 工具 | 按状态或类型筛选 |
| 搜索软件 | 按名称查找 Agent 或组件 |
| 状态 | 区分未安装、已安装、运行中和可更新等状态 |
| 操作 | 根据应用状态显示网页端、配置、终端、导入、导出、更新或卸载等入口 |
不同应用的操作按钮并不完全相同，以当前卡片实际显示为准。
安装第一个 Agent
- 点击左侧“软件商店”。
- 在“一键部署”中选择“全部”，或直接搜索应用名称。
- 先核对“系统支持”是否包含当前系统。
- 打开应用卡片提供的安装或配置入口。
- 按页面提示确认运行目录、安装方式和所需组件。
- 等待状态变为“已安装”或“运行中”，再进入 实例管理 验证实例。
完成状态
目标应用不再显示未安装状态；配置、终端或打开入口可用，并能在实例管理中看到对应引擎。
更新、导入和导出
- 出现“更新”时，先结束该 Agent 正在执行的任务，再执行更新。
- “导出”适合备份当前应用的可迁移配置；导出文件仍可能含服务地址或账号信息，应按敏感资料保管。
- “导入”前核对来源和适用版本，不要导入来历不明的配置包。
- 更新后至少执行一次模型连接、实例在线和只读测试任务。
导入、导出不等同于完整备份。换机前还应阅读 升级、备份与迁移。
卸载应用
- 确认没有任务正在使用该应用。
- 记录关联的实例、运行目录和必要配置。
- 先导出需要保留的配置，再点击应用卡片中的“卸载”。
- 返回实例管理，确认旧实例不再被任务选中。
- 如需清理剩余数据，按 升级、备份与迁移 核对数据目录，不要直接删除未知目录。
安装模式怎么选
| 模式 | 适用情况 | 需要额外确认 |
|---|---|---|
| 本机 | 日常使用、需要访问本地项目 | 目录权限、端口和运行环境 |
| 隔离 | 希望减少对本机环境的影响 | 隔离边界、文件映射和资源占用 |
| 远程 | Agent 运行在服务器或其他电脑 | 网络、SSH 安全和远程目录 |
只有当前安装页面明确提供某种模式时才选择它；不要根据模式名称推断所有应用都支持相同能力。
故障排查
| 现象 | 检查顺序 |
|---|---|
| 列表加载失败 | 网络连接、刷新按钮、日志中心中的请求错误 |
| 安装一直进行中 | 磁盘空间、目录写入权限、下载进程和日志时间点 |
| 显示已安装但无法使用 | 应用设置、模型配置、实例是否在线 |
| 更新后启动失败 | 当前版本、旧配置兼容性；必要时恢复更新前备份 |
| 终端一闪而过 | 从日志中心复制完整错误，不要只反复点击启动 |