DeepSeek Harness 实战教程

从安装到跑通一个可复用的内容工作流

一、DeepSeek Harness 是什么

可以把 DeepSeek Harness 理解成一个可扩展的智能体运行环境。它负责连接模型、工具、工作区和插件，让智能体围绕任务读取文件、运行命令、调用工具、修改项目内容，并保留会话记录。

它不是固定的小说推文生成器，也不只是聊天界面。实际能力取决于启用的工具、插件、模型和权限设置。官方将其描述为开源 Agent Harness，底层基于 Cordis，核心架构是一切皆插件。项目目前仍处于开发者预览阶段，功能和兼容性可能变化。官方仓库 · 官方产品页

适合先验证的任务包括：阅读文件并整理摘要、按模板生成文案或报告、修改指定工作区内的文件、运行命令检查结果，以及通过插件扩展能力。

如果目标只是输入一段文字，得到一段文案，直接调用模型也能完成。Harness 更适合多步骤任务、工具协作和文件工作流。

二、准备工作

最简单的上手方式是运行官方 CLI，再通过浏览器打开 Web UI。准备：

1. 安装 Node.js 的电脑；

2. DeepSeek API 密钥；

3. 稳定的网络连接；

4. 独立的测试文件夹，用来存放输入资料和输出结果。

官方 README 的启动命令：

npx @deepseek-ai/dsh web

首次运行时，命令会下载并启动 Harness。默认 Web UI 地址：

http://127.0.0.1:3080

从源码运行则按官方仓库步骤：

git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web

普通体验先用 npx 即可；需要查看或修改源码时再从源码运行。官网也提供 macOS 和 Windows 桌面端入口，具体版本以官网为准。GitHub README · DeepSeek Harness 官网

三、启动后先做两项设置

1. 配置模型

打开 Harness，进入：

Settings → Models

在 DeepSeek 模型卡片中填入 API Key 并保存。官方文档说明，密钥是只写入的：保存后页面不会再次显示完整密钥，凭据存放在 Harness 的凭据文件中。配置保存后即可用于后续请求，无需重启服务。模型配置文档

添加第三方模型时，可以选择已有提供商；使用公司网关或自建兼容接口时，需要配置 API 地址、协议、密钥和模型名称。具体模型名称和能力以配置页面及服务端文档为准，不要照抄旧教程里的模型名。

2. 选择工作区

新开 Web UI 后，点击 Choose workspace，添加并选择专门的测试目录。新 Web UI 默认没有选定工作区；选择目录后才能开始会话。Agent 可在工作区读写文件、运行命令，具体操作受权限策略控制。Web UI 快速入门

建议新建目录：

harness-content-test/ ├── input/ │ └── story_excerpt.md └── output/

只放完成任务所需的资料。初次测试不要直接选择包含个人文件、账号数据或公司机密的目录。

四、实战案例：生成可审核的小说推广文案

以下沿用原文主题，但把任务设计为可检查、可复用的工作流：先分析素材，再生成文案，最后保存到指定目录。

第一步：准备输入素材

在 input/story_excerpt.md 中放入你有权使用的原创或授权素材。不要把整本小说、未授权付费内容或他人的大段作品投入商业化生产。

示例：

女主曾被未婚夫和闺蜜联手背叛，家族败落后离开故乡。 三年后，她以新身份回到商界，并在第一次董事会上见到了前未婚夫。

第二步：提交明确任务

新建会话后输入：

请阅读 input/story_excerpt.md，并完成以下工作：

1. 提取人物关系、核心冲突、反转点和情绪卖点。
2. 只依据文件内容写一条适合短视频/社交平台发布的推广文案。
3. 不要补写文件中没有的情节、人物身份或结局。
4. 输出结构：
   • 标题：3 个版本
   • 开头钩子：1 句
   • 正文：100—180 字
   • 结尾悬念：1 句
   • 话题标签：5 个
   • 事实核对：列出每个关键情节对应的素材依据
5. 将结果保存为 output/promo_draft.md。
6. 写入文件前先展示拟保存内容，等待我确认。

这条指令限定了素材范围、输出结构和长度，还要求给出依据，并把写文件拆成预览—确认两步。它比帮我写一篇爆款推文更容易得到可用结果。

第三步：检查执行过程

Harness 会使用当前会话可用的工具。官方快速入门说明，Agent 可以读取、编辑工作区文件，运行命令、委派工作并维护计划；需要审批的操作会根据权限策略弹出确认。Web UI 快速入门

执行过程中重点检查：

1. 是否读取了正确的输入文件；

2. 是否添加了素材中没有的情节；

3. 是否在确认之前写入或覆盖文件。

如果文案虚构了内容，补充：

请删除所有无法从 input/story_excerpt.md 找到依据的情节。 事实核对必须引用对应的原文短句；没有依据的内容标记为未提供，不要推测。

第四步：审核并保存

确认文案、依据和文件路径正确后，再允许它写入 output/promo_draft.md。

可以继续要求生成多个风格版本：

保留已核实的情节，分别改写成：

1. 情绪悬念风格；
2. 女主成长风格；
3. 反转爽感风格。

每版不超过 180 字，不能改变人物关系和事实。 保存为 output/promo_variants.md。

至此完成最小闭环：

素材文件 → 结构化分析 → 文案草稿 → 人工审核 → 保存结果

Harness 的优势在于任务不只停留在回答框里，还能围绕工作区文件继续执行。

五、如何扩展成实际工作流

方向一：团队内容初稿工具

把产品资料、授权素材或品牌规范放入独立工作区，让 Harness 生成初稿、摘要、标题候选和标签建议。最终内容由编辑审核，避免未经证实的卖点或错误信息进入发布稿。

方向二：固定格式的资料整理

可以要求它把活动资料整理为活动摘要、目标受众、宣传文案、不同渠道版本、待确认信息和来源文件清单。固定交付结构更方便团队复核和复用。

方向三：插件或程序接入

官方支持通过插件扩展工具，也提供 SDK 等开发路线。要把 Harness 接入程序或开发流程，应查官方 SDK、插件和 ACP 文档，不要依赖未经核实的通用 HTTP 路径。原文的 /api/v1/agents/{id}/invoke 只是示例写法，不能当作官方接口。插件开发文档 · Python SDK 指南

批量处理建议分阶段推进：

1. 先用 Web UI 手动跑通 5—10 条；

2. 检查输出一致性、失败率和人工审核耗时；

3. 再通过官方 SDK 或插件接入自动化流程；

4. 加入输入校验、失败重试、日志和人工复核；

5. 最后评估服务化和收费。

能批量调用不等于适合无人审核地批量发布。内容质量、版权、平台规则和 API 成本都要先验证。

六、常见问题排查

Web UI 打不开

检查启动终端是否仍在运行，并确认访问启动时显示的地址。官方默认使用本机地址 127.0.0.1:3080。若端口被占用或服务启动失败，先查看终端错误，再按当前版本 CLI 文档处理。GitHub README

输入框不可用

检查是否已经添加并选择工作区。新 Web UI 默认没有工作区，必须先选定目录。Web UI 快速入门

模型请求失败

检查 API Key、提供商、模型名称和网络连接。自定义接口还要核对 API 协议与网关支持的格式。Harness 文档列出 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 等协议选项。模型配置文档

输出格式不稳定

把要求写成明确字段、长度和禁止事项，并用多个真实样本测试。涉及事实时要求它给出素材依据；涉及业务流程时，要求它先列计划，执行后再核对文件。

七、安全边界

DeepSeek Harness 目前仍是开发者预览软件。官方安全说明指出，项目尚未经过安全审计；它可能执行模型生成的代码和命令、加载第三方插件，并访问配置中可用的文件和网络资源。沙箱、审批提示和权限设置可以降低风险，但不能保证完全隔离。官方建议采用最小权限、使用一次性虚拟机或独立环境、保留备份，并在执行前审查插件和命令。官方安全说明

初次使用时：

• 使用单独的测试目录，不要直接授权整个个人文件夹；

• 不要放入密码、私钥、客户隐私或未公开资料；

• 安装第三方插件前先检查来源和代码；

• 涉及覆盖、删除、联网发布或花费时，先要求它说明计划并等待确认；

• 发布前人工核对事实、授权和平台规范。

总结

DeepSeek Harness 的实操重点，不是先搭一个自动赚钱的小说推文机器人，而是先跑通一条可验证的任务链：配置模型、选择工作区、提供有边界的任务、检查工具执行、人工确认并保存结果。

小说推广文案可以作为练手题，但原文中的 Python 安装命令、配置样例和 API 路径不应照搬。按当前官方资料，建议从 npx @deepseek-ai/dsh web 和 Web UI 开始；具体工作流稳定后，再通过官方插件或 SDK 扩展。