跳转到内容
supastack
浏览文档
WebNext.js

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

常见问题

14 个问题

supastack 是什么?

supastack 是用于构建 AI 驱动 SaaS 产品的模块化基础。它把通用基础设施整合在一起,让你专注于产品专属的功能。

它支持 Web 和移动端吗?

支持。supastack 包含 Next.js 与 Expo 应用,作为 Web 与移动端体验的起点。

包含哪些认证方式?

Better Auth 覆盖邮箱/密码、OTP 与社交登录。个人工作区随账户一起开通,产品记录从第一天起就有边界。

AI 是如何支持的?

supastack 包含可配置的多供应商 AI、用量追踪、预算,以及加密的自带密钥(BYOK)支持。

订阅如何处理?

对于基于该套件构建的产品,Stripe 计费、订阅与权限构成付费访问的基础。供应商密钥仅存于服务端。

我的产品专属代码放在哪里?

产品专属功能保留在独立的代码库中,产品通过配置接入 supastack 的基础模块。

supastack 如何定价?

套件为一次性购买、终身更新:单框架 249 美元(限时优惠价,较常规价 349 美元优惠 100 美元),或全框架(Next.js、iOS、Android)499 美元(限时优惠价,较常规价 599 美元优惠 100 美元),每个额外开发者席位 75 美元。套件本身没有订阅。本站结账后通过邮件发送许可证密钥,仓库访问通过 GitHub 邀请授予。

工作区如何界定我的数据?

用户记录按 workspaceId 划定边界。身份、权限、AI 用量、计费事件与审计条目都留在个人工作区边界内。

后台任务如何工作?

Trigger.dev 是明确的任务运行时。JobRunner 契约只承诺 enqueue、status 与 cancel——工作流语义保持 Trigger.dev 专有且显式。

邮件与营销触达有何不同?

事务性邮件覆盖产品工作流,如任务完成通知。冷触达与营销活动属于产品自身的范畴,不在本套件的邮件模块内。

移动端购买如何运作?

移动端已支持 RevenueCat 原生购买和恢复购买,访问权限由服务端验证。发布前需配置商店账户并完成设备测试。Web 计费保持独立。

AI 供应商密钥存放在哪里?

自带密钥凭证经过加密且仅存于服务端。密钥在日志中被脱敏;用量与预算在工作区级别保持可见。

结账支持哪些付款方式?

Stripe 托管结账接受银行卡,在 Stripe 账户启用后还可提供支付宝与微信支付——方便中国买家。钱包授权为异步确认,付款完成后许可证页面会立即更新。

我能申请退款吗?

获得代码仓库访问权限后,supastack 将永久归你所有,因此无法退款。但请放心,你将获得包含终身更新的完整源代码,可为你自己或客户构建并发布无限数量的产品。你只需注意不能转卖代码,也不能将仓库作为启动模板二次分发。

CN
主题