dsh-loghud：DeepSeek Harness 本地開發錯誤監控插件

在本地調試智能體應用時，錯誤往往散落在終端輸出或日誌文件中，難以集中管理。dsh-loghud 將這些運行時、編譯、模塊解析、構建、測試和應用啓動錯誤整理成有界、去重的錯誤卡片，集中展示在一個懸浮面板中，便於快速定位和排查。

這是什麼¶

dsh-loghud 是面向 DeepSeek Harness 的可擴展本地開發錯誤監控 Web 插件。目前由 XuXcode 維護，採用 MIT License。v0.4.0 版本支持 Go、Python、Node.js、TypeScript、Java 與 Spring 等主流技術棧。

核心功能¶

錯誤整理與去重
插件將運行時、編譯、模塊解析、構建、測試和應用啓動錯誤整理成有界、去重的錯誤卡片。使用穩定指紋合併重複錯誤，並記錄出現次數和最近發生時間。

多語言與框架支持
* Go：識別 panic/fatal、goroutine 棧、編譯、go test、go vet、模塊下載和端口占用。
* Node.js / TypeScript：識別運行時錯誤、TSxxxx 錯誤、模塊缺失、網絡連接、npm/pnpm/yarn 生命週期以及 Vite、Rollup、Webpack、Next.js 構建錯誤。
* Python：識別 3.10–3.14 Traceback、異常鏈、導入失敗、SyntaxError、asyncio 後臺異常和 pytest 測試失敗。
* Java / Spring：識別 Spring IOC、MyBatis、MySQL/數據庫、Redis、Spring MVC、Java 運行時和應用啓動錯誤。

界面與交互
* 使用活動/已解決/已忽略三個標籤頁，詳情在面板內單獨打開，返回保留篩選和滾動位置。
* 支持搜索、語言/分類篩選、JSON/Markdown 導出、可拖動和可調整尺寸的懸浮面板。
* 支持中英文界面、Harness 明暗主題變量、鍵盤操作及佈局持久化。

AI 診斷
支持按需調用 AI 診斷，並在發送前遮蓋常見密鑰和憑據。AI 解釋完全由用戶手動觸發，檢測到錯誤時插件不會自動調用模型。

安裝與啓用¶

使用官方安裝命令添加插件：

    dsh plugin --profile web add https://github.com/XuXcode/dsh-loghud/releases/download/v0.4.0/dsh-loghud-0.4.0.tgz

安裝後驗證配置：

    dsh --profile web --dump-config

檢查配置輸出中是否包含已啓用的 `dsh-loghud` patch。

在 Harness 設置 > 插件 > 插件配置中的 LogHUD 卡片修改配置。

典型用法¶

Go 演示
進入示例目錄並運行特定命令以觸發錯誤檢測：

cd examples/go-demo
go run . panic
go run . port
go build -tags loghud_compile_failure .

增量模式
使用增量模式（streaming-tool）讓 Agent 使用 loghud_run。命令通過官方 Terminal 服務運行，增量輸出會持續送入採集器。

適用場景與注意¶

適用場景
適合需要在本地開發過程中實時監控 Go、Python、Node.js、TypeScript、Java 或 Spring 項目錯誤的開發者。

注意
* 觸發方式：AI 解釋完全由用戶手動觸發，檢測到錯誤時插件不會自動調用模型。
* 功能範圍：當前 v0.4.0 不承諾生產日誌、原生程序崩潰或任意文本日誌監控。
* Shell 交互：插件不會替換或修改 Harness 原生 Shell。
* 服務依賴：缺少 Terminal 服務時只會禁用 loghud_run，缺少 LLM 路由時只會禁用 AI 診斷。
* 自動恢復：自動恢復範圍嚴格，只有同一命令族再次出現 Spring 啓動成功標記且無錯誤退出時，纔會解決此前相關的啓動錯誤。

總結¶

dsh-loghud 通過集中展示錯誤卡片和提供手動觸發的 AI 診斷，幫助開發者提升本地調試效率。更多信息請參考 GitHub。