88 lines (55 loc) · 3.51 KB

GitHub Actions（自动化说明）

本仓库包含 2 个工作流：

1) 自动更新 Bing 壁纸列表

文件：.github/workflows/auto-bing.yml
频率：每天 UTC 01:00（北京时间 09:00）
作用：运行 node assets/js/bing.js，生成并提交：
- assets/json/images.js（window.BING_IMAGES = [...]）

页面加载时会读取 assets/json/images.js，轮播使用 Bing 壁纸作为背景。

2) WakaTime 日主题 + 周报数据（含 GitHub Models 点评）

文件：.github/workflows/daily-theme-update.yml
频率：每天 UTC 00:00（北京时间 08:00）
作用：运行 node .github/scripts/update-wakatime.js，生成并提交：
- assets/json/config.js（window.WAKATIME_CONFIG = {...}，用于日主题）
- assets/json/weekly.js（window.WAKATIME_WEEKLY = {...}，用于周报弹窗）

工作流支持手动触发

在 GitHub Actions 页面选择 WakaTime Daily Theme Update → Run workflow：

hours：手动指定当天编码小时（便于测试）
theme：手动指定主题名（rest/relaxed/productive/focused/intense/legendary）

GitHub Models

端点：https://models.github.ai/inference/chat/completions
默认模型：openai/gpt-4.1（可通过 MODEL_NAME 覆盖）
若调用失败，会自动回退到内置文案（不会阻塞周报文件生成）

Secrets / 变量清单

在仓库 Settings → Secrets and variables → Actions 配置：

名称	类型	必需	用途
`GH_TOKEN`	Secret	是	Actions 提交文件 + GitHub Models 调用授权（需要 `repo` + `models` scope）
`WAKATIME_TOKEN`	Secret	用于周报	拉取 WakaTime summaries 数据（支持 `waka_` API key 或 Bearer）
`MODEL_NAME`	Variable/Secret	否	覆盖 GitHub Models 模型名（默认 `openai/gpt-4.1`）
`MODEL_DEBUG`	Variable/Secret	否	设为 `1` 输出调试日志

配置 GH_TOKEN（图文步骤）

1. 生成 GitHub API 令牌

打开 Create Tokens，点击 Generate new token 创建令牌。

Note 填写备注；Expiration 选择 No expiration；Select scopes 勾选 repo，并额外勾选 models（用于 GitHub Models 调用）；点击 Generate Token。

2. 在仓库里创建 Actions Secrets

打开仓库 Settings → Secrets and variables → Actions。

点击 New repository secret：
- Name 填 GH_TOKEN
- Secret 填上一步生成的 Token

工作流权限

auto-bing.yml / daily-theme-update.yml 需要 contents: write 用于提交生成文件。
daily-theme-update.yml 额外声明 models: read。

常见问题

WakaTime Token 应该填什么？

WAKATIME_TOKEN 支持三种形式：

以 waka_ 开头的 API Key（会自动走 Basic Auth）
形如 Bearer xxx 的字符串
直接填 token 值（会按 Bearer 处理）

周报点评出现乱码/替代字符怎么办？

脚本会尽量清洗并截断 AI 文本，且在调用失败时回退到内置文案（不影响 weekly.js 生成）。
如需排查：在工作流里设置 MODEL_DEBUG=1，查看 Actions 日志里的模型返回内容。