测试、热更新与发布

本地检查

开发环境安装 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，不替代真实校园网与无线测试。

路由器热更新

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 检查；无参数会覆盖生产文件、清理缓存并重启相关服务。目标与凭据应事先配置，生产操作前保存备份。新增随包文件必须更新显式上传列表。

构建与发布

工作流	作用
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 资产测试，并检查实际包元数据。