修复失效链接

jamdesk fix 是 jamdesk broken-links 的自动修复配套命令。它读取相同的失效链接警告，并重写所有能够明确确定正确目标的文件。对于存在歧义的情况，它会标记为需要手动检查并保持不变。

它可以修复两种失效的内部链接：

• 拼写错误的锚点 — 目标页面中某个片段明显是实际标题的拼写错误（例如 #instalation → #installation）
• 跨语言锚点漂移 — 翻译页面重命名了标题，但该语言环境中的链接仍指向旧的英文片段（例如 /fr/ai/selectors#ai-strategies → /fr/ai/selectors#stratégies-ia）

步骤 1：查找失效链接

运行 jamdesk broken-links，查看需要修复的内容：

jamdesk broken-links

检查输出。jamdesk fix 会针对能够与实际标题匹配到可能正确锚点的警告进行处理。

步骤 2：预览修复内容

使用 --dry-run 运行，在修改任何文件前准确查看将发生的更改：

jamdesk fix --dry-run

示例输出：

Planned fixes:

  fr/ai/overview.mdx:9
    /fr/ai/selectors#ai-strategies  →  /fr/ai/selectors#stratégies-ia

(dry run — no files written)

检查每项计划中的修复。如果某项更改看起来不正确，请手动修复该链接，而不要应用此修复。jamdesk fix 只会重写能够明确解析的链接。

步骤 3：应用修复

不使用 --dry-run 运行即可应用修复。系统会提示你确认：

jamdesk fix

Apply 1 fix(es) to local files? (y/N)

按 y 写入更改。要在 CI 或脚本中跳过提示，请使用 -y：

jamdesk fix -y

应用后，命令会输出：

Fixed 1 file(s); 0 warning(s) left for manual review.

如果警告的目标存在歧义，jamdesk fix 会保持其不变，供你手动解决。

步骤 4：检查差异并提交

提交前检查更改：

git diff

确认每个重写后的链接都指向预期位置。然后提交：

git add -A
git commit -m "fix(docs): auto-fix broken internal links"

选项

接下来做什么？