zqlit/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,000 Commits 1 Branch 2 Tags
ca2fb7163ddc1729e9a983e5b2069e54d45362a6
Commit Graph
1000 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
zqlit ca2fb7163d perf: 开启 Workers Cache 缓存 favicon，并给动态接口兜底 no-store 
背景：favicon 此前只有 Cache-Control: max-age（仅浏览器缓存），
CF 边缘不缓存 Worker 响应 → 每次请求都进 Worker → 第一句就是 KV.get。
友圈页按友链数放大，KV 读量被显著放大。

★ 关键纠错：zone 级 Cache Rules 对 Worker 响应**完全无效**。
原因是 Worker 位于 zone 缓存之前（"Workers sits in front of cache"），
且 Worker 直接生成响应时不发 fetch 子请求，cache status 只能是 none/unknown。
查证 CF 官方文档后确认，正确方案是 [cache] enabled = true（Workers Cache，
2026-07 上线，需 wrangler >= 4.69）。

改动：
- wrangler.toml: 新增 [cache] enabled = true；compatibility_date 提到 2026-07-24
- package.json: wrangler ^3.99 → ^4.147，workers-types ^4 → ^5（peer 要求）
- index.ts: 抽出 dispatchRequest；新增 ensureCachePolicy 兜底
  ★ 这一步是必须的：Workers Cache 遵循 RFC 9111 含**启发式缓存**，
    没带 Cache-Control 的响应也可能被缓存。实测 /api/v2/comments 开启后
    立刻被缓存（HIT, age:29）→ 用户发的新评论看不见。
    现在白名单式兜底：已显式声明可缓存的（favicon 的 s-maxage）保留，
    其余一律补 no-store。

验证（中转机实测，已清空 zone 的无效 cache rule）：
- /api/favicon      → MISS → HIT，age 递增（Worker 不再执行，KV 读归零）
- /api/v2/comments  → BYPASS ×3，cache-control: no-store
- /api/v2/conf      → BYPASS，no-store
- /api/v2/healthz   → BYPASS，no-store
 2026-10-06 13:28:56 +08:00
zqlit d2f1d176af docs: 修正证书实况表（实测校准） 
- t-t.live 组：文档记的 Oct 9 是旧快照，实测线上已续期为
  Let's Encrypt Sep 28 → Dec 27（三个子域共用）
- usj.cc 组：确认 Dec 7 2026（LiteSSL / TrustAsia）
- 补充签发方列与探测方法说明
 2026-10-06 13:05:55 +08:00
zqlit 42f28f0a39 content: 恢复《流量卡还真得选御三家😂》文章 
该文被 4215e081 删除，但线上评论库（24 条）与 pages 记录均未动，
仅缺文章文件。补回文章后 slug=20260724101237 与 page_key 精确对应，
评论自动挂上，无需任何数据迁移。

从 4215e081^ 恢复整个目录（index.md + 2 张配图）。
 2026-10-06 13:03:43 +08:00
zqlit c2f890a0f7 feat: favicon 边缘缓存 + CDN 整站刷新兜底 + 评论孤儿修复归档 
- blog-admin tools.ts: favicon 响应加 s-maxage/CDN-Cache-Control，
  让 CF 边缘可缓存，边缘命中即不进 Worker，KV 读取量大幅下降
- scripts/refresh_cdn.js: 裸域名自动补尾斜杠（多吉云 rtype=path 是目录刷新，
  https://usj.cc 只刷首页，https://usj.cc/ 才是全站），并打印刷新清单
- 新增文档：评论孤儿修复方案、函数版证书管家方案、诊断报告
 2026-10-06 12:46:05 +08:00
zqlit d273330e10 merge: 合入编辑器发布的两笔提交（2026-10-05 22:00~22:06 测试文章增删） 2026-10-05 22:54:09 +08:00
zqlit cfadba6007 fix(后台文案): 删除确认框措辞纠正 
旧文案「…不进 git，也不影响版本历史，但前台会立刻少一篇」有两处不准：
- 「前台会立刻少一篇」不成立 —— DELETE 只把目录 move 到服务器回收目录
  (/srv/editor-trash)，不 commit 不 push，线上要等下次「发布」才少一篇；
- 「不影响版本历史」也不严谨 —— 下次发布时这次删除会作为 D 一起进历史。

新文案：「文件会移到服务器上的回收目录（在仓库外，不进 git）：
后台立刻少一篇，线上要等你下次点「发布」后才会少。确定删除？」
 2026-10-05 22:53:30 +08:00
blog-editor 870ce7ad31 编辑: 2026-10-05 14:06 2026-10-05 14:06:52 +00:00
blog-editor 237c8f5d4c 编辑: 2026-10-05 14:02 2026-10-05 14:02:19 +00:00
zqlit 5e9d328841 fix(排序): 同日文章 date 补全时分秒 + EdgeOne 部署重试增强 
现象：小乖同一天发的第二篇排到了第一篇后面。

根因：front matter 的 date 只写到年月日（写入侧只收得到日期），
同一天多篇的时间戳完全并列 → 排序退化成比标题，前台/后台都错。

改动：
- 数据（6 篇）：用目录名/slug 里的时间戳把 date 补全为
  'YYYY-MM-DDTHH:MM:SS+08:00'，slug 即写作时刻。每篇仅 1 行 diff。
  2026-10-05 两篇（必须）、2026-06-02 / 06-03 四篇（同一 bug 的历史遗留）。
- 写入侧根治
  - editor-api/src/posts.mjs：新建时「只到天」补北京时间此刻；
    保存时「同日保真」——没换日子则原有时分秒一字符不动。
  - write-server/src/lib/posts.ts：parseDate 按 Asia/Shanghai 归日，
    列表同天排序不再受 UTC 时区漂移影响。
- 回归测试：新增 editor-api/test/date-time.mjs（8 项，自带一次性临时仓库）。
- .cnb.yml：EdgeOne stage 重试 3 次/20s → 5 次/30s。
  构建节点到 api.edgeone.ai 偶发 15s 超时会被 CLI 误报
  「Invalid EDGEONE_PAGES_API_TOKEN」，纯网络抖动，令牌没坏。
- .gitignore：忽略 *.zip 与 .edgeone/（误留的 blog.zip 达 361MB）。
 2026-10-05 21:54:03 +08:00
blog-editor 5d16c8c8d6 编辑: 2026-10-05 13:31 2026-10-05 13:31:26 +00:00
zqlit 6b8fba827b fix(评论): 徽章排序兜底 —— 系统徽章(博主/小编)恒定排在最前 
现象：普通用户的 badge_name 徽章（如「小编」）会排在
友链/友圈/官职之后，与「博主」的位置不一致（管理员路径下系统徽章
在 .atk-badge-wrap 里、会被提前，普通用户路径则可能被追加到末尾）。

修法：拆掉 .atk-badge-wrap 后做一次确定性重排，按
系统徽章 > 置顶 > 头衔 > 友链 > 友圈 > 官职 的优先级依序 append 回
昵称（DocumentFragment 移动保序）。不管 Artalk 把系统徽章渲染在哪
都会归位，以后新徽章只要补进 PRIO 数组即可。

本地验证：CDP 注入 fetch 拦截给小十的评论加 badge_name=小编，
完整复现截图场景 → 顺序 小编 友链 友圈 司户参军 ✅
 2026-10-05 18:21:00 +08:00
zqlit c1f9a0c6f0 fix(ci): 全量刷新判定改为「非纯内容改动即全量」+ 刷新分批（又拍云 50/次） 
上一版用「themes/layouts/assets 等 dirs 白名单」判全局，实测被绕过：
build 2 的 diff 只有 scripts/purge_list.js（主题改动在上一个 commit），
判成非全局 → 只刷了 10 条固定入口页 → 文章页仍引用已被 --delete 删掉的
旧 page-only.min.1e47477b…（靠 CDN 缓存才 200，缓存一过期即 404）。

改法：
- 判定反转：diff 只含 content/** 才算「纯内容改动」（走精细刷新），
  其它一律全量刷 public 下所有 .html。
- 拿不到基线时：push 事件按全量（宁多刷不漏刷），定时任务只刷固定入口页。
- 输出一行 stderr 诊断（base/变更数/纯内容/全量/清单条数）便于事后核对。
- .cnb.yml：清单按 50 条/批 + 批间 6s 调用 upx purge（又拍云限制
  单次 ≤50、每分钟 ≤600），并逐批打日志；不再一次性提交 1300+ 条。
 2026-10-05 17:57:51 +08:00
zqlit 5a50df6e23 fix(ci): 主题/layouts/assets 等全局改动时，purge 清单追加全站 HTML 
问题：模板用 resources.Fingerprint 生成带 hash 的 JS/CSS 文件名，而 upx sync
带 --delete（远端不存在的文件会被删）。只改主题、不动 content/*.md 时，
purge_list 只输出固定入口页 + content 页 → 文章页的 HTML 仍留在 CDN（TTL 8 天），
里面引用的是**已被删掉的旧指纹 JS** → 评论区/交互断链（实测文章页仍引用
page-only.min.1e47477b…，该文件本轮已不在源站，只是还在 CDN 缓存里）。

修法：diff 命中 themes/ layouts/ assets/ static/ data/ archetypes/ 或
hugo.toml/config.* 时，walk public/ 把所有 .html 加入刷新清单
（本机验证 1336/1336 覆盖）。
 2026-10-05 17:39:59 +08:00
zqlit 79c9f2371c feat(评论): 最近表情改为分组 tab + 提交后面板收起 + 小编徽章配色 + 走心评论 20 条 
- emoticon-recent.js: 「最近使用」从面板顶部独立栏重构为分组切换条最左侧的
  同构 tab（data-index="recent"），无记录时整个 tab 隐藏；复用 Artalk 原生
  .atk-grp[data-type=image] 网格样式，零自定义布局。
- artalk.js:
  · 新建评论成功（res.ok）后，对当前激活的插件按钮派发 click()，收起仍展开的
    表情面板（Artalk 上游只 reset 输入内容、不关面板），内部 openedPlug 状态同步复位。
  · 徽章处理末尾把徽章文字镜像到 data-badge 属性，供 CSS 按名字配色。
- artalk.html: 新增 .atk-badge[data-badge="小编"] 玫红实底规则（含暗色模式），
  特异性高于博主规则，两者互不覆盖。
- featured-comments.html: 走心评论 limit 8 → 20（后端上限）。
- main.css: 移除旧 .atk-recent-emoticons 相关样式。
 2026-10-05 17:34:18 +08:00
zqlit 1b2e3d46f8 fix(友链): 修复申请「通过不了/删不掉」；feat(评论): 通知按文章作者分派 
## 友链自助申请（通过不了 / 删除不掉）
根因：admin.js 全局事件委托把 data-id 一律 parseInt，
而友链申请 id 是字符串（lamus5uptzcdam）→ NaN → JSON 成 {"id":null}
→ 后端 String(null||'') 为空 → 400 id and action required，查看/通过/拒绝全失效。
引入于 a74b3c71（10-04 归档 rss-robot 时；后台只有友链申请用字符串 id）。

- admin.js：纯数字才转数字，其余原样（评论/用户/站点按钮请求完全不变）
- admin.js：待审卡片加「删除」按钮
- links.ts：新增 action:'delete'（不受「已处理过」限制，处理过的也能删）
- links.ts：approve 改为先写友链再改状态 + URL 去重（重试幂等）
- links.ts：已是目标状态时返回 {ok:true,already:true}，不再 409
  —— 否则网络抖动后重试会让用户以为「怎么点都通不过」

## 评论通知按文章作者分派
编辑角色（女朋友）写的文章，评论通知改发给她，不再打扰博主。
不需要「文章→作者」同步表：Hugo 模板把 author_id 注入 artalkConfig，
artalk.js 已有的 fetch 拦截器把它塞进评论提交体，Worker 直接读。

- artalk.html：artalkConfig 增 pageAuthorId（老文章 0）
- artalk.js：提交评论时带上 author_id（读 window.artalkConfig，防 PJAX 过期）
- comments.ts：createComment 解析 author_id 并传给通知
- mail.ts：收件人改为「这篇文章的主人」——作者非管理员且开了邮件则发给他，
  否则回退博主；已被回复通知过 / 作者本人评论自己的文章都不重复发
- mail.ts：增一行收件人决策日志，便于线上排查

验证：Worker tsc 通过；Hugo 构建通过；artalk.js 语法通过；
友链本地跑通（通过 200 → 再通过 already:true → 友链仅 1 条 → 删除 200 → 再删 404）。
 2026-10-05 16:44:15 +08:00
zqlit 68416366eb fix(editor-api): 身份判定改为会话优先，防止配置漂移静默提权 
identify() 原来「令牌优先」：令牌对得上就用 X-Editor-* 头的身份，没有头时默认 admin。
国内线路的 nginx 目前不注入令牌，但一旦配置回滚到「注入令牌」的旧版本，编辑的请求
会命中令牌分支 → 静默获得管理员权限（看到全部文章、能改别人的、能全量发布）。

改为「会话（真实的人）优先于共享令牌（服务身份）」，把边界写死在代码里而不是靠配置。
新增断言：编辑会话 + 管理员令牌头 → 仍按编辑身份。role-perm.mjs 47/47
 2026-10-05 14:41:02 +08:00
zqlit d899cd793b feat(编辑角色): editor 只能写并发布自己的文章 
- D1 users 加 role 列（''/editor/admin），与 is_admin 成对写入
- Worker routes/editor.ts 放行 admin+editor，反代注入 X-Editor-Uid/User/Role（昵称 encodeURIComponent）
- editor-api 引入 identify()：身份取自注入头或本机会话；文章归属记 frontmatter author_id
- 编辑发布改精确 pathspec（只提交自己文章目录），管理员保持全量；空 pathspec 显式拦截
- 国内机直连登录改为转发 CF /user/access_token 校验，CF 不可达回退本机管理员
- handoff 签名覆盖身份（ts/uid/name/role），防编辑一键跳转变管理员
- admin.js：编辑只渲染「文章编辑」tab、作者框只读；用户管理加角色下拉 + 新建用户
 2026-10-05 14:34:56 +08:00
zqlit 66c27c7b62 fix(ci): CDN 刷新清单改为「固定入口页 + 本次改动过的内容页」 
又拍云对 HTML 的 max-age 是 8 天，而流水线只刷固定白名单（/ sitemap rss
archives posts comment links）。不在清单里的页面改动后，源站已更新、CDN 仍发
旧副本——本次 about.html 就卡住了（源站 47935B 含新板块，CDN 仍是 41454B）。

- 新增 scripts/purge_list.js：读 git diff 找出改动的 content/*.md，按
  slug/url/目录名/文件名推输出页，并校验 public/ 下确实存在才加入
- .cnb.yml 刷新步骤改用它，脚本失败时兜底只刷首页
- git diff 必须带 -z / core.quotepath=false，否则非 ASCII 路径会被转义引号包裹，
  校验必然失败（本次踩过）
 2026-10-05 12:19:28 +08:00
blog-editor ec8d1c45f2 编辑: 2026-10-05 04:09 2026-10-05 04:09:17 +00:00
zqlit 1b71fba413 feat: 走心评论（精选评论）+ 移动端评论框底栏布局修复 
- 底栏：≤480px 压缩按钮内边距，SE 等小屏单行放下；换行时按钮组右对齐
- Worker：comments 加 is_featured；PUT /comments/:id 支持切换；新增公开接口
  GET /api/v2/featured/comments（排除悄悄话/待审/已删，服务端渲染 markdown）
- 前端：评论区注入「精选」按钮（回复右侧，仅管理员可见）
- 关于页：走心评论板块（标题寄语通栏 + 卡片瀑布流），排在热力图上方
 2026-10-05 12:08:33 +08:00
zqlit 3d7d7bd396 fix(theme): pageTitle 加 safeJS —— 修 Go 模板 JS 上下文二次转义导致标题天生带引号 
在 <script> 里 {{ .Title | jsonify }} 会被 Go 模板按 JS 上下文再转义一层：
标题「留言」渲染成 pageTitle: "\"留言\""，前端每次上报 page_title 都自带
一对引号 —— 评论入库、邮件标题因此出现《"留言"》，历史上 pages 表一堆标题带
引号（17 行）也是这个根因。jsonify 后用 safeJS 标明这就是最终 JS 字面量，
`</` 仍按惯例转义兜底；已验证中文/emoji 标题字面量均合法
 2026-10-05 11:01:20 +08:00
zqlit f7e0596218 fix(comments): 悄悄话允许管理员发表 + 邮件标题优先用实时标题；返回顶部改 UIkit 同款动画 
- comments.ts: 去掉旧匿名语义遗留的 !admin 前置条件 —— 博主（登录态）发的悄悄话
  以前被忽略标志、入库 is_anonymous=0 变成公开评论
- 邮件标题改用本次请求带来的 page_title（前端 .Title 总是最新），D1 pages.title
  仅兜底：存量脏数据 /comment.html 曾存成字面量 "留言"，邮件渲染出《"留言"》
  （线上已清洗 17 行带引号标题 + 3 篇被污染成「留言」的文章页标题）
- 返回顶部：CSS 挂类+scrollTo 同帧执行会被浏览器按旧计算样式瞬移（"一下子就上去"），
  改 UIkit scrollIntoView 同款 rAF + 余弦 ease-in-out + 40*dist^0.375 时长（上限 1.2s），
  滚轮/触摸打断、reduced-motion 瞬移；main.css 移除 .css-smooth-scroll
 2026-10-05 10:52:13 +08:00
zqlit 4fa592c11c feat(comments): 匿名评论升级为「悄悄话」——只藏内容不藏身份；fix: PJAX 瞬断自动重试 
- 悄悄话：头像/昵称/头衔/等级/IP归属照常显示，仅内容对非管理员请求剥空
  （F12/网络面板拿不到原文），博主后台/登录态/邮件看全文
- 开关挪进底栏 .atk-bottom-left、表情/预览按钮右边，移动端不挤；
  回复悄悄话勾不勾随自己（去掉自动勾选）
- 前端识别：服务端剥空后 .atk-content 为空即悄悄话（空评论会被后端拒绝、
  纯表情评论有 img 不误判），无需解析 API
- 邮件页面标题书名号《》保留（按用户要求）
- PJAX 偶发「连不上服务器」：GET /api/v2 网络错误或 5xx 静默重试 2 次
  （700ms/1800ms 退避），POST 不重试，被 abort 的请求不续命
 2026-10-05 10:05:21 +08:00
zqlit 215929a67f feat(comments): 匿名评论 + 表情最近使用；fix: 自动填充聚焦提示 & 邮件模板回退原版 & 返回顶部改 CSS 动画 
- 匿名评论：comments.is_anonymous 列；对外昵称/头像/网址/徽标/等级/IP归属全部脱敏，
  真实身份留 users 表（回复通知照发、autofill 不受污染）；邮件昵称也用「匿名」防泄露
- 表情包最近使用：面板顶部「最近」栏，localStorage 记录 8 个，零侵入复用 Artalk 插入逻辑
- 匿名开关插在 textarea 与底栏之间独立一行，不挤移动端底栏
- 自动填充：提示改 focusin 触发（原 input+sessionStorage 一次性门导致永不触发）；
  已填昵称/网址时不覆盖并弹提示
- 邮件模板 UI 回退原版深色气泡设计，保留表情内联尺寸/主题文案等逻辑修复
- 返回顶部：rAF 自绘改 CSS scroll-behavior（滚动期临时挂类），修移动端掉帧
 2026-10-05 09:02:23 +08:00
zqlit 090262d278 fix(autofill): 编辑器容器选择器改为 .atk-main-editor，线上 Artalk DOM 里没有 .atk-editor，委托匹配不到导致功能空转 2026-10-05 07:46:08 +08:00
zqlit bcfa229105 邮件模板微信化 + 评论老友自动填充 + CF 后台国内线路一键跳 
- 邮件模板重做成微信聊天式：灰底、自己评论绿色气泡靠右、对方白色气泡靠左、
  40px 圆角方头像（weavatar，邮箱 md5 不外泄）、时间居中、#07C160 主按钮；
  布局全嵌套表格（Outlook 稳），表情内联 max-height:28px（修掉「表情太大」）、
  配图限宽 100%；管理员主题从「新的评论待审」改成「您有一个新的评论」
- 老友自动填充：新增 /comments/lookup（只回昵称+网址，绝不含邮箱；IP 限速
  30 次/10 分钟）+ 主题 comment-autofill 模块（填昵称弹提示、填邮箱自动带出
  上次的昵称/网址，事件委托不怕 Artalk 重建编辑器）
- CF 后台新增「国内线路」一键跳：/editor/handoff 用共享令牌对时间戳 HMAC
  签名 → editor-api /admin/handoff 验签发会话 Cookie（2 分钟有效、防重放），
  晚高峰丢包时直达国内机后台免重新登录
 2026-10-05 07:36:26 +08:00
zqlit 18a4882577 登录页去掉订阅口令：订阅接口认后台会话 + editor-api 反代 
- Worker 侧 requireAuth 新增两条通道：① Authorization 管理员会话（CF 版后台
  登录后订阅模块免口令）；② X-Editor-Token 共享令牌（服务端到服务端）。
  原 ?token=/Cookie 通道保留，RSS 阅读器与友圈页不受影响
- editor-api 新增订阅反代（/api/feeds|links|link-apply）：国内机后台的
  订阅源/友链由本机带共享令牌去 CF 取，前端不再持有任何口令；GET 幂等重试
  抗跨境抖动
- 登录页只留账号+密码（CF 版与国内机版统一）；国内机后台侧栏新增订阅中心
  入口；RSS_TOKEN / LS_RSS 前端残留全部清理
 2026-10-04 23:57:02 +08:00
zqlit a11631faa6 fix(editor): 编辑器接口只认真实会话，封掉 name/email 匿名兜底越权（P0） 
isAdminRequest 的 query 兜底会把「读文章源码/改文件/删文章/触发 git 发布」
裸露给任何拼参数的人。改为 requireAdminSession：只认 Bearer 会话，
已登录 + is_admin（或邮箱命中配置管理员）才放行。线上 Worker 已部署此版本。
 2026-10-04 23:40:49 +08:00
zqlit a4758dbbfd 同步编辑器里已删除的两篇测试文章（工作区与远端保持一致） 2026-10-04 23:40:31 +08:00
zqlit 9f586d625b 后台登录改造：自建登录页 + Cookie 会话，弃用 basic auth 弹窗 
- editor-api 新增 /admin/login|session|logout：HttpOnly Cookie 会话（落盘持久化）、
  登录失败限速（5 次锁 5 分钟）、鉴权改为「X-Editor-Token 或 会话」双通道
- 登录页重做：品牌标识、图标输入框、密码可见切换、柔光背景，深浅色适配
- 前端以 /admin/session 探测部署模式：国内机走本机会话，CF 版走原令牌流程
- nginx：/admin/ 与 /api/v2/editor/ 去掉 basic auth 与令牌注入，登录凭据只存 Cookie
- bootstrap.sh 同步 ADMIN_USER/ADMIN_PASS，保持一键迁移能力
 2026-10-04 23:40:23 +08:00
zqlit 96751b8143 fix(editor): 删文章 EXDEV 修正 + 订阅口令不再阻断登录 
1) 删除文章报 EXDEV（cross-device link not permitted）
   · 根因一：容器内 /blog 与 /app/trash 是两个独立 bind mount，
     rename(2) 跨挂载点必然 EXDEV —— 哪怕宿主机上它们同在一块盘。
   · 根因二：退化成 fs.cpSync 后，Windows 上遇到**中文目录名**会把
     Node 进程直接干崩（exit 127，不抛异常，stdout 缓冲丢失）。
     而文章目录名几乎必然含中文（<日期>-<中文标题>-<slug>）。
   · 修法：改用 readdirSync/copyFileSync 自己递归复制（宽字符路径，中文 OK）；
     bootstrap.sh / compose 改成挂 BLOG_DIR 的父目录，让仓库与回收站
     落在**同一个挂载点**内，正常情况下 rename 直接成功、不再复制。

2) 登录页「订阅口令」填错会阻断整个登录
   · 它只是可选订阅模块的口令，不该 throw 掉登录流程。
   · rssApi() 无条件 searchParams.set('token', RSS_TOKEN)，会用浏览器里
     记住的旧口令覆盖调用方刚传的值 → 正确口令也验不过。
   · 现在：填错只 toast 提示 + 清掉失效旧口令；rssApi 尊重调用方传的值。

3) wrangler.toml：EDITOR_API_BASE 改指国内机新域名 writeapi.usj.cc
   （原指向即将到期的境外机 post.usj.cc，且那台从未部署过 editor-api）

验证：api-e2e 44/44；front matter 往返 130/130；保存往返 130/130；
中文路径删除实测通过（目录 + 中文子目录 + 图片全部移入回收站，进程不崩）。
 2026-10-04 22:11:02 +08:00
zqlit e8d13b9a6e fix(docker): apk 默认走阿里云镜像（国内构建实测官方源单包 30~40s） 2026-10-04 21:33:39 +08:00
zqlit c217d20c30 feat(editor): 在线编辑文章（Worker 前端 + 轻量 docker 后端） 
后端（新增 editor-api/，零 npm 依赖，只用 node 内置模块）：
- 只做文章相关：列表/读取/新建/保存/删除/图片上传/git 状态·发布·同步
- front matter 往返保真：未改动的块按字节照抄，CRLF/块标量/引号写法都不动
- 列表用目录名当 id，slug 撞名不再静默改错文件（返回 409 列候选）
- 鉴权只有一条路：X-Editor-Token（只存在 Worker 侧，浏览器拿不到）
- 端口只绑 127.0.0.1，由宿主机 nginx 反代出去

部署（新增 deploy/editor-api/bootstrap.sh）：
- 一条命令在新机器上完成 克隆仓库→写 .env→起容器→健康检查
- 状态全在两个目录（/srv/blog 仓库工作区 + /srv/editor-api 配置），
  迁移 = 复制目录或在新机重跑本脚本，容器本身无状态

Cloudflare Worker 侧（blog-admin）：
- src/routes/editor.ts：鉴权 + 反代，浏览器只跟 Worker 说话
- 管理面板新增「文章编辑」：两栏布局 + 快捷插入面板（13 项短代码，
  与 write-server 的 ShortcutPanel 一致）+ 底部 草稿/保存/发布
- 系统设置改为 schema 驱动的表单，且**以运行时实际生效的配置为准**
  （frontend_conf/captcha/moderator/ip_region/site_default + KV human_check），
  修复「表单显示一套、评论系统跑另一套」的脱节问题

验证：tsc 0 错；front matter 往返 130/130；保存往返 130/130；
API e2e 44/44；无头 Chrome UI e2e 14/14
 2026-10-04 21:16:06 +08:00
zqlit 48a2fd697f ci: EdgeOne 境外部署加重试（构建节点到 api.edgeone.ai 偶发 15s 超时会被误报成令牌无效） 2026-10-04 18:45:01 +08:00
zqlit 437cd339ad fix: 管理员编辑跳过邮箱校验 + 返回顶部 rAF 丝滑滚动 + admin.js 正则笔误 + 页面标题污染 
- artalk.js: beforeSubmit 在编辑态跳过昵称/邮箱校验(管理员改评论不再被拦)
- floating-tools.js: 返回顶部/去评论改 rAF + easeInOutCubic 自绘,原生 smooth 不可靠
- admin.js: 修 5 处 //s //n 正则笔误(整脚本 SyntaxError 致后台全灰),需 wrangler deploy
- artalk.html: 显式传 pageTitle(不再读 document.title,PJAX 竞态致文章页标题被记成「留言」)
- artalk.js: conf 缓存合并前剔除 pageKey/pageTitle/pageThumb,杜绝跨页串值
 2026-10-04 18:30:30 +08:00
zqlit e8c991274a fix(comments): 额度故障态提示去冗余 + 修「误恢复」bug + 本地复现开关 
服务端 D1 额度用尽时同屏会出现三层重复提示，且故障态会被定期误解除。

- 提示从三层收敛为两层：横幅只留一句极简状态（⏸ 评论暂停中，预计明早 8:00 恢复），
  卡片是唯一详细说明并紧贴编辑器；删掉「点击编辑器再弹一遍 toast」
- 修 bug：恢复判定原来过于宽松，任何 conf/comments/captcha/votes/pages 请求成功都算恢复；
  但 /captcha/status 走 KV 不读 D1，60s 探针恒成功 → 故障态每 60s 被误撤，编辑器看似正常
  实则列表还挂着。现在恢复只认评论列表本身成功，探针改用 GET /comments?limit=1（真读 D1）
- 故障态不再灰化编辑器（opacity+grayscale 观感很差），只禁交互，原因由横幅说明
- 服务端 errors.ts 文案去掉与卡片标题重复的「评论服务暂时不可用」前缀
- 新增本地调试开关：仅 localhost 下 ?atk_svc=<code> 强制进入故障态，便于排查，生产不生效

改动文件：themes/Ying/assets/js/modules/artalk.js、blog-admin/src/lib/errors.ts
（errors.ts 需下次部署 Worker 才在线上生效，前端已做旧文案兼容清洗）
 2026-10-04 18:04:47 +08:00
zqlit 571d552c9d fix(build): 消除构建期远程拉取隐患 + 评论提交反馈 + 友链卡片移动端 
构建隐患（本次丢构建的根因）
- footer.html 用 resources.GetRemote 在每个页面渲染时拉 api/links 与 api/feeds，
  构建节点连不上 Cloudflare 时重试撞穿 Hugo partial 30s 超时 → 整站构建失败
- 改为「流水线 curl 快照 + 模板读本地文件」：
  · 新增 scripts/fetch_snapshots.sh，一次拉齐 conf / friend_links / friend_feeds
    （--max-time 30 --retry 2，JSON 校验，失败一律删文件且恒 exit 0）
  · .cnb.yml Hugo 构建 stage 改为调用该脚本
  · footer.html 改读 site.Data.friend_links / site.Data.friend_feeds，缺失渲染空值
  · .gitignore 忽略 /data/friend_links.json 与 /data/friend_feeds.json
- 降级实测：删掉快照后构建仍 EXIT=0，产物 friendLinks 为空数组

评论提交反馈（artalk.js 新增 __atkSubmit 模块）
- 校验：config.beforeSubmit 拦下 内容空 / 昵称空 / 邮箱空 / 邮箱格式错（网址不校验）
- 发送中：editor-submit 常驻 loading，超 7s 补「网络较慢」
- 成功：editor-submitted 按 normal/reply/edit 分文案，is_pending 提示等待审核
- 失败：拦 POST /api/v2/comments，403/429/4xx/5xx/网络异常全部翻译成人话
- 失败时输入内容保留，并清掉 Artalk 自带的重复小字通知
- 无头浏览器实测 19/19 通过（POST 走 mock，未向线上写数据）

友链申请卡片移动端
- max-width:640px 下隐藏 .atk-fl-nick（昵称 + 博主徽章），桌面端不变

改动：6 files, +282 / -61
 2026-10-04 17:38:04 +08:00
zqlit 836743b16d ci: 重跑部署（上次构建因构建节点连不上 api.200181.xyz 超时失败） 2026-10-04 17:02:45 +08:00
zqlit e0c5ac5739 feat(comments): 人机验证改点按式 + 分割线可配置 + 投票契约修复 
- 人机验证抽成 human.js 模块，改成 Cloudflare Turnstile 风格的「点一下验证」，
  控件移到「评论一下」发送按钮左侧（不再用图形验证码那一套）
- 留言页 / 文章页两段内联脚本（友链弹窗、人机验证）抽成模块随 page-only.js 加载。
  原先内联 <script> 写在 #pjax-container 外，PJAX 只换容器内容不重新执行它，
  从首页 PJAX 进留言页会出现「申请友链卡片点了没反应」「没有人机验证控件」
- 友链申请弹窗 #flApplyBox 隐藏滚动条（内容仍可滚，避开细滚动条 + 毛玻璃的割裂感）
- 内容分割线抽成 partial divider.html，hugo.toml [params.divider] 可切
  icon（原生 uk-divider-icon）/ image（本地图片），当前用 icon
- 投票契约修复（后端 blog-admin）：Artalk 客户端把方向编在 target_name 后缀
  （comment_up / comment_down / page_up / page_down）、路径只有两段，
  而原先只注册了三段 :choice 路由 → 点赞/踩一路 404、界面点了没反应。
  补 POST /votes/:target_name/:target_id，新增 parseVoteTarget() 同时兼容两套契约
  （名字里与路径里方向矛盾时判非法，不静默取其一），错误文案改用实体名
- 无身份点赞不再静默失败：artalk.js 加 __atkVoteGuard，
  未填昵称/邮箱时拦截并提示「填写昵称和邮箱后才能点赞」，
  同时把光标送到昵称框（多个同名输入框逐个试，以 focus 真生效为判据）
 2026-10-04 16:26:28 +08:00
zqlit 50a906e07c perf(comments): 评论加载提速 + 骨架屏 + 友链弹窗 pjax 修复 + toast 统一 Message.js 
优化：
- initArtalk 加节点级幂等守卫（mount.__atkInited，失败回滚），
  消除 artalk.html/mypjax 多入口导致的 4× comments + 4× pv 重复请求
- fetch 包装层对无 body 的 GET/HEAD 去掉多余 content-type，
  消掉 Artalk 对 GET /comments 的 CORS 预检（按完整 URL 缓存，
  每篇文章都重付一次 RTT）。实测评论列表 +1150~1565ms → +626ms

修复：
- 评论列表骨架屏改注入 .atk-list-body（原骨架在 #Comments 内，
  被 Artalk.init 清空），list-loaded/故障/12s 兜底移除
- 友链申请弹窗抽成 modules/friendlink.js 进 page-only bundle
  （原内联脚本在 #pjax-container 外，pjax 后 flApplyOpenModal 未定义）
- toast 统一走本地化 Message.js/Qmsg 适配层（保留 window.Toast/showToast 旧 API）

文档：
- README / 架构总览 更新；新增 评论加载优化方案.md
 2026-10-04 15:00:52 +08:00
zqlit 9e972f2b61 ci: 修 CNB docker build 上下文（by 必须列出 bin/linux/hugo） 
首跑失败在镜像构建：
  COPY bin/linux/hugo /usr/local/bin/hugo
  ERROR: failed to compute cache key ... "bin/linux/hugo": not found

根因（CNB 官方文档原文）：docker build 的构建上下文里「只包含 Dockerfile
和 by 声明的文件」，未出现在 by 列表中的文件在构建时一律视为不存在。
原配置 by:[package.json] 既漏了 hugo 二进制，又列了个 Dockerfile 根本
没 COPY 的 package.json。

改为 by: [bin/linux/hugo] / versionBy: [bin/linux/hugo]。
 2026-10-04 13:07:31 +08:00
zqlit c68d60f34c ci: 触发 CNB 首次流水线（验证密钥仓库 + 构建链路） 
密钥仓库 zqlit/blog-secrets 已建好，重跑一次确认整条链路：
Hugo 构建 → 又拍云 sync/purge → 多吉云刷新 → EdgeOne 部署 → 邮件通知。
 2026-10-04 13:04:53 +08:00
zqlit 03a066296a docs: CNB构建落地方案 填实密钥仓库地址（zqlit/blog-secrets） 2026-10-04 12:56:53 +08:00
zqlit bcc2236bde ci: 迁移到 CNB 流水线（.cnb.yml）+ 零依赖邮件通知 
- .cnb.yml：6 个 stage 顺序执行（Hugo 构建 → 又拍云 sync → 又拍云 purge →
  多吉云刷新 → EdgeOne 部署 → 上报状态）；push 与每日 09:00 定时任务
  共用同一组 stage（YAML 锚点），失败通知走 failStages
- 又拍云保持「非阻断但如实上报」：allowFailure 沿用原版 continue-on-error
  语义，国内线路直传失败不拖垮境外线路
- scripts/send_mail.js：零依赖 SMTP 发信（node net/tls，465 隐式 TLS +
  587 STARTTLS），变量名沿用 MAIL_USERNAME / MAIL_PASSWORD
- 密钥经 imports 从密钥仓库 zqlit/blog-secrets 注入（共 10 项）
- .gitignore：补 cnb-secrets.yml 本地粘贴草稿（含真实令牌，不入库）

原 GitHub Actions 里的 artifact 传递 / COS 中转 / 广州机 sync.sh 轮询
整条链在此不再需要 —— 其唯一根因是 runner 在境外，CNB 节点在国内。
 2026-10-04 12:56:05 +08:00
zqlit e0218b42bb docs: 迁 CNB 前的架构决策文档 + 构建骨架 
- 决策文档：架构总览 / 代码源与构建平台选型 / CNB构建落地方案 /
  EdgeOne双区域 / Gitee / 阿里云ESA / 精简方案
- CNB 构建骨架：deploy/Dockerfile、bin/linux/hugo
  （84MB，linux/amd64 extended 0.128.2，供 CNB 容器 COPY 用）
- scripts/setup-cnb-remotes.sh：双远端切换（CNB 主仓 + GitHub 备份）
- .gitignore 补 .workbuddy/（工作数据不入库）
 2026-10-04 12:40:17 +08:00
zqlit 1f568bbfd1 fix: artifact 改为单文件 tar 传递（v3 逐文件上传时 Gitea finalize 500） 
实测 run #56：upload-artifact@v3 传 public/ 目录时会逐文件上传 3216 个
blob（376MB），文件全部传完后 finalize 调用被 Gitea 拒绝：
  Finalize artifact upload - Attempt 1..5 of 5 failed: Request timeout
  ::error::Finalize artifact upload failed: Artifact service responded with 500
整轮 build 白跑约 30 分钟（v3 已越过 v4 的 'not supported on GHES' 报错点，
这是另一个独立问题）。

改法：build 侧先把 public/ 打成单个 public.tar.zst（无 zstd 时退 gzip），
只上传这 1 个文件 -> 上传是 1 次 PUT、finalize 常数级开销。
deploy-edgeone 侧下载后解包，产物结构因此完全确定（不再有「多一层
public/」的歧义），原 Normalize 步骤随之删除。

配套：中转机 sync.sh.new 增加「artifact 内 tar 包二次解包」（已上传服务器，
未生效）。
 2026-10-04 11:08:40 +08:00
zqlit ed38f9384b fix: upload/download-artifact 降级 v4 -> v3（v4 在 Gitea 上不被支持）
Deploy to Production / probe-network (push) Skipped
Details
Deploy to Production / pre-check (push) Successful in 1m9s
Details
Deploy to Production / build (push) Failing after 39m20s
Details
Deploy to Production / deploy-edgeone (push) Skipped
Details
Deploy to Production / finalize (push) Skipped
Details
Deploy to Production / notify-failure (push) Successful in 5s
Details 
实测 run #55：build job 在「Upload build artifact (public/)」失败：
  ::error::@actions/artifact v2.0.0+, upload-artifact@v4+ and
  download-artifact@v4+ are not currently supported on GHES.
Gitea 被 v4 识别为 GHES、未实现新 artifact API → 降回 v3（走旧 API）。

v3 无 include-hidden-files 选项、隐藏文件不保证进包，故：
- build job 额外写非隐藏的 public/build_hash.txt 兜底
- 中转机 sync.sh 优先读 .build_hash，读不到退 build_hash.txt，最后才本地复算
 2026-10-04 10:33:55 +08:00
zqlit fffdbe6865 fix: artifact 传递补两个坑（隐藏文件 + 产物层数）
Deploy to Production / probe-network (push) Skipped
Details
Deploy to Production / pre-check (push) Successful in 54s
Details
Deploy to Production / build (push) Failing after 3m53s
Details
Deploy to Production / deploy-edgeone (push) Skipped
Details
Deploy to Production / finalize (push) Skipped
Details
Deploy to Production / notify-failure (push) Successful in 4s
Details 
- upload-artifact@v4 默认排除隐藏文件，public/.build_hash 会丢
  → 开 include-hidden-files: true，否则中转机读不到 hash 无法判断同步
- download 后产物可能多一层 public/ → EdgeOne 部署前统一拍平并校验 index.html

配合中转机 sync.sh 改造（COS → Gitea artifact），两者需同时生效。
 2026-10-04 10:06:27 +08:00
zqlit 4ede54b96d fix: 修复 .env.example 被根 .gitignore 的 .env.* 规则误伤
Deploy to Production / probe-network (push) Skipped
Details
Deploy to Production / pre-check (push) Successful in 50s
Details
Deploy to Production / build (push) Failing after 4m16s
Details
Deploy to Production / deploy-edgeone (push) Skipped
Details
Deploy to Production / finalize (push) Skipped
Details
Deploy to Production / notify-failure (push) Successful in 6s
Details
2026-10-04 09:53:20 +08:00
zqlit 2388694e8a chore: 砍COS改造(deploy.yml改artifact传递+gitea-backup可移植部署包+改造步骤文档) 2026-10-04 09:52:50 +08:00