Models Config Skill Skill

Models Config Skill

功能

编辑和管理 ~/.pi/agent/models.json 配置文件，支持多种 API 协议的测试和验证，以及从 https://models.dev/api.json 自动获取模型价格信息。

配置结构

{
  "providers": {
    "provider-name": {
      "baseUrl": "https://api.example.com",
      "apiKey": "sk-xxx",
      "api": "anthropic-messages|openai-completions|openai-responses",
      "authHeader": true
    }
  }
}

使用方法

基本操作

# 编辑配置文件
bat ~/.pi/agent/models.json

# 验证 JSON 格式
python3 -m json.tool ~/.pi/agent/models.json

协议类型

| API 类型 | 用途 | 端点格式 | |---------|------|---------| | anthropic-messages | Claude 消息 API | /v1/messages | | openai-completions | OpenAI Completions API | /v1/chat/completions | | openai-responses | OpenAI Responses API | /v1/responses |

测试方法

1. Anthropic Messages API

export ANTHROPIC_BASE_URL=https://api.xairouter.com
export ANTHROPIC_AUTH_TOKEN=sk-XvsJhNdiXcDYA3e5hzD1AJP5ploMAaFuMTUxp3bHRfCiZRNt

curl $ANTHROPIC_BASE_URL/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

2. OpenAI Completions API (Chat)

export OPENAI_BASE_URL=http://127.0.0.1:8317/v1
export OPENAI_API_KEY=proxypal-local

curl $OPENAI_BASE_URL/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "glm-4.7",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

3. OpenAI Responses API

export OPENAI_BASE_URL=http://127.0.0.1:8317/v1
export OPENAI_API_KEY=proxypal-local

curl $OPENAI_BASE_URL/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "glm-4.7",
    "input": "Hello"
  }'

4. 简化测试脚本

#!/usr/bin/env bash
# test-model.sh

PROVIDER=$1
BASE_URL=$2
API_KEY=$3
MODEL=$4

echo "Testing $PROVIDER with model $MODEL..."

case "$PROVIDER" in
  anthropic)
    curl -s "$BASE_URL/v1/messages" \
      -H "x-api-key: $API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "content-type: application/json" \
      -d "{\"model\":\"$MODEL\",\"max_tokens\":256,\"messages\":[{\"role\":\"user\",\"content\":\"Hi\"}]}" \
      | jq .
    ;;
  openai-chat)
    curl -s "$BASE_URL/chat/completions" \
      -H "Authorization: Bearer $API_KEY" \
      -H "content-type: application/json" \
      -d "{\"model\":\"$MODEL\",\"max_tokens\":256,\"messages\":[{\"role\":\"user\",\"content\":\"Hi\"}]}" \
      | jq .
    ;;
  openai-responses)
    curl -s "$BASE_URL/responses" \
      -H "Authorization: Bearer $API_KEY" \
      -H "content-type: application/json" \
      -d "{\"model\":\"$MODEL\",\"input\":\"Hi\"}" \
      | jq .
    ;;
esac

使用示例：

# 测试 Anthropic
bash test-model.sh anthropic \
  https://api.xairouter.com \
  sk-XvsJhNdiXcDYA3e5hzD1AJP5ploMAaFuMTUxp3bHRfCiZRNt \
  claude-sonnet-4-5

# 测试 OpenAI Chat
bash test-model.sh openai-chat \
  http://127.0.0.1:8317/v1 \
  proxypal-local \
  glm-4.7

常见配置

本地服务 (ProxyPal)

{
  "proxypal": {
    "baseUrl": "http://127.0.0.1:8317/v1",
    "apiKey": "proxypal-local",
    "api": "openai-completions",
    "authHeader": true
  }
}

Cloud 服务 (xAIRouter)

{
  "xairouter": {
    "baseUrl": "https://api.xairouter.com",
    "apiKey": "sk-xxx",
    "api": "anthropic-messages",
    "authHeader": true
  }
}

Ngrok 隧道

{
  "ngrok": {
    "baseUrl": "https://xxx.ngrok-free.dev/v1",
    "apiKey": "proxypal-local",
    "api": "openai-responses",
    "authHeader": true
  }
}

价格更新功能

从 https://models.dev/api.json 获取模型价格并更新到配置文件。

使用方法

# 更新所有模型价格
bun ~/.pi/agent/skills/models-config/update-prices.ts

工作原理

从 https://models.dev/api.json 获取最新价格数据
读取 ~/.pi/agent/models.json 配置文件
按 model ID 智能匹配价格信息
更新 cost 字段（input/output/cacheRead/cacheWrite）
显示更新摘要

匹配规则

优先级（从高到低）：

精确匹配：model ID 完全相同
标准化匹配：去除前缀、版本号后相同
- anthropic/claude-sonnet-4-5 → claude-sonnet-4-5
- claude-sonnet-4-5-20250929 → claude-sonnet-4-5
模糊匹配：基于 Levenshtein 距离的相似度匹配（≥70%）
- 自动匹配最佳相似度的模型
- 显示匹配相似度百分比

支持的别名映射：

| 你的模型 ID | 匹配到 | |------------|--------| | opus4.5 | claude-opus-4-5 | | claude-sonnet-4-5-20250929 | claude-sonnet-4-5 | | claude-haiku-4-5-20251001 | claude-haiku-4-5 | | z-ai/glm4.7 | glm-4.7 | | minimaxai/minimax-m2.1 | minimax-m2.1 |

模糊匹配示例

即使你的供应商不在 models.dev 中，只要模型名称相似，也会自动匹配：

bun ~/.pi/agent/skills/models-config/update-prices.ts

# 输出示例：
✓ Updated: claude-sonnet-4-5
  Old: {"input":0,"output":0,"cacheRead":0,"cacheWrite":0}
  New: {"input":2.6,"output":13,"cacheRead":0.26,"cacheWrite":3.2}
✓ Updated: glm-4.7
  Fuzzy matched "glm-4.7" -> "zai-glm-4.7" (85.7% similarity)
  Old: {"input":0,"output":0,"cacheRead":0,"cacheWrite":0}
  New: {"input":0,"output":0,"cacheRead":0,"cacheWrite":0}

=== Summary ===
Updated: 15 models
Not found: 3 models

Models without price data:
  - custom-model-x
  - experimental-beta

注意事项

baseUrl 格式：
- anthropic-messages: 不需要 /v1 后缀
- openai-*: 通常需要 /v1 后缀
认证方式：
- Anthropic: x-api-key header
- OpenAI: Authorization: Bearer header
测试前检查：
- 确认服务端口已启动（如 curl http://127.0.0.1:8317）
- 检查 API Key 有效性
- 验证网络连通性
价格更新：
- 模糊匹配阈值：70% 相似度
- 匹配成功会显示相似度百分比
- 未匹配的模型会在摘要中列出
- 价格单位：美元/百万 tokens ($/1M tokens)

Agent Skills: Models Config Skill

Install this agent skill to your local

Skill Files