模板
可 fork 的起步包 —— `todo`、`contracts`、`procurement`、`helpdesk` 等等。
模板
模板是可 fork 的起步包。每一个都是真实成型的应用,能从应用市场一键安装,也能用 CLI 克隆下来得到一个可扩展的 TypeScript 代码库。
模板存在的两个理由:
- Show, don't tell —— 一个能跑的多对象应用,比文档读得更快。
- 给工程团队一个起点 —— 当你想要代码在版本管理之下,而不只是 AI 在 DB 里生成的元数据。
默认目录里有什么
| 模板 | 领域 | 可 fork 用于… |
|---|---|---|
todo | 任务与项目 | 任何"按某种方式分组的待办事项"工具 |
contracts | 带 AI 条款抽取的 CLM | 审批 + 文档 AI |
procurement | 供应商、PO、三方对账 | 审批链 + 收货 |
compliance | SOC 2 / ISO 27001 控制 | 证据收集工作流 |
helpdesk | AI 优先的客户支持 | 工单 + SLA + AI 副驾 |
content | 编辑日历 + 渠道 ROI | 生命周期 + 指标 |
hr | 通讯录、组织架构、休假 | 以人为中心的应用 |
project | 项目 / 任务 / 里程碑跟踪 | PM 工具 |
源码:github.com/objectstack-ai/templates。Apache-2.0。Fork 无需打招呼。
30 秒安装(零代码)
在 Console 里:
- 打开 Marketplace,搜索模板。
- 点击 Install。
- 刷新 —— 新应用出现在你的导航里。
完成。记录、视图、流程、权限 —— 全活了。
作为代码库 Fork(面向工程师)
pnpm dlx @objectstack/cli create my-app --template todo
cd my-app
pnpm install
pnpm dev # http://localhost:4002克隆下来是一个自包含的 pnpm 包 —— *.object.ts、*.view.ts、*.flow.ts 文件,你可以编辑、lint、测试、提交。满意之后:
pnpm build
os package publish # → 你的应用市场安装你 fork 的客户拿到你的品牌和你的修改。
模板章程(社会契约)
每个模板都附带 CHARTER.md,声明其范围和硬性限制 —— 通常是:≤ 6 个业务对象、src/ 下 ≤ 2,500 LOC、一个 app、一个默认 locale。章程的存在是为了让模板保持模板身份,而不是半成品。如果 fork 超过这些限制,请作为新模板发布,不要把已有的撑大。
文件后缀协议(*.object.ts、*.state.ts、*.hook.ts……)、编写顺序(对象 → 状态 → Hook → 视图 → 流程 → ……),以及你应该复用而非重造的多态平台服务(sys_comment、sys_attachment、sys_audit_log),见上游 TEMPLATE_GUIDE.md。
怎么选起点
| 如果你在做… | Fork 这个 | 为什么 |
|---|---|---|
| 任何跟踪"东西"的内部工具 | todo | 最小、最干净地演示所有原语 |
| 任何带审批链的东西 | procurement 或 contracts | 真实的审批流程已经接好 |
| 任何带 AI 的客户向应用 | helpdesk | Agent + 工单副驾模式 |
| 受监管行业的工作流 | compliance | 审计 + 证据 + 控制项映射 |
| 人员 / 组织架构应用 | hr | 通讯录 + 汇报关系 |
AI Builder + 模板 一起用
你可以 fork 一个模板,继续在上面用 AI Builder。安装 helpdesk,然后说:
"在
hd_ticket加一个csat_score整数字段,1–5 范围,关闭时询问。"
AI 就地扩展已安装的包。用 os package export 把变更推回源码仓库。
下一步
- AI Builder —— 用对话扩展任何模板
- Packages —— 模板实际是什么
- Marketplace —— 分发你的 fork
- Quickstart —— 开发者路径端到端