一個原生的 dsh web 外掛程式，把 DeepSeek Harness 的 Agent 會話變成可檢視的執行迷宮——迷宮時間軸、資料軌道、確定性失敗分析、多會話對比與重播，且日誌資料不出瀏覽器。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-08-30
授權條款
MIT
01它能幫你完成什麼？
把 DeepSeek Harness 的 Agent 會話變成可檢視的執行迷宮
同一根時間軸上畫清主幹路徑、失敗支路與資料軌道（工具密度、Token 脈衝、上下文壓力），並給出確定性的失敗復原分析
想看清 Agent 真實幹活過程的 dsh 使用者與開發者——主幹路徑、失敗支路、重試與復原一目瞭然
對比同一任務的多輪跑法，並回放會話看清它如何一步步走到結果
2~5 次跑的同軸對比（輪次對齊、支路盤點、手動錨點），以及最高 300× 重播整場執行
跨模型對比行為、或複盤一場長會話到底怎麼走到結果的工程師與評估者
02如何將外掛接入 DeepSeek Harness？
先決條件
- 已安裝官方 dsh 宿主——README 已對 0.1.0-rc.6 與 rc.8 驗證，peer 範圍涵蓋 rc.6 到目前 rc 線
- 若從原始碼安裝需 Node.js 工具鏈與 pnpm（`corepack enable && pnpm install && pnpm build`）
安裝步驟
- 01
全域安裝宿主：`npm install --global @deepseek-ai/dsh@0.1.0-rc.8`
$ npm install --global @deepseek-ai/dsh@0.1.0-rc.8
- 02
新增外掛程式：`dsh plugin --profile web add dsh-maze`
$ dsh plugin --profile web add dsh-maze
- 03
啟動宿主：`dsh web`
$ dsh web
驗證整合成功
- 重启 `dsh web` 后，侧边栏底部出现「执行迷宫」入口，每个会话视图多一个「实时迷宫」页签。
03DSH 整合程度與能力邊界
透過 `dsh plugin --profile web add dsh-maze` 以第一級身份安裝為 dsh web 外掛程式；在宿主側邊欄注入「執行迷宮」入口，並為每個會話視圖新增「即時迷宮」頁籤。
迷宮時間軸視覺化
DSH 會話事件流（.jsonl / .jsonl.zstd）→同一時間軸上的主幹路徑、失敗支路與資料軌道（工具密度、Token 脈衝、上下文壓力）
失敗復原與執行分析
已判定的工具呼叫與 verdict→失敗復原鏈、工具結果矩陣、耗時分布散點，以及 Agent 關係圖譜
多會話對比與回放
同一任務的 2~5 次跑→同軸對比（輪次對齊、支路盤點、手動錨點），以及最高 300× 重播
注入 dsh web 的執行迷宮 UI
執行中的 dsh web 宿主→側邊欄「執行迷宮」入口，外加每個會話視圖的「即時迷宮」頁籤
在 dsh web 側邊欄注入「執行迷宮」入口，並為每個會話視圖新增「即時迷宮」頁籤
04適合誰？何時不該用？
適合
- 想看清 Agent 真實幹活過程的 dsh 使用者與開發者——主幹路徑、失敗支路、重試與復原一目瞭然
- 跨模型對比行為、或複盤一場長會話到底怎麼走到結果的工程師與評估者
不適合
- 依賴官方 dsh 宿主的 rc 線：README 已對 0.1.0-rc.6 與 rc.8 驗證（peer 範圍涵蓋 rc.6 到目前 rc 線），並隨每個新 rc 複驗；宿主版本不被支援時外掛程式無法正確載入。
- 上游 master 的宿主 0.1.2 重新拆分了客戶端包、並換掉了會話快照的資料模型，兩條線的外掛程式不通用。1.1.x 線（npm 安裝路徑）與 2.x 線（宿主 0.1.2）相互獨立，選錯線外掛程式將無法工作。
05相容性、維護與安全提醒
- 依賴官方 dsh 宿主的 rc 線：README 已對 0.1.0-rc.6 與 rc.8 驗證（peer 範圍涵蓋 rc.6 到目前 rc 線），並隨每個新 rc 複驗；宿主版本不被支援時外掛程式無法正確載入。
- 上游 master 的宿主 0.1.2 重新拆分了客戶端包、並換掉了會話快照的資料模型，兩條線的外掛程式不通用。1.1.x 線（npm 安裝路徑）與 2.x 線（宿主 0.1.2）相互獨立，選錯線外掛程式將無法工作。
MIT · 活躍維護中（最新版本 v1.1.0，2026-08-26）
06常見問題
要怎麼替 DeepSeek Harness 安裝 dsh-maze？
先安裝官方 dsh 宿主（例如 `npm install --global @deepseek-ai/dsh@0.1.0-rc.8`），再執行 `dsh plugin --profile web add dsh-maze`，用 `dsh web` 啟動。重啟後側邊欄出現「執行迷宮」入口，每個會話多出「即時迷宮」頁籤。
dsh-maze 支援哪些 session 日誌格式？
依照檔案內容辨識格式（檔名任意）。支援純文字 `.jsonl`（session v0 事件流）與 `~/.dsh/sessions/` 下的原生 `.jsonl.zstd`，都在瀏覽器端解壓。
dsh-maze 會把我的 session 日誌傳出去嗎？
不會。上傳 / 視覺化頁面是一份自包含 HTML，執行於沙箱化 iframe 裡；解析與渲染全部在瀏覽器端完成，上傳的日誌內容不會到達宿主。
支援哪些 dsh 宿主版本？
已對官方 0.1.0-rc.6 與 rc.8 驗證（peer 範圍涵蓋 rc.6 到目前 rc 線），並隨每個新 rc 複驗。另有 2.x 線追蹤上游宿主 0.1.2 的拆包，用 `dsh plugin --profile web add dsh-maze@2.0.0-alpha.2` 安裝。
07相關的 DSH 工作流程
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座，支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/側邊對話/Git/子代理頁面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公眾號收錄的 TUI 補位外掛：Claude Code 風，鯨魚頂欄/即時狀態/流式思考/雙擊 Esc 回滾/上下文進度+TPS。npm 一鍵裝。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
openpets
作者 alvinunreal
本地優先的桌面陪伴平臺，提供動效寵物、外掛 SDK 與編碼智慧體整合。
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的互動式終端 UI 外掛：自研 ANSI 極簡互動渲染、流式 Markdown/工具卡、16+ 主題、slash 命令與選擇器、輸入歷史與本地偏好持久化、LSP 診斷、memory記憶，很絲滑的開發體驗。
08資料與來源
dsh plugin --profile web add dsh-maze
重启 `dsh web` 后，侧边栏底部出现「执行迷宫」入口，每个会话视图多一个「实时迷宫」页签。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-30。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。