报错速查
按症状找 dsh 的常见问题 · 共 320 条 · 76 条有社区方案
安装与升级66 条 · 18 条有方案
升级到 0.2.2-RC2 后 workspaceController 服务不可用,导致工作区与对话记录丢失、无法新建
回退到 0.2.2-RC1,RC1 下工作正常
安装器继承安装目录为工作目录,给安装目录改名等于改自身当前目录,导致失败
完全退出 DSH,PowerShell 执行 Start-Process installer.exe -ArgumentList '--updated','--force-run' -WorkingDirectory $env:TEMP,完成后再启动确认版本
stop(requireGraceful) 需 graceful、exitCode===0、shutdownCompleted 同时满足;Host 已确认 shutdown-com…
临时方案:手动运行已下载的分阶段安装包(staged installer)完成升级
将 Downloads 等宽泛目录设为 workspace-write 工作区,Windows ACL 沙箱向其写入可继承的 Low 完整性标签并持久残留,子进程无法写 %TEMP…
改用专用子目录作为工作区;或将可执行文件复制到其他位置运行,避免从被标记目录启动安装程序
升级时宿主未完成 graceful teardown,更新 pending 不落地;旧版启动阶段崩溃
最终用旧版安装包覆盖安装恢复;更新未落地时 pending 目录保留、exe 未被替换
0.1.7 三天内连发 alpha/rc,升级未备份、未固定版本,导致设置丢失、会话历史缺失
社区整理恢复清单:先备份数据、固定版本、必要时回滚;所有操作先在校验副本上执行,链接处均有社区验证
同一进程加载两份 @deepseek-ai/dsh-tools:CLI 侧经 tsx + tsconfig paths 指向 src,profile 插件侧经原生解析指向 lib,…
官方仓库暂不接受外部 PR,社区在 fork 分支给出 4 行最小修复(profile 解析锚点规范化)并附回归测试与端到端验证,供维护者取用。
apps/web 是最终执行构建的包,未在自身 dependencies 声明 react,仅靠兄弟包 devDependencies 传递提供
在 apps/web/package.json 的 dependencies(非 devDependencies)中加入 "react": "^18.3.1" 和 "react-dom": "^18.3.1"
node-pty 生命周期脚本由 powershell.exe -c 执行,Windows PowerShell 5.1 不支持 || 运算符
把 npm 的 script-shell 改为 PowerShell 7 或 cmd.exe,安装即可成功完成
新版本更新引入回归,旧会话不兼容,且降级已无法恢复
降级已无效,社区建议坐等官方修复更新
CLI 未校验插件声明的 @deepseek-ai/* peer 范围与 host 层版本是否匹配,也不告警
可用 DSH_HOME=/tmp/dsh-demo dsh plugin --profile web add dsh-win32 隔离复现;正文未给出修复方案
未明确(为工具发布帖,针对 dsh 起不来、升级前后异常的自查需求)
@moonquake2004/dsh-doctor 提供 env/profile 等 40 项检查(node/pnpm、node-pty、storages、PATH、bundle、patch、deps 等),dsh-security 31 项安全检查,均为普通…
并行 Loader 激活下,modules 未声明依赖 webServer,Node 半部先激活,访问 webServer 时触发 Cordis 服务竞态。
让现有 modules Loader 行在激活时显式依赖 webServer(正文提出的修复方向)。
发布包 manifest 把 zustand、immer 只列为 devDependencies,但 lib/index.js 仍 import 它们
回退到 0.1.5-alpha.1(该版本纯净安装可正常 import);或自行补装 zustand、immer 运行时依赖
指定路径已存在但不是 symlink 或 dsh 管理的 module proxy,导致模块回退安装校验失败。
按错误提示移除该路径,让 dsh 重新管理安装回退。
插件直接覆盖自身文件后旧代码无法完整卸载,跨环境重启涉及权限与可靠性问题。
社区已有 dsh-check-update 等尝试,但完整自动更新链路仍未解决,主要依赖手动重启。
profile 目录设置 autoInstallPeers:false,大部分 missing peer 警告是设计使然,仅少数项需处理。
大部分 peer 警告可安全忽略;仅个别项需要修复,正文未给出具体修复方法。
旧版Host退出慢,Shell等待10秒graceful超时后发送SIGTERM,判定非干净退出而拒绝安装
安装器重命名安装目录时文件被占用,MoveFileExW 反复返回共享冲突,安装失败且应用已退出
新版插件新增首个 postinstall,安装被 pnpm 11 构建脚本策略拦下;回滚旧版后,profile 的 pnpm-workspace.yaml 里留下不是布尔值的 al…
未明确,更新后自动退出但版本未变,管理员权限运行同样失败
安装器日志显示 MoveFileExW error 32,改名前安装目录仍被占用(路径含中文、非默认目录)
未明确
更新器拉起安装器时未设置 cwd,安装器继承安装目录,导致备份改名时自占用返回 ERROR_SHARING_VIOLATION(32)
updateBundle HMR 重新激活 dsh-web-app 的 directory-picker-auto,重复注册 directoryPicker 服务
升级后旧 Cookie 未自动失效,鉴权失败掩盖了插件不兼容。
自动更新重建C:\DSH目录,工作区被删,旧会话因路径不存在无法打开
升级后出现,清理客户端并重装仍无法创建会话,具体原因未明确
官网下载仅提供 M 芯片版本,客户端内原有更新按钮消失,Intel 版停在 0.2.1-rc.1
更新包已下载解压,但在替换安装目录阶段中止;用户为自定义非系统盘安装路径
安装器 backup 阶段重命名旧安装目录返回 Windows error 5(拒绝访问);已排除进程残留、ACL、杀软,具体原因未明确
HMR 可用时 install_bundle 拒绝安装已存在的包,报 already-installed,且回滚时构建验证也失败。
正文未说明,疑似安装插件后引发,重启即报错
未明确,仅截图无报错文本
官方桌面端目前未提供 Linux(Ubuntu)安装包,Linux 用户无法直接安装使用
安装程序要求目标文件夹为空,未说明具体原因
0.1.5-rc.3 发布集中 dsh-web-app 依赖的 sidebar-documentpreview@^0.1.5-rc.3 未发布到 npm
正文仅显示npm ERESOLVE peer dependency警告,未给出打不开具体原因
正文仅截图,未说明具体报错原因
未明确,用户认为官方缺少人工代码审核与线下测试
未明确,安装构建时执行 git rev-parse HEAD 失败并抛 Command failed
git clone 后 pnpm build 源码启动,Web UI 默认模型下调用 Bash 等工具即失败;未明确
升级后旧会话数据校验失败,事件缺少 tool source 导致会话损坏
未明确(正文仅附图,未说明具体报错内容)
用户怀疑 dsh 修改了插件加载方式导致各类插件报错,正文未给出确认结论
未明确;更新到最新版并 clean build 后出现,仅 DeepSeek 模型受影响
新版升级旧会话格式时校验过严,遇到老版本遗留字段或旧格式即拒绝加载整份会话
更新到最新版本后无法新建对话;正文未说明具体原因
更新后无启动信息,卸载重装也无效;具体原因未明确
fs-ext@2.1.1无预编译二进制,install脚本无条件执行node-gyp configure build
sandbox 权限比较或工具权限继承逻辑错误,未正确判断权限包含关系,将高权限下的工具声明当成权限升级请求。
升级0.1.2-rc.1后必现,与消息内容无关,可能与会话持久化ENOENT有关;0.1.1-rc.2正常。
v0迁移策略拒绝包含unexpected member origin的旧会话,且源文件保持byte不变,导致永久无法加载。
未明确;npm 在 idealTree 阶段反复输出,疑似依赖解析或网络/缓存问题。
未明确;可能由新版本引入 token 访问控制和兼容性变化导致。
npm 依赖 @deepseek-ai/dsh-agent-loop@^0.1.0-rc.8 在 registry 中无匹配版本。
用户担心更新会覆盖旧版本及其中重要资料。
未明确
npm Arborist在placeDep阶段进入死循环,CPU 100%且内存持续增长,网络正常,清缓存换镜像无效。
未明确,可能与网络速度或升级包体积有关。
npm 安装时 node-pty 执行 prebuild.js 或 node-gyp rebuild 失败,导致安装中止;具体环境原因未明确。
dsh 包族多数 latest 停留在 0.0.1-rc.1,其 peerDependencies 引用已不存在的包名,导致解析失败。
node.js安装于C:\Program Files\nodejs,但npx启动时提示找不到文件,可能因路径包含空格或npx缓存/配置异常,正文未明确。
profile的node_modules中存在第二份核心包,安装时遇到missing-peer错误后依赖树异常,工具调用读取prepare属性失败
未明确;内网隔离环境、安全软件或更新后版本兼容性均可能相关
启动与崩溃75 条 · 17 条有方案
崩溃恢复重写cordis.patch.yml时丢弃手写insert条目,MCP配置丢失,工具报unknown tool且无提示
需手工修改配置文件恢复,暂无自动修复或提示方案
第三方插件在 body 上三个 MutationObserver 回调内写 DOM,形成微任务死循环
给三处 observe() 加守卫后 CPU 从 ~119% 降至 ~2%;禁用该插件;官方 rc.3 无需升级
多次重启后旧认证 cookie 不断累积,Cookie 请求头超过 Node.js 默认 16KB 上限,服务端返回 431,被误报为认证失败
清除遗留的 stale 认证 cookie 后应用可正常启动,已验证恢复
启用实验性开发者工具后,HostInspectorSource 异常关闭,树观察者未停,setState 抛未捕获异常
正常 disposal 为逆序不会触发;正文未给出临时方案,需避免 source 异常关闭
同一pwsh.exe在cmd正常,经Windows沙箱运行器拉起时DLL初始化失败,无stdout/stderr输出;临时目录缺失时另有明确报错
社区建议直接把该现象反馈官方,维护者可按windows-acl-run的受限令牌配置排查,无需再做实验
插件处实验阶段,架构与兼容性验证不完善,Windows 桌面端冷启动验收未完成
弹窗时点击 Disable third-party plugins, back up profile patch, and restart,禁用第三方插件、备份 profile patch 并重启;事前备份配置、会话和知识库,使用独立测试 profile
Windows 桌面版以管理员身份启动时受限 shell 初始化失败(STATUS_DLL_INIT_FAILED),与管理员宿主关联,完整触发条件未明确
改用普通权限重启 DSH 后 shell 恢复正常,工作区写入成功、越界写入被拒;管理员启动则故障重现
GUI 子系统的 Electron 作为 ACL 沙箱运行宿主与 ConPTY 不兼容,导致 shell 进程启动即退出
设置 DSH_PERMISSION_MODE=danger-full-access(会话级或写入用户环境变量后新建会话)可完全恢复正常
启动即报错,已排除中文用户名因素;workbuddy 分析(截图中)原因未明确
社区/workbuddy 编写了一个启动脚本,可正常启动 dsh,用户暂时靠脚本启动并等待官方更新
runNativeCommand 恒以 windowsHide:true(SW_HIDE)启动子进程,Explorer 继承隐藏状态;且后台进程被 Windows 前台锁拒绝激活
发文者提出修复思路:目录改用 explorer 方式激活路径(原文在此截断),社区暂未给出完整补丁;注意 POST /open-in-app/open 仍返回 200 ok:true,无报错
浏览器工具Playwright MCP启动失败,failOnStartupError:true连坐整个会话创建并残留孤儿浏览器进程
将插件配置failOnStartupError由true改为false,新对话创建恢复正常,同时清理孤儿浏览器进程
鼠标按下使卡片失焦(relatedTarget 为 null),onBlur 在 click 前关闭卡片
用键盘选择(↓ 进入列表后 Enter)可正常切换;Chrome/Chromium 不受影响
备份/清理/恢复后出现两个独立 bug:session 日志首帧非 header 致 web 崩溃;zip 恢复丢失链接,插件安装静默丢弃 bundles。
社区给出了根因与修复说明但正文未完整展示;建议先清理损坏首帧、保留 junction,再升级到含修复的版本。
WSL2环境下通过npx启动dsh时,Node.js内存堆溢出(默认约2GB),导致OOM崩溃。
社区未在正文中给出明确解决方案,仅报告了完整报错输出。
正文仅提供外部文档链接,具体原因未在正文中说明,但标题指向插件引起启动失败。
所附 dsh-issue-plugin-not-built.md 中提供了解决方案。
dsh-auth cookies 按随机端口逐次累积,超出 Node 16 KiB 请求头上限触发 431
每次启动累积过期 dsh-auth cookies,请求头过大触发 HTTP 431,桌面端 Web 认证失败无法启动。
sandbox.confine() 用 WRITE_RESTRICTED 限制令牌包裹 shell,PowerShell/node 在该令牌下 DLL 初始化失败(0xC00001…
dsh web 空闲无操作时自动退出,端口3080停止监听,未明确根因。
--port 0 每次随机端口,Chromium 按 host 存 cookie,dsh-auth-* cookie 累积不清理,约 71 次后请求头超限
会话历史含 developer 消息(工具注册表抖动产物),provider 改名+配置重写+重启+插件升级后 preStep 必崩
首次创建 shell 失败(环境问题)后被 owner-scoped 持久 shell 缓存,环境修复也不自愈
修复先截断并 fsync 日志,再写入恢复记录;两步之间崩溃会丢失记录
每次启动写入随机名鉴权cookie,去重键含name永不重复只增不减,累积约73条超16KB,服务端返回431
每次启动新增按主机+端口命名的认证cookie,30天不清理,约70次启动后请求头超16KiB,本地服务返回431
正文未明确说明根因,仅描述关闭重开桌面版后启动即失败、点击重启重复弹窗
未明确
某些写入路径给 profiles/<name>/package.json 加了 UTF-8 BOM,readProfileManifest 直接 JSON.parse 不剥离 BO…
dsh-auth-* cookie 无限累积,Cookie 头超过16KB,约70次启动后认证失败
cordis/tree 源状态超出 source-frame 字节上限,setState 抛未捕获异常
Electron session 中 dsh-auth-* 会话 cookie 无界累积,Cookie 头超过 Host 16KB 限制,每次启动都收到 HTTP 431
桌面端用 Electron GUI 进程(无控制台)创建 console 子系统子进程,加载器初始化失败,退出码 0xC0000142
crypto_context.cc:884 证书断言失败、raw_hash_map::at NOTREACHED、renderer 静默退出三类交替;文件校验正常
认证Cookie按含随机端口的authority命名,jar仅按host保存,每次启动新增且不删除,请求头超限
应用启动失败触发filesystem恢复,将dsh.profile.bundles重置为基础包并重写配置,丢弃补丁条目。
host 进程因未捕获的 ECONNRESET 异常退出,Electron 壳仍存活但不重启服务,UI 无提示。
桌面壳以 ELECTRON_RUN_AS_NODE=1 子进程运行宿主,launchDetachedApp 将该变量泄露给被启动的 Electron 应用。
profile-boot 将 SIGTERM 处理成干净退出且无持久记录;插件警告仅存64KB内存环
工作区一旦用低权限模式启动过会话便被贴“低权限”封条,不随会话结束或切到完全权限解除并继承给所有文件
沙箱受限令牌下 .NET 程序初始化失败(STATUS_DLL_INIT_FAILED),pwsh 无输出直接退出
workspace-write 策略下 shell 命令在进程初始化阶段即失败,退出码 0xC0000142
受限令牌默认 DACL 只授予 restricting 列表中的写能力 SID,子进程自身访问检查失败,DLL 初始化中止
ripgrep 遇 ACL 拒绝访问目录时以 exit 2 退出,glob 工具把整次搜索判为失败,已扫到的候选结果一并丢弃
Desktop 宿主注入的 ELECTRON_RUN_AS_NODE=1 被继承,导致 VS Code 等 Electron 应用启动即失败
continuable subagent 结算时读取 inbox 状态,其 inbox projection registration 已失效,ReactLoopInbox.cur…
会话日志格式 v3→v4 迁移过程触发 SIGABRT(正文未明确具体代码原因)
Intel Arc 显卡+多虚拟显示器环境下 GPU 进程初始化失败,双击后约1秒退出;应用不写日志
桌面宿主将 ELECTRON_RUN_AS_NODE 传给 VS Code,使其以 Node 模式启动,导致启动失败。
第三方客户端插件 dsh-ears@0.3.2 的 apply() 被 reject,客户端 Loader 未透出错误信息,只给笼统提示
#7228 崩溃窗口在 tool/call 与 tool/result 之间中断,会话留下未完成的工具调用,v4 迁移拒绝该产物
PR #4471 将源码启动默认 resolutionMode 从 link 改为 runtime 引入该错误
全新默认 profile、无第三方插件,任何工具调用即崩溃;正文未说明根因
源码检出的包解析同时指向 src/ 与 lib/,加载两份包引发冲突
系统设置停止应用后,workspace.json 的 updatedAt 触发 ZodError,插件树加载失败致 Node 引擎无法启动
托管子进程以 windowsHide:true 启动时失败并弹出模态错误框;正文被截断,根因未明确
v0→v3迁移后部分事件缺少content字段,内置投影读取message.content未做防护
第三方插件在 apply() 中失败,cordis 中止整个 loader 链,dsh app-boot 抛错、进程退出
与 Node.js v24.1.0 存在兼容性问题(原文 Root Cause 部分被截断)
Safari 17.5 环境下加载插件失败,报 Can't find variable: Iterator,正文未说明具体原因
迁移只接受 subagent/descriptor version 3,而 2026-08-24 前的版本写入 version 2
正文未明确;表现为 settings.section 插槽渲染时 removeChild 目标不是子节点,疑似前端 DOM 更新不同步。
强制中断dsh进程导致session日志seq gap和文件损坏,启动时崩溃。
连续三轮在 bash 工具调用后崩溃,agent loop 读取 undefined 的 prepare 属性;底层机制未明确。
cordis.patch.yml 中引用了未安装的包,引导时模块解析失败导致进程退出。
MSYS2 CLANG64环境下npx/bunx调用dsh web时无输出直接退出,具体原因未明确
已定位到 FrameQueue.buffer 等4处无界累积点,导致 V8 堆持续增长直至 OOM。
运行中会话的持久化日志/目录被外部删除,追加写入时文件不存在,触发 ENOENT 导致 fatal。
读取 profile manifest JSON 时遇到 BOM(U+FEFF),JSON.parse 无法解析该内容。
OutputCollector.spillAll 尝试打开已被删除的 spill 日志文件父目录,未处理 ENOENT,导致进程崩溃。
会话日志损坏,出现seq gap,导致无法加载历史。
自定义插件 provide 了核心已占用的服务名 chatFileMentions。
工具执行崩溃后回合被标记为已结束,留下悬空tool_calls,导致会话后续请求永久返回400。
以GitHub dependency安装插件时未执行build,exports指向dist/但dist不存在,导致ERR_MODULE_NOT_FOUND。
网络与代理20 条 · 4 条有方案
超时策略等工具 promise 结束才替换结果;底层忽略 abort 时 promise 永久 pending,step 不结束
社区确认是 DSH 侧代码问题;原文未给出修复或临时方案,只能重启进程恢复
in-process 子代理在模型调用层失败时,父工具只透传通用错误,真实原因仅存于子会话日志
查看子会话日志 ~/.dsh/sessions/<workdir>/<childSessionId>/session.jsonl.zstd 中 turn/end 的 reason.error.message
卡巴斯基 HTTPS 扫描替换证书,Node.js 校验失败报自签名证书链错误
临时方案:关闭卡巴斯基后 DSH 恢复正常;用户建议官方记录为已知问题并给出指引
crypto.randomUUID 仅 HTTPS/localhost 可用,非回环 HTTP 下 RPC 失败,导致连接丢失。
临时方案:通过 HTTPS 或 127.0.0.1 访问;避免使用非回环 HTTP。
点击 New Session 实际恢复的是旧的空白草稿,而非新建会话,导致仅对后建会话生效的子代理模型设置无法生效
run_code 截断字符串产生孤立 UTF-16 代理项,服务端请求校验失败
会话文本含孤立代理字符,请求体被 API 判无效,错误详情被吞
Agent Teams 会话中 send_message 只接受队友名称;传 subagent 返回的 agent_id 会报 active teammate not found,…
web_fetch未走代理,先做本地DNS解析,Clash fake-ip把域名解析到198.18.x.x非公网地址,被判定为blocked
每次搜索都先把整份持久化语料对账进 :memory: 的 FTS5 索引,且只在最后单事务提交,超过工具 30s 预算
read 工具按 UTF-16 码元下标截断超长行,切在代理对中间产生孤立高代理项,JSON.stringify 写出非法 JSON
dsh-mcp-client 写死 versionNegotiation: auto,对现代探测回 501 的 streamable-http 服务端握手失败
正文未明确,用户仅询问是 DSH 还是接入模型导致
dsh-http-proxy 换用 undici v8 dispatcher,与宿主内部 undici v6 fetch 不兼容,HTTP 200 响应体未解压
session/list 与 session/resume 将 parentSession 与 origin=subagent 混为一谈,误判为不可恢复
/compact后同时存在.jsonl和.jsonl.zstd文件,zstd后端无法处理.jsonl格式。
MCP session 过期后 DSH 未重新初始化连接或刷新工具列表,仍持续调用过期会话,反复返回 -32001。
Ollama 本地模型长提示词超过默认 300000ms 超时,用户尝试 settings.yaml 配置未生效。
框架级中止,发生在摘要 LLM 流期间;非网络/代理/用户取消。具体内部原因未明确。
dsh-client-ui-conversation 中 steeringAvailable 被硬编码为 subagent === null,导致子代理会话只能排队输入,不能中途打…
登录与认证9 条 · 4 条有方案
内置 token 计量用固定约 4 字符/token 启发式,CJK 会话与大型工具 schema 系统性低估,本地服务报 exceed_context_size_error
社区插件 dsh-plugin-local-prompt-bridge 已可用;核心协议方案(可选 countPromptTokens 与溢出处理)因项目暂不接受外部 PR 只能先以 Discussion 提出
Windows 沙箱受限令牌(CreateRestrictedToken,DISABLE_MAX_PRIVILEGE|LUA_TOKEN|WRITE_RESTRICTED)导致 s…
改用 full access 模式可临时规避;社区暂未给出官方修复方案。
远程开发环境需求,host 0.0.0.0启动默认被拦截(正文未详细说明原因)。
安装GDWhisper/dsh-web-startup-auth模块,装后host 0.0.0.0启动不被拦截且具备安全能力。
DSH对opencode go套餐可用模型列表未同步,仍用旧的可用模型列表导致请求被拒绝
添加模型时选择自定义,填入API Key,API地址填写https://opencode.ai/zen/go/v1,再获取最新可用模型列表自行裁剪
WAF 前置的 MCP 服务器拒绝 streamable-http 版本协商探测请求
推理通道在 reasoning→action 边界进入重复吸引子,反复输出同一句待执行动作,直到耗尽输出预算
未明确;用户怀疑上下文累积、重复工具调用或子智能体循环导致用量异常。
每次请求输出预留 maxTokens=256000,有效输入上限仅 792576,按 window 计算的 0.8 阈值永远无法触发压缩
正文未明确原因,仅描述异常扣费现象。
插件相关21 条 · 4 条有方案
插件对 fetch 做了 monkey-patch 引发递归,并非 Electron 外壳问题(原报告结论已更正)
定位并移除/修正做 fetch monkey-patch 的插件;同 profile 下 dsh headless 与 Web UI 正常可作对照排查
插件为配置档全局生效、预设仅单会话生效,中间缺少「工作区/任务→预设」绑定层,用户误以为要敲命令激活
建议支持把预设绑定到工作区(按目录),新建会话默认使用;或按工作区记住上次选择并沿用
DSH 未提供环境隔离命令,插件作者自写脚本;PowerShell 中 $HOME 为只读自动变量,赋值静默失败仍指向真实用户目录,随后被递归强删
提案建议 P1 新增 dsh --profile <name> --ephemeral,由 DSH 在系统 temp 内自行完成隔离环境的创建与销毁;作者已用事故前约 50 分钟备份逐项恢复
llm-pi-ai插件设置命名空间未注册到settings.describe,导致添加按钮禁用、卡片渲染不出
更新后在设置→模型查看是否出现llm-pi-ai命名空间及第三方卡片;或POST /api/settings/describe确认返回里是否有"ns":"llm-pi-ai"
插件 bundle 解析/加载失败,实时解析器报找不到包,虽从两个预期锚点均可解析
插件宿主为Node语义,无法require electron;window.open被setWindowOpenHandler拒绝;画中画请求报InvalidStateError。
插件安装成功但每次启动报 failed to import,状态为未运行;具体原因正文未明确
Windows 下 link: 安装的插件是 junction,卸载时被当普通目录递归进入并删除目标源码
dsh-hmr 下写 cordis.patch.yml 触发重载,session-controller 重建时重复注册 file-upload 的 Agent resolver
profile 插件入口导入了非 profile 层依赖的裸包,路由器抛内部 TypeError 而非未解析包错误,加载器只显示 failed to import
dsh-app:// 转发层无法流式返回响应,内置 host 路由 /plugins/events 的 SSE 恒失败;非流式插件 bundle 走同一路径却正常
0.1.7-rc.1 不再修复 $DSH_HOME/profiles/node_modules,profile 内安装的插件缺少 @deepseek-ai/cordis
插件以裸字符串调用 agent.followup(),核心按对象读取 kind 属性得到 undefined 而抛错
HostConnectionService.register() 在提供方 client-connection 影子上下文挂载路由,其 fiber 不持有 webServer,co…
HostConnectionService.register() 通过 owner.webServer 解析路由,但连接插件静态 inject 未声明 webServer
bundled-runtime payload smoke 断言仍引用已被移除的 fs-ext,导致校验中止、无法产出 resources/dsh
加载文档预览插件时导入 loader entry 失败并报 Iterator is not defined,原因未明确
迁移工具无法安全转换未分类的 message source,插件自定义 kind 不被识别
Session.run() 要求首个通知必须为 agent/inbox/spliced;bundled runtime 检测到磁盘会话与 live session 不一致时拒绝续接…
dshmarketplace-plugin 0.1.5/0.1.6 注册的 tools/pre-execute 监听器短路瀑布,导致工具调用读取 undefined 的 kind。
第三方插件捆绑了重复的 @deepseek-ai/dsh-tools,导致 ctx.tools[TOOL_RUNTIME_SCHEDULER] 未定义。
权限与沙箱23 条 · 11 条有方案
token 默认 DACL 命名了非限制性 capability SID,导致 STATUS_DLL_INIT_FAILED
定位到 token 默认 DACL 中该 SID 的 ACE 为根因,正文未给出完整修复步骤
沙箱环境无法正常启动PowerShell,导致仅需读取XLSX/TSV的只读任务也请求danger-full-access权限
建议官方增加“必要时询问”权限模式:低风险自动执行、敏感操作审批,支持仅本次/任务内允许与拒绝选项
回合运行中修改模型、思维强度或权限,导致会话服务在 inactive context 中取不到 sessionProjections
重启 host 可恢复;有时切换一次权限预设也能把会话救回来
bwrap --ro-bind 使沙箱内根盘显示为 ro,与内核因 ext4 错误 remount-ro 的现象完全一致。
在工作区内写测试文件判断磁盘是否可写;再查 dmesg 是否有 EXT4-fs error / Remounting 记录辅助判别。
GUI exe作runner无可继承控制台,且受限令牌默认DACL不含通用受托人
临时改用 read-only 或 danger-full-access 可绕过;正文附最小复现与修复建议
受限沙箱档(read-only / workspace-write)走受限令牌创建进程路径(CreateProcessAsUserW + 空环境块),导致 DLL 初始化失败;手动…
切换到 danger-full-access 档可正常执行 pwsh,受限沙箱档目前必现失败
模型执行删除测试文件时路径拼写错误,包含上级目录且未创建测试文件夹,直接fs删除整个项目,无备份
用户已通过插件形式实现回收站式删除:删除先进临时文件夹,可恢复,不再用fs命令行直接删除
Windows 上模型偏爱用命令行列目录找文件,被沙箱正常拒绝时,常驻 ACL 诊断技能让它误判为环境故障需修复
正文建议:改用 DSH 自带 glob/read/grep 文件工具,或把预期内的拒绝直接向用户解释,而不是提权或写探针脚本
受限令牌 Default DACL 授权对象是 capability SID(S-1-4-…)而非 Everyone,导致子进程 DLL 初始化失败
在 AclSandbox.init() 的 setTokenDefaultDaclGrant 中把该参数换成 worldSid 或补一条 Everyone,workspace-write 实测恢复正常
工作区在数据盘等非用户目录,默认继承 ACL 缺 WRITE_OWNER,grantWrite 打开根目录被拒
正文仅给出根因分析,未提供修复方案;可靠规避方式是把工作区放到用户目录下
MSIX App Execution Alias 的 stat() 抛 EACCES,探测失败被 shell 菜单过滤
会话中插件重载触发 permission-presets 与 experimental-auto-review 预设依赖死锁,权限投影未注册
受限令牌 + Low integrity 下 Schannel/SSPI 在 AcquireCredentialsHandle 阶段拿不到凭据
非提升标准用户令牌缺 WRITE_OWNER/WRITE_DAC,SetNamedSecurityInfoW 调用返回 Win32 5
未明确;沙箱 composition 下两套工具族对“重复当前模式 + 空 justification”的处理不一致
创建受限子进程的宿主自身需有控制台,打包桌面版中介是 GUI 子系统 PE 二进制(ELECTRON_RUN_AS_NODE=1),无控制台可继承
DSH 0.2.0-rc.2 Windows ACL 沙箱存在两个缺陷;read-only 与 danger-full-access 正常,仅 workspace-write 下所…
受保护 DACL 子目录永不获授权、desktop 根授权缓存不复核不自愈、标准用户+非系统盘 grantWrite 失败(Win32 5)
工作区 Modify 来自继承的 Authenticated Users ACE,不含 WRITE_OWNER,而 0.1.7 的 grantWrite 需要该权限
会话已是 danger-full-access 且审批策略为 never 时,请求同一沙箱模式触发校验失败关闭
未明确,疑似权限比较逻辑判定严格宽于关系时出错
writeFileAtomic在Windows上无重试机制,杀软或索引器短暂占用.tmp文件句柄导致rename失败
性能与内存16 条 · 4 条有方案
compaction 摘要请求跟随会话同一个小窗口路由,摘要自身超窗报 CONTEXT_WINDOW_EXCEEDED,上下文无法缩小形成死循环
为 compaction 单独配置大窗口摘要模型;或把会话路由窗口设为该模型声明的 Max 值,问题即消失
中断修复路径按已存储日志长度写入合成关闭事件,却未推进内存 seq 计数器,工具真正完成时复用了同一批 seq。
删除这 4 行合成占位事件(零真实内容丢失)后 seq 恢复严格连续,会话经真实加载路径可正常打开并继续使用。
上下层Prompt提示符不一致:底层预设'dsh> ',上层注入PS1不同,导致sanitizer无法匹配提示符。
社区附Fork分支修复,正文未给出具体修改细节。
27分钟内启动546个dsh-subprocess(多为git),导致内存耗尽、VM冻结。
openai-responses 路径未按协议图片能力降级图片块,也无 400 会话自愈
上游 usage 统计与界面分项严重不符(显示300K实际约75K),疑与第三方插件 billion-context 及 Kiro Max 渠道配合异常,未明确
压缩阈值随目标模型窗口重算,但摘要请求仍发往该小窗口模型,压缩请求自己超限
未明确(本地llama.cpp+96k窗口约37.9k tokens即触发压缩,日志提示summary is not smaller than the shadowed conte…
readEvent 走 load→snapshotLive,用 structuredClone 深拷贝整个会话事件数组,复杂度退化
会话日志中存在 data.turn 为 null 的 step 块,客户端渲染状态机死循环、CPU 升高,数据层正常
压缩请求携带模型不支持的 thinking 级别 MINIMAL(profile 仅支持 high),压缩失败后继续用未压缩历史
macOS 不支持 PR_SET_PDEATHSIG,host 退出后 bootstrap.py 被 launchd 接管,IPC fd 3 关闭后忙等占满一核
收到 CONTEXT_WINDOW_EXCEEDED 后未记录任何压缩尝试,重试仍同类报错,直至 turn/end 报错终止
@deepseek-ai/dsh-tool-fs 中 apply() 在 attachments-gated 子上下文注册 read_image,作用域缺少 fs 注入。
两个 harness 进程共享 sessions 根目录,追加日志只校验内存游标,进程间交错写导致 JSONL 损坏。
界面与交互14 条 · 2 条有方案
turn 渲染路径读取 end.data.reason.kind 未做空值保护,reason 为 null 抛错后被 slot 错误边界渲染成空 div
给相关属性读取加可选链 ?.,本地打补丁后恢复正常;与用户数据、第三方插件、纯净内核均无关
本地残留旧默认预设名 code,以及浏览器 localStorage 中残留的旧版 store 值导致侧边栏槽位崩溃
只改用户本地数据:清除/修正残留的默认预设名 code,清理浏览器 localStorage 中的旧版 store 值,无需改代码
打开右侧栏使卡片可用宽度变化,选项行命中区域与绘制区域错位,上半部点到其他元素
未明确
welcome-store 已区分确认未持久化或 scope 不可用,但渲染层丢弃原因,引导弹窗被强制阻塞
UI字体默认过小,设置仅能调整聊天字体,无法调整UI
runNativeCommand强制windowsHide:true,隐藏了Explorer委托窗口导致操作静默失败
未明确;计划模式下反复输入再删除后输入态异常,Win11 + 0.1.6-alpha2 稳定复现
claimed 输入写入 durable user/message 的 append 排在 step() 中 prepareRequest() 之后,抛错时消息既不在 inbox …
两处原因:file:// URL 被百分号编码,以及 windowsHide:true 隐藏了 explorer 自身窗口;非ASCII(中文)路径触发
输入法组合输入(拼音未上屏)时输入框错误显示音译汉字,正文未说明原因
DeepSeek官方模型不支持图片,因此添加模型界面未考虑该配置选项
模型发现和采纳流程未保留 inputModalities,只写入 id/name/contextWindow/maxTokens,导致回退为 text。
切换模型时 selectModel 会检查会话中是否已有图片以及目标模型是否支持图片输入;会话含图且目标模型不支持时直接拒绝。
其他76 条 · 12 条有方案
controller 把「会话不存在」和「header 无 cwd」两种观察结果都映射为 session/not-found,详情相同
提议在 session/not-found 的 details 中加入仅描述观察分支的 reason,属讨论建议,未落地
workspace-write 文件策略下 PowerShell 子进程初始化失败(STATUS_DLL_INIT_FAILED)
把同一会话切到 danger-full-access 命令立即可用,切回即 100% 复现
官方桌面端 0.2.0-rc.2 环境下 AI 执行的命令不执行、无输出并返回 0xC0000142;命令本身在 cmd 中可正常运行
把同一入口改为从命令行/终端启动,AI 执行命令恢复正常,问题不再复现
importLegacyDocument 先重命名 settings.yaml 为 .imported 再写入,context 未激活时 write 抛错,全部段失败且不重试
作者提供根因与修复建议,正文未列出具体操作步骤
dsh-tools 的 Symbol 身份不一致,工具在派发前的 prepare 阶段拿到 undefined
cli profile 不复现,可临时改用 cli profile 规避,等待官方修复
恢复路径从回卷的 seq(91853) 重新追加事件,未截断已提交的合成关闭行,导致同一 seq 重复出现。
正文未给出修复方案,仅指出与《V2→V3 迁移拒绝含中断轮次重启的 v2 会话》同族,属 zstd JSONL 存储侧变体。
bin 入口用 import.meta.main 守卫(Node 24 才支持),且 package.json 未声明 engines,Node<24 时直接跳过执行
升级 Node.js 到 24 及以上;社区实测降回 0.1.2-rc.1 可正常运行
DSH Web 默认限制只能从 localhost 访问,外部访问被拒绝。
通过 nginx 监听 4080,校验 token 后 proxy_pass 到 127.0.0.1:3080,并设置 Host 和 Origin 为 localhost。
用带回溯的正则校验多MB base64,超出V8正则栈深度抛RangeError,工具结果降级为文本占位
未明确
未明确(正文仅提出需求)
CommonMark 把反斜杠加标点视为转义,链接目标中 \. 被解析成 .,fileAddressFor 解析后已无法纠正
PowerShell的$HOME为只读自动变量,赋值静默失败,$home仍指向真实用户目录,Remove-Item递归删除
工具 parameters JSON Schema 含 $ref/$defs/additionalProperties,Gemini 不接受,每轮全量重发工具目录导致全部请求失败
verifyDesktopPath 判定路径含 junction 或符号链接时一律拒绝,测试用例对 symlink/junction/realpath 零覆盖
run_code 子调用 id 在同一 Session 内重复,违反 Session v4 的 subCallId 唯一性要求;写入时不报错,读取时全量校验失败
内网 AI 请求排队时抛出 PI_AI_ERROR,该错误未被默认自动重试规则覆盖,导致请求持续中断
未明确,用户仅反馈当日 8:00 多至 11:15 服务端持续不可用
重启后的服务端不认得客户端的 mcp-session-id,返回 400/404,SDK 既不关闭传输也不重建会话
主智能体停留在 wait_agent 等待子智能体,用户插话消息被团队等待条件挡住,无法及时送达。
classifyPiAiError 对流内无 HTTP 状态的服务端故障错误回退为 PI_AI_ERROR,该码不在默认 retryableCodes 中。
会话原始体积超模型窗口,dsh web 重启后全量重放,压缩死锁,此后每轮请求均 400
未明确(用户反馈新旧会话派发子智能体时,均沿用主会话模型而非指定模型)
链状态取不到时多次重试全写成 retry:1 且每次新建 retryId,校验器判为 attempt 序列跳号
DeepSeek Messages适配器对tool-call参数执行JSON.parse,模型偶发返回非法JSON即抛硬错,无重试且不带原始参数
一次并行派出 8 个子 agent,其中一个 preset 为 ptc 的子 agent 跑偏,脱离管理面持续循环且无失败通知
pi-ai adapter 丢弃 provider 的稳定错误码,把 upstream_stream_read_error 等传输级流中断统一转成 PI_AI_ERROR
历史中一段约2836字符的Markdown表格内容触发上游内容审核,之后该会话每轮请求均被拒,会话被永久锁死
0.2.0-rc.2 的 Web UI 与桌面端均未提供会话 id 的查看或复制入口
智能体团队名额上限为 8,长会话中已有 7-8 个队友后无法新建成员,用户也不清楚能否修改或删除成员
当前版本没有消息/会话回退(revert)功能,误发或需回滚时无法操作
正文未说明,用户猜测已只支持 arm 架构
会话持久化层编码事件时,v4 格式消息要求 producer-owned source kind 而缺失,core 0.1.7-rc.1 上偶发
持久化观察者将 v0 会话走 v0→v1 迁移,迁移要求 subagent/descriptor 的 data.version 为 3,而写入方实际只产出 version 2
模型联网抓取页面内容被服务端判定违规,返回Content Exists Risk 400;之后每条消息均被同一400拒绝。
迁移为该 attempt 重建 873 个 chunk 事件,而 assistant/message 声明 874 个源引用,多出的 seq 4059829 并非 chunk 事件
最新代码中 @deepseek-ai/dsh-llm 与 dsh-session 缺少 assertNever、snapshotJsonValue 导出
长会话工具输出过大,请求体超过provider限制,压缩请求重放同样超限
未明确
未明确;正文仅在 settings.yaml 的 compat 中加入 thinkingFormat: deepseek 后模型即无法被识别
未明确(pwsh 工具调用被中断后本轮运行失败)
未明确;同一中转站同配置下换 gpt-5.6-terra 正常,疑似中转站对 deepseek-v4 工具调用轮次不兼容
Edge 129 下 new URL().hostname 无法解析 dsh-resource 非特殊 scheme,hostname 为空,protocolOf 返回 undef…
win32 下 revealNativePath/runNativeCommand 调起资源管理器窗口后永久不可见,无报错,根因未明确
迁移先截断 gen0 再写入 v3,两步非原子;期间进程停止则日志尾部不可恢复丢失
未明确;正文称非长会话,新建会话首轮仍报错
profile 挂载 name 为相对目录 specifier 的 loader row 后,扩展准备失败且真实原因被包装隐藏
dsh-client-ui-sidebar-documentpreview 使用了 Safari 17.6 未支持的 Iterator 全局变量
tsdown workspace 解析不到入口 lib/types/{index,invariant,startup}.js,构建时该目录尚未生成
gateway/internal 无法安全转换未分类的消息源,session.jsonl.zstd 源工件保持未变(正文未进一步说明)
新版 0.1.5-rc.1 存在 bug:多轮对话中 fork 旧会话后,新写入的 prompt 会被重载成 fork 之前的 prompt
对回复进行中的会话 fork 时消息/队列继承异常,重放源会话 prompt A(未做代码级定位)
内置 preset 由 code 改名为 ptc,而用户 settings.yaml 仍保留旧默认值 code
预览页最大化后缺少关闭入口,alpha 与 rc 版本均存在
dsh 0.1.2-rc.1 的 MCP 客户端强制要求 structuredContent,忽略服务端声明的 structured_output=false,不符 MCP spe…
未明确;疑似路径解析对混合中英文名称支持不完善。
拉取最新代码后,agent-presets/api-remotes 缺少导出 resolveSessionPreset,导致 Windows 11 构建失败。
本地文件系统提供方将 HTTP(S) URL 当作相对路径处理,Windows 下拼成 Windows 路径并产生误导性 not found 错误。
持久化格式均硬拒绝非当前版本,且无迁移/双写路径;目前因都是首版未触发,一旦改版全部旧会话不可读。
混合不同provider的历史消息重放时丢失reasoning_content,API在思考模式下拒绝请求。
workspace.archiveSession仅追加archivedSessionIds,不删transcript,且任何API/CLI/持久化操作均无删除会话日志的路径
工具调用 prepare 阶段抛错,未写入 tool/result,历史残留未配对 tool_calls,后续请求被上游 400 拒绝。
正文未明确;用户使用 0.1.1-rc.2 询问是否支持最新视觉模型。
国内 OpenAI 兼容服务(如火山方舟、阿里百炼)不允许 developer 角色,而请求中带了该角色。
pi-ai 对声明 reasoning 的模型使用 developer 消息角色,但阿里云百炼网关仅接受 system/assistant/user/tool/function,导…
续传分片携带空name字段覆盖已累积的工具名,导致unknown tool错误。
模型陷入病态循环,反复输出bash命令无法自停。
关机强杀进程后,中断收尾事件与真实事件seq撞号,导致日志损坏。
工具调用名称为空,具体原因未明确。
DSH屡次出现严重bug导致无法使用,缺少备份还原机制。
未明确
Code Mode将工具schema描述原样嵌入tools:sdk提示词,renderPrompt严格插值器把{{dotted.state.path}}误当作变量引用