给 Claude Code 做了个本地桌面工作台,对接官方 OTLP / hooks

8 天前
 zhnd18

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

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

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

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

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

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

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

也就是 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 这个算是顺手做的,用来做阶段性总结和分享还挺合适。

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

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

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

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

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

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

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

1141 次点击
所在节点    分享创造
13 条回复
v9912ex
8 天前
很好的项目, 已 star, 请求 x64.dmg
zhnd18
8 天前
@v9912ex 后续安排
zhnd18
8 天前
@v9912ex 已支持,欢迎下载使用: https://github.com/zhnd/lumo/releases
hitrip
8 天前
Mac Mini M4
hitrip
8 天前
没仔细读 readme ,已解决
zhnd18
7 天前
@hitrip 后续可能的话我添加证书来优化
dododook
7 天前
大佬 Claude 怎么使用安全?
zhnd18
7 天前
@dododook 当代码助手的话,不要把敏感信息直接丢进去,给 AI 的权限要控制,另外 review 好自动生成的代码,应该就没什么问题
tadashiyui
7 天前
码住,很实用
gap
7 天前
不错,设计很清爽
yzld2002
7 天前
赞,很棒的思路,比扫文件舒服多了,也放心很多
Anadem
2 天前
会支持 windows 嘛?
zhnd18
2 天前
@Anadem 已经提上计划啦,也欢迎参与项目

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1198243

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX