前言¶
做 DSH Web 客戶端長會話時，經常要同時看當前會話的 Token 用量、上下文壓力、全部歷史消息，以及當前工作區裏的文件。這些信息分散在會話、日誌和工作區裏，查起來不方便。
下面介紹 dsh-workspace-inspector。它是一個 DeepSeek Harness (DSH) Web 客戶端右側面板插件，把當前會話 Token 用量、全部歷史消息目錄、上下文壓力和工作區文件樹集中展示在右側詳情列中。它跨平臺支持 macOS / Windows / Linux。
這是什麼¶
先說定位：dsh-workspace-inspector 是 DSH Web 客戶端插件，由 GIGHT111 維護，許可證爲 MIT。
它解決的問題是：在同一個會話裏，快速覈對會話級 Token、上下文狀態、歷史消息位置，以及工作區文件狀態。經過上面的描述，可以看到它的價值集中在“右側面板彙總查看”，而不是替代對話主流程。
核心功能¶
Token 用量¶
在右側詳情列展示當前會話 Token 用量，包括輸入、緩存讀取、輸出及各自佔比。這些數據來自 tokenUsage 投影。
全部歷史消息目錄¶
展示全部歷史消息目錄。目錄由 host 重放會話持久化日誌重建，支持摺疊展開，並顯示摘要與工具調用次數。
點擊條目會跳轉到對應消息行並高亮。消息目錄摘要爲啓發式文本提煉，非 LLM 生成。如果目標消息行尚未在對話視圖中加載，會提示先加載更早歷史。
上下文壓力¶
展示上下文壓力，包括下一次請求預計 token 數、上下文窗口容量與佔用百分比。這些數據來自 contextPressure 投影。
工作區文件樹¶
展示工作區文件樹：以當前會話工作區爲根，目錄懶加載，可展開/摺疊，文件顯示大小。
點擊文件會用系統默認應用打開。面板支持隱藏文件開關與刷新。
右側列開關¶
支持關閉和重新打開右側列。使用 ✕ 關閉後，可通過會話頭部「📊 概覽」按鈕重新打開，並恢復原生拖拽分欄調整大小。
該插件以更低 priority 遮蔽默認右側 DetailsPanel，並在會話存在時自動打開；卸載後恢復原狀。
安裝與啓用¶
先確認環境已安裝 dsh，並且 pnpm 在 PATH 中。再執行下面的 GitHub 安裝命令：
dsh plugin --profile web add github:GIGHT111/dsh-workspace-inspector
安裝後需要重啓 web profile 才能激活：
dsh --profile web
典型用法¶
本地路徑安裝¶
如果已有本地插件目錄，可以使用本地路徑安裝：
dsh plugin --profile web add /path/to/dsh-workspace-inspector
tgz 包安裝¶
如果使用打包文件，可以執行：
dsh plugin --profile web add /path/to/dsh-workspace-inspector-0.1.0.tgz
構建與測試¶
修改插件代碼後，需要重新構建並刷新頁面；如果 manifest 或行結構變更，需要再次重啓 web profile。
構建與測試命令如下：
npm install && npm run typecheck && npm run build && npm run test:host && npm run test:client
配置目錄條目上限¶
可以在 profile 的 cordis.patch.yml 中配置 workspace-inspector.config.maxEntriesPerDir，用於限制單層目錄最多返回條目數。示例值爲 1000：
- id: workspace-inspector
config:
maxEntriesPerDir: 1000
適用場景與注意¶
適合需要長期跟蹤 DSH Web 會話上下文、消息歷史和工作區文件的開發者。
安裝前應檢查源碼與 MIT 許可證。該插件以當前 dsh 進程權限運行，並涉及工作區文件讀取、文件打開和 localhost HTTP 路由，因此只建議在可信環境中使用。
需要注意以下邊界：
1、文件樹路由僅限 host cwd 或已註冊 workspace 根之下的絕對路徑；Windows 下大小寫不敏感。
2、文件樹經 localhost HTTP 路由讀取，list/open 路由均使用 Cache-Control: no-store。
3、資料提醒：請勿在不可信網絡環境中暴露 3080 端口。
4、消息目錄跳轉依賴對話視圖已加載對應消息行；未加載時會提示先加載更早歷史。
5、修改代碼後，需要重新構建並刷新頁面；manifest 或行結構變更時，需要再次重啓。
結尾¶
dsh-workspace-inspector 把當前會話 Token 用量、上下文壓力、全部歷史消息目錄和工作區文件樹集中到 DSH Web 客戶端右側面板，適合在長會話和工作區操作中快速覈對狀態。
相關鏈接來自安裝命令與倉庫標識，可用於查找目錄頁和倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/GIGHT111/dsh-workspace-inspector
- GitHub 倉庫：https://github.com/GIGHT111/dsh-workspace-inspector
