你最终会得到什么
这篇教程写给从没碰过 DeepSeek Harness 的人——SEO 从业者、内容人员、小站站长,不一定是开发者。
学完你会拥有:
- 本地运行中的 DeepSeek Harness,浏览器里开着网页 UI
- 配置好的可用 API Key
- 一个连接到电脑真实文件夹的工作区
- 一个跑通的真实任务,由智能体在你的工作区内完成
- 额外收获:一条运行任务后自动退出的单行命令(无头模式),后面做自动化会用
时间: 大约 10 分钟。前置条件: 一台能上网的电脑;Node.js 的安装包含在步骤里。完成的标志: 网页 UI(http://127.0.0.1:3080)真实地回答了你的第一个提示词——不是报错。
开始之前:你需要什么
项目 | 需要? | 说明 |
|---|---|---|
Node.js 18+ | 是 | 一次性安装; |
DeepSeek API Key | 推荐 | 只有跑任务才需要,不是启动 UI 必需;可以之后再加 |
一个项目文件夹 | 推荐 | 智能体在一个文件夹(它的"工作区")里工作——选放内容、草稿或站点文件的文件夹 |
终端访问 | 是 | 你要运行一条命令 |
已有 Node.js 的话,直接跳到步骤 1。检查方法:运行 node --version——18 或更高即可。
第 1 步 — 安装并启动网页 UI
打开终端,运行这一条命令:
npx @deepseek-ai/dsh web首次运行时 npx 会下载包,启动器打印出网页 UI 的地址:
dsh web: http://127.0.0.1:3080在浏览器打开这个地址。你会看到 DeepSeek Harness 网页 UI——目前品牌文案是 Into the Unknown / Preview(驶向未知 / 预览版)——以及一个首次运行提示,说明这是个开发者预览版,插件和 API 会快速演进。点 Continue(继续)。
安装到这里就结束了。没有账户、没有许可证、没有下载页面。首次运行的提示值得读一遍:那是 DeepSeek 自己对 0.1 的定位——诚实的预览版,不是成品。
第 2 步 — 添加 API Key
UI 没有 Key 也能启动,但在连上模型之前,输入框是禁用的。点左侧边栏底部的 Settings(设置),然后点 Models(模型)。
点 DeepSeek 旁边的 Edit(编辑) 粘贴你的 Key。这个输入框永远不会显示你的 Key——保存后也只显示占位文案"Configured — enter a new value to replace(已配置——输入新值以替换)",你的 Key 始终是打码状态。
点 Apply(应用),关掉设置,模型路由立刻可用——不需要重启服务。
第 3 步 — 选择工作区
工作区就是电脑上一个智能体可以读写操作的文件夹。没选中之前,输入框保持锁定("Choose a workspace to start(选择工作区开始)")。
在侧边栏点 Add workspace(添加工作区),选任意文件夹。首次运行建议选一个里面有几个文件的文件夹——智能体有东西可读。
第 4 步 — 运行你的第一个任务
在"Describe what you want to build(描述你想构建什么)"输入框里输入任务并发送。官方文档建议从仓库摘要开始;对非开发者的首次运行,试试离你工作更近的内容。这是本教程实际运行的第一个任务,工作区里只有一个公司简介文件(about.md):
Read about.md in this workspace, then summarize the company in 3 sentences
and suggest 3 keywords the site should target for SEO.(读工作区里的 about.md,然后用 3 句话概括这家公司,并为网站建议 3 个适合做 SEO 的关键词。)
实际发生的过程(在消息流里每一步都能看到):
- 上下文注入 — 智能体加载系统提示词和技能目录
- 思考(Think) — 它规划:读文件、概括、建议关键词
- 读取 about.md — 对工作区文件发起真实工具调用
- 回答 — 三句话概括加三个关键词,每个都带理由
回答下方还带着有用的元数据:02:05 · Ran for 3s · TTFT 0.6s · 105 tok/s——总会话时长、本次运行时长、首 Token 延迟和 Token 速率。它建议的关键词(如"Portland specialty coffee roaster(波特兰精品咖啡烘焙商)""Coffee subscription Pacific Northwest(太平洋西北地区咖啡订阅)""Whole bean coffee for offices(办公用全豆咖啡)")是基于真实文件内容得出的——这就是在工作区里干活、而不是在通用聊天框里提问的全部意义。
聊天旁边的 Trajectory(轨迹) 标签显示完整会话日志——系统提示词、上下文快照、每一次工具调用。以后跑真实的 SEO/GEO 任务时,这就是 Harness 可审计的原因。
进阶路径 — 用无头模式跑一次性任务
同一个引擎不需要 UI 也能跑。这就是你以后做定时监控(本系列后面会讲)用的命令,现在跑一遍也能快速验证整个链路是否通畅:
dsh --profile headless "your task here"它启动一个配置、跑一个全新会话、打印最终回答、然后退出。本教程的真实示例:
dsh --profile headless "In one short paragraph, explain what generative engine optimization (GEO) is and why it matters for a small business website."真实输出(英文原文是 headless 会话的完整回答,下面是中文翻译):
Generative engine optimization (GEO) is the practice of structuring a
website's content so that AI-powered answer engines — like ChatGPT,
Perplexity, Google's AI Overviews — can easily find, understand, and cite
your business when people ask them questions. Where traditional SEO
optimized pages for ranked blue links, GEO optimizes for being named as a
source inside an AI-generated answer... In short, GEO is the new front door
to your business, and ignoring it means letting AI recommend everyone but
you.生成式引擎优化(GEO)是结构化网站内容、让 ChatGPT、Perplexity、Google AI Overviews 等 AI 答案引擎在你被提问时能轻松找到、理解并引用你的做法。传统 SEO 优化的是蓝色链接的排名,GEO 优化的是在 AI 生成的回答里被点名成为来源……一句话,GEO 是你业务的新大门,忽视它等于让 AI 推荐除了你以外的所有人。
一条命令、一个回答、不需要浏览器。这就是本系列自动化工作流的基础积木。
常见问题修复
现象 | 原因 | 修复 |
|---|---|---|
| 未安装 Node.js | 从 nodejs.org 安装 Node.js 18+,重启终端重试 |
端口 3080 被占用 | 其他应用(或第二个实例)占用了端口 | 换个端口: |
输入框一直锁定 / "Choose a workspace to start" | 未选择工作区 | 在侧边栏添加或选择工作区(第 3 步) |
发送时报 "API key" 错误 | Key 缺失或错误 | 设置 → 模型 → 编辑 → 粘贴 Key → 应用(第 2 步) |
第一个任务很慢 | 首次冷启动(下载插件、模型预热) | 正常——稍等;之后的任务会快很多 |
版本不匹配警告 | 开发者预览版更新频繁 |
|
无头模式提示会话创建成功但挂载失败 | 工作区路径不一致(macOS 把 | 配置工作区文件夹时使用真实路径( |
验证你的安装
- [ ]
npx @deepseek-ai/dsh web打印dsh web: http://127.0.0.1:3080且页面能打开 - [ ] 设置 → 模型 显示你的供应商带"已配置"标记
- [ ] 输入框解锁,并显示你的工作区名称
- [ ] 一个真实任务返回了基于文件内容的回答(不是报错)
- [ ]
dsh --profile headless "say OK"打印结果并退出
五项全过,你就装好并可以开工了。下一步是把 Harness 用起来:带复制即用提示词的 SEO 工作流,然后是 GEO 引用审计和自动化监控——本系列接下来的内容。
FAQ
除了 Node.js 还要装别的吗?不用。npx 负责 Harness 本身;其他一切(插件、网页 UI)首次启动时自动就绪。
没有 API Key 能运行 DeepSeek Harness 吗? UI 可以打开和浏览,但任务需要模型——在设置 → 模型里添加 DeepSeek Key(第 2 步)。
我的数据存在哪里?本地。会话和配置默认在 ~/.dsh/。工具运行在你的机器上;除非你用云插件,否则不会上传任何东西。
为什么写着 "Internal Testing Notice" 和 "Preview"? DeepSeek Harness 0.1 是开发者预览版。DeepSeek 明确警告插件和 API 会变化。现在能用——只是别在没锁版本的情况下把自动化建在它上面。
`dsh web` 和无头模式有什么区别? dsh web 启动浏览器 UI;无头模式(dsh --profile headless "任务")运行一个任务就退出。同一个引擎、同一个工作区,只是界面不同——无头模式是自动化路径。
本系列其他文章
- DeepSeek Harness 是什么?93k 星开源智能体平台入门指南
- DeepSeek Harness 做 SEO:7 个工作流 + 复制即用提示词
- DeepSeek Harness 做 GEO:如何让 ChatGPT、Perplexity 和 Google AI Overviews 引用你
- DeepSeek Harness 提示词库:35 条复制即用的 SEO & GEO 提示词(免费)
- 搭建你的第一个自动化:用 dsh 无头模式做每周 GEO & SEO 监控
- DeepSeek Harness CLI 速查表 + 新手故障排查
作者:Nathan Reed,Auspia AI 营销工作流设计师,搭建过 80+ 增长系统。Nathan 专注 AI 工作流、工具搭建,以及小团队可复用的增长系统。
