2026-05-09 - 安全加固与 API 规范化
✨ 新增
- 事件名合法性校验:不合规的事件名会立即报错,防止运行时异常
- 生产/调试双模式:
@expose接口在生产模式下仅返回通用错误提示,调试模式可通过Bridge(debug=True)开启详细报错 - 错误响应新增
code字段,方便前端根据错误码做分支处理 - 自动化测试体系:核心模块测试覆盖率 78%,其中 bridge 模块达 96%
- 开发服务器健康检查:启动时自动检测前端服务是否就绪,超时即报错,取代固定等待
🐛 修复
- 修复高负载下事件循环重入导致的任务乱序和资源浪费问题
- 修复事件推送时特殊字符可能导致前端脚本异常的安全隐患
- 修复开发工具在非打包环境下总是自动弹出的问题
⚡ 优化
- 任务调度 API 更名:
run_on_main_thread→run_on_bridge,准确反映实际执行语义(旧名称仍可用,会提示废弃警告) - 打包流程增加前端构建产物检查,缺失时立即报错而非打包后失败
- 内部轮询方法
_tick升级为公开tick(),对齐平台命名规范
💥 Breaking Changes
@expose接口默认隐藏错误详情:原先返回的完整异常信息现改为"Internal error"。如需开发时查看详细报错,请在初始化时传入Bridge(debug=True)App.run()不再自动开启 DevTools:需要调试时请显式传入debug=Truerun_on_main_thread已废弃:请迁移至run_on_bridge,旧名称将在下个大版本移除
What's Changed
- refactor(pywebvue): Implement thread-safe event queuing and task execution system by @wish2333 in #2
- feat(core): v2.0.0 安全加固与 API 规范化 by @wish2333 in #3
Full Changelog: 1.0.0...v2.0.0