第 08 章 约 6 分钟

运行可观测性

会话日志、Trajectory 视图与配置树的观测能力。

对研究人员与严肃用户而言,DeepSeek Harness 最大的吸引力之一,是它完整可观测:每一次运行都有迹可循,每一份配置都可被审查。

会话日志:仅追加设计

模型看到的一切——系统提示词、思维链、工具调用与结果、子 Agent 调度、上下文注入——都写入仅追加(append-only)设计的会话日志。同一份事件流同时支持恢复、分叉、检索与回放。

Trajectory 视图

在 Web UI 的「轨迹(Trajectory)」面板,可以按来源查看每一次运行的完整过程:系统提示词、思维链、工具调用与子 Agent 调度,逐条展开、随时回放。

  • 来源分类查看事件;
  • 回放任意历史运行;
  • 恢复或分叉某次会话继续跑;
  • 检索历史事件流。
为什么要紧

黑盒 Agent 出问题最难排查。有了完整事件流,你可以精确知道“模型到底看到了什么、调用了什么、得到了什么”,这对调试和研究都至关重要。

配置树:无特权内核

Profile + 组合包分层叠加配置,通过 --dump-config 可以查看实际启动的完整配置树,确认每个能力来自哪个插件、如何被覆盖:

# 实际配置树(含用户 patch)
dsh --profile web --dump-config

# 默认配置树(不含用户 patch)
dsh --profile web --dump-default-config

内核本身无特权,所有注册皆可逆——你可以随时卸载、替换任何插件,彻底摆脱“厂商黑盒锁定”。

面向研究

完整可观测的事件流与配置树,加上底层 Cordis 有学术论文支撑,使 DeepSeek Harness 成为面向 Agent 架构研究的开放设计。它不仅是工具,更是一个可被严谨研究的实验平台。

小结

  • 运行有迹可循:append-only 会话日志 + Trajectory 视图。
  • 配置可审查--dump-config 展示完整配置树。
  • 能力可替换:无特权内核,所有注册皆可逆。
  • 研究就绪:事件驱动设计有论文支撑。

到这里,你已经完整走完了 DeepSeek Harness 从认识 → 安装 → 上手 → 架构 → 模式 → 使用 → 插件 → 可观测的学习路径。接下来,去实践:装起来、跑一个真实任务,然后尝试用插件定制属于你自己的 Agent。