项目环境与版本

AI 编程项目提供面向开发的在线工作区。用户不需要在本地安装开发工具，就可以完成项目创建、运行、调试和发布。

项目工作区

项目工作区通常包含：

• 对话区：输入需求、查看 Agent 思考过程和任务执行结果。
• 文件树：查看项目目录、打开文件、管理资源文件。
• 代码编辑区：查看和编辑项目代码。
• 预览区：查看网页、应用或服务运行效果。
• 终端：执行安装依赖、启动服务、运行脚本等命令。
• 控制台：查看日志、报错和运行输出。
• 发布入口：发布项目并查看发布状态。

对话设置

项目对话输入区底部的齿轮按钮是 对话设置。单击后，可以分别选择协作模式和权限模式；当前选项右侧会显示勾选标记。设置会用于后续发送的项目对话，可根据当前任务随时调整。

图 1：打开“对话设置”，选择协作模式和权限模式。

协作模式

模式	适用场景
Agent 模式	让 AI 分析需求并执行项目任务，适合开发功能、修改文件、运行命令和修复问题。
对话模式	以问答、解释和需求澄清为主，适合先讨论方案或了解项目，不急于执行修改。
计划模式	先梳理实施步骤、影响范围和验证方式，适合复杂改动或希望确认方案后再开发的任务。

权限模式

模式	说明
运行所有指令	在当前项目权限范围内允许 AI 连续执行指令，操作更流畅；适合来源可信、范围明确的开发任务。
危险操作需确认	普通操作可以继续执行，遇到可能影响文件、数据或运行环境的危险操作时，先请求用户确认。

不确定如何选择时，建议使用 Agent 模式 + 危险操作需确认。只需要咨询或讨论时选择 对话模式；涉及范围较大的改造时，可以先用 计划模式 明确步骤。

文件与资源

项目中的代码文件、配置文件、静态资源和上传文件都属于当前项目。项目内数据库和项目内对象存储也只服务当前项目，不作为资源库中的通用资源。

版本管理

AI 编程项目应支持查看历史修改、发布版本和部署记录。开发过程中建议在关键节点保留版本，例如：

• 初始需求完成。
• 页面结构完成。
• 业务逻辑联调完成。
• 发布前验收完成。

协作方式

项目可按空间、成员和角色控制可见范围。具备权限的成员可以查看项目、进入工作区、参与调试或处理发布。