> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 内容管理

类型化的 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/` 镜像；检查此处指定的确切源文件；列出文件并在编辑前进行检查；保留工作区所有权和仅限服务器的机密；并向您展示差异。告诉它您想要的行为、输入和输出字段、允许的角色、预期的成功和错误以及测试帐户、提供程序或设备。使用样本值；永远不要粘贴真正的秘密。

[开始之前](https://supastack.dev/zh/docs/web/before-you-start.md)

[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)

[网络本地设置](https://supastack.dev/zh/docs/web/ship-in-5-minutes.md)

[座席提示和项目内存](https://supastack.dev/zh/docs/web/agents.md)


## 创建工作区条目

`/content` 管理器处理 `post`、`page`、`doc` 和 `report` 条目。 `content_entry` 行具有草稿/已发布/存档状态、工作区范围的段和作者身份。管理操作需要适当的所有者/管理员角色。

此 CMS 与 `src/resources` 中套件的类型化公共 docs/blog 目录分开。产品可以通过自己的页面组合呈现CMS条目。


## 将主体门控到服务器上

`required_entitlement` 可为空：未设置的条目未门控。对于门控条目，仅服务器 `content-queries.ts` 会投影可读内容或带有空正文的锁定预告片。 `content-access.ts`拥有投影；永远不要相信客户提供的权利主张。

发布发出`content.published`；预定摘要可以总结出版团队最近的条目。创作内容也参与帐户导出。


## 验证发布和访问

测试草稿可见性、发布/存档转换、重复的段、错误的工作空间、免费条目和不活动的付费赠款。使用付费墙块进行演示，而服务器仍然负责访问。

[付费内容教程](https://supastack.dev/zh/docs/web/setup-ai.md)

[内容摘要](https://supastack.dev/zh/docs/web/project-structure.md)

[付费墙介绍](https://supastack.dev/zh/docs/web/project-structure.md)


## 安装与配置

/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 每次发布动作只触发一次。


## 下一篇

[电商](https://supastack.dev/zh/docs/web/commerce.md)