前言¶
在使用 DeepSeek Harness (DSH) 和 Maestro 插件栈时，开发者需要处理工具调用、成本分析和系统健康状态。虽然存在通用解决方案，但针对 Maestro 特定工作流的本地、轻量级工具通常更受青睐。dsh-maestro-observe 提供了一种基于 SQLite 的本地存储方案来处理这些问题。
插件信息¶
- 名称：dsh-maestro-observe
- 核心价值：Local-first observability for the Maestro plugin stack: trace, cost, and health capture + client dashboard.
- 维护者：ddtcorex
- 分类：客户端
- Stars：1
- 许可证：MIT
安装与启用¶
使用官方命令安装：
dsh plugin add @ddtcorex/dsh-maestro-observe
核心能力¶
该插件将信号（追踪、健康、成本）记录到本地 SQLite 存储，并通过命令行工具和 RPC 端点暴露它们。
- 本地存储：信号存储在
~/.dsh/dsh-maestro-observe/observe.sqlite。 - 追踪：
trace命令支持limit、sessionId、tool、kind、since参数。 - 成本：
cost命令支持按天或会话范围查询，并支持groupBy。 - 错误：
errors命令按工具分组错误。 - 延迟：
latency命令提供count、p50、p95、p99指标。 - 健康：
health命令报告插件、工具计数和状态。 - 预算：
budget命令用于设置和检查令牌限制。 - 配置：
config命令用于获取和设置操作参数。 - 状态 RPC：
/dsh-maestro-observe端点提供运行时间、版本、ring size 和行数。
可选功能包括通过 maestroNotifier 进行 Telegram 摘要和峰值警报。
典型用法¶
trace { limit?, sessionId?, tool?, kind?, since? }cost { scope: 'day'|'session', sessionId?, day?, groupBy?: 'tool'|'session' }budget { action: 'set'|'check', scope, key, limit_tokens? }config { action: 'get'|'set', key, value? }errors { tool?, since? }latency { tool?, since? }health {}
注意事项¶
- 运行时：插件以当前 DSH 进程的权限运行。安装前请检查源码和许可证。
- 依赖项：需要 Node.js ^22.19.0 || >=24.0.0 和
@deepseek-ai/cordis(~4.0.4)。 - UI：没有内置的客户端 UI；渲染发生在
dsh-maestro-dashboard中。 - 隐私：追踪详情中的敏感信息在持久化前会被脱敏。
- Telegram：摘要调度为本地时间（HH:MM）。要发送警报，需要
@ddtcorex/dsh-maestro-notifier；否则，它会记录警告。
