写代码是面向开发者的任务类型。你可以描述功能需求,麦芽AI 会分析参考代码库的结构和风格,然后编写符合项目规范的功能代码,并自动完成代码提交。
一、功能说明
写代码功能让 AI 根据功能需求编写实际的代码文件,AI 会分析现有代码库的结构和编码风格,生成符合项目规范的功能代码。
能做什么:
- 开发新功能模块(后端接口、前端页面、数据处理等)
- 分析和参考现有代码库的结构和风格
- 编写单元测试代码
- 修复 Bug 和代码重构
- 自动提交代码到 Git 仓库
二、创建步骤
(一)进入需求创建页面
点击“新建任务”,进入工作台,选择编程领域
(二)输入需求
提示词输入示例🌟 示例一:开发后端接口
"帮我开发一个用户登录接口。需要支持用户名+密码登录和手机号+验证码登录两种方式。登录成功后返回 JWT Token,登录失败时返回具体错误信息。"
(三)参考附件上传
参考文档的具体功能点介绍的(三)添加参考附件片段——写文档的具体功能点介绍
三、代码自动生成
麦芽AI收到需求后,将立即启动需求分析,逐步生成需求的代码,同时在页面进行显示
四、代码展示面板
(一)模式切换
顶部工具栏提供三种模式切换,满足不同开发阶段的需求:
- 代码:查看和编辑代码文件(默认模式)。可直接编辑文件,使用 Ctrl+S 或 Command+S 保存。
- 预览:预览项目运行效果,所见即所得。
- Bug修复:管理 Bug 修复任务。
🌟 提示:代码模式下可手动编辑文件。但轮询和 Diff 模式下文件变为只读,不支持编辑。切换模式时请留意当前状态。
(二)资源管理器(文件树)
右侧面板的左侧边栏提供文件管理和版本控制功能:
- 资源管理器:以树形结构展示工程项目的文件目录,可展开、折叠各级节点。
- 添加工程:添加新的工程项目到当前工作区。
- 绑定 Git:将本地工程绑定到 Git 仓库。
- 变更记录:查看 Git 提交历史。
- 提交 Git:提交代码变更到 Git 仓库。
- 拉取代码:从远程仓库拉取最新代码。
(三)工程文件树
文件树以多工程并列方式展示所有项目文件:
- 工程节点:每个工程节点显示当前分支名,可切换分支或添加新分支。
- 文件操作:
- 单击打开文件进行编辑。
- 右键菜单可复制文件名、删除文件。
- 支持查看文件变更(Diff 模式)。
- 文件标记:新增的文件显示绿色标记,修改的文件显示橙色标记,一眼即可看出哪些文件是 AI 新生成或修改过的。
- 移除工程:支持从工作区移除不需要的工程。(需要会话中有多个工程)
(四)变更记录面板
变更记录面板展示 Git 提交历史,方便追溯每一次代码变更:
- 提交记录列表:显示 Git commit 记录,支持无限滚动加载更多历史。
- 变更详情:每条记录展开后显示变更文件列表,包含文件夹路径和文件名。
- Diff 对比:点击文件可查看变更前后的代码差异对比。
- 回滚操作:支持 Revert 操作,可将某次提交的变更回滚。
- 加载和回滚操作时有 Loading 遮罩,防止重复操作。
(五)Git 提交
Git 提交面板让你将代码变更推送到远程仓库:
- 提交信息:输入提交说明,最多 500 个字符。
- "提交并推送"按钮:一键提交并推送到远程仓库。
(六)代码编辑器
代码编辑器是右侧面板的核心,基于 Monaco 编辑器构建,提供专业级的代码编辑体验:
标签页管理 多个文件以标签页形式打开,可在标签之间自由切换。 标签页右键菜单提供:关闭其他、关闭左侧、关闭右侧、关闭全部。
文件路径栏 显示当前文件的完整路径,支持一键复制路径。
Monaco 编辑器
- 语法高亮:根据文件类型自动适配(支持常见编程语言)。
- 行号显示和代码折叠。
- 手动编辑:非只读和轮询状态下可直接编辑代码。
- 保存文件:Ctrl+S 或 Command+S 保存修改。
Markdown 文件 支持预览和编辑模式切换,方便查看文档的渲染效果。
Diff 模式 查看代码变更对比,以只读模式显示变更前后的差异。
骨架屏动画 文件加载时显示骨架屏动画,提升等待体验。
(七)预览模式
切换到预览模式后,右侧面板显示项目的运行效果:
- 根据当前分支预览项目运行效果。
- 自动跟随系统的暗色或亮色主题。
- 只读模式下不可交互,仅用于查看效果。
(八)Bug 修复模式
切换到 Bug 修复模式后,显示 Bug 修复对话框:
- 列出项目关联的 Bug 列表。
- 点击确认可将 Bug 描述自动填入左侧 AI 助手的输入框。
- 方便快速发起 Bug 修复需求,不需要手动复制 Bug 信息。
🌟 提示:发现 Bug 时,直接在此模式下选择 Bug,AI 就能自动获取 Bug 描述并开始修复流程,省去手动输入的步骤。
(九)添加工程面板
点击侧边栏的"+"按钮打开工程选择面板:
- 搜索:按工程名称或别名搜索目标工程。
- 工程详情:显示工程的 VCS 类型、开发语言、Git 路径等信息。
- 分支选择:列出可用分支,点击即可添加到当前工作区。
- 跳转到 Git:支持"去 Git 上添加分支",方便在线管理分支。
五、页面级功能
以下是代码开发模块页面级别的通用功能,不受左右面板划分影响。
(一)拖拽调整布局
页面中间的垂直分隔条支持拖拽,可调整左侧面板(AI 助手)和右侧面板(代码展示)的宽度。
宽度范围限制为 410px 到 800px。调整后的宽度自动保存到浏览器本地存储,下次打开页面时自动恢复。
(二)会话快照
系统自动为当前会话生成缩略图快照(使用 html2canvas 截取代码区域),用于会话列表的卡片展示,方便你在工作台中快速识别不同会话。
(三)轮询状态管理
当 AI 正在执行需求时,右侧代码面板进入轮询状态:
- 文件编辑变为只读,防止手动编辑与 AI 生成冲突。
- Git 提交和拉取操作被禁用。
- 轮询完成后自动刷新工程树、已打开文件内容和文件标记。
这确保了 AI 执行过程中代码的一致性,避免并发操作导致的问题。
(四)文件标记清除
AI 执行完成后,系统自动标记新增文件(绿色)和修改文件(橙色)。
当你确认所有变更无误后,可使用"清除所有标记"功能一键清除这些颜色标记,让文件树恢复默认状态。
(五)路由离开保护
离开页面时,系统会检测输入框是否有未发送的内容。如果有,会弹出确认提示,防止你不小心关闭页面导致已输入的需求丢失。