第 29 卷

• **路径处理**：中文路径、特殊字符路径有真实 bug（0x00 截断、ENOENT），社区多

人反馈（根因 #107，家族 17+ 帖）

• **编码问题**：UTF-16 相关处理存在缺陷，终端输出偶发乱码
• **CLI/TUI 之争未定**：官方讨论区存在"CLI 才是正道 vs TUI 才是交互未来"的路线争议

（#386），路线未明前，投资终端 UI 形态有风险 > 以下 Windows 家族问题来自官方讨论区挖掘报告（[docs/research/discussion-mining.md]

(./research/discussion-mining.md)，2026-08-14 抓取，rc.6 时代），均为社区真实复现，多数尚未修复。

端口：默认 3080 撞上 Hyper-V 保留区间（#589）

**现象**：Windows 上默认端口 3080 启动报 EACCES，服务起不来、web 界面打不开。

**根因**：启用 Hyper-V/WSL2 后，Windows 会保留一段动态端口区间（3070-3169）， 3080 恰好落在其中。

**临时 workaround**：换用保留区间外的端口（社区实测 13080 可用）。

局域网 HTTP 访问 RPC 全挂（#755）

**现象**：局域网内通过 HTTP（非 localhost、非 HTTPS）访问时，所有 RPC 调用失败。

**根因**：`crypto.randomUUID` 只在安全上下文（HTTPS 或 localhost）可用，局域网裸 HTTP 属非安全上下文。

**临时 workaround**：官方无修复；HTTPS 或隧道（如 Tailscale）访问可规避非安全上下文限制（按成因推论，未在社区帖内验证）。

沙箱：临时目录清理后永久崩溃（#758）

**现象**：Windows 上清理沙箱临时目录后 dsh 永久崩溃、不自愈（社区标 P0），并伴随 4 个相关稳定性问题。

**影响**：清一次临时目录 = 服务报废，无自动恢复路径。

**临时 workaround**：不要清理 dsh 沙箱临时目录；已触发则重启进程恢复。

WSL：工作区只能选 /root（#160）

**现象**：WSL/Ubuntu 环境下工作区选择器只能选 /root 内的目录，其余路径不可选。

**临时 workaround**：把项目放到 /root 下使用（限制内可用，限制外暂无绕过方案）。

子进程：Windows 无优雅终止（#717）

**现象**：Windows 下子进程管理系统性缺失——没有优雅终止阶梯、孙进程输出截断、 spill 权限不生效、shellPath 默认指向 /bin/bash（Windows 上不存在该路径）。

**影响**：长任务终止不干净、输出丢失、权限预期失效，属平台适配缺口而非单个 bug。

**临时 workaround**：手动 `taskkill /T` 清理进程树；显式配置 shellPath 为 Windows 实际路径。

---

> **沙箱 MSYS 冲突（#1889 实测签名）**：`workspace-write` 用受限令牌时，MSYS 系 shell 在 cygheap 初始化即死（`cygheap_user::init: NtSetInformationToken (TokenDefaultDacl),

0xC0000022` / `CreateFileMapping ... Win32 error 5`）——MSYS 运行时模型与受限令牌直接冲突，插件层无解。这也解释了为什么 Windows 方案清一色要求 `danger-full-access`（不是作

者偷懒）。

12.4 跨平台已知问题速查表

> 本章跨平台已知问题一表速查。帖号均为官方讨论区真实帖（deepseek-ai/deepseekharness），截至 2026-08-14。

discussions/107 （根因；家族

#151/#396/#563 等 17+ 帖）

目录选择器 workerWindows#30https://安装层锁

harness/ discussions/30

（家族 #154/#236/#449/

#768）

deepseekharness/

discussions/589

discussions/755

deepseekharness/

discussions/758

deepseek-ai/ deepseek-

harness/ discussions/160

harness/ discussions/717

---

12.5 性能边界未充分验证

白皮书的 benchmark 覆盖了**单 agent、常规任务规模**，以下场景缺少公开数据：

• **高并发**：多 agent 并行、大规模任务分发
• **大型代码库**：百万行级仓库的上下文管理、工具调用延迟
• **长时运行**：连续数小时运行的稳定性、内存泄漏风险
• **缓存命中率的边界**：97% 实测命中率依赖"对话模式重复"——全新任务/冷启动场景

会明显下降

12.6 与成熟 Agent 的差距

对照 Claude Code、Codex 等成熟产品，dsh 的差距是**结构性**的（不是补几个功能就能追上）：