op-packages/luci-app-substore/docs/TESTING.md

Testing — luci-app-substore

单元测试

tests/ 下每个测试文件均可独立运行，全部为纯 Lua 5.1：

测试文件	覆盖内容
run_tests.lua	util(base64/json/url/hostport)、node、parser 基础
node_*_test.lua	节点模型扩展、分组、重命名
output_clash_meta_test.lua	Clash.Meta / Mihomo YAML 生成
output_formats_test.lua	15 种目标格式统一分发
output_full_config_test.lua	sing-box / V2Ray 完整配置输出
vmess_cipher_test.lua	vmess 加密方式（cipher）与 TLS 层（security）不混淆
core_link_test.lua	订阅 token + generate_link 链接生成
parser_clash_yaml_test.lua	Clash YAML 解析
parser_json_config_test.lua	sing-box / V2Ray / Clash JSON 解析
parser_input_test.lua	多客户端配置导入（sing-box/V2Ray/Surge/QX）
parser_local_link_test.lua	局域网订阅链接检测与解析
singbox_transport_test.lua	sing-box transport 对象（ws / grpc / http / httpupgrade）读取
list_lock_test.lua	订阅列表 mkdir 互斥锁、陈旧锁回收、可重入
qx_tag_comma_test.lua	QX 节点名含逗号时的整条丢弃
dns_fallback_test.lua	DNS 解析回退（nixio → nslookup）与连接时对端地址校验；wget 后端在无法校验时拒绝
parser_mixed_format_test.lua	混合格式文本导入：明确报错（7 种组合）+ 单一格式不误判（Surge [Proxy] / Clash YAML / sing-box JSON / YAML 流式映射）+ 远程 M.parse 行为未变
acl_menu_test.lua	菜单 ACL 接线：ACL 组定义、depends.acl 引用同一组名、Makefile 确实安装 acl.d / menu.d
data_integrity_test.lua	写入失败被上报而非吞掉（M.remove / M.ensure_token 注入 atomic_write 失败）
subscriptions_format_gate_test.lua	订阅列表页格式下拉的启用条件（真实渲染模板后断言）
subscriptions_bulk_delete_test.lua	订阅列表页勾选批量删除：选择框列 / 全选 / 删除按钮 / 空选不删（真实渲染模板后断言）
subscriptions_combo_row_test.lua	订阅列表页组合订阅行的显示：名称列只显示名称、[组合] 徽标在订阅地址列且位于来源列表之前、徽标全页只出现一次（真实渲染模板后断言）；普通订阅行与本地订阅行（[本地] 徽标）回归
user_agent_test.lua	订阅客户端类型（User-Agent）：取值校验、-A/-U 进入命令行、重定向每一跳带 UA、预设解析、core 透传、控制器接线
core_combo_test.lua	组合订阅：合并/重算、来源校验、删除源订阅后组合立刻重算（节点/下载链接/来源剪除/来源删光的报错/无关组合不受影响）
view_i18n_test.lua	视图模板界面文本的 i18n：用恒等 translate 真实渲染模板，输出不得含中文（复现「英文界面显示中文」）+ 每个 msgid 都有 zh-cn 译文 + 静态扫描模板字面 HTML 里的硬编码中文

运行全部：for f in tests/*.lua; do lua5.1 "$f" || exit 1; done

集成测试

1. 编译安装到目标设备
2. 添加订阅 URL，手动更新，验证节点数 2.1 订阅列表勾选批量删除：表头全选 / 单条勾选、一条都没勾选时点「删除」不删除任何东西、 多条一次删除、删除后 /etc/cron.d/substore 同步刷新 2.2 组合订阅随源删除重算：建 A+B 组合 → 删除 A → 组合节点数立刻只剩 B 的、 「来源」列不再出现裸 id、组合下载链接不再含 A 的节点；把来源删光时组合报错而非静默 0 节点 2.3 混合格式文本导入：粘贴「URI 行 + WireGuard .conf」的混合文本 → 明确报错并 列出两种格式，而不是只导入一半；再分别单独导入两种格式，均应成功 2.4 部分删除失败时 cron 同步：构造一条删除会失败的订阅（如手工改坏 nodes 文件名）， 与一条正常订阅一起勾选删除 → 至少一条被删掉时 /etc/cron.d/substore 必须被重写
3. 节点浏览：筛选、排序
4. 输出生成：15 种格式下拉均可生成
5. 订阅链接：复制 /substore/download?token=...&target=ClashMeta 到 Passwall/OpenClash 验证可拉取
6. 输入源：导入 Clash YAML / sing-box JSON / V2Ray JSON / Surge / QX 配置验证解析
7. 定时更新：修改 Settings cron，验证 /etc/cron.d/substore 生成
8. 规则应用：设置协议过滤、关键词，验证节点列表/输出受影响
9. ACL —— ✅ 已于 2026-10-02 在设备上实测通过：新建一个非 root 的 LuCI 用户 （不在 luci-app-substore 组内），登录后看不到本应用入口；把该用户加入组后 入口出现；该用户直接访问 URL （/cgi-bin/luci/admin/services/substore/list）返回 403 Forbidden （依据：ucode dispatcher 在 dispatch() 里对路径上累积的 depends.acl 做校验， 不足即 403 —— 已从上游源码核实，并已由本次设备实测确认）
10. 表单 token：提交任一写操作（保存订阅 / 删除 / 节点保存）应正常生效； 手工构造一个缺 token 或 token 不匹配的 POST，应看到错误提示而不是静默无反应

安全测试

• SSRF：尝试内网 URL，被拒绝
• 大响应：>10MB 被截断
• 恶意 Base64/JSON：解析失败不崩溃

回归测试

每次阶段发布前执行 tests/run_tests.lua 并在目标设备手动验证菜单/功能。