main.py                      命令行入口，参数分组：登录 / 保活 / 每日任务 / 国战
config.json                  配置模板（密钥请放 config.local.json）
protocol.json                保活协议规格：握手步骤、心跳帧、间隔
protocol.example.json        上面那份的带注释示例
requirements.txt             依赖，只有 requests
run_keepalive.sh / .bat      保活启动脚本
run_daily.sh   / .bat        每日任务启动脚本

tankstorm/
  __init__.py                包定义，游戏 URL 常量，模块分工一览
  qq_login.py                QQ 扫码登录（ptlogin2）、cookie 持久化与静默续期
  qzone.py                   打开空间游戏页，解析 FlashVars
  session.py                 连服务器、登录、收完登录推送；登录态失效时重新登录
  socket_keepalive.py        保活守护进程：心跳、断线重连
  jobs.py                    一次性任务（--daily / --country-war）与成果推送
  daily/                     每日任务
    tasks.py                 任务表：opcode、字段、前置、闸门、档位
    model.py                 任务表的积木：Task / Gate / Tiers / Followup / 占位符
    pickers.py               从响应里挑下一步的值（空演习场、无主矿、达标档位）
    checks.py                危险字段、免费次数闸门、回包判据
    judge.py                 判成败
    runner.py                执行器：前置 → 闸门 → 动作 → 判成败 → 后续步骤
    state.py                 当天状态 logs/daily-state.json
  country_war.py             国战自动打摩多军团（形状不合流水线，走 runner）
  campaign.py                征战世界逐关打到打不过，输了用免费次数重新开始（同上）
  arena.py                   争霸战自动挑战 + 内置 NPC 名字表（同上）
  guild.py                   公会战参加（type:70，判据是"上次参加时刻"被刷新）
  shop.py                    功勋商城补支援兵，唯一会花钱的模块，默认关闭
  wire.py                    请求原语：发请求、等回包、边等边心跳、按路径读响应
  account.py                 从服务端推送里读国家 ID 和背包数量
  sender.py                  组帧与发送，含超级强攻拒绝包的构造
  crypto.py                  RC4 双向实现，密钥由 FlashVars 推导
  recorder.py                收发录制、实时解密、事件告警、自动拒绝回调
  stream_recorder.py         原始字节流旁路落盘（解密的前提）
  protocol.py                读 protocol.json，构造握手与心跳帧
  wiremap.py                 按游戏版本在本项目编号和线上编号之间翻译 opcode 与字段号
  wiremap.json               游戏版本 → 编号对照，由 build_wiremap.py 生成
  schema.py                  协议 schema 载入 + protobuf 解码
  schema.json                567 个 opcode 的字段表（本项目编号），由 extract_proto.py 生成
  proto_encode.py            protobuf 编码
  settings.py                读 config.json 并合并 config.local.json
  paths.py                   区分随包只读数据和程序目录里的用户数据
  notify.py                  PushPlus 推送（文本 / HTML / 二维码图）
  log.py                     日志

tests/                       单元测试（标准库 unittest，不连网络、不碰账号）

tools/
  pcap_split.py              从 pcapng 拆出 TCP 流，报告有没有空洞
  redwar_rc4.py              离线解密收发流，自带密钥自检
  brute_sid.py               忘记记录 sid 时的已知明文爆破
  capture_daily.py           从解密后的上行帧提取每日任务参数
  analyze_frames.py          分析运行时录制的帧日志
  pcap_analyze.py            不解密也能定位登录握手与心跳
  extract_proto.py           从 SWF 还原 opcode 表 / .proto / schema.json / structure.json
  build_wiremap.py           对比两版 structure.json，生成新游戏版本的编号对照
  dump_class.py              按类名反汇编 SWF
  xref.py                    全库交叉引用（找谁引用了某名字或某字符串）
  disasm.py                  AVM2 字节码反汇编器
  abcparse.py                ABC 结构解析
  swfparse.py                SWF 容器解析
  _console.py                工具脚本共用：输出固定为 UTF-8

docs/
  banner.svg                 README 头图
  redwar.proto               从 SWF 还原的完整协议定义
  opcodes.json               opcode ↔ 消息名对照
  structure.json             本项目编号那一版（2026101403）的完整消息结构，生成映射时作基准
  protocol-reverse-engineering.md   二进制协议逆向方法论
  加密与协议还原.md          RC4 与协议还原的完整过程
  原理与逆向.md              早期原理记录（内容已迁至 Wiki）

具体代码佬们自行研究学习查阅