💡 知识卡片
原始会话经 LLM 提炼后的结构化知识。比原始会话更好读、更好搜。
主题
DSH 模型名自动改写问题
- 配置文件 ~/.dsh/settings.yaml.imported 与 ~/.dsh/profiles/desktop/cordis.patch.yml 的 llm-deepseek.models 中写的是 deepseek-v4-flash，但实际 API 请求发出的是 deepseek-v4-1-flash，说明 DSH 0.1.7-rc.2 的 dsh-llm-deepseek-api-key 内部做了模型名改写
- DSH 自己的 model id 与 API 端 model id 不一定一致，只有实际能调通的才能用；web profile patch 里列了 deepseek-v4-flash / deepseek-v4-pro / deepseek-flash 三个
- settings.yaml 是热加载的，修改模型后不需要重启桌面版
- llm-pi-ai 插件使用 apiKeyEnv 模式而非 model env，想 100% 锁定模型版本需改源码中 llm-deepseek 的 routing 段
- 错误信息中的 distributor group（如 ds4.1flash99缓）是 API provider 分配给账号的分组，group 下无对应 channel 即报 model_not_found
问答
DSH 报 503 model_not_found 排查
问题：DSH 桌面版调用 DeepSeek API 报错：503 model_not_found，No available channel for model deepseek-v4-1-flash under group ds4.1flash99缓 (distributor)。配置文件里写的是 deepseek-v4-flash（无 -1-），但实际请求出去变成了 deepseek-v4-1-flash。
方案：1) 解读错误：503=服务不可用，model_not_found=模型找不到，group ds4.1flash99缓 是 API 后端分发组，该组下没有该模型的 channel；request id 用于找客服。2) 根因：DSH 客户端内部把 deepseek-v4-flash 自动改写成 deepseek-v4-1-flash 发出（DeepSeek 官方改名/改路由到 V4.1 Flash，处于内测阶段），但账号所在 group 未开通新模型。3) 修复优先级：①找 API 提供方（platform.deepseek.com 或三方分销客服）开通 v4.1-flash 权限或切到有 channel 的 group，带上 request id；②在 ~/.dsh/settings.yaml.imported 中把 agent-default-model.model 换成账号下已知可用的模型（如 deepseek-v4-pro），settings.yaml 热加载无需重启；③尝试用环境变量/显式 model id 锁住版本避免自动改名（变量名需查 llm-pi-ai 插件实现）；④必要时降级到 0.1.7-rc.1 或更早版本。4) 附带说明：每次请求 503 会触发客户端重试/等待，是体感变卡的原因之一。