DeepSeek Harness 从 0 到 1详细拆解
本文详细拆解了DeepSeek Harness,一个开源的Agent执行框架。作者通过本地测试验证了其文件写入、Shell执行、权限拦截和会话轨迹功能,并指出当前版本更适合Agent开发者而非普通用户。文章对比了DeepSeek Harness与WorkBuddy、Codex的差异,分析了其插件化设计、权限控制和在企业落地中的不足,最后给出了适用人群建议。
本文详细拆解了DeepSeek Harness,一个开源的Agent执行框架。作者通过本地测试验证了其文件写入、Shell执行、权限拦截和会话轨迹功能,并指出当前版本更适合Agent开发者而非普通用户。文章对比了DeepSeek Harness与WorkBuddy、Codex的差异,分析了其插件化设计、权限控制和在企业落地中的不足,最后给出了适用人群建议。
文章对DeepSeek Harness进行了详细的技术拆解,包含本地运行步骤、权限测试、插件架构分析,并对比了WorkBuddy和Codex,信息密度高且时效性极强,但实用性因面向开发者而略有局限。
本文是一篇面向小白的 DeepSeek Harness(DSH)完整上手教程。作者介绍了 DSH 的核心特点:门槛低(DeepSeek 账号登录即用)、一切皆插件(连 Agent 循环都可替换,社区插件超 6000 个)、过程可回放(轨迹功能)。文章详细讲解了下载安装、登录方式(账号与 API Key 两种)、界面各功能入口(模式、权限、模型、推理强度等)的含义,并分析了计费方式与省钱技巧,同时提醒它仍是预览版,未经过安全审计,需注意数据安全。后续还将涵盖插件市场、原理拆解、实战练习及与 Pi、Claude Code、Codex 的对比。
文章介绍了作者开发的三个围绕 Harness 的 Skill:star-your-harness 用于从零搭建个人 Agent 工作台,通过四个问题生成目录骨架;better-your-harness 用于诊断已有文件夹,从安全隐私、上下文质量、工具装备、记忆学习五层扫描并生成 HTML 报告;view-your-harness 用于可视化展示项目文件和 Skill 调用情况。作者认为 Harness 是模型之外让模型能干活的整套结构,搭建个人 Harness 能让工作在不同 Agent 间无缝衔接。
文章系统解释了 AI 领域中 harness(套件/执行框架)的概念。作者指出 LLM 默认只能生成文本,要真正执行操作需要工具、调用语法、解析系统、结果回传和工具清单,这一切组成了 harness。文中区分了界面(如 Claude Code 的 TUI/GUI)与底层 harness(如 Anthropic Agent SDK、Codex App Server),并用厨房比喻说明 harness 与工具的关系。文章还解释了 MCP 的作用——类似'食谱',让代码可以在外部运行,以及 agent 的定义:LLM 与 harness 的结合体。
本文译自 Earendil 的 What is a Harness?,以攀岩安全带类比 Agent Harness,面向初学者介绍其概念与工作原理。文章指出 Agent = Model + Harness,Harness 是为 AI 模型提供运行环境的软件,核心职责包括四点:提供系统提示、提供可调用的工具、构建 Agent 循环、以及作为转换层支持多种 AI 模型。作者通过比较小学排名并撰写建议邮件的示例,演示了 Agent 循环的完整流程。文章还强调开源中立 Harness(如 Pi、OpenClaw 等)能将自主权交还用户,用户可以拥有、改造自己的 Harness,自由选择模型并比较结果与成本,从而避免对 AI 实验室单一应用的依附。
剪映官方推出 Agent,走封闭全家桶路线,能力仅限软件内并售卖 AI 会员。与此相反,逸尘开源的逆向项目 jianying-headless 将剪映控制权交还外部 Agent:可用 Codex 一条指令批量粗剪、加字幕、配 BGM;借助 DeepSeek 和豆包 ASR,一小时视频成本不到一块钱;生成的是剪映原生工程文件,可随时人工微调。作者认为这是目前最自由、成本最低的视频剪辑自动化方案,并建议大家尽快 Fork 以防项目被下架(404)。该项目替代了此前用 Computer Use 模拟鼠标操作的笨办法。
作者介绍了一款 DeepSeek Harness 的 Live2D 桌宠插件 dsh-live2d-pets。该插件能在写代码时提供互动陪伴:内置 Hiyori/Haru/Mao 等 5 款模型,支持人设选择(傲娇、元气、三无、病娇等),眼睛跟随鼠标、可拖动摆放,还有 51 段动画包括发呆、打瞌睡、散步、玩魔方等互动效果。作者还将其从原平台迁移到了 Windows,支持桌面闲逛、置顶、开机自启、多实例生成。安装方式非常简单,只需复制一句指令给 Agent,通过 dsh plugin 命令即可完成安装。项目已开源在 GitHub。
文章介绍了 OpenAI 对 Codex hooks 机制的重大升级:hook 现在支持异步执行和直接调用 MCP 工具。作者将 hooks 比作'闸机',与 AGENTS.md、Skill 这类'规章制度'不同,它能在运行时真正拦截工具调用。文章详细讲解了 11 个事件类型(SessionStart、PreToolUse、PermissionRequest、PostToolUse、Stop 等)的触发时机与拦截姿势,配置文件的加载规则、异步 hook 的限制(最多 8 个并发、无法拦截)、MCP 工具 hook 的占位符机制,以及基于哈希绑定的信任机制。作者强调 hooks 是有用的护栏而非完整安全边界,真正防越权还需沙箱和权限体系配合。
文章系统介绍了 DeepSeek Harness,强调它不是单纯的模型聊天界面,而是把模型、工具、会话、沙箱、工作流、调度和 UI 都插件化的 Agent 运行框架。内容涵盖安装启动、Web UI 与远程访问的安全风险、4 种 Agent 模式的权限取舍、Trajectory 执行轨迹带来的可调试性、多模型接入降低供应商锁定、'一切皆插件'的架构理念、会话分支用于并行验证假设,以及 Dynamic Workflow 和 Agent Teams 实现多 Agent 协作的任务拆分与汇总。作者认为其价值在于让 Agent 成为可配置、可观察、可复用的执行系统,但仍处 developer preview 阶段,需谨慎对待权限与数据安全。
作者逐行阅读 OpenAI 开源的 Codex harness(rust-v0.150.1)与 DeepSeek Harness(dsh v0.1.1-rc.2)的源码,从工具调度、多智能体、上下文管理、沙箱、可观测性、模型互操作等十个维度对比两者,并设计了五个机制场景、六个组合共 150 次真实 agent 运行测试。文章揭示多个反直觉发现:Codex 多智能体更成熟但没有独立的读文件工具;Codex 只支持 Responses 协议而 dsh 兼容 chat completions;两者在上下文压缩上防的是不同故障。结果 149/150 通过,压缩场景 Codex 快约五倍。文章最后给出按使用目的的选型建议。
本文从《给宝宝的机器人学》类比切入,系统讲解 Agent 的核心概念与发展脉络:大模型只负责生成回答,而 Agent 能借助工具、API、Agent Loop 和文件/终端等真实工作现场,把任务完整做完。文章依次介绍模型、Tool 与 API、Agent Loop、computer use、MCP 协议,以及 Claude Code、Codex CLI 到 Codex 桌面端的产品演进,说明为何同一个模型放进不同 Harness 表现差异巨大。最后以实战演示如何用 Codex 搭建论文资料整理 Agent,从建立项目结构、规划执行到接入 PubMed 检索工具,展现普通人也能上手的 Agent 工作流。
DeepSeek 发布了坚持'一切皆插件'理念的 DeepSeek Harness,模型适配器、工具、文件系统、沙箱甚至 Agent Loop 都可通过插件组合。但其使用门槛偏高,界面仍处开发者预览阶段。作者基于此前 CodePilot 的经验开发了 Pilot Harness,为其加上桌面外壳和一组客户端插件:优化了项目切换、会话 Hover 卡片、输入区和设置页等交互,新增项目文件树、服务商配置等插件,并提供 macOS、Windows、Linux 三平台安装包。作者认同 Harness 拆分组件、允许重组的架构思路,认为这为 Agent 参与调整自身配置预留了接口。
本文用办公室比喻,深入浅出地介绍了 DeepSeek Harness(dsh)的概念、组成、四种模式及其与 Claude Code、Codex 的区别。文章强调模型决定 Agent 的思考上限,而 Harness 决定其执行能力。dsh 作为开放实验场,允许用户自由组合模型、工具、Skills 等组件,但开源免费不等于安全,用户需注意权限控制。最后给出小白试用建议,并指出未来 Agent 竞争的关键在于模型之外的工作环境。