pi-ccs
本地切换AI模型与提供商,支持参数覆盖与标签
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:pi-ccs。 它的用途是:本地切换AI模型与提供商,支持参数覆盖与标签 完整的 Skill 内容见:https://321skill.com/skills/pi-ccs/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用pi-ccs将当前AI模型切换到Anthropic的claude-3-opus,并设置temperature为0.5,标签显示为“Claude-精准”',它会执行npm run pi-ccs switch --provider anthropic --model claude-3-opus --params '{"temperature":0.5}' --label 'Claude-精准',自动修改本地配置并生效。
介绍
在开发AI应用或智能体时,经常需要切换不同的模型提供商(如OpenAI、Anthropic、本地模型等),并针对不同场景调整参数。pi-ccs 是一个轻量级 Pi 扩展包,基于 cc-switch 本地切换逻辑,允许你通过简单的命令或配置快速切换当前使用的模型提供商,同时支持参数覆盖(如 temperature、max_tokens)和短显示标签,方便管理和识别。
使用方式非常直接:通过 npm 安装后,在项目或 Pi 配置中调用 pi-ccs 提供的接口,即可指定目标提供商和模型,并传入需要覆盖的参数。包会自动处理本地配置文件的修改,并生成易读的标签(如“GPT-4o-快速”),避免频繁手动编辑环境变量或配置文件。
适合需要频繁切换模型进行测试或对比的开发者,特别是智能体开发、后端服务开发以及全栈开发者。如果你正在构建依赖多个 AI 模型的应用,或者需要为不同任务分配不同模型(如快速回复用低成本模型,复杂推理用高性能模型),pi-ccs 能显著提升效率。
使用前建议先确认本地已安装 Node.js 和 npm,并确保你有对应模型提供商的 API Key。注意,该工具仅负责切换配置,不管理模型调用本身,也不提供模型运行环境。如果项目涉及多个环境或需要版本控制,建议将配置文件纳入.gitignore。
核心特点
同类工具有 cc-switch 等,但 pi-ccs 专门为 Pi 生态定制,提供参数覆盖和短标签功能,节省手动解析配置的时间,且与 Pi 的智能体开发流程更紧密集成。
注意事项
仅适用于 Pi 框架或项目中需要使用 npm 包管理模型切换的场景,不适用于非 Node.js 环境或无需本地配置切换的在线平台。
常见问题
pi-ccs 支持哪些模型提供商?
基于 cc-switch 的底层支持,理论上兼容所有主流提供商(OpenAI、Anthropic、Google、本地模型等),具体取决于你本地的 cc-switch 配置。
如何设置参数覆盖?
在调用切换函数时传入一个对象,例如 { temperature: 0.7, max_tokens: 2000 },即可覆盖默认参数。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/pi-ccs/raw/index.md 读取 pi-ccs 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-ccs/raw/index.md(查看排版版本)