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。