DeepSeek Harness 从 0 到 1:一切皆插件的开源 Agent,完整上手

6次阅读
没有评论

DeepSeek 也做 Agent 了,而且一出手就是开源。8 月 13 日开源的 DeepSeek Harness(简称 DSH),两个多月涨到 25.6 万 Star。它不是模型,而是一个开源的 Agent 框架:模型负责“想”,Harness 负责“做”——把模型接到文件、终端、浏览器和各种工具上,管理对话历史、权限确认和上下文压缩,再把结果交回来。

DeepSeek Harness 从 0 到 1:一切皆插件的开源 Agent,完整上手

它强在三点:门槛低,不用梯子、不用 API Key,DeepSeek 账号登录就能用;一切皆插件,底层用 Cordis 插件框架,模型适配器、工具注册表、会话日志、连 Agent 循环本身都能从配置替换;看得见,每一步都能在「轨迹」里回放,连塞给模型的隐藏上下文都看得到。先说一句丑话:它还是预览版,官方明确写着未来会有破坏兼容性的变更,也没做过安全审计。放心学、放心玩,别一上来就拿它碰公司核心资料。

下载、登录、第一句话

去官网下载桌面版,macOS(Apple 芯片)和 Windows(64 位)两个版本,桌面版功能和网页版一致。装好打开,点左下角头像选「登录」,浏览器里用 DeepSeek 账号确认一次就行。注意页面顶部的提醒:登录后 DSH 调用模型花的是你账号里的钱,只在官网下载的客户端上登录,别在来路不明的“魔改版”上登。

DeepSeek Harness 从 0 到 1:一切皆插件的开源 Agent,完整上手

登录后在「设置 → 账号与余额」能看到充值余额、赠金余额和「查询用量」;「设置 → 模型」里有两张卡片:DeepSeek 账号登录和填 API Key 两种方式,个人体验直接用账号登录就够了。想接其他模型点「添加模型提供商」,Anthropic、OpenAI、Kimi、GLM 都在内置列表里,中转站选「自定义模型 API」。开发者不想装桌面版,也可以在项目文件夹里跑 npx @deepseek-ai/dsh web,在 http://127.0.0.1:3080 打开网页版。

DeepSeek Harness 从 0 到 1:一切皆插件的开源 Agent,完整上手

新建会话,工作区建议单独建一个练习文件夹,别直接把整个桌面或下载文件夹交出去。先问一句最简单的「你是什么模型?」——它会回答自己是 deepseek-flash 驱动的编程智能体。注意回复下面那行「用量 9.2K tok」:问 6 个字用了 9200 多个 token,因为每次请求 DSH 都会把系统提示词、工具说明、技能目录、当前时间和工作目录一起发给模型。

用一次要花多少钱

DSH 本身免费开源,花钱的是模型调用,按 token 计费,从 DeepSeek 余额里扣,有赠送余额时优先扣赠送余额。官方价格页上两款模型的价格(每百万 token,人民币):Flash 输入缓存命中 0.02~0.04 元、未命中 1~2 元、输出 4~8 元;Pro 输入缓存命中 0.15~0.30 元、未命中 4.5~9 元、输出 13.5~27 元。每格前一个数是空闲时段价,后一个数是高峰时段价,高峰是北京时间工作日 9:00~12:00 和 14:00~18:00,其余时间半价。缓存命中指的是和之前请求重复的那部分内容,比如每次都要发的系统提示词——以 Flash 为例,命中缓存的输入比没命中便宜 50 倍。

DeepSeek Harness 从 0 到 1:一切皆插件的开源 Agent,完整上手

换算成体感:上面那句「你是什么模型?」用了 9.2K token,按 Flash 高峰价粗算大约 2 分钱;跑一个普通 demo,读几个文件、写几个文件,也就几毛钱。三个省钱习惯:日常用 Flash,材料多、步骤长的任务再切 Pro;不着急的大批量任务放到晚上或周末跑,直接半价;隔几天去「设置 → 账号与余额」点「查询用量」,看看钱花在哪。另外记住一个时间点:DSH 里使用 DeepSeek API 时触发的网页搜索和抓取目前不收费,从 2026 年 11 月 1 日起按次收费,每 1000 次成功请求 5 元。

输入框这一排,先全部翻译成人话

四种模式。标准模式处理代码、文件和资料,默认就用它;PTC 模式适合批量调用工具、筛选整理汇总一堆文件或网页;极简模式只用终端和图片读取工具,适合测模型裸能力;创造模式能让 Agent 编写插件、给 DSH 加功能,连模式本身都能让 Agent 帮你造一个。模式不是越高级越好,普通读文件、改文档,标准模式完全够用。

权限三档。「仅可查看」只读不写;「工作区内修改」是默认档,能改选中的工作区文件,敏感操作先问你;「完全权限」不受工作区限制,选它会额外弹一次风险确认。建议第一周就待在「工作区内修改」,看到删除、覆盖、批量改名、git push 这类审批时,先读清楚对象和范围再点同意。

模型与推理强度。Flash 响应快,日常整理文件、改文档、问答都用它;Pro 留给材料多、步骤长的任务。模型名右边的 High 是推理强度,有 Off、Low、High、Max 四档——改格式、换个说法这种小事 Low 就够,复杂研究、跨文件核对再开 Max。高强度不会自动修正错误,任务完成后仍然要自己核对。

计划模式、技能、定时任务、轨迹。标准模式里内置计划模式:先出方案,你通过界面上的批准动作确认后它才动手,你在对话里说一句“好的”不算批准。技能就是一份写给 AI 的工作说明书(SKILL.md),DSH 自动扫描项目/.dsh/skills、项目/.agents/skills、~/.dsh/skills、~/.agents/skills 四个位置,之前给别的 Agent 写的技能不用重装;桌面版还自带 7 个 Office 技能,覆盖 Word、Excel、PPT 的创建、编辑、校验和导出 PDF。自动化任务直接在对话里说,比如“每天 23:00 提醒我查看天气”,模型会调用内置定时工具存下来,支持 cron 表达式——但要先手动跑一次完全正确,再把它变成定时任务。轨迹是每个会话顶部的第二个标签,像行车记录仪:每一次对话的所有细节按顺序追加记录,只增不改,点开任意一条能看到概述、预览、原始内容、来源,以及每一步的耗时和 token 用量,还支持恢复会话、从某一步分叉出新会话。

插件:DSH 真正的灵魂

DSH 没有内置任何插件来源,但官方留了一个口子:实验性插件「自定义插件市场」。打开它,插件页多出一个「发现」标签页,在「管理索引源」里粘贴社区维护的开放插件市场索引地址 https://dshopen.org/index.json,就能直接浏览和安装——截图当天这个索引收录了 785 个插件。想换别的索引,在同一个地方加一个地址就行。想要更像应用商店的界面,再装一个社区插件 dshmarket,左侧栏会多出一个「插件市场」入口,截图时显示 6.3k 个插件,还会自动隐藏与当前版本不兼容的插件。市场里没有的插件,点插件页右上角「添加插件」手动装:填包名、GitHub 仓库地址或本地目录路径都行,安装源默认是「中国大陆镜像源」,国内装插件不用额外配代理。

装插件只认一条铁律:插件就是代码,装一个插件等于让一段别人写的程序用你的身份在电脑上跑,只装来源清楚、有人维护的插件。DSH 默认不装刚发布的新版本,要等它过一段观察期——万一某个插件的新版被人投毒,你不会第一时间中招。

5 个可以挑着试的插件:dshmarket(社区插件市场,搜索、查看介绍、一键安装);billion-context(长对话分层压缩,需要时还能找回之前的细节);dsh-ops(给 Windows 补 Bash、PowerShell 7 和高效文件工具,仅支持 Windows x64);dsh-free-search(支持 Bing、DuckDuckGo、SearXNG 等多个搜索后端,部分引擎不需要 API Key);DSH-better-sidebar(开放的侧边栏底座,内置文件渲染编辑、终端、侧边对话、Git 和子代理页面,装上以后 DSH 更像一个完整的开发工作台)。装插件的顺序:先把市场接上,再一个一个加,每装一个开新会话试一下,确认没问题再装下一个。

第一次开工:先跑两个任务

在练习文件夹里再建 input、output 两个子文件夹:input 放材料副本,output 放 DSH 生成的结果,原文件留在原地,出错也不会丢东西。任务一,整理一批文件:读取 input 里的所有文件,按内容主题分成 3 到 5 类,在 output 里生成一份 Markdown 清单(文件名、所属分类、一句话摘要),只读取、不移动、不改名、不删除;验收是清单里的文件数量和 input 实际文件数量一致。任务二,批量处理再汇总:切到 PTC 模式,读取 input 里所有 CSV/Excel 表格,合并到 output/汇总_v1.xlsx,保留原始数据页,新增“汇总”页按月份和类别统计数量与金额,去掉完全重复的行,无法判断的行单独放进“异常”页;验收是回复里写出原始总行数、去重后行数、异常行数和汇总金额。完成以后切到「轨迹」,从第一条看到最后一条——你会第一次清楚地看到,一个 Agent 到底是怎么“想一步、做一步”的。

还有余力的话可以进创造模式试试:让它给你加一个叫 word_count 的小工具,输入工作区内的文件路径,返回字数和行数,先让它说打算怎么实现、会新建哪些文件,等你确认后再动手。

国内用户最关心的两件事

网络:用 DeepSeek 账号或官方 API,国内直连没问题;装插件默认走中国大陆镜像源,也不用代理。只有接海外模型,或者让它联网搜索、抓海外网页时才需要代理。注意一个坑:浏览器能翻出去,不代表 DSH 能翻出去——DSH 读的是 HTTPS_PROXY 和 HTTP_PROXY 这两个环境变量,不读系统代理设置,端口换成你自己代理软件的端口,也可以写进 ~/.dsh/.env。安全上还有个细节:项目文件夹里的 .env 不能设置代理,因为别人仓库里的 .env 会跟着 git clone 一起下来,DSH 宁可拒绝启动,也不让一个陌生仓库决定你的流量往哪走。

安全:官方安全说明写得很坦白:沙箱、审批提示和权限控制可以降低风险,但不保证隔离。只给最小必要的权限和访问范围,优先在一次性虚拟机、容器或专用环境里运行,备份它能访问到的文件,不要把敏感凭据和数据暴露给它。8 月一篇 arXiv 论文专门测了 DSH 对间接提示词注入的抵抗力:14,560 次受控测试、16 种内容渠道,其中“隐藏 Unicode 字符藏在文件里”这种手法攻击成功率达到 25.5%。这不是 DSH 独有的问题,所有能读文件、能联网的 Agent 都面临同样的风险——让 Agent 读一份陌生文件、一个陌生网页之前,权限别开太大。

已经在用 Pi、Claude Code 或 Codex,怎么选

Pi 默认极简,哪里不舒服就补 Skill、写扩展,更像角色编辑器;DSH 一上来就给一套完整的架子,连 Harness 自己的核心都能替换,更像把“怎么造 Agent”整套开源了出来。Claude Code、Codex 更稳、坑更少,适合只想今天就把活干完、又能稳定用海外模型的人;想用国产模型、想看清 Agent 每一步在干什么、想自己改造 Agent,DSH 最值得花时间。已经在用 Claude Code / Codex 也不用二选一:项目里的 AGENTS.md、CLAUDE.md 和 .agents/skills 它都直接认,还能把它们俩当成 DSH 的“外包”,把独立子任务分包出去。

五级升级路线:装好桌面版,用 DeepSeek 账号登录,建练习工作区,只让它读和总结;读取副本文件,输出一个新文件,学会看轨迹;打开「自定义插件市场」接上开放插件市场,从推荐的 5 个插件里挑 1 个试试;手动跑通一次后,再建一条定时任务;单次任务稳定后,再进创造模式写插件、开子智能体、接 MCP。你今天只需要完成前两级。

相关链接:

DeepSeek Harness 官网

DeepSeek Harness GitHub 仓库

DeepSeek 官方价格页

dshmarket 社区插件市场

billion-context 长对话压缩插件

dsh-ops Windows 工具插件

dsh-free-search 多搜索后端插件

DSH-better-sidebar 侧边栏工作台插件

正文完
 0