Agent Skills
返回列表
DeepSeek Harness (dsh) 本地安装

DeepSeek Harness (dsh) 本地安装

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8104043a/install-deepseek-harness。

技能介绍

要解决什么问题

你想在自己的项目仓库里跑 DeepSeek 开源的 Agent 运行框架 DeepSeek Harness(CLI 为 dsh),而不是每次 npx 临时拉包、版本漂移、装到一半卡在官方 npm 源。墙内单包动辄十秒以上时,还需要把依赖树装进 node_modules 并留下可复现的锁文件,同时把模型配置和 DSH_HOME 跟项目一起走,方便团队对齐同一套编码 Agent。

技能如何工作

本技能按「先只读核查、再确认方案、后落盘安装」执行,避免一上来改坏仓库:

  • 环境核查(只读):检查 Node 是否 ≥ 22.19、pnpm 是否可用、npm 镜像是否可达、目标目录状态;此阶段不写文件。
  • 方案确认:在锁版本 npm/pnpm、源码构建、npx 临时等路径里与用户确认集成目录后再动手。
  • 锁版本安装:写入精确版本的 package.json、固定国内镜像的 .npmrc,用 pnpm 装全依赖并生成 pnpm-lock.yaml。
  • 配置与启动器:项目内 .dsh/settings.yaml(密钥走环境变量或 Web UI,不落明文)、纯 ASCII 的 dsh.cmd / dsh-stop.cmd、补充 .gitignore。
  • 冒烟验证:跑 dsh --version、dsh --profile web --dump-default-config,并提示你在本机双击 dsh.cmd 打开默认 http://127.0.0.1:3080 的 Web UI。

文档中当前稳定可装参考为 @deepseek-ai/dsh@0.1.0-rc.7(开发者预览,官方提示后续可能有破坏性变更)。

适用边界与注意点

  • Node 版本过低会在运行时报错;勿把 22.12 等旧小版本当可用品。
  • Web UI 监听需在用户本机(常需管理员权限)执行启动脚本验证;受限沙箱可能因无法覆盖 .dsh/profiles/web/cordis.yml 而无法在 Agent 环境内完成真实监听。
  • API Key 推荐 DEEPSEEK_API_KEY 环境变量,或在启动后于设置页写入并由 .dsh/.credentials.yaml 保管。
  • 首次 dsh web 会为 profile 拉取各模型/MCP 提供方插件,联网较慢属预期;pnpm-workspace.yaml 残留可安全删除。

使用场景

  • 新仓库要在根目录固定 `@deepseek-ai/dsh` 精确版本,并生成 `pnpm-lock.yaml` 供 CI 复现
  • 用户说「在本地装一个 dsh」且希望默认 Web UI 监听 127.0.0.1:3080,需一并写好启动脚本
  • 墙内 `npm install` 极慢,需要把 registry 切到 npmmirror 并用 pnpm 装完整棵依赖树
  • 团队要把 `.dsh/settings.yaml` 与 `DSH_HOME` 放在项目内,API Key 只走环境变量或凭证文件

适合人员

  • 维护单体/全栈仓库、要把 Cordis 插件化编码 Agent 接进现有 Node 项目的后端工程师
  • 在 Windows 环境习惯用 `.cmd` 启停本地服务、不想在 PowerShell 里手敲 `node .../bin.js web` 的开发者
  • 负责内网镜像与依赖审计、要求 package.json 锁版本且可离线复现安装的 DevOps
  • 需要在受限网络下给多个项目复制同一套 dsh 配置模板的内部平台同学