前言¶
DeepSeek Harness（DSH）的“軌跡”回答過去發生了什麼，而運行時的狀態變化需要通過“透視”來查看。dsh-runtime-xray 是 DeepSeek Harness 的只讀運行時檢查插件。它不會修改配置、重載插件、執行命令或向模型增加工具，而是通過查看當前真正生效的運行時底座、會話能力、模型輸入和生命週期資源，解決開發者需要實時掌握 Agent 狀態的問題。
插件簡介¶
dsh-runtime-xray 是 DeepSeek Harness 的只讀運行時 X-Ray，由 hollis-openlab 維護。它遵循 MIT 許可證。
透視頁按一條清晰的運行鏈組織信息：運行時底座 → Skill / 工具 → 模型上下文。服務屬於 Host 內部運行底座，不會被誤認爲模型輸入。
核心功能¶
插件提供以下能力：
- 分層導航：概覽、運行時底座、會話能力和模型輸入按運行層級瀏覽。
- 當前會話：查看當前會話實際可用的服務、Skill、工具、模型上下文和模型路由。
- 整個應用：檢查所有會話共享的插件、服務與生命週期資源。
- 作用域繼承：展示“整個應用 → 預設 → 當前會話”的覆蓋順序。
- 模型輸入：統計系統指令段、運行時上下文、變量，並按 Harness、工具、應用、部署、Plan、UI 分組。
- 插件—服務網絡：展示所有者關係（實線）和來自明確
ctx.provide標籤的推斷關係（虛線）。 - 生命週期資源：按服務註冊、子插件掛載、定時器、監聽器和其他資源聚合，展開後可查看來源和深度。
- 服務詞典：顯示原生 DSH 服務的用戶化名稱和中英文作用氣泡；未知服務保留原始 key 並使用安全兜底。
- 證據等級：區分精確、推斷、不可用；不會把猜測僞裝成事實。
- 故障隔離：一個檢查域失敗時，其他域仍然可用。
- 重新讀取：手動採集一次當前狀態；頁面關閉時不會後臺輪詢。
- 下載診斷文件：下載當前畫面的脫敏 JSON；文件大小上限爲 1 MiB。
- 中英雙語：跟隨 DSH Web 的語言設置實時切換，無需重載插件。
安裝與啓用¶
使用以下命令安裝插件並啓動 Web profile：
dsh plugin --profile web add "github:hollis-openlab/dsh-runtime-xray#main"
dsh --profile web
重啓 Web profile 後，在「對話」和「軌跡」旁邊會出現「透視」。
典型用法¶
- 打開一個會話，點擊“透視”。
- 選擇“當前會話”，沿着運行時底座、會話能力和模型輸入查看當前會話。
- 打開“Skill”查看有效 Skill 目錄；再打開“工具”查看模型可調用動作。
- 打開“模型上下文”，按數據類型和來源分組檢查模型輸入。
- 選擇“整個應用”，檢查插件—服務網絡和聚合後的生命週期資源。
- 需要確認熱更新後的狀態時，點擊“重新讀取”。
- 需要提交問題證據時，點擊“下載診斷文件”下載脫敏 JSON。
適用場景與注意事項¶
插件只讀取當前 DSH 進程公開提供的運行時信息，不會連接任何外部服務，也不需要自己的 API Key、環境變量或可寫數據目錄。
默認快照和診斷文件不會包含：
* 憑據和環境變量值；
* 提示詞正文和運行時上下文正文；
* 變量值、審批載荷和工具結果；
* 可調用對象或任意插件配置；
* 原始會話和運行時實體標識。
導出標識會在單個文件內一致地匿名化。診斷文件的大小上限爲 1 MiB。
結語¶
dsh-runtime-xray 提供了從運行時底座到模型輸入的完整視圖，幫助開發者在調試和排查問題時快速定位狀態。若需瞭解更多或獲取源碼，可訪問 DSH 生態目錄 或 GitHub 倉庫。
