AGENTS.md 2.4 KB

mynetspeeder context guide

结论先行

  • 这是一个以 config.json + config.py 为中心的网络加速项目。
  • 日常修改时,优先读 config.py、相关入口文件、对应脚本;不要默认通读 README.md
  • 当前推荐运行模式是:TCP 透明接管 + UDP SOCKS
  • config.jsonsocks_port > 0 时,默认语义应理解为:UDP 不走透明接管,优先走 SOCKS5 UDP ASSOCIATE

最小上下文读取顺序

按任务类型只加载必要文件,避免把大段说明一次性塞进上下文。

配置相关

  1. config.py
  2. config.json
  3. README.md 中“配置文件 / 启动方式”相关小节

TCP/UDP 转发相关

  1. transparent_edge.py
  2. socks_edge.py
  3. relay_client.py
  4. relay_server.py
  5. 必要时再看 protocol.py

启动脚本相关

  1. scripts/start-transparent.sh
  2. scripts/stop-transparent.sh
  3. scripts/start-relay.sh

CLI/命令入口相关

  1. cli.py
  2. __main__.py
  3. scheduler.py

上下文压缩规则

  • 先摘要后展开:先记录“目标、影响文件、风险点”,再决定是否读取大文件。
  • README.md 只按标题定点读取,不要一次性全读。
  • 日志、抓包、长报错默认只保留:报错类型、关键堆栈、端口、协议、目标地址、触发命令。
  • 对配置讨论,优先引用字段名,不复述整份 JSON。
  • 对网络路径讨论,固定区分三类:directrelaysocks,避免语义混杂。

上下文退化防护

  • 若同时出现“UDP 透明”和 socks_port > 0,以脚本实际行为为准,先判定为 UDP SOCKS
  • 若文档描述与代码冲突,以 config.py 和脚本实现为高优先级事实源。
  • 若任务只改局部模块,不要把其他模式说明带入当前判断。
  • 若已经发现错误假设,不在原上下文上叠加修正,直接丢弃旧假设并重述当前结论。

稳定事实

  • 配置加载入口:config.py
  • 默认 SOCKS 监听:127.0.0.1
  • socks_port = 0 表示关闭 SOCKS UDP 入口
  • udp_always_broadcast 默认开启
  • udp_direct_redundancy / direct_redundancy 是 direct 路径冗余主开关

修改前检查清单

  • 这是配置问题、转发问题、脚本问题,还是文档问题?
  • 这次任务是否真的需要读取 README.md 全文?
  • 是否把“透明 UDP”和“UDP SOCKS”混成了同一种路径?
  • 是否只需最小改动就能完成任务?