SuperAPI AI 工具集

rust-web

编程与开发

查看项目

更新于 10-16 01:10

技能介绍

用途:设计、实现、测试并运维生产级 Rust 服务端 HTTP 服务,基于 HTTP 契约与运行时生命周期交付 API。框架只负责传输适配,领域逻辑与数据访问保持可独立测试,不把后端问题全部塞进 handler。

主要能力:修改前先确认服务契约,包括方法、路径、状态码、请求/响应 schema、兼容策略、认证上下文来源、并发与超时限制、上传与响应大小约束、外部依赖及失败语义、监听地址与代理/TLS 终止/健康检查/优雅关闭预算、依赖 crate 与 MSRV、日志与追踪配置。工作流涵盖:建立基线(rustc --version --verbose、cargo metadata --format-version 1、cargo tree -e features、cargo test --all-targets);定义传输边界(请求→路由/提取器/传输校验→应用服务/用例→仓储或出站 HTTP 端口→领域结果/错误→集中式 HTTP 响应映射);实现路由与输入边界;统一错误响应映射(校验失败→4xx,未找到/冲突/拒绝→404/409/403,下游不可用/超时/内部缺陷→5xx 且不泄露内部细节,错误响应含稳定机器码与请求/追踪标识);中间件组合与安全边界(敏感头脱敏、超时、请求体限制、并发保护、CORS 精确白名单、仅在受控来源信任代理头);管理异步生命周期(分层超时、取消传播、优雅关闭、重试需预算与幂等);有界外部适配器访问(复用连接池、配置超时与连接限制);分层服务测试(领域纯测试、路由级请求测试、提取器失败与错误映射、外部适配器契约与故障注入、数据库迁移隔离、有限 socket 测试)。

常用门禁:cargo fmt --all -- --check、cargo check --all-targets、cargo test --all-targets、cargo clippy --all-targets -- -D warnings。

适用场景:需要交付可维护、可测试、契约明确的 Rust HTTP API 服务。

限制:认证/授权、会话令牌、CORS/CSRF 策略、密钥管理归 rust-web-security;schema 迁移、事务、SQL/ORM 建模归 rust-database;Tokio 任务、锁、通道、取消安全归 rust-concurrency;测试分层策略与性能基线归 rust-testing。本技能只消费已验证来源的主体身份与授权结果。WebSocket 升级、消息协议、心跳与背压仅在明确要求时作为独立子流程处理。真实数据库、网络、TLS 或部署未验证时,须显式标注剩余边界。具体收费、价格与平台信息暂未提供。