DeepSeek Harness

DeepSeek Harness

第 09 讲约 6 分钟阅读官方讲义 ↗

用 Session、事件与插件理解 Agent 运行环境和可恢复状态。

阅读目标与前置知识3 项目标
  • 区分 Session 事件与界面呈现
  • 说明不同输入时机的影响
  • 分析插件协作需要保留的状态

建议先读 第 8 讲

HarnessSessionGenUI插件
本章关联演示让失败成为下一步的输入。

一个很小的程序已经能把模型调用和工具执行串成循环。把它变成可恢复、可扩展、多端协作的产品,难点会转移到状态、插件契约和失败恢复。本讲以讲义中的 DeepSeek Harness(dsh)为例,讨论怎样以少量共同抽象组织这些能力。

一、从最小 Agent 到长期运行的系统

最小循环接收输入,组装上下文,让模型决定回答或调用工具,再把工具结果送回模型。它适合解释基本机制。只要工作跨越一次进程运行,其他问题就会出现。

需求变化 原来哪个假设失效 系统需要表达什么
执行一半进程退出 状态始终留在内存 持久会话、进度与可恢复边界
手机和桌面共同处理一项工作 一次只有一个交互入口 共享会话、冲突处理和同步状态
用户希望添加专用工具或界面 核心程序知道所有能力 工具注册、组件装配、插件生命周期
工具已经对外执行但结果没保存 重试整步没有额外影响 外部动作的身份、完成证据与恢复策略
模型窗口放不下完整历史 保存历史等于把它全部发给模型 可持久化的记录与可重建的上下文投影

第二个条件经常改变第一个问题。一个命令行助手可以通过读日志恢复,移动端和桌面同时编辑时还要知道哪个入口先提交了什么。针对需求变化,可以检查当前架构究竟在哪一层固定了旧假设。

二、架构的交换以 MapReduce 为例

MapReduce 要求开发者按映射、键分组和归约组织计算。统计网页访问量时,映射阶段为每条日志生成一个 URL 与计数,系统按 URL 汇在一起,归约阶段计算总数。框架用固定的表达换来任务分发、数据搬运和故障处理。若需要持续更新窗口结果并处理迟到事件,有限批次的前提变化了,流处理还要面对事件时间、水位线、输入读到哪里以及算子状态如何共同恢复。

这类对照能用来审视插件化。统一扩展接口限制了组件随意调用彼此内部状态,也让加载、装配和替换有章可循。接口选得合适时,不同产品可以共享基础能力。超出接口能表达的场景,则会迫使插件绕路或者促使核心抽象演化。

三、dsh 的共同抽象

对象 承担的职责 典型问题
Cordis 服务解析、依赖激活、作用域、注册的清理 工具服务由谁提供,插件什么时候可用,退出时如何移除监听
Session 保存已发生的事件,为不同用途提供投影依据 哪个工具完成了,当前消息怎样重建,任务状态从哪里来
Agent 接收输入、组装上下文、驱动模型与工具执行 这条消息启动新任务,还是补充正在做的事
Slots 给界面预留扩展位置 一个插件怎样贡献按钮、卡片或面板

模型适配、会话日志、工具与默认执行循环都可以采取插件方式组织。核心提供少数共同接口,插件保存本地状态和业务知识。作用域负责约定注册如何生效与清理。文件修改或邮件发送等外部结果仍要由对应能力管理。

3.1 同一份事件怎样变成几种视图

讲义将 Session 抽象成有序事件序列。假设用户提交了一项任务,模型调用检索工具,检索返回结果,模型最终生成报告。事件记录这几步发生了什么。聊天界面可把工具结果显示成卡片,任务面板可计算当前进度,模型上下文可以选取有用的信息组装成消息。三种投影可以使用同一份事实,独立按用途决定保留多少细节。

在讲义所示接口中,session.append(type, data) 追加事件,session/event 提供观察机会,session.deriveMessages() 从历史构造模型消息,业务插件可注册自己的投影。会话历史接纳事件与事件已经持久写入可能发生在不同时点。恢复逻辑要以持久化证据为准。

3.2 三种输入表达的是三种执行意图

讲义中的入口 适合表达 行为边界
agent.followup(message) 用户提交后续任务 排入新的执行轮次并唤醒
agent.inject(message) 插件获得补充信息 等后来组装上下文时使用,单独调用不会启动空闲 Agent
agent.steer(message) 用户要求正在进行的工作改变方向 在最近合适的执行点消费,空闲时也可唤醒

当前工具动作可能已执行。中途改变方向时,系统需要保留已经生效的结果,再让后续工作按新要求推进。动态上下文可按需读取当前应用状态,例如打开文件和选区,避免在插件加载时保存一份很快过期的描述。

四、插件组合要把顺序和冲突说清楚

插件 A 改写输入,插件 B 校验输入。先校验再改写,可能让实际发出的输入绕过校验。先改写再校验,则需要定义插件 A 可以修改哪些信息,B 失败后应怎样报告。可以把阶段命名成「规范化 → 验证 → 执行」并为每段约定输入输出,从而确定规则在哪里生效。

同样,多个压缩插件各自减少一半信息,叠加后可能丢掉任务的关键证据。讲义用这个思想实验说明组合效应。选择插件阶段和优先级之前,应先回答谁拥有某项事实、哪处是唯一修改入口、失败如何传播,以及卸载后要清理哪些注册。跨插件场景的测试需要观察最终状态和中间决策。

五、把 Agent 接进已有应用

Excalidraw 案例从用户选中的图形开始。插件锁定选区及绑定文本,把选区序列化为 JSON 交给会话。模型通过 replace_selection 提交替换内容,应用检查改动范围并暂存。成功以后应用结果,失败或取消时解锁并保留原选区。选区之外仍可继续编辑。

阶段 应用保存什么 需要验证什么
选择与锁定 选区标识、绑定对象、开始时的版本 锁住的对象正好对应用户授权的范围
模型处理 足以表达选区的序列化对象 模型得到的内容和当前选区相符
提议替换 待提交的新对象 内容结构合法,变更未越界
完成或退出 结果或明确失败状态 成功只提交一次,超时能继续编辑原选区

另一个方向是 GenUI。界面组件能把用户操作和当前状态送回同一个会话,模型再提供响应。棋盘示例中,程序可以负责轮次和合法走子,模型负责选择或解释策略。图表、任务面板与参数表也可以用类似方式,让明确操作和自然语言共享状态。

六、设计一个可恢复插件的案例练习

设想阅读插件在用户选定资料后生成可回查的摘录。建议先约定三个事实事件,如路径选择、读取完成与摘录保存。聊天界面展示段落,侧边栏跟踪任务进度,模型只接收当前需要的片段。随后分别模拟重复启动、读取失败和插件卸载。对每种情况说明事件会留下什么、哪个视图能恢复、哪一步需要检查外部文件状态。这个练习可以把第 6、7 讲的事件思想和第 8 讲的验证流程连在一起。

第 9 讲官方讲义

停一下,解释给自己听。

为什么只保存最后一条回答,不足以恢复一次复杂任务?

展开答案要点

最后回答可能丢失工具输入输出、决策依据、执行状态和中间制品。恢复需要与执行语义相匹配的事件与持久状态。

为这次阅读留下一个标记。

已读由你决定,不代表自动评估掌握程度。

学习记录,留在这里。

阅读位置、已读章节和实验清单保存在当前浏览器。更换浏览器或清理站点数据后,这些记录不会同步。

0 / 12 讲已标记为已读

Search the course
输入关键词,或从下方开始。
试试 暂存区、CQRS、不变量Esc 关闭 · Tab 选择结果