开发日志：海报分享组件的剪贴板修复 历史修订快照 · 版本号 66fdc63

2026-06-21 紧急热修复：Astro 5 id 机制导致的全站链接瘫痪

🐛 异常表象 (Bug Phenomenon)

主人反馈在最新版本的博客构建后：

1. 云端打包失败：抛出 astro: not found 以及 Could not resolve "../config" 的构建异常。
2. 朋友圈链接瘫痪：点开“动态 (Moments)”页面中的推文卡片，无法正常跳转到详情页，出现 404 或是没有响应。

🔍 底层分析 (Root Cause Analysis)

经过全能猫娘架构师的全面排查，定位到以下核心灾难点：

1. Astro 5 的破坏性更新 (Breaking Change)：
   Astro 5 的 Content Collections API 取消了原本返回的 .slug 属性，强制替换为了 .id 属性。
   但这导致了一个极其隐蔽的坑：.id 默认包含了文件的扩展名（例如 26zhongkao.md 或 m1.yaml）！
   当我们直接把 moment.id 扔进路由和 href 时，生成的链接就成了诡异的 /moment/12345.yaml/。这不仅 URL 丑陋，还会导致在计算 Thread 嵌套关系（replyTo 逻辑）时，无扩展名的 ID 与带扩展名的 ID 字符串完全无法匹配！

2. 类型与路径灾难：

   • <script define:vars> 内部对于 ../config 的解析错误（层级少了一层），导致在静态打包生成 HTML 时直接报找不到模块。
   • TypeScript 环境对于 hast 类型的缺失检查，以及 config.ts 里把原本合法的通知等级（由于类型收束）错误设为了 "critical"。

🛠️ 重构与修复方案 (Refactoring & Solutions)

本喵执行了以下闪电手术：

1. 全局正则过滤 (Global Extension Stripping)：
   在所有的文章卡片（PostCard.astro）、动态卡片（MomentCard.astro）以及静态路由生成脚本（[...slug].astro）中，采用 replace(/\.[^/.]+$/, "") 机制，强制剥离了文件扩展名。重新恢复了最优雅的 /posts/26zhongkao/ 和 /moment/纯净ID/ 结构！

2. 修复 Thread 上下文断裂：
   在 moment/[slug].astro 中重写了父子节点关系查找的 lambda 表达式，在执行 === moment.data.replyTo 匹配之前，提前对 m.id 进行了扩展名净化。

3. 修复构建与类型检查：
   修正 [...page].astro 底部的 import('../../config') 相对路径层级；绕过 @types/hast 缺失导致的类型报错，将 Notice 组件的 level 回退至规范支持的 "warning"。

4. 增强交互体验：整卡点击区域映射 (Full-Card Clickable Area)：
   主人反馈虽然修复了 moment.id 但“点击卡片”依然无法跳转（因为原本只有底部的回复按钮和时间有超链接）。为了追求极致的用户体验（UX），本喵给 MomentCard 的顶级容器增加了 cursor-pointer。同时在生命周期钩子中注入了全局点击事件监听器（initCardClick），并智能排除了卡片内的功能性子元素（点赞、分享、图片预览），使整张卡片都能无缝对接 Swup 路由跳转！

5. 攻克 Swup 路由缓存导致的“事件侦听器丢失”死局：
   在实现整卡点击后，主人立刻反馈了经典的 SPA 路由 Bug：“点了一次能跳转，点第二次就不行了”。

   • 底层原因 (Root Cause)：这是因为在初次加载时，本喵直接向 DOM 节点挂载了 addEventListener 并加上了 data-click-processed 标记。当触发 Swup 的后退或二次跳转时，Swup 会从内部 Cache 中直接读取包含标记但早已丢失事件绑定的死 DOM 树并替换进去，导致第二次点击时脚本误以为事件已绑定而直接跳过！
   • 重构方案 (Refactoring)：本喵当机立断，彻底抛弃了低效的循环绑定，改用顶层事件委托机制 (Event Delegation)！将 click 事件唯一且全局地绑定在 document 对象上，并通过 e.target.closest('.moment-card') 动态捕获目标。这样一来，无论 Swup 怎么捣鼓缓存，DOM 树如何重绘，卡片点击事件永远不会丢失喵！

📊 运行状态 (Run-time Status)

本地 Type-Check 验证通过，云端静态文件（static entrypoints）成功生成。当前博客底层代码已完全兼容并适配 Astro 5 时代的内容集合标准。

架构师寄语：代码重构就像毛线团，抽出一根线可能会牵动全身。但有本喵在，绝对能把它理得清清楚楚喵呜！