36 KiB
MonkeyCode AI 前端使用文档
本文档基于当前 frontend 源码整理,描述的是现在前端已经实现的页面、入口和交互。
如果文档与页面行为不一致,优先以以下源码为准:
- 路由入口:
frontend/src/App.tsx - 页面组件:
frontend/src/pages/** - 关键交互组件:
frontend/src/components/**
一、产品与页面入口
1. 当前前端覆盖的能力
当前前端已经覆盖以下能力:
- 官网首页与公开介绍页
- 普通用户登录与控制台
- 智能任务创建、执行、追问、上下文管理、文件查看和在线预览
- 项目协作、需求管理和自动 Review
- Git 审查机器人
- 独立开发环境、终端、文件管理、端口管理和远程协助
- 开发者广场内容浏览与发布
- 企业管理后台
2. 主要路由
- 首页:
/ - 登录页:
/login - 找回密码:
/findpassword - 重置密码:
/resetpassword?token=... - 开发者广场:
/playground - 发布广场内容:
/playground/create - 广场详情:
/playground/detail?id=... - 隐私政策:
/privacy-policy - 用户协议:
/user-agreement - 产品介绍 PPT:
/ppt/或/ppt/index.html - 公开任务跳转入口:
/tasks/public?id=... - 普通用户控制台:
/console - 新任务页:
/console/tasks - 任务详情页:
/console/task/:taskId - 项目页:
/console/project/:projectId - Git 机器人:
/console/gitbot - IDE 辅助工具:
/console/ide - 独立终端页:
/console/terminal?envid=... - 独立文件管理页:
/console/files?envid=...&path=... - 远程协助页:
/sharedterminal?id=... - 企业管理后台:
/manager
3. 首页导航
首页顶部导航当前包含:
介绍广场文档/使用文档开源/ GitHub 入口- 已登录时显示
控制台/进入控制台 - 未登录时显示
注册、立即开始
说明:
文档/使用文档当前跳转到外部文档站:https://monkeycode.docs.baizhi.cloud/开源/ GitHub 当前跳转:https://github.com/chaitin/MonkeyCode- 访问首页时如果 URL 带
?ic=...,前端会把邀请码写入localStorage,注册登录入口会携带该邀请 ID - 移动端导航收纳在抽屉菜单中
4. 首页内容
首页当前使用 TerminalNativePage,主要区块包括:
- Hero:
MonkeyCode在线 AI 开发平台介绍 - 功能与特色:免费即用、云端开发环境、主流模型、移动端支持、开源、私有化离线部署
- 使用场景:小游戏、需求开发、安全审查、毕业论文、数据分析、技术调研等
- 和其他 Coding 工具的能力对比
- 用户真实评价
- 套餐与费用
- 免费赚积分与充值积分
- 开源版与团队版入口
- FAQ
- 底部开始使用和 GitHub 入口
5. 套餐与积分入口
首页展示的套餐包括:
基础版:免费,1 个并发任务,云开发环境 1C / 4GB,注册赠送 5000 积分专业版:10,000 积分 / 月,3 个并发任务,云开发环境 2C / 8GB,每日赠送 2,000 积分旗舰版:100,000 积分 / 月,3 个并发任务,云开发环境 2C / 8GB,每日赠送 30,000 积分
首页还展示:
- 注册即送 5000 积分
- 每邀请 1 位新用户奖励 5000 积分
- 每日签到可持续获得积分
- 分享使用故事可获得活动积分
- 充值档位:¥50 / 1 万积分、¥200 / 5 万积分、¥1000 / 30 万积分
6. 客户端下载
代码中仍保留了 downloads 组件,支持展示:
- Windows
- macOS
- Android
- iOS
下载统一跳转:
https://github.com/chaitin/MonkeyCode/releases
但当前首页实际渲染的是新版 TerminalNativePage,不再直接展示旧版客户端下载区块。
7. 页脚与法律页面
公开页面页脚包含:
- 产品文档
- 技术论坛
- 开源仓库
- 模型广场
- 长亭科技
- 长亭百智云
- 隐私政策
- 用户协议
- ICP 备案链接
- 微信群、飞书群、钉钉群二维码
法律页面包括:
/privacy-policy:隐私政策,最后更新时间为2026-03-24/user-agreement:用户协议,最后更新时间为2026-03-24
法律页面顶部导航会切换为 隐私政策 和 用户协议 两个入口。
8. 产品介绍 PPT
frontend/public/ppt/index.html 是一个基于 Reveal.js 的静态产品介绍 PPT。
部署后可通过以下路径访问:
/ppt//ppt/index.html
内容主题包括:
- MonkeyCode AI 产品定位
- 需求、设计、编码、审查闭环
- 智能任务、项目协作和自动 Review
- 多模型、自定义镜像、自有宿主机和消息通知
- 企业管理后台、开发者广场和开源社区
说明:
- 该 PPT 使用 CDN 加载 Reveal.js、主题样式和字体
- 这是静态介绍页,不经过 React 路由
- 当前文件不是
.pptx,而是 HTML 演示文稿
二、登录与账号
1. 登录页
登录页路径:
/login
页面包含两个标签:
普通用户团队管理员
登录页底部要求勾选并同意:
用户协议
如果未勾选协议,普通用户 OAuth 登录、快速注册、账号密码登录和团队管理员登录都会被阻止。
2. 普通用户登录
普通用户标签默认先展示登录方式选择:
百智云登录 - 推荐账号密码登录快速注册
说明:
百智云登录 - 推荐和快速注册都跳转到后端登录入口/api/v1/users/login?redirect=&inviter_id=...- 如果首页或注册入口保存过邀请码,登录入口会携带
inviter_id 账号密码登录会切换到邮箱 / 密码表单
账号密码登录支持:
- 输入邮箱和密码
- 密码明文 / 隐藏切换
- 登录前验证码校验
- 本地记住上次输入的邮箱和密码
找回密码
普通用户登录成功后进入:
/console/
3. 团队管理员登录
团队管理员登录表单支持:
- 输入邮箱和密码
- 密码明文 / 隐藏切换
- 登录前验证码校验
- 本地记住上次输入的邮箱和密码
团队管理员登录成功后进入:
/manager/
团队管理员标签下当前没有单独的 找回密码 入口。
4. 找回密码
找回密码页路径:
/findpassword
操作流程:
- 输入邮箱
- 完成验证码校验
- 提交后发送重置密码邮件
5. 重置密码
重置密码页路径:
/resetpassword?token=...
页面会先根据 token 读取账号信息,再要求输入:
- 新密码
- 确认密码
前端校验:
- 两次密码必须一致
- 密码长度至少 6 位
重置成功后会提示用户,并返回首页。
三、普通用户控制台
1. 默认入口
登录后访问 /console 会自动跳转到:
/console/tasks
控制台布局当前为:
- 左侧侧边栏
- 顶部面包屑与操作区
- 主内容区
顶部区域包含:
- 面包屑
- 免费模型用量提示
获取积分刷新
2. 免费模型用量提示
顶部免费模型提示会展示平台共享免费模型池的当日用量。
当前实现:
- 每天早上 10 点送出 500 亿 token 免费额度
- 所有用户共享使用
- 选择带有
免费标记的模型即可使用免费额度 - 当日免费额度耗尽后,模型调用按正常模型价格扣除积分
- 前端每 30 秒请求一次
/api/v1/users/free-model-pool/usage
3. 获取积分
顶部 获取积分 会打开弹窗,当前列出:
- 邀请注册:
+5,000 积分 / 人 - 征文投稿:
1 万 - 10 万积分 - 充值积分:立即到账
- 每日签到:
+100 积分 / 天 - 社区活动:不定期奖励
其中:
去邀请好友和去充值会打开钱包的我的积分加入社区交流群会打开技术交流群弹窗- 征文投稿会跳转到外部活动规则文档
4. 左侧侧边栏
侧边栏包含:
- 顶部 MonkeyCode 标识
- 未归属任务和项目列表
签到领积分技术交流群配置- 当前用户与积分入口
任务与项目区域支持:
- 查看未归属任务
- 点击
启动任务打开快速任务创建弹窗 - 展开 / 折叠
历史任务 - 点击
查看更多进入/console/tasks - 查看项目列表
- 点击项目进入项目页
- 对项目点击
+直接启动项目任务 - 点击
添加项目创建项目 - 每 30 秒刷新项目、未归属任务和历史任务
任务条目支持:
- 进入任务详情
- 修改任务名称
- 对等待中 / 运行中的任务执行
终止任务 - 删除任务
折叠侧边栏时:
- 显示
空项目 - 显示
项目列表或创建项目
5. 创建项目
创建项目当前不是自由输入仓库地址,而是:
- 输入项目名称
- 从已绑定 Git 身份中选择身份
- 从该身份可访问的授权仓库列表里选择仓库
如果尚未绑定 Git 身份,弹窗会提示先去 配置 里完成绑定。
6. 技术交流群
侧边栏 技术交流群 和顶部 获取积分 弹窗都可以打开社群入口。
当前展示:
- 微信群二维码
- 飞书群二维码
- 钉钉群二维码
7. 签到
如果当天尚未签到,侧边栏会显示 签到领积分。
当前实现:
- 点击后先进行验证码校验
- 签到成功获得 100 积分
- 成功后刷新钱包余额和签到状态
- 如果当天已签到,侧边栏签到入口不显示
四、钱包、套餐与积分
1. 钱包入口
侧边栏底部用户入口同时展示:
- 用户头像和昵称
- 当前套餐简称
- 当前可用积分总数
当前可用积分 = 长期积分 + 今日积分。
点开后,钱包弹窗包含 5 个分区:
我的账户我的套餐我的积分积分记录模型定价
2. 我的账户
我的账户 主要展示:
- 用户头像、昵称、邮箱
- 当前套餐
- 可用积分
- 所属团队或个人空间
账号操作包括:
- 修改头像
- 修改昵称
- 绑定邮箱
- 修改密码 / 设置密码
- 登出
补充说明:
- 头像必须是图片文件
- 已有密码的账号修改密码时需要输入当前密码
- 设置 / 修改用户密码时,前端要求新密码至少 8 位
- 绑定邮箱会发送绑定邮件
3. 我的套餐
套餐页当前展示:
基础版专业版旗舰版
基础版:
- 免费
- 并发任务限制:1 个任务
- 每日积分:无
专业版:
- 价格:10,000 积分 / 月
- 并发任务限制:3 个任务
- 每日赠送 2,000 积分
- 每日积分仅当日有效,不累计
旗舰版:
- 价格:100,000 积分 / 月
- 并发任务限制:3 个任务
- 每日赠送 30,000 积分
- 每日积分仅当日有效,不累计
套餐操作:
- 非团队用户且已开通高级套餐时,顶部显示到期时间和自动续费开关
- 可直接开通专业版或旗舰版
- 开通前会弹出确认框
- 开通成功后刷新钱包、套餐状态和交易记录
- 如果当前是旗舰版,不再显示专业版开通按钮
4. 我的积分
我的积分 当前包含:
- 当前可用积分
- 邀请注册
- 社区活动
- 每日签到
- 兑换积分
当前可用积分拆分为:
长期积分今日积分(凌晨自动清零)
充值:
- 点击
充值打开充值弹窗 - 选择充值档位后点击
确认充值 - 前端向后端请求支付链接
- 请求成功后在新标签页打开支付页面
固定充值档位:
10,000 积分,价格¥5050,000 积分,价格¥200,原价¥250,页面标记为8 折300,000 积分,价格¥1000,原价¥1500,页面标记为6.7 折
邀请注册:
- 系统生成个人邀请链接:
https://monkeycode-ai.com/?ic=当前用户ID - 点击
复制邀请链接会复制完整链接 - 好友通过该链接注册后,邀请人获得
5000 积分 - 支持展开查看最近邀请用户列表
- 首次请求前 20 条邀请记录
每日签到:
- 每天可签到 1 次
- 每次获得 100 积分
- 钱包内也可发起签到
兑换积分:
- 输入兑换码后点击
兑换 - 按回车也会触发兑换
- 兑换成功后刷新钱包余额
5. 积分记录
积分记录 用于查看积分流水。
当前实现:
- 单次请求 20 条记录
- 支持滚动加载更多
- 正向记录显示为
+积分 - 消耗记录显示为
-积分
常见记录类型包括:
新用户注册奖励通过兑换码领取邀请注册奖励每日签到奖励套餐升级退款当日钱包发放充值积分开发环境消耗大模型消耗MCP 工具消耗兑换专业版专业版自动续费兑换旗舰版旗舰版自动续费
6. 模型定价
模型定价 页面用于展示不同模型与积分消耗之间的关系。
当前展示字段:
- 模型名称
- 每百万 token 消耗积分
- 代码能力分
- 标签
支持排序:
- 性价比排序
- 代码能力排序
- 按名字排序
当前内置模型价格表来自 frontend/src/utils/common.tsx 的 modelPricingList:
minimax-m2.7:200 积分,标签免费qwen3.5-plus:120 积分,标签免费gpt-5.5:1000 积分,标签最新、很强gpt-5.4:600 积分,标签能力强gpt-5.2:400 积分gpt-5.3-codex:400 积分,标签能力强、性价比glm-5.1:600 积分glm-5:400 积分glm-4.7:200 积分,标签性价比kimi-k2.6:700 积分,标签新、能力强qwen3-max:400 积分qwen3.6-plus:200 积分,标签性价比kimi-k2.5:400 积分
说明:
- 标记为
免费的模型会优先使用平台共享免费模型池 - 当共享免费额度耗尽后,会按模型正常价格扣除积分
五、智能任务
1. 新任务页
新任务页路径:
/console/tasks
页面由两部分组成:
- 上方任务输入区
- 下方任务卡片列表
页面标题:
MonkeyCode 智能任务
2. 创建任务
任务输入
主输入框支持:
- 输入自然语言需求
- 语音输入
当前输入框没有在代码里单独处理 Enter 提交,主要通过点击 执行 创建任务。
任务类型
当前有三种类型:
开发设计审查
说明:
开发:根据需求执行开发编码任务设计:进行架构设计,输出技术方案与设计文档审查:审查代码,识别风险,提出改进建议
代码来源
代码 菜单当前支持三种来源:
ZIP 文件我的仓库其他仓库
ZIP 文件:
- 仅接受
.zip - 文件大小上限 10MB
- 先上传到对象存储,再作为本次任务代码来源
我的仓库:
- 按已绑定 Git 身份分组展示
- 支持 GitHub App、Gitee、Gitea、GitLab OAuth 身份
- 支持在每个身份下搜索仓库
- 支持刷新单个身份下的授权仓库列表
- 选中仓库后自动关联对应 Git 身份凭证
- 如果没有可选 Git 身份,会提示去设置绑定
其他仓库:
- 手动输入完整仓库地址
- 按回车确认
- 下方展示从任务列表中归纳出的历史仓库地址
- 如果手动输入的仓库地址匹配已绑定身份的
base_url,参数确认时可选择对应身份;否则可匿名
技能
技能 按钮会打开技能选择面板。
当前实现:
- 从后端拉取技能列表
- 按标签分类展示
- 支持多选
- 部分默认技能不可取消
- 按钮上显示已选技能数量
执行前参数确认
点击 执行 后会打开 任务参数 弹窗。
当前弹窗字段包括:
- 大模型
- 仓库分支
- 仓库身份凭证
仅子账号额外显示:
- 宿主机
- 系统镜像
补充说明:
- 从
我的仓库里选中的仓库,不再重复要求选择身份凭证 - 使用 ZIP 代码源时,不显示仓库分支和仓库身份凭证
- 当前创建的任务固定使用
OpenCode - 如果选择了平台内置模型,会强制使用平台内置宿主机
- 任务创建时固定资源为 2 核 CPU、8GB 内存、3 小时生命周期
- 上一次选择的大模型、宿主机、镜像会写入本地参数缓存,后续创建任务时复用
- 大模型字段旁边的帮助按钮可打开
模型定价
并发限制
如果后端返回并发限制错误,会弹出并发限制提示框。
弹窗会:
- 列出当前正在运行或等待中的任务
- 允许直接终止这些任务
- 对基础版用户提供升级专业版或旗舰版入口
3. 快速启动任务弹窗
侧边栏 启动任务 会打开快速任务创建弹窗。
它和新任务页的任务输入能力基本一致,但把模型、宿主机、镜像、分支等参数收纳到 高级选项 区域。
弹窗关闭后会重置输入内容、代码来源、技能选择和高级选项。
4. 任务列表
任务列表以卡片方式展示,当前每页加载 24 条,支持无限滚动。
卡片信息包括:
- 任务名称
- 仓库名或 ZIP 文件名
- 任务状态
- Token 用量
- 创建时间
当前任务状态展示:
finished:显示已终止error:显示启动失败pending:显示正在启动processing:显示运行中
卡片支持:
- 点击标题进入任务详情
- 右上角菜单修改任务名称
- 对等待中 / 运行中的任务执行
终止 - 对所有任务执行
删除 - 悬浮查看任务名称、任务内容、任务状态、任务类型、代码仓库、代码文件、仓库分支、开发工具、大模型、创建时间等详细信息
六、任务详情页
1. 路径
/console/task/:taskId
2. 页面结构
当前任务详情页主要由以下区域组成:
- 顶部状态与工具栏
- 中央消息区
- 右侧文件面板
- 底部终端面板
- 在线预览弹窗
顶部按钮当前包括:
终端文件预览
说明:
文件按钮会显示当前已变更文件数量预览按钮会显示当前发现的可预览端口数量- 当任务不处于运行中时,这三个按钮会禁用
3. 顶部模型与上下文
顶部左侧展示当前任务模型,并支持在任务可输入时切换模型。
切换模型流程:
- 点击当前模型下拉菜单
- 选择目标模型
- 弹出确认框
- 确认后通过任务控制连接切换模型
顶部还会展示:
- 累计消耗 token
- 上下文使用进度
当上下文使用信息可用时,点击圆形进度可打开上下文弹窗。
上下文弹窗支持:
压缩上下文:向当前任务发送/compact重置上下文:确认后重启会话并清空当前上下文
4. 环境准备状态
如果任务对应开发环境尚未就绪,主区域会显示准备视图。
当前会展示:
- 开发环境状态说明
- 最近一次环境条件消息
这部分不仅覆盖正在创建,也覆盖部分环境失败状态。
5. 消息区
消息区用于展示任务完整对话和工具执行信息。
支持:
- 自动附着运行中任务的实时消息流
- 加载历史轮次消息
- 通过
加载历史消息/加载更多逐轮加载历史 - 自动滚动到底部
- 一键滚动到顶部 / 底部
- 显示计划步骤块
- 对消息错误展示悬浮错误详情
- 对失败消息提供
尝试修复,会重新加载会话并发送继续执行指令
如果任务已经结束、且当前没有实时流消息,页面会自动加载历史轮次。
6. 与 AI 对话
任务运行中且当前流未执行时,底部显示输入框。
输入区支持:
Enter发送Shift + Enter换行- 语音输入
- 斜杠命令插入
斜杠命令来自实时连接返回的 availableCommands。
执行中时:
- 文本输入框会隐藏
- 页面显示当前耗时
- 发送按钮切换为停止按钮,可发送取消命令
当任务不再处于运行中时,底部显示:
任务已结束
7. AI 反向提问
任务消息流里支持 ask_user_question 类型消息。
当前实现支持:
- 单选题
- 多选题
- 自定义补充答案
- 直接在消息卡片中提交回答
如果问题来自历史消息,或实时连接已经关闭,问题会被标记为过期,无法再提交回答。
8. 文件面板
点击顶部 文件 后,会在右侧展开文件面板。
文件面板包含两个模式:
目录变更
目录模式
支持:
- 浏览任务工作区文件树
- 展开 / 折叠目录
- 打开文本文件只读预览
- 刷新文件树
- 在当前目录创建文件
- 创建目录
- 上传文件
- 复制文件
- 移动文件 / 目录
- 下载文件 / 目录
- 删除文件 / 目录
补充说明:
- 文件预览为只读
- 超过 100KB 的文件不支持预览
- 二进制文件不支持预览
变更模式
支持:
- 查看全部已变更文件列表
- 显示新增 / 删除行数
- 点击单个文件查看 Diff
- Diff 以分栏形式展示
9. 终端面板
点击顶部 终端 后,会在页面下方展开终端区。
终端区支持:
- 查看当前任务绑定开发环境的终端会话列表
- 新建终端会话
- 切换终端会话
- 刷新会话列表
- 关闭终端会话
- 查看连接状态图标
10. 在线预览
点击顶部 预览 会打开在线预览弹窗。
弹窗支持:
- 列出已发现的监听端口
- 刷新端口列表
- 当端口已有可访问地址时直接访问
- 当端口不可访问时显示错误或暂不可访问状态
说明:
- 任务详情页里的预览主要负责展示和访问
- 端口的开放、关闭和白名单编辑在独立终端页的
在线预览 / 端口管理中完成
七、Git 机器人 / 代码审查
1. 路径
/console/gitbot
当前这个页面没有固定侧边栏入口,需要直接访问地址。
2. 页面页签
页面包含两个标签:
审查任务机器人
3. 审查任务
审查任务 页支持:
- 查看机器人触发的审查任务列表
- 每页 24 条并支持无限滚动
- 显示任务状态
- 显示关联平台机器人
- 点击标题跳转到对应 PR / MR 页面
- 手动刷新列表
空状态下提供:
刷新如何使用?
4. 机器人
机器人 页支持:
- 创建审查机器人
- 查看 Webhook 信息
- 修改机器人
- 修改查看权限
- 删除机器人
创建机器人时需要填写:
- 备注
- 宿主机
- Git 平台
- Access Token
创建成功后,页面会自动弹出 Webhook 信息,包括:
- Webhook 地址
- Secret Token
5. 查看权限
机器人 权限 弹窗支持:
- 选择团队成员
- 保存后,这些成员可以看到该机器人执行过的任务
八、项目协作
1. 路径
/console/project/:projectId
如果项目数据异常、没有绑定仓库,当前会直接显示 项目异常 空状态。
2. 项目头部
项目头部展示:
- 项目名称
- 项目描述或
未绑定仓库 - 自动 Review 状态
启动 AI- 更多菜单
更多菜单包括:
- 修改名称
- 环境变量
- 开发镜像
- 移除项目
3. 自动 Review
点击 未开启自动 Review / 已开启自动 Review 会打开配置弹窗。
当前弹窗能力:
- 查看项目名称
- 切换自动 Review 开关
开启后,前端说明为:
- 自动配置仓库 Webhook
- 当提交新的 PR / MR 时自动启动 Review 任务
4. 启动 AI
项目页的 启动 AI 会打开项目专用任务弹窗。
当前可配置:
- 项目
- 代码仓库分支
- 大模型
- 任务内容
补充说明:
- 如果项目平台是 internal,不显示代码仓库分支
- 对普通 Git 平台会优先拉取分支列表
- 如果分支列表获取失败,可手动输入分支
- 提交后创建与当前项目关联的开发任务
- 项目任务生命周期为 2 小时
5. 项目页页签
当前项目页固定有三个页签:
信息需求任务
信息
信息 页签包含:
- 项目文件浏览器
- 项目根目录
README.md自动加载与渲染
项目文件浏览器支持:
- 浏览项目仓库文件树
- 按分支切换查看
- 打开文件只读预览
- 跳转访问原仓库
补充说明:
- 这里是仓库浏览器,不是开发环境里的可写文件管理器
- README 会优先选择
main,其次master,否则使用排序后的第一个分支 - 如果仓库根目录没有
README.md,页面会显示暂无文档
需求
需求 页签支持:
- 按状态筛选
- 按优先级筛选
- 创建需求
- 查看需求详情
状态筛选包括:
- 全部状态
- 未完成
- 已完成
- 已关闭
优先级筛选包括:
- 全部优先级
- 高
- 中
- 低
创建需求时当前字段为:
- 需求标题
- 原始需求说明(Markdown)
需求详情弹窗支持:
- 直接点击标题编辑标题
- 查看 / 编辑原始需求文档
- 查看 / 编辑技术方案文档
- 修改状态
- 修改优先级
- 查看创建者
- 查看创建时间
更多操作支持:
- 启动设计任务
- 启动开发任务
- 删除需求
设计任务会根据需求文档自动生成设计方案。
启动设计任务 / 开发任务时需要选择:
- 工作分支,内部项目除外
- AI 大模型
确认后会创建 2 小时生命周期的任务,并跳转到任务详情页。
开发任务会根据需求文档和设计文档自动生成开发任务。
任务
任务 页签展示当前项目下的任务卡片列表。
支持:
- 查看任务详情
- 无限滚动加载
- 修改任务名称
- 删除任务
当前项目任务页签没有单独的终止任务操作。
九、配置
配置通过普通用户控制台左侧侧边栏底部 配置 打开。
当前配置弹窗固定有 7 个分区:
Git 身份MCP 与工具AI 大模型系统镜像宿主机开发环境通知
1. Git 身份
当前支持的绑定方式包括:
- GitHub App 安装绑定
- Gitee OAuth 绑定
- Gitea OAuth 绑定
- GitLab OAuth 绑定
- 手动录入 GitHub / GitLab / Gitea / Gitee 身份
已绑定身份支持:
- 查看平台与地址
- 修改
- 移除
未绑定时,页面会展示对应平台的绑定卡片。
手动录入身份需要填写:
- Git 平台类型
- Git 平台地址
- Access Token
- Username
- 备注(可选)
GitHub App 安装完成后,配置弹窗会显示安装成功或失败提示,并刷新身份列表。
2. MCP 与工具
MCP 与工具 用于管理 MCP 服务器及其提供的工具能力。
当前支持:
- 查看 MCP 服务列表
- 查看内置平台 MCP 服务
- 添加用户 MCP 服务器
- 修改用户 MCP 服务器
- 同步用户 MCP 服务器
- 删除用户 MCP 服务器
- 查看服务下工具列表
- 启用 / 禁用工具
- 查看工具说明
- 查看工具调用价格,单位为
积分/次
添加 / 修改 MCP 服务器时需要:
- 名称
- MCP 服务器地址
- HTTP Header(JSON 对象,可选)
说明:
- 工具前缀由名称自动转拼音 / slug
- HTTP Header 必须是 JSON 对象
- 平台内置 MCP 服务不可编辑或删除,但工具开关可操作
3. AI 大模型
模型列表支持:
- 查看接口类型
- 查看归属类型
- 修改私有模型
- 移除私有模型
- 添加私有模型
说明:
- 公开模型会展示但不能在这里修改或移除
- 普通用户侧没有独立健康检查按钮和设为默认入口
- 添加 / 修改私有模型时需要选择接口格式、填写模型 API 地址、API Token 和模型名称
- 接口格式支持
OpenAI Responses、OpenAI Chat、Anthropic - 填写 Token 后可拉取模型列表;如果接口未返回模型,也可以手动输入模型名称
- 保存添加 / 修改前会执行一次模型健康检查
4. 系统镜像
镜像列表支持:
- 查看镜像备注和镜像名
- 查看归属类型
- 修改私有镜像
- 移除镜像
- 添加镜像
说明:
- 公开镜像会展示但不能在这里修改
- 普通用户侧当前没有镜像设为默认入口
5. 宿主机
宿主机页面支持:
- 生成并复制安装命令
- 通过命令绑定 Linux 宿主机
- 查看宿主机状态和标签
- 查看宿主机上的开发环境数量
- 修改备注
- 移除私有宿主机
说明:
- 当前普通用户侧仅团队空间支持绑定宿主机
- 普通用户侧当前没有宿主机设为默认入口
6. 开发环境
这里指独立创建和管理的开发环境,不是任务详情页里的临时交互区。
支持:
- 创建开发环境
- 查看在线 / 离线环境
- 打开终端
- 打开文件管理
- 续期
- 移除
- 切换是否显示离线开发环境
创建开发环境时可配置:
- 宿主机
- 开发环境名称
- 仓库地址
- 仓库分支
- 仓库身份凭证
- 系统镜像
- AI 大模型
- CPU
- 内存
- 生命周期
补充说明:
- 当前仅团队空间支持创建开发环境
- 平台内置宿主机当前只允许选择不超过 3 小时的生命周期
- 平台内置宿主机最多 8 核 CPU、32GB 内存
- 其他宿主机的 CPU / 内存选项来自宿主机规格
- 生命周期可选 1 小时、2 小时、3 小时、6 小时、12 小时、1 天、3 天、7 天
- 续期弹窗当前支持追加 1 / 2 / 3 小时
7. 通知
用户级通知当前支持四类接收端:
- 钉钉机器人
- 飞书机器人
- 企业微信机器人
- Webhook
每个接收端支持:
- 名称
- Webhook 地址
- Secret(可选)
- 订阅事件类型
可执行操作:
- 添加
- 编辑
- 测试发送
- 移除
十、独立终端、文件管理与远程协助
1. 独立终端
路径:
/console/terminal?envid=...
这是针对某个开发环境单独打开的终端页。
当前能力包括:
- 查看开发环境名称、状态、操作系统
- 首次进入时选择已有终端连接
- 新建终端连接
- 连接已有终端连接
- 关闭终端连接
- 手动重新连接
- 切换终端配色主题
- 打开独立文件管理
- 打开端口管理 / 在线预览
- 发起远程协助
终端连接选择弹窗中会显示:
- 终端连接 ID
- 创建时间
- 当前连接数
2. 端口管理
独立终端页里的 在线预览 实际打开端口管理弹窗。
当前支持:
- 查看端口列表
- 刷新端口列表
- 开放访问
- 访问已开放端口
- 复制访问地址
- 编辑白名单 IP
- 关闭访问 / 回收端口
补充说明:
- 开放访问时,前端会先尝试获取当前访问者 IP
- 如果获取成功,会把该 IP 写入白名单
- 白名单编辑弹窗要求每行输入一个 IP,且至少填写一个 IP
3. 远程协助
独立终端页支持生成远程协助连接信息。
模式有两种:
只读模式:对方只能看到终端界面,无法输入或操作控制模式:对方可以看到终端界面,且可进行输入和交互
生成后会得到:
- 共享地址
- 连接密码
支持:
- 一键复制整段邀请信息
4. 远程协助页
路径:
/sharedterminal?id=...
访问者进入后需要先输入连接密码,之后才能加入共享终端。
页面支持:
- 查看连接状态
- 查看分享者名称和头像
- 切换终端主题
5. 独立文件管理
路径:
/console/files?envid=...&path=...
这是针对某个开发环境的完整文件管理页。
当前支持:
- 浏览目录
- 面包屑导航
- 返回上级目录
- 刷新文件列表
- 新建文件
- 新建目录
- 上传文件
- 复制文件
- 移动文件 / 目录
- 下载文件 / 目录
- 在线编辑文本文件
- 删除文件
列表展示字段包括:
- 名称
- 大小
- 用户
- 权限属性
- 修改时间
补充说明:
- 超过 1MB 的文件不允许在线编辑
- 当前独立文件管理页里,复制和删除菜单只对文件开放
- 移动和下载支持文件 / 目录
十一、IDE 辅助工具
路径:
/console/ide
当前这个页面仍是占位页,但已经提供两个外链:
- 开源仓库
- 官方文档
页面文案为 敬请期待,不应描述为已完整交付的功能页。
十二、开发者广场
1. 广场列表
路径:
/playground
当前已实现:
- 搜索内容
- 浏览文章 / 任务分享卡片
- 查看封面、标题、摘要
- 查看作者与浏览量
- 登录后发布内容
- 未登录点击
发布会跳到登录页
2. 发布内容
路径:
/playground/create
当前可选发布类型只有两种:
写一篇文章分享你执行过的任务
说明:
- 代码里仍保留了
project类型的旧状态变量,但当前 UI 没有开放项目分享入口 - 如果以
/playground/create?taskid=...打开,页面会自动进入任务分享模式并预选该任务
文章发布
支持:
- 标题
- Markdown 内容
- 图片上传
任务分享
支持:
- 从自己的任务列表中选择任务
- 填写标题
- 填写 Markdown 内容
- 上传图片
补充说明:
- 当前前端要求至少上传 1 张图片才能发布
- 当所选任务仍在运行中,且开发环境在线时,还可以额外选择
产出物文件 - 这些产出物会先被前端打包成 ZIP,再随分享一起上传
- 发布成功后提示
审核后会显示在广场上
3. 广场详情
路径:
/playground/detail?id=...
广场详情页会根据内容类型展示:
- 标题
- 作者
- 发布时间
- 浏览量
- Markdown 正文
- 图片预览
对于任务分享,当前还额外支持:
- 封面上点击播放后,加载并回放任务历史消息
- 下载分享时附带的 ZIP 代码产出物
- 文件树展开 / 折叠
- 打开单个文件查看内容
补充说明:
- 页面右侧
网友评论区域目前只是占位,没有真正评论交互
十三、公开任务
路径:
/tasks/public?id=...
这个页面当前不是独立展示页,而是一个跳转入口:
- 如果带有
id,会直接跳转到/console/task/:taskId - 如果没有
id,会跳回首页
因此不应把它描述成公开任务列表页或独立公开详情页。
十四、企业管理后台
1. 路径与导航
企业管理后台路径:
/manager
默认进入:
/manager/dashboard
左侧菜单当前包含:
- 仪表盘
- 成员管理
- 开发环境
- AI 大模型
- 系统镜像
- 管理员
- 操作记录
- 其他配置
右上角提供:
刷新
左下角管理员用户菜单支持:
- 修改密码
- 登出
2. 仪表盘
当前仍是占位页,显示:
敬请期待
3. 成员管理
成员管理页由两张卡片组成:
团队成员分组
团队成员
支持:
- 查看成员数量与上限
- 批量添加成员
- 添加时一次输入多个邮箱
- 添加成员时支持逗号、换行或分号分隔邮箱,并会校验邮箱格式
- 禁用 / 启用成员
- 为成员发送重置密码邮件
- 查看成员加入时间和最近使用时间
- 查看成员所属分组
分组
支持:
- 新建分组
- 修改分组名称
- 删除分组
- 查看分组成员数量
- 查看分组成员列表
- 调整分组成员
4. 开发环境
团队级开发环境页面管理的是宿主机。
支持:
- 绑定宿主机
- 查看宿主机状态、规格、架构和 IP
- 查看宿主机上的开发环境数量
- 修改宿主机信息
- 删除宿主机
- 查看宿主机所属分组
- 查看宿主机上正在使用的虚拟机
修改宿主机时可配置备注和可使用该宿主机的分组。
5. AI 大模型
团队模型支持:
- 添加
- 修改
- 健康检查
- 删除
- 查看所属分组
添加 / 修改团队模型时可配置接口格式、模型 API 地址、API Token、模型名称和可使用该模型的分组;保存前会执行模型健康检查。
6. 系统镜像
团队镜像支持:
- 添加
- 修改
- 删除
- 查看所属分组
添加 / 修改团队镜像时可配置镜像名、备注和可使用该镜像的分组。
7. 管理员
管理员页支持:
- 查看所有管理员
- 添加管理员
- 为管理员发送密码重置邮件
8. 操作记录
操作记录页支持:
- 查看审计日志表格
- 查看时间、用户、操作、来源 IP
- 查看请求内容
- 查看响应内容
- 游标分页
- 切换每页条数
9. 其他配置
当前 其他配置 里已经实现的是团队级消息通知。
能力与用户侧通知基本一致,支持:
- 钉钉机器人
- 飞书机器人
- 企业微信机器人
- Webhook
- 添加
- 编辑
- 测试
- 删除
- 选择订阅事件