前言¶
在多轮对话里接入 DeepSeek V4 Flash 或 Pro 的 thinking 模式时,请求有时会直接返回 HTTP 400。常见诱因是历史消息里 assistant 回合缺少 API 要求的 reasoning_content 字段,而客户端在拼装下一轮请求时没有补全。手工改消息体或只修主循环往往不够:定时任务、网关会话、辅助任务等路径仍会带上不完整的历史。
下面介绍 SkillHub 社区技能 @user_930668a2/deepseek-thinking-fix(页面名称:deep seek v4 400 解决方案,Hermes和open claw完美版),它在发往 API 之前对 assistant 消息做统一回填,并覆盖文档中列出的多条代码路径。
这是什么¶
该技能属于 dev-programming 分类,由社区发布者 user_930668a2 维护,当前版本 1.0.2,来源标注为 community。SkillHub 坐标为 @user_930668a2/deepseek-thinking-fix。
官方简介说明其定位:修复 DeepSeek V4 Flash/Pro 在 thinking 模式、多轮对话场景下的 400 错误;在每次请求发出前,自动为所有 assistant 消息回填 reasoning_content;并覆盖主循环、cron、gateway session 与 auxiliary task 等路径。页面标签标明 requires_api_key=false(技能本身不强制配置 API Key,实际调用 DeepSeek 仍取决于你的运行环境)。
- SkillHub 展示页:https://www.skillhub.cn/skills/user_930668a2/deepseek-thinking-fix
- API 资源地址:https://api.skillhub.cn/user_930668a2/deepseek-thinking-fix
核心功能¶
依据 SkillHub 页面与简介,可核实的能力如下。
-
多轮 thinking 400 修复
针对 DeepSeek V4 Flash/Pro 开启 thinking 模式后,多轮上下文导致的请求失败(400)。 -
reasoning_content自动回填
在将消息列表提交给 API 之前,对历史中的 assistant 消息补齐reasoning_content,避免缺字段触发校验错误。 -
全路径覆盖
不仅处理主对话循环,还覆盖 cron jobs、gateway sessions、auxiliary tasks 等辅助入口,减少「主流程正常、旁路仍 400」的情况。
页面未单独列出 Hermes 或 OpenClaw 的配置项名称;名称中的「Hermes和open claw完美版」以 SkillHub 展示为准,具体挂载方式遵循你所用 Agent 的 skills 目录约定(见下文安装一节)。
安装与启用¶
SkillHub 推荐两种方式:用 CLI 安装,或把安装提示交给当前 AI Agent 按官方安装文档执行。
1. 安装 SkillHub CLI(若尚未安装)¶
command -v skillhub && skillhub --version
未安装时可执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本技能¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。
skillhub install user_930668a2/deepseek-thinking-fix --dir <你的 skills 目录>
SkillHub 技能页给出的坐标写法为 @user_930668a2/deepseek-thinking-fix;安装细节以 https://skillhub.cn/install/skillhub.md 为准。页面亦提示:可根据该文档,让 AI 安装 @user_930668a2/deepseek-thinking-fix。
3. 各客户端 skills 目录(摘自 SkillHub 安装文档)¶
| 环境 | 典型 skills 路径 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| OpenClaw 及变体 | 对应发行版文档中的 skills 目录 |
安装到正确目录后,按你所用 Agent 的要求重启或刷新技能列表,使 SKILL 生效。
典型用法¶
公开页面未提供独立的「调用示例」代码块;该技能以 Agent Skill(SKILL.md) 形式工作:启用后由 Agent 在组装 DeepSeek V4 thinking 请求时介入,无需在业务代码里手写回填逻辑。
可复现的启用流程可以概括为:
- 按上一节将
@user_930668a2/deepseek-thinking-fix安装到当前环境的 skills 目录。 - 在已集成 DeepSeek V4 Flash/Pro thinking 的 Agent(含 OpenClaw 一类支持 skills 的运行时)中开启该技能。
- 进行多轮对话或触发 cron / gateway / 辅助任务,观察原先出现的 400 是否消失。
若需确认技能是否被加载,以你所用客户端的 skills 列表或日志为准;SkillHub 页面未给出额外环境变量或配置文件名。
适用场景与注意¶
适合谁
- 在 Agent、OpenClaw 或兼容 SkillHub 技能机制的客户端里,使用 DeepSeek V4 Flash/Pro thinking 模式,并在多轮对话中遇到 400。
- 希望由技能统一处理
reasoning_content回填,而不是在每个请求出口手写补丁。
限制与注意
- 技能解决的是「assistant 历史缺少
reasoning_content」一类与简介描述一致的问题;若 400 来自鉴权、模型名错误、配额等其他原因,需要另行排查。 - SkillHub 展示的安装数为页面实时统计(抓取时约为 761 次下载),与具体业务案例无关;勿将评分或下载量等同于生产验证。
- 版本以 SkillHub 为准(当前 1.0.2);升级可用
skillhub对该坐标执行更新,并继续指定正确的--dir。 - 社区来源(community):合并或启用前建议查看技能包内 SKILL.md 与变更说明,确认与本地 DeepSeek 接入方式一致。
结尾¶
@user_930668a2/deepseek-thinking-fix 把 DeepSeek V4 thinking 多轮场景里常见的 400 问题收敛为「发 API 前统一回填 assistant 的 reasoning_content」,并声明覆盖主循环与 cron、gateway、辅助任务等路径。若你正卡在同类错误上,可从 SkillHub 安装到当前 Agent 的 skills 目录后启用。
- 技能页:https://www.skillhub.cn/skills/user_930668a2/deepseek-thinking-fix
- 安装说明:https://skillhub.cn/install/skillhub.md