For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/web/content.md (or send Accept: text/markdown).

內容管理

型別化的 CMS 條目，生命週期自由流轉，並有公開讀取邊界。

詢問本指南

初學者演練

先決條件：閱讀下面的兩個初學者指南，完成 Web 本地設定，並在編輯器的根目錄中開啟此 monorepo。網頁設定屬於apps/web/.env.local； Next.js不讀取根.env。預設fake模式下的/dashboard是無資料庫演示； /auth 需要遷移資料庫。

簡而言之：工作區是一個團隊的單獨使用者、資料和設定。伺服器是可信後端；讓提供商金鑰遠離瀏覽器和電話程式碼。遷移是建立或更新表的版本化資料庫更改。人工智慧模型是回答的引擎；型號目錄是伺服器上可用型號 ID 和價格的列表。提供商是一種外部服務，例如人工智慧、電子郵件或計費服務。權利是允許工作區使用某項功能的授權。 Webhook 是一個服務傳送到另一個服務的 URL 的訊息。

1. 以工作區所有者或管理員身份登入，開啟 /content，然後使用表單建立具有唯一別名的帖子、頁面、檔案或報告。將其儲存為草稿，然後釋出。

2.確認狀態變更為已釋出；沒有管理訪問許可權的重複 slug 或成員應該會失敗。

3. 對於門控測試，使用required_entitlement=ai.reference-task；如果沒有經過驗證的授權，該頁面必須僅顯示其預告片。

對於自定義程式碼，請從提供的 prompts/README.md 開始，然後複製最接近的提示：對於應用程式螢幕為 prompts/new-app-screen.md，對於公共頁面為 prompts/new-landing-page.md。對於伺服器、資料庫或提供商工作，請為您的編碼代理提供本指南的任務，並要求其讀取 AGENTS.md、.ai/PROJECT_CONTEXT.md 和匹配的 .ai/ 映象；檢查此處指定的確切原始檔；列出檔案並在編輯前進行檢查；保留工作區所有權和僅限伺服器的機密；並向您展示差異。告訴它您想要的行為、輸入和輸出欄位、允許的角色、預期的成功和錯誤以及測試帳戶、提供程式或裝置。使用樣本值；永遠不要貼上真正的秘密。

建立工作區條目

/content 管理器處理 post、page、doc 和 report 條目。 content_entry 行具有草稿/已釋出/存檔狀態、工作區範圍的段和作者身份。管理操作需要適當的所有者/管理員角色。

此 CMS 與 src/resources 中套件的型別化公共 docs/blog 目錄分開。產品可以通過自己的頁面組合呈現CMS條目。

將主體門控到伺服器上

required_entitlement 可為空：未設定的條目未門控。對於門控條目，僅伺服器 content-queries.ts 會投影可讀內容或帶有空正文的鎖定預告片。 content-access.ts擁有投影；永遠不要相信客戶提供的權利主張。

釋出發出content.published；預定摘要可以總結出版團隊最近的條目。創作內容也參與帳戶匯出。

驗證釋出和訪問

測試草稿可見性、釋出/存檔轉換、重複的段、錯誤的工作空間、免費條目和不活動的付費贈款。使用付費牆塊進行演示，而伺服器仍然負責訪問。

安裝與配置

/content 工作區介面管理 CMS 條目——post、page 和 doc 是建議型別，但該列接受任何 URL 安全的產品型別（小寫字母、數字、連字元、下劃線，最長 64 個字元）。content_entry 表將每行限定在 workspaceId 內，記錄 createdBy，並按工作區和型別保持 slug 唯一。

條目遵循自由的 draft ↔ published ↔ archived 生命週期——src/content.ts 中的 evaluateContentStatusChange 拒絕無效或無變化的轉換，publishedAt 在首次釋出時打上時間戳，並在之後的取消釋出中保留，讓訪客始終看到最初的釋出日期。

/content                    workspace CMS surface
src/content.ts              input + lifecycle rules
src/content-actions.ts      member+ mutations
content_entry               workspaceId, type, slug, status

實現流程

member 及以上角色才能寫入條目——每次變更都通過 requireWorkspaceWriter（workspace-access.ts）解析會話、活動工作區和至少 member 角色，guest 保持只讀。normalizeContentEntryInput 在寫入前驗證型別、1–255 字元的標題和 URL 安全的 slug。

listPublishedContentEntries 是有意設定的公開讀取邊界：它接受顯式的 workspaceId，不需要會話，只返回已釋出的行——店鋪頁面、部落格和檔案正是通過它渲染工作區內容。釋出會發出一個出站 content.published webhook，寫入的條目也會進入 GDPR 資料匯出。

驗證與排障

走完一次完整的 draft → publish → archive 流程，驗證同型別內重複 slug 與跨工作區讀取的行為。確認公開邊界永遠不會返回草稿或其他工作區的行，且 content.published 每次釋出動作只觸發一次。