zqlit/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
965 Commits 2 Branches 2 Tags
3555bf25280cc21b65782b7336620d56cb888207
Commit Graph
965 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
zqlit 3555bf2528 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 6988a39732 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 db150c55bd ci: 重跑部署（上次构建因构建节点连不上 api.200181.xyz 超时失败） 2026-10-04 17:02:45 +08:00
zqlit 6fb5b0e039 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 e3e3cce1a4 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 b60ddc5bf5 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 8182bead0b ci: 触发 CNB 首次流水线（验证密钥仓库 + 构建链路） 
密钥仓库 zqlit/blog-secrets 已建好，重跑一次确认整条链路：
Hugo 构建 → 又拍云 sync/purge → 多吉云刷新 → EdgeOne 部署 → 邮件通知。
 2026-10-04 13:04:53 +08:00
zqlit 41503560d5 docs: CNB构建落地方案 填实密钥仓库地址（zqlit/blog-secrets） 2026-10-04 12:56:53 +08:00
zqlit b6f9daaf1f 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 3c506fa604 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 2a5f710db1 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 d62cbfcf33 fix: upload/download-artifact 降级 v4 -> v3（v4 在 Gitea 上不被支持） 
实测 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 a6af84cd6a fix: artifact 传递补两个坑（隐藏文件 + 产物层数） 
- 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 14c1bce5f1 fix: 修复 .env.example 被根 .gitignore 的 .env.* 规则误伤 2026-10-04 09:53:20 +08:00
zqlit 8ef265ca60 chore: 砍COS改造(deploy.yml改artifact传递+gitea-backup可移植部署包+改造步骤文档) 2026-10-04 09:52:50 +08:00
zqlit 299ab57e4d 归档 artalk-cf 评论后端 + rss-robot 到 blog-admin（含技术选型/模块分布 README） 2026-10-04 08:45:40 +08:00
zqlit e1323bd260 编辑器禁用态：置灰但内容完整(补发送字样/占位符/表情预览图标)，svc-down 隐藏 Powered By 版权 2026-10-04 00:28:12 +08:00
zqlit 258645a954 评论错误卡片：额度文案双保险(中文特征词兜底+连接异常优先判)、底部边距加大与footer分隔线隔开(桌面30px/移动24px) 2026-10-03 21:01:58 +08:00
zqlit 3f06a3a598 评论验证码取不到时降级为可重试提示（不留破图） 2026-10-03 20:37:46 +08:00
zqlit 8cad0292cd 错误卡片重设计：居中布局+去技术详情(读者无需看)，图标放大、重试改胶囊按钮 2026-10-03 20:07:05 +08:00
zqlit 6592d2d0ae 评论加载失败改为清晰提示：接管 Artalk 错误层，按服务端错误码给读者人话文案+可展开技术详情 2026-10-03 19:49:10 +08:00
zqlit 50ec0d9ede 评论人机验证(自研一键验证)：静默PoW+行为信号，必要时点一下/图形验证码兜底 2026-10-03 19:30:07 +08:00
zqlit 265c731f6f 友圈卡片背景头像效果恢复：背景图/头像统一用自建favicon绝对地址+失败兜底，缓存key升v2 2026-10-03 17:39:06 +08:00
zqlit a2fe9355c5 友圈头像不再兜底第三方默认头像：改用站内/api/favicon(绝对地址)，兜底也从cravatar换成自建服务 2026-10-03 17:35:32 +08:00
zqlit e32312b1f0 友链卡片移动端适配：≤640px隐藏头像、收紧间距内边距、微调字号字距 2026-10-03 17:29:20 +08:00
zqlit ac0ca52db1 友链卡片只转换顶层评论(回复里的同串URL不再被隐藏) 2026-10-03 17:23:46 +08:00
zqlit 8f959be37c 徽章样式补充卡片上下文(.atk-fl-card)：卡片已移出.atk-comment导致博主徽章露出Artalk内联蓝底 2026-10-03 17:22:58 +08:00
zqlit 95e5ef9678 友链卡片固定在评论列表上方(不再被新评论挤到中间)：整条评论用class隐藏，卡片插入atk-list-body首位 2026-10-03 17:20:04 +08:00
zqlit 89d64cc2f4 修复发评论后卡片被挤下去：原评论内容改用class+!important隐藏(Artalk重渲染会抹掉内联display)，转换逻辑改幂等自愈 2026-10-03 17:13:06 +08:00
zqlit 6785d1234c 友链申请表单新增可选图标链接字段(留空由/api/favicon自动抓取站点图标) 2026-10-03 17:05:57 +08:00
zqlit cd82fd80db 评论徽章DOM/尺寸统一(拆badge-wrap+单一类名)、修复main.css!important劫持徽章尺寸、友链卡片挂到comment级与输入框对齐、卡片动效+打字机、申请弹窗按钮错位与滚动条修复 2026-10-03 16:59:34 +08:00
zqlit 3168fddde5 徽章样式定稿：博主浅底灰黑描边(回线上版)、置顶浅底红字描边；恢复Artalk默认徽章右间距与CN地域徽标原样 2026-10-03 16:12:23 +08:00
zqlit c55e8e5052 友链申请入口改URL评论触发+卡片原生风格化; 博主/头衔徽章改浅底描边风格与友链友圈官职统一 2026-10-03 15:16:00 +08:00
zqlit 519c7fb35e 友链申请卡片重设计(头像+昵称+徽章+主题色) + 弹窗横向滚动条/显隐bug修复 2026-10-03 14:28:50 +08:00
QunLIn c1f2bc913e 评论徽章全展示按优先级排序 + 新增金色头衔徽章 
- 徽章不再互斥：满足条件全部展示，排序 = 系统徽章（博主等）
  > 头衔（新增）> 友链 > 友圈 > 官职
- 头衔徽章：后端 users 表新增 title_name 字段，管理面板用户编辑
  可设置，金色 UI 与官职一致，优先级仅次于系统徽章
- 官方 badge-wrap 挪进昵称元素内，保证与主题徽章的排序正确
 2026-10-03 13:37:22 +08:00
QunLIn ebada8eaa6 友链申请卡片改挂置顶评论 + 弹窗挂 body 加毛玻璃 
- 置顶评论卡片化：管理员置顶且内容含「友链自助申请」的评论，
  整条解析成申请入口卡片（隐藏昵称/页脚，渐变虚线卡片，点击打开
  申请弹窗），其余置顶评论不受影响
- 弹窗 DOM 动态挂 document.body：评论容器带 transform 动画会把
  position:fixed 劫持成相对定位，导致遮罩/表单跟着容器变形——
  挂 body 彻底规避
- 遮罩加 backdrop-filter 毛玻璃（GPU 合成，不影响页面性能）
 2026-10-03 13:08:14 +08:00
QunLIn e1cfbf69e5 字体切全量、评论徽章优先级、友链自助申请卡片、友圈头像兜底 
- 字体：zql 从 subset(776K) 切换到全量(1.2MB woff2)，subset 覆盖
  不足导致大量字回退系统字体，视觉不一致；全量一次加载彻底解决
- 评论徽章统一 comment-rendered 注入，优先级互斥：友链 > 友圈 >
  官职（后端 rank 字段），官方系统徽章（博主）独立显示
- 留言页新增友链自助申请入口卡片 + 弹窗表单（名称/链接/订阅/邮箱
  必填），提交进 api.200181.xyz 待审队列，审核结果邮件通知申请人
- 友圈头像：favicon 抓取失败时兜底第三方 favicon 服务
 2026-10-03 12:13:45 +08:00
QunLIn 4319434f1c 评论后端统一到 api.200181.xyz（与 RSS 同一 Worker） 
评论与订阅已合并为同一个 Cloudflare Worker（artalk-cf，
同时服务 api.200181.xyz 与 artalk.200181.xyz）。为收敛到
单一域名/单一面板，评论入口统一切到 api.200181.xyz。

- hugo.toml params.artalk.server → api.200181.xyz
- write-server ARTALK_SERVER 默认值同步
- 注意：post.usj.cc 服务器 .env 里若有 ARTALK_SERVER 覆盖项需同步改
 2026-10-03 10:57:33 +08:00
QunLIn bc0841aecc CI 构建完成后上报部署状态到 api.200181.xyz 
中转机 sync.sh 同步完成后会上报 phase=synced，CI 在 COS 上传后
上报 phase=built。打开 https://api.200181.xyz/api/deploy-status
即可查看国内线路是否同步完成（state: synced/syncing）。
需在 Gitea 仓库 Secrets 配置 RSS_API_TOKEN（未配置则跳过上报）。
 2026-10-03 10:40:22 +08:00
QunLIn 6bc9eaf8fc 永久跳过海外直传 UpYun，国内线路全走中转机 
海外 runner 对 UpYun v0 接口无论什么参数都是 70 秒左右 EOF
（-w 10/--strong 与 -w 3 均验证），3 轮重试全败，每次部署白耗
5 分钟（build #25 日志实锤）。

直传步骤改为 if: false 永久跳过（代码保留，将来 runner 挪国内
删掉该条件即可恢复）。国内线路由腾讯云广州中转机兜底：每分钟
比对 COS build hash → 下载产物 → upx sync → 又拍云 purge →
多吉云刷新（sync.sh 自带，CI 侧不再重复刷）。
 2026-10-03 10:23:43 +08:00
QunLIn c6e55e9dfb 官职徽章改回主题渲染，数据由后端 rank 字段下发 
上一版把九品官阶塞进官方 badge_name/badge_color 槽——但博主
徽章是独一无二的，官职应该接在它后面而不是挤占同一个槽位。
后端现下发独立字段 rank_name/rank_title/rank_count/rank_color/
rank_bg（配色沿用主题原版彩字+半透明底），本文件在
comment-rendered 事件里渲染官职徽章。
 2026-10-03 10:01:52 +08:00
QunLIn bc8bc87532 RSS API 地址全部收敛到 hugo.toml [params.rssapi]，切到 api.200181.xyz 
- 新增 [params.rssapi] base 配置，主题 7 处硬编码改为读配置：
  head(preconnect+window.rssApiBase)、footer(构建时拉 links/feeds)、
  render-link(favicon)、circles/links 页 fetch、linkify.js(读 window.rssApiBase)
- scripts/fetch_greetings.js 支持 RSS_API_BASE 环境变量，默认新地址
- scfapi.usj.cc（国内代理）保持不变
 2026-10-03 01:19:02 +08:00
QunLIn 360886b971 评论等级改为后端计算（artalk-cf 下发官方 badge） 
主题原来的九品官阶用 localStorage 累计——只统计当前浏览器
渲染过的评论，换设备/清缓存就失真，别人看到的也不准。
现在后端按全站真实评论数算好，随评论 API 下发
badge_name/badge_color，官方前端原生渲染，跨设备一致。
本文件移除本地注入逻辑，友链/友圈徽章保留。
 2026-10-03 01:11:43 +08:00
QunLIn daa09a4375 write-server 切到自建后端：评论 artalk.200181.xyz + RSS api.200181.xyz 
- ARTALK_SERVER: artalk.usj.cc（朋友机器）→ artalk.200181.xyz（自建 CF Workers）
- RSS_API_BASE: api.usj.cc（EdgeOne）→ api.200181.xyz（迁到 CF Workers 的 rss-robot-cf）
- SCF_PROXY 不变（scfapi.usj.cc 是国内代理，继续复用）
 2026-10-02 22:37:54 +08:00
QunLIn c9c2c32e0d 修 UpYun 直传：降并发去 --strong、加三轮重试；UpYun 未成功不再刷国内 CDN 
- upx sync 从 -w 10 --delete --strong 改为 -w 3 --delete + 三轮重试（单次 25 分钟）。
  本runner 在海外，UpYun v0 接口对并发敏感，-w 10 + --strong 会让一批目录的
  mkdir 全部 EOF（2026-10-02 连续两次失败，第二次直接撞 480s 超时）。
  upx 0.4.9 只有 -w/--delete/--strong 三个参数，没有 --resume/--checksum，
  所以只能靠降并发 + 整体重试。
- 多吉云 CDN 刷新改为仅在 UpYun 成功时执行：EdgeOne 是境外线路，
  它成功不代表国内源站已更新，之前会刷出一份"刷新成功但内容没变"的假象。
 2026-10-02 20:39:00 +08:00
QunLIn 7ae448331b 评论后端切到 Cloudflare Workers 自建版 
artalk.usj.cc（朋友机器）→ artalk.200181.xyz
数据已用增量导入同步到 artalk-cf 的 D1。
 2026-10-02 19:55:29 +08:00
zqlit f94c80bbde 删除一篇文章 2026-10-02 18:04:21 +08:00
zqlit 565d69d401 修改文章 2026-10-02 16:44:28 +08:00
Write Server fce1de1e4e 发布: 评论组件被人恶意sql注入，25端口被封，邮件无法发信 2026-10-02 08:15:58 +00:00
zqlit 29c607a27d merge: 合并 Gitea CI 修复(三态上报) 与内容发布(测试部署) 
- 2293626f 只推过 Gitea，c0692e17 只推过 GitHub，两条线在 52c2b01a 分叉
- 写作后台 origin 的 fetch 只指向 GitHub，看不到 Gitea 上的提交，导致 push Gitea 被拒
- 合并后两边内容一致，此后任何提交都同时推两个远端
 2026-10-01 20:53:26 +08:00