4xx 非重试错误（404）应立即放弃，不再发起第二次请求。

集成测：本地服务器发起 302 跳到非白名单域名；下载客户端必须拒绝。 注意：合入 #52（PR #80）后，doDownload 入口会先校验 URL 前缀， 所以本测试中 redirector.URL（非 github 前缀）会在到达重定向逻辑前就被拒绝。 这意味着本测试的"零 hit"保证由

非白名单 URL 必须在 doDownload 入口就被拒，不能打到网络。

500 服务器首两次 503，第三次 200 —— doDownload 应在第 3 次尝试拿到成功。

404：明确的"文件不存在"信号 → 调用方可以安全走 create 路径

核心回归：撞二级限流（403）/ 429 / 5xx 时，必须返回非 nil 且非 errRemoteFileNotFound 的错误。否则 uploadToGitHub 会把它当成"文件不存在"，走 create 路径对已有文件 发无 sha PUT —— 触发 GitHub 422（正是 iss

核心回归 #2：stream cancel / 5xx / 403 等瞬时错误应该在 getGithubFileSHA 内部 透明重试。前两次 503、第三次 200 模拟 GitHub secondary rate limit 恢复过程。

200 + 有 sha：返回 (sha, nil) 供 uploadToGitHub 进入"对比跳过"路径

─── 重定向域名白名单（#53 / PR #81） ────────────────────────────────────────

TestInjectKatexCSS_AlreadyHasLink 主题已经引了 katex CSS → 不重复注入。

TestInjectKatexCSS_Disabled 开关关 → 即使含公式也不注入（由主题自行负责）。

TestInjectKatexCSS_NoMath 不含公式 → 不注入（节省一个 stylesheet 请求）。

TestInjectKatexCSS_WithMath 含 KaTeX 公式且开关开 → 注入 katex.min.css 到 head。

TestKatexBlockRendered 块级公式 `$$\n...\n$$` 应该被渲染，且不嵌在 <p> 里。

TestKatexBlockSingleLine 单行 `$$ x $$` 也应该被识别成块级。

TestKatexCacheReuse 第二次渲染同一公式应该走缓存（耗时显著小于第一次）。

TestKatexCrossLineInlineRejected 跨行的 `$x\n$` 不应该被当公式。

TestKatexInlineDisplayInParagraph 同行 `$$x$$` 在段落里应该用 display 模式渲染。

TestKatexInlineRendered 行内公式 `$x$` 应该被渲染成 KaTeX HTML。

TestKatexInlineWhitespaceBoundary `$ x$` 和 `$x $` 都不应该开/闭公式。

TestKatexInsideCodeBlockNotRendered 代码块里的 `$x$` 不应该被渲染成公式。

TestKatexLiteralDollarNotConsumed issue 108 同类回归保护： `It costs $10 and $20.` 这种字面美元符号不能被当成公式起点吞掉。

TestNormalizeFileName 验证 repo 入口归一：去掉末尾 .md（含历史遗留的多重 .md）， 大小写敏感（只剥小写 .md，与 save 补的小写 .md 对齐），中间的 .md 保留。 这是 #122 的核心——保证 repo 内部 FileName 始终是裸名。

TestNormalizeFileName verifies that normalizeFileName strips any trailing ".md" extension(s) so callers can pass either "hello-world" or "hello-world.

─── SHA256 完整性校验（#54 / PR #82） ────────────────────────────────────────

核心回归场景（#39）：调用方在 GetSetting 返回值上 InjectCredentials 注入 token， 再次 GetSetting 不应看到这个 token —— 前端侧永远拿不到敏感字段。

Save 阶段也要走 Clone：调用方保存后继续修改入参 map，不应影响 cache。

核心回归：InjectCredentials 注入 token 后，只影响传入的 setting，不污染原始 map。

SlugifyName 产出的所有 slug 都必须满足 ValidateSlug —— 这是两个函数之间的约定。

关键修复：连续两次下载（第一次成功、第二次失败）后，readyPath 不应指向第一次的文件。

不同 host 互不影响

Issue #99：仅大小写不同的 Name / Slug 在 macOS/Windows 默认大小写不敏感的 文件系统上会互相覆盖页面，必须判重。

─── Tag 唯一性检查 ───────────────────────────────────────────────────────────

WriteFileAtomic 调用完后，目标路径立刻被标记成 self-write。 这是 ResourceWatcher 过滤自激事件的契约入口。

UnmarshalJSON 自定义反序列化：对老配置（缺 katexEnabled 字段）默认开 KaTeX。 这样从 v1.2.0 之前升级过来的站点不需要手动到主题设置里打开开关。

UnmarshalJSON 自定义反序列化逻辑，专治历史技术债

Update 更新条目

Update 更新菜单

Update 更新分类（按 ID 查找）

Update 更新闪念

Update 更新友链