sjh9714/dsh-win32 预览 preview

sjh9714/dsh-win32

搞定Windows上的DSH。一行命令安装极简模式持久shell,沙箱也已内置。

Project Overview项目介绍

dsh-win32 is a command-line tool built exclusively for fixing DeepSeek Harness (DSH) issues on native Windows systems, eliminating the common requirement to run DSH inside a WSL virtual environment. It is distributed via npm, so users do not need to clone the repository or install it globally to use it; you simply run the one-line command npx dsh-win32 setup from an official PowerShell window to initiate the entire repair process. The tool checks the existing official DSH installation stack, detects common known failures specific to the Windows environment, applies only repairs that are proven to be safe, and adds a desktop shortcut for easy access to DSH.

It is designed for any developer running DSH on Windows, whether you are setting up DSH for the first time or troubleshooting an existing installation that will not launch or has permission errors. After setup completes, you can run the npx dsh-win32 verify command to check that your entire installed DSH stack meets the runtime requirements, confirming that all core components work as expected on your system. The tool supports custom flags for advanced users, letting you specify a target profile or skip creating the desktop shortcut, and it includes dedicated diagnostic commands for legacy DSH installations.

This project is released under the permissive open source MIT license, and it requires no additional dependencies beyond a working Node.js installation and an existing DSH deployment on your Windows machine. The tool does not automatically install PowerShell 7, though it is the recommended shell for DSH on Windows, and it explicitly does not support the Node 23 release. Legacy preset configurations for Git Bash and busybox have documented limitations, including the fact that the tool will not automatically install Git for these setups, and all changes are clearly documented for user review before application.

这是一个专为 DeepSeek Harness (DSH) 设计的原生 Windows 修复工具,用于在不依赖 WSL 的前提下修复 Windows 平台上的 DSH 运行问题。它通过 npm 分发,只需执行一条命令 npx dsh-win32 setup 即可部署,会检查现有官方 DSH 安装栈,识别已知的 Windows 环境故障,应用经测试安全的修复,并创建桌面快捷方式。它不会额外安装 Git、PowerShell、WSL 或新的 DSH 安装包。

面向所有在 Windows 平台使用 DSH 的开发者,专门解决 DSH 无法启动、权限异常、环境配置错误等常见 Windows 适配问题。用户可先运行 npx dsh-win32 verify 指令验证现有安装栈的完整性,确认所有核心组件符合 DSH 的运行要求,也支持自定义配置参数,比如指定目标配置文件、跳过桌面快捷方式创建等。针对旧版 DSH 的 legacy 安装栈,也提供专门的诊断和修复命令。

本项目采用 MIT 许可证开源,不需要用户额外安装除 Node.js 和已有的 DSH 外的依赖,但推荐用户使用 PowerShell 7,工具本身不会自动安装 PowerShell 7。目前明确不支持 Node 23 版本,legacy 模式下的 Git Bash 和 busybox 预置有一定限制,且不会自动安装 Git。工具不对用户原有配置做强制修改,所有操作都提供明确的下一步指引。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 no risk signal found未发现风险信号
  • This site's static screen found no obvious risk signal (stars, license, activity, manifest)本站静态筛查没发现明显风险信号(星标、许可证、更新活跃度、清单完整度)
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:sjh9714/dsh-win32

把 sjh9714/dsh-win32 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-win32

Fix DSH on Windows. No WSL.

Official PowerShell. Workspace Write. One command.

npx dsh-win32 setup

Current DeepSeek Harness already includes persistent PowerShell and a Windows ACL sandbox. dsh-win32 checks that official stack, finds known Windows failures, applies the repairs it can prove safe, and creates a desktop shortcut.

It does not install Git, PowerShell, busybox, WSL, or another DSH bundle on the current path.

Use the standalone CLI above on current DSH. Do not run dsh plugin --profile web add dsh-win32 for this workflow: that installs the legacy bundle, not the current Windows setup path.

中文 · Windows evidence and legacy details

Using a coding agent? Copy the setup and verification request. For a guided walkthrough, see Windows troubleshooting in Chinese.

Start with the Windows first-run walkthrough if DSH will not launch or a check fails. It follows one problem from diagnosis through the next verification step. Share your first-run result, including attempts that are still blocked.

Need to disable or uninstall the old plugin, even when DSH cannot start? See disable / uninstall / remove. From 0.17.14, npx dsh-win32@0.17.14 disable --profile web previews offline deactivation; after stopping DSH, add --apply to back up the manifest and disconnect only the old bundle.

npm CI stars win32 MIT

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-run2skill 下一个 Next dsh-codex-ui →