DeepSeek Harness 怎么更新？npx 与源码两种升级方式详解

DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的一款 Agent 运行框架，核心设计是"一切皆插件"。它处于开发者预览阶段，版本迭代很快，官方明确提示未来会有破坏兼容性的变更，所以学会正确更新很重要。本文按两种安装方式（npx 和源码）分别讲清楚怎么升级，以及升级前后的注意事项。

一、先分清你的安装方式

更新方式取决于当初怎么装的：

• npx 方式：npx @deepseek-ai/dsh web 启动的 → 升级靠重跑命令拉新版
• 源码方式：git clone 下来构建的 → 升级靠 git pull + 重新构建

二、方式一：npx 安装的更新（最简单）

npx 方式更新几乎零成本：重新执行启动命令即可。

npx @deepseek-ai/dsh web

npx 会自动检查并拉取最新版本。如果想确保强制更新到最新，可以显式指定：

npx @deepseek-ai/dsh@latest web

优点：不用手动删旧包，npx 自动处理。

三、方式二：源码安装的更新

源码方式需要手动同步：

git pull                # 1. 拉取最新代码
pnpm install            # 2. 安装新依赖
pnpm run build          # 3. 重新构建
pnpm dsh web            # 4. 启动

注意：构建必须完整跑一遍，否则前端产物不更新，界面可能还是旧的。

四、更新前必做：备份你的数据

dsh 的个人数据（配置、会话、凭据）都在 $DSH_HOME（默认 ~/.dsh）里，和程序本体是分开的：

cp -r ~/.dsh ~/.dsh-backup

更新程序不会动你的数据目录，但备份一下更安心——尤其是跨大版本更新前。

五、更新后要检查什么

1. 1. 配置文件兼容性

   开发者预览阶段的"破坏性变更"可能改动配置格式。更新后如果启动报错，用这个命令看配置：

   dsh --dump-config

2. 2. 自定义内容是否还在
   • 自定义的 profile、技能（Skill）、预设如果报错，可能是格式变化
   • 改过内置样式文件的，升级会被覆盖，需要重新应用
3. 3. 功能是否正常

   跑一个简单的 headless 任务验证：

   dsh --profile headless "Say hello in one line."

六、常见问题速查

七、更新频率建议

• 尝鲜用户：官方发布新版本即可更新，跟着迭代走
• 稳定使用：不要每次小版本都追，重点看 Release 说明里的"破坏性变更"标记，有标记再评估升级
• 生产/重要环境：更新前先在测试环境验证

总结

DeepSeek Harness 更新分两种：npx 方式重跑 npx @deepseek-ai/dsh web 自动拉新版；源码方式执行 git pull → pnpm install → pnpm run build。更新前备份 ~/.dsh，更新后重点检查配置兼容性和自定义内容。因为它是开发者预览阶段、可能有破坏性变更，建议关注官方 Release 说明，有"破坏性变更"标记时谨慎升级。

预约实在Agent企业效能顾问

深度诊断企业痛点，定制专属 AI 自动化办公方案

联系我们 → 立即试用