前言¶

DeepSeek Harness（DSH）自带「轨迹」页签，适合逐条查看会话事件。当一次会话出现上百个 LOOP、数百次工具调用时，开发者更常问的是：哪一轮最慢、首字延迟多少、这一轮模型拿到了哪些上下文和工具、某次工具失败是否经过重试、缓存命中率如何。这些问题需要带时间维度和聚合的视图，而不是只在事件列表里翻页。

下面介绍社区插件 LOOPScope（dsh-loopscope），它只读消费当前会话的 durable event window，在 Web GUI 右侧栏用图表回答上述问题，不改动 Host、不上报、不新增 RPC。

这是什么¶

LOOPScope 是 maintainer hanranCode 维护的 DSH 工作流类插件（npm 包名 dsh-loopscope，当前 README 对应版本 0.1.0，许可证 MIT）。定位是：把 DSH 会话的执行轨迹变成可交互图表——「LOOP 循环卡片 + 瀑布耗时 + Token 账本 + 工具调用明细」，便于看清每一轮循环里模型看到了什么、决定了什么、调用了什么、结果如何。

插件在 SkillHub 目录页：https://www.skillhub.cn/plugins/hanranCode/dsh-loopscope；源码与文档：https://github.com/hanranCode/dsh-loopscope。

核心功能¶

资料中明确列出的能力如下。

三种互补视图¶

LOOP 循环视图¶

• 相位环：上下文 → 决策 → 执行 → 观察四段，弧长按相位耗时，可点击选中。
• 卡片与 chips：对话 / 上下文 / 决策 / 执行 / 观察、工具 chips（按工具族着色）、开发信号徽标（审批、重试、工作区变更、产物、团队任务等）。
• LOOP 序列 ribbon：点击跳转；▶ 播放 约每 1.4 秒自动巡览下一个 LOOP。

汇总与明细¶

汇总卡包括活跃时长、轮次/步数、工具调用与失败数、Token 入/出、平均首字延迟与生成耗时、缓存命中率等。决策与上下文明细覆盖请求路由、上下文窗口占用、首字延迟、tok/s、工具参数与结果、错误码等。

数据与运行时¶

插件通过注入的 sessions 服务的 eventSource 只读当前会话事件，不读文件、不发网络请求、不写存储。浏览器产物仅 require React 平台模块，无额外 Host RPC。中英文与明暗主题跟随 DSH GUI（ctx.locale、--dsw-alias-*）。

安装与启用¶

环境要求¶

• DeepSeek Harness >=0.2.0 <0.3.0（Web GUI，dsh.client 平台 web）。
• 从源码构建需 Node.js >= 20；通过 GitHub 安装时仓库已提交 lib/，无需本地构建。

安装¶

方式 A：插件管理器（推荐）

让 DSH agent 调用 plugin_manager 的 install_bundle，target 传下列之一：

dsh-loopscope                      # npm 发布后
github:hanranCode/dsh-loopscope    # 或直接从 GitHub 安装（lib/ 已提交，无需构建）
/absolute/path/to/dsh-loopscope    # 或从本地 checkout 安装（link:）

方式 B：CLI

dsh plugin --profile web add github:hanranCode/dsh-loopscope
dsh --profile web

从本地 checkout 安装（README 原文示例）：

git clone https://github.com/hanranCode/dsh-loopscope.git
dsh plugin --profile web add /absolute/path/to/dsh-loopscope

卸载：

dsh plugin --profile web remove dsh-loopscope

安装后若标题栏没有出现按钮，先刷新页面（客户端 bundle 需重新拉取）。仍无效时，检查 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 是否包含 dsh-loopscope，并查看 dsh web 启动日志是否有加载错误。

典型用法¶

经过上面的步骤安装并启动 Web profile 后：

1. 打开任意已有消息的会话（新会话或尚未产生 step 的会话会显示「暂无轨迹事件」）。
2. 点击会话标题栏右侧的 「轨迹图表」（也可从右侧栏引导页或页签「+」打开）。
3. 在工具栏切换 时长条 / 时间轴 / 循环。
4. 在 LOOP 视图中点击相位环或 chips 查看对话、上下文、决策、执行、观察明细；点击工具 chip 查看参数与结果；需要聚焦某工具问题时，可在「执行」相位明细中继续点击进入单工具页。
5. 历史窗口只覆盖最近一段事件时，使用 「加载更早历史」 扩展可见范围。

适用场景与注意¶

适合谁：在 DSH Web GUI 里开发或调试 agent 工作流、需要性能热点（P90 时长条、瀑布图）与行为归因（每 LOOP 上下文与工具）的开发者。

权限与安全：插件随当前 DSH 进程在 Host 侧加载，并以 Web 客户端面板展示会话内已有事件；安装前建议阅读仓库源码与 MIT 许可证。README 说明插件不接触凭据、不写文件；事件文本以 React 文本节点渲染。

兼容性：现代 Chromium（与 DSH Web GUI 一致）；长会话（200+ LOOP）设计上为同步 O(n) 折叠，面板不自动轮询 Host。

生态说明：DSH 采用「一切皆插件」的扩展方式；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

LOOPScope 在 DSH 自带轨迹列表之上，补上了时长条、时间轴与 LOOP 卡片三种聚合视图，便于在长会话里定位慢轮次、Token 与工具调用细节。需要安装命令与事件映射表时，以 GitHub README 为准。

• 目录页：https://www.skillhub.cn/plugins/hanranCode/dsh-loopscope
• 仓库：https://github.com/hanranCode/dsh-loopscope