Files
hoelee-blog/docs/consultant-review/reports/report-batch-05.md
T

4.7 KiB
Raw Blame History

blog.hoelee.com 外部顾问审阅报告 — Batch-05(DevOps 11 篇专项)

对应资料包:原 docs/consultant-review/batches/batch-05.md(共 11 篇,中英双语对照)
审批状态:已全量采纳并落地修改,11 篇均在 audit-tracker.json 中标记为 approved。


逐篇审阅意见与落地执行总结

序号 文章 Slug 顾问结论 落地执行措施
01 space-reclamation-wasnt-stuck-it-was-waiting 需微调 1. 修正容量释放口径:区分早间快照轮转(115.8 GiB)与回收站清空(5.0 GiB),与采样表加总(120.8 GiB,约 121 GiB)严格对齐;
2. 修复中文版文末内链 /zh/ 前缀;
3. 中英文版末尾补齐存储与快照容量审计双轨 CTA,frontmatter 增加 dynamicCta: true。
02 synology-spreadsheet-api-is-a-container 需微调 1. 修复中文版代码块误脱敏:将两处 curl 命令中被误替换为 *** 的字面量全部还原为与英文版一致的 $TOKEN 变量;
2. frontmatter 补齐 dynamicCta: true。
03 that-dying-ssd-was-just-a-bad-sata-cable 需微调 1. 消除英文版禁用词:将结尾出现的 home server 与 a rig 替换为 an on-premise server 与 a host;
2. 修正中文错别字:将“内存在...”修正为“内核在(the kernel)”;
3. 中英文版文末补齐存储 I/O 与链路排障双轨 CTA,frontmatter 补齐 dynamicCta: true。
04 the-cause-was-trim-not-the-ssds 需重点修订 1. 消除悬空看门狗提示:删除文末不存在的 watchdog 详情提示,交代统一在每日定时脚本中告警三项指标;
2. 跨篇因果闭环:补充解释无论底层是 PCIe 超时全零页还是 NCQ TRIM 固件抹零,任何 4 KiB 全零页的 CRC32C 均固定为 0x8941f998;
3. 修复时间线矛盾:首段修正为说明事故发生于两周前;
4. 修复中文内链 /zh/ 前缀,补齐双轨 CTA 与 frontmatter。
05 the-upstream-was-deleted-then-came-back-rewritten 需微调 1. 修复英文版有序列表排版:对 1. 至 8. 列表补充换行符,防止渲染坍缩为单段;
2. 修正时间跨度:由“四周”微调为更严密的“三周(three weeks)”;
3. frontmatter 补齐 dynamicCta: true。
06 unraid-stop-array-hangs-on-swapfile 需重点修订 1. 纠正 Unraid 技术机制反向解释:明确 At First Array Start Only 只在机器启动后首次触发,纯 GUI 停止/启动循环不会运行;
2. 脚本 2 调度正确选为 At Startup of Array,并使用 losetup -j 幂等检测;
3. frontmatter 补齐 dynamicCta: true。
07 uploading-large-videos-to-youtube-via-cdp 需重点修订 1. 消除英文绝对禁用词:将 homelabs 替换为 self-hosted Synology and Unraid nodes;
2. 超长代码折叠:第 4 节 50 行 Python 归档注入脚本按规范采用 <details><summary> 原生折叠并标明行数;
3. 中英文版末尾补齐媒体与浏览器自动化流水线双轨 CTA,frontmatter 补齐 dynamicCta: true。
08 vetting-an-open-source-dependency-before-you-bet-on-it 通过(微调) 1. 首尾数字呼应调整:将结尾“六个假设被修正”调整为“通过六项检查纠偏了那三个核心假设”,英文版代码行数统一为 1,306-line;
2. frontmatter 补齐 dynamicCta: true。
09 when-smart-says-healthy-but-your-raid-is-corrupting-data 需微调 1. 顶部更新日期修正为 2026-09-18,更新章节增加指向续篇 TRIM 根因的衔接;
2. 中英文版文末补齐端到端存储恢复验证双轨 CTA,frontmatter 补齐 draft: false 与 dynamicCta: true。
10 why-chrome-forgets-its-tabs-in-a-container 需微调 1. 超长代码折叠:tabs_keeper.py 42 行代码块使用 <details><summary> 原生折叠;
2. 中文版文末内链修正为中文路径 /posts/zh/scraping-bot-walled-marketplace-warm-browser-session/;
3. frontmatter 补齐 dynamicCta: true。
11 why-telegram-bot-notifications-die 需重点修订 1. 消除中文标题绝对禁用词:将“一个折腾了一整天的 400”改为“一个追查了一整天的 400”;
2. 修正 Python bytes.join 原理说明:明确按行切分与分隔符篡改 JPEG \n/\r 边界导致畸形包;给出 b"".join(parts) 二进制分块拼装标准代码(< 20 行);
3. 闭环悬案与网络排障逻辑:交代 docker exec 测试因使用简单小样本绕过边界 bug,梳理 IPv6 与 HTTP 400 时序;弱化个人玩具口吻;
4. frontmatter 补齐 draft: false 与 dynamicCta: true。