本教程带你从零上手 DeepSeek HarnessDSH讲清楚临时安装和永久安装的区别以及日常最常用的命令。全程实操复制即用。一、什么是 DeepSeek HarnessDeepSeek Harness简称DSH是 DeepSeek 官方的 AI 编程助手运行框架提供 Web 图形界面、终端对话、任务执行等多种模式。官方包名deepseek-ai/dshWeb 界面默认地址http://127.0.0.1:3080依赖Node.js 22建议 24二、两种安装方式先看结论对比项临时安装npx永久安装npm -g安装命令npx deepseek-ai/dsh webnpm install -g deepseek-ai/dsh安装位置npm 缓存_npx/目录全局目录AppData\Roaming\npm启动方式每次都要npx前缀直接敲dsh适合人群想先体验一下打算长期使用升级方式自动用最新版联网手动npm update -g deepseek-ai/dsh一句话想先试试用 npx确定好用就 npm 全局装。三、方式一临时安装先体验# 一键启动 Web 界面首次会自动下载稍等片刻npx--yesdeepseek-ai/dsh web启动成功后浏览器打开http://127.0.0.1:3080特点不污染全局环境用完即走包缓存在C:\Users\你的用户名\AppData\Local\npm-cache\_npx\想删掉直接删掉_npx目录即可不影响其他软件缺点每次都要带npx前缀依赖 npx 缓存清理缓存后要重新下载四、方式二永久安装推荐长期使用第 1 步全局安装npminstall-gdeepseek-ai/dsh第 2 步验证安装dsh--version能输出版本号如0.1.0-rc.6即安装成功。第 3 步启动 Web 界面dsh web浏览器打开http://127.0.0.1:3080即可使用。 以后每次使用只需要一条命令dsh web升级 / 卸载# 升级到最新版npmupdate-gdeepseek-ai/dsh# 卸载npmuninstall-gdeepseek-ai/dsh五、常用命令速查表小白必备 基础命令命令作用dsh --version查看版本号dsh --help查看所有命令帮助dsh web启动 Web 图形界面最常用dsh web --help查看 Web 界面的参数️ Web 界面相关命令作用dsh web启动 Web 界面默认端口 3080dsh --profile web等价于dsh web完整写法 其他运行模式命令作用dsh --profile headless 运行测试无界面模式回答一个任务后退出dsh --profile tui终端交互界面模式dsh --profile tui --resume 会话ID恢复之前的会话 插件管理命令作用dsh plugin --profile web add 包名给 Web 模式安装插件dsh plugin --profile web remove 包名移除插件️ 调试与配置命令作用dsh --dump-config打印当前完整配置树dsh --dump-default-config打印默认配置不含用户自定义dsh --patch 文件路径加载额外的配置覆盖层六、小白常见问题Q1npx每次都提示下载很慢怎么办答直接换永久安装npminstall-gdeepseek-ai/dsh以后直接dsh web不再联网下载。Q2永久安装后dsh命令找不到答全局安装目录没加入系统 PATH。检查方法npm config get prefix把输出的路径如C:\Users\你的用户名\AppData\Roaming\npm加入系统环境变量Path然后重开终端。Q3临时安装的缓存想清理# 直接删除 npx 缓存目录安全下次自动重建rmdir/s /q%LOCALAPPDATA%\npm-cache\_npxQ4端口 3080 被占用了怎么办答运行dsh web --help查看端口参数按提示修改端口后重新启动。Q5装过临时版又装了永久版会不会冲突答不会。两者是独立的npx 缓存和全局安装互不影响。只要记住——永久版用dsh启动临时版用npx deepseek-ai/dsh启动。建议二选一长期用推荐永久版。七、完整上手流程照着做就行# ① 永久安装npminstall-gdeepseek-ai/dsh# ② 验证dsh--version# ③ 启动 Web 界面dsh web# ④ 浏览器打开 http://127.0.0.1:3080 开始使用以后每次使用dsh web就这一条命令完事。总结临时版npx deepseek-ai/dsh web → 体验用 永久版npm install -g deepseek-ai/dsh → 长期用 启动dsh web → 打开 http://127.0.0.1:3080如果本文对你有帮助欢迎点赞收藏有问题评论区见~