DeepSeek Harness Agent 工作流

dsh-plugin-agent-workflow 是一个可独立安装的 DeepSeek Harness Web UI 插件。它在原有“对话”和“轨迹”之外增加“工作流”标签页，以用户对话轮次为入口，把 Agent 的模型请求、模型响应和工具调用呈现为清晰的执行链路。

插件不会替换或修改 DeepSeek Harness 内置的“轨迹”功能。

界面预览

工作流总览

左侧按用户对话轮次组织任务，右侧按时间顺序显示本轮发生的模型调用和工具调用。页面顶部汇总用户对话数、模型调用数、工具调用数和总耗时。

请求详情

点击请求卡片后，可以检查该次模型请求真实记录的系统提示词、messages[] 消息体和工具定义。三个区域均使用可折叠 JSON 树展示，并支持复制和放大查看。

主要功能

• 按轮次浏览：左侧固定显示当前 Session 的用户对话轮次，包括提示词摘要、开始时间、模型调用数、工具调用数和完成状态。
• 执行链路可视化：每次模型调用依次展示请求、响应和工具调用卡片，一行内容超出可视区域时支持横向滚动。
• 完整请求检查：请求详情分别展示真实记录的 system、提供方无关的 messages[] 和 tools，JSON 节点可以逐级展开或收起。
• 响应内容检查：展示 reasoning、content、工具调用以及当次模型响应的原始记录。
• 工具执行状态：区分运行中、完成和失败状态，并展示调用参数、执行结果、耗时和错误摘要。
• Token 与缓存统计：分别显示输入、未缓存输入、缓存读取、缓存写入和输出 Token，便于分析上下文复用情况。
• 大数据量浏览：轮次列表和模型调用列表独立滚动，模型调用行使用虚拟化渲染，长链路不会挤压整个页面。

数据来源

工作流页面由 DeepSeek Harness Session 中真实记录的事件生成。系统提示词、工具定义、响应和工具结果来自内置 Trajectory 投影；messages[] 按 DSH 与模型请求相同的 Session surface 追加、替换规则，在每次请求边界重建。

插件只读取并展示已有记录，不会向模型请求中增加消息、提示词或工具。

兼容版本

插件版本	DSH 版本
0.4.x	dsh@0.2.2-alpha.2
0.3.x	dsh@0.2.0-rc.2
0.2.x	dsh@0.1.5-alpha.1
0.1.x	dsh@0.1.0-rc.8

0.4.x 适配 dsh@0.2.2-alpha.2 的客户端接口：通过 useTrajectory 标准 hook 读取内置 Trajectory 投影，继续复用 Session 事件窗口做分页，并适配工具准备阶段新增的 args 视图字段。它不注册自己的视图目标，因此不会与 Chat、Trajectory 的生命周期交错。

从插件 0.3.x 升级时，安装 0.4.x 并重启 Web UI。0.2.x 升级到 0.3.x 时同样需要重启 Web UI，以加载支持工具准备阶段的宿主与客户端代码。

DeepSeek Harness 仍处于预发布阶段，不同 RC 版本的客户端接口可能发生变化。升级 DSH 后，需要同时安装与新版本适配的插件版本。

安装

安装本地 .tgz 包

假设安装包位于当前目录：

npx --yes @deepseek-ai/dsh@0.2.2-alpha.2 plugin \
  --profile web \
  add ./dsh-plugin-agent-workflow-0.4.0.tgz

检查安装结果：

npx --yes @deepseek-ai/dsh@0.2.2-alpha.2 plugin \
  --profile web \
  list --depth 0

列表中出现 dsh-plugin-agent-workflow 0.4.0 表示安装成功。重启 Web UI 后即可看到“工作流”标签页：

npx --yes @deepseek-ai/dsh@0.2.2-alpha.2 web

从源码构建安装

pnpm 11 默认阻止 Git 依赖执行构建脚本（ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），因此推荐从源码构建安装包：

git clone https://github.com/flynow-harness/dsh-plugin-agent-workflow.git
cd dsh-plugin-agent-workflow
pnpm install
pnpm pack

然后把生成的 dsh-plugin-agent-workflow-0.4.0.tgz 安装到目标 profile：

dsh plugin --profile web add ./dsh-plugin-agent-workflow-0.4.0.tgz

其他 profile（示例为 video）使用相同插件版本：

dsh plugin --profile video add ./dsh-plugin-agent-workflow-0.4.0.tgz
pnpm dsh --profile video

直接安装 github: 写法需要包管理器允许该 Git 依赖执行构建脚本（pnpm-workspace.yaml 的 allowBuilds 需按解析后的 tarball 地址逐条声明）。只有在你信任源码时才应放行。

卸载

npx --yes @deepseek-ai/dsh@0.2.2-alpha.2 plugin \
  --profile web \
  remove dsh-plugin-agent-workflow \

卸载后重启 DSH Web。该操作只移除独立的“工作流”插件，不会影响内置的“轨迹”标签页。

安装到本地 DSH 源码目录

在已经安装依赖并构建好的 DSH 0.2.2-alpha.2 源码目录中执行（替换安装包的绝对路径）：

pnpm dsh plugin --profile web add /absolute/path/dsh-plugin-agent-workflow-0.4.0.tgz
pnpm dsh plugin --profile web list --depth 0
pnpm dsh web

插件由该源码目录的 CLI 安装到 Web profile，并自动加入 dsh.profile.bundles；无需修改 DSH 的内置插件源码。

本地开发与打包

需要 Node.js ^22.19.0 或 >=24.0.0，以及 pnpm 11。

pnpm install
pnpm run typecheck
pnpm test
pnpm pack

pnpm test 会先构建宿主入口和浏览器插件包。pnpm pack 生成可直接安装的 dsh-plugin-agent-workflow-<version>.tgz 文件。

已知限制

• 汇总数据只覆盖客户端能够加载的 Session 历史；无法取得的更早事件不会计入统计。
• JSON 展开状态和卡片选中状态保存在当前页面中，不提供可分享的深链接。
• 同一次响应中的多个工具调用以可横向滚动的线性序列展示，不绘制并行分支图。

致谢与许可

• 本项目基于 xuanyuanzhifeng/dsh-plugin-agent-workflow（MIT）适配 dsh@0.2.2-alpha.2，由 flynow-harness 维护。
• 原始版权声明保留在 LICENSE 中；修改与适配内容同样以 MIT 许可发布。

License

MIT