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

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

---

## v1 · 2026-10-23

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

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

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

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

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

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

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