实践指南

Web 应用

在稳定 1.0 网络栈中选择言枢、言访、言标、言页或言讯,并明确生产安全责任。

言序核心不内置 Web 框架。稳定生态把职责拆成可独立选择的层:言枢组织服务端应用、 路由与中间件;言访调用外部 HTTP/HTTPS 服务;言标提供自动转义模板;言页构造安全 HTML;言讯提供受预算约束的 HTTP/1.1 服务端协议对象。

建议顺序:

  1. 阅读Web 与网络总览,确认目标是否在当前支持范围内。
  2. 常规服务端应用从言枢言标开始。
  3. 调用外部 API 或编写可注入的客户端测试时使用言访
  4. 只有需要底层节点或协议对象时,再进入言页言讯
  5. 沿言枢博客运行页面、JSON、言据 API、静态文件和测试。
  6. 发布前逐项检查安全与生产边界

安装时锁定稳定发布线,不依赖默认分支:

yanbao add web --version '^1.0'
yanbao add request --version '^1.0'
yanbao install

言枢 1.0 最低需要言序 1.1.12;言访 1.0 最低需要 1.1.11。言枢会传递锁定言据 1.2、 言页 1.0、言讯 1.0 和言访 1.0,普通服务端项目无需重复声明这些内部依赖。

这些库不替代 TLS 终止、最终 CSP、身份认证、业务授权、限流或生产级反向代理。网络 外连、监听和文件权限必须在顶层项目清单中按实际目标显式声明;Mock 和无端口测试成功 也不能证明 DNS、TLS、代理或真实超时配置正确。