留言板

概述

留言板是前台导航直达的页面（/guestbook），分为两个分区：

分区	合成 post ID	用途
💬 留言	`gb-note`	访客留言、闲聊问候
💡 优化方案	`gb-idea`	对博客的功能建议与优化方案

留言板没有独立的后端接口和数据表——它通过两个合成文章 ID 复用整套评论管道（post_id 直接存 gb-note / gb-idea）：

POST /api/posts/gb-note/comments   → 提交留言
POST /api/posts/gb-idea/comments   → 提交优化方案
GET  /api/posts/gb-note/comments   → 拉取留言列表

所有安全机制（限流、Origin 校验、控制字符清洗、长度上限、重复拦截、审核模式）自动生效，零额外维护成本。

合成 ID 以 gb- 为前缀，不会与真实文章冲突；管理后台「全局评论列表」中 post_id 为 gb-note / gb-idea 的评论即留言板内容，可正常审核 / 删除。

与评论接口完全一致，仅 :id 换成合成 ID：

GET  /api/posts/:id/comments       # :id = gb-note | gb-idea
POST /api/posts/:id/comments

响应： 列表按插入顺序返回（最旧在前），前端倒序展示（最新在最上）。错误码、安全机制、长度上限与评论接口完全相同：

限制	取值
昵称长度	30 字
内容长度	1000 字
每分区条数上限	300 条（与文章评论一致）
频率限制	每 IP 5 条 / 分钟（超出返回 `429`）
重复拦截	同分区同昵称同内容 → `409`
审核模式	后台开启 `moderate_comments` 后新留言默认待审核

行为	说明
分区切换	Tab 切换「留言 / 优化方案」，各自独立列表与计数
快捷提交	在内容框按 `Ctrl + Enter`（macOS `⌘ + Enter`）直接发送
提交反馈	成功清空输入框并显示 ✓；失败保留已输入内容，状态行显示后端透传的具体原因（重复 / 频控 / 来源校验）
表情	内置 Smoji 表情选择器（点击 😊 按钮）
无下划线	列表条目悬停 / 点击均无下划线，与全站样式统一
排序	最新留言显示在最上方
i18n	全部界面文案走 5 语言语言包（`guestbook.*` 键），见国际化

留言板内容不在 RSS / Sitemap 中（不属于真实文章）
静态模式下留言存入浏览器 localStorage（键 qingyu.comments.gb-note / qingyu.comments.gb-idea），仅本机可见、不跨设备共享
分区计数上限与文章评论一致（每分区 300 条；静态模式超过后丢弃最旧一条）