From fcf991086d09ca52a4fb04151598d94583bf735d Mon Sep 17 00:00:00 2001
From: tradecatlabs <288998340+tradecatlabs@users.noreply.github.com>
Date: Tue, 2 Jun 2026 04:45:26 +0800
Subject: [PATCH] fix: ci - exclude unstable opencost link

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

diff --git a/.lychee.toml b/.lychee.toml
index 4b9afb4..2045f03 100644
--- a/.lychee.toml
+++ b/.lychee.toml
@@ -26,4 +26,7 @@ exclude = [
   '^https://user-images\.githubusercontent\.com.*',
   '^https://notebooklm\.google\.com.*',
   '^https://www\.contributor-covenant\.org.*',
+  # Verified public documentation URL. GitHub-hosted lychee runners can fail this
+  # Netlify-backed site with TLS or connection errors while local curl returns 200.
+  '^https://opencost\.io/docs/?$',
 ]
diff --git a/AGENTS.md b/AGENTS.md
index 589e6e9..8c0d183 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 失败 | 文档中存在失效链接 | 检查并修复 Markdown 中的链接 |
+| CI link-checker 失败 | 文档中存在失效链接，或少数官方外链在 GitHub runner 上网络/TLS 不稳定 | 先本地验证链接；真实失效则修复 Markdown，已验证但 runner 不稳定的外链用 `.lychee.toml` 精确排除 |
 
 ---
 
diff --git a/README.md b/README.md
index 1bf76fc..a1819e3 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/` 的软链接资产
+- 外部链接检查配置：`.lychee.toml`，排除生成物、外部仓库、指向 `tools/external/` 的软链接资产，以及已验证但 GitHub runner 网络不稳定的官方外链
 - CI 配置：`.github/workflows/ci.yml`，在 `develop` / `master` 分支的 push / pull_request 上运行 markdown-lint、本地链接检查、docs 结构检查与 link-checker
 - Codex 配置基线：`tools/config/.codex/README.md`，支持一键安装、自动备份和恢复。
 - Submodule 来源：`.gitmodules`