op-packages/smart-srun/core/AGENTS.md

Go 核心

本目录是独立 Go module。先读涉及的包及相邻测试；公开架构说明见文档站。

代码地图

责任	入口
命令、进程与本地 RPC	cmd/srunnet、cli、daemon、control
状态、调度与用户动作	domain、application、policy
配置、备份和秘密	config；ParseBackup 位于 backup.go
登录事务与 SRun 编码	auth、protocol/srun
网口绑定、联网检测与 portal	transport、openwrt、portal
无线观察与切换回滚	wifi、wireless
学校目录与声明式策略	presets、strategy
更新 Worker 与恢复	update；部署手册

容易误用的约束

• 配置是 schema_version: 2 强类型 JSON；启动不读 Python 旧路径。显式备份导入走预览、revision/CAS 和动作互斥，导入后自动认证保持关闭。
• 账号的 operator_suffix 决定登录后缀：空串不追加，非空追加对应值。空值和未选择不同，不猜运营商后缀。
• 认证策略声明参数和扩展字段，不自行创建 HTTP 客户端。保留命令的唯一集合是 strategy.ReservedCommands，不要在文档复制列表。
• 手动动作、自动维护和探测使用同一选择网口的 IPv4/L3 绑定；缺少严格绑定时失败关闭，不退回更弱 HTTP 路径。
• 例行状态不得覆盖动作终态的 last_action_message / last_action_portal_url；新动作入队时清空。Portal 可达但 Internet 探测失败与认证拒绝分开表示。
• 静默时段覆盖受管有线账号及活动账号；强制下线去重，只重试失败项。状态投影不能意外触发网络操作。
• 学校预设页面读取不联网；默认每日更新时间为北京时间 09:00，tmpfs 日领取记录跨服务重启保留、设备重启后不保留。
• 预设与配置跨层修改同时读 doc/AGENTS.md 和 root/AGENTS.md。升级与恢复使用原生受信验签，不沿用手动安装的信任绕过。
• 日志与错误不得包含密码、真实备份或原始认证响应体。

验证与历史规格

相关包测试从本目录运行 go test ./internal/<package>；完整 Linux 门禁和硬件边界见 tests/README.md。 更改依赖方向时检查 tests/architecture，不能仅凭编译判断架构保持。

冻结设计材料位于本地 .codex/go-rewrite/（02 架构、03 契约、04 状态/网络、05 测试、15 改进契约），任务记录在 .codex/go-loop/。 它们被忽略，克隆不会带来；已提供时按当前任务读取相关章节，缺失时说明限制，不声称完成依赖这些材料的验收。 旧交接的运行状态不能代替当前观察。