SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

dsh 本轮运行失败、API 密钥无效:真实原因与排查顺序

dsh 显示「本轮运行失败」「API 密钥无效」,密钥却可能没问题:适配器把上游的 401 和 403 都归为 AUTH,界面还丢掉原文。先用 curl 在 dsh 外复现,再从会话日志找回真实报错。

dsh 的「API 密钥无效」到底在说什么

dsh 报出「本轮运行失败」和「API 密钥无效」,并不说明你的 API 密钥坏了。「本轮运行失败」是 dsh 每一轮出错时都会显示的通用标题。「API 密钥无效」是一句固定文案。只要这次失败被归成 AUTH 这一类,界面就显示它,同时丢掉上游服务商返回的原文。在 @deepseek-ai/dsh 0.2.1-rc.2 里,适配器先把上游的 401 或 403 归为 AUTH,然后才判断是不是额度用尽。所以额度耗尽、余额不足、网关拒绝,都可能显示成「密钥无效」。

截至 2026-10-21,能证明这个行为的只有社区报告和代码本身。下面列出的几个讨论帖,页面上都还没有维护者回复。排查分三步:先在 dsh 之外用 curl 测同一个 key,再从会话日志里找回上游的原始报错,最后确认 dsh 进程实际拿到的是哪把密钥。

以下内容以 npm 上的 @deepseek-ai/dsh 0.2.1-rc.2 为准。2026-10-21 当天,latest 和 next 两个标签都指向这个版本(alpha 标签是 0.2.1-alpha.5)。下面所有命令都要你自己在本机运行,因为它们要调用远程 API,或者读取你本地的文件。

这两行字分别来自哪里

两条文案都在聊天界面包 @deepseek-ai/dsh-client-ui-chat 里。0.2.1-rc.2 中它们的键名和中英文如下:

message.turnError      本轮运行失败    (en: This turn failed)
message.failure.auth   API 密钥无效    (en: API key is invalid)

界面决定显示什么,顺序大致是这样:先处理 ACCOUNT_SIGNED_OUT、INTERRUPTED、ACCOUNT_SIGN_IN_REQUIRED、QUOTA、ACCOUNT_QUOTA 这几种代码。接着,如果代码是 AUTH,就返回固定的本地化文案,原始消息被置为空字符串。其余代码则直接显示原始消息。

所以界面上的「API 密钥无效」后面,不会再有任何上游信息。它只告诉你一件事:这次失败被归成了 AUTH。

不过原文并没有丢。@deepseek-ai/dsh-llm 里的 normalizeLlmFailure 不会清空 AUTH 的消息,原始消息会跟着失败记录写进会话日志。清空只发生在聊天界面这一层。这就是第二步能把原文找回来的原因。

社区报告过哪些「假的密钥无效」

下面都是别人报告的案例,不是我们的测量。数字和配置都由报告者给出。

  • deepseek-harness 讨论 #5715(mengge237,2026-09-05):阿里云百炼的免费额度用完后,dsh 显示 API key is invalid。会话日志里 turn/end 记录的代码是 "AUTH",消息以 403: 开头,并且含有 Free quota exhausted.。评论者 Saidoua 指出,界面对 AUTH 清空消息是有意设计的,真正的问题是分类函数先测 401/403、后测额度。报告者在 2026-09-23 收回了自己最初「这是界面层 bug」的判断。
  • 讨论 #7799(zhaocjiang,2026-09-24):请求体超过了一个中转网关的 8 MiB 上限。网关在主渠道返回 413,随后转移到备用渠道,备用渠道返回 403 Insufficient account balance。dsh 显示「本轮运行失败」加「API 密钥无效」,代码是 AUTH。报告者说把 maxRequestImageBytes 调到 6 MiB 后恢复正常。8 MiB 和 6 MiB 是报告者环境里的数字,不是 dsh 的默认值。
  • 讨论 #8433(fuanan,2026-09-30,Q&A 分类,标为 Unanswered):已经正常登录、能和模型对话,聊着聊着弹出「本轮运行失败,API密钥无效」。唯一一条评论来自社区成员 PerryLink。他建议先用 curl 拿同一个 key 测端点:curl 也失败,就是 key、账户、地域或端点的问题;curl 成功,问题就在 dsh 这一侧。下面的第一步就是这个思路。
  • dsh-our-free-model 的 issue #344(buganmao,2026-10-15):添加华为云渠道后,提问直接回复「本轮运行失败 API 密钥无效」。细节放在后面的免费模型插件一节。

在 deepseek-harness 讨论区搜「API 密钥无效」,列表里还有更多同类标题:#10008(报告称 Kimi 每周额度用尽的 403 被归为 AUTH,官方文档将该错误列为 429)、#9636(429 被误归为 AUTH)、#3222(403 归为 AUTH 后原始报错被隐藏)、#10412(OpenCode 免费模型 ID 解析出错导致 403,被报成密钥无效,已关闭)、#5794(Web UI 报 API key is invalid,headless 模式却正常)。除了 #10008,这几条我们只读了列表里的标题,引用细节前请自己点开。如果你是在 VPS 上通过浏览器使用 dsh,在 VPS 上访问 dsh Web 界面 讲了这条访问链路怎么搭。

2026-10-21 我们查看时,#5715、#7799、#8433、#10008 和 #344 的页面上都没有维护者回复。#7799 和 #10008 各有一条来自 PerryLink 的评论,他不是维护者。

为什么 403 会被显示成「API 密钥无效」

dsh 把调用模型的工作交给适配器包。0.2.1-rc.2 里和这个问题有关的适配器有两个:@deepseek-ai/dsh-llm-pi-ai 和 @deepseek-ai/dsh-llm-deepseek。它们把上游错误归成几类代码,AUTH 是其中一类。

dsh-llm-pi-ai 的 classifyPiAiError(message) 用正则表达式匹配错误消息的文本。我们读到的先后顺序是:

if (/\b(?:401|403)\b/.test(message)) return "AUTH";
// ...
if (isQuotaExceededError(message)) return QUOTA_EXCEEDED_CODE;

再往后才是 429 与限流,然后是 413 和 failed to buffer the request body,后两者归为 INVALID_REQUEST。因为匹配的是文本,消息里只要出现一个独立的 401 或 403,就会被判成 AUTH,哪怕后面写着额度已经用完。pi-ai 的 README 自己也说明了原因:pi-ai 的错误事件在不同服务商之间不提供稳定的 HTTP 状态码,所以只能读文本。

dsh-llm-deepseek 在一个叫 providerError 的函数里分类。#5715 的评论里用的是另一个名字 httpErrorCode,那是 9 月时的版本。我们读到的两行是:

if (status === 401 || status === 403 || ["authentication_error", "permission_error"].includes(type)) code = "AUTH";
else if (isQuotaExceededError(detail) || status === 402) code = "QUOTA";

后面依次是 RATE_LIMIT、CONTEXT_WINDOW_EXCEEDED、INVALID_REQUEST(400、413 或 invalid_request_error)和 SERVER。也就是说,状态码一旦是 403,额度判断就没有机会运行。

isQuotaExceededError 本身定义在 @deepseek-ai/dsh-llm 的 lib/types/error.js 里,QUOTA_EXCEEDED_CODE 的值是 'QUOTA'。它认的是几种英文写法,例如 insufficient quota、quota exceeded、out of credits。#10008 的报告者建议扩充这些写法,报告中贴出的错误是 HTTP 403,消息包含「You've reached your weekly (7-day) usage limit.」,type 是 access_terminated_error,现有写法匹配不到。但截至 2026-11-15,Kimi 官方错误参考将这条周额度错误列为 HTTP 429,示例是 error, status code: 429, message: You've reached your weekly (7-day) usage limit.;社区报告不能证明 403 是 Kimi 的官方响应。官方还说明,这条周额度错误只适用于旧套餐的现有会员,新套餐会员不受该周额度限制。报告者要求补上的有 reached ... usage limit、access_terminated_error、upgrade your plan 和 purchase extra usage。

所以 0.2.1-rc.2 的答案是:两个适配器都还是先判 401/403,再判额度。上面这些代码片段来自我们阅读 unpkg 上的 0.2.1-rc.2 文件,不是在你机器上 grep 的结果。请在自己的环境里确认。

如果 dsh 是用 npm 全局安装的,直接在安装目录里搜:

find "$(npm root -g)" -path '*@deepseek-ai/dsh-llm*/lib/index.js' -exec grep -nHE '401|403|isQuotaExceededError' {} + | cut -c1-200

在同一个文件里,如果 401/403 那一行的行号比 isQuotaExceededError 那一行小,你的版本就仍然是「先判 AUTH,后判额度」。

桌面版或其他安装方式不一定把文件放在这里。那就把同版本的包下载到一个新的空目录里,每个包解压到各自的子目录:

mkdir -p ~/dsh-src && cd ~/dsh-src
npm pack @deepseek-ai/dsh-llm-deepseek@0.2.1-rc.2 @deepseek-ai/dsh-llm-pi-ai@0.2.1-rc.2 @deepseek-ai/dsh-llm@0.2.1-rc.2
for p in dsh-llm-deepseek dsh-llm-pi-ai dsh-llm; do mkdir -p "$p" && tar -xzf "deepseek-ai-$p-0.2.1-rc.2.tgz" -C "$p"; done
grep -nE 'status === 40[13]|isQuotaExceededError' dsh-llm-deepseek/package/lib/index.js
grep -nE '401\|403|isQuotaExceededError' dsh-llm-pi-ai/package/lib/index.js
grep -n "QUOTA_EXCEEDED_CODE" dsh-llm/package/lib/types/error.js

这些文件只用来读,不要在这个目录里运行任何东西。

先确认你跑的是哪个版本

分类顺序可能随版本变化。先看清楚自己的版本,再对照上面的结论:

npm ls -g @deepseek-ai/dsh

这条命令只对 npm 全局安装有效。#9962 里有人发现,命令行和桌面版可以是两个不同的版本,例如命令行还停在 0.1.7-rc.1,桌面版已经是 0.2.1-rc.2。哪个界面报错,就查哪个的版本。安装和升级本身出了问题,请看 dsh 安装与版本报错的排查。

第一步:在 dsh 之外,用 curl 测同一个 key

这一步只有一个目的:把「key 本身能不能用」和「dsh 怎么用它」分开。base URL 必须和 dsh 里配置的完全一样,包括结尾的 /v1 这类路径。模型 ID 也用 dsh 里选中的那个。

先把 key 读进变量,这样它不会进入 shell 历史。read -rs 不回显输入,粘贴后按回车即可:

read -rs TEST_KEY && export TEST_KEY
export BASE_URL='https://api.example.com/v1'
export MODEL='你在 dsh 里选中的模型 ID'

OpenAI 兼容的服务商通常提供 GET /models,可以先测它,看端点通不通、key 会不会被直接拒绝。注意 dsh 的模型列表不一定来自这个请求:2026-10-27 我们读 deepseek-harness 当前源码时,pi-ai 适配器的 listModels 先解析一次凭据,然后直接读取本地的模型集合,并不请求 /models。所以这一步测的是端点和 key,不是在复现 dsh 的模型发现:

curl -sS -i "$BASE_URL/models" -H "Authorization: Bearer $TEST_KEY" | head -n 30

/models 能通,也不一定说明 key 通过了认证。有些端点根本不校验 key,例如 Ollama 的 OpenAI 兼容接口文档写明,客户端需要填一个 API key 值,但 Ollama 会忽略它。何况 dsh 失败的是生成请求,所以再发一个同类的最小请求:

curl -sS -i "$BASE_URL/chat/completions" \
  -H "Authorization: Bearer $TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"'"$MODEL"'","messages":[{"role":"user","content":"ping"}],"max_tokens":8}'

-i 会把状态行和响应头一起打印出来。先看第一行的状态码,再读响应体:

  • 401:请求缺少目标资源所需的有效认证凭据。检查 key 是否抄错、已被撤销,以及平台、地域和端点是否匹配。无效 key 不一定返回 401:Google GenerateContent 错误参考中的无效密钥示例返回 400,消息是 API key not valid. Please pass a valid API key.,reason 是 API_KEY_INVALID。按响应体确认原因后再更正 key 或端点。
  • 403:上游理解了请求,但拒绝执行;这不证明它已经识别或认证了你,拒绝原因也可以与凭据无关。一定要读响应体。额度用尽、余额不足、地域限制、模型未开通,都可能以 403 返回。#5715 的响应体里写的就是 Free quota exhausted.。如果原文说的是这把 key 没有访问该模型或资源的权限,换一把有权限的 key,或者给原来的 key 开通权限,也能解决。Google Gemini API 的错误参考对 403 的描述就是 API key 没有访问这个资源的权限,或者项目的 API 访问受到限制。
  • 200 并且有回复:这把 key 在这个地址上能正常生成内容。问题在 dsh 这一侧。它用的可能是另一把 key、另一个地址、另一个模型 ID,或者它发出的请求和你测的不一样。#7799 就是请求体太大,你的小请求不会触发那个上限。

如果服务商用的不是 OpenAI 兼容协议,就按它自己文档里的最小请求来测,判断方法相同。

curl 返回 200 而 dsh 仍然失败时,不要急着换 key。先做第二步,看 dsh 实际收到了什么。

第二步:从会话日志里找回原始报错

聊天界面清空了 AUTH 的消息,但会话日志里还留着。0.2.1-rc.2 的会话文档里,turn/end 事件有两个字段:turn(轮次编号)和 reason(这一轮结束的原因)。reason 的类型有 completed、aborted、blocked、error、max-tokens、interrupted 和 forked。类型为 error 时,reason 里带一个 error 字段,内容是结构化的失败信息,包含 message 和 code。所以要找的是 reason 里 error 下面的 message,不是 turn/end 记录顶层的字段。

日志由 JSONL 后端写入。JSONL 指每行一个 JSON 对象的文本格式。每个会话一个目录,0.2.1-rc.2 的布局是:

<root>/--<规范化后的工作目录>--/<编码后的会话 ID>/session.v3.jsonl.zstd

默认用 zstd 压缩。压缩设成 none 时,文件是不带 .zstd 后缀的 .jsonl。root 在这个后端包里是必填项,没有默认值。正常启动 dsh 时 root 落在哪个目录,我们读过的文档里没有写明。所以不要猜路径,直接搜最近一小时改动过的日志:

find "${DSH_HOME:-$HOME/.dsh}" -name 'session*.jsonl*' -mmin -60 2>/dev/null

没有结果,就把范围扩大到整个家目录:

find "$HOME" -name 'session*.jsonl*' -mmin -60 2>/dev/null

压缩日志要用 zstd 解开。Ubuntu 上用 sudo apt install -y zstd jq 安装 zstd 和 jq。然后取出最后一条 turn/end 记录:

f='上一步找到的文件路径'
case "$f" in *.zst*) zstd -dc "$f" ;; *) cat "$f" ;; esac | grep 'turn/end' | tail -n 1 | jq .

如果 grep 'turn/end' 没有结果,改成 grep '"AUTH"' 再试。在输出里找 "code": "AUTH" 旁边的 message。#5715 报告的那一条以 403: 开头,后面跟着服务商的原文,里面有 Free quota exhausted.。看到这种原文,该做的是充值或等额度恢复,换 key 解决不了。

日志里有你的提示词和代码。需要发帖求助时,只贴这一条记录里的 code 和 message,不要贴整份日志。

第三步:确认 dsh 进程拿到的是哪把密钥

如果前两步说明 key 本身没问题,剩下最常见的情况是:dsh 用的不是你测的那把 key。apiKeyEnv 里填的是一个环境变量名,dsh 在每次请求时解析它。它读的是 dsh 进程自己的环境,不是你当前登录 shell 的环境。dsh 的 API 密钥、模型和端点配置 已经讲过这一点,包括 systemd 单元为什么拿不到你在交互 shell 里 export 的变量,这里不再重复。

有两个细节和「密钥无效」直接相关。

  • 环境变量层是 dsh 启动时拍下的快照。dsh 启动之后再 export 的变量,它看不到。你换了新 key 却没有重启 dsh,它会继续送旧 key,上游仍会按旧 key 处理请求。
  • 变量引用解析不出任何值时,dsh 报的是 MISSING_CREDENTIAL,不是「API 密钥无效」。所以看到「密钥无效」,通常说明 dsh 确实送出了一把 key,而这次失败被归成了 AUTH。这不一定意味着 HTTP 状态码是 401 或 403:2026-10-27 我们读 deepseek-harness 当前源码时,dsh-llm-deepseek 的 providerError 也会把类型为 authentication_error 或 permission_error 的错误归为 AUTH,而它接受没有 HTTP 状态码的流内错误事件。

查看正在运行的 dsh 进程里这个变量的值。下面的命令只打印前 6 个字符,足够你和测试用的 key 对比:

pgrep -af dsh
sudo cat /proc/<PID>/environ | tr '\0' '\n' | sed -n 's/^\(DEEPSEEK_API_KEY=.\{6\}\).*/\1.../p'

把 <PID> 换成第一条命令列出的进程号,把 DEEPSEEK_API_KEY 换成你 apiKeyEnv 里填的变量名。没有输出,说明这个进程的环境里没有这个变量,key 来自别处。

别处指的是 $DSH_HOME/.credentials.yaml(没有设置 DSH_HOME 时是 ~/.dsh/.credentials.yaml)。在 Models 页面里保存的 key 就存在这个文件里,设置里只保留一个引用。至于几个来源谁先谁后,0.2.1-rc.2 的两份文档写得不一样。CLI 参考说先查继承的环境变量,再查 .credentials.yaml、当前目录的 .env、$DSH_HOME/.env。dsh-credentials-local 的 README 则说先查存储文件,再查启动环境、项目 .env 和 harness 主目录的 .env。我们不替你判断哪份对。换 key 时,把这四个地方的旧 key 都更新或删除,然后重启 dsh。这样就不用依赖查找顺序。

还要注意哪些改动需要重启。providers.md 说,模型设置的改动在下一次请求就生效,不用重启。来自环境变量的 key 不在此列:改了它,必须重启 dsh。

免费模型插件报「密钥无效」:查的是另一套凭据

在 our-free-model、WorkBuddy、Qoder 这类渠道里,dsh 发出去的凭据通常不是你自己申请的 API key。dsh-our-free-model(Ebony-Vinyl 维护,MIT 许可)的 README 说,它让用户不登录、不填 API key 也能用免费模型。2026-10-27 我们查看时,README 的标题是「十个账号渠道,一体接入」,Qoder 和 Qoder 中国版是其中之一,OpenCode 账号渠道在插件里默认停用。账号渠道的凭据写进宿主的凭据存储,聚合渠道的 key 写进插件自己的 settings.json,权限是 0600。

这意味着你手里没有一把自己申请的上游 key 可测,但第一步的 curl 仍然能做。插件提供本地转发,README 写的是「设置 → Our Free Model → 本地转发,启用后复制 base URL 并生成 Key」。它默认只监听 127.0.0.1,列出的端点包括 GET /v1/models 和 POST /v1/chat/completions,面板里还给出可以直接执行的 curl 示例。把面板复制出的 base URL 和生成的 Key 填进第一步的 BASE_URL 和 TEST_KEY,就能在 dsh 之外测同一条渠道。

上游返回 401 或 403 时,被拒绝的可能是插件替你拿来的账号、会话或签名,也可能根本不是凭据问题。插件的 src/upstream.js 写明,它的免密免费通道上有地域闸门(403 RegionError),还有工具指纹闸门,请求不符合要求时返回 403 FreeTierError。dsh 照样把这些都显示成「API 密钥无效」。

issue #344 里的几条社区分析针对旧版插件。维护者在 2026-10-31 回复,华为云 CodeArts 渠道已移除,问题不再适用,并关闭了这个 issue。下面保留旧版案例的排查细节:

  • 一位评论者认为,错误出在 billion-context 的压缩和重签名步骤。
  • jfxb666 说,插件回退去找的 ~/.dsh/jet-hub/state.json 已经不存在,真正的账号池在 ~/.dsh/channel-pack/state.json,其中 provider 为 "codearts" 的条目带着 credentialRef。插件去错了地方,就拿不到账号。
  • OMSociety(2026-10-19)报告,在 DSH NEXT 0.2.0-rc2、ofm 2.5.3、bili 0.1.201 的组合下,bili 要求入站请求带 x-bili-resign 请求头。他还说适配器把任何 401/403 都映射成认证错误。

如果你仍在排查上述旧版组合,第二条可以在本机上检查。下面的命令只看文件在不在、有几个 codearts 条目,不打印内容:

ls -l ~/.dsh/jet-hub/state.json ~/.dsh/channel-pack/state.json
grep -c '"codearts"' ~/.dsh/channel-pack/state.json

设置了 DSH_HOME 的话,把 ~/.dsh 换成它的值。这个文件里有凭据引用,不要整份贴到公开的 issue 里。

另一个插件 dsh-codearts-auth 的 README 也写到同一现象:DSH 客户端对 AUTH 一律替换成「API 密钥无效」并丢掉原文,用户因此反复重新登录,而令牌其实是有效的。它的做法是在自己的适配器里把一类安全策略拦截改归为 PERMISSION_DENIED,让原文能显示出来。这是插件作者的说法,不是 dsh 的文档。

自动修复插件 dsh-api-heal 做了什么

YSwo-fei/dsh-api-heal 是 MIT 许可,Releases 一栏为空,2026-10-21 页面上只有 2 个提交。界面显示 API key invalid 时,它针对实际失败的那个服务商(qoder、workbuddy-ai 或 our-free-model)重新获取凭据,然后重发请求。它还加了一个手动触发的 heal_api 工具和一个只读的状态路由。

凭据从哪里来,要说清楚。对 workbuddy-ai,它重新解密 WorkBuddy 桌面应用保存的凭据。对 our-free-model,它从 .credentials.yaml 里读出签名密钥,自己签发一个会话 cookie。README 说这个 cookie 不落盘、不外发,只在 127.0.0.1 上使用。这是插件自己的说法,没有经过审计。

也就是说,装这个插件,就是让一段第三方代码带着 dsh 的权限去读取、解密其他应用的凭据。另外,如果失败的真实原因是额度用尽或余额不足,换一份凭据也不会让额度回来。这里不推荐它。要评估这类插件,按 dsh 插件的工作方式与审查方法 里的做法来:把每个插件当成拥有 agent 权限的代码,读包里的脚本和入口文件,锁定确切版本,并用单独的 unix 用户而不是 root 运行 harness。

「本轮运行失败」后面还可能跟着哪些报错

以下按 0.2.1-rc.2 整理。AUTH 之外的大多数代码,界面会直接显示原始消息,所以这些报错你通常能看到原文。

  • unknown prompt variable "{{cwd}}" in section "deployment:persona-suffix":更新后所有模型都失败。错误发生在提示词组装阶段,和 key 无关。见下一小节。
  • MISSING_CREDENTIAL:apiKeyEnv 指向的变量解析不出值。providers.md 给的办法是在 Models 页面保存 key,或者提供它引用的环境变量。
  • INVALID_CREDENTIAL:凭据存在但无法使用。pi-ai 的 README 说这个报错会写出是哪条路由、哪个引用。
  • 413 或 failed to buffer the request body:pi-ai 归为 INVALID_REQUEST,表示请求体太大。如果中间有网关在失败时转移到另一个渠道,就可能变成 #7799 那样的 403,又回到「密钥无效」。

更新后报 unknown prompt variable "{{cwd}}" 怎么办

这个问题见 讨论 #9962(Goron01,2026-10-17,Q&A,标为 Unanswered)。报告者在 Windows 上从 0.2.0-rc.2 更新后,所有模型都用不了。截至 2026-10-21,帖子里没有维护者回复,也没有被采纳的答案。

评论者 argszero 的解释是:cwd 这个变量在 0.2.1 的一个 alpha 提交里被移除了,而某个用户配置层还在引用它。0.2.1-rc.2 的 persona 文档只说,完整的 {{…}} 占位符会严格按已注册的提示词变量解析,没有提到 {{cwd}}。

社区的临时办法是找到含 {{cwd}} 的那句话,删掉它,或者把 {{cwd}} 换成「当前工作区」这样的固定文字。先导出合成后的配置:

dsh --profile <name> --dump-config > ~/dsh-dump.yaml
grep -n 'cwd' ~/dsh-dump.yaml

--dump-config 会打印合成后的配置树,然后退出。它会叠加 profile 自己的 cordis.patch.yml、主目录级的 $DSH_HOME/cordis.patch.yml 和 --patch 指定的覆盖文件,还会补建缺失的 profile 文件。导出内容里带有注释,写明每一行来自哪个文件,以及改动过它的每一个覆盖层。打开 ~/dsh-dump.yaml,看 {{cwd}} 那一行附近的注释,就知道要改的是哪个文件。也可以直接在这些源文件里搜:

grep -rn '{{cwd}}' "${DSH_HOME:-$HOME/.dsh}/profiles/<name>" "${DSH_HOME:-$HOME/.dsh}/cordis.patch.yml" 2>/dev/null

<name> 是你的 profile 名。dsh <name> 是 dsh --profile <name> 的简写,启动的就是 $DSH_HOME/profiles/<name>。改之前先备份那个文件。如果你用 --patch 加载过其他文件,也一起搜。

FAQ

dsh 显示「API 密钥无效」,是不是一定要换密钥?

不一定。在 @deepseek-ai/dsh 0.2.1-rc.2 里,适配器把上游任何 401 或 403 先归为 AUTH,额度判断排在后面。界面对 AUTH 只显示固定的「API 密钥无效」,并丢掉原文。社区报告里,免费额度用完、余额不足、中转网关拒绝都出现过这行字。先用 curl 拿同一个 key 和同一个 base URL 发一个最小请求:401 表示缺少有效认证凭据,403 表示请求被拒绝,具体原因都要读响应体。无效 key 也能返回 400,额度耗尽也能返回 429,不能只凭状态码决定换 key。

怎么看到被 dsh 隐藏的上游原始报错?

原文保存在会话日志里。日志是 JSONL 格式,默认用 zstd 压缩,文件名形如 session.v3.jsonl.zstd。用 find "${DSH_HOME:-$HOME/.dsh}" -name 'session*.jsonl*' -mmin -60 找到刚失败的会话,用 zstd -dc 解压,再 grep turn/end。原文在 reason 里的 error 字段下,和 "code": "AUTH" 放在一起。

curl 测试返回 200,dsh 还是报 API 密钥无效,问题在哪?

这说明这把 key 在这个地址上能用,问题在 dsh 这一侧。常见情况是 dsh 进程拿到的是另一把 key。环境变量在 dsh 启动时就固定了,换 key 后没重启,它还在送旧 key。$DSH_HOME/.credentials.yaml 里也可能存着旧 key。另外要检查 base URL 和模型 ID 是否和 curl 里一致,以及请求是否大到触发了网关的请求体上限。

更新后报 unknown prompt variable,是密钥的问题吗?

不是。unknown prompt variable "{{cwd}}" 发生在提示词组装阶段,所以所有模型都会失败。截至 2026-10-21,讨论 #9962 里没有被采纳的修复。社区的临时办法是用 dsh --profile <name> --dump-config 导出合成配置,再在 profile 目录和 cordis.patch.yml 里找到含 {{cwd}} 的那句话,删掉它或换成固定文字。

这篇文章对您有帮助吗?