From 6af6f67529bef417ae33759ebafaec0f99b3dd5a Mon Sep 17 00:00:00 2001
From: tradecatlabs <288998340+tradecatlabs@users.noreply.github.com>
Date: Tue, 2 Jun 2026 04:48:45 +0800
Subject: [PATCH] fix: ci - stabilize external link checks

---
 .lychee.toml | 5 +++++
 AGENTS.md    | 2 +-
 README.md    | 2 +-
 3 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/.lychee.toml b/.lychee.toml
index 2045f03..eefa633 100644
--- a/.lychee.toml
+++ b/.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(/|$)',
diff --git a/AGENTS.md b/AGENTS.md
index 8c0d183..ed42a9c 100644
--- a/AGENTS.md
+++ b/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` 的重试、超时、并发或精确排除项 |
 
 ---
 
diff --git a/README.md b/README.md
index a1819e3..7f488b3 100644
--- a/README.md
+++ b/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`