CLI

beeuni 命令行工具、其身份验证模型、开发迭代流程以及所有命令。

beeuni 命令行界面（CLI）可通过终端（你的笔记本电脑或会话沙箱）控制 Beeuni。本页介绍日常开发循环，然后列出所有稳定的命令和标志。

安装

curl -fsSL https://beeuni.ai/install | bash

安装程序会为 macOS 和 Linux 下载预构建的二进制文件。不支持 Windows。

身份验证模型

Beeuni 按主机存储身份验证信息，而非全局存储。主机是一个 Beeuni API 端点。使用 cloud 连接到 Beeuni。

配置文件位于 ~/.config/beeuni/config.json，权限模式为 0600。使用 BEEUNI_CONFIG_FILE 覆盖其路径。

CLI 遵循以下层级：主机 → 账户 → 项目 → 会话。你登录主机，在其中选择账户，在该账户中选择项目，然后在项目中开启会话。beeuni hosts login 会依次执行前三个步骤：登录、选择账户，然后设置默认项目。

每个令牌都以 beeuni_pat_ 开头。用户令牌来自 beeuni login，可访问你所属的所有账户和项目。项目令牌会为会话沙箱自动签发，并限定于单个项目。请参阅令牌范围。

开发循环

本循环假设已安装 CLI 并运行过 beeuni login。请参阅快速入门了解设置方法。

beeuni init my-app
cd my-app

beeuni projects link <project-id>

beeuni ship

beeuni sessions new --prompt "Build the login page" --wait

beeuni connect

beeuni sessions chat

beeuni tui        # or: beeuni t, or beeunit
beeunit --project <id> --new --terminal   # new session + sandbox shell, one command

beeuni sessions shell

beeuni sessions ls

beeuni cr ls
beeuni cr diff 1
beeuni cr merge 1

参考

身份验证命令

beeuni hosts login / hosts logout / hosts whoami 是规范形式。login / logout / whoami 是针对当前主机操作的快捷方式。

主机

以 http:// 开头的远程主机 URL 会规范化为 https://。CLI 绝不会通过纯 HTTP 向远程主机发送令牌。localhost 不受此限制。

账户

成员

查看账户成员及其账户角色。角色包括 owner、 admin 和 member。所有者和管理员在每个 项目中都隐式拥有 Manager 权限，因此只有 member 角色需要按项目单独授权。

<user> 是用户 ID，或已加入账户的人员的电子邮件地址。 选项：--account <id>、--host <name>、--json、-y。

组

账户组是一组命名的人员集合，你可以一次性为其授予角色。使用 beeuni access grant --group <id> --role <key> 将组绑定到作用域；使用 beeuni access revoke <assignment-id> 撤销绑定。

<group> 可以是组 ID 或组的完整名称。读取操作需要 group.read。 create、set 和 add 需要 group.update 或 group.members.manage，以及企业 rbac 权益。rm 和 remove 用于清理，永远不受权益限制。

令牌

账户的非交互式凭据。读取操作需要 token.read。每位账户成员都可以创建和撤销自己的个人密钥（token.personal.create、token.personal.revoke）；个人密钥代表你操作，且携带的角色不会超过你自己的角色。服务账户和他人的密钥需要 token.create / token.revoke（所有者和管理员）。

个人 API 密钥代表你操作，并随你的成员资格一同失效。服务账户代表自身操作，不会继承任何访问权限：新建的服务账户没有任何权限。使用 beeuni access grant --service-account <id> --role <key> 为其授予权限。 --expires <when> 接受 ISO-8601 时间或向前的时间跨度：30d、12h、6w、1y。

计费

读取当前账户的套餐、额度和支出。仅支持读取：套餐变更、充值和付款方式需要在控制面板中操作。

过滤器：--project <id>、--session <id> 和 --owner <id>（会话，配合 --by session）。选项：--account <id>、--host <name>、--json。

项目

命令按以下顺序解析“该项目”：

1. --project 标志。
2. BEEUNI_PROJECT_ID 环境变量。
3. 当前工作目录中准确匹配的 .beeuni/link.json。
4. 由 beeuni projects use 设置的全局默认项目。

一个项目只能显示一个图标，因此写入 --icon 会清除字形，写入 --glyph 会清除表情符号；同时传入两者会被拒绝。字形颜色：grey、red、orange、yellow、lime、blue、purple、magenta。set 和 features 需要 project.settings.write。如果平台将某个标志标记为不可用，无论项目覆盖设置如何，该标志都会保持关闭。

项目 CLI 令牌绑定到一个项目——API 会拒绝其在其他项目中的使用。会话沙箱使用其与会话绑定的 BEEUNI_TOKEN。cli-tokens ls 需要项目读取权限；new 和 rm 需要 project.credentials.issue。无论项目是否声明代理，会话绑定的令牌都不能创建或撤销项目令牌（403）。项目 CLI 令牌遵循账户的 PAT 政策：当账户要求过期时间时，传入 --expires-at；超过最大生命周期的过期时间会返回 400。

beeuni projects upgrade 需要项目写入权限。默认代理会刷新 marketplace 基线、重写清单、运行 beeuni validate，并创建变更请求。它绝不会合并：由人工审查差异。

项目脚手架

beeuni init [project-name] [options] 创建新的项目目录。启动模板会写入 v2 beeuni.yaml、agents/、skills/、memory/ 和 harnesses/opencode/。该命令可以配置本地编码工具发现，而不会更改云端 默认运行时 运行时。该命令不会写入 .beeuni/link.json。beeuni ship 或 beeuni projects link 会创建该文件。

本地编码工具选择不会更改云端 默认运行时 运行时。

beeuni init 不包含 marketplace 选择器。添加 marketplace 技能属于代理导入操作：启动会话并要求代理导入技能。

发布

beeuni ship 会将当前分支暂存、提交并推送到项目的 git 仓库。首次运行时创建项目；之后可随时再次运行以同步。别名：beeuni deploy。

每次运行：

• 运行 beeuni validate 检查：beeuni.yaml 会检查与 imports: 中列出的每个文件合并后的内容、沙盒 Dockerfile、代理接线和仓库大小（使用 --no-verify 跳过）。出错会阻止发布，警告则不会。
• 提交工作树中的所有未提交更改（使用 --no-commit 跳过）。
• 提示输入缺失的 env 密钥（使用 --no-env 跳过）。
• 将当前分支推送到同名远程分支。
• 连接仍需授权的已声明连接器（使用 --no-connect 跳过）。

现有的 GitHub origin 会通过 Beeuni GitHub App 关联。其他任何现有的 origin 都会按原样注册。不提供 origin 时，会创建由 Beeuni 管理的 Git 仓库。

应用

Apps 可托管静态网站、服务器、后台任务和数据库。每个 App 有稳定的 URL。发布包含代码与配置；部署失败不会替换当前发布。

beeuni apps list
beeuni apps show main
beeuni apps connect main
beeuni apps launch --template convex --slug main
beeuni apps deploy dist --type static --spa
beeuni apps machines main
beeuni apps volumes main

通过 uses 连接应用，使用 beeuni apps connect 提供的连接示例。不要在客户端代码中放入管理凭据。

运行中的资源消耗账户额度，在 Billing 和 Usage 中查看余额与用量。Apps 不再单独设置月度预算。

Apps

会话

每个会话都在自己的分支上的一个沙盒中运行。

sessions queue需要project.session.start，与发送消息所需的权限相同。排队的提示会在终端关闭后继续保留，并在会话可以接收时送达。使用beeuni sessions chat <id> -p "…" --queue将提示放入队列，或使用--steer引导正在运行的轮次。sessions queue ls会显示每个提示的DELIVERY（steer、queue或interrupt）；对于作为queue运行的引导提示，还会显示原因：unsupported（会话无法在轮次进行期间接收消息）、not_prompter（另一位成员的轮次正在运行）或turn_ended。

sessions approvals会持久保留：与sessions pending不同，即使沙盒重启也不会丢失。操作需要project.members.manage权限，或由启动会话的用户本人执行。智能体绝不能处理自己的审批。

sessions attachments读取会话的私有文件存储，而不是工作区。文件会在发送时存入其中，智能体展示的每个文件也会在轮次结束时存入其中。

sessions files读取智能体当前正在编辑的工作树，即尚未提交的内容；beeuni files则读取已提交的仓库。除非路径以/workspace、/tmp、/home或/opt开头，否则会在/workspace下解析。若沙盒处于休眠状态，此命令会将其唤醒。选项：--from <local path>（write会改为读取此文件，而不是标准输入）、--content（find会使用 ripgrep 搜索内容，而不是文件名）、--limit <N>（find文件名数量上限），以及-y，用于跳过rm确认。

sessions share由所有者管控：如果项目管理员原本无权读取该会话，API 就会拒绝操作。共享会话只能使用与整个项目共享的提供商密钥运行：使用你自己的密钥运行的模型，会改用该提供商的项目密钥；如果项目没有可用于运行该模型的密钥，共享请求会被拒绝（409 SHARED_SESSION_NEEDS_PROJECT_KEY）。

sessions links create选项：--port <n>（默认3000；拒绝22、8000和 opencode 端口）、--path <p>（默认/）、--preview <id>（指定候选项——web、vite、dev-server、api-docs——而非--port/--path）、--file <path>（共享一个工作区文件，而不是预览；始终为只读）、--mode view\|interactive（默认view；interactive允许写入和使用 WebSocket，对--file无效）、--label <text>和--expires <iso>。创建链接需要会话所有者权限，因为链接本身无需登录；列出和撤销链接也允许项目管理员操作。

在沙盒内，BEEUNI_SESSION_ID是你自己的会话 ID。

更改请求

更改请求（CR）会在任意 Git 托管平台上将一个分支合并到另一个分支。这是智能体将会话工作合并到默认分支的唯一方式。请参阅更改请求。

request-changes会将备注记录在 CR 上，并发送到发起该 CR 的会话；如果其沙盒处于休眠状态，则会启动沙盒。此操作需要project.review.act，即 Review Center 使用的相同权限叶节点，而不是gitops.push。

<cr>接受项目内编号（3）或完整 ID。在沙盒内，CLI 会自动读取会话令牌，无需登录或链接。

审核

项目的审核收件箱汇集所有等待人工决策的内容：更改请求、策略要求审批的连接器工具调用，以及智能体提交以供签核的输出、决策和批次。与仪表板中的 Review Center 保持同步。所有项目默认启用；project.review.read和project.review.act分别控制读取和操作权限。

判定结果：approve、reject、changes、answer、dismiss。类别：needs_you、waiting、done。类型：change、approval、output、decision、batch。

判定结果的处理方式取决于项目 ID。对于cr:<id>，approve会合并更改，reject会关闭它，changes会将备注发回创建该请求的智能体（需要--message）。对于call:<id>，approve会允许工具调用运行，reject会拒绝它；连接器审批不接受其他判定结果——请先使用beeuni review show查看其参数。其他所有 ID 都会交由原生操作端点处理，该端点接受所有判定结果。

bulk仅处理原生 ID。连接器审批需要单独审核参数，更改请求则需要查看其差异，因此这两类项目会被报告并跳过——这与仪表板的多选规则相同。

submit选项：--kind output\|decision\|batch（必填）、--title <text>（必填）、--summary <text>、--risk none\|low\|medium\|high（默认none）、--detail <json>（JSON 对象）、--agent <name>和--session <id>（当它不属于此项目的会话时会被忽略）。

读取需要project.review.read，处理判定需要project.review.act，而submit需要project.review.submit。

密钥

存储在项目中的加密值。默认情况下，启动时会将密钥作为普通环境变量注入每个会话沙箱（环境暴露）。强制交付——沙箱持有句柄，由 Beeuni 在沙箱外替换为真实值（出口强制暴露，以及 beeuni secrets call）——目前处于实验阶段。启用 secrets_egress 功能标志（Settings → Feature flags）即可使用；关闭该标志时，beeuni secrets delivery … egress 会返回 403 feature_disabled。参阅 Secrets。

如果某一行被 ls 报告为无法交付，使用 grant 修复。它只会扩大一个智能体的列表；要缩小或替换列表，请使用 beeuni agents scope. There is no secrets revoke 重写整个集合——API 没有只从授权中删除单个标识符的路由。项目尚无智能体时的首次授权会启动治理：此后，清单中未列出的智能体将无法收到项目密钥，发生这种情况时，命令会予以提示。

Env

Agents

链接项目中每个智能体的模型设置。

每个作用范围选项都会替换现有内容，不会合并。--set 值若能解析为 JSON，就按 JSON 解析；否则保留为字符串。模型固定设置和 scope 会立即生效，无需 beeuni.yaml 提交；default 和 config 会提交到项目默认分支上的 beeuni.yaml。scope 需要 project.agent.write，default 和 config 也需要。

Tools

项目会话可用的工具，从本地 beeuni.yaml 及其导入项读取。在项目根目录运行。参阅 Tools。

没有 tools: 键时，每个会话都会获得全部五个 Beeuni 工具（web_search、 image_search、scrape_webpage、memory、show）。有 tools: 键时， 会话只能获得其中列出的 Beeuni 工具。要移除 Beeuni 工具，请删除它在 tools: 下的行，然后运行 beeuni validate。若要限制单个智能体可用的工具，请使用 agents.<name>.tools。退出码：0 成功；1 操作被拒绝（文件已存在，或清单、导入项无法解析）；2 清单不存在、选项未知，或名称不是 Beeuni 工具。

Models

项目提供哪些模型，以及默认使用哪个模型。与控制面板中的 Customize → Models 页面相同。项目只存储对目录默认值（每个系列的最新模型）的例外设置。启用状态仅影响显示：它决定选择器提供哪些选项，而不会限制网关提供哪些模型。

模型 ID 是网关线路 ID——可以是未加前缀的托管模型 ID（glm-5.3-flash），也可以是 BYOK provider/model。从 beeuni models ls --json 复制。每个智能体的固定设置位于 beeuni agents model <agent> <model-id>。写入需要 project.model.write。

Channels

管理项目与聊天平台的连接。令牌会加密存储在项目密钥中，并在服务端解析——绝不会注入沙箱。

--platform slack|teams 选择平台；默认值为 slack。Teams connect 输出 Microsoft 管理员同意 URL；授予整个租户的同意后， 应用会自动发布到 Teams 目录。请参阅 Connectors。

电子邮件渠道由 AgentMail 提供支持，需要启用 agentmail_email 功能 标志。email connect 选项：--connector <slug>（默认值 beeuni_email）、 --api-key <k>（使用你自己的 AgentMail 密钥；- 从 stdin 读取）、 --display-name <n>（外发邮件的发件人名称；默认为项目名称）、 --username <u> 和 --domain <d>（新建托管收件箱），以及 --inbox-id <id> 和 --email <addr>（关联现有收件箱——两者必须同时提供）。 --allow 可重复使用，并会启用受限模式；不带 @ 的裸值，或以 @ 开头的值，均会被视为域名。 --allow-all 会清空列表，重新接受所有发件人的邮件。

电子邮件和 bind 写入操作需要 project.connector.write。

Connectors

供智能体作为工具调用的连接器。add、rm 和 policy set 会编辑本地 beeuni.yaml；运行 beeuni ship 以应用更改，除非传入 --apply，立即更改云项目。

policy ls、show、set、add 和 rm 属于项目范围的命令，因此，若连接器名称与其中一个动词相同，必须使用 policy <slug> ls 指定该连接器。<match> 可以是工具名称、通配模式（send_*）或 /regex/。

add 选项：--name <label>、--provider <pipedream\|mcp\|openapi\|postman\|graphql\|http>、--app <slug>、--url <url>、--transport <http\|sse>、--endpoint <url>、--base-url <url>、--spec <url\|path>、--auth-type <none\|bearer\|basic\|custom>、--credential shared。

Sandboxes

管理项目的沙盒镜像。模板定义镜像或 Dockerfile 及资源；构建会生成会话启动时使用的快照。

固定提供商需要 project.settings.write。

add/update 选项：--name <label>、--cpu <n>、--memory <n>（GiB）、--disk <n>（GiB）。

Backends

数据库是带有持久卷的 App。通过 Apps 管理和连接。

Apps

Marketplace

浏览 Beeuni Marketplace，并将项目安装到项目中。

选项：--query <text>、--type <type>、--source <source>、--host <name>、--project <id>、--json。

安装由 agent 驱动：它会启动项目会话，克隆项目、读取内容、合并适用的部分，并发起更改请求。没有确定性的安装、更新或移除机制。

系统技能

Beeuni 系统技能是供用户和 agent 参考的平台运维指南，涵盖会话、沙盒、默认运行时、连接器、记忆和频道。此公开页面是入口；经过身份验证的 CLI 会从运行中的主机读取技能。使用 beeuni system-skills list 查找可用技能，然后使用 get 查阅所需技能。API 会实时提供技能，因此内容与已部署的主机版本一致。不要将本地副本视为最新版本。

选项：--host <name>、--json。

beeuni skills 是同一命令的永久别名。先使用 beeuni login 登录主机；技能 API 需要身份验证。使用 --host <name> 可操作其他主机。公开文档页面无法替代这些实时且针对特定主机的说明。

此列表始终只包含系统技能，不会混入其他技能。可选技能位于 Marketplace：beeuni marketplace list --type skill。命令语法请参阅 beeuni <command> --help；完整的平台参考请阅读 beeuni system-skills get beeuni-system --full。

Connector

沙盒内 agent 连接所有连接器的接口。每次调用都会在服务器端经过检查、解析和审计；CLI 不会保存任何第三方凭据。身份验证：BEEUNI_TOKEN。输出为 JSON。

文件

只读查看项目的 git 仓库。除非 --ref 指定其他分支、标签或提交，否则使用默认分支。

每个子命令都支持这些选项：--ref <ref>、--path <p>、--limit <n>、--json。 download 还接受 -o, --out <file>，此选项为必填项。

每个子命令都需要 project.file.read。此外，download 会拒绝任何包含你无权访问的代理或技能的子树——zip 文件无法在流式传输过程中进行筛选——因此在这种情况下，请归档范围更窄的 --path。

触发器

触发器可根据计划、webhook、应用事件或监视器（实验性）启动会话。add、rm、enable、disable 会编辑本地清单——运行 beeuni ship 以应用更改。pause/resume 会切换单独的服务器端开关。请参阅 Triggers。

add 选项：--type <cron\|webhook\|event\|monitor>（默认为 cron）、--prompt <text>（必填）、--agent <name>、--cron <expr>（6 个字段，例如 "0 0 9 * * 1-5"）、--run-at <iso>（在此时刻运行一次，而不是按 cron 运行）、--timezone <tz>（默认为 UTC）、--secret-env <NAME>、--name <label>、--disabled。

仅实时选项——适用于 add --apply，以及每个 set：--model <provider/model>、--session-mode <fresh\|keyed\|pinned\|reuse>、--session-key <tmpl>（按键为每个会话分桶，例如 "{{ body.data.chat_jid }}"；隐含 keyed）、--session-id <id>（pinned 触发器循环使用的会话；必须是此项目的会话）、--session-access <private\|project\|members>（默认为 private）、--member <uuid> 和 --group <uuid>（可重复；每个都隐含 members），以及 --filter <path=value>（可重复；每一个都必须匹配，例如 --filter body.type=push）。

set 接受所有仅实时选项，以及 --name、--prompt、--cron、--run-at、--timezone、--secret-env、--agent 和 --enabled true|false。--cron 和 --run-at 互斥：设置其中一个会清除另一个。监视器字段仅支持添加。

提醒

提醒会在之后的一个会话中再次提示一次或按重复计划提示。它存储在数据库中，而不是 beeuni.yaml 中。在会话内，--session 默认为 $BEEUNI_SESSION_ID。请参阅 Reminders。

计划选项：--in <duration> 或 --at <iso>（首次触发；单独使用时仅触发一次）、--every <duration>（重复，最短间隔为 5m）、--cron "<expr>" 与 --timezone <tz>。其他选项：--name <label>、--session <id>（可使用唯一前缀）、--project <id>、--host <name>、--json。

事件选项（--type event）：--connector <slug> 和 --event <TYPE>（均为必填）、--config key=value（可重复，字符串值），以及 --config-json '{...}'（类型化值）。set 接受相同的标志。事件触发器拒绝 --cron、--run-at、--timezone、--secret-env 以及监视器选项。提示内容读取 {{ event.data.<field> }}；请参阅 App event triggers。

监视器选项（--type monitor）：--run <cmd>（要监视的相对于仓库的命令；必填）、--mode <poll\|stream>（必填；poll 会在 --interval 上重新运行，stream 会使命令保持运行）、--interval <dur>（仅限 mode=poll，最短 30 秒，例如 60s、5m），以及 --expect-event-within <dur>（静默看门狗；在时间窗口内没有事件时改为触发生命周期事件，最短 5 分钟，例如 24h）。监视器是平台全天候运行的仓库命令，每一行 stdout 都会触发该触发器。它是实验性功能：平台仅在启用 monitors 功能标志的位置运行监视器。

访问权限

唯一授权表的 CLI 界面。每一行都是一项分配：一个主体、一个角色、一个范围，可选择进一步限定到一个对象。有关模型，请参阅 Accounts & access。账户角色：owner、admin、member。项目角色：manager、member。

授权选项：--project <id>（默认为关联项目）、--account（整个账户）、--agent <name>（将授权限定到一个代理——对象分配）、--connection <id>（限定一个共享连接器账户的使用范围；第一项授权会将该账户限制为其被授权者，撤销最后一项授权后则再次对整个项目开放）、--everyone（授予所有有权访问项目的人员；它包含一个 --agent 或 --connection，而不是角色），以及 --expires <iso>（自动撤销时间戳）。--principal 会筛选列表，并接受 user:<id>、group:<id>、service_account:<id>、project:<id> 或 pending:<email>；单独的 ID 会被视为用户。授予所有人的授权会列为 everyone。代理的身份是一个 service_account，因此 --service-account <id> 是向代理分配角色的方式。--user 接受电子邮件地址，并在账户成员目录中解析该地址。

beeuni access grant --user alice@corp.com --role manager
beeuni access grant --user alice@corp.com --role admin --account
beeuni access grant --group 8f3c… --role member --project 1a2b…
beeuni access grant --user alice@corp.com --agent support-bot
beeuni access grant --everyone --agent support-bot
beeuni access grant --group 8f3c… --connection 2b7e…
beeuni access revoke 4d5e…

项目成员动词是对相同分配的读取模型：

以上两个表格中的每个动词都需要 project.members.manage。

人员、群组或代理会从 Beeuni 获得角色；代理还会在 beeuni.yaml 中携带 Beeuni 权限，而会话只能执行两者都允许的操作。参见一种词汇，两种绑定。

审计

审计命令读取集中式重建日志。账户和项目列表按时间倒序排列。会话时间线按创建时间排序（session_sequence 仅在 2026-10 之前写入的行上设置，这些行排在最前）。--all 会跟随每个续传游标。ls 列出最近 90 天的记录；export 可追溯 365 天，超过 90 天的事件来自归档（参见审计保留期）。表格在每行标题（例如 EVENT「已撤销 LLM 网关密钥」）旁显示其 ACTION（gateway.key.revoke）；--action 按操作前缀筛选。所有操作和标题见：审计日志操作。

审计 Webhook 会将记录流式传输到 SIEM。每个动词都需要 account.write；add 和 enable 还需要企业版权益。disable 和 rm 则始终不需要。

筛选条件：--actor、--actor-type、--project、--session、--source、--phase、--outcome、--action、--resource-type、--request-id、--correlation-id、--query、--since、--until、--cursor 和 --limit。 账户列表和导出需要 audit.read 以及账户的 auditAccess 权益。项目范围的列表需要 project.members.manage，因为其中可能包含私有会话元数据。重建会话需要 project.session.read，且必须能查看该会话。

角色

角色是具名的权限集合。系统角色（账户范围的 owner、admin、member；项目范围的 manager、member；以及对象分配携带的标记 agent-user）均为只读引用。自定义角色可由你创建和编辑，并且需要企业版 rbac 权益。

使用 beeuni access grant 将角色绑定到主体。旧版的 beeuni roles assign / unassign / assignments 动词仍可使用，并写入同一张表，但 beeuni access 是文档所述的操作方式。beeuni roles actions 已由 beeuni permissions ls 取代。

自定义角色只能添加权限。Beeuni 没有拒绝规则，因此角色无法阻止管理员拥有某项权限。

权限

权限目录以数据形式呈现。每个叶级操作占一行，列出其判定范围、是否可委派以及会隐含哪些权限。角色由这些键构成——beeuni roles create --actions 和 beeuni roles set-actions 使用的正是这些键。别名：beeuni perms。

授权

将一个项目对象分配给主体，即创建一个对象分配。密钥和连接器属于代理，因此将代理分配给某人会授予该代理声明的所有内容。代理默认是封闭的：只有在分配中指定某个成员或其所属群组时，该成员才能访问代理。beeuni access grant --agent <name> 会写入同一行记录。

清单验证

参见清单参考。

仓库大小

会话会根据基础提交中 Git 跟踪的所有文件构建其代理配置。新会话会从自己的检出中获取这些文件，不受大小限制。运行中的会话通过项目快照获取基础分支的更改；Beeuni 云构建的快照压缩后最多为 512 MiB。超过此限制时，会话会继续使用当前运行的配置，直到启动新会话。每个会话也会下载所有文件。beeuni validate 会统计 Git 存储的文件以及下次由 beeuni ship 提交的未跟踪文件；当单个文件达到或超过 10 MiB，或总大小超过 512 MiB 时，会打印警告。Git LFS 文件按其指针计数，因为发布内容仅包含指针。警告会列出最大的文件。此项检查绝不会导致命令失败。

要消除警告：

• 将大型静态资源（视频、图像、数据集、模型权重）移至 S3、R2 或 GCS 等对象存储，或移至 CDN，并在运行时下载。
• 将构建输出（dist/、out/）添加到 .gitignore。
• 对于必须保留在 Git 中但没有代理会读取的路径，将 <path> export-ignore 添加到 .gitattributes。发布内容和检查都会忽略该路径；目录规则会涵盖其下的所有内容。代理配置目录和 beeuni.yaml 始终会完整发布。

令牌范围

每个令牌都以 beeuni_pat_ 开头。用户令牌的作用域涵盖你账户中的所有项目。项目令牌的作用域仅限于一个项目，并会自动注入该项目的沙箱中。请参阅完整的令牌系列参考：Session runtime。

退出代码