文章草稿、发布与人工审核

创建和继续编辑草稿

  1. 登录后点击「写文章」,填写标题和 Markdown 正文,再点击「保存草稿」。需要继续编辑时,从「我的文章」的「草稿」筛选重新打开。
  2. 草稿只对作者本人可见,列表每页显示 20 篇。旧 /drafts 地址会跳转到草稿筛选。
  3. 新草稿页可以手动导入当前浏览器保存的旧草稿。导入后点击「保存草稿」才会写入数据库。编辑时请在离开页面前手动保存。
  4. 如果在旧标签页保存或删除时遇到版本冲突,按提示重新打开草稿,避免覆盖新版本。

站主发布

  1. 登录后点击“写文章”,或从“我的文章”的“草稿”筛选继续编辑。
  2. 填写非空标题与正文,先点击“保存草稿”。
  3. 没有未保存修改时,“直接发布”按钮可用;确认后文章立即公开。
  4. 发布成功后进入当前语言的文章详情页,例如 /zh/articles/[slug]。游客可从 /zh/articles 或 /en/articles 列表阅读。

普通用户投稿

  1. 保存草稿后点击“提交人工审核”。当前 AI 审核执行器尚未接入,所有普通用户投稿明确转人工。
  2. 提交后前往“我的文章”(例如 /zh/my-articles)查看状态与正文。待审核内容只有本人和站主审核入口可查看。
  3. 被拒绝时可查看原因,点击“复制为新草稿修改”,修改保存后重新投稿。原稿与审核记录保留。

站主审核

  1. 从管理后台点击“文章审核”,或直接访问 /zh/admin/reviews。
  2. 打开投稿阅读正文,在审核说明中填写意见。
  3. “通过并发布”会立即公开当前审核版本;“拒绝投稿”必须填写原因。
  4. 审核时重新检查站主权限及投稿作者的封禁、发布权限;已审核或已变化的版本不能重复审核。

编辑已发布文章

  1. 在“我的文章”的“已发布”筛选中点击“编辑文章”,修改标题或 Markdown 正文。
  2. 站主点击“发布修改”后,原文章地址立即展示新版本。普通作者点击“提交修改审核”,可从“待审核”筛选查看进度。
  3. 审核期间及拒绝后,访客仍看到上次发布的版本。审核通过后,原文章地址展示新版本。修改被拒绝时,作者可查看原因并在原文章上修改后重新提交。
  4. 编辑内容在提交时保存。删除已发布文章也会取消该文章待审的修改。

分类和标签

  1. 站主从「站点管理 → 文章分类管理」创建分类。分类名称最多 32 个字符。
  2. 作者在编辑器为文章选择一个分类,或留空。可填写最多五个标签,每个最多 32 个字符,用中文或英文逗号分隔。重复标签会合并。
  3. 分类和标签与标题、正文一起保存到文章版本,并随版本提交审核。待审修改期间,公开页继续显示上一次发布的分类和标签。
  4. 访客可在文章列表按分类、标签或两者组合筛选,也可点击文章上的分类或标签进入筛选。分页会保留筛选条件。公开筛选项只来自当前已发布的文章版本。

分类和标签名称按原文显示。现阶段分类管理支持创建,照片墙分类与标签及词条合并、停用待接入。

实现与边界

  • 复用 Content、ContentRevision、ModerationReview、AuditLog,无新增迁移。
  • 草稿提交、审核状态、发布版本指针及记录在数据库事务中写入;操作按内容行串行化并重新检查版本状态。
  • 普通用户不能审核,不能替别人投稿;自己的草稿状态由服务端读取,客户端不能指定“免审”。
  • 公开列表、详情和标题元数据仅使用 publishedVersion 指向的 PUBLISHED 版本,不读取最新私有草稿替代它。
  • 正文使用 Markdown 渲染并跳过原始 HTML。通过编辑器上传的图片随文章版本审核和公开。配置与使用步骤见文章图片上传。
  • 发布后可在“我的文章”的“已发布”筛选中删除自己的文章;确认后退出公开展示和个人列表,数据库保留内容和审核记录,暂无恢复入口。首次投稿被拒绝时可通过复制为新草稿修改。
  • 列表每页 20 篇,提供上一页和下一页。发布时间取发布审核记录,显示 UTC+8。
  • 账号被封禁后不能新投稿或通过审核;已发布历史内容暂保留,后续下架功能单独处理。

验证

pnpm test
pnpm test:drafts
pnpm test:articles
pnpm typecheck
pnpm build

test:drafts 单独运行草稿数据库集成测试。test:articles 同时运行草稿和发布审核数据库集成测试。两者都需要已配置的本地数据库,使用临时测试用户与内容,最后事务回滚。test:articles 覆盖匿名、越权、封禁、显式禁止、版本冲突、重复操作、拒绝重投、公开版本隔离与审核记录。

已验证类型检查、生产构建、9 项规则测试、3 项数据库集成测试,以及匿名访问页面和不存在文章的 404。真实登录浏览器中的按钮交互仍可按上面的步骤验收。