夜雨聆风如果你一直用 Codex、Claude Code 或“模型 + CC Switch”的组合，DeepSeek Harness 可能会让你重新理解 Agent 工具。
它不是简单换一个聊天界面，也不是把 DeepSeek API 接到另一个客户端里。
它把模型、工具、文件系统、Shell、会话、工作流、子 Agent，甚至 Agent Loop 都拆成了可以替换和组合的插件。
普通 Agent 是“官方给你一套固定配置”。DeepSeek Harness 更像一台毛坯工作台：你可以先按默认方式使用，也可以继续加工具、换模式，甚至让 Agent 帮你组装一个新的 Agent。
这篇不只讲安装，而是从下载、四种模式、插件扩展到第一次实战，一次看懂它为什么值得关注。
DeepSeek Harness 是什么
可以把 Agent 拆成两部分理解：
模型负责思考，Harness 负责让模型进入真实环境。
普通聊天模型给出一段回答后，任务基本就结束了。
Harness 则可以把模型连接到文件系统、终端、工作区和插件，让它按照计划连续完成多个步骤。
比如，下面这句话交给普通聊天框，通常只能得到建议：
帮我整理这个项目，并找出最需要修改的地方。
交给 Harness 后，Agent 可以进一步：
- 查看项目目录；
- 读取指定文件；
- 总结模块关系；
- 列出风险和修改计划；
- 在获得确认后编辑文件；
- 运行测试并返回结果。
它和 Codex、Claude Code、WorkBuddy 的使用场景有重叠，但 DeepSeek Harness 更强调可组合的插件体系。模型、工具、界面、存储和运行方式，都可以按需要替换或扩展。
官方安装：4 行就够了
官方 GitHub README 给出的路径很直接：安装 Node.js，执行一条命令，打开本地地址，再配置 API Key。
官方仓库：https://github.com/deepseek-ai/deepseek-harness
Node.js 下载：https://nodejs.org/en/download/
npx @deepseek-ai/dsh web启动后打开：
http://127.0.0.1:3080进入页面后，在模型设置中填入 DeepSeek API Key 即可。
API 平台：https://platform.deepseek.com/
如果不想配置 Node.js，可以尝试社区桌面版，但它不是 DeepSeek 官方桌面客户端：
DeepSeek Harness Desktop Releases
安装就按官方 README 来
不要把安装过程搞复杂。官方推荐的就是：安装 Node.js，运行 npx @deepseek-ai/dsh web，打开 http://127.0.0.1:3080，再配置 API Key。
安装完成后，直接进入下面的“四种模式”和插件部分，这才是 Harness 与普通客户端拉开差异的地方。
第一次使用：先做一个可验收任务
安装成功不代表已经会用。
很多人打开 Agent 后，第一句话就写：
帮我把这个项目做好。
这个任务范围太大，Agent 不知道什么算完成，也不知道哪些文件可以修改。
第一次实践建议选择“能看见结果、风险较低、可以撤回”的任务。
实践一：读取项目并生成结构说明
请分析当前工作区的目录结构。要求：1. 只读取文件，不修改任何内容；2. 说明每个主要目录和文件的用途；3. 找出项目的入口文件、配置文件和依赖文件；4. 输出一份适合新手阅读的 Markdown 说明；5. 如果无法确认，请标记“待确认”，不要猜测。先给出你的分析计划，确认后再生成说明文档。这个任务可以观察 Agent 是否会先盘点、是否能引用文件内容，以及是否会在没有授权时擅自写入。
实践二：让它检查表格
如果你平时做跨境电商、运营或办公，可以放入一份脱敏后的 CSV 或 Excel 导出文件：
请读取 sample-data.csv，只做数据检查，不修改原文件。输出：1. 字段和数据类型；2. 时间范围；3. 空值、重复值和格式异常；4. 可以直接计算的指标；5. 不能从当前数据得出的结论。所有发现都要给出对应的行号或字段名。不要把空值当成 0，不要把相关性写成因果，也不要生成任何对外发送内容。实践三：让它生成一个小网页
确认前两个只读任务正常后，再尝试生成文件：
请在当前测试工作区创建一个简单的 HTML 页面，用于展示 sample-data.csv 中的字段说明和异常统计。要求：1. 不修改原始 CSV；2. 先列出执行计划和准备创建的文件；3. 等我确认后再写入；4. 页面完成后在本地运行检查；5. 返回创建的文件、检查结果和仍需人工确认的问题。这一步可以看到 Harness 与普通聊天工具的区别：它不只是生成代码，还要进入工作区创建文件、运行检查，并把执行过程展示出来。
Harness 的几个常用模式
知识库中的最新实践把四种模式讲得很清楚：它们不是四个换皮按钮，而是四套不同的 Agent 能力组合。选错模式，往往比模型选错还影响体验。
标准模式
标准模式是一套功能完整的通用编码 Agent，包含文件编辑、Shell、网页检索、Skills、计划、目标、子 Agent 和工作流。适合读代码、改 Bug、生成网页、处理本地资料和运行测试。第一次使用，直接选它。
极简模式
极简模式只提供较少的工具，减少 Harness 对模型的干预。适合修改一个明确文件、测试模型原始能力，或排查问题究竟来自模型还是复杂工具链。
创造模式
创造模式拥有标准模式的能力，还增加运行时检查、插件实验和 Agent preset 创作能力。它甚至可以让 Agent 查看自身运行时，并尝试组装一个新的 Agent。这个模式适合高级用户，不建议第一次就让它修改主工作区。
请在微信客户端打开
PTC 或自动化模式
PTC 可以理解为 Programmatic Tool Calling。它让模型先写一段程序，再一次性完成批量读取、筛选、比较和汇总。处理几十个文件、连续调用多个工具，或者需要循环和并行操作时，PTC 往往比标准模式更合适。
一句话选择：日常任务用标准，批量数据用 PTC，小任务排错用极简，改装 Agent 才用创造。模式名称和可用功能可能随着项目版本变化，具体以当前界面和 README 为准。
插件怎么玩，先从“补一项能力”开始
DeepSeek Harness 的特点之一是插件化。文件浏览、视觉能力、侧边栏、主题、任务看板和远程控制，都可以通过插件扩展。
但插件不是越多越好。
第一次安装插件，建议按这个顺序：
- 先确认插件来源和权限；
- 阅读 README 和安装命令；
- 在测试工作区安装；
- 记录新增了哪些工具；
- 用一个可撤回任务验证；
- 确认稳定后再迁移到常用环境。
如果已经安装全局 dsh，可以尝试插件市场：
dsh plugin --profile web add dshmarket使用 npx 启动的用户，也可以执行：
npx @deepseek-ai/dsh plugin --profile web add dshmarket完成后重新启动 Web UI：
npx @deepseek-ai/dsh web也可以让 Harness 帮你设计插件，但要求它先输出方案，不要直接写入运行时：
我想增加一个“文件浏览与 Markdown 预览”能力。请先研究当前项目的插件结构，输出：1. 需要修改或新增的文件；2. 插件的输入和输出；3. 需要的权限；4. 对现有功能的影响；5. 回滚方式；6. 测试清单。不要直接修改源码，等我确认方案后再开始。这才是插件化的正确起点：先理解运行时，再增加能力。
最新社区玩法：图片识别和手机远程
8 月 18 日的社区实践还展示了 dsh-web-ui 这类插件集合。它不是重新开发一个 Agent，而是通过 Profile 和 Plugin 机制给 Harness 增加任务看板、文件差异、SSH、图片识别、手机远程和皮肤中心。
其中有两个能力比较值得关注：
图片识别
通过额外的视觉模型插件，Harness 可以接收截图、商品图或界面图片，把图片内容转成文字描述，再交给 DeepSeek Agent 继续分析。
这对截图排错、UI 检查、OCR 和跨境电商商品图分析比较实用。但它不是 Harness 默认就有的能力，需要额外配置视觉模型。
手机远程
通过社区插件和安全组网方案，可以用手机查看 Agent 任务、继续对话或检查长任务进度。
远程控制不要直接把本地 3080 端口暴露到公网。应使用认证、最小权限和安全组网，先在局域网或测试环境验证。
常见问题和排查方式
1. 浏览器打不开本地地址
先检查启动 Harness 的终端是否还在运行，再确认地址是否完整复制。不要只复制 localhost，端口号也要保留。
2. 页面能打开但模型不回复
重点检查 API Key、模型名称、接口地址和账户余额或额度。桌面版只是把工作台启动起来，不会自动提供免费模型调用。
3. Agent 修改了不想改的文件
立刻停止任务，查看会话轨迹和文件差异。重要项目要使用 Git 或提前复制工作区。第一次测试时，尽量使用独立目录，不要直接指向主资料库。
4. 安装插件后界面异常
记录插件名称、版本、安装时间和错误信息。优先卸载最近安装的插件，或者恢复到上一个可用版本，不要连续安装多个插件后再排查。
5. 想让它直接执行高风险命令
不建议。删除、覆盖、发送、改权限、写入生产系统和涉及隐私数据的操作，都应该设置人工确认。
安全边界一定要记住
DeepSeek Harness 能够进入本地工作区，所以它的能力越强，权限管理越重要。
至少保留这几条规则：
- 不把 API Key 写入代码、笔记和公开仓库；
- 不在没有备份的情况下让 Agent 改重要项目；
- 给它最小工作区，不要一次开放整个硬盘；
- 高风险命令要求确认；
- 先看计划，再允许执行；
- 任务结束后检查文件差异和会话记录；
- 早期版本只用于测试，不要直接承担生产任务。
本地运行不代表绝对安全。它只是让数据和执行环境更靠近自己的电脑，仍然需要管理模型服务、密钥、插件和文件权限。
适合哪些人
DeepSeek Harness 更适合：
- 想体验 Agent 编程，但不想先研究复杂框架的人；
- 经常处理本地 Markdown、表格、代码或资料库的人；
- 想把重复办公动作交给 AI 的运营、内容和电商从业者；
- 愿意尝试插件化和本地工作流的开发者。
如果只是想聊天，直接使用 DeepSeek 网页版会更轻量。
如果希望 AI 读取文件、执行任务、调用工具并留下过程记录，Harness 才有明显价值。