前言¶
在使用 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；否則，它會記錄警告。
