内容与文章发布指南

本文面向使用 CMS 后台维护新闻、案例、产品、相册和其他列表内容的编辑人员。日常发布以后台为标准入口：权限、字段校验、媒体、修订和审计都在同一条保存链路中完成。

发布前先确认栏目与模型

列表型栏目包含列表页和多篇详情内容，适合新闻、产品、案例、相册和赛事；单页型栏目只有一篇内容，适合关于、联系和服务说明。

新建内容时先选择内容模型、语言和所属栏目。内容模型必须与栏目绑定的模型一致，否则内容不会进入该栏目的前台列表。主题或模型声明了内容变量后，编辑页会显示对应字段；没有声明的字段不会被保存，也不会凭空出现在前台。

草稿、立即发布与定时发布

建议先保存为草稿，完成正文、图片、SEO 和移动端检查后再发布。置顶只改变同一栏目内的排序，不会绕过草稿状态或未来发布时间。

标题、slug 与公开地址

标题是页面可见内容；slug 是 URL 中稳定、便于引用的标识。slug 留空时系统会自动生成。手工填写时必须以小写英文字母开头，只允许小写字母、数字和连字符，例如 summer-training-2026。

以下值会被直接拒绝，内容不会继续保存：

• 含空格、大写字母、下划线或中文；
• 以数字或连字符开头；
• 在同一栏目和语言下与其他内容重复。

默认详情路径是 /栏目-slug/内容-slug。自定义完整路径只在确有旧站兼容或专题路径需求时使用；站点启用的语言前缀和 .html 后缀由系统统一添加，不要重复写入。内容上线后不要随意修改 slug 或完整路径；必须更换时，应同时添加旧地址到新地址的 301 重定向。

摘要、正文与内容组件

摘要用于列表卡片，也会在没有单独填写 SEO 描述时作为页面描述。正文继续使用 SunEditor 3.3.0 中文编辑器，适合段落、标题、列表、表格、链接、图片和视频。粘贴或输入的 HTML 会经过服务端白名单清洗，不能依赖脚本或未知属性完成页面布局。

内容变量和 blocks 是主题或内容模型提前声明的结构字段：

• 普通内容仍可只用正文编辑器，原有正文不会因为启用结构字段而消失；
• repeater 适合规格、联系人、FAQ、图片列表等同类重复行；
• blocks 适合按顺序混排不同组件，例如文字、图片、信息网格和步骤；
• 每种组件能填写什么由当前主题声明，组件顺序可以在后台调整；
• 未知组件、非法选项或缺失必填字段会明确报错，不会跳过错误后继续保存。

前台的 HTML、响应式布局和组件样式仍由主题负责。编辑器只维护内容和顺序，不允许把一整套页面模板塞进富文本正文。

图片、图集与替代文本

封面图、正文图片和结构字段图片都应从媒体库选择或上传。非装饰图片填写准确的替代文本，描述图片表达的信息，不要堆砌关键词。图集中的每张图片可以分别维护 alt；删除媒体前，系统会检查栏目、正文、结构字段和设置中的引用，仍在使用的文件会阻止删除。

SEO 设置

• SEO 标题：为空时使用内容标题；需要区分同名页面时可补充栏目或业务语境。
• SEO 描述：为空时使用摘要。建议写成一段能够独立说明页面内容的文字，不复制无关关键词。
• SEO 关键词与焦点关键词：用于记录和体检，不代替真实标题、摘要和正文。
• 禁止收录（noindex）：只用于草拟的重复入口、临时页或明确不希望进入搜索结果的页面。正常公开内容不要勾选。
• FAQ：问题与答案必须与页面可见内容一致；填写后才能输出对应结构化数据。

SEO 预览用于检查标题和描述，不代替最终页面验收。保存后应从内容列表打开真实公开地址，核对 canonical、语言路径、标题、描述、分享图和 robots 设置。

多语言内容

同一内容的不同语言版本各自保存标题、slug、摘要、正文、图片说明和 SEO。先完成一个语言版本，再从编辑页的“语言版本”区域新建翻译，系统会把它们归入同一翻译组。

不要把默认语言文案直接当作另一种语言的正式内容。目标语言缺少译文时，前台回退页会标记为不索引；准备公开该语言前，应补齐译文并逐页检查语言前缀、canonical 和 hreflang。

保存、修订与恢复

编辑已有内容时，系统会在保存前自动快照旧版本，并在后台保留最近的历史版本。恢复历史版本前，当前内容也会先被快照，因此仍可再次回退。删除内容会先进入回收站；恢复、彻底删除和批量操作都应在后台完成并确认目标。

每次创建、修改、恢复和删除都会进入审计日志。发现保存失败时，应保留页面提示和请求信息，先修正真实字段或数据问题，不要复制一篇新内容来绕过错误。

发布后的检查

1. 从内容列表打开真实公开地址，确认返回的是目标语言和目标栏目。
2. 检查标题层级、摘要、正文、组件顺序、图片、alt、链接和下载文件。
3. 同时检查桌面和手机宽度，确认没有横向溢出、遮挡或不可操作控件。
4. 查看页面源信息中的 SEO 标题、描述、canonical、robots、Open Graph 和 hreflang。
5. 确认列表页、站内搜索、sitemap、RSS 和 llms.txt 只出现应该公开的内容。
6. 更新既有文章时，确认后台已经生成修订记录；有异常立即停止继续修改并查看日志。

后台发布与程序化发布的边界

当前版本不提供面向第三方的通用内容写入 API。日常编辑、草稿、定时发布、翻译、回收站和修订恢复都应使用后台。

确需程序化导入或发布时，不能直接写数据库，也不能绕过模型字段校验。可靠的集成至少要具备目标唯一性检查、变更预览、并发保护、变更前备份、修订、审计、缓存清理和公开页面读回；不具备完整链路时，应继续使用后台完成发布。