SuperAPI AI 工具集

stack-patterns

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:这是 @outfitter/* 包约定的主要参考,用于学习 Outfitter Stack 的模式,包括 Result 类型、Handler 契约、错误分类和包使用约定。

主要能力:Handler 是纯函数,接收类型化输入与上下文,返回 Result<TOutput, TError>,不感知传输层(CLI 标志、HTTP 头、MCP 工具 schema),便于测试、复用、类型安全与组合。Result 类型来自 better-result,支持创建、检查、模式匹配与组合(如 combine2)。错误分类共十类,映射退出码与 HTTP 状态:validation(1/400)、not_found(2/404)、conflict(3/409)、permission(4/403)、timeout(5/504)、rate_limit(6/429)、network(7/503)、internal(8/500)、auth(9/401)、cancelled(130/499)。验证使用 Zod 配合 createValidator,返回 Result。HandlerContext 携带 requestId(自动生成 UUIDv7)、logger、config、signal、workspaceRoot、cwd 等横切关注点。

包参考:@outfitter/contracts(基础,始终使用)、@outfitter/types(类型与集合工具)、@outfitter/cli(CLI 应用)、@outfitter/mcp(AI 智能体工具)、@outfitter/config(配置)、@outfitter/logging(日志)、@outfitter/daemon(后台服务)、@outfitter/file-ops(文件操作)、@outfitter/state(分页)、@outfitter/testing(测试)。@outfitter/types 提供 sortBy、dedupe、chunk 及 Prettify、DeepPartial、Nullable 等类型工具。

使用方式:所有项目从 @outfitter/contracts 开始;CLI 应用加 @outfitter/cli;MCP 服务器加 @outfitter/mcp;需要配置加 @outfitter/config;文件操作需 @outfitter/file-ops 以保证安全。优先使用 Bun 原生 API,如 Bun.hash()、Bun.Glob、Bun.semver、Bun.$、Bun.color()、Bun.stringWidth()、bun:sqlite、Bun.randomUUIDv7()。

适用场景:构建 CLI、MCP 服务器、后台服务等需要统一错误处理与类型安全的 TypeScript/Bun 项目。

限制:资料未提供安装命令、版本要求、收费或价格信息,暂未提供。