[分享创造] 给 Claude Code 做了个本地桌面工作台,对接官方 OTLP / hooks

·

最近一直在重度用 Claude Code ,边用边有一个挺强烈的感受:

Claude Code 本身已经很强了,但围绕它的很多能力还是比较散。

一部分信息在终端里,一部分配置在本地,一部分要自己翻文件,一部分干脆没有一个顺手的入口。尤其是当你开始高频使用之后,很多问题会变得越来越具体:

  • 今天到底用了多少?
  • 钱花在哪些模型、哪些 session 上?
  • 哪些工具调用最频繁,成功率怎么样?
  • cache 到底有没有帮我省 token / 省钱?
  • 哪些 session 特别重,过两天怎么快速复盘?
  • usage 怎么查得更方便一点?
  • skills / marketplace / 插件这些东西能不能别全靠手动折腾?
  • Claude Code 的 hook 事件能不能直接给桌面通知?

所以我做了个本地桌面应用,叫 Lumo 。

先说我觉得最重要的点,也是我自己比较在意、和别的工具差异最大的点:

Lumo 是 OTLP 采集,而不是去读 Claude Code 生成的本地 json 文件,也不是解析终端输出

它走的是 Claude Code 官方支持的监控链路:

  • OTLP logs
  • OTLP metrics
  • hooks

也就是 Claude Code 原生就支持的 telemetry / hook 能力。Lumo 在本地起一个 daemon ,接收这些官方事件,然后写入本地 SQLite ,再由桌面应用把它展示出来。

所以它的数据采集方式不是“旁路扒数据”,而是直接接官方暴露出来的观测入口。

这一点我觉得很关键。

因为如果只是去扫本地 json ,或者解析 CLI 输出,短期内当然也能做出一些统计,但问题是这种方式天然会有几个麻烦:

  • 数据结构依赖实现细节,容易变
  • 很多信息拿不到,或者只能靠猜
  • 后面想扩展成更完整的工作台会比较别扭
  • 稳定性和可信度都一般

而直接走官方 telemetry / hooks ,事情就会顺很多:

  • 数据来源更正
  • 粒度更细
  • 扩展能力更自然
  • 接入方式也更正规

对我来说,这个点甚至比 UI 漂不漂亮更重要。

目前 Lumo 做的事情,大概可以分成几块。

  1. Usage
    可以直接查 Claude 官方 usage ,包括当前额度、weekly limits 、extra usage 这些。
    这个能力看起来不花哨,但实际挺高频。尤其是你开始认真控制使用成本的时候,会反复看。

  2. Sessions
    可以按项目看 Claude Code 的 session ,进详情后能看到会话内容、工具调用、工具结果、失败情况、涉及文件这些。
    如果你平时 session 很长,过两天想回头看当时到底发生了什么,这一块会比直接翻原始记录舒服很多。

  3. Overview / Tools / Performance
    这一块是分析面板,能看:

cost
token
session 数
代码改动
模型分布
tool 调用频次
tool 成功率
平均耗时
cache hit rate
error rate
peak hours
session length 分布

我自己做这块,不是为了“做点图表”,而是因为 Claude Code 用久了之后,很多优化问题其实都落在这里:
到底是模型选得不对,还是 session 习惯有问题,还是某些工具特别耗时,还是 cache 根本没起作用。

  1. Skills
    可以直接管理 Claude Code 的 skills ,包括全局和项目级的。
    这个能力做进去之后,至少不用老在目录和配置之间来回跳了。

  2. Marketplace / Plugin
    可以加 source 、同步 marketplace 、安装和卸载 plugin 。
    这部分我自己日常会用到,所以也放进来了。相比手动处理,桌面端统一管理还是顺手很多。

  3. 桌面通知
    Claude Code 的 hook 事件可以接到 Lumo ,然后走系统桌面通知。
    对我自己来说这个很实用,有些状态变化没必要一直盯着终端看。

  4. Wrapped
    这个算是顺手做的,用来做阶段性总结和分享还挺合适。

划重点,整个链路是 本地优先 的:

  • 不需要账号
  • 没有云端 dashboard
  • 没有第三方 analytics
  • 数据默认都在本机

Lumo 现在还在持续迭代,但至少目前已经把我自己最常用、最想收拢的几块做进来了。

项目地址:
https://github.com/zhnd/lumo

如果你也在高频用 Claude Code ,欢迎试试。

也欢迎直接提意见,尤其是这几类我会比较关注:

你最想看的 Claude Code 指标是什么

你更在意:
usage / 成本,还是 tools / 效率 / session 复盘
除了现在这些,你觉得 Claude Code 还缺什么桌面侧能力

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *