运行有迹可循
DeepSeek Harness (harness.vin) 会话轨迹 (Trajectory) 为每个会话记录完整的 append-only 事件流:系统提示词、思维链、工具调用与结果、子 Agent 调度以及每一次上下文注入。恢复、分叉、检索与回放共享同一份事件流,让 Agent 运行透明可控、有迹可循。
轨迹记录流程
用户输入
Agent 接收用户请求,开始处理任务。事件流记录请求内容与上下文注入。
LLM 推理
大语言模型分析请求,生成执行计划。事件流记录组装后的模型请求与思维链。
工具调用
Agent 执行工具调用,如代码执行、文件操作等。事件流记录工具名称、输入参数和执行结果。
子 Agent 调度
Agent 可将工作委派给子 Agent。事件流记录每一次子 Agent 调度与上下文注入。
结果输出
Agent 完成任务,输出最终结果。整个会话可恢复、分叉、检索与回放。
核心能力
完整运行记录
每个会话都记录完整的 append-only 事件流:系统提示词、思维链、工具调用与结果、子 Agent 调度,以及每一次上下文注入都会被写入。
运行回放
支持回放 Agent 的运行过程。恢复(resume)、分叉(fork)、检索(search)与回放(replay)共享同一份事件流,定位问题更直接。
按来源检查
事件流中的每条记录都可以按来源检查:模型请求、工具调用、子 Agent 调度与上下文注入分门别类,快速定位任意一步。
会话分叉与恢复
从任意一次运行恢复或分叉出新会话,延续已有上下文继续任务,或尝试不同的执行路径。
JSONL 落盘
会话日志以未压缩 JSONL 持久化到 session 目录,包含组装后的模型请求与工具调用,便于离线分析与归档。
单一事件流
记录、恢复、分叉、检索与回放全部基于同一份事件流,不同视图之间数据始终一致。
轨迹记录示例
会话日志以未压缩 JSONL 保存到 session 目录,每一行对应事件流中的一条记录:
# 会话日志保存在 session 目录(未压缩 JSONL)
# 每一行包含组装后的模型请求与工具调用
$ cat sessions/example-001/*.jsonl
{"type":"system_prompt","content":"You are a helpful software engineer assistant."}
{"type":"llm_request","model":"deepseek-v4-flash","messages":[...]}
{"type":"tool_call","tool":"bash","input":"pytest -q"}
{"type":"tool_result","tool":"bash","output":"3 passed in 1.2s"}
{"type":"context_injection","source":"plugin","content":"..."}相关文档
常见问题
什么是 DeepSeek Harness 会话轨迹?
会话轨迹 (Trajectory) 记录每个会话完整的 append-only 事件流:系统提示词、思维链、工具调用与结果、子 Agent 调度和每一次上下文注入。
如何查看 Agent 的运行轨迹?
在 Web UI 的轨迹视图中查看事件流记录,也可直接读取 session 目录中的 JSONL 日志,其中包含组装后的模型请求与工具调用。
会话轨迹可以回放吗?
可以。恢复(resume)、分叉(fork)、检索(search)与回放(replay)共享同一份事件流。
轨迹数据存储在哪里?
会话日志以未压缩 JSONL 持久化保存到 session 目录(session_root),便于离线分析与归档。