项目与代码版本
一、功能定位
「项目」是一个应用的容器:同一个项目下可以有很多次对话、很多份文档、一套代码,全部归在一起。
3.0 里开发和对话是分开的——对话可以有很多次,项目只有一个。理解这一点,才不会把"新建会话"当成"新建项目"。
| 概念 | 含义 |
|---|---|
| 项目 | 一个应用,含代码、数据库、文档、成员 |
| 会话 | 项目下的一次对话,改同一个项目的不同部分 |
| 项目详情 | 项目的计划、资产、设置三块 |
⚠️ 同一项目下的会话共用同一套代码。在 A 会话里改的代码,B 会话能直接看到。
二、项目列表
入口:左侧导航「团队·项目·开放·自动化」→「项目&应用」,下面三个分类:
| 分类 | 放什么 |
|---|---|
| 常规项目 | 手写的普通项目 |
| 网站应用开发 | Vibe Coding 生成的全栈应用 |
| 三方应用接入 | 外部系统接进来的应用 |

每张卡片显示名称、最近编辑时间、项目简介;已上线的带绿色「已发布」标记。右上角「+ 创建网站应用」。
卡片右侧「⋯」是该项目全部操作:
| 操作 | 作用 |
|---|---|
| 置顶 | 固定到左侧项目栏顶部 |
| 归档 | 从列表收起来,不删除 |
| 收藏 | 加入收藏 |
| 项目详情 | 进入项目的计划 / 资产 / 设置 |
| 重命名 | 改项目名 |
| 删除 | 连同代码与数据一并删除 |
三、项目详情:计划
打开「项目详情」默认落在「计划」页——一张任务表,记录这个项目做到哪一步了。

| 列 | 说明 |
|---|---|
| 任务 | 一条具体工作,如"实现后端 API" |
| 阶段 | 初始化 / 设计 / 后端 / 前端 / 自检 / 上线 |
| 状态 | 已完成等 |
右侧「相关任务」列出这个项目关联的对话任务,点「+ 新建任务」可以从这里直接开一次新会话。
提示:判断一个项目做到哪了,看计划表比翻聊天记录快。阶段标签是按开发流程切的,不是随便标的。
四、项目详情:资产
「资产」是这个项目的文档区,放方案、架构说明、踩坑记录这类东西。

顶部四个动作:新建文件夹、新建(文档/表格/多维表格等)、上传文件夹、上传文件;右侧「全部类型」过滤,下面有搜索框。
资产和资料库是两套存储:资产跟着项目走,项目删了资产也没了;资料库跟着空间走,与项目无关。
五、项目详情:设置
「设置」页当前是 OAuth2 认证信息——平台为项目自动生成了一套凭证,用于第三方登录与接口鉴权。

| 项 | 说明 |
|---|---|
| Client ID | 公开标识,可放前端 |
| Client Secret | 敏感信息,只能放服务端 |
| 主页地址 / 回调地址 | 第三方登录后跳回哪里 |
| 授权范围(Scope) | profile 读昵称头像、user:search 检索用户、user:phone 读手机号、user:space 查可见空间 |
⚠️ Client Secret 不要写进前端代码,也不要提交到公开仓库。授权范围变更需要管理员审核,审核通过前仍按原范围生效。
六、代码版本(Git)
项目代码是云端仓库,同一项目只有一份,所有会话改的都是它。
三种改代码的方式:
| 方式 | 适合 |
|---|---|
| 在会话里提要求 | 常规修改,AI 改完自动落到项目 |
| 右侧「终端」 | 需要执行命令、看文件、跑 Git |
| 本地客户端 | 把项目拉到本机,用熟悉的编辑器和 Git 工具改 |
在客户端的 Git 流程是常规流程——提交、看改动、切分支、回退;改完推回项目,云端会话里就能看到新代码。
⚠️ 本篇没有写客户端的逐步操作(这台机器上未装客户端,界面未实测)。等你们提供客户端截图或我装上,再补成完整步骤。
七、注意事项
- 删项目等于删数据。项目带数据库,删除前先在「线上环境」确认有没有真实数据。
- 归档不是删除。归档只是从列表收起来,随时可以取消归档。
- 会话不等于项目。一个项目下开十个会话来改,代码还是同一套。
- 代码冲突:本地改了同时云端会话也改了,以最后推送的为准,推之前先同步。
