本文主要针对于爱折腾入门级别的小白食用，教大家如何从 0～1 再自己本机上安装好最近开发圈很火的 deepseek harness，以及分享安装过程中遇到的坑和解决办法，分享了一些好用的插件。

介绍

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）,采用一切皆插件的架构。

开源地址：https://github.com/deepseek-ai/deepseek-harness （截止发文 star：202K）

官网：https://www.deepseek.com/

安装步骤

前置条件

  • 一双勤劳实操的手
  • 安装 Node.js ，支持 22.19+ 与 24+。
  • 可选：Git 2.26 或更高版本；钩子设置会启用 Git 的 worktree 专属配置扩展。（源码安装需要），一个 DeepSeek API key（使用 ds官方需要）

一次性启动体验：国内镜像源加速

npx --registry=https://registry.npmmirror.com @deepseek-ai/dsh web

全局安装：

# 全局安装
npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com

# 启动
dsh web

界面配置

启动完成自动会浏览器打开：http://127.0.0.1:3080/

如果没有deepseek官方的密钥，那么就添加自定义的，兼容openai和authropic协议。

AI 小白入门篇：初体验安装 DeepSeek Harness

对话体验：（插播广告->若你有 AI 大模型部署运维，企业内部知识库搭建，AI 相关业务培训等需求可以评论区留言或发送邮件到（ i#51it.wang将#改成@）联系我们。）

AI 小白入门篇：初体验安装 DeepSeek Harness

扩展配置

目前github上有一些开源好用的插件，这里推荐一下DeepSeek Harness（DSH）Web （@zhu1090093659/dsh-web）插件聚合生态包 ，也是「一切皆开发、一切皆插件」理念在 Web 端最完整的落地：任务看板（task board）、移动端远程控制（mobile remote）、SSH 运维终端、图像理解（image understanding）、梁神模式 agent 预设、救助模式（rescue mode）与右侧面板，每一样都是独立成包的插件，可插拔、可替换、可再开发——一次装齐便是完整的 AI 开发工作台，只挑一两个也能安静融入原生界面。

安装dsh-web-all

安装聚合包：dsh plugin --profile web add @linxin666/dsh-web-all@latest --registry=https://registry.npmmirror.com

执行完命令可能会提示如下错误：

Packages: +223
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Progress: resolved 233, reused 223, downloaded 0, added 223, done
╭ Warning ─────────────────────────────────────────────────────────────────────╮
│                                                                              │
│   Ignored build scripts: cloudflared@0.7.3, cpu-features@0.0.10,             │
│   node-pty@1.1.0, ssh2@1.17.0.                                               │
│   Run "pnpm approve-builds" to pick which dependencies should be allowed     │
│   to run scripts.                                                            │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯

直接执行 pnpm approve-builds ，然后弹出让你选择允许哪些包，直接选择全部。

如果执行 pnpm approve-builds 之后提示如下：

> pnpm approve-builds                                                 
There are no packages awaiting approval

那就进入到 进入 dsh 的插件存放目录下再执行

macOS / Linux / Git Bash / WSL：cd ~/.dsh/profiles/web
Windows PowerShell：cd $HOME\.dsh\profiles\web
Windows CMD：cd %USERPROFILE%\.dsh\profiles\web

执行之后会弹出让你选择允许哪些，直接上下键勾选所有回车。

重启再执行命令 dsh web，侧边栏出现全部插件入口，打开「设置 > 插件配置」按需开关插件，或在皮肤面板试穿皮肤，如下效果：

AI 小白入门篇：初体验安装 DeepSeek Harness

插件市场

一切皆为插件，那么我们在哪里可以找到 dsh 的插件呢，最主要的是就是 github 上面，下面也给几个在线网站整理的直接搜索。

⚠️插件安装本来存在风险，一定要仔细斟酌，尽量选择开源了的插件。

学习资料

社区教程：https://deepseekdocs.com/

Github 文字教程：https://github.com/ht426/deepseek-harness-tutorial、https://zoahdev.github.io/deepseek-harness-handbook/

runboot 教程：https://www.runoob.com/deepseek-harness/deepseek-harness-tutorial.html

B站：https://www.bilibili.com/video/BV1ZRbe6eENh

总结

本文主要参考官方文档以及开源仓库 README.md 展示了从 0~1安装DeepSeek Harness，文章中所有命令都针对国内安装设置了镜像源加速，虽然当前还是v0.1.1-rc.2预览，但是基本上的功能都是有的了，真正体会到了万物的操作，从 codex 和 claude ，opencode 到 pi 再到 deepseek harness，真正就是从黑盒变白盒，从自动挡变从手动挡，为了生态肯定理念没毛病，这样更能调动全员创意，希望本文能够对 AI 小白入门有所帮助，若您有好的意见以及疑问请评论区留言或邮me。

文章目录