31 lines
2.4 KiB
Markdown
Executable File
31 lines
2.4 KiB
Markdown
Executable File
# TTSHOP 同步脚本
|
||
|
||
TTSHOP 的代码仓库地址为 `git.ops.roasbloom.site`，报告目录地址为 `ops.roasbloom.site/<仓库名>/`；本仓库对应的报告目录为 `ops.roasbloom.site/ttshop/`。
|
||
|
||
`sync.py` 使用 Python 标准库和 `requests` 读取公开 Google Sheets 工作簿，并把所有工作表合并成一个 UTF-8 HTML 表格，固定写入 `data/merged.html`。生成的 `data/merged.html` 供 Google Sheets 的 `IMPORTHTML` 使用，不改成 `index.html` 或 `data.json`。工作表名称和顺序来自 XLSX 导出，单元格使用公开 gviz 接口返回的显示值。
|
||
|
||
合并规则：每张表第一行是标题；列按首次出现顺序取并集；源表已有的 `LinkName` 会改名为 `LinkName_Source`、`LinkName_Source_2` 等并保留；脚本最后追加生成的 `LinkName` 列。HTML 文本会进行转义。内容没有变化时不产生 Git 提交，变化时只提交 `data/merged.html` 并推送到 `main`。
|
||
|
||
## AgentStage 自动更新
|
||
|
||
AgentStage 服务器会自动执行仓库根目录的 `update.sh`，不使用 Gitea Actions workflow。`update.sh` 会进入脚本所在目录并使用 `python3` 执行 `sync.py`；脚本失败时会以非零状态退出。
|
||
|
||
`schedule.conf` 是一个表示间隔小时数的数字：默认值为 `1`（每小时一次），本仓库设置为 `24`，表示每天刷新一次。服务器执行更新后，报告可从 `ops.roasbloom.site/<仓库名>/` 访问。
|
||
|
||
## 本地运行
|
||
|
||
```sh
|
||
python3 -m pip install -r requirements.txt
|
||
./update.sh
|
||
```
|
||
|
||
脚本默认使用固定工作簿 ID `1DPbdVsX3SG_kgDXs2j34mDAgplRSfcAWKKG9yqalFmw`、仓库 `ttshop`、分支 `main` 和输出路径 `data/merged.html`。本地运行需要当前目录是该仓库，并且 Git 已配置可推送的 `origin`；不要把凭据写入 remote URL。
|
||
|
||
## 环境变量
|
||
|
||
- `GIT_CREDENTIAL_SECRET`：可选的 Git 密码/token。脚本通过临时 `GIT_ASKPASS` 使用，不写入 URL、日志或提交文件。
|
||
- `GITEA_OWNER`：Git askpass 的用户名提示值。
|
||
- `SYNC_FAILURE_WEBHOOK_URL`：可选的失败通知 URL。失败时最多发送一次简短通知，通知失败不会覆盖原始异常。
|
||
|
||
AgentStage 运行不需要 Gitea Actions、Google OAuth 或 Google 服务账号。请勿把 token、密码或其他密钥写入脚本、仓库 URL、提交文件或日志；本地密钥和临时文件应被 `.gitignore` 规则忽略，避免进入提交。
|