文档
面向技术团队
构建你的运营所需的系统。
Norbital 是一个运营应用平台——你的团队用来处理日常工作的工具。你用 Bolt 以文件的形式编写工作区（模型、集合、应用、自动化、策略、Agent），再由 Colony 这样的宿主把源码变成一个在线、可版本化的系统：租户应用、工作区工作室、不可变的发布制品，以及一个遵守同一套访问规则的 AI Agent。
┌─────────────────────────── Bolt ────────────────────────────┐
│ Author a workspace as files under src/: │
│ data/ access_control/ integration/ agent/ app/ … │
│ │
│ bolt build → one immutable artifact │
└──────────────────────────────┬────────────────────────────────┘
│ artifact
▼
┌─────────────── Host: bolt-server or Colony ─────────────────┐
│ the Bolt engine · Postgres per tenant · guest isolates │
│ Colony adds routing · releases · Workspace Studio · billing │
└──────────────────────────────┬────────────────────────────────┘
│ serves
▼
┌────────────────────────── Browser ──────────────────────────┐
│ $bolt reads once or live; writes paint optimistically and │
│ settle on their outcome; live views stream changes over SSE │
└───────────────────────────────────────────────────────────────┘Bolt 定义工作区；宿主运行它
Bolt 是编写接口、编译器与引擎。
bolt build 写出一个制品，任何宿主都能运行它：在你自己的机器上用 bolt start（bolt-server），或使用 Norbital 的托管宿主 Colony。随附的入门工作区列在模板页面上。你要构建什么
- 模型与集合——存储在
src/data/model/中；src/data/collection/中则是每个模型可供调用方读写的部分 - 写入契约——每个集合一个 transform、带类型的查询与操作，每次写入一条语句
- 自动化——定时、事件与 webhook 触发的工作，也是唯一可以进行外部 I/O 与 AI 调用的地方
- 应用——通过带类型的
$bolt客户端与@norbital-ai/ui视图读写数据的 Svelte 页面 - 安全——团队、按集合授予权限的策略，以及嵌入写入授权中的审批流程
- Norbius——应用内 Agent，以及在 WhatsApp、Telegram 或电子邮件上的 Envoy，受同一套策略约束
如何阅读这些文档
文档按照工作的实际发生顺序排列：