dsh-plugin-agent-workflow README

The project's README from github.com/xuanyuanzhifeng/dsh-plugin-agent-workflow. As one markdown file: README.md.

DeepSeek Harness Agent 工作流

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

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

界面预览

工作流总览

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

工作流总览

请求详情

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

模型请求详情

主要功能

数据来源

工作流页面由 DeepSeek Harness Session 中真实记录的事件生成。系统提示词、消息、工具定义、响应和工具结果都来自对应模型调用的会话记录,不会从 Harness 源码中推测或重新拼接。

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

兼容版本

当前 0.1.x 版本仅适配:

[email protected]

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

安装

安装本地 .tgz 包

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

npx --yes @deepseek-ai/[email protected] plugin \
  --profile web \
  add ./dsh-plugin-agent-workflow-0.1.1.tgz \
  --workspace-root

检查安装结果:

npx --yes @deepseek-ai/[email protected] plugin \
  --profile web \
  list --depth 0

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

npx --yes @deepseek-ai/[email protected] web

从 GitHub 安装

仓库发布 v0.1.1 标签后,可以直接安装固定版本:

npx --yes @deepseek-ai/[email protected] plugin \
  --profile web \
  add github:xuanyuanzhifeng/dsh-plugin-agent-workflow#v0.1.1 \
  --workspace-root

固定 Release 标签或 commit 可以避免安装内容随分支变化。只有在信任源码的情况下,才应允许包管理器执行 Git 依赖的构建脚本。

卸载

npx --yes @deepseek-ai/[email protected] plugin \
  --profile web \
  remove dsh-plugin-agent-workflow \
  --workspace-root

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

本地开发与打包

需要 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 文件。

已知限制

License

MIT

dsh-plugin-agent-workflow (xuanyuanzhifeng/dsh-plugin-agent-workflow)

Searching Database…

What is this?It is a web UI plugin for DeepSeek Harness (DSH) that adds a new 'Workflow' tab, turning each user conversation turn into a clear execution chain of the agent's model requests, model responses, and tool calls.
Does it replace the built-in Trajectory tab?No, it sits alongside the existing 'Conversation' and 'Trajectory' tabs as a separate add-on and does not replace or modify DSH's built-in trajectory feature.
Does it work with any version of DeepSeek Harness?No, the current 0.1.x release only targets a specific DSH build, and since DSH is still in pre-release, RC client interfaces can change, so you need to install a matching plugin version after upgrading DSH.
What are its known limitations?Summary stats only cover session history the client can actually load, JSON panel/card expand state isn't shareable via deep link, and multiple tool calls from one response show as a scrollable linear list rather than a parallel branch diagram.
Does the plugin send extra data to the model?No — it is read-only. It only displays events already recorded in the DSH session and never injects extra messages, prompts, or tools into a model request.
What exactly can I inspect in a request card?Clicking a request card opens the real recorded system prompt, the provider-agnostic messages[] array, and tool definitions, each rendered as a collapsible, copyable JSON tree.
What token stats does the workflow view show?Each model call breaks down input, uncached input, cache-read, cache-write, and output tokens, which helps you analyze how much context is being reused.
Size
1 MB
Stars
255
Updated
CommitOct 12
Age
2mo
Commits · 90 Days