dsh-win32

解决什么问题

• 在原生 Windows（不使用 WSL）上，DSH 常出现无法启动或检查不通过的情况，原因往往难以定位：PowerShell 7 环境问题、损坏的 koffi 运行时、遗留的旧版插件 bundle。
• dsh-win32 提供四个命令：
  • setup：检查已发布的 DSH Windows 包契约与 PowerShell 7，识别已知损坏的 koffi 运行时，创建 DeepSeek Harness 桌面快捷方式，并保持官方 profile 与预设在 stock Minimal 状态。
  • doctor：校验 Windows 包契约并检查本地 Windows 故障，--json 输出遵循 dsh-doctor/v1 信封。
  • verify：对已安装的依赖树做免模型、免 API Key 的实时验收——持久 pwsh 保持同一 PTY/工作目录/环境、临时工作区内写入与读取、普通进程可写而受限 PowerShell 被拒且不产生文件、拒绝后恢复与取消清理；所有临时资源随后被移除。
  • fix：只修复已知损坏或真实加载失败的 koffi 版本，并在修复后重新验证加载。
• 同时提供旧版 bundle 的停用/卸载路径，即使 DSH 已经无法启动。

适合谁

• 在原生 Windows 上使用 DSH、但不希望引入 WSL 的开发者。
• 需要向他人分发或支持 Windows 上 DSH 安装、希望有可复现诊断与验收步骤的维护者。
• 正被 koffi / PowerShell 7 / Workspace Write 沙箱相关故障卡住、需要一条命令定位与修复的用户。

使用

npx dsh-win32 setup
npx dsh-win32 setup --verify
npx dsh-win32 doctor --json
npx dsh-win32 fix

注意事项

• 该流程使用独立 CLI；不要执行 dsh plugin --profile web add dsh-win32，那会安装旧版 bundle 而非当前 Windows setup 路径。
• verify 的通过只代表组件链验收，不等于完整的 stock Minimal 会话、插件安装器或 hook 强制执行。
• 若在已有沙箱中运行 verify，需仅为该命令批准一次非沙箱执行，否则嵌套的受限令牌/ConPTY 层可能卡住。