SuperAPI AI 工具集

fill-model-descriptions

智能体与模型

查看项目

更新于 10-16 00:06

技能介绍

用途:保持 packages/llm-info/data/models.yml 中模型描述简洁准确,补全空描述,并在新增模型或权威文档使旧描述过时时刷新。描述优先取自 OpenRouter,其次回退到厂商文档。

主要能力:为每个 description 为空的条目补全描述;保留人工整理的非空描述,除非新增模型或权威来源使“最新”“最强”、可用性或能力等具体说法过时;不做纯风格改写,必须修改时只做最小事实更正并记录。文件为顶层 YAML 映射,键为 provider id,值为模型条目数组;不得改动其他字段、重排条目或改变格式(如 roles: [chat, edit] 的流式数组、条目间空行、provider 段间空行)。该技能需要网络访问。

使用方式:用 yaml 库的 parseDocument(非 parse)解析以保留格式与注释;建立 { provider, model } 工作清单,先收集所有空描述,再审查同族条目中因新增模型而过时的说法及权威文档导致的事实变化。来源顺序:a. OpenRouter GET https://openrouter.ai/api/v1/models(无需认证),按小写 id 建索引,依次尝试 ${vendor}/${model}、${vendor}/${model.replaceAll('-', '.')};Bedrock 带区域/别名前缀(us.、eu.、jp.、global.、anthropic.、minimax.、mistral.、zai.、nvidia.)时去前缀重试;Google 带 @default 后缀时去后缀并尝试 anthropic/${rest},描述应注明仅 Vertex AI(非 Gemini API)。b. 无 OpenRouter 命中时用 WebSearch 或 WebFetch 查厂商文档(anthropic.com/news、platform.openai.com/docs/models、ai.google.dev/gemini-api/docs/models、mistral.ai/news、x.ai/blog 等)的一行摘要。c. 两者都无把握时保留 description: "" 并记录,空优于错。截断规则:取第一句,去尾部空白与 markdown(**、_、反引号),硬上限 200 字符,超长在 200 前最后词边界截断并加 …,去掉开头冠词,优先能力陈述而非营销语。用解析文档上的定向 Pair 变更写回,参考 packages/llm-info/src/sync-models.ts,stringify 用 { lineWidth: 0, flowCollectionPadding: false }。校验:pnpm --filter @marimo-team/llm-info test(schema.test.ts 捕获结构漂移)。最后报告补全数、更新数(含 provider/model 与事实原因)、跳过数(含列表)。

适用场景:marimo 仓库 llm-info 模型元数据维护。限制:需网络;不保证所有条目都能找到可靠来源;缺失事实暂未提供。