生态Web 与网络

迁移到 Web 1.0

把言枢、言讯与言页的 0.x 依赖升级到稳定标签,并采用新的预算、安全和测试边界。

Web 栈的 1.0 升级不是只改版本号。先固定公开标签、重建锁文件,再逐层处理包名、响应、 资源预算和测试边界。

更新依赖

[依赖]
web = { 包 = "yanxu-web", git = "https://github.com/yanxulang/yanxu-web.git", 修订 = "v1.0.0", 版 = "^1.0" }

言枢会锁定言据 1.2、言页 1.0、言讯 1.0 和言访 1.0。不要继续使用main^0.2

yanbao update --dry-run
yanbao update
yanbao check
yanbao test
yanbao build --release
yanbao audit

需要检查的变化

  1. 言页的稳定包名是言页,普通文字必须经过文字节点;原始仍是可信边界。
  2. 言讯 1.0 支持持久连接、分块、Multipart 和 WebSocket 握手;应用仍负责并发、TLS 和帧层。
  3. 言枢请求/响应、路由、中间件、会话、CSRF、静态文件和 OpenAPI 都受显式预算约束。
  4. JSON 与言据是不同媒体类型;使用言据值响应或受限解析,不按正文形状猜测。
  5. 会话存储改为显式协议,生产存储必须实现并发、过期、容量和观测策略。
  6. 无端口测试可使用言枢测试客户端,或把包:web/言访测试交给言访。

发布前回归

  • 覆盖 404、405、无效正文、超限正文、异常中间件和错误处理器。
  • 覆盖 Session Cookie、CSRF 来源和令牌、静态路径穿越、条件请求与单范围响应。
  • 覆盖 JSON/言据内容协商、不可接受的Accept和结构化错误代码。
  • 对生产配置复核文件、监听和出站网络权限;框架依赖不会替应用取得授权。

历史 0.1 → 0.2 变化仍可查阅旧迁移记录,但新项目应直接 以 1.0 页面和公开标签为准。