Add private operations portal and weekly accounting reports

2026-11-03 16:45:50 +08:00
parent 10c4487463
commit 20aea13054
18 changed files with 958 additions and 0 deletions
@@ -0,0 +1,21 @@
+# 运营周报
+
+每周五北京时间 20:00 生成报告，覆盖上周五 20:00 到本周五 20:00。阶段快照只覆盖截至生成时的部分周期，历史周报不覆盖改写。
+
+```bash
+python3 ops/report.py --data-dir "$PAWPLAY_OPS_DATA" --snapshot
+python3 ops/report.py --data-dir "$PAWPLAY_OPS_DATA" --notify
+python3 -m unittest discover -s ops -p 'test_*.py' -v
+```
+
+数据放在仓库外的私有目录，不加入 Git 或镜像。运营门户只读挂载该目录；格式见 `ops-portal/README.md`。`collector.json` 为本机采集配置，不由网站 API 返回，可包含 `repository`、`thread_id`、`codex_sessions_dir`、`backup_dir`、`bark_script` 和 `portal_url`。只保存模型用量汇总，不把对话、密钥或浏览器会话作为报告内容。
+
+`findings.json` 的 `checked_at` 标注证据核验时间；`highlights` 可用字符串或 `{date,text}` 事件。过期成果不会重复计为本周完成。任务和风险持续保留，直到其状态有证据更新。
+
+套餐按 200 美元/月、跨月实际时间和项目分摊比例记固定成本。周额度重置不产生新周费，套餐内 token 不按 API 单价重复计费。缓存输入、推理输出作为用量单列，不重复相加；日志计数不等于周额度百分比。额外 API、实际现金支出、已结算收入、预估收入分别记账。未知值使用 `null`，不当作零成本或零收入。
+
+收入条目使用 `direction: income`、`basis: settled`，支出使用 `direction: expense`；`date` 使用含时区的时间戳。不同货币不直接相减；未确认汇率和完整支出前不宣称净利润。当前免费自研 App 的原创介绍正常推进，创作激励适用性按当前账号及具体稿件后台核验，不能仅凭旧公告预设无收益。
+
+安装两个 systemd user unit 前，配置受保护的 `~/.config/pawplay-ops/report.env`，其中 `PAWPLAY_REPO` 指向项目目录，`PAWPLAY_OPS_DATA` 指向私有数据目录。`Persistent=true` 会在错过计划时间后补跑最近一期；不会追补所有历史周次。配置 `backup_dir` 时，生成报告同时将报告和账本复制到独立备份目录。
+
+周报是数据归档任务，不会自动投稿、购买服务、生成视频或修改应用。发布稿件后，在 `content.json` 登记 BV 号；当前播放数据采集未接入，有已发布稿件时相关指标保留待核验。平台结算数据须按实际到账或后台结果记账。