# 你的项目

项目是一个 git 仓库，用于存放智能体的配置和状态。

Canonical page: https://beeuni.ai/docs/zh/project

一个项目就是一个 git 仓库。它存放清单、智能体配置，以及智能体生成的状态。无需同步单独的数据库。

Beeuni 以两种方式管理项目：

- **Beeuni 托管的仓库** — Beeuni 创建并托管私有仓库。默认选项。
- **导入 GitHub 仓库** — 连接现有仓库。Beeuni 通过 GitHub API 操作该仓库。

无论哪种方式，项目都有一个 `default_branch`。每个
[会话](/docs/zh/work/sessions) 都从它分支而出。每个
[变更请求](/docs/zh/work/change-requests) 都合并到它。GitHub 仓库的每个分支都可以成为独立项目。这样，`main` 和 `dev` 就可以作为独立项目运行，各自拥有自己的会话和变更请求。

<a id="a-project-is-not-your-codebase"></a>

## 项目不是你的代码库

项目存放智能体的指令、它的
[连接器](/docs/zh/connect/connectors)、它的[触发器](/docs/zh/connect/triggers)，
以及它的记忆。保持项目精简——Beeuni 会将它克隆到每个会话中。

你的代码存放在别处。任务需要用到代码库时，智能体会克隆该仓库、完成工作，然后向该仓库发起变更请求。不要通过向现有代码库添加清单来把它变成项目。请另建一个专用项目，并将其指向智能体要操作的仓库。

<a id="the-manifest"></a>

## 清单

每个项目的仓库根目录下都有一个清单，默认文件名为 `beeuni.yaml`。平台会读取以下顶层键：

| 键 | 配置项 |
|---|---|
| `default_agent` | 默认运行哪个智能体 |
| `agents` | 每个智能体的授权：连接器、密钥、技能、Beeuni 权限 |
| `sandbox` | 沙盒映像和硬件 |
| `triggers` | 计划任务和 webhook 自动化 |
| `connectors` | 项目可以访问哪些外部工具 |
| `env` | 项目需要的环境变量名称（其值来自密钥） |

未知键会被忽略。

较旧的项目可能仍使用 `beeuni.toml`（`beeuni_version: 1`）。Beeuni 两种格式都能读取。迁移方式请参阅[旧版 TOML](/docs/zh/project/legacy-toml)。

<a id="deleting-a-project"></a>

## 删除项目

可在项目设置中 **Danger zone** 下选择 **Delete project** 删除项目，也可使用 `beeuni projects rm`。从删除那一刻起，任何操作都不能再代表该项目执行：

| 接入方式 | 删除后的行为 |
|---|---|
| LLM 网关密钥（`kgw_…`） | 请求将被拒绝，并返回 `401`。 |
| 公开分享链接 | 返回 `410`。 |
| 应用 | 不再提供服务。 |
| 新会话 | 请求将被拒绝：`404`、`code: "project_archived"`。 |
| Slack 和 Teams | 回复“此 Beeuni 工作区已删除……”，且不启动任何操作。 |
| 电子邮件收件箱 | 对邮件线程中的第一封邮件回复一次：“此地址目前不接收邮件。不会有人回复此消息。”该线程在 30 天内的下一封回复不会收到任何回复；发件人身份验证失败的邮件也不会收到回复。 |
| 现有会话 | 不接收任何新消息：无论消息来自聊天线程、触发器，还是删除前排队的提示。 |

<a id="in-this-section"></a>

## 本节内容

- [清单](/docs/zh/project/manifest): 完整的 beeuni.yaml 参考。
- [智能体](/docs/zh/project/agents): 带有作用域限定工具的 Markdown 角色设定。
- [模型](/docs/zh/project/models): 会话使用哪个模型，以及由谁付费。
- [密钥](/docs/zh/project/secrets): 注入沙盒的加密值。
- [旧版 TOML](/docs/zh/project/legacy-toml): 从 beeuni.toml 迁移。