前言¶
在同一套 Agent 工作流里,复杂任务往往希望用能力更强的模型,而查资料、改文案、批量小改动则更适合快且便宜的档位。若每次都要去改全局配置或重开会话,上下文也容易断掉。Model Switcher 是 SkillHub 上由社区发布者 user_346b2eef(页面展示作者为 Rain)维护的 ai-agent 类 Skill,版本 1.0.0,来源为 community。它把「在当前会话里换模型」收敛成自然语言指令和固定执行步骤,面向 DeepSeek V4 Pro 与 DeepSeek V4 Flash 两个档位,且页面标注 requires_api_key=false(Skill 包本身不额外要求 API Key)。
这是什么¶
Model Switcher 遵循通用 SKILL.md 格式:包内主要是给 Agent 阅读的操作说明,不包含独立脚本。坐标为 @user_346b2eef/deepseek-model-switcher,在 SkillHub 上的展示页为 Model Switcher,API 入口为 https://api.skillhub.cn/user_346b2eef/deepseek-model-switcher。截至资料抓取时,SkillHub 显示评分 100000,下载 941 次,安装计数为 0(以商店统计为准)。
核心功能¶
根据包内 SKILL.md,该 Skill 的能力可以概括为以下几点。
- 会话级模型切换:在 DeepSeek V4 Pro 与 DeepSeek V4 Flash 之间切换当前会话使用的模型,而不是改写全局默认模型。
- 自然语言触发:用户用口语表达「切 Pro / 切 Flash / 切回去」等意图时,由 Agent 按 Skill 规则识别并执行。
- 固定调用方式:切换时通过
session_status(model=...)传入对应模型 ID(见下文表格)。 - 切换后确认:执行完成后用简短回复说明当前模型,并可附带 Token 成本量级提示(Skill 要求回复简洁)。
| 模型 | session_status 的 model 参数 |
Skill 中的定位 |
|---|---|---|
| DeepSeek V4 Pro | deepseek/deepseek-v4-pro |
能力强,成本高 |
| DeepSeek V4 Flash | deepseek/deepseek-v4-flash |
速度快,成本低 |
安装与启用¶
下面介绍通过 SkillHub CLI 安装到当前 Agent 能识别的 skills 目录。安装说明以 SkillHub 安装文档 为准。
1、检查 CLI
command -v skillhub && skillhub --version
未安装时可执行完整安装(文档推荐):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 Model Switcher
搜索结果显示的安装坐标为 deepseek-model-switcher,命名空间为 user_346b2eef。安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落到 ./skills/ 可能不会被识别。
skillhub install deepseek-model-switcher --namespace user_346b2eef --dir <你的 Agent skills 目录>
常用路径示例(来自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可将提示词交给 Agent,让其按安装文档安装 @user_346b2eef/deepseek-model-switcher。
3、启用后
各客户端对 Skill 的发现方式不同;安装到正确目录后,按你所用 Agent 的说明刷新或重启会话,使 SKILL.md 进入技能列表。本包仅含说明文件,无额外环境变量或配置文件字段需要填写。
典型用法¶
Skill 内写的触发与执行流程如下,可在支持 session_status 的 Agent 环境中复现。
触发条件(用户消息包含类似意图时)
- 切换到 Pro:
切换pro、切Pro、换Pro、换V4 Pro,或切换模型到Pro - 切换到 Flash:
切换flash、切Flash、换Flash、换V4 Flash,或切换模型到Flash - 回到 Flash:
切回去、换回去、切换回(Skill 规定为切换到 Flash)
执行流程
- 判断用户要 Pro 还是 Flash。
- 调用其一:
- Pro:session_status(model="deepseek/deepseek-v4-pro")
- Flash:session_status(model="deepseek/deepseek-v4-flash") - 回复确认:当前模型已切换,并简要说明 Token 成本约况。
适用场景与注意¶
适合谁
- 已在 DeepSeek 相关 Agent 链路中使用 V4 Pro / V4 Flash,且运行时提供
session_status一类会话状态工具的用户。 - 希望在同一对话里按任务难度临时升档或降档,而不反复改
default_model的开发者。
限制与注意(均来自 Skill 说明)
- 切换只影响当前会话;群聊等其他会话不受影响。
default_model不变,仅覆盖本 session 的模型选择。- Agent 必须能理解并调用
session_status;若你所用的客户端没有该工具,Skill 中的执行步骤无法落地,需要先确认运行环境。 - 切换后的回复应简短,避免冗长说明。
结尾¶
Model Switcher 把 DeepSeek V4 Pro 与 V4 Flash 的会话级切换写成可触发的 Skill 流程,适合在成本与能力之间按轮次调节。安装与详情见 SkillHub:https://www.skillhub.cn/skills/user_346b2eef/deepseek-model-switcher,API 页:https://api.skillhub.cn/user_346b2eef/deepseek-model-switcher。