DeepSeek Harness 指南

旧版 Node 上安装失败

先说结论：DeepSeek Harness 需要 Node.js ^22.19.0 或 >=24.0.0。更旧的运行时会在 npx 失败，有时出现 node-domexception。

1. 运行 node -v 并确认版本范围。
2. 从你现有的 Node 发行渠道安装 22.19+ 或 24+。
3. 新开一个终端，让 PATH 生效。
4. 重试 npx @deepseek-ai/[email protected] web.

0.1.2-rc.1 还修复 Node 24.0-24.11.1 的启动与 HMR。版本钉在 下载页.

dsh web 在端口 3080 上报 EACCES

先说结论：在 Windows 上通常是 Hyper-V、WSL2 或 Docker 占用端口，不是文件权限问题。

1. 查看主机的 reserved-range 输出。若 3080 在该范围内，不要去 chmod。
2. 停掉占用方（Hyper-V 交换机、WSL2、Docker），或用当前版本说明里的 dsh 参数换端口。
3. 确认打印的 URL 仍是 loopback。不要把 UI 绑到公网接口。
4. 若页面能开但 API 返回 403，说明不在受信任 Host 列表。请留在 127.0.0.1。

Windows 沙箱 ACL 修复

先说结论：@deepseek-ai/dsh-sandbox-windows-acl 可能把创建者锁在 C:\Windows\Temp 下的 TEMP 目录外，或在 BUILTIN\Administrators 拥有的 workspace 上以 SetNamedSecurityInfoW error 5 失败。

1. 检查机器级 TMP/TEMP 是否为 C:\Windows\Temp，以及用户覆盖是否为空。
2. 把 HKCU 的 TMP 和 TEMP 设到你拥有的文件夹，例如用户配置目录下。然后重启终端。
3. 创建所有者是你本人、不是 Administrators 的 workspace。避免 D:\ 这类盘符根目录。
4. 再试一次沙箱内的 pwsh。若只有 danger-full-access 能用，仍是 ACL 问题，不是模型问题。

授权后清空 Windows Temp 可能永久破坏 workspace-write，直到你重建 temp 策略。见 sandbox 策略 and 沙箱限制.

中文文件夹名触发 workspace-invalid-path

先说结论：Win32 文件夹选择器可能截断含 开 或 一 等字符的路径，于是 dsh 看到 ENOENT。

1. 0.1.2-rc.1 含此截断修复。若仍在 0.1.1-rc.2 请钉住该版本。
2. 若暂时不能升级，请用 ASCII 名称作为 workspace 路径。
3. 不要选盘符根目录。那里 session.create 会 EPERM，New Session 保持空白。

pnpm install 之后出现 ERR_MODULE_NOT_FOUND

先说结论：用 pnpm 安装已发布 CLI 通常会触发 loader entry ui-plan 失败，并缺少 @deepseek-ai/cordis-plugin-group。

1. 已发布包装用 npx 或 npm。
2. 仅在源码检出里、完成以下步骤后再用 pnpm pnpm install and pnpm run build.
3. 若 plugin add 拉到 latest 0.0.1-rc.1 而 CLI 是 0.1.1-rc.2，请把插件版本钉到 CLI 同一列车。

Windows 沙箱内的 SEC_E_NO_CREDENTIALS

先说结论：沙箱可能破坏 Schannel HTTPS（curl、PowerShell、.NET），而普通 HTTP 和 OpenSSL 客户端仍可用。

1. 在沙箱外复现。若那里 HTTPS 正常，说明主机证书库没问题。
2. 沙箱步骤优先用不走 Schannel 的客户端，或在明确批准后把这次请求放到 workspace-write 之外。
3. 不要把它当成文件策略已关闭的证据。网络不在 SandboxMode 范围内。

升级后隐藏会话标题或无法启动

先说结论：0.1.2-alpha.5 与 0.1.2-rc.1 修复从 0.1.1-rc.2 或 0.1.2-alpha.3 升级的回归。

1. 若需要 0.1.2 线，请钉住 0.1.2-rc.1。
2. 若必须导出 SQLite 会话数据，请在早于 0.1.2-alpha.3 的构建上做。后端已移除，文件未被删除。
3. 测试升级时保持 DSH_HOME 可丢弃。

杀毒软件警告

先说结论：dsh 是已签名的 npm 包，会启动 Node 并可能拉起 shell。启发式扫描器会标记该模式。

1. 确认启动的是 @deepseek-ai/dsh，不是仿冒名。
2. 把已安装 tarball 的 shasum 与下列页上的值对照 SHA 与签名说明.
3. 仅在核对之后再恢复被隔离的 Node 或临时目录。

首次运行的最佳做法

1. 从空的可丢弃目录开始，不要用家目录或客户 monorepo。
2. 保持 workspace-write 和 ask。不要一上来就用 danger-full-access。
3. 钉住版本。未钉住的 npx 跟随 latest，目前仍是 0.1.1-rc.2。
4. 在执行前审查 plugins、MCP 服务器、Skills 和 Hooks。
5. 若不能接受同用户进程读取凭据，就不要把凭据放进 workspace。文件沙箱限制写入，不限制读取。

下载 DeepSeek Harness