DSH 社区报错案例库
12 条 GitHub 原始记录，合并为 11 个案例。按系统、版本和症状查找，区分用户成功反馈、维护者验证与待解决问题。
本页内容
以下结果来自原帖与回复，本站尚未独立复现。旧版本案例不代表最新版仍受影响；Issue 关闭也不等于修复已发布。先匹配 Desktop / CLI、内核版本、系统与错误全文，再判断是否适用。
子代理报凭据缺失或 401
报告环境：旧版 web / spawn / fork；系统与原帖版本未注明
验证状态：用户反馈重启后恢复
主会话切换模型后正常，子代理却请求旧路由。先对照父子任务使用的 Provider；报告者称重启服务后恢复。第三方插件替代方案与 fork 补丁未确认在当前版本有效。
Web UI 密钥无效，Headless 却正常
报告环境：DSH 0.1.2-rc.1 · macOS · Node 24.19.0
验证状态：有对照，修复待验证
同一 Provider 和凭据下，作者展示 Headless 成功、Web 失败的对照。回复讨论错误分类、Profile 和插件差异，尚无 Web 修复成功反馈。先记录失败入口与脱敏原始响应，不能仅凭界面文案认定 Key 无效。
上下文超限显示为认证失败
报告环境：Kimi coding API · 补丁基线 47f9438；系统未知
验证状态：作者补丁测试，发布未确认
作者报告 HTTP 401 的错误体实际提示上下文超限，并提供错误分类补丁与测试结果。未确认官方发布或用户安装版恢复；排查时应结合原始错误体，不能把所有 401 都归为 Key 错误。
工具调用报 unknown tool 空名称
报告环境：Windows 11 · SSE · 回复涉及 47f943859b
验证状态：多人反馈有效，限旧版补丁
后续空 SSE 分块覆盖工具名称，多名用户报告保护非空名称后工具调用恢复。原帖直接拼接名称的修法被后续回复纠正：可能生成重复或带 null 的名称。当前安装版适用性待核验，不应照搬第一版补丁。
桌面端端口冲突，进入恢复模式
报告环境：Desktop 2.0.5 · Windows x64
验证状态：单个用户反馈有效
EADDRINUSE 出现在 127.0.0.1:43152。作者称把 settings.yaml 中 dsh-desktop.port 设为 0 后恢复启动。报告尚无评论或维护者确认；修改前备份配置，并核对自己使用的是 Desktop，不能套用 CLI 的 --port 命令。
装插件后 dsh-settings 缺失，无法启动
报告环境：Desktop 2.0.4 · 内核 0.1.2-alpha.1 · Windows 11
验证状态：作者报告组合恢复有效
安装 dsh-theme-center 后，作者发现内核包目录为空；移除插件并补回匹配包体后恢复。尚无维护者确认，不能推断单独卸载或任意版本补包都有效。保留日志和 Profile 备份后再按对应版本寻求恢复方案。
迁移后依赖缺失，反复启动失败
报告环境：Desktop 2.0.5 · Windows x64 · Node 24.18.1
验证状态：作者报告组合恢复；根因待确认
启动时缺少 @opentelemetry/semantic-conventions。作者报告重装、重置 Profile 与端口调整的组合恢复，未逐步对照；与端口案例 #892 为同一作者，不算独立交叉验证。重置会影响用户状态，不能直接照搬删除目录的操作。
macOS 冷启动退出，runtime 目录异常
报告环境：Desktop 2.0.0 · macOS 26.5 arm64
验证状态：维护者确认主线修复；发布需核对
报错 pnpm runtime directory contains unexpected entries: dsh。作者临时处理后可启动但会复发；贡献者纠正了最初的目录共用解释。维护者后续明确 v2.0.1 尚未包含修复，不能根据“主线已修”直接建议升级该版本。
浏览器直开 Desktop 页面，插件加载失败
报告环境：desktop plugin 2.0.0 · Windows 报告
验证状态：已关闭，修复证据不足
普通浏览器访问时报 invalid or missing dsh-desktop-mode null，作者报告桌面窗口正常。Issue 已关闭但没有修复评论或成功回测；手动补参数只是可能方向，不能作为已验证方案。
双安装共用配置，工具 prepare 崩溃
报告环境：Desktop 2.0.0 + CLI 0.1.0-rc.6 · Windows
验证状态：维护者复现并验证；作者回测缺失
Cannot read properties of undefined (reading 'prepare') 出现在共享 DSH_HOME 的双安装场景，报告中的故障进程是 CLI。维护者验证了 fallback 链接修复，要求两套 runtime 都到 rc.7 或以上；未明确对应 Desktop 安装包版本，不适用于任意单安装崩溃。
新会话报 preset code not found
报告环境：Desktop 2.0.5 · Windows 10 x64；内核未知
验证状态：仅有故障报告
新会话引用 code 预设，但可用列表是 standard、ptc、minimal、cordis。原帖没有成功方案，也未完成新 Profile 对照。先收集版本和预设来源，不把删除会话或重建 Profile 写成已验证修复。