[MoMeak9]

将 VuePress 文档博客迁移为 Astro 静态站点，继续使用 Markdown 发布内容，采用 Chronicle 排版、双语界面与原生自由滚动，并完成移动适配、内容去重迁移、作者简介同步及 SEO/GEO 技术优化。

变更

• 沿用现有文档整理分支，并同步其远端历史。新审查 820 份源 Markdown：新增 516 篇、更新 7 篇、跳过 292 项，按请求排除抖音/法律目录 3 篇及 2 份私人或敏感文件。源目录只读；迁移工具重复执行待写入为 0。当前 791 份 Markdown，其中 789 篇文章、783 篇非空公开文章。
• 原 153 处缺失文档引用中，128 处按真实文章和 Git 重命名证据修复，25 处保留为普通文本；旧 VuePress .html 地址和标题锚点继续兼容。修复含字面 % 文件名的 Astro 预渲染请求，保留原文件名和文章地址。
• 统一 GitHub、Bilibili 和邮箱入口。首屏使用旋转线框与粒子 Canvas，并保留 SVG 后备。使用浏览器原生自由滚动，移除 Lenis 依赖、滚动阻尼及强制平滑；保留 GSAP 淡入/卡片错峰/分隔线与真实计数。动画元素不影响原生滚动锚定，浏览器页面缓存返回保留动画和阅读位置；支持减少动画及首屏离屏/菜单暂停。
• 关于作者完整迁入 GitHub 个人主页 README 的介绍、经历、AI 工程实践、技术栈和联系方式。英文正文保留原语言，来源版本记入 frontmatter，5 个 SVG 按相同版本原样保存并跟随站点主题；统一更新联系邮箱。
• 手机/平板提供 44px 触控目标、安全区留白、横滑分类、避免 iOS 聚焦缩放的搜索框、可自动收起且校准锚点的目录、短横屏菜单及独立代码/表格横滚。归档每页仅静态生成 12 张卡片，支持无 JS 分页；元数据和全文索引按需加载，归档 HTML 约 40KB。
• 用 Pagefind 1.5.2 替换全量 JSON 线性搜索：索引 783 篇公开文章的标题、正文、代码、摘要和标签，支持相关性排序、分类和安全的命中摘要。以引擎实际词表统一中英文界面查询，修复中文分词差异和无关逆向前缀匹配；传输元数据保留多空格文件名，自动摘要按完整 Unicode 字符簇截断。
• 离线索引在页面加载并空闲至少 5 秒后自动准备，不显示下载按钮；请求使用低优先级及单并发，输入/查询或隐藏标签页暂停，省流量及慢速网络延后，失败退避及配额停止，支持同版本续传。完整缓存就绪后可断网搜新词、筛选、分页、重载和阅读最近 20 篇已访问文章；版本化及项目范围隔离保留，删除原 4.2 MB 全量正文 JSON。
• 文章封面采用显式 cover 优先，仅首个正文段为图时兜底，无封面文章为文字卡片；首页、静态归档和本地搜索结果遵循同一规则，保留本地资源及部署路径。界面采用 PingFang SC / HarmonyOS_Regular / Helvetica Neue / Microsoft YaHei 系统字体栈，代码保留等宽字体，移除外部字体请求。
• 增加可信发布/更新日期、原文作者/维护者及可见来源，Blog/Person/BlogPosting/Breadcrumb JSON-LD、OG/Twitter 本地分享图、sitemap lastmod、RSS 日期语义、公开内容元数据与可选 llms.txt 索引。未知发布时间不以构建时间补造；不承诺搜索排名或 AI 引用提升。Mermaid 图示按需绘制并保留源码后备。
• 移除 VuePress/serverless 配置及 .idea 跟踪；GitHub Pages 已启用 Actions 发布源，main/master 合入后部署，PR 执行检查、构建和产物验收。

迁移审查报告 · 迁移工具

验证

• pnpm check：0 errors / 0 warnings。
• pnpm test：55/55 通过，包含 Markdown/路径、Unicode 摘要、查询分词、真实 Pagefind 词表、离线下载原子性/配额/更新和作用域隔离。
• BASE_PATH=/MyBlogDoc/ SITE_URL=https://momeak9.github.io pnpm build：1,718 个页面构建成功；构建后自动生成 Pagefind 与离线资源包。
• pnpm test:build：12/12 通过，覆盖所有文章、分页、旧链接、静态资源、JSON-LD、可见作者/日期/面包屑、canonical/hreflang、sitemap lastmod、RSS 和内容索引。
• 浏览器矩阵：320、360、390、430、768、1024px 布局及手机横屏无页面横向溢出；触控筛选、按需全文搜索、分页、目录折叠/定位、SVG、真实 Mermaid 图示和无 JS 分页均通过，无客户端 JS 错误。
• 原生滚轮、键盘、移动端触摸、目录定位，以及普通历史返回与真实 BFCache 返回已验证；滚轮停止后没有脚本惯性位移。
• 关于作者正文的全部可见文字与源 README 核对一致；SVG 的 Git blob 哈希与源版本一致。320、390、768、1280px、站点手动主题切换、英文界面及无 JS 内容展示均通过。
• 真实浏览器：10 组中文/英文/混合查询的中英文结果排序一致；含代码检索、相关摘要高亮、无结果、输入法、快速输入与字面 % 地址。下载后断网搜索此前未搜词、筛选/结果分页/重载/英文界面/已访问文章阅读均通过，移动端无溢出，未启用 JS 时保留静态归档。
• 最新封面/字体/后台离线验收：首段图与显式封面优先级、文字开头/后续插图排除、SSR/搜索封面一致、实际 9/783 篇封面；初始无全量预取、输入暂停、空闲自动恢复、无按钮及断网新查询、移动端无溢出均通过。
• 523 篇迁入/更新稿的来源 hash、mtime、原 frontmatter 和图像资源完整性已审计，抖音/法律目录及排除文件不在目标目录。

合入 main 后由 GitHub Pages 工作流部署。Google 的 AI 指南不要求特殊 AI 文件；llms.txt 作为可选内容导航而非排名策略。项目子路径 robots.txt 不能控制域名根路径的抓取策略，详细说明见 README。