内容提要
DeepSeek Harness 安装使用指南:可通过源码、npx命令或第三方桌面端安装,也可让Codex/WorkBuddy自动部署。支持多模态输入、插件系统(如皮肤、PPT制作)和轨迹追踪。卸载简单,删除相关文件即可。核心亮点是降低命令行门槛,让AI代理处理繁琐操作。
延伸解读
安装门槛与替代方案
DeepSeek Harness 官方提供源码安装和 npx 命令两种方式,但源码安装需要熟悉 Git 和命令行,对普通用户不友好。更简单的途径是使用 npx @deepseek-ai/dsh web 快速启动,前提是电脑已安装 Node.js。如果仍遇到困难,可尝试社区开发的第三方桌面客户端,如 Anywhere Lab 的版本,它提供了类似微信的一键安装体验,并内置插件市场。此外,还可以借助 Codex 或 WorkBuddy 等 AI 代理自动完成部署,只需将 GitHub 仓库链接发给它们即可。
多模态支持的限制
DeepSeek Harness 在 0820 更新中增强了多模态支持,但实际使用时需注意:当前默认的 DeepSeek-V4-Pro 模型并不支持图片输入,因此即使 Harness 能接收图片,模型也无法处理。只有支持视觉的模型才能使用多模态功能。此外,旧版本在多轮对话中发送多张图片或大图可能导致请求崩溃,更新后已改善,但若模型被标记为仅文本,则仍无法使用。
插件生态与自定义
插件是 DeepSeek Harness 的核心亮点,基于 Cordis 内核,模型、工具、技能等能力均可由插件提供。用户可通过对话或命令安装插件,例如皮肤插件市场提供了 189 种皮肤,还有 PPT 制作、记忆增强等插件。自定义插件也不难,例如可以要求 DSH 修改界面背景,或根据推理等级调整 UI。安装插件后,记得切换到创造模式以获得更好效果。
卸载与数据清理
卸载 DeepSeek Harness 相对简单:若通过 npx 快速体验,关闭终端或结束进程即可,无需额外卸载命令;若从源码安装,删除项目文件夹即可;第三方客户端则像普通应用一样卸载。若想彻底清除数据,可删除 ~/.dsh 目录,其中包含会话、配置和凭据。也可以让 WorkBuddy 或 Codex 帮忙执行卸载操作。
Q&A
DeepSeek Harness 有哪些安装方法?
DeepSeek Harness 可以通过源码安装(git clone 后执行 pnpm install 等)、使用 npx 命令快速启动(npx @deepseek-ai/dsh web)、安装第三方桌面客户端(如 Anywhere Lab 开发的),或者让 Codex/WorkBuddy 自动部署。
如何用 npx 快速启动 DeepSeek Harness?
先安装 Node.js,然后在命令行输入 npx @deepseek-ai/dsh web,启动后浏览器访问 http://127.0.0.1:3080 即可。
DeepSeek Harness 支持多模态输入吗?
DeepSeek Harness 在 0820 更新中增强了多模态支持,/goal、/plan 等命令可接收图文输入,@ 菜单支持引用文件和会话。但当前默认的 DeepSeek-V4-Pro 模型不支持图片输入,因此默认组合下无法直接读取图片。
如何安装 DeepSeek Harness 的插件?
可以通过终端命令安装,例如 dsh plugin --profile web add github:csyangwen/dsh-memory-evolve,也可以直接在对话中发送插件链接让 DeepSeek Harness 安装,比如发送“帮我安装一下这个 Skill https://github.com/hugohe3/ppt-master/blob/main/skills/ppt-master/SKILL.md”。
DeepSeek Harness 的插件系统有什么特点?
DeepSeek Harness 基于 Cordis 内核,插件系统是其最大亮点。Cordis 内核只负责插件的加载、卸载和依赖关系,模型、工具、技能、会话、沙箱、存储、UI 等所有 Agent 能力都可以由插件提供。用户可以通过插件自定义 UI、开发游戏、实现代码审查等。
如何卸载 DeepSeek Harness?
卸载方法取决于安装方式:如果是通过 npx 启动,关闭终端或结束进程即可;如果是源码安装,删除本地 deepseek-harness 文件夹;如果是第三方桌面客户端,从系统卸载。另外,删除 ~/.dsh 目录可以清除会话、配置和凭据。也可以让 WorkBuddy/Codex 帮忙卸载。
DeepSeek Harness 的“轨迹”页面有什么作用?
“轨迹”页面清晰呈现了调用了哪些工具、助手的回复、上下文注入以及 Token 的使用情况,方便用户追踪任务执行过程。
DeepSeek Harness 有哪些皮肤插件?
皮肤市场提供了 189 个皮肤插件,例如深海女仆工坊、回到 2005 的广告门户网站、海洋皮肤、滑动变祖、便签等。