typia：超高速 TypeScript 运行时验证与序列化库
通过 TypeScript 类型转换，实现零依赖的超级快速运行时验证、JSON 序列化、LLM 函数调用和 Protocol Buffer 编解码。
证据显示这是一个开源库，没有涉及权限、用户确认、数据流透明、敏感数据处理、外部副作用、回滚或来源归属的机制。依赖安全方面，package.json 列出了 devDependencies，但没有锁定版本或安全审计信息。因此所有信任标准得分为 0。
自一致性：README 和 package.json 描述一致，功能列表清晰，得 2 分。依赖可用性：依赖通过 pnpm 管理，有 lock 文件，但未验证可用性，得 2 分。失败消息：代码中有错误处理，但未提供详细的失败消息文档，得 1 分。
受众和场景：README 明确列出了多种使用场景（验证、JSON、LLM、protobuf），得 2 分。能力边界：文档说明了支持的功能，但未明确边界，得 2 分。触发精度：API 设计清晰，得 2 分。环境适配：支持多种构建工具，但需要特定工具链，得 2 分。
信息架构：文档结构清晰，有指南和 API 文档，得 2 分。安装说明：提供了安装步骤，但依赖特定工具，得 2 分。命名稳定性：API 命名一致，得 2 分。示例和 FAQ：有示例，但缺少 FAQ，得 2 分。已知限制：未明确列出，得 1 分。许可证：MIT 许可证明确，得 2 分。版本和变更日志：有版本号，但无变更日志，得 1 分。维护责任：有作者和仓库，得 2 分。
输出可用性：输出是类型安全的验证器和序列化器，得 2 分。边际价值：提供了独特的功能，得 2 分。成本效益：性能声称有基准，但未验证，得 2 分。
声明可追溯性：性能声明有基准链接，但未验证，得 1 分。跨来源佐证：有社区使用案例，但未独立验证，得 1 分。事实与推断分离：文档区分了事实和推断，但不够明确，得 1 分。
- 这是一个静态审查，未执行代码，性能声明未验证。
- 依赖安全未审计，建议检查依赖漏洞。
- 需要特定工具链（ttsc），可能限制环境适配。
这个 Agent 能做什么，适合哪些场景？
typia 是一个 TypeScript 转换器库，利用编译时转换将 TypeScript 类型直接生成高效的运行时验证器、序列化器和解析器。它提供 `is`、`assert`、`validate` 等验证函数，`json` 命名空间支持 JSON Schema 和序列化/解析，`llm` 命名空间提供函数调用应用和结构化输出，`protobuf` 支持 Protocol Buffer 消息编解码，还有 `random` 生成随机数据。typia 声称其运行时验证器比 class-validator 快 20,000 倍，JSON 序列化比 class-transformer 快 200 倍。开发者只需编写 TypeScript 类型，typia 在构建时生成对应的运行时代码，无需额外 schema 或运行时反射。
typia 在编译时分析 TypeScript 类型，将 typia.is<T>() 等函数调用转换为专用的类型检查代码。它读取 TypeScript 源文件，通过 ttsc（TypeScript 编译器包装器）应用转换，输出优化后的 JavaScript 运行时函数。具体功能包括：is<T>() 返回布尔值，assert<T>() 抛出 TypeGuardError，validate<T>() 返回详细验证结果；json.schema<T>() 生成 JSON Schema，json.assertParse<T>() 和 json.assertStringify<T>() 提供类型安全的解析和序列化；llm.application<Class>() 生成函数调用 schema 和验证器集合，llm.structuredOutput<P>() 生成结构化输出 schema，llm.parse<T>() 宽松解析 JSON；protobuf.message<T>() 生成 Protocol Buffer 消息定义，protobuf.assertDecode<T>() 和 protobuf.assertEncode<T>() 进行安全的编解码；random<T>() 生成随机数据。开发流程是：安装 typia 和 ttsc，使用 ttsc 构建，在代码中调用 typia 函数，构建时自动转换。
- TypeScript 开发者需要零依赖的运行时数据验证，替代 class-validator 等库，提高性能。
- 需要从 TypeScript 类型自动生成 JSON Schema 以用于 API 文档或验证。
- 构建 LLM 函数调用应用，需要为模型提供准确的函数参数 schema 和结果解析。
- 使用 Protocol Buffer 进行高效数据编码解码，同时希望类型安全。
- 在测试或开发中需要快速生成符合 TypeScript 类型的随机数据。
- 希望消除手动维护 schema 和类型定义的双重工作，通过单一类型源驱动所有运行时需求。
这个 Agent 有哪些优点和局限？
- 极高性能：运行时验证比 class-validator 快 20,000 倍，JSON 序列化比 class-transformer 快 200 倍（据 README）。
- 纯 TypeScript 类型驱动：无需额外 schema 或装饰器，减少维护成本。
- 功能全面：涵盖验证、JSON、LLM 函数调用、Protocol Buffer 和随机数据生成。
- 由编译时转换保证类型安全，减少运行时错误。
- 必须使用 ttsc 工具链，不能使用标准 tsc 或 ts-node，增加了构建配置的复杂度。
- 与某些打包器集成需要额外插件（如 @ttsc/unplugin），可能造成兼容性问题。
- 编译时转换可能增加构建时间，特别是大型项目。
- 类型转换的灵活性有限，某些高级类型可能不支持，需要额外工作。
如何安装或部署这个 Agent？
安装 typia 和 ttsc 工具链：
npm i typia
npm i -D ttsc typescript注意：必须使用 ttsc 而不是 tsc，因为 ttsc 能应用 typia 的转换。若使用打包器（如 Vite、Next.js），需安装 @ttsc/unplugin 进行集成。
如何使用这个 Agent？
在 TypeScript 文件中导入 typia 并使用函数，例如 import typia from "typia"; const checkString = typia.createIs<string>();。然后使用 ttsc 构建：npx ttsc，或直接运行脚本：npx ttsx src/index.ts。typia 会在构建时自动生成对应的验证器代码。
这个 Agent 与同类方案有什么区别？
与 typescript-is 库类似，但 typia 提供了更全面的功能（JSON、LLM、protobuf）和更好的性能。其他类似库如 class-validator 需要装饰器和 schema，性能较差。