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