data_agent · 更新日志 & 能力总览

HakkoAI 数据/分析工具箱（海外为主，数据源 ByteHouse 柔佛 Johor）。
本文件永久存档：能力描述 + 工作流程 + 全部更新日志（按主题归并）。
最后更新：2026-06-01

一、这是什么

HakkoAI 的数据/分析工具箱——从数据仓库拉数 → 按统一口径(canon)算指标 → 渲染报告 →

部署 Cloudflare Pages → 推送飞书。覆盖海外业务为主（ByteHouse 柔佛 Johor）。

二、数据源

源	用途
ByteHouse Johor（`mindcraft` / `uba_production_default` / `atlas`）	用户 / 订单 / 行为事件 / 广告花费 —— 业务指标主源
Cloudflare D1	全渠道用户反馈池（LLM 分类后）
Stripe / Apple / Google Play API	订阅 SKU 逐笔实收对账
飞书表格	目标值（严口径预估）、中国手填数据

三、核心能力

canon 口径中枢 —— docs/kpi_canon/（KPI_HAKKO_JOHOR.md 等）是单一口径源：

DAU/MAU 严口径（DataFinder 虚拟事件）、收入（§5 mindcraft 白名单）、留存、UGC、渠道归因。

有 pre-commit hook 自动校验新代码 SQL 是否符合口径。

三档定时报告：
日报：核心 KPI / 新增 / 活跃 / 付费 / 对话 / 内容 / 反馈 / 质量监控
周报：MTD 进度对照飞书目标（本月各周进度表）
月报：月度业务复盘 + 月度用户体验报告（综合 feedback agent）
反馈 agent：6 渠道拉取（端内 / 邮件 / Discord / App Store / Google Play / NPS）

→ D1 → Doubao Seed 2.0 Pro LLM 分类（情感 / 话题 / P0–P1 优先级）→ 日报段 + 月报。

实时看板 /live：D1 增量 ETL + 真广告归因 ROI / CAC（Google Ads + TikTok 花费）。
订阅对账：Stripe / Apple / Google 三平台 SKU 生命周期 + MRR/ARR 审计。
运维监控：多地可用性（每 10 分钟）、CF 下载→安装转化监控。

四、工作流程（以日报为例）

GitHub Actions cron（每天北京 06:00）
  → run_daily_report_v2.py     拉 ByteHouse（canon 严口径 SQL）
  → feedback_*.py              拉 6 渠道 → D1 → LLM 分类
  → render_daily_report_v2.py  渲染浅色 HTML（移动端适配）
  → deploy_daily_to_pages.py   wrangler → Cloudflare Pages
  → 飞书群推送卡片摘要 + Pages 链接

周报（周一 10:00）、月报（1 号 02:00）同构。全链路 UTC+8；

发布只走 Cloudflare Pages + 飞书（页面需 @hakko.ai 邮箱过 Cloudflare Access）。

五、活跃定时任务（`.github/workflows/`）

workflow	周期(UTC)	北京时间
`daily_report`	`0 22 * * *`	每天 06:00
`weekly_report`	`7 2 * * 1`	周一 10:07
`monthly_report`	`0 18 1 * *`	每月 1 号 02:00
`sync_subscriptions`	`30 4 * * *`	每天 12:30
`sync_ad_spend`	`0 3,15 * * *`	每天 11:00 / 23:00
`feedback_pull_discord`	`0 4 * * *`	每天 12:00
`cf_download_monitor`	`0 3 * * *`	每天 11:00
`hakko-monitor`	`/10 * * *`	每 10 分钟

六、线上产物

产物	URL（需 @hakko.ai 邮箱过 CF Access）	形态
日报	https://hakko-daily-report.pages.dev/	静态报告(Pages)
周报	https://hakko-weekly-report.pages.dev/	静态报告(Pages)
月报（入口）	https://hakko-monthly-report.pages.dev/	静态报告(Pages)
目标看板	https://hakko-targets.pages.dev/	静态看板(Pages)
实时看板 /live	https://hakko-dashboard-worker.hakkoai.workers.dev/live	动态 SPA(Worker + D1 + KV)

静态报告（日/周/月报、目标看板）= 定时跑批生成的 HTML，部署 Cloudflare Pages；
实时看板 /live = Cloudflare Worker SPA（实时查 D1，6 个 tab：注册/活跃/付费/Cohort/ROI/订阅），
架构详见 dashboard/README.md。两类都走 @hakko.ai Cloudflare Access。

统一 UI 风格：浅色（bg #f5f6f8 / 白卡 / 橙 #ff7849），全部移动端适配。

七、更新日志（按主题归并，新 → 旧）

🎨 UI / 移动端

#81 全部线上报告页统一浅色风 + 移动端适配（日/周/月报 + 3 入口页）
#80 月报入口页 index.html 浅色化
#78 用户体验月报 UI 浅色化
#77 月报 UI 浅色风 + 参考飞书 docx 重构结构（AI 总结/建议 + 新增/活跃/付费/互动）
/live 看板移动端适配（78ffa3e）

📅 月报（monthly_review）

#71 月度报告自动化（海外）—— 综合 data agent + feedback agent，两份报告

（业务复盘 + 用户体验），cron 每月 1 号；canon §5/§8 严口径

📈 周报（weekly_report）

收入目标对齐 hakko-targets 看板（付费人数×ARPU 推导，22b9a56）
移除「内容和市场成本」(无源)，成本=纯广告花费（ed0a197）
广告花费源 D1→atlas，按 campaign_name OS token 拆端（#74）
活跃改 canon 虚拟事件严口径 + 修 DAU 基线窗口（b2b33c9）
改为「本月各周 MTD 进度表」对齐飞书（5f3304d）
payers 跨平台去重（814ed51）；cron 避开整点防漏触发（4a4e322）
自动周报 → Pages + 胖猫飞书 IM（be1ea5a）

📊 日报（daily_report）

对话率口径对齐 canon §10/§11（修复漏掉 ~52% 对话，#73）
对话率分 PC/iOS/Android 三端（#65）
GH Actions vs CF Worker 调度评估文档（#63）
飞书日报「用户反馈」改用 feedback agent 全渠道 D1（#62）
#59 canon 口径对齐 + 发布精简（严口径 DAU/MAU · 仅 CF+飞书 · 调度提前到 8 点前）
修 GHA 部署：装 Node+wrangler + 补 CF 凭据（#68 / #66）

💬 反馈 agent（feedback）

Phase 1 统一反馈基建（NPS / email / Discord / D1 / LLM，88afb6a）
App Store + Google Play + LLM 分类（6821f6c）
端内反馈 mindcraft.user_settings_feedback（f6f364a）
Discord 多服务器 + upsert 修复（fe99957）；Discord 拉取走 GHA 绕 SNI 封锁（9514984）

💰 订阅 / 收入对账（subscriptions）

Stripe 逐笔实收对账（balance_transaction USD，canon 同口径，046c2ed）
Apple App Store Connect SKU 生命周期（6394378）
Google Play financial-stats —— 三平台 SKU 齐全（fcc7881）
MRR/ARR 审计方法论（ce587ea）

📡 实时看板（dashboard /live）

新增 /live 实时看板（Luddi 风 6 tab，1d7fa2b）
D1 持久化 + 增量 ETL + 双 CAC + ROI by-day（#45）
canon §4 真广告归因 LTV/CAC（#47）
真广告花费 Google Ads + TikTok → D1 → ROI（#41）
canon 审计：全指标对齐 KPI_HAKKO_JOHOR（#50）

📐 口径 canon / 专题分析

KPI canon 文档迁入 docs/kpi_canon/（9cfc6ef）
修 Adjust 区域错误（北京→柔佛 Johor，2b0fd22）
弃用 Adjust REST API + ROAS pipeline（ByteHouse+atlas，03f0dfd）
PC 端 6 步增长漏斗（#32）
Remix 血统树分析（986117d）；v3.4.0 系列深度分析（4pillar / cohort / launch decision）
海外 2026 ARR 预估表（#56）

🔭 运维监控

HakkoAI 多地可用性监控 hakko-monitor（每 10 分钟，4b14755）
每日 CF 下载转化监控（8741a7c）
仓库整理：移除入库密钥/原始报表（acb0818）

完整提交历史：git log -- data_agent/ monthly_review/（截至本次共 178 次提交）。
口径细节见 docs/kpi_canon/KPI_HAKKO_JOHOR.md；周报口径见 docs/WEEKLY_REPORT_METRICS_SPEC.md；
月报自动化见 monthly_review/scripts/README_AUTOMATED.md。