WorkBuddy 下 DeepSeek Harness 一键安装

要解决什么问题

DeepSeek Harness（dsh）是 DeepSeek 官方在模型外层编排文件系统、终端、工具与会话的 Agent 执行框架。官方常用 npx @deepseek-ai/dsh web 启动 Web UI，但在 WorkBuddy 托管的 Windows + Bash 里，这条路径很容易踩坑：$HOME 被重定向到 C:\ProgramData\WorkBuddy\...，用 ~ 拼路径会装错位置；npx 临时目录没有 package.json，中途 npm install 会清空依赖树，导致 koffi 原生模块缺失；npm 解压时的 trash 操作还可能卡死安装。C 盘默认缓存与 ~/.dsh 数据目录也会占满系统盘。本技能把这些环境差异和实测结论整理成可执行的安装与启动流程。

技能如何帮你落地

技能按 正规目录完整安装（推荐）、npx 一键、全局安装 三种方式说明差异，并强调 WorkBuddy 下应使用托管 Node 与用户级 skills 的绝对路径，必要时用 npm_config_cache、DSH_HOME 把缓存和数据迁出 C 盘。启动上把 dsh web 当作长驻后台服务（日志出现 http://127.0.0.1:3080 即成功），并处理 .dsh 残留 profile 触发的 SAFEDELETEBULKCONFIRMREQUIRED（改名备份后全新初始化）。

DeepSeek API Key 被标为必做第一步：未配置时 Web UI「内测声明」点继续会报无法保存确认状态，模型会话也不可用；技能覆盖 Web UI、环境变量、$DSH_HOME/.credentials.yaml 三种配置方式及验证思路。此外还包含在沙箱限制下创建 纯 ASCII 的 start-dsh.cmd、用 CLSID + pywin32 生成 .lnk 快捷方式，以及 koffi、端口占用、路径乱码等排障对照。

适用边界

内容面向 WorkBuddy Windows 沙箱 与托管 Bash，路径示例含本机实测目录，换机器需替换为你的绝对路径。dsh 处于开发者预览，命令与插件接口可能随版本变化；DeepSeek API Key 与 Musein 等第三方算力无关，需使用 DeepSeek 平台自己的 Key。沙箱下生成的 .lnk 可能出现图标 StringData 错位，不影响双击启动，需手动指定 dsh-icon.ico。