模板 | ObjectOS

可 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 —— 開發者路徑端到端

模板