# 记录卡片 card-001：一次研究文档链接404修复：维护者演练

- 做的事：维护者用本项目已完成的研究链接修复作建卡演练；2026-10-23整理公开页面与内容文档，不是用户口述，也不声称当天才完成修复。
- 创建：2026-10-23
- 当前版本：v2

---

## v1 · 2026-10-23

### 核心要点
[公开观察 F1/F2/F4] 仓库研究文档存在，不等于网站同一路径有页面；当前页面把文档链接指向可打开的GitHub目标。

### 机理
[公开观察 F1/F2/F4 ＋ 助手整理] 内容Markdown保留相对 docs/ 链接；未映射的站内文档路径返回404；当前页面的实际href指向内容仓库固定提交，因此读者可以打开对应文档。这里描述可观察结果，不涉及网站私有实现。

### 具体方法
[助手根据公开观察整理的通用方法；非用户确认]
1. 从公开内容文档和公开页面分别读取链接。
2. 区分仓库文件路径与网站实际发布路径。
3. 仓库文档可使用已确认存在的固定提交GitHub地址。
4. 打开最终目标核对内容；示例看板继续使用实际站内资源地址。

### 使用范围·适用
[助手编辑提炼，未获受访者确认] 内容仓库与网站发布范围不同、需要让读者找到对应版本文档的知识站点。

### 使用范围·不适用
[助手编辑提炼，未获受访者确认] 不用于任意把站内页面改成外链；文件存在也不能替代最终链接和目标内容检查。

### 原话摘录
> （本次访谈无摘录）

### AI 补充与提炼
> 演练声明：正文由助手根据公开页面和公开内容文档结构化整理，不是用户口述；未进行人工访谈或逐段确认。
> 方法与适用边界是助手编辑提炼，尚未作为受访者观点采纳。原话摘录为空，默认占位不代表发生过访谈。

## v2 · 2026-10-23

> 变更：[维护者演练修订，非用户原话] 增加固定版本与读者实际点击目标的区分；明确公开观察能证明什么、不能证明什么。

### 核心要点
[AI编辑提炼，未获受访者确认] 修链接时，同时检查读者能不能打开，以及打开的是不是这版内容。

### 机理
[公开观察 F1/F2/F3/F4 ＋ AI编辑提炼]
文件层：内容仓库存在研究文档。
链接层：未映射的站内路径404，当前公开页面已给出固定提交的GitHub文档目标。
版本层：固定提交使引用与导入内容版本绑定；HTTP200只证明可访问，仍需核对页面是否为预期文档。

### 具体方法
[公开观察 ＋ AI编辑提炼]
1. 保留v1的公开链接分类。
2. 比较公开Markdown里的相对href与公开页面最终href。
3. 打开实际GitHub目标，核对固定提交与文档身份。
4. 将失败的旧路径与当前可打开目标分别记录，避免把旧路径404说成当前页面仍坏。
5. 对查询参数、锚点等变体应另行验证；本演练没有宣称测试这些变体。

### 使用范围·适用
[助手编辑提炼，未获受访者确认] 内容仓库与网站发布范围不同、需要让读者找到对应版本文档的知识站点。

### 使用范围·不适用
[AI编辑提炼，未获受访者确认] 单个案例的链接观察不代表全站链接审计；没有实际检查的锚点、重定向、访问权限和其他页面，不扩写为已通过。

### 原话摘录
> （本次访谈无摘录）

### AI 补充与提炼
> 演练声明继续有效：没有用户口述或人工访谈；v2是助手对公开资料的编辑修订，不是用户采纳后的访谈终稿。
> F1至F4来自本轮公开页面、内容仓库文档与URL状态；没有引入私有仓库、内部测试或未公开源码。
> “文件／链接／版本三层”是助手新增的分析框架，未经受访者确认，不冒充维护者原话。
> v1原文完整保留；本版通过replace-ai-notes替换当前说明，展示历史与新说明分别保存。