夜间 Token 燃尽工作流 — 自动消耗配额 + README 增强 + 晨报推送 + 复盘归档

⚠️ 兼容性提示：仅支持 Linux / macOS（需要 bash + crontab）。Windows 用户请使用 WSL 或 Git Bash。

---

• 快速开始
• 目录结构
• 核心脚本
• 环境变量
• 定时任务
• 输出产物
• 常见问题

---

# 1. 克隆仓库
git clone https://cnb.cool/cnbll/nightly-token-burn-workflow-skill.git
cd nightly-token-burn-workflow-skill

# 2. 安装定时任务
bash scripts/install-cron.sh

# 3. 配置 Token
export CNB_TOKEN="your_token_here"

# 4. 手动测试（dry-run 模式）
NIGHTLY_DRY_RUN=true bash scripts/run-nightly-burn.sh

---

nightly-token-burn-workflow-skill/
├── SKILL.md                       # Skill 规格文档（开发者参考）
├── README.md                      # 本文件（用户参考）
├── scripts/
│   ├── run-nightly-burn.sh        # ⭐ 主循环（含熔断）
│   ├── finalize-nightly.sh        # ⭐ 窗口收口
│   ├── send-morning-brief.sh      # ⭐ 晨报推送
│   ├── install-cron.sh            # ⭐ 定时任务安装（幂等）
│   └── publish-to-cnbll.sh        # 增量发布到 CNB
├── references/
│   ├── prompt-catalog.md          # Prompt 模板目录
│   ├── prompt-log-template.md     # 台账模板
│   ├── retro-template.md          # 复盘模板
│   └── pr-template.md             # PR 模板
└── examples/output/               # 示例产出

安装路径：推荐安装到 ~/.openclaw/workspace/nightly-token-burn/（由 install-cron.sh 自动管理）

---

脚本	作用	何时运行
run-nightly-burn.sh	双窗口主循环 + Token 熔断	由 cron 自动触发
finalize-nightly.sh	汇总台账、生成复盘	主循环结束后自动调用
send-morning-brief.sh	晨报推送（企微/OpenClaw）	收口后自动调用
install-cron.sh	安装/卸载定时任务	一次性安装

---

变量	必填	默认值	说明
CNB_TOKEN	✅	—	CNB API Token
CNB_API_ENDPOINT		https://api.cnb.cool	API 地址
OPENCLAW_WORKSPACE		~/.openclaw/workspace	工作区根目录
NIGHTLY_TOKEN_BUDGET		0（不限）	单窗口 Token 上限
NIGHTLY_TOKEN_THRESHOLD_PCT		80	预警阈值百分比
NIGHTLY_ORG_SCOPE		cnbll	扫描组织列表
NIGHTLY_DRY_RUN		false	Dry-run 模式
NIGHTLY_FORCE		false	忽略锁文件强制执行

---

安装后自动在以下时间执行：

窗口	时间	Token 上限	主要任务
W1	22:30 每日	50%	README 增强 + 轻量复审
W2	03:30 每日	85%	深度代码复审 + 全仓复审

bash scripts/install-cron.sh --uninstall

---

路径	说明
logs/nightly-YYYY-MM-DD.log	主运行日志
logs/error-YYYY-MM-DD.log	错误日志
logs/circuit-breaker.log	熔断事件记录
output/audit-log-YYYY-MM-DD.md	每日台账
output/workflow-retro-YYYY-MM-DD.md	每日复盘

---

Q: 脚本报 command not found: crontab
A: Ubuntu/Debian: sudo apt install cronie；macOS: 系统自带，无需安装

Q: Windows 能用吗？
A: 原生不支持，请安装 WSL2 或使用 Git Bash

Q: Token 消耗太快怎么办？
A: 设置 NIGHTLY_TOKEN_BUDGET=50000（具体数值根据配额调整）

Q: 如何查看定时任务是否正常运行？
A: crontab -l 查看已安装的任务；logs/ 目录下查看运行日志