fix: ci - stabilize external link checks

.lychee.toml

@@ -5,6 +5,11 @@
 # be visible to readers. Generated tools, external snapshots and login-only pages
 # are excluded here instead of being repeated in workflow YAML.
 
+timeout = 20
+max_retries = 3
+retry_wait_time = 2
+max_concurrency = 32
+
 exclude_path = [
   '^\.history(/|$)',
   '^\.github/wiki(/|$)',

AGENTS.md

@@ -269,7 +269,7 @@ git push origin develop
 | prompts-library 报错 | 缺少 Python 依赖 | `pip install -r tools/prompts-library/requirements.txt` |
 | prompts-library 辅助脚本报 Google API 依赖错误 | 未安装脚本专用依赖 | `pip install -r tools/prompts-library/scripts/requirements.txt` |
 | CI markdown-lint 失败 | Markdown 规则违规或本地未按 `.github/lint_config.json` 校验 | 运行 `make lint`，按输出修复对应 Markdown |
-| CI link-checker 失败 | 文档中存在失效链接，或少数官方外链在 GitHub runner 上网络/TLS 不稳定 | 先本地验证链接；真实失效则修复 Markdown，已验证但 runner 不稳定的外链用 `.lychee.toml` 精确排除 |
+| CI link-checker 失败 | 文档中存在失效链接，或官方外链在 GitHub runner 上网络/TLS 不稳定 | 先本地验证链接；真实失效则修复 Markdown，runner 不稳定则优先调整 `.lychee.toml` 的重试、超时、并发或精确排除项 |
 
 ---
 

README.md

@@ -272,7 +272,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 
 - Markdown lint 配置：`.github/lint_config.json`
 - Markdown lint 版本：`Makefile` 中固定为 `markdownlint-cli@0.48.0`
-- 外部链接检查配置：`.lychee.toml`，排除生成物、外部仓库、指向 `tools/external/` 的软链接资产，以及已验证但 GitHub runner 网络不稳定的官方外链
+- 外部链接检查配置：`.lychee.toml`，统一管理外链检查的超时、重试、并发上限和排除项
 - CI 配置：`.github/workflows/ci.yml`，在 `develop` / `master` 分支的 push / pull_request 上运行 markdown-lint、本地链接检查、docs 结构检查与 link-checker
 - Codex 配置基线：`tools/config/.codex/README.md`，支持一键安装、自动备份和恢复。
 - Submodule 来源：`.gitmodules`