SuperAPI AI 工具集

better-chatbot-patterns

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:该技能从 better-chatbot 项目提取可移植的实现模板,供自定义 AI 聊天机器人项目参考与改造,区别于讲解项目约定的 better-chatbot 技能。

主要能力(共 5 类模式):

  1. 服务端操作校验器:提供 validatedAction、validatedActionWithUser、validatedActionWithPermission 三种封装,统一处理鉴权、FormData 解析、Zod 校验与错误返回。
  2. 工具抽象系统:用 ToolTag 品牌类型标签区分 MCP、Workflow、Default 等工具类型,通过 isMaybe() 做运行时类型收窄。
  3. 多 AI 提供商配置:以提供商注册表统一初始化 OpenAI、Anthropic、Google、xAI、Groq,并提供 getModel(provider, modelName) 获取模型。
  4. Zustand 状态管理:以浅更新模式更新嵌套 workflow 节点状态与数据,避免直接变更。
  5. Zod 跨字段校验:用 superRefine 处理密码确认、日期区间、条件必填等关联字段规则。

使用方式:将 templates/ 下的 action-utils.ts、tool-tags.ts、providers.ts、workflow-store.ts 复制到项目并改造占位函数(如 getUser()、checkPermission())以适配自身鉴权与角色系统。依赖 zod@3.24.2、zustand@5.0.3、ai@5.0.82,可选 @ai-sdk/openai、@ai-sdk/anthropic、@ai-sdk/google。

适用场景:需要鉴权的服务端操作与表单校验、多类型工具系统、多提供商模型切换、复杂嵌套状态管理、跨字段业务规则校验。

限制:资料未提供安装命令、收费与价格信息;模式需按自身鉴权与权限系统改造,不可直接照搬;工具类型必须做运行时检查,Zustand 状态不可直接变更。