文章草稿、发布与人工审核
创建和继续编辑草稿
- 登录后点击「写文章」,填写标题和 Markdown 正文,再点击「保存草稿」。需要继续编辑时,从「我的文章」的「草稿」筛选重新打开。
- 草稿只对作者本人可见,列表每页显示 20 篇。旧
/drafts地址会跳转到草稿筛选。 - 新草稿页可以手动导入当前浏览器保存的旧草稿。导入后点击「保存草稿」才会写入数据库。编辑时请在离开页面前手动保存。
- 如果在旧标签页保存或删除时遇到版本冲突,按提示重新打开草稿,避免覆盖新版本。
站主发布
- 登录后点击“写文章”,或从“我的文章”的“草稿”筛选继续编辑。
- 填写非空标题与正文,先点击“保存草稿”。
- 没有未保存修改时,“直接发布”按钮可用;确认后文章立即公开。
- 发布成功后进入当前语言的文章详情页,例如
/zh/articles/[slug]。游客可从/zh/articles或/en/articles列表阅读。
普通用户投稿
- 保存草稿后点击“提交人工审核”。当前 AI 审核执行器尚未接入,所有普通用户投稿明确转人工。
- 提交后前往“我的文章”(例如
/zh/my-articles)查看状态与正文。待审核内容只有本人和站主审核入口可查看。 - 被拒绝时可查看原因,点击“复制为新草稿修改”,修改保存后重新投稿。原稿与审核记录保留。
站主审核
- 从管理后台点击“文章审核”,或直接访问
/zh/admin/reviews。 - 打开投稿阅读正文,在审核说明中填写意见。
- “通过并发布”会立即公开当前审核版本;“拒绝投稿”必须填写原因。
- 审核时重新检查站主权限及投稿作者的封禁、发布权限;已审核或已变化的版本不能重复审核。
编辑已发布文章
- 在“我的文章”的“已发布”筛选中点击“编辑文章”,修改标题或 Markdown 正文。
- 站主点击“发布修改”后,原文章地址立即展示新版本。普通作者点击“提交修改审核”,可从“待审核”筛选查看进度。
- 审核期间及拒绝后,访客仍看到上次发布的版本。审核通过后,原文章地址展示新版本。修改被拒绝时,作者可查看原因并在原文章上修改后重新提交。
- 编辑内容在提交时保存。删除已发布文章也会取消该文章待审的修改。
分类和标签
- 站主从「站点管理 → 文章分类管理」创建分类。分类名称最多 32 个字符。
- 作者在编辑器为文章选择一个分类,或留空。可填写最多五个标签,每个最多 32 个字符,用中文或英文逗号分隔。重复标签会合并。
- 分类和标签与标题、正文一起保存到文章版本,并随版本提交审核。待审修改期间,公开页继续显示上一次发布的分类和标签。
- 访客可在文章列表按分类、标签或两者组合筛选,也可点击文章上的分类或标签进入筛选。分页会保留筛选条件。公开筛选项只来自当前已发布的文章版本。
分类和标签名称按原文显示。现阶段分类管理支持创建,照片墙分类与标签及词条合并、停用待接入。
实现与边界
- 复用 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。真实登录浏览器中的按钮交互仍可按上面的步骤验收。