生态Web 与网络
Web 与网络
用言枢、言访、言讯、言页与言标组成稳定 1.0 的服务端和客户端网络栈。
言序 Web 与网络栈已经进入稳定 1.0:言讯负责严格 HTTP/1.1 服务端协议,言访负责 HTTP/HTTPS 客户端,言页负责默认安全的 HTML 构造,言枢把路由、中间件、言据、会话、 CSRF、静态文件和测试传输组合成应用框架。言标继续作为言枢内建的自动转义模板语言。
┌─ 言访 1.0:客户端 · 重试 · Mock · 回放
应用与测试 ─────────┤
└─ 言枢 1.0:路由 · 中间件 · 会话 · CSRF
│
┌────────────┼────────────┐
▼ ▼ ▼
言讯 1.0 言页 1.0 言据 1.2
HTTP/1.1 协议 安全 HTML 数据交换言枢 1.0
路由、中间件、会话、CSRF、静态文件、OpenAPI 和无端口测试
言访 1.0
HTTP/HTTPS 客户端、正文、认证、重试、中间件、Mock 与回放
言讯 1.0
严格 HTTP/1.1、keep-alive、分块、Multipart、Cookie 与升级边界
言页 1.0
默认转义、保守 URL、资源预算、组件与增量渲染
言标
自动转义的中文模板、控制流、包含与继承
迁移到 1.0
从早期 Web 包升级稳定标签、导入名、安全边界和测试方式
稳定版本
| 仓库 | 包名 | 版本 | 最低言序 | 直接依赖 |
|---|---|---|---|---|
yanxu-http | yanxu-http(常用别名 http) | 1.0.0 | 1.1.6 | 无 |
yanxu-request | 言访(常用别名 request) | 1.0.0 | 1.1.11 | 言据、言韧、言录 |
yanxu-html | 言页 | 1.0.0 | 1.1.12 | 无 |
yanxu-web | yanxu-web(常用别名 web) | 1.0.0 | 1.1.12 | 言据、言页、言讯、言访 |
安装稳定标签,而不是默认分支:
yanbao add http --version '^1.0'
yanbao add request --version '^1.0'
yanbao add html --package 言页 --version '^1.0'
yanbao add web --version '^1.0'
yanbao install如何选择
| 目标 | 使用 |
|---|---|
| 调用外部 HTTP/HTTPS 服务 | 言访 |
| 编写服务端协议适配器或自建监听器 | 言讯 |
| 构造邮件、静态片段或安全服务端 HTML | 言页 |
| 构建有路由、中间件和应用安全边界的 Web 服务 | 言枢 |
| 在测试中让言访直接调用言枢而不监听端口 | 言枢的言访测试导出 |
言访和言讯没有循环依赖:客户端使用言序标准网络传输,服务端协议类型由言讯独立维护。 言枢同时依赖两者,只在应用层提供无端口适配。
生产边界
- 言讯只实现 HTTP/1.1 服务端协议,不终止 TLS,也不提供 HTTP/2、HTTP/3 或并发调度。
- 言枢内建服务器用于开发与集成;生产环境应由成熟前置服务器终止 TLS 并实施限流。
- 言访标准传输使用统一总超时和有界缓冲;细分超时、逐跳重定向控制等能力必须由 如实声明的自定义传输提供。
- 言页的
原始和扩展是显式信任升级,不是 HTML 清洗器。 - 认证、授权、密钥管理、业务 Schema 和隐私留存仍由最终应用负责。
继续按任务阅读各库页面;完整 21 库目录见第三方库。