From d2c155927cbcffd4f812cb5b1f270b7af116b3dd Mon Sep 17 00:00:00 2001 From: Vaica <94612053+zqlit@users.noreply.github.com> Date: Wed, 21 Jan 2026 13:14:15 +0800 Subject: [PATCH] Update README.md --- README.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/README.md b/README.md index 52712c7c..5a5070a3 100644 --- a/README.md +++ b/README.md @@ -148,3 +148,37 @@ RSS 地址: `https://usj.cc/rss.xml` 1. 扫描 `content/post` 下所有 Markdown 文件。 2. 如果文章包含 `status: hidden` 但没有 `draft: true`,自动添加 `draft: true`。 3. 用于批量确保“隐藏”的文章不被 Hugo 生成。 + +### 6.6 自动更新友链 JSON (`scripts/update_link_lite_json.ps1`) +根据 `themes/Ying/data/links.yaml` 自动生成 `themes/Ying/static/json/link_lite.json`。 + +* **用法**: + ```powershell + ./scripts/update_link_lite_json.ps1 + ``` +* **功能**: + 1. 读取 YAML 格式的友链数据。 + 2. 转换为 Friend-Circle-Lite 所需的 JSON 格式。 + 3. 通常在部署前自动运行。 + +### 6.7 刷新多吉云 CDN (`scripts/RefreshCDN.py`) +用于在部署完成后自动刷新 CDN 缓存。 + +* **用法**: + 通常由 GitHub Actions 自动调用,不建议手动运行。 + 需要环境变量: `DOGECLOUD_ACCESS_KEY`, `DOGECLOUD_SECRET_KEY`, `CDN_URL_LIST`. + +## 7. 自动化部署 (GitHub Actions) + +本项目配置了完整的 CI/CD 流程 (`.github/workflows/upy.yml`),主要包含以下步骤: + +1. **环境准备**: 安装 Hugo, Python, PowerShell。 +2. **预构建检查**: + * 运行 `update_link_lite_json.ps1` 确保友链数据最新。 + * 运行 `add_draft_to_hidden.ps1` 确保隐藏文章安全。 +3. **构建**: 运行 `hugo --minify` 生成静态文件。 +4. **部署**: 将 `public` 目录推送到又拍云 (UpYun)。 +5. **刷新缓存**: 部署成功后,调用多吉云 (DogeCloud) API 刷新 CDN 节点。 + +> **注意**: 友链健康检查 (`scripts/check_links.js`) 仅作为本地工具 (`deploy.ps1`) 运行,不会阻断线上部署流程。 +