ObjectOS模板
可 fork 的入门包 —— `helpdesk`、`hr` 和 `project`。
模板是可 fork 的入门包。每一个都是一个真实的、成形的应用，你可以从 市场一键安装，也可以用 CLI 克隆下来，得到一个可供扩展的 TypeScript 代码库。
模板的存在有两个原因：
- 展示，而不是讲述 —— 一个能用的多对象应用比文档读起来更快。
- 给工程团队一个起点 —— 当你想把代码纳入源码管理，而不只是数据库里 由 AI 生成的元数据时。
默认目录中包含什么
| 模板 | 领域 | 可 fork 作为……的起点 |
|---|---|---|
helpdesk | AI 优先的客户支持 | 工单 + SLA + AI 副驾驶 |
hr | 通讯录、组织架构图、休假 | 以人为中心的应用 |
project | 项目 / 任务 / 里程碑跟踪 | 项目管理工具 |
源码：github.com/objectstack-ai/templates。 Apache-2.0。无需询问即可 fork。
30 秒安装（零代码）
在 ObjectOS 中：
- 打开 Marketplace（市场）→ 搜索该模板。
- 点击 Install（安装）。
- 刷新 —— 新应用会出现在你的导航中。
完成。记录、视图、流程、权限 —— 全部上线。
作为代码库 fork（面向工程师）
npm create objectstack@latest my-app
cd my-app
pnpm install
pnpm dev脚手架会让每个项目都从它的 blank 模板开始。它不再按名称拉取内容模板：
在 ObjectStack 17.7 上，--template todo 会因已退役而被拒绝。
项目是一个自包含的 pnpm 包 —— *.object.ts、*.view.ts、*.flow.ts
文件，你可以编辑、lint、测试、提交。当你满意时：
pnpm build
os package publish # → your marketplace安装你的 fork 的客户得到的是你的品牌和你的修改。
模板章程（社会契约）
每个模板都附带一份 CHARTER.md，声明它的范围和硬性限制 —— 通常是：
≤ 6 个业务对象、src/ 下 ≤ 2,500 行代码、一个应用、一种默认语言。这份
章程的存在是为了让模板保持为模板，而不是半成品。如果一个 fork 超出了
这些限制，就把它作为一个新模板发布，而不要让已有的模板膨胀。
文件后缀协议（*.object.ts、*.state.ts、*.hook.ts ……）、编写顺序
（对象 → 状态 → 钩子 → 视图 → 流程 → ……），以及你应该复用而不是重新发明
的多态平台服务（sys_comment、sys_attachment、sys_audit_log），见上游
的 TEMPLATE_GUIDE.md。
选择一个起点
| 如果你在构建…… | Fork 这个 | 为什么 |
|---|---|---|
| 任何面向客户且带 AI 的东西 | helpdesk | Agent + 工单副驾驶模式 |
| 人员 / 组织架构应用 | hr | 通讯录 + 汇报结构 |
AI Builder 与模板配合使用
你可以 fork 一个模板，仍然在它之上使用 AI Builder。安装 helpdesk，
然后说：
"给
hd_ticket添加一个csat_score整数字段，范围 1–5，在关闭时 询问。"
AI 会就地扩展已安装的包。这个变更是你部署中的实时元数据，像任何其他 AI Builder 变更一样经过批准；它不会自己回流到模板的源码仓库。
下一步
- AI Builder —— 通过对话扩展任何模板
- 包 —— 模板实际上是什么
- 市场 —— 分发你的 fork
- 在本地运行 ObjectOS Community —— 开发者路径的完整端到端演示