v1.9.2 安全更新

• 修复客户端上传完成接口的路径穿越与本地文件认领问题，阻止读取存储目录外的文件。
• 云直传完成请求绑定服务端签发的上传授权，校验用户、策略、路径和大小，并防止重复完成。
• 本地文件访问增加根目录约束和符号链接防护，覆盖普通下载、签名预览、缩略图与取色；历史越界实体同样无法读取。
• 无用户隔离的默认本地根策略上传仅限管理员；独立挂载继续校验属主，旧上传会话完成时重新验证权限。
• 配置导出和自动备份不再包含 JWT 与本地文件签名密钥；恢复旧备份保留当前实例密钥，新备份使用更严格的文件权限。

建议所有使用文件上传功能的站点尽快升级。升级前未完成的云直传任务需要重新创建上传会话。普通用户不再通过共享默认根策略上传；独立挂载和业务图片上传保持可用。

若配置或备份曾被未授权读取，应在升级后轮换 JWT 和本地文件签名密钥，并审计备份内其他凭据。仅修改管理员密码不能代替签名密钥轮换。本次发布不自动清理历史备份，也不自动轮换现有站点密钥。

---

Anheyu App v1.9.2

🎉 正式版本发布！

📋 构建信息

• 版本: v1.9.2
• Commit: [05a30c3](https://github.com/anzhiyu-c/anheyu-app/commit/05a30c30cae0451a9c91791be1ed9edeb84b8311)
• 构建时间: 2026-11-06T10:02:20Z
• Go 版本: go version go1.25.14 linux/amd64

Changelog

🚀 新功能

• 1b89fcc: feat(comment): 拦截昵称违禁词并同步评论前端修复 (@anzhiyu-c)

🐛 问题修复

• 731b58a: fix(preview): 同步管理员文章预览前端 (@anzhiyu-c)
• 05a30c3: fix(security): confine upload paths and protect backup signing keys (@anzhiyu-c)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_1.9.2_checksums.txt

修复与优化

• 修复站点 SEO 关键词配置未正确输出到页面的问题。
• 修复文章与编辑器中嵌套列表的序号、缩进样式。
• 优化服务端渲染查询缓存，避免请求结束后继续保留查询回收定时器。
• 调整前端启动探测，避免通过首页请求触发额外渲染。
• 限制页面缓存条数和正文容量，停止捕获不可缓存或过大的响应正文。
• 优化图片格式降级，避免重复解码、缩放和水印处理。

验证

前端生产构建、281 项前端测试、相关 Go 模块测试及 GoReleaser 配置检查通过。

v1.9.0 安全更新

本版本修复注册策略绕过、文章与文件对象越权、公开内容敏感字段泄露和 HTML 净化边界问题。建议所有 App / Pro 用户升级。

• 服务端执行关闭注册策略；Pro 第三方登录不能绕过开关创建新账号，已有账号登录保持可用。
• 文章详情、修改、历史及自动保存增加属主/管理员授权；普通作者不能伪造属主或绕过审核。
• 公开文章查询、归档和文档目录遵守审核及下架状态，公开响应不再暴露作者邮箱等管理信息。
• 修复私有文件详情、评论引用及图片路由的签名/直链生成权限，评论上传校验实际图片内容与大小。
• 修复 Mermaid 与存量正文的 HTML 净化旁路，前端图表采用严格模式并净化 SVG。
• 加强验证码单次消费与强度；登录界面不再使用邮箱存在性预检。
• 主题下载和图片代理增加统一公网连接、重定向、类型、超时及体积边界。
• 修复相册标签查询的数据库兼容性，避免公开响应暴露数据库错误。
• Pro 额外修复密码块恢复授权，并在验证密码前检查文章可见性。

升级兼容说明

• 关闭注册也会关闭第三方新账号自动创建；错误验证码需要重新获取。
• 评论上传支持 PNG、JPEG、GIF、WebP，最大 10 MiB。公网图片代理不再返回 SVG。
• 主题下载要求公开 HTTPS/443 地址；图片代理允许公开 HTTP/80、HTTPS/443，拒绝私网和非标准端口。
• 内联事件脚本被移除；没有对应 Markdown 源码的旧 Mermaid 图表可能需要重新保存。
• 自定义客户端不能依赖邮箱预检判断账号存在，也不能依赖公开接口的作者邮箱/内部 ID/审核字段或自报密码块解锁状态。

升级阻止新的越权访问和签名生成，不会自动清理历史账号、上传物或撤销既有永久直链。短期签名在原有效期内仍可能有效；站点所有者应按实际暴露情况审计历史数据和分享链接。本次没有引入会话吊销或刷新令牌轮换，历史泄露的会话凭据需要单独进行失效处理。

验证

两版 Go 1.25.11 全量测试、构建、静态检查及 GoReleaser 配置检查通过；两套前端生产构建和安全回归测试通过。真实浏览器验证确认正常 Mermaid 图表可显示，测试中的脚本未执行。

Anheyu App v1.8.26

🎉 正式版本发布！

📋 构建信息

• 版本: v1.8.26
• Commit: [b11ca56](https://github.com/anzhiyu-c/anheyu-app/commit/b11ca56850c7eafdff9ce2b75f40058260a737ae)
• 构建时间: 2026-10-15T07:52:29Z
• Go 版本: go version go1.25.14 linux/amd64

Changelog

🐛 问题修复

• b11ca56: fix(theme): 修复主题安装路径穿越并限制管理员权限 (@anzhiyu-c)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_1.8.26_checksums.txt

v1.8.25 更新重点

• 修复社区版新建文章首次自动保存后的页面标题：生成文章并将 URL 切换到编辑页时，浏览器标题同步从“新建文章”更新为“编辑文章”，保留站点名称后缀，不改写无此前缀的自定义标题。
• 补充首次自动保存的标题回归，覆盖站点标题后缀和自定义标题边界。本地真实 Chrome 已验证新建页、站内导航、手动保存后编辑和返回首页；补修后的生产构建再次验证首次自动保存时标题、正文、选区和编辑器实例保持正确。

本版延续 App v1.8.24 的文本配置前导零、代码块缩进、公式兼容与历史恢复、首屏可见性、服务恢复和静态错误响应修复，以及缓存管理、Meting/QQ头像、PWA和可选节庆能力。移动Firefox、特定Edge原图、上传/停机及代理现场仍按各自issue验收条件继续跟踪，不能以防御性改进代替原故障确认。

升级说明

使用本Release中与系统架构匹配的安装包，或Docker镜像 anheyu/anheyu-backend:1.8.25。二进制安装包应整体更新后端与随包前端资源；运行Next.js前端仍需Node.js。升级前备份配置和数据库。

SSR主动刷新需要前后端配置一致的 REVALIDATE_TOKEN；未配置时缓存面板显示不可用。节庆能力默认关闭。PWA只缓存通用离线页与公开静态资源，不缓存文章正文、后台、认证/API和个性化响应。

发布流水线已通过；五平台安装包、SHA256 校验和及 linux/amd64、linux/arm64 镜像已核验可获取。

---

Anheyu App v1.8.25

🎉 正式版本发布！

📋 构建信息

• 版本: v1.8.25
• Commit: [e73e148](https://github.com/anzhiyu-c/anheyu-app/commit/e73e148f17a0c75986305214f73f28d3db39a18b)
• 构建时间: 2026-09-23T08:54:35Z
• Go 版本: go version go1.25.14 linux/amd64

Changelog

🐛 问题修复

• e73e148: fix(editor): 更新自动保存标题补修前端 (@anzhiyu-c)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_1.8.25_checksums.txt

v1.8.24 更新重点

• 修复站点名称等文本配置被转换为数字或布尔值的问题，保留前导零与 0。
• 修复多代码块 Tab/Shift-Tab 的选区定位，兼容常见 eqnarray 对齐及旧公式格式；恢复文章历史后及时刷新编辑内容。
• 补齐新建文章页面标题；改进首屏加载层退出，JavaScript 加载失败时不再永久遮挡服务端正文。
• 改进数据库/Redis 连接重试、前端进程有限恢复与恢复期错误响应；修正静态错误响应的压缩头和缓存策略。
• 新增管理员缓存状态及受控清理/重建入口；增加最小 PWA 离线页与手动更新提示，不缓存文章正文、后台、认证和个性化 API。
• 支持可选 Meting 协议，QQ 官方头像不再依赖昵称接口成功；又拍云错误不再透传敏感响应正文。
• 新增默认关闭的节庆按钮与烟花祝福，支持停止、移动端粒子限制和减少动态效果设置。

升级说明

使用本 Release 中与系统架构匹配的安装包，或 Docker 镜像 anheyu/anheyu-backend:1.8.24。二进制安装包请整体更新后端与随包前端资源；运行 Next.js 前端仍需 Node.js。升级前备份配置和数据库。

SSR 主动刷新需要前后端配置一致的 REVALIDATE_TOKEN；未配置时状态面板会显示不可用。新增节庆能力默认关闭。

移动 Firefox、特定 Edge 原图、个别上传/停机及代理现场仍在收集证据；本次防御性改进不代表这些原始故障均已复现解决。相关 issue 按各自验收条件继续跟踪。

---

Anheyu App v1.8.24

🎉 正式版本发布！

📋 构建信息

• 版本: v1.8.24
• Commit: [9e4f136](https://github.com/anzhiyu-c/anheyu-app/commit/9e4f13690e26a2246f9929cf0019818dfc106dc8)
• 构建时间: 2026-09-23T06:20:37Z
• Go 版本: go version go1.25.14 linux/amd64

Changelog

🚀 新功能

• 297ce23: feat(plugin): 完善插件开发平台，支持第三方二次开发 (@anzhiyu-c)
• 08372d3: feat(theme): 新增定时主题切换配置键 (@anzhiyu-c)

🐛 问题修复

• deae061: fix(auth): restore activation and reset email delivery (@anzhiyu-c)
• 9e4f136: fix: 修复共享配置缓存资源响应和服务恢复问题 (@anzhiyu-c)

🔧 其他更新

• b662490: chore(frontend): 同步文章主色与控制台激活图标修复 (@anzhiyu-c)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_1.8.24_checksums.txt

Anheyu App v1.8.23

🎉 正式版本发布！

📋 构建信息

• 版本: v1.8.23
• Commit: [72c865c](https://github.com/anzhiyu-c/anheyu-app/commit/72c865cdf09ac571b58ff2e769063b0269ddfcb3)
• 构建时间: 2026-07-27T09:12:47Z
• Go 版本: go version go1.25.12 linux/amd64

Changelog

🚀 新功能

• 72c865c: feat(image): 支持本地图片首次访问压缩 (@anzhiyu-c)

🐛 问题修复

• a0233a9: fix(article): 完善无标题草稿自动保存后端 (@anzhiyu-c)

✅ 测试相关

• 2bfc94f: test(parser): cover Tiptap formatting sanitization (@anzhiyu-c)

🔧 其他更新

• 3788c7a: chore(frontend): update editor formatting (@anzhiyu-c)
• 6b6d4a0: chore: ignore database files (@Evilrabbit520)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_v1.8.23_checksums.txt

Anheyu App v1.8.22

🎉 正式版本发布！

📋 构建信息

• 版本: v1.8.22
• Commit: [5811794](https://github.com/anzhiyu-c/anheyu-app/commit/58117944adb7ab7d05531e2bf5796f347e6cd025)
• 构建时间: 2026-07-17T08:15:45Z
• Go 版本: go version go1.25.12 linux/amd64

Changelog

🚀 新功能

• 711c678: feat(storage): 存储策略图片样式支持默认样式与自动压缩 (@anzhiyu-c)

🐛 问题修复

• 934c7f5: fix(article): 修复随机文章接口在文章数大于等于2时必定返回500的问题 (#278) (@wulintang)
• 82fa9e8: fix(article): 修复随机文章接口在无已发布文章时误返回500的问题 (@anzhiyu-c)

♻️ 代码重构

• 27d25f7: refactor(music): 音乐 API 地址改为每次动态读取配置 (@anzhiyu-c)

🔧 其他更新

• 5811794: chore(frontend): 更新前端子模块指针 (@anzhiyu-c)
• 2369445: chore(frontend): 更新前端子模块指针（目录滚动对抗修复） (@anzhiyu-c)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_v1.8.22_checksums.txt

Anheyu App v1.8.21

🎉 正式版本发布！

📋 构建信息

• 版本: v1.8.21
• Commit: [3178b51](https://github.com/anzhiyu-c/anheyu-app/commit/3178b51653e504cc2ae8c07d978db0ae9bc15a72)
• 构建时间: 2026-07-06T09:54:23Z
• Go 版本: go version go1.25.11 linux/amd64

Changelog

🐛 问题修复

• 3178b51: fix(service): 规范音乐接口与友链通知地址 (@anzhiyu-c)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_v1.8.21_checksums.txt

Anheyu App v1.8.20

🎉 正式版本发布！

📋 构建信息

• 版本: v1.8.20
• Commit: [cb57cf3](https://github.com/anzhiyu-c/anheyu-app/commit/cb57cf3a3df262bdde05aaeb040a785f601e18ac)
• 构建时间: 2026-06-27T09:29:20Z
• Go 版本: go version go1.25.11 linux/amd64

Changelog

🐛 问题修复

• cb57cf3: fix: preserve mobile video gallery attributes (@anzhiyu-c)

---

📚 相关链接

• 完整更新日志
• 文档
• 问题反馈

完整的 SHA256 校验和：anheyu-app_v1.8.20_checksums.txt

迷你音乐播放器 / 说说 Markdown / 关于页重做 / 编辑器工具栏 / 更新日志改读 GitHub

自 v1.4.0 以来累计 24 次提交；版本号 1.4.0 → 1.5.0 随本提交落库。

前台

• 左下角新增迷你音乐播放器：歌单取自后台 music.player，收起是旋转唱片、展开含进度/音量/播放列表， 支持歌词（当前行高亮自动居中）与顺序/随机/单曲循环三种模式，音量与进度持久化
• 说说支持轻量 Markdown：换行原样保留，支持粗体/斜体/删除线/行内代码/链接/图片，URL 走白名单
• 关于页重做：头像之外新增「此刻状态条 / 数据一览 / 本站地图 / 最近动态时间轴 / 装备缩略」， 其中「此刻在听」跟随左下角播放器实时变化
• AI 播客入口从正文末尾挪到左下角（AI 助手与播放器之上），仅在文章详情页显示
• 更新日志前端 tab 改为读 GitHub Releases/Tags，不再依赖本地 git；两个 tab 居中

后台

• Markdown 编辑器工具栏扩到 18 个按钮（标题/文字样式/块级/插入/列表分组），AI 写作移到工具栏最右
• 编辑器按钮放大到 30px、间距与分隔线重排；编辑器页只保留正文一条滚动条
• 文章表单与 AI 助手面板删除「后端没有该字段」类说明，未开放能力保持禁用

工程

• LRC 解析抽到 lib/lyrics.ts，音乐馆与迷你播放器共用；新增 lyrics / essay-markdown 单元测试
• tests 目录移出版本库（.gitignore 忽略，本地 pnpm test）
• AGENTS.md 补「版本号工作流」：功能提交 push 完再升版本号并打 tag

短代码渲染补齐 / 图片图注 / 音乐播放器 / tabs 分段渲染 等 11 次提交

自 v1.3.0（2026-10-15）以来累计 11 次提交、149 个文件变动；版本号 1.3.0 → 1.4.0 随本提交落库。

文章正文渲染（本轮主线）

• 新增块级短代码渲染器（lib/article-shortcodes-render.ts）：{btn} {linkcard} {tip} :::tabs :::btns :::hidden {hide} :::gallery :::video-gallery 以及 $…$ / $…$ 公式，全部按官方同构 HTML 输出
• 后端保存文章只做 SanitizeHTML、不渲染 Markdown：短代码的结构原先由官方 Tiptap 编辑器生成， 我们用 Markdown 编辑器保存后短代码会以纯文本入库，前台 CSS/增强脚本找不到目标 → 全文样式失效。 本次补的正是「Markdown → 结构」这一层
• tabs 改为分段渲染：先把嵌套块级短代码转 HTML，再按 :::tabs 切分、每页内容单独渲染后拼装。 修掉「按钮组那一页只剩源码」「标签页数量少一页」（内层 ::: 被当成 tabs 结束符导致截断）
• 所有块级替换都跳过围栏代码块；捕获组按偏移量取原文（对原文重跑正则会被代码块里的 ::: 截断）
• 标签页标题不再带 “tab ” 前缀；围栏里的 == 不算分段

前台交互

• 图片图注： 在图片下方显示居中说明（alt 缺省用 title）， 图片组/视频组/链接卡/播放器内的图片跳过（否则会因多包一层导致多图重叠）
• 音乐播放器：{music id=…}{/music} 补成播放器卡片（封面/歌名/歌手/时长/进度/播放）， 新增同源代理 /api/public/music/playlist 取歌名与封面；播放控制沿用已有 enhanceMusic
• 行内短代码支持 color= 参数；{psw} 忽略 color（否则密码明文可见）
• 新增上标下标 {sup}/{sub}；标签页里的 {u}{emp}{wavy}{del} 现在也生效（此前被 .tabs 守卫挡住）
• {tip} 去掉内联 border-bottom（与 CSS 叠成两条下划线）；链接卡收窄到 1/4 宽、纵向排布、标题省略

后台与工程

• 编辑器默认关闭实时预览（长文滚动卡顿的主因），改为底部按钮按需开启
• 后台设置新增评论审核/评论通知/评论专用 SMTP 三组（违禁词、限频、AI 检测、notify_admin、邮件模板）
• /api/pro/f/* 增加同源代理；toSameOriginMediaUrl 白名单同步
• 正文与预览图片加 content-visibility，屏幕外不渲染

验证

• tsc（仅 src）：0 error
• pnpm lint：0 error 0 warning
• pnpm build：exit 0；Compiled successfully in 19.3s；静态页 186/186；BUILD_ID=oiPORAtgegn2QcW9Fq6yL
• 布局/主题回归（真实浏览器 PC 1440×900 + 移动 390×844 × 深浅色，共 16 例）： 主题切换正常、横向溢出 0、破图 0、JS 异常 0、图片组重叠 0 文章页结构：tabs 6 / 按钮组 4 / 隐藏块 3 / 图片组 5 / 音乐 3 / 图注 2 / 链接卡 9 / 提示 14 / 公式 2

已知限制

• 短代码是保存时渲染的：旧文章需要「后台打开 → 保存一次」才会重写正文 HTML； 纯前台增强（{u}/{kbd}/{sup}、图注、音乐）刷新页面即可生效
• Windows 普通用户无法创建符号链接，standalone 打包会 EPERM；本地构建用 NEXT_SKIP_STANDALONE=1 （Linux / 容器 / CI 不要设这个变量）
• 后台设置页三个新分组、音乐播放器的实际播放链路（需要歌单内的歌曲 ID）尚未逐项点选实测

系统设置重构 / 后台批量接真 / AI 写作 / 文章短代码补丁 / 页面管理全屏 等 22 次提交

自 v1.2.0（2026-10-08）以来累计 22 次提交、251 个文件（版本号 1.2.0 → 1.3.0 的改动随上一提交落库，

本条只补发布说明与 tag 锚点）。

【后台】系统设置重构为官方分组结构（字段 298→399）；页面批量接真接口（缓存管理 / 配置备份 / 插件管理 /

知识库 / 图片样式 / 会员与工单 / SEO 推送与体检 / 社区问答）；仪表盘重排（统计区 CSS 多列瀑布流、修趋势柱

不渲染与卡片重叠）；文章编辑页右栏重构并修掉左栏大片空白；AI 生成摘要 + 定时发布 + 文档模式入口；

AI 写作（SSE 流式）与 AI 设置面板；友链导入导出与排序；文章/评论导入导出等。

【前台】社区问答前后台（/questions 与 /admin/community-qa）；评论图片四件套（1/4 缩略 + 点击放大 +

多图横排 + 左右切换）与评论区改造（蓝色边框 + 气泡尾巴 + 大肥鱼挂件）；评论 Markdown 预览；

侧边栏「公告」卡；移动端侧边栏改为正文下方整块显示；文件管理上传入口；原生 confirm 全量替换为站内弹窗；

深色模式原生控件（color-scheme）；404 去配图 + 加「返回仪表盘」；loading.tsx 全部删除。

【修复】文章正文写入空白（后端不渲染 Markdown，前端渲染后同时提交 content_html）；分类/标签新增 405、

改名/删除 404；文件删除失败（JSON body）；评论传图不显示（/needcache 前缀补后端源）；后台 404 不再套前台

外壳；文章短代码前端补丁（{btn} layout=block → 容器 + 左中右；{tip} theme/position/delay 补类名）与 tip

触发分层（click 档悬停不弹、点击才弹）；iconfont 豆腐块（真因是文章 HTML 的 <i> 不带 anzhiyufont 类）；

文章正文按钮样式对齐官方；首字下沉不再套到自定义页面；页面管理弹窗改全屏并只留 Markdown 编辑框；

访问日志卡改「左饼图 + 右前五」与图表多色令牌；友链「排序」弹窗删除；用户菜单未登录态图标圆角统一。

【注意】所有写操作（保存/发布/审核/作答/点赞/上传/删除/导入导出）与页面管理的保存链路从未对线上实测，

第一次使用请留意；仪表盘访问日志卡为 max-content 宽度，其右侧暂留白（砌体布局未采用）。

定时主题与软导航进度条、前台自动刷新；友链导入导出接入

package.json 由 1.1.0 提升为 1.2.0。本次是向后兼容的功能新增（主题跟随站点配置、前台自动刷新、

后台友链批量导入导出），按语义化版本取 minor。

内容：

• 主题：支持站点配置 DEFAULT_THEME_MODE = "auto"，按 THEME_LIGHT_START_TIME / THEME_DARK_START_TIME 定时切换（口径对齐官方 theme-schedule）；手动切主题即解除托管；音乐馆不再写死深色，深浅色全部跟随配置。
• 体验：软导航顶部进度条（nextjs-toploader）、后台保存设置后同源广播 + 前台定时/唤醒兜底刷新、 loading.tsx 从根段挪进各路由组并给不同分组各自的后备 UI。
• 后台：友链管理的「分类标签 / 导入 / 导出」三个原先没有 onClick 的按钮接入 API （分类标签 CRUD、导入导出同构 JSON），配套 4 个新同源路由与 8 个 API 函数。
• 修复：/posts 分页链接指回首页；前台侧边栏 data-collapsed 的 hydration 不匹配。

验证：pnpm lint 0 问题；pnpm build 通过（TypeScript、112/112 页面、standalone 产物）；

PC 1440×900 / 移动 390×844 × 浅色/深色 × 6 个页面共 24 项布局巡检无横向溢出、无控制台报错。

详见 d63f3a1。

音乐馆接入播放接口

package.json 由 1.0.0 提升为 1.1.0。本次是向后兼容的功能新增（音乐馆播放能力、

后台列表移动端卡片式），按语义化版本取 minor。

内容：音乐馆接入后端歌单 + Meting 音源解析、样式改用参照项目并换用站点 header；

后台五个列表改移动端卡片式；正文字体英文改 Georgia 并修掉字体变量失效 bug。

验证：pnpm lint 0 问题，pnpm build 通过（100/100 页面），UI 巡检 18 项全通过。详见 aa83b39。

评论引用/回复、头像口径统一、后台打赏管理与前端版本号

评论区

• 回复：点某条评论的「回复」把主输入框切到回复态（引用提示条 + 自动滚动聚焦 + 目标评论高亮）， 发送时带 parent_id / reply_to_id；回复子评论时 parent_id 仍是顶层父评论（保持两级结构）。
• 引用：新增 comment-form-set-quote 事件约定（src/hooks/use-comment-quote.ts，即刻页与朋友圈页共用）。 卡片右下角「评论」按钮把该条内容摘要（前 50 字）送进页面底部评论区并滚动过去，提交时拼成 > 引用 前置到正文 —— 让所有读者都能看出这条评论说的是哪一条内容。 即刻页 / 朋友圈页各共用一个 target_path（/essay、/fcircle），与线上 CommentSection 的做法一致； 朋友圈卡片评论按钮是线上没有的，按需求新增。
• 引用块样式：globals.css 补 .comment-content blockquote（主题色淡染底 + 3px 左侧竖线 + 引号装饰）。 之前只给 .article-body 写了引用样式，评论区的引用渲染出来跟正文糊在一起。

头像

• 新增 src/lib/avatar.ts（resolveCommentAvatar）：统一按站点配置 GRAVATAR_URL + DEFAULT_GRAVATAR_TYPE 拼， 邮箱没有自定义头像时由 d= 生成兜底头像，地址永远有值（不再出现「头像啥也不显示」）。
• (blog) layout 用 GravatarProvider 下发配置 —— 复用 layout 已经取到的 site-config， 客户端不再重复请求，也不会出现「先渲染错头像再换一次」的闪动。
• 替换 5 处各写各的实现（评论区、侧边栏「最近评论」、最近评论页、用户中心、首页评论时间轴）。 原先它们读构建期 NEXT_PUBLIC_GRAVATAR_URL 且写死 d=identicon / d=mp，改后台设置必须重新构建才生效。
• 后端直给的 avatar_url 若只是 Gravatar 链接（只含邮箱哈希），按站点配置重建：后端写死 d=identicon， 否则同一个人会在同一页出现两个不同头像（父评论走前端拼、子评论用后端给的）。

后台

• 打赏管理页（PRO）：统计磁贴 + 状态筛选 + 列表（多选批量删除）+ 新增/编辑弹窗 + 分页。
• 新增同源代理 /api/admin/donations（列表/新增）、/api/admin/donations/[id]（单条/更新/删除）、 /api/admin/donations/total（总额；静态段优先于同级 [id]）。
• app-sidebar 底部显示前端版本号（收起为图标模式时隐藏）。

版本号

• package.json 0.1.0 → 1.0.0（首个正式版基线）。与后端程序版本（/api/version）和站点配置里的 APP_VERSION 无关，仅代表本前端项目自身。
• next.config.ts 从 package.json 读取并注入 env.APP_VERSION；src/lib/version.ts 作为单一访问点。 改版本只需改 package.json 一处，生产环境重新构建生效。

配置修正（由本地对照源码暴露）

• eslint.config.mjs 与 tsconfig.json 排除 scripts/**：该目录已被 .gitignore 忽略（本地探测脚本与 拉下来对照的官方源码），却仍参与 lint 与类型检查，会把官方源码报成项目错误 （83 个 lint error + 1 个 build 类型错误）。

验证

• pnpm lint 0 问题；pnpm build 通过（TypeScript 无错误、standalone 产物正常，/admin/* 一并编译）。
• 评论引用/回复：PC 1440×900 与移动端 390×844 下点卡片「评论」→ 引用预览 → 自动聚焦 → 滚到评论区； 提交载荷经 CDP 拦截核对（target_path、> 引用 前缀、parent_id/reply_to_id），未向线上写入数据。
• 即刻页在引用抽取逻辑抽成共用 hook 后做了回归，逐字一致。
• 头像：5 个位置共 25 个头像全部为统一口径且加载成功。
• 打赏管理：临时预览页 + CDP 模拟接口，20 次调用覆盖统计/筛选/分页/新增/编辑/删除/批量删除。
• 版本号：确认取自 package.json（v0.1.0 → v1.0.0）；前台页脚展示按要求撤掉，改为后台侧边栏。