1.x 测试、热更新与发布
1.x 本地检查
开发环境安装 Python、Node.js 与 Lua 5.1；Python 工具版本应与 CI 保持一致：
python -m pip install pytest "ruff==0.16.5" paramiko
python -m pytest tests/ -v
ruff check root/usr/lib/smart_srun/
node --check root/www/luci-static/resources/smart_srun.js
python -m pytest tests/test_lua_syntax.py -v按修改范围运行针对性测试，例如 tests/test_setup_wizard_ui.py、tests/test_operator_discovery.py、tests/test_wifi_setup.py、tests/test_ap_selection_ui.py，策略扩展运行 python -m pytest tests/ -k runtime -v。
Lua/JS 源码契约与 Node 小型 DOM 测试是本仓库常用验证方式；无线驱动和真实校园策略仍需设备验证。Windows 上缺少 Linux 专用能力的测试会跳过，不应据此宣称覆盖所有路由器行为。
学校门户测试占位值集中在 tests/_portal_urls.py，可用 SMARTSRUN_TEST_PORTAL_ORIGIN、SMARTSRUN_TEST_PORTAL_HTTPS_ORIGIN、SMARTSRUN_TEST_PORTAL_IPV4_ORIGIN、SMARTSRUN_TEST_PORTAL_BARE_HOST、SMARTSRUN_TEST_WIRED_BIND_IP 修改测试字符串。真实校园地址保留在预设清单，不散落到业务测试。Ruff 版本和 ruff.toml 规则显式固定，不因工具升级顺带扩大规则集。
具备 root 与 iproute2 的 Linux 开发机可运行隔离出口验证：
sudo python3 scripts/test_network_namespaces.py --output-dir /tmp/smart-srun-netns-check该脚本创建并清理自己的 namespace / veth，验证绑定、相同 IP、DHCP 换址、断线和 DNS，不替代真实校园网与无线测试。
1.x 路由器热更新
scripts/hot_update.py 使用 Paramiko 与显式文件列表。必须设置 SMARTSRUN_ROUTER_HOST 和 SMARTSRUN_ROUTER_PASSWORD；SMARTSRUN_ROUTER_USER 与 SMARTSRUN_LUCI_BASE_URL 可选。工具没有默认目标地址。不要将实际密码写入文档或提交文件。
python scripts/hot_update.py --dry-run
python scripts/hot_update.py --probe
python scripts/hot_update.py--dry-run 只展示计划；--probe 上传到临时目录做远端语法/import 检查；无参数会覆盖生产文件、清理缓存并重启相关服务。目标与凭据应事先配置，生产操作前保存备份。新增随包文件必须更新显式上传列表。
1.x 构建与发布
| 工作流 | 作用 |
|---|---|
| ci.yml | Python、JS、Lua 与测试检查 |
| build-prerelease.yml | 预览构建，可选发布预发布版本 |
| build-release.yml | 正式构建并生成草稿 Release |
工作流将本仓库放入 OpenWrt SDK 的 package/luci-app-smart-srun/ 并执行 make package/luci-app-smart-srun/{clean,compile} -j1 V=s。Build/Compile 为空，脚本文件无需编译；Makefile 的版本保持 0.0.0，构建时注入版本。
release_assets.py 为 ipk / apk 分别整理 bundle 与分体包。Release 提供对应 bundle；分体 zip 及 SHA-256 旁注按工作流发布到 downloads。不要将两个格式的 zip 数量或命名混为一个固定文件。
APK 后端的包互斥通过 BuildPackage 之后追加负依赖表达；IPK 保留 CONFLICTS。修改打包逻辑时运行包冲突与 Release 资产测试，并检查实际包元数据。