# MonkeyCode AI 使用指南 欢迎使用 MonkeyCode AI!本文档将帮助你快速上手,了解如何完成各项操作。 --- ## 一、产品简介 MonkeyCode 是面向研发团队的企业级 AI 开发平台,覆盖 **需求 → 设计 → 开发 → 代码审查** 全流程。你可以用自然语言描述需求,让 AI 帮你写代码、做设计、做 Review。 **入口说明**:首页(`/`)顶部导航含「控制台」(已登录时)、「广场」(`/playground`)、「使用文档」等;开发者广场(`/playground`)、发布内容(`/playground/create`)、公开任务(`/tasks/public`)可直接访问对应路径。登录后个人控制台默认进入 **新任务页**(`/console/tasks`,顶栏面包屑显示为「新任务」)。 --- ## 二、登录与账号 ### 登录 1. 打开登录页(`/login`),在 **普通用户** 与 **团队管理员** 两个标签之间切换 2. 输入邮箱和密码 3. 完成验证码验证 4. 点击登录 - **普通用户**:进入个人控制台(`/console/…`),使用智能任务、项目管理等功能。同一区域还提供 **百智云账号登录**、**注册**(跳转 OAuth 流程)入口。 - **团队管理员**:进入企业管理后台(`/manager/…`),管理团队资源(该标签下暂无「找回密码」入口,密码问题需按团队流程处理)。 ### 找回密码 在 **普通用户** 登录表单中点击「找回密码」,将打开找回密码页(`/findpassword`)。输入注册邮箱并完成验证后,系统会发送重置链接到你的邮箱;点击邮件中的链接,按提示设置新密码即可。 --- ## 三、控制台导航 登录后进入个人控制台,布局为 **左侧边栏 + 顶栏 + 主内容区**。 **左侧边栏** - **开发项目**:展示 **默认** 分组与各项目。点击刷新图标可刷新列表;标签右侧「+」为 **创建项目**。 - **默认**:点击进入新任务页(`/console/tasks`);旁的「+」为 **创建任务**(与进入同一页后创建任务等价)。展开后列出未归属项目的任务;每条任务悬停可出现 **更多** 菜单,支持 **删除任务**。 - **具体项目**:点击进入该项目概览(`/console/project/:projectId`);项目行右侧「+」为 **启动任务**(基于该项目仓库创建 AI 任务,未绑定仓库时该按钮不可用)。展开后列出该项目下任务,同样支持 **删除任务**。 - **配置**:侧栏底部点击「配置」打开设置弹窗,可管理 Git 身份、AI 大模型、系统镜像、宿主机、开发环境、通知等。 - **用户区**:侧栏最底部为当前账号信息。点击展开菜单可 **修改昵称**、**修改密码**、**登出**;点击头像区域可 **修改头像**(图片 ≤5MB)。 **顶栏(个人控制台)** - 面包屑导航(例如任务详情中会显示任务名称)。 - **技术交流群**:悬停展示微信、飞书、钉钉群二维码。 - **钱包**:查看点数余额(充值/赠送)、兑换码兑换、交易记录、邀请链接等(大屏下显示;小屏可能收纳)。 - **帮助**:跳转官方文档站点。 **未在侧栏列出的页面(需直接访问 URL 或自行收藏)** - **Git 机器人 / 代码审查**:`/console/gitbot`(审查任务与审查机器人配置)。 - **IDE 辅助工具**:`/console/ide`(当前为占位页,含开源与文档链接,见下文「IDE 辅助工具」一节)。 --- ## 四、智能任务 ### 如何创建一个任务 1. **输入任务内容** 在输入框中用自然语言描述你的需求,例如:「为这个项目添加用户登录功能」。 2. **选择任务类型** 点击「开发 / 设计 / 审查」按钮选择: - **开发**:让 AI 根据需求写代码 - **设计**:让 AI 输出技术方案和设计文档 - **审查**:让 AI 审查代码,提出改进建议 3. **选择代码来源** 点击「代码」按钮: - **我的仓库**:展开后按已绑定的 Git 身份分组,选择身份后显示该身份下授权的仓库列表(支持搜索)。其中 GitHub 需使用 **GitHub App 安装** 方式绑定的身份才会出现可选仓库;Gitee、Gitea、GitLab 等为 OAuth 类绑定。若未绑定,会提示「去绑定」并跳转到配置页 - **其他仓库**:输入完整的 Git 仓库地址,按回车确认;下方会显示历史使用过的仓库供快速选择 - **ZIP 文件**:选择本地的 .zip 压缩包上传(最大 10MB),上传成功后该文件会作为代码来源 4. **选择技能(可选)** 点击「技能」按钮,按标签分类展示技能列表。勾选需要的技能以扩展 AI 能力,部分默认技能不可取消。 5. **语音输入(可选)** 点击麦克风按钮,用语音描述任务,系统会自动转为文字。 6. **点击「执行」** 会弹出「任务参数」配置窗口,确认后即可开始执行。任务创建成功后会跳转到任务详情页。 ### 任务参数配置 执行前可以调整: - **大模型**:选择要使用的 AI 模型(含免费模型和付费选项) - **仓库分支**:不填则使用主分支 - **身份凭证**:使用「其他仓库」时,需选择已绑定的 Git 身份(从「我的仓库」选择的仓库已自动关联身份,不展示此选项) 子账号还可以选择宿主机和系统镜像。开发工具固定为 OpenCode。 ### 查看任务列表 任务创建后会在下方以卡片形式展示,每个卡片显示: - 任务摘要 - 关联的仓库或文件 - 状态:等待执行、正在执行、任务完成、执行失败 - Token 用量(若有) - 创建时间 点击任务卡片进入任务详情页。列表支持无限滚动,接近底部时自动加载下一页(每页 24 条,与接口分页一致)。 --- ## 五、任务开发页面 任务创建后或从列表进入,会打开任务详情页(`/console/task/:taskId`),你可以在这里与 AI 协作。 ### 页面布局 - **主区域**:与 AI 的对话与交互区。上方为可滚动的 **消息列表**;其下依次为 **执行步骤**(有规划时显示)、**文件变更提示条**(有待提交改动且 AI 等待你输入时可能出现)、**输入框**。展开右侧面板时,中间会出现 **可拖动的竖向分割线**,用于调整左右区域宽度。 - **底部工具条**:**文件**、**终端**、**修改**(若有未提交改动会显示数量)、**预览**(已开放端口时显示数量)、**续期**。点击前四项可在右侧展开对应面板,再次点击可收起。**续期**为打开续期弹窗,而非右侧面板。 - **文件**:项目文件树,可浏览、打开、编辑文件 - **终端**:终端输出,展示 AI 执行的命令,也可手动输入 - **修改**:查看 AI 修改过的文件及 Diff - **预览**:端口转发与在线预览 - **续期**:延长开发环境使用时间;当剩余可用时间不足约 1 小时时,「续期」文字会闪烁提醒 任务已结束(非执行中状态)时,文件/终端/修改/预览按钮会禁用,悬停提示「任务已结束,无法查看」。**续期**仅在虚拟机仍在线时可用。 开发环境准备中时,主区域会显示准备状态(如「正在创建虚拟机」等)。若当前开发环境不可用,原输入框位置会显示「开发环境不可用」。 ### 与 AI 对话 - 当 AI 执行完毕、等待你的反馈时,底部输入框会变为可输入状态 - 输入补充说明或新指令,点击发送,AI 会继续执行 - 支持 **Shift+Enter** 换行,**Enter** 发送 - 输入框左侧有 **菜单(≡)** 按钮,可进行: - **重置上下文**:清空当前对话上下文,后续操作基于新上下文(会二次确认) - **重新加载开发工具**:重新加载 OpenCode 等开发工具 - 支持**语音输入**:点击麦克风按钮,用语音描述需求,系统会自动转为文字 - 支持**斜杠命令**:点击 **终端样式** 的按钮可展开服务端下发的可用命令列表(如 `/command`),选择后会将对应内容插入输入框 ### 查看 AI 的执行进度 - **执行步骤**区块位于 **消息列表下方、输入框上方**,展示 AI 的计划步骤及完成进度;可通过右侧按钮 **展开/折叠** 全部步骤(执行中且折叠时可能仅显示当前进行中的步骤) - 执行中可点击 **停止** 中断当前执行 - 页面底部工具条右侧会展示 Token 用量(宽屏为输入/输出分项,窄屏可为合计展示) ### 提交代码变更 当 AI 修改了代码后: 1. 对话区域会显示「X 个文件被修改,是否提交保存」 2. 点击「提交」会向 AI 发送指令,让其用 git 提交并推送;也可点击「不急」暂时忽略 3. 若需选择性提交,可点击该提示区域打开变更列表,勾选要提交的文件后提交选中或全部提交 4. 在「修改」面板中可查看每个文件的 Diff ### 查看和编辑文件 - 点击底部「文件」按钮展开文件树,点击文件可查看内容(超过 1MB 会提示无法预览) - 支持多种展示方式:代码高亮、Markdown 渲染、图片预览、JSON 格式化等 - 代码类文件可直接在编辑器中修改,修改后保存即可 - 文件操作支持:新建文件/文件夹、上传、复制、移动、删除等 ### 其他功能 **在线预览** 当任务中运行了 Web 服务(如前端开发服务器)时: 1. 点击底部「预览」按钮展开预览面板 2. 查看已开放的端口列表 3. 若端口尚未开放,需先「开放端口」:系统会获取你的 IP 并加入白名单,开放后可通过生成的访问地址在浏览器中预览 4. 若端口已开放,直接复制访问地址在浏览器中打开即可 **续期** 开发环境有回收时间,即将到期时「续期」按钮会闪烁提醒: 1. 点击「续期」按钮 2. 在弹窗中选择要续期的时长 3. 确认后开发环境的使用时间会延长 --- ## 六、代码审查(Git 机器人) 在 **Git 机器人** 页面(`/console/gitbot`,个人控制台侧栏无固定入口时需手动输入地址访问),可以配置 Git 机器人,让 AI 自动审查你的合并请求(PR/MR)。页面默认展示 **审查任务** 标签。 ### 审查任务 「审查任务」标签下: - 以列表形式展示所有由机器人触发的审查任务 - 每个任务显示关联的 PR/MR、状态、平台等,点击可跳转到对应 Git 平台的 PR 页面 - 点击「刷新」可更新列表 - 若无任务,会显示「如何使用?」链接,可查看配置说明 ### 创建审查机器人 1. 切换到「机器人」标签 2. 点击「创建审查机器人」 3. 填写: - **备注**:可选,便于区分多个机器人 - **Git 平台**:GitLab、GitHub 或 Gitee - **Access Token**:在对应平台的设置中生成,用于机器人访问仓库 - **宿主机**:选择运行审查任务的机器(MonkeyCode 内置或自有宿主机) 4. 提交后,系统会显示 Webhook 地址和 Secret Token,并提示在 Git 平台配置 ### 在 Git 平台配置 将生成的 Webhook 地址和 Secret Token 配置到你的 Git 仓库或组织的 Webhook 设置中。配置完成后,当有 PR/MR 创建或更新时,Git 平台会向该地址发送事件,MonkeyCode 收到后自动触发 AI 进行代码审查。具体配置步骤因平台而异,可参考各平台的 Webhook 文档。 ### 管理机器人 每个机器人卡片右侧有「更多」菜单: - **编辑**:修改备注、Token、宿主机等配置 - **查看 Webhook**:再次查看 Webhook 地址和 Secret Token,可复制 - **权限管理**:选择可将该机器人分享给哪些团队成员,被分享的成员可以使用该机器人 - **删除**:移除不再使用的机器人(需确认) --- ## 七、开发项目 ### 如何创建项目 1. 在左侧「开发项目」区域点击「+」按钮 2. 在弹窗中输入项目名称 3. 选择代码仓库: - 若已绑定 Git 身份(GitHub、Gitee、GitLab、Gitea 等),会显示已绑定的身份列表,选择其中一个身份 - 选择身份后,系统会加载该身份下授权的仓库列表,从中选择要关联的仓库 - 若尚未绑定 Git 账号,会提示「去绑定」并跳转到配置页 4. 提交后,项目会出现在侧边栏,并自动进入该项目页面 ### 项目页面 若项目 **未绑定仓库**,进入项目页后会显示「项目异常」提示,无法使用启动 AI、自动 Review 等依赖仓库的能力;需先在创建/编辑流程中完成仓库绑定。 进入正常项目后,顶部有三个 Tab:**信息**、**需求**、**任务**。 **信息** Tab: - **项目信息**:名称、描述、仓库状态(未绑定仓库时会显示提示) - **文件树**:树形展示仓库结构,点击目录可展开/折叠,点击文件可预览内容 - **README**:自动加载仓库根目录的 `README.md` 并渲染 **需求** Tab:创建和管理需求,详见「项目需求」。 **任务** Tab:查看该项目下的所有任务,点击任务可进入任务详情页。 ### 启动 AI 操作 在项目信息区域点击「启动 AI」按钮: - 弹出「启动 AI 任务」对话框,选择分支后点击「开始对话」 - 系统会基于当前项目仓库创建开发任务,并跳转到任务详情页与 AI 对话 ### 自动 Review 项目信息区还提供 **自动 Review** 入口(与「启动 AI」并列):用于为该项目配置是否开启自动代码审查(需已绑定仓库)。开启后状态会显示为「已开启自动 Review」,未开启为「未开启自动 Review」,点击可进入配置。 ### 项目设置 点击项目信息区域的「更多」菜单: - **修改名称**:在弹窗中修改项目名称和描述,保存即可 - **环境变量**:配置项目运行时的环境变量 - **开发镜像**:选择项目使用的系统镜像 - **移除项目**:删除项目(不可恢复,请谨慎操作) ### 项目需求 在项目内切换到「需求」标签: 1. 点击「创建需求」 2. 输入需求标题和原始需求说明(支持 Markdown) 3. 提交后,需求会出现在列表中 **需求详情**:点击某个需求可查看和编辑: - 标题:点击可修改 - 原始需求、技术方案:可编辑并保存 - 状态:进行中、已完成、已关闭 - 优先级:高、中、低 **从需求启动任务**:在需求详情的「更多」菜单中: - **启动设计任务**:让 AI 基于需求输出技术方案 - **启动开发任务**:让 AI 基于需求直接开发 - **移除**:删除该需求 ### 项目任务 切换到「任务」标签,可查看该项目下的所有任务,点击任务卡片可进入任务开发页面。 --- ## 八、配置 点击侧栏底部的「配置」会打开 **设置弹窗**(非独立路由页面),可在其中管理各类基础设置。 ### Git 平台身份凭证 用于在 Git 仓库中拉取和提交代码。 **绑定 GitHub**:点击「绑定 GitHub」,按提示完成 GitHub App 安装和授权。 **绑定 Gitee**:点击「绑定 Gitee」,在弹窗中完成 OAuth 授权。 **绑定其他平台**(如 GitLab、Gitea): 1. 点击「绑定」→「绑定其他平台」 2. 选择平台类型,填写 Base URL、Access Token、邮箱、用户名 3. 提交即可 **管理**:已绑定的身份可修改备注或移除。 ### AI 大模型 平台提供部分免费模型,你也可以添加自己的 API 模型。 **添加**: 1. 点击「添加模型」 2. 填写 API Token 和模型 API 地址(默认百智云,可改为自建或第三方) 3. 选择接口类型(如 OpenAI Chat、Anthropic 等,需与模型兼容) 4. 点击「获取模型列表」拉取该地址下的可用模型 5. 从列表中选择要添加的模型 6. 保存前会进行连接检查,通过后即可使用 **管理**:可设为默认、检查连接、修改或移除(仅自己添加的模型可编辑和删除)。 ### 系统镜像 配置任务运行时的操作系统环境(Docker 镜像)。不同镜像提供不同的预装环境和工具。 **添加**:点击「添加镜像」,输入镜像名称(如 `docker.io/library/ubuntu:24.04`),可选填写备注,保存即可。 **管理**:可设为默认、修改备注、移除。 ### 宿主机 若希望任务在你自己的机器上执行,需先将机器接入为宿主机。 1. 点击「绑定宿主机」或「获取安装命令」 2. 弹窗会显示一段安装命令,点击可复制 3. 以 root 权限登录你的 Linux 服务器,粘贴并执行该命令 4. 执行成功后刷新页面,宿主机会出现在列表中 **管理**:可修改备注、设为默认、移除。 ### 通知 配置任务执行完成后的通知接收方式,支持钉钉、飞书、企业微信、Webhook 等渠道。可添加多个通知通道,并选择要接收的事件类型(如任务完成、任务失败等)。 ### 开发环境(虚拟机) 展示你名下所有开发环境,包括任务自动创建的以及手动创建的。 **查看列表**:每个环境显示名称、状态(运行中/待机/离线)、系统、配置、创建时间等。可切换「显示离线环境」来查看已回收的环境。 **创建**: 1. 点击「创建开发环境」 2. 选择宿主机(或 MonkeyCode 免费宿主机) 3. 选择系统镜像、CPU 核数、内存大小 4. 选择回收时间(如 1 小时后、3 天后等) 5. 可选:填写仓库地址、分支、身份凭证,创建时会预拉取代码 6. 点击创建 **操作**:续期、删除、进入终端、打开文件管理 --- ## 九、终端 从开发环境列表点击「终端」进入终端页面。需在 URL 中指定环境 ID(通常从开发环境列表点击进入时会自动带上)。 ### 首次连接 若该环境没有已有连接,会弹出选择框: - **使用已有连接**:列出该环境下已有的终端会话,选择其中一个连接 - **新建连接**:创建新的终端会话 选择后即可进入终端界面。也可以关闭某个不再需要的终端连接。 ### 常用功能 - **重新连接**:断线后点击「重新连接」重新建立连接 - **在线预览**:与任务开发页面的在线预览相同,可配置端口转发,在浏览器中访问运行中的 Web 服务 - **文件管理**:跳转到该环境的文件管理页面 - **远程协助**: 1. 点击「远程协助」 2. 选择模式:**只读**(对方只能看,不能操作)或 **控制**(对方可输入命令) 3. 点击「生成连接信息」 4. 复制连接地址和密码,发送给对方 5. 对方在浏览器打开地址、输入密码后即可连接 - **配色方案**:在下拉框中选择终端主题,选择后会保存,下次进入自动应用 --- ## 十、文件管理 从开发环境列表点击「文件管理」进入。默认进入该环境的 `/workspace` 目录。 ### 浏览文件 - 顶部面包屑显示当前路径,点击任意一级可快速跳转 - 点击「上级目录」返回上一级 - 点击文件夹进入该目录 - 点击文件:若为目录则进入,若为普通文件且小于 1MB 则打开编辑弹窗;超过 1MB 会提示无法在线编辑 ### 新建 点击「新建」下拉: - **创建文件夹**:输入文件夹名称(相对于当前路径),保存后会在当前目录下创建 - **创建文件**:输入文件名(含路径),保存后创建空文件 - **上传文件**:选择本地文件,上传到当前目录 ### 文件操作 每个文件/文件夹右侧有「更多」菜单: - **复制**:在弹窗中选择或输入目标路径,将文件复制到该位置 - **移动**:在弹窗中选择或输入目标路径,将文件移动到该位置 - **下载**:将文件下载到本地 - **删除**:删除该文件或文件夹(需确认,删除目录会递归删除其内容) ### 编辑文件 在编辑弹窗中修改内容后,点击保存即可写入。支持多种文件类型的语法高亮。 --- ## 十一、IDE 辅助工具 IDE 辅助工具(`/console/ide`)当前为占位页:提示功能「敬请期待」,并说明相关能力已开源。页面提供 **开源仓库**(跳转 GitHub `chaitin/MonkeyCode`)与 **阅读文档** 按钮。侧栏无入口时需直接在地址栏访问 `/console/ide`。 --- ## 十二、开发者广场 开发者广场(`/playground`)可浏览和分享内容,可从首页进入或直接访问。未登录时可浏览,发布需先登录;**发布**流程对应路由 **`/playground/create`**(从广场点击发布会进入该页)。 ### 浏览 - 在搜索框输入关键词,点击「搜索」或按回车,可筛选帖子 - 每个卡片显示封面图、标题、描述、作者、浏览量 - 点击卡片进入详情页查看完整内容 ### 发布 点击「发布」后,先选择发布类型: **写一篇文章** - 输入标题、正文(支持 Markdown) - 可上传图片:点击上传区域选择图片,或拖拽图片到编辑区 - 点击发布,审核通过后会显示在广场上 **分享你执行过的任务** - 从下拉列表中选择要分享的任务 - 输入标题和说明 - 可选:通过「选择文件」从该任务的开发环境中勾选要打包的代码文件,分享时会一并打包供他人下载 - 点击发布,审核通过后会显示在广场上 --- ## 十三、公开任务 公开任务(`/tasks/public`)展示他人公开分享的任务列表。每个任务以卡片形式展示,点击可进入任务详情页,查看任务描述、执行过程或关联的代码文件等。 --- ## 十四、远程协助 当你在终端页面使用「远程协助」功能时,会生成一个连接地址和密码。将地址和密码发送给对方后: - **只读模式**:对方在浏览器中打开地址、输入密码后,只能看到你的终端画面,无法输入或操作 - **控制模式**:对方可以看到终端画面,并且可以输入命令、进行操作 适用于需要他人协助排查问题、或进行远程演示等场景。 --- ## 十五、企业管理后台 使用团队管理员账号登录后,可进入企业管理后台(`/manager`,默认重定向到 `/manager/dashboard`)。左侧 **企业管理** 分组下的菜单为:**仪表盘**、**成员管理**、**开发环境**(管理团队接入的宿主机)、**AI 大模型**、**系统镜像**、**管理员**、**操作记录**、**其他配置**(界面文案与路由 `/manager/images` 等一一对应)。下面分别说明每个页面的功能和操作方式。 ### 仪表盘 当前为「敬请期待」状态,后续将提供团队概览数据。 --- ### 成员管理 成员管理页面分为两个区域:**团队成员** 和 **分组**。 #### 团队成员 **查看成员列表** - 页面展示所有团队成员,每人显示头像、姓名、邮箱、加入时间、最后使用时间 - 顶部显示「当前成员数量 / 成员上限」 **添加成员** 1. 点击「添加成员」按钮(若已达成员上限则按钮不可用) 2. 在弹窗的文本框中输入邮箱地址 3. 支持批量添加:多个邮箱用分号、逗号或换行分隔,例如:`user1@example.com; user2@example.com` 4. 点击「添加」完成 **管理成员** 每个成员右侧有「更多」菜单: - **设为禁用**:禁用后该成员无法登录,名称会显示删除线 - **设为启用**:将已禁用的成员恢复为可用状态 - **重置密码**:系统会向该成员邮箱发送密码重置邮件,成员通过邮件链接自行设置新密码 #### 分组 分组用于将成员归类,便于后续为宿主机、镜像、模型等资源分配使用权限。 **添加分组** 1. 点击「添加分组」 2. 输入分组名称 3. 点击「添加」 **管理分组** 每个分组右侧有「更多」菜单: - **修改名称**:修改分组名称 - **调整成员**:打开成员选择框,勾选或取消勾选成员,点击「保存」更新该分组的成员列表 - **删除**:删除该分组(需确认) **查看分组成员** 点击分组下方的「X 个成员」,可弹窗查看该分组下的成员列表。 --- ### 开发环境(宿主机) 管理团队接入的宿主机,宿主机用于创建开发环境(虚拟机)。 **绑定宿主机** 1. 点击「绑定宿主机」 2. 弹窗会显示一段安装命令 3. 以 root 权限登录你的 Linux 服务器,复制并执行该命令 4. 执行成功后,刷新页面,宿主机会出现在列表中 **查看宿主机列表** 每个宿主机卡片显示: - 备注或名称、IP - 状态(在线/离线等) - 核数、内存、架构 - 开发环境数量及正在使用的数量 - 所属分组 - 当前正在使用的开发环境及占用者 **修改宿主机** 1. 点击宿主机右侧「更多」→「修改」 2. 可修改: - **备注**:便于识别的名称 - **可使用该宿主机的分组**:勾选哪些分组的成员可以使用该宿主机创建开发环境 3. 点击「保存」 **移除宿主机** 点击「更多」→「移除」,确认后该宿主机将从团队中移除。 --- ### 系统镜像(管理后台) 管理团队可用的 Docker 系统镜像,用于构建开发环境(与侧栏菜单名称「系统镜像」一致)。 **绑定镜像** 1. 点击「绑定」按钮 2. 填写: - **镜像名称**:Docker 镜像地址,例如 `docker.io/library/ubuntu:24.04` - **备注**:可选,便于识别 - **可使用该配置的分组**:勾选哪些分组的成员可以使用该镜像 3. 点击「保存」 **查看镜像列表** 每个镜像显示名称、备注、完整镜像地址、所属分组。 **修改镜像** 1. 点击镜像右侧「更多」→「修改」 2. 可修改备注和可使用该镜像的分组 3. 点击「保存」 **移除镜像** 点击「更多」→「移除」,确认后该镜像将从团队中移除。 --- ### AI 大模型 管理团队可用的 AI 模型,供成员在任务中使用。 **添加模型** 1. 点击「添加模型」或卡片上的添加按钮 2. 填写: - **API Token**:模型服务的 API 密钥 - **模型 API 地址**:默认百智云地址,可改为自建或第三方地址 - **接口类型**:根据模型选择(如 OpenAI Chat、Anthropic 等) 3. 点击「获取模型列表」拉取该地址下的可用模型 4. 选择要添加的模型 5. **可使用该配置的分组**:勾选哪些分组的成员可以使用该模型 6. 点击「保存」,系统会先检查连接,通过后完成添加 **查看模型列表** 每个模型显示名称、接口类型、健康状态、所属分组。 **管理模型** 每个模型右侧有「更多」菜单: - **检查**:测试模型连接是否正常,弹窗显示检查结果 - **修改**:修改 API 配置、分组等 - **移除**:从团队中移除该模型(需确认) --- ### 操作记录 查看团队内的操作日志,便于审计和排查问题。 **查看记录列表** 表格展示每条记录的时间、用户、操作类型、来源 IP。 **操作** - **每页显示**:可选择每页 10、20、50、100 条 - **翻页**:使用底部的「首页」「上一页」「下一页」按钮 - **查看请求**:点击某条记录的「查看请求」,弹窗显示该次操作的请求内容(JSON 格式) - **查看响应**:点击「查看响应」,弹窗显示该次操作的响应内容 --- ### 管理员 管理拥有企业管理后台权限的管理员账号。 **查看管理员列表** 展示所有管理员,每人显示头像、姓名、邮箱、加入时间、最后使用时间。 **添加管理员** 1. 点击「添加管理员」 2. 输入邮箱地址和姓名 3. 点击「添加」 4. 系统会向该邮箱发送邀请,对方按邮件指引完成注册后即可登录管理后台 **重置密码** 点击某管理员右侧「更多」→「重置密码」,确认后系统会向该管理员邮箱发送密码重置邮件。 --- ## 十六、常见问题 **Q:如何创建项目?** A:在左侧「开发项目」区域点击「+」按钮,输入项目名称,选择已绑定的 Git 身份,从该身份下授权的仓库列表中选择要关联的仓库后提交即可。若尚未绑定 Git 账号,需先在配置中完成绑定,详见「七、开发项目」→「如何创建项目」。 **Q:如何绑定 GitHub?** A:进入「配置」→「Git 平台身份凭证」→ 点击「绑定 GitHub」,按页面提示完成 GitHub App 安装即可。 **Q:任务执行失败怎么办?** A:可在任务详情页刷新页面重试,或回到新任务页(`/console/tasks`)重新创建任务。系统会重新创建开发环境。 **Q:如何接入自己的电脑作为开发环境?** A:进入「配置」→「宿主机」→ 点击「获取安装命令」,将命令复制到本地终端执行。执行成功后,你的电脑会出现在宿主机列表中。 **Q:子账号和主账号有什么区别?** A:子账号在创建任务时可以选择宿主机和系统镜像;主账号会使用团队或系统默认配置。 --- 如有更多问题,可在个人控制台顶栏点击 **帮助** 打开官方文档站点;顶栏 **技术交流群** 内提供微信、飞书、钉钉群二维码。企业管理后台顶栏同样有 **帮助** 入口。