| name | hansa-changelog-scan |
| description | AgentHansa changelog/source-of-truth 梳理 — 平台规则、新功能、游戏类型变化的自动发现与记录。SPA 应用的 changelog 不在静态 HTML 中，需通过 API 端点捕获变化。 |
| tags | ["agenthansa","changelog","api-discovery","platform-intelligence"] |
| version | 1 |
hansa-changelog-scan
核心原则
AgentHansa 是 SPA (Single Page Application)，/changelog 等页面只返回静态 HTML shell。changelog 内容不在页面中，需通过 API 端点发现。
Changelog 来源
1. /api/arena/how-to-play — 最重要
返回 JSON，包含：
schema_version: 当前版本games.registered_keys: [当前游戏列表]payouts: pot_formula, survival_reward_usd_per_round, legacy_base_pot_usdtournament_format: lifecycle, rounds, pairings, scheduleplay_steps: 步骤指引
变化检测：
curl -s -H "Authorization: Bearer <key>" https://www.agenthansa.com/api/arena/how-to-play | jq '.schema_version, .games.registered_keys'
2. /api/agents/me — 平台公告
注意 字段可能包含：
- 新赏金任务提示（如 "$500 bounty — write a tweet..."）
- 平台更新提示
- 新功能上线通知
3. /api/arena/games/{key} — 新游戏规则
当 how-to-play 出现未知 game_key 时，抓取详细规则。
4. /api/alliance-war/quests — 新大任务
GET /api/alliance-war/quests?per_page=20 列出所有大任务- 每次新一批 quests 上线时检查 slots_remaining 和 deadline
- 用户经常关注 alliance war 赚钱机会，需要将 changelog 扫描与 quest 发现联动
5. 不可用的来源
以下端点返回静态 HTML，不包含实时 changelog：
/api/changelog → HTML/api/changes → HTML/api/updates → HTML/api/announcements → HTML/api/agents/me/announcements → HTML/api/agents/me/notice → HTML/changelog.json → HTML/api/how-to-play → HTML
工作流
日常扫描（已集成到 hansa_checkin.py）
- 读取上次保存的
schema_version 和 registered_keys
- 调用
/api/arena/how-to-play
- 比对 schema_version 差异 → 报告
- 检查是否有新 game_key → 抓取规则 → 报告
- 调用
/api/agents/me 检查 notice 变化 → 报告
- 检查
/api/alliance-war/quests 有无新任务上线 → 报告
- 保存新状态到
~/.agent-hansa/checkin_state.json
重要发现录
| 日期 | 来源 | 发现 | 影响 |
|---|
| 2026-05-25 | /api/prediction/markets | arena_hint 新增详细字段（tournament_id, joined, min_field_size, pot_amount, join_endpoint） | 预测市场空时自动导流 Arena |
| 2026-05-25 | Multiple probes | /api/prediction/bets, /my-bets, /history 已变 SPA HTML fallback | 历史投注查询失效 |
| 2026-05-25 | Probes | /api/prediction/positions → 502, /api/prediction/categories → SPA HTML | 预测市场相关端点降级 |
| 2026-05-24 | /api/arena/how-to-play | 新增 CAPTCHA Master 游戏 | 需多模态视觉模型，否则 0 分 |
| 2026-05-24 | /api/arena/how-to-play | 取消 "agent_one_at_a_time" 限制 | 可同时参加多场锦标赛 |
| 2026-05-24 | /api/arena/how-to-play | survival_reward 每轮 $0.01 | 资金逐轮流动到账 |
CAPTCHA Master 规则要点（来自 /api/arena/games/captcha）
- 3×3 网格，9 个 tile，index 0-8 row-major
- 指定目标物（如 "trucks"）
- 提交
{selected: [indices]} 到 /captcha-submit
- 正确答案分数 = max(0, 600 - solve_seconds)
- 错误答案 5s cooldown，然后重试
- 无视觉模型时 strategy-mode 自动提交随机 9-bit guess（0.2% 命中）
- Table Talk 禁止在 captcha 场合作业
CAPTCHA 实战根因诊断（2026-05-25）
5164 次 cron 运行中0 次实际 vision_analyze 成功提交。
- Prompt 文本包含 "captcha" 但无实际执行（文件全是
[SILENT]）
- Cron 声明
toolsets: [terminal, file, web, vision]，但 vision_analyze 未在 captcha 场景中被调用成功
- Collector 未为 captcha 输出
deterministic_recommendation（仅有 captcha_image_url + captcha_note）
- LLM 需要自己 fetch → vision → submit，整个链条从未跑通
- Arena state 验证：
259d9bba captcha（R4, 133人）joined=True, eliminated=True, highest=None=0轮存活
结论：captcha 当前不可行。建议：
- 方案 A（推荐）：在 collector 里跳过 captcha join，专注 coin_snipe + crash_pilot
- 方案 B：保留 join 但接受 0 分，靠另外两场赢回来
- 方案 C：为 captcha 实现确定性推荐（需 vision API 集成到 Python 端）
扫描脚本
位置: ~/.hermes/scripts/hansa_checkin.py
- 每日运行时自动执行 changelog 扫描
- 对比存储在
~/.agent-hansa/checkin_state.json 中的上次 snapshot
- 有新发现时输出到 stdout（cron 通知飞书）
常见陷阱
- 不要用 browser 或 curl 抓 /changelog 页面 — 只有 HTML shell
- 不要用 grep 在 JS bundle 中找 changelog — 数据是 client-rendered 静态，不含实时更新
- API 端点需
Authorization: Bearer <key> 头部
- 部分端点返回 HTML（SPA fallback），检查 content-type 或 JSON parseability
