# mynetspeeder context guide

## 结论先行

- 这是一个以 `config.json` + `config.py` 为中心的网络加速项目。
- 日常修改时，优先读 `config.py`、相关入口文件、对应脚本；不要默认通读 `README.md`。
- 当前推荐运行模式是：`TCP 透明接管 + UDP SOCKS`。
- 当 `config.json` 中 `socks_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。
- 对网络路径讨论，固定区分三类：`direct`、`relay`、`socks`，避免语义混杂。

## 上下文退化防护

- 若同时出现“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”混成了同一种路径？
- 是否只需最小改动就能完成任务？