前言¶

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