面向 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 不会替你安装。
安装步骤
- 01
`npx dsh-win32 setup` —— 检查官方持久 PowerShell 与 Workspace Write 包,并创建 DeepSeek Harness 桌面快捷方式。
$ npx dsh-win32 setup
- 02
`npx dsh-win32 setup --profile desktop --no-shortcut` —— 使用其他 profile 且不创建快捷方式。
$ npx dsh-win32 setup --profile desktop --no-shortcut
- 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 适配与能力边界
直接修复并验证官方原生 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 命令批准一次无沙箱 / 完全访问执行。
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 不会安装它。
07相关的 DSH 工作流
open-design
作者 nexu-io
DeepSeek Harness 的开源 AI 设计插件,本地优先桌面应用,让编码智能体变身设计引擎,生成原型、落地页、幻灯片、图片与视频,支持多种格式导出。
picgo
作者 molunerfinn
PicGo:面向高效创作者的图片上传神器,支持 Obsidian、Typora、VS Code 等编辑器,以及 S3、GitHub、Cloudflare R2、Imgur、阿里云 OSS 等 60+ 图床,粘贴即上传。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
openbiliclaw
作者 whiteguo233
本地私有、开源的自进化跨平台 AI 内容发现 Agent:先理解你,再主动从 B站、小红书、抖音、YouTube、X、知乎、Reddit、微博等平台与开放 Web 寻找内容。(支持 deepseek harness 插件) | Local-first open-source cross-platform AI content discovery agent: understands you, then proactively finds content across Bilibili, Xiaohongshu, Douyin, YouTube, X, Zhihu, Reddit, Weibo and the open web.(support deepseek harness plugin)
08数据与来源
Current DeepSeek Harness already includes persistent PowerShell and a Windows ACL sandbox.
**Official PowerShell. Workspace Write. One command.**
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-06。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
