DeepSeek Harness 本地部署入门:插件化 Agent 框架怎么跑起来

DeepSeek Harness 本地部署教程:安装、启动、配置 API Key 与模式选择。

冷月清谈:

文章介绍了 DeepSeek Harness 的基本定位和本地部署流程。DeepSeek Harness 基于 Cordis 插件系统构建,核心思路是“一切皆插件”:框架本身负责插件加载、卸载和依赖关系管理,具体能力则由不同插件组合实现,开发者可以在不修改源码的情况下替换或扩展功能。

实操部分主要包括四步:先安装 Node.js,并通过 node --version 检查环境;再使用 npm install -g @deepseek-ai/dsh 全局安装 DSH,并用 dsh --version 验证;随后运行 dsh web 启动本地服务,默认访问地址为 http://127.0.0.1:3080;首次进入界面后,需要填写 DeepSeek 开放平台的 API Key 才能开始使用。

文章还提到,DeepSeek Harness 支持不同运行模式:极简模式适合普通编码辅助,标准模式则更适合让 Agent 操作文件、执行命令或完成更完整的开发任务。由于当前仍处于开发者预览阶段,接口和功能可能频繁变化,建议先在独立环境中试用,不要直接接入生产工作流。遇到问题可优先查看 GitHub 仓库或加入官方 Discord 社区。

怜星夜思:

1、DeepSeek Harness 这种“一切皆插件”的设计,真的会让 Agent 开发更容易吗?
2、现在 DeepSeek Harness 还在开发者预览阶段,适合拿来做实际项目吗?
3、让 Agent 操作文件、跑命令时,普通开发者最该注意哪些安全问题?
4、和 Cursor、Claude Code 这类开发工具相比,DeepSeek Harness 可能更适合什么人?

原文标题:终于来了!DeepSeek Harness 保姆级教程,本地完整部署实操

原文作者:数据派THU

原文内容

图片
本文约1000字,建议阅读5分钟

本文介绍 DeepSeek Harness,提供保姆级安装启动教程与使用提醒。


DeepSeek Harness终于来了!


据官方所说:DeepSeek Harness 基于具有时空可组合性的 Cordis 插件系统构建。Cordis 元框架只负责插件的加载与卸载以及依赖关系,Agent Harness 的所有具体组件都是不同的 Cordis 插件。插件通过 Cordis 服务与事件彼此协作,并可以在配置层自由组合。


开发者无需改动 DeepSeek Harness 的源码本身,就能以插件的方式独立选择、替换或扩展其中的任一能力。这就是 DeepSeek Harness 最重要的设计原则:一切皆插件。



这篇文章就带你把 DeepSeek Harness 跑起来。


保姆级安装与启动


第一步:环境准备

你的电脑上需要先装好 Node.js。打开终端,输入:


    node --version
    


    看到版本号就说明装好了。如果没装,去 https://nodejs.org/ 下载 LTS 版本安装即可。


    第二步:安装 DSH

    Node.js 就绪后,全局安装 DeepSeek Harness:


      npm install -g @deepseek-ai/dsh
      


      装完之后,验证一下是否成功:


        dsh --version
        


        看到版本号(当前是 0.1.0-rc.6)就说明安装完成。


        第三步:启动服务

        输入以下命令启动:


          dsh web
          


          服务会在本地启动,浏览器会自动打开 http://127.0.0.1:3080。如果没有自动跳转,手动在浏览器地址栏输入这个地址即可。



          第四步:首次配置

          第一次打开界面,会弹出一个内测声明。Harness 目前还在快速迭代,接口和功能随时可能调整,点击"继续"进入主界面。



          进入后需要配置一个 DeepSeek API Key 才能开始对话。点击配置入口,填入你从 DeepSeek 开放平台获取的 API 密钥,保存后即可使用。



          如果没有 API Key,需要先去 https://platform.deepseek.com/ 注册并创建。


          选择模式并开始对话

          配置完成后,点击左侧的"新会话"按钮,进入对话界面。新建会话时可以选择运行模式。



          如果只需要简单的编码辅助,选极简模式;如果要让 Agent 帮你操作文件、跑命令、做完整开发任务,选标准模式。



          选择模式后,在输入框里输入你的需求,就能开始和 DeepSeek 的 Agent 对话了。


          写在最后


          DSH 现在还是开发者预览阶段,破坏性兼容变更会很频繁。如果你打算用它做正经项目,建议先在一个独立环境里试用,不要直接接进生产工作流。


          另外,由于它刚发布不久,社区插件和文档还在积累中。遇到问题时,优先去 https://github.com/deepseek-ai/deepseek-harness 查看,或者加入官方 Discord 社区求助。


          编辑:于腾凯

          校对:林亦霖



          关于我们

          数据派THU作为数据科学类公众号,背靠清华大学大数据研究中心,分享前沿数据科学与大数据技术创新研究动态、持续传播数据科学知识,努力建设数据人才聚集平台、打造中国大数据最强集团军。



          拿它和 Cursor 比,我感觉 Cursor 是“你直接来写代码”,Harness 更像“你来搭一个会写代码的系统”。前者适合日常干活,后者适合喜欢改造工具链的人。两者不是完全同一类。

          1 个赞

          关于“Agent 操作文件安全吗”,我觉得 API Key 和环境变量也要小心。很多项目根目录里有 .env、密钥、数据库连接信息,如果 Agent 能读取并把内容发给模型,就可能产生泄露风险。至少要先确认它能访问哪些路径。

          1 个赞

          回答“DeepSeek Harness 更适合谁”:从文章描述看,它更偏框架和可扩展 Agent Harness,不只是一个开箱即用的 IDE 助手。所以它可能更适合想研究 Agent 架构、定制工作流、写插件的开发者,而不是只想要一个现成代码补全工具的人。

          2 个赞

          这个问题我踩过类似坑。让 AI 改代码前一定要 git commit,一定要 git commit,一定要 git commit。它写得好不好另说,至少你得有后悔药。没有版本控制就让 Agent 放飞自我,基本等于把方向盘交给刚拿驾照的朋友。

          2 个赞

          回答“Agent 跑命令的安全问题”:最重要的是权限隔离。不要让它直接操作你的主目录,更不要给它管理员权限。最好新建一个测试目录,里面放可丢弃的项目副本,命令执行也尽量在容器或虚拟环境里完成。