Pi Auto

pi汽车

______________________________________________________________________

先决条件

在使用pi-auto之前，请安装以下内容（全局）：

示例：全局安装并设置 ccusage 别名

# 1. Pi Coding Agent
npm install -g @mariozechner/pi-coding-agent

# 2. Usage tracking (for pi-auto)
npm install -g @ccusage/pi

# 3. Alias for ccusage (pick one: bash or zsh)
echo "alias ccusage='npx @ccusage/pi@latest'" >> ~/.bashrc
# echo "alias ccusage='npx @ccusage/pi@latest'" >> ~/.zshrc

# 4. Pi MCP adapter (run after Pi is installed)
pi install npm:pi-mcp-adapter

# 5. Cursor provider for Pi (optional)
pi install npm:@netandreus/pi-cursor-provider

然后重新加载shell（例如。 source ~/.bashrc 或 source ~/.zshrc)所以 ccusage 可用。

______________________________________________________________________

安装（Pi）

先决条件： 在Pi中安装MCP适配器，使其可以运行MCP服务器：

pi install npm:pi-mcp-adapter

安装pi auto软件包（技能自动加载）：

pi install npm:@netandreus/pi-auto

或者从git：

pi install git:github.com/netandreus/pi-auto

MCP配置： 将MCP服务器添加到pi的配置中，以便代理可以调用工具。

~/.pi/agent/mcp.json （或您的pi MCP配置路径）：

如果您是通过安装的 pi install npm:@netandreus/pi-auto，pi使用全局npm；指向已安装的软件包。使用二进制名称（在包的全局npm安装后）：

{
  "mcpServers": {
      "pi-auto": {
        "command": "pi-auto-mcp",
        "lifecycle": "keep-alive",
        "directTools": true
      }
  }
}

或者使用显式路径（替换 GLOBAL_NPM_ROOT 随着输出 npm root -g):

{
  "mcpServers": {
      "pi-auto": {
        "command": "node",
        "args": ["GLOBAL_NPM_ROOT/@netandreus/pi-auto/dist/index.js"],
        "lifecycle": "keep-alive",
        "directTools": true
      }
  }
}

外露工具： mcp_pi-auto_pi_get_usage, mcp_pi-auto_pi_suggest_provider, mcp_pi-auto_pi_set_provider, mcp_pi-auto_pi_get_provider, mcp_pi-auto_pi_get_strategy, mcp_pi-auto_pi_set_strategy, mcp_pi-auto_pi_get_priority, mcp_pi-auto_pi_set_priority.

技能： 安装软件包后，技能会自动加载。调用 /skill:pi-auto 或者询问使用情况、平衡成本或更换提供商。

______________________________________________________________________

游标代理中的MCP

从以下位置使用pi auto MCP服务器 光标代理 （不仅来自Pi），连接服务器，启用它，并允许它的工具。

1.将MCP服务器连接到代理

将pi auto MCP服务器添加到Cursor的MCP配置中（例如。 ~/.cursor/mcp.json):

{
  "mcpServers": {
    "pi-auto": {
      "command": "pi-auto-mcp",
      "lifecycle": "keep-alive",
      "directTools": true
    }
  }
}

2.启用MCP服务器

服务器可能显示为“未加载（需要批准）”。启用并批准它：

agent mcp list
# pi-auto: not loaded (needs approval)

agent mcp enable pi-auto
# ✓ Enabled and approved MCP server: pi-auto

检查工具是否可用：

agent mcp list-tools pi-auto
# Tools for pi-auto (8):
# - pi_get_priority ()
# - pi_get_provider (scope, projectPath)
# - pi_get_strategy ()
# - pi_get_usage (period)
# - pi_set_priority (priority)
# - pi_set_provider (provider, model, scope, projectPath)
# - pi_set_strategy (strategy)
# - pi_suggest_provider (period)

3.允许使用此MCP中的工具

确保允许游标代理调用pi auto MCP工具。在 ~/.cursor/cli-config.json，下 permissions.allow，包括：

"permissions": {
  "allow": [
    "Shell(ls)",
    "Mcp(pi-auto:*)"
  ],
  "deny": []
}

______________________________________________________________________

特性

______________________________________________________________________

配置

要求： 节点18+，以及（用于使用数据） @球菌/pi 可通过 npx.

环境

服务器配置

策略和优先级存储在 ~/.pi/agent/pi-auto.json.

例子：

{
  "strategy": "load-balancing",
  "priority": ["codex", "claude-code", "cursorai"],
  "defaultModels": {
    "claude-code": { "provider": "anthropic", "model": "claude-sonnet-4-20250514" },
    "codex": { "provider": "openai", "model": "gpt-4o" },
    "cursorai": { "provider": "cursor", "model": "auto" }
  }
}

______________________________________________________________________

使用策略

• 负载平衡 — pi_suggest_provider 使用以下命令选择后端 最低 当前使用情况（令牌总数）。使用 pi_get_usage 查看每个后端的总计；然后打电话 pi_suggest_provider 并且可选 pi_set_provider 切换。
• 高可用性 — pi_suggest_provider 返回 第一 后端在 priority （及其默认模型）。使用 pi_set_priority 更改顺序（例如，首选Codex，然后是Claude，然后是CursorAI）。

当您需要平衡成本或确保首选提供商时，请使用pi auto工具：获取/设置策略和优先级，获取当前提供商，获取使用情况，建议提供商，并设置为 pi_set_provider.

______________________________________________________________________

后端映射

使用来源 @ccusage/pi （与 --json --breakdown)映射到三个后端：

您可以在中覆盖映射和默认模型 ~/.pi/agent/pi-auto.json 如果您的设置不同。

______________________________________________________________________

发布（npm）

发布到 :

1. 登录： npm login （使用有权访问的帐户 @netandreus 范围）。
2. 凹凸版本 在 package.json （例如。 0.1.0 → 0.1.1).
3. 构建和发布：\

npm publish\ （跑步 prepublishOnly → yarn build，然后出版；作用域包通过以下方式作为公共包发布 publishConfig.access.)

查看将包含哪些内容： npm pack --dry-run.

______________________________________________________________________

许可证

麻省理工学院