mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-11-19 06:53:42 +08:00
2.0 KiB
2.0 KiB
用 JavaScript 视图 + ucode 取代 Lua 实现
- 状态:已接受
- 日期:2026-10-05
- 决策者:cocolight
- 影响版本:2.0.0
背景
1.x 用 Lua + CBI model + luci-compat 实现。这套路径在OpenWrt 上的实际问题是:
luci-compat是兼容层,不是目标环境。官方文档本身不推荐新应用使用它。- 端口扫描的旧实现是「每个端口跑一次
nc -z,且只扫 loopback」。慢,且扫出来的是 路由器自己都访问不到的地址。 - 配置写回要经CBI,逻辑分散在
luasrc/model/cbi/portal/settings.lua与luasrc/portal.lua两处。
与此同时 LuCI 已把 JavaScript 视图作为正式路径,rpcd-mod-ucode 让后端可以不依赖
Lua 运行时。
决策
2.0.0 起前端改为三个纯 JavaScript 视图(htdocs/luci-static/resources/view/portal/),
后端改为 ucode rpcd 插件(root/usr/share/rpcd/ucode/portal.uc),不再需要
luci-compat。
端口扫描改为读 /proc/net/tcp[6],只保留从 LAN 地址可达的监听端口。
后果
- 正面:去掉一个兼容层依赖;扫描从「N 次进程调用」变成「一次文件读取」;
ucischema 不变,老配置可直接沿用。 - 负面:1.x 用户的自定义要迁移(
icon→icon_url语义见 README的 Migrating 一节);portal.uc只能用 ubus 调用,不能当CLI 工具用(rpcd 加载时不定义ARGV)。 - 负面(已发生):
run_rpc()沿用「promise 链 +.catch()」的写法,而后端用{ ok: false }返回失败,于是 resolved 的失败被当成成功 —— 这是 v2.0.0-r7 已知缺陷的根因 1。教训:跨语言边界必须有一方显式检查成功标志,不能靠异常传播。
备选方案
- 继续维护 Lua 实现:不选。
luci-compat是过渡设施,且扫描实现无法在不重写的情况下 改进。 - 前端改用 TypeScript + 构建步骤:不选。本项目是纯脚本包,引入构建会让「clone 即可 审查」失效,CI 也无法在合理时间内验证。