SuperAPI AI 工具集

maintain-model-list

智能体与模型

查看项目

更新于 10-15 19:54

技能介绍

用途:维护项目受支持的 LLM 模型列表,既包括按指定模型新增,也包括无指定模型的例行维护,验证现有模型可用性并发现值得添加的新模型。模型列表保存在三处并需保持同步:文档页 page.tsx 中的 MODEL_GROUPS 与 BASELINE、实时测试文件 models.live.test.ts 中镜像的 MODEL_GROUPS 及 OPENROUTER_ID_OVERRIDES / ALIYUN_ID_OVERRIDES、utils.ts 中的 modelPatch(按模型族修正请求参数,如思考/推理开关、tool_choice 差异)。

流程:改动前先运行 git status,若有不相关的未提交改动则不得编辑文件,需先报告并征得用户同意。以完整实时测试作为基线:npm run test:live -w @page-agent/llms,密钥来自仓库根目录 .env(TESTING_OPENROUTER_KEY、TESTING_ALIYUN_KEY、TESTING_DEEPSEEK_KEY),缺密钥时测试静默跳过,需确认哪些 provider 实际执行并记录通过/失败情况。

指定模型时:调研其是否在 OpenRouter 提供及确切 id,其他渠道(厂商原生 API、阿里云 DashScope 等)的原生 id,API 差异(推理能否关闭、工具调用参数怪癖),以及工具调用支持、上下文窗口、延迟与成本;必要时更新 modelPatch,并加入两处 MODEL_GROUPS(组内新的在前),id 不一致时加覆盖;跑实时测试确认每个提供该模型的 provider 通过,持续失败则从该 provider 排除并注释原因;仅当模型快速、便宜、工具调用强时才考虑加入 BASELINE;最后运行 npm run typecheck 和 npm test。

例行维护时:跑实时测试核查现有列表,调查新失败(弃用、改名、provider 下架),对照当前 OpenRouter 模型接口检查 id 覆盖漂移,检索新模型候选(须支持 OpenAI 兼容 API 的工具调用);小改动可自行按流程处理后再交用户判断,新增或移除需先报告建议由用户决定。

交接:测试通过后须提醒用户手动验证,告知在 .env 中按渠道填入的精确模型 id(含 OpenRouter id,如 LLM_BASE_URL、LLM_API_KEY、LLM_MODEL_NAME),并运行 npm run dev:demo(端口 5174)在真实页面上实测;实时测试只验证单次强制工具调用往返,不等于智能体质量评估,用户手动运行才是最终验收。限制:以上仅为该技能文档提供的步骤与约束,其他信息暂未提供。