構建

模板

可 fork 的入門包 —— `helpdesk`、`hr` 和 `project`。

模板是可 fork 的入門包。每一個都是一個真實的、成形的應用,你可以從 市場一鍵安裝,也可以用 CLI 克隆下來,得到一個可供擴充套件的 TypeScript 程式碼庫。

模板的存在有兩個原因:

  1. 展示,而不是講述 —— 一個能用的多物件應用比文件讀起來更快。
  2. 給工程團隊一個起點 —— 當你想把程式碼納入原始碼管理,而不只是資料庫裡 由 AI 生成的後設資料時。

預設目錄中包含什麼

模板領域可 fork 作為……的起點
helpdeskAI 優先的客戶支援工單 + SLA + AI 副駕駛
hr通訊錄、組織架構圖、休假以人為中心的應用
project專案 / 任務 / 里程碑跟蹤專案管理工具

原始碼:github.com/objectstack-ai/templates。 Apache-2.0。無需詢問即可 fork。

30 秒安裝(零程式碼)

在 ObjectOS 中:

  1. 開啟 Marketplace(市場)→ 搜尋該模板。
  2. 點選 Install(安裝)。
  3. 重新整理 —— 新應用會出現在你的導航中。

完成。記錄、檢視、流程、許可權 —— 全部上線。

作為程式碼庫 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 的東西helpdeskAgent + 工單副駕駛模式
人員 / 組織架構應用hr通訊錄 + 彙報結構

AI Builder 與模板配合使用

你可以 fork 一個模板,仍然在它之上使用 AI Builder。安裝 helpdesk, 然後說:

"給 hd_ticket 新增一個 csat_score 整數字段,範圍 1–5,在關閉時 詢問。"

AI 會就地擴充套件已安裝的包。這個變更是你部署中的即時後設資料,像任何其他 AI Builder 變更一樣經過批准;它不會自己迴流到模板的原始碼倉庫。

下一步