f894e55602
- 简化 http-api/http-tcp/web-toolkit 的 router.py，抽取重复代码 - 修复 ws-api middleware 中间件返回值传递问题 - 修复 web-toolkit template.py 安全漏洞 (eval → AST 验证) - 将首页标题从 "OSS Runtime" 改为 "Future OSS" - 更新 README.md 与 static/banner.svg - 新增 i18n 国际化插件 (骨架) - 新增 oss/shared/ 共享模块
ws-api WebSocket API
提供 WebSocket 实时双向通信服务。
功能
- WebSocket 服务器
- 路由匹配
- 中间件链（认证/日志）
- 广播消息
- 连接/断开/消息事件
- 与 HTTP 插件集成
使用
ws = plugin_mgr.get("ws-api")
# 注册消息路由
ws.router.on_message("/chat", lambda client, msg: client.send({"echo": msg}))
# 广播
ws.server.broadcast({"type": "announcement", "data": "服务器维护通知"})
# 获取客户端列表
clients = ws.server.get_clients()
事件
# 通过 plugin-bridge 订阅 WS 事件
bridge = plugin_mgr.get("plugin-bridge")
bridge.event_bus.on("ws.connect", lambda event: print(f"新连接: {event.client.path}"))
bridge.event_bus.on("ws.message", lambda event: print(f"消息: {event.message}"))
bridge.event_bus.on("ws.disconnect", lambda event: print(f"断开: {event.client.id}"))
配置
{
"config": {
"args": {
"host": "0.0.0.0",
"port": 8081
}
}
}