diff --git a/.cnb.yml b/.cnb.yml index 3fae26e0..bea79763 100644 --- a/.cnb.yml +++ b/.cnb.yml @@ -54,6 +54,25 @@ : > "$CI_STATUS" hugo version + + # ── /conf 快照(评论首屏优化)──────────────────────────────────── + # 构建期拉一次 Artalk 的 /conf 落到 data/,Hugo 会内联进每个页面。 + # 前端据此对匿名 /conf 请求本地合成响应 —— Artalk 内部 conf 与评论列表 + # 是严格串行的,省掉这一跳等于首屏少一整个跨境往返。 + # 服务端这份 conf 只由 settings 表决定(唯一因人而异的 imgUpload 由前端 + # 按登录态放行真实请求),所以匿名访客的快照人人相同。 + # 拉取失败一律降级:删文件 → 模板不内联 → 前端自动走原生远程请求。 + # 绝不让它拖垮构建(在 if 条件里失败不会触发 set -e)。 + mkdir -p data + if curl -fsS --max-time 30 --retry 1 --retry-delay 2 \ + "https://api.200181.xyz/api/v2/conf" -o data/artalk_conf.json \ + && python3 -c "import json;json.load(open('data/artalk_conf.json',encoding='utf-8'))"; then + echo "✅ conf 快照就绪 $(wc -c < data/artalk_conf.json | tr -d ' ') 字节" + else + rm -f data/artalk_conf.json + echo "⚠️ conf 快照拉取失败,已降级为运行时远程拉取" + fi + python3 scripts/add_draft_to_hidden.py rm -rf public resources/_gen hugo --minify --gc diff --git a/.gitignore b/.gitignore index 5d195ae5..93ef50bc 100644 --- a/.gitignore +++ b/.gitignore @@ -15,3 +15,5 @@ node_modules/ .ci_status # CNB 密钥仓库的本地草稿(含真实令牌,仅供往 Web 界面粘贴,绝不入库) cnb-secrets.yml +# 构建期拉取的 Artalk /conf 快照(每次构建现拉,不入库,避免陈旧配置被 git 固化) +/data/artalk_conf.json diff --git a/README.md b/README.md index 1fede0eb..9f03d3ac 100644 --- a/README.md +++ b/README.md @@ -1,86 +1,155 @@ -# 博客项目说明 +# 优世界博客(usj.cc) -本项目使用 Hugo 构建,主题为 `Ying`。以下是主要的配置说明与脚本使用指南,方便后续查阅和维护。 +Hugo 静态博客 + 自研评论后端 + 写作后台。 +**构建与发布跑在腾讯云 CNB**(国内节点),单次发布约 3.5 分钟,境内/境外两条线路一次推完。 -## 1. 常用脚本与工具 (Scripts) - -项目包含多个 PowerShell 和 Node.js 脚本,用于自动化维护、检查和部署。 - -### 1.1 日常维护 - -* **新建文章 (`./new_post.ps1`)** - * **用途**: 交互式创建新的博客文章。 - * **功能**: 自动引导输入标题、Slug、分类、标签等信息,并按 `YYYY-MM-DD-Slug` 格式创建 Page Bundle 目录和文件。 - * **运行**: - ```powershell - ./new_post.ps1 - ``` - -* **手动构建与检查 (`./deploy.ps1`)** - * **用途**: 手动执行构建,包含友链健康检查。 - * **流程**: - 1. 运行 `scripts/check_links.js` 检查友链连通性。 - 2. 如果检查通过,执行 `hugo --minify` 生成静态文件。 - * **运行**: - ```powershell - ./deploy.ps1 - ``` - -### 1.2 自动化与 CI/CD 工具 - -以下脚本主要在 GitHub Actions (`.github/workflows/upy.yml`) 中自动运行,也可手动用于调试: - -* **友链数据同步 (`scripts/update_link_lite_json.ps1`)** - * **功能**: 将 `themes/Ying/data/links.yaml` (YAML源数据) 转换为 `themes/Ying/static/json/link_lite.json`,供前端 JS 和检查脚本使用。 - -* **友链健康检查 (`scripts/check_links.js`)** - * **功能**: 读取 `link_lite.json`,并发检查所有友链的可访问性。 - * **依赖**: `node-fetch` (内置于 Node 18+ 或作为依赖)。 - -* **朋友圈数据生成 (`scripts/generate_circle_data.js`)** - * **功能**: 根据友链抓取 RSS/Atom 订阅源,生成朋友圈更新数据 (`friend_circle_data.json`)。 - * **依赖**: `rss-parser`. - -* **构建安全预处理 (`scripts/add_draft_to_hidden.ps1`)** - * **功能**: 在构建前扫描 `content/post`,将标记为 `status: hidden` 的文章强制设置为 `draft: true`,防止隐私文章意外泄露到公共列表。 - -* **CDN 刷新 (`scripts/RefreshCDN.py`)** - * **功能**: 部署完成后调用 DogeCloud API 刷新 CDN 缓存。 - * **配置**: 需要在环境变量中设置 `DOGECLOUD_ACCESS_KEY` 等参数。 +> 架构全貌、迁移前后对比、运维要点 → [`架构总览.md`](架构总览.md) --- -## 2. 基础配置 (`hugo.toml`) +## 一、项目构成 -位于项目根目录下,控制网站的全局行为。 +| 子系统 | 位置 | 技术栈 | +|---|---|---| +| **内容** | `content/`、`themes/Ying/` | Hugo 0.128.2 extended + Ying 主题 | +| **评论后端** | `blog-admin/` | artalk-cf:Cloudflare Workers + D1 + KV(`api.200181.xyz`) | +| **写作后台** | `write-server/`(线上 `post.usj.cc`)、`write/`(本地 Windows) | Next.js | +| **发布** | `.cnb.yml`、`deploy/` | CNB 流水线 + Dockerfile | -* **网站信息**: 标题、BaseURL、语言等。 -* **固定链接 (Permalinks)**: - ```toml - [permalinks] - post = "/:slug" - ``` - 文章页面使用 Front Matter 中的 `slug` 字段作为文件名(例如 `https://usj.cc/my-post.html`)。 +--- -## 3. 主题配置 +## 二、目录结构 -* **主题目录**: `themes/Ying/` -* **友链数据**: `themes/Ying/data/links.yaml` - * 添加友链请直接编辑此 YAML 文件,构建时会自动同步到 JSON。 - -## 4. 文章管理指南 - -### URL 设置 -文章默认使用 `slug` 字段作为 URL 的文件名。 -```yaml -title: "我的文章" -date: 2023-01-01 -slug: "my-post" ``` -生成的链接为: `https://usj.cc/my-post.html` +blog/ +├── .cnb.yml # ★ CNB 流水线(push + 每日定时) +├── deploy/Dockerfile # 构建镜像(hugo 二进制由 bin/linux/hugo 提供) +├── bin/linux/hugo # Hugo extended 0.128.2(linux/amd64,供 CNB 构建用) +├── content/ +│ ├── posts/<年>/<日期>-<标题>/ # 文章(Page Bundle,index.md + 图片) +│ ├── about.md / links.md / circles.md / archives.md +├── themes/Ying/ # 主题(layout / assets / data) +├── static/ # 原样复制进产物(emotion 表情、image、js …) +├── blog-admin/ # 评论后端(artalk-cf) +├── write-server/ # 线上写作后台 +├── write/ # 本地写作前端 +├── scripts/ # 各类工具脚本(见第六节) +├── hugo.toml # Hugo 主配置 +└── 架构总览.md # ★ 架构文档 +``` + +--- + +## 三、内容写作 + +### 文章结构 + +每篇文章是一个 **Page Bundle**: + +``` +content/posts/2024/2024-05-01-文章标题/ +├── index.md # 正文 +└── 配图.jpg # 同目录图片(可用相对路径引用) +``` + +### URL 规则 + +由 front matter 的 `slug` 决定(`hugo.toml` 里 `permalinks.post = "/:slug"`): + +```yaml +--- +title: "我的文章" +date: 2024-05-01 +slug: "my-post" +--- +``` + +生成 `https://usj.cc/my-post.html`(uglyURLs,带 `.html`)。 ### 隐藏文章 -如果你想写一篇不公开在列表显示的文章(但可以通过链接访问): -1. 在 Front Matter 中添加 `status: hidden`。 -2. 自动化脚本会在构建时将其标记为 `draft: true` (配合特殊构建逻辑) 或进行其他处理。 -*注:具体表现取决于 CI 脚本的逻辑,通常用于草稿或隐藏页。* + +在 front matter 加 `status: hidden`。构建前 `scripts/add_draft_to_hidden.py` 会把它转成 +`draft: true`,**不出现在列表里,但直达链接仍可访问**。 + +### 本地预览 + +```bash +hugo server -D # 含草稿 +``` + +--- + +## 四、发布流程 + +``` +写作(write-server / write/) + │ git pushall + ▼ +CNB 主仓 zqlit/blog ──触发──► CNB 流水线(国内节点,约 3.5 分钟) + ├─ Hugo 构建 + ├─ 同步到又拍云(境内源站) + ├─ 刷新又拍云 CDN + ├─ 刷新多吉云 CDN + ├─ 部署 EdgeOne Pages(境外线路) + └─ 邮件通知 +``` + +- **推送**:`git pushall` = `git push origin main; git push gh main` + (`origin` = CNB 主仓,`gh` = GitHub 备份) +- **触发**:推送到 `main`;另有每日 `0 9 * * *`(北京时间)定时构建 +- **密钥**:全部来自 CNB 密钥仓库 `zqlit/blog-secrets`,经 `.cnb.yml` 的 `imports` 注入, + **仓库里没有任何明文密钥** +- 改动 `main` 即自动上线,本地无需构建 + +--- + +## 五、三个子系统 + +### 内容系统 + +Hugo + Ying 主题。`hugo.toml` 控站点信息、永久链接、Artalk 地址、弹幕等。 + +### 评论系统(`blog-admin/`) + +自研的 **Artalk v2 兼容服务端**,跑在 Cloudflare Workers + D1(SQLite)+ KV: + +- 前端用官方 Artalk 客户端(`themes/Ying/assets/js/libs/Artalk.js`,本地打包,非 CDN) +- 后端 API 基址 `https://api.200181.xyz`(评论 `/api/v2/*` 与 RSS 订阅 `/api/*` 同一 Worker) +- 部署:`cd blog-admin && npm run deploy`(详细步骤见 `blog-admin/README.md`、`部署清单.md`) + +### 写作后台 + +- `write-server/`:线上版(Next.js),部署在独立主机 +- `write/`:本地 Windows 版 + +--- + +## 六、常用脚本(`scripts/`) + +| 脚本 | 用途 | 在哪跑 | +|---|---|---| +| `add_draft_to_hidden.py` | 构建前把 `status: hidden` 转成草稿 | **CI** | +| `refresh_cdn.js` | 刷新多吉云 CDN(零依赖) | **CI** | +| `send_mail.js` | 构建结果邮件通知(零依赖 SMTP) | **CI** | +| `setup-cnb-remotes.sh` | 切换/重建 git 远端(CNB 主仓 + GitHub 备份) | 本机 | +| `optimize_images.js` | 图片批量压缩优化 | 本机 | +| `generate_circle_data.js` | 抓友链 RSS 生成朋友圈数据 | 本机 | +| `update_link_lite_json.ps1` | 友链 `links.yaml` → JSON | 本机 | +| `add_ancient_chars.py` / `check_ancient_chars.py` / `merge_chars.py` | 字体生僻字增补与校验 | 本机 | +| `cleanup_duplicates.js` / `migrate_slugs.js` | 一次性维护脚本 | 本机 | + +> `deploy_*.sh`(又拍云 / EdgeOne / 定时)是本机手动部署的旧入口,**日常已不需要**—— +> 推送 `main` 由 CNB 自动完成。 + +--- + +## 七、相关文档 + +| 文档 | 内容 | +|---|---| +| `架构总览.md` | **当前架构全貌**(子系统、发布链路、迁移前后对比、运维要点) | +| `CNB构建落地方案.md` | 迁 CNB 的实施方案与实测数据 | +| `代码源与构建平台选型.md` | 平台对比(CNB / Gitee / GitLab / EdgeOne / 阿里云 ESA) | +| `砍COS改造步骤.md` | 腾讯云 COS 下线记录 | +| `blog-admin/README.md` | 评论后端完整说明 | +| `blog-admin/部署清单.md` | 评论后端部署步骤 | diff --git a/themes/Ying/assets/css/main.css b/themes/Ying/assets/css/main.css index ee9e5123..02c4a0a8 100644 --- a/themes/Ying/assets/css/main.css +++ b/themes/Ying/assets/css/main.css @@ -4126,76 +4126,41 @@ input[type=submit] { } } -/* ── Toast ── */ -.ying-toast-container { - position: fixed; - top: 18px; - left: 50%; - transform: translateX(-50%); - z-index: 10000; - display: flex; - flex-direction: column; - align-items: center; - gap: 8px; - pointer-events: none; +/* ── Toast(Message.js / Qmsg 适配,见 assets/js/modules/toast.js)── + 组件自带样式在 css/libs/message.min.css(随 style.css 打包)。 + 这里只做主题融合:跟随主题变量 + 暗色适配。 */ +.qmsg { + border-radius: 8px; + -webkit-backdrop-filter: blur(8px); + backdrop-filter: blur(8px); } -.ying-toast { - padding: 9px 18px; - border-radius: 6px; - font-size: 13px; +.qmsg-content { + color: var(--text-main, #333); font-weight: 500; - line-height: 1.3; - opacity: 0; - transform: translateY(-10px); - transition: opacity 0.28s ease, transform 0.28s ease; - pointer-events: auto; - -webkit-backdrop-filter: blur(4px); - backdrop-filter: blur(4px); - will-change: transform, opacity; } -.ying-toast--visible { - opacity: 1; - transform: translateY(0); +[data-theme="dark"] .qmsg { + background: #2a2e33; + box-shadow: 0 4px 12px rgba(0, 0, 0, .5); } -.ying-toast--success { - background: rgba(34, 197, 94, 0.88); - color: #fff; - box-shadow: 0 8px 32px rgba(34, 197, 94, 0.18); +[data-theme="dark"] .qmsg-content { + color: #d6dade; } -.ying-toast--error { - background: rgba(239, 68, 68, 0.88); - color: #fff; - box-shadow: 0 8px 32px rgba(239, 68, 68, 0.18); +[data-theme="dark"] .qmsg-close { + color: #7a828a; } -.ying-toast--warning { - background: rgba(245, 158, 11, 0.88); - color: #fff; - box-shadow: 0 8px 32px rgba(245, 158, 11, 0.18); -} - -.ying-toast--info { - background: rgba(29, 61, 108, 0.85); - color: #f0f4fb; - box-shadow: 0 8px 32px rgba(29, 61, 108, 0.18); -} - -[data-theme="dark"] .ying-toast--info { - background: rgba(159, 196, 244, 0.22); - color: #f3f7fd; - -webkit-backdrop-filter: blur(4px); - backdrop-filter: blur(4px); +[data-theme="dark"] .qmsg-close:hover { + color: #a8b0b8; } @media screen and (max-width: 480px) { - .ying-toast { + .qmsg { padding: 8px 14px; font-size: 12px; - border-radius: 5px; } } diff --git a/themes/Ying/assets/js/modules/artalk.js b/themes/Ying/assets/js/modules/artalk.js index 80f81aea..eac49d29 100644 --- a/themes/Ying/assets/js/modules/artalk.js +++ b/themes/Ying/assets/js/modules/artalk.js @@ -21,17 +21,94 @@ internal: { ic: '⚠️', title: '评论暂时加载不出来', desc: '服务出了点小状况,请稍后再试。' } }; + // ── /api/v2/conf 内联快照 ────────────────────────────────────────── + // 构建期把 conf 响应内联进页面(见 partials/artalk.html)。服务端这份 conf + // 只由 settings 表决定,唯一因人而异的字段是 imgUpload(imgUpload || admin), + // 所以匿名访客看到的 conf 人人都一样 —— 匿名请求直接本地合成 Response, + // 不发网络。Artalk 内部 conf 与评论列表是严格串行的,省掉这一跳等于首屏 + // 少一整个跨境往返。 + // 带 Authorization 的请求来自已登录用户(管理员拿到 imgUpload=true),属个性化 + // 响应,放行真实网络。 + var CONF_URI = /\/api\/v2\/conf(\?|$)/; + function hasAuthHeader(init, input) { + try { + var h = (init && init.headers) || null; + if (!h && input && typeof input !== 'string') h = input.headers || null; + if (!h) return false; + if (typeof h.get === 'function') return !!h.get('Authorization'); + if (Array.isArray(h)) { + for (var i = 0; i < h.length; i++) { + if (String(h[i][0]).toLowerCase() === 'authorization') return !!h[i][1]; + } + return false; + } + return !!(h.Authorization || h.authorization); + } catch (e) { + return true; // 判不准就当有凭据 → 放行真实请求(保守,宁可多一跳也不串号) + } + } + + // ── 0) 去掉 GET/HEAD 上多余的 content-type:省掉一次 CORS 预检 ────── + // Artalk 给「所有」请求都带上 content-type: application/json,可 GET 根本没有 body。 + // content-type 属于「非简单头」→ 浏览器必须先发一个 OPTIONS 预检(Access-Control-Request-Headers: content-type)。 + // 预检按「完整 URL」缓存(含 query),而 comments 的 URL 带 page_key、每篇文章都不同, + // 于是每进一篇新文章都要重付一次预检 —— 跨域下这是实打实的整整一个 RTT, + // 而它正好卡在评论列表的关键路径上(预检 → 才发 GET)。 + // GET/HEAD 没有 body,删掉这个头不改变任何语义,却能直接把预检砍掉。 + function sansContentType(init) { + var out = {}, k; + for (k in init) out[k] = init[k]; + var h = out.headers; + try { + if (h && typeof Headers === 'function' && h instanceof Headers) { + var nh = new Headers(); + h.forEach(function (v, n) { if (n.toLowerCase() !== 'content-type') nh.append(n, v); }); + out.headers = nh; + } else if (Array.isArray(h)) { + out.headers = h.filter(function (p) { return String(p[0]).toLowerCase() !== 'content-type'; }); + } else if (h && typeof h === 'object') { + var nh2 = {}; + for (k in h) { if (k.toLowerCase() !== 'content-type') nh2[k] = h[k]; } + out.headers = nh2; + } + } catch (e) { + return init; // headers 形态不认识就原样放行(宁可多一次预检,不能出错) + } + return out; + } + // ── 1) 记录 API 失败原因。只读不改:包装层原样返回上游响应, // 失败时顺带 clone 一份读 body(clone 不影响 Artalk 自己读)。 var origFetch = window.fetch; if (typeof origFetch === 'function') { - window.fetch = function (input) { + window.fetch = function (input, init) { var url = typeof input === 'string' ? input : (input && input.url) || ''; url = String(url); - var p = origFetch.apply(this, arguments); - if (url.indexOf('/api/v2/') === -1) return p; - // 学习 API 源(探测恢复用) + if (url.indexOf('/api/v2/') === -1) return origFetch.apply(this, arguments); + // 学习 API 源(探测恢复用)—— 拦快照之前先学,别因为少了一次网络请求而丢掉来源 if (!apiBase && url.indexOf('/api/v2/') > 0) apiBase = url.split('/api/v2/')[0]; + + // conf 快照命中:本地合成响应,完全不发网络 + if (window.__artalkConfSnapshot && CONF_URI.test(url) + && typeof Response === 'function' && !hasAuthHeader(init, input)) { + return Promise.resolve(new Response( + JSON.stringify(window.__artalkConfSnapshot), + { + status: 200, + statusText: 'OK', + headers: { 'Content-Type': 'application/json; charset=utf-8' } + } + )); + } + + // GET/HEAD 且无 body:去掉 content-type,避免不必要的 CORS 预检 + var fargs = arguments; + var method = String((init && init.method) || (input && input.method) || 'GET').toUpperCase(); + if ((method === 'GET' || method === 'HEAD') && !(init && init.body)) { + fargs = [input, sansContentType(init || {})]; + } + + var p = origFetch.apply(this, fargs); return p.then(function (res) { if (res && res.ok === false) { try { @@ -105,6 +182,7 @@ // 这里:编辑器整体置灰(内容原样可见,只是变灰)+ 编辑框上方插窄横幅 // 说明原因和恢复时间,并每 60s 用一次 1 行 D1 成本的探针(/captcha/status, // 只读 1 行 settings)探测恢复,恢复后自动解除禁用并 toast,不用刷新页面。 + // toast 统一走 Message.js(modules/toast.js 适配层),不再自绘浮层。 // conf 加载失败时 Artalk 渲染的是"空壳编辑器"(i18n 没加载):发送按钮 // 没有字、输入框没有占位符、工具栏按钮整排缺失。置灰态要保留完整外观, @@ -130,22 +208,18 @@ var svcDown = false; var downCode = ''; + var downAt = 0; // 进入禁用态的时刻(用来判断这次"故障"是不是一闪而过) var probeTimer = null; var apiBase = ''; // 从拦截到的请求里学习 API 源(跨域探测需要绝对地址) function svcToast(msg) { - var t = document.getElementById('atk-svc-toast'); - if (!t) { - t = document.createElement('div'); - t.id = 'atk-svc-toast'; - t.style.cssText = 'position:fixed;left:50%;bottom:110px;transform:translateX(-50%);z-index:99999;' + - 'padding:12px 24px;border-radius:999px;background:var(--theme-main,#07c160);color:#fff;' + - 'font-size:14px;box-shadow:0 10px 32px rgba(0,0,0,.35);opacity:0;transition:opacity .35s,transform .35s;pointer-events:none'; - document.body.appendChild(t); + // 统一通知组件(Message.js):Toast 在 core bundle 里先于本模块加载, + // 但 PJAX 极端时序下仍兜底判一次,避免 undefined 直接抛错 + if (window.Toast && typeof window.Toast.info === 'function') { + window.Toast.info(msg, 3200); + } else { + try { console.log('[artalk]', msg); } catch (e) {} } - t.textContent = msg; - requestAnimationFrame(function () { t.style.opacity = '1'; }); - setTimeout(function () { t.style.opacity = '0'; }, 3200); } function ensureBar(code) { @@ -185,8 +259,11 @@ function setSvcDown(code) { downCode = code; + // 评论服务故障:列表不会返回了,别让骨架屏一直转(故障态有自己的横幅/卡片) + listSkeletonDone(); if (svcDown) { ensureBar(code); return; } // 已在禁用态,只刷新文案 svcDown = true; + downAt = Date.now(); ensureBar(code); if (!probeTimer) { probeTimer = setInterval(function () { @@ -203,12 +280,26 @@ svcDown = false; if (probeTimer) { clearInterval(probeTimer); probeTimer = null; } removeBar(); - svcToast('评论服务已恢复,可以继续评论了 ✓'); + // 禁用态只持续了一瞬间就别报喜:读者眨个眼就"恢复"的故障,弹提示纯属噪音 + // (真实故障从出现到恢复不会只有两三秒,所以门槛不会漏报) + if (downAt && Date.now() - downAt >= 3000) { + svcToast('评论服务已恢复,可以继续评论了 ✓'); + } + downAt = 0; } function rewrite(layer) { if (!layer) return; + // ── 不是评论列表的错误层,一律不碰 ────────────────────────────── + // Artalk 会把「编辑器插件资源加载失败」(表情包 / 图片等)的错误层也渲染成 + // .atk-error-layer,挂在编辑器插件面板(.atk-plug-panel-wrap)里。它既不是 + // 评论服务故障,也不该被改写成我们的故障卡片 —— 直接放行走 Artalk 原样式。 + // 曾经没这道判断时:这类层的文本不在 .error-message 里 → raw 读成空串 → + // 兜底判成 internal → 因为 internal !== network 就置灰整个评论区,随后 + // 数据正常返回又弹「评论服务已恢复」toast(读者视角:页面顿一下 + 莫名提示)。 + if (layer.closest('.atk-plug-panel-wrap, .atk-editor-plug-emoticons')) return; + var raw = ''; var em = layer.querySelector('.error-message'); if (em) raw = (em.innerText || em.textContent || '').trim(); @@ -236,8 +327,10 @@ ? fresh.msg.replace(/^评论服务暂时不可用(?:[((][^))]*[))])?[::]\s*/, '') : info.desc; - // 服务端故障(非读者自身网络问题)→ 禁用编辑器并挂说明横幅 - if (code !== 'network') setSvcDown(code); + // 服务端故障(非读者自身网络问题)→ 禁用编辑器并挂说明横幅。 + // 但「读不到任何可归因证据」时不下结论:raw 为空且结构化记录也没命中, + // 说明这是个我们识别不了的错误层,宁可只渲染卡片,也不要误置灰评论区。 + if (code !== 'network' && (raw || (fresh && fresh.code))) setSvcDown(code); // 原始「重试」节点:Vue 会整层重建,所以每次重新找; // 若本层已重写过,就从我们自己卡片里把它取回来(移动 DOM 保留已绑事件) @@ -501,8 +594,91 @@ window.loadScriptOnce = window.loadScriptOnce || function(src, globalName, callb document.head.appendChild(script); }; +/* ── 评论列表骨架屏 ──────────────────────────────────────────────────── + Artalk 初始化时会把 #Comments 整个清空(连服务端渲染出来的骨架屏一起清), + 而评论列表要等一次跨境 /api/v2/comments 往返才有内容 —— 这段时间评论区是 + 一片空白(本地实测空档约 1.0~1.5s,跨境只会更久),读者视角就是"进来啥也没有"。 + 这里在 Artalk 挂载后往 .atk-list-body 里补一份骨架,list-loaded / 服务故障 / + 12s 兜底时移除,把这段空档抹平。 + 延迟 120ms 才显示:命中缓存、极快返回的情况不会闪一下骨架。 */ +var LIST_SKELETON_HTML = + '