前言¶
想在本机跑 DeepSeek Harness(下文简称 dsh,npm 包 @deepseek-ai/dsh)的人,通常要自己走一遍完整链路:确认 Node 环境、拉包、填 API Key、启动、处理端口占用。链路不长,但每一步都可能卡住——尤其是在 Windows 本机:npx 缓存和全局包挤占 C 盘空间、Node 由系统托管导致命令不可用、Git Bash 下路径转换出错,都是常见死法。
下面介绍的这个 Skill 把这些步骤固化成了一条可执行流程。它面向 workbuddy 场景,作用是在 workbuddy 里一键安装、启动、配置和排障 dsh,并把 Windows 本机的坑提前处理掉。
这是什么¶
Skill 名称:DeepSeek Harness 在workbuddy 一键安装,坐标 @user_b4bc8872/deepseek-harness-dsh,版本 1.0.1。
它解决的问题很具体:用户说「帮我安装 / 启动 / 配置 DeepSeek Harness、dsh、deepseek harness、npx @deepseek-ai/dsh、DSH Web UI」,或遇到 dsh 无法启动、端口占用、API Key 配置等问题时,由 Skill 接管后续操作,而不是让用户自己对着命令行排查。
需要说清楚的一点:dsh 本身是 DeepSeek 官方开源的 Agent 运行框架;这个 Skill 是社区来源(community),由发布者 user_b4bc8872 维护,它只是把 dsh 的安装运维流程打包成了 skill。
核心功能¶
根据 SkillHub 页面上的简介,这个 Skill 的能力有四项:
- 一键安装 DeepSeek Harness,即完成 dsh 的安装与启动;
- 主动生成桌面快捷方式,装完不用手动找入口;
- 主动避坑,重点是 Windows 本机的三类问题:C 盘空间紧张、托管 Node、Git Bash 路径转换;
- 主动提醒填写 API Key,因为 dsh 运行需要 DeepSeek API Key(Skill 标签为
requires_api_key=true)。
它对应的触发场景是:安装 / 启动 / 配置 dsh,访问 DSH Web UI(默认地址 http://127.0.0.1:3080),以及排障(无法启动、端口占用、API Key 配置)。
安装与启用¶
第一步,在 SkillHub 安装这个 Skill。页面地址:
https://www.skillhub.cn/skills/user_b4bc8872/deepseek-harness-dsh
或 API 地址:
https://api.skillhub.cn/user_b4bc8872/deepseek-harness-dsh
坐标为 @user_b4bc8872/deepseek-harness-dsh,来源 community,分类 ai-agent。按 SkillHub 的安装方式把 Skill 加到 workbuddy 后,在对话里提出需求即可。
第二步,让 Skill 干活。在 workbuddy 里直接说需求,例如「帮我安装 DeepSeek Harness」或「dsh 启动不了,端口 3080 被占了」。Skill 触发后会按内置流程执行安装、配置和排障,包括生成桌面快捷方式、提示填写 API Key。
第三步,确认 dsh 本体已就位。dsh 是 npm 包,官方启动命令是:
npx @deepseek-ai/dsh
启动后打开浏览器访问默认 Web UI 地址:
http://127.0.0.1:3080
如果 3080 被占用,按 Skill 的排障流程处理(换端口或释放占用),不必手动改配置。
典型用法¶
以下用法来自 Skill 的触发条件描述,是可复现的最小路径:
- 安装:在 workbuddy 里说「安装 DeepSeek Harness」,Skill 完成安装并生成桌面快捷方式,随后提醒你填写 API Key;
- 启动:说「启动 dsh」或「打开 DSH Web UI」,Skill 执行启动命令,你访问
http://127.0.0.1:3080使用; - 配置:说「配置 DeepSeek Harness」,Skill 引导你完成 API Key 等配置项;
- 排障:说「dsh 无法启动」「端口占用」「API Key 配置有问题」,Skill 按内置的 Windows 踩坑清单逐项排查。
适用场景与注意¶
适合的人:想在 Windows 本机快速跑起 dsh、不希望手动查资料解决 Node 和路径问题、已经在用 workbuddy 的开发者。
需要注意的地方:
- 这个 Skill 是社区来源,不是 DeepSeek 官方出品;它操作的 dsh 才是官方开源框架。
- 运行 dsh 需要有效的 DeepSeek API Key,Skill 会提醒,但 Key 本身要在 DeepSeek 开放平台申请,Skill 不代发。
- Windows 上的三类坑(C 盘空间、托管 Node、Git Bash 路径)是 Skill 声明覆盖的场景;如果你的环境不是这三类,排障仍可能要自己动手。
- Skill 页面显示安装数为 0、来源为 community,属于较新且未经大规模验证的 Skill,介意的话可以先在测试环境跑一遍。页面上的评分和下载量以 SkillHub 实时数据为准。
结尾¶
这个 Skill 的价值在于把「装 dsh」从一次手工排查变成一次对话。官方地址:
https://www.skillhub.cn/skills/user_b4bc8872/deepseek-harness-dsh
或 API 地址:
https://api.skillhub.cn/user_b4bc8872/deepseek-harness-dsh