返回目录

dsh-win32

编辑精选维护状态: 活跃

sjh9714/dsh-win32

在原生 Windows 上修复与诊断 DeepSeek Harness,提供官方 PowerShell、工作区写入、快捷键与旧预设修复,无需 WSL。

前往 GitHub项目主页
$ npx dsh-win32 setup

31

星标

2

Fork

TypeScript

语言

MIT

许可证

2026-08-15

创建于

2026-09-05

最近推送

面向 DeepSeek Harness 的原生 Windows 修复与验证工具集:一条命令完成安装,对已知故障做可证安全的修复,生成桌面快捷方式,并对已安装的 DSH 技术栈做无模型的 `verify` 验收。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-09-06

许可证

MIT

01它能帮你完成什么?

  • 在原生 Windows 上修复并诊断 DeepSeek Harness(无需 WSL)

    经过验证的官方技术栈、按可证安全方式修复的已知 Windows 故障,以及一个 DeepSeek Harness 桌面快捷方式

    在 Windows 上运行 DeepSeek Harness、遇到启动 / ACL / PowerShell 故障,并希望修复且不改动官方 profile/preset 的用户

  • 通过无模型的验收运行证明已安装的 DSH 技术栈确实可用

    一份通过/失败报告,实测 PowerShell 7、PTY 状态保持、Workspace Write 策略与 Windows ACL 隔离

    需要实时证据证明已安装的 PowerShell / Workspace Write / ACL 组件可用、且无需模型请求或 API 密钥的 Windows 用户与 CI 流水线

02如何接入 DeepSeek Harness?

前置条件

  • 需要原生 Windows 以及 DSH 支持的 Node 版本;Node 23 明确不被支持。
  • 已安装 `@deepseek-ai/dsh`(DeepSeek Harness)——`verify` 针对已安装的依赖树运行。
  • 推荐使用 PowerShell 7,但 dsh-win32 不会替你安装。

安装步骤

  1. 01

    `npx dsh-win32 setup` —— 检查官方持久 PowerShell 与 Workspace Write 包,并创建 DeepSeek Harness 桌面快捷方式。

    $ npx dsh-win32 setup

  2. 02

    `npx dsh-win32 setup --profile desktop --no-shortcut` —— 使用其他 profile 且不创建快捷方式。

    $ npx dsh-win32 setup --profile desktop --no-shortcut

  3. 03

    `npx dsh-win32 setup --legacy` —— 修复旧版 Git Bash / busybox preset。

    $ npx dsh-win32 setup --legacy

验证接入成功

  • `npx dsh-win32 verify` —— 对已安装技术栈做无模型、无 API 密钥的验收运行。
  • `npx dsh-win32 verify --json` —— 同样的检查,输出机器可读结果。

03DSH 适配与能力边界

DSH 适配原生运行时

直接修复并验证官方原生 Windows DSH 技术栈(持久 PowerShell + Windows ACL 沙箱)——无需 WSL

  • 官方技术栈检查与安全修复

    Windows 上已安装的 `@deepseek-ai/dsh`按可证安全方式修复已知 Windows 故障;profile 保留在官方 Minimal preset

  • 桌面快捷方式

    已安装 DSH 的 Web profile一个 `DeepSeek Harness` 桌面快捷方式

  • 实时验证(`verify`)

    已安装的 `@deepseek-ai/dsh` 依赖树针对 PowerShell / Workspace Write / ACL 组件的无模型、无 API 密钥验收报告

  • Doctor 与 koffi 修复

    已发布的 DSH Windows 包契约与已安装的 koffi 运行时`doctor` 的 JSON(`dsh-doctor/v1`)以及只修复已知损坏 koffi 版本的 `fix`

  • 旧版 preset 修复

    DSH rc.6 及更早版本(Git Bash / busybox preset)面向旧版 Windows preset 的 `setup --legacy` / `doctor --legacy`

04适合谁?何时不该用?

适合

  • 在 Windows 上运行 DeepSeek Harness、遇到启动 / ACL / PowerShell 故障,并希望修复且不改动官方 profile/preset 的用户
  • 需要实时证据证明已安装的 PowerShell / Workspace Write / ACL 组件可用、且无需模型请求或 API 密钥的 Windows 用户与 CI 流水线

不适合

  • 需要原生 Windows 以及 DSH 支持的 Node 版本;Node 23 明确不被支持。推荐使用 PowerShell 7,但 dsh-win32 不会替你安装。
  • dsh-win32 只在原生 Windows 上修复 DSH,不使用 WSL;它也不会在当前路径安装 Git、PowerShell、busybox、WSL 或其他 DSH 套件。
  • 旧版 Git Bash preset 需要 `danger-full-access`,这会移除常规的 Windows ACL 隔离。
  • 在另一个 Workspace Write / Windows ACL 沙箱内部运行 `verify` 可能在 PowerShell 启动前卡住;需仅为本次 verify 命令批准一次无沙箱 / 完全访问执行。

05兼容性、维护与安全提示

  • 需要原生 Windows 以及 DSH 支持的 Node 版本;Node 23 明确不被支持。推荐使用 PowerShell 7,但 dsh-win32 不会替你安装。
  • dsh-win32 只在原生 Windows 上修复 DSH,不使用 WSL;它也不会在当前路径安装 Git、PowerShell、busybox、WSL 或其他 DSH 套件。
  • 旧版 Git Bash preset 需要 `danger-full-access`,这会移除常规的 Windows ACL 隔离。
  • 在另一个 Workspace Write / Windows ACL 沙箱内部运行 `verify` 可能在 PowerShell 启动前卡住;需仅为本次 verify 命令批准一次无沙箱 / 完全访问执行。
作者未说明作者未说明v0.17.7

readme_verified

06常见问题

运行 dsh-win32 需要 WSL 吗?

不需要。dsh-win32 在原生 Windows 上修复 DeepSeek Harness,且明确不会安装 WSL(也不会安装 Git、PowerShell、busybox 或其他 DSH 套件)。

`npx dsh-win32 setup` 会做什么?

它会检查官方的持久化 PowerShell 与 Workspace Write 包,创建 DeepSeek Harness 桌面快捷方式,并把配置保留在官方的 Minimal 预设上。PowerShell 7 推荐使用,但 dsh-win32 不会替你安装它。

`verify` 和 `doctor` 有什么区别?

`doctor` 校验已发布的 DSH Windows 包契约并从包元数据检查本地故障;`verify` 则是针对你已安装的 `@deepseek-ai/dsh` 依赖树、无需模型与 API 密钥的验收运行,会实测 PowerShell / Workspace Write / ACL 组件。

`verify` 需要 API 密钥或模型访问吗?

不需要。`verify` 是无模型、无 API 密钥的验收运行,只测试已安装的技术栈,不会发起模型请求,也不把包元数据当作证明。

支持哪些 Windows 版本和 Node 版本?

需要原生 Windows 以及 DSH 支持的 Node 版本;Node 23 明确不被支持。推荐使用 PowerShell 7,但 dsh-win32 不会安装它。

08数据与来源

  • 作者声明github.com7401db4567f9…

    Current DeepSeek Harness already includes persistent PowerShell and a Windows ACL sandbox.

  • 作者声明github.com7401db4567f9…

    **Official PowerShell. Workspace Write. One command.**

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-06。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。