vibemeter

VibeMeter

Agent 在做什么，一眼就知道。
追踪你的 Agent，发现你的 AI 编程人格。

🇨🇳 中文 · 🇺🇸 English

VibeMeter 把实时状态、长期数据和 VCTI 人格装进一款本机优先的 macOS 应用。Claude Code、Codex 与 DeepSeek Harness 正在思考、读取、调用工具，还是等你处理，Notch 会及时告诉你；会话、Token、成本、模型、工具与 Skill 使用留在本机，逐渐形成可回看、可分享的数据。证据足够后，24 种 VCTI 人格会给你一份真正属于自己的协作画像。

它不接管 Agent，不替你批准权限，也不改写源码仓库。读不到的数据会明确标注，不用漂亮的 0 掩盖缺失。

0.6.0：边缘侧栏与毛玻璃

在「设置 → 边缘侧栏」开启独立的屏幕边缘面板，可选择左侧或右侧，也适用于没有硬件 Notch 的显示器。悬停展开，移开后延迟收起；固定按钮保持展开，Escape 收起。侧栏为每个受支持的 Agent 画一个环，默认只显示本机检测到、且有额度可读的 Agent，可在「设置 → 边缘侧栏」逐项调整（没有额度的也能勾选显示）。显示订阅的剩余额度与重置时间：环形读数取该来源最紧的用量窗口，卡片按窗口列出剩余比例和重置时间。没有可读订阅的 Agent 照样有环，但明确标注读不到，不以 0 补齐；实时会话仍在 Notch 显示。

订阅额度之外，DeepSeek 与 Moonshot（Kimi）支持读取 API 密钥余额。在「设置 → API 账户」添加密钥即可，同一来源可以添加多个：卡片按账户分别列出余额、赠送与充值，并给出合计；余额没有分母也不会重置，所以不画进度条、不显示重置倒计时。密钥存入 macOS 登录钥匙串，仅在查询余额时读取，不写入数据库、日志或导出。端点与响应结构参考 CodexBar，相关 MIT 声明保留于 THIRD_PARTY_NOTICES.md。现有顶部 Notch 保留。

主窗口使用 macOS 原生毛玻璃材质，搭配半透明导航和内容层，支持浅色、深色及系统外观，并尊重系统减少动态效果与降低透明度设置。

新增 Claude Fable 5.1 和 GPT 6 Astra 的官方标准 API 价格。按每百万 token 计，输入 / 缓存读取 / 输出分别为 $10 / $0.25 / $50 和 $10 / $1 / $50。成本为标准档估算，不是订阅账单；Fast、Batch、长上下文和地区附加费未据此推断。详见价格核验记录。

侧栏交互与弹簧动画参考 CodeNotch，感谢 Vinz 的开源工作。相关 MIT 声明保留于 THIRD_PARTY_NOTICES.md。

✨ 三件事，一款 VibeMeter

• 抬眼就懂。 Notch 展示 Claude Code、Codex 与 DeepSeek Harness 的实时阶段、优先状态和最近结构化动作；菜单栏弹窗负责时间范围、Token、成本、活跃趋势与剩余额度。
• 越用越清楚。 Data 汇总会话、Token、输入/输出/缓存、时长、成本、Agent、模型、工具、Skill、活跃时间与工作事件。
• 数据变成性格。 VCTI 用本机可验证的长期行为生成 24 种 AI 编程人格，并给出维度、置信度与证据；数据不足时继续观察，不强行判型。

会话详情现在分为“过程”“上下文”“委派”和“记忆”。“委派”根据规范事件重建父子 Agent、创建、交接、恢复与汇合，提供可缩放关系图、时间轨迹、证据下钻和异常提示；证据不完整时明确显示部分记录或未记录，推断关系不会伪装成已观测。“记忆”按需加载可证明的记忆读写活动、时间轨迹和规范证据，不保存记忆正文；当前 Codex 读取仅为部分覆盖和派生证据，写入及其他来源保持不可用。“上下文”仍是只读观察面：它按已观测、估算、未记录标记覆盖状态，展示 Token 摘要、上下文组成、事件时间线，以及系统提示、工具定义、用户消息、注入上下文、Agent 回复和工具结果等分类。首次加载最近 50 条事件，可继续加载更早事件；正文只在按需读取时脱敏、限长预览，不保存完整原文。

上下文浏览器的交互方向参考了 dsh-context，感谢原作者 bowenliang123 的开源工作。VibeMeter 采用独立的数据模型与实现。

分享与设置作为工具入口。口头禅与洞察卡片并入 VCTI，对比条与会话回放在 Data。数据源暂为过渡路由（侧栏不展示），从设置打开。复盘工作区暂不进入 VibeMeter；其旧实现保留在 TokenGraph。aftervibe 仅作为旧数据库迁移兼容标识，不再出现在产品界面。

📸 关键界面

🧬 VCTI：24 种 AI 编程人格

VCTI 把协作行为分成六个环节，每个环节包含四种人格。名称负责让特征好记，最终结果仍由本机可验证的行为信号确定；证据不足时，VibeMeter 会继续收集，而不是强行判型。

起手方式派

Agent 驾驭派

质量守护派

排障修复派

交付推进派

资源策略派

⚡ 实时监看

首次完成引导时，VibeMeter 会为已安装的 Claude Code 与 Codex 自动配置本机 Hook：

• 安全合并现有 JSON / TOML 配置，不覆盖其他 Hook；
• 写入前创建带时间戳的备份；
• Hook 只把事件发送到权限为 0600 的本机 Unix socket；
• Notch 只显示 Agent、项目、阶段、状态与最近结构化动作，不显示原始 Prompt、命令或工具输出；
• Codex 阶段识别只读取会话文件中的事件类型、协作模式、工具名和时间戳，不读取或保存 Prompt、回复正文、推理正文、代码、路径与工具参数；
• 来源不在前台且进入“等待处理”或“错误”时会发静音系统通知；CLI 实例完成时也会通知，但 Codex 桌面端沿用自身通知，不重复发送；
• 设置页支持检查、修复和卸载；卸载只移除 VibeMeter 管理的条目。

DeepSeek Harness 不需要安装 Hook。VibeMeter 只读观察其本机会话事件流，提供与 Codex 同级的精确实时生命周期、历史分析、轨迹回放、来源状态与跳回入口，并且不会修改 Harness 配置或会话。

Notch 空闲时完全缩回实体刘海；有活动时，单会话在紧凑左翼显示来源图标与项目名，多会话才显示按来源统计的会话数；右翼只显示优先级最高的一项状态。点击或在实体刘海/两翼停留约 300 ms 都会展开；悬停展开后移开约 500 ms 自动收起，点击其他窗口也会收起。当前展开可临时固定，手动关闭或重启后恢复自动收起。Notch 与菜单栏可以分别关闭。不具备实体 Notch 的屏幕会诚实降级为菜单栏与主界面。Claude Code、Codex、DeepSeek Harness、Kimi Code 与 ZCode 提供精确实时生命周期；其中 DeepSeek Harness、Kimi Code 与 ZCode 只读观察本机结构化状态。Cursor、OpenClaw 与 Hermes 仅按本机可读取能力进入历史数据、回放和 VCTI。

💬 口头禅

“我的口头禅”与“Agent 的口头禅”位于 VCTI 页，并遵循同一套确定性规则：

• 中文优先保留 3–12 字的完整表达，英文保留 2–5 个词；
• “你接受……吗”一类跨任务问句会在内存中折叠为不含可变正文的句式骨架；
• 至少在多个会话重复出现才进入词云；
• 排除代码、文件路径、密钥形态、工具输出和停用词；
• 排除 Codex 附件清单、My request for Codex 等客户端自动包装文案；
• 对会话证据高度重合的包含短语去重，优先保留更完整的一条；
• 每一侧最多显示 8 条，字号只编码出现频率；
• Agent 词语底色表示主要来源 Agent，并提供颜色图例与悬浮归因；
• 有模型记录时优先归因到具体模型，否则退回 Agent；
• 当前范围数据不足时显示明确的不足状态，不用 0 冒充“没有”。

分析在本机完成。历史会话只保存派生词频；实时 Hook 原始信封默认在规范化后丢弃。只有用户主动开启诊断模式时，原始信封才会使用 macOS 钥匙串保护的密钥在本机加密保留七天，并可提前清除。长期分析只依赖规范事件与派生指标。

🔐 数据与隐私

• VibeMeter 只读扫描受支持的本机会话历史，不改写源会话或源码仓库。
• 独立数据库位于 ~/Library/Application Support/com.vibemeter.desktop/vibemeter.sqlite。
• 首次启动会优先从 aftervibe 数据库复制，其次兼容旧 TokenGraph 数据库；复制使用 SQLite 在线备份，源数据库、WAL 与 SHM 不会被修改。
• Git 证据读取默认关闭；未授权、未记录与不可用会作为不同状态展示。
• 不保存完整 diff、终端环境变量、凭据或完整模型回复。
• 分享导出统一经过 Share Guard；发现密钥或绝对路径时直接阻止导出。

完整边界见 架构、隐私模型与迁移记录。

🎨 分享

分享工作台目前公开 6 个模板：

“Catchphrases”卡片只突出一条 Agent 冠军口癖，并显示重复次数、跨会话数和模型优先归因；数据不足时保持明确状态。界面默认预览优先，画幅收成 5 个常用比例，文案/显示/指标放在折叠区；后端仍支持全部 8 种画幅。所有公开模板支持简体中文 / 英文、浅色 / 深色、PNG / SVG 与复制图片，并让预览和导出共用同一确定性渲染模型。

🧰 运行与构建

要求 macOS 14+、Node.js 22+、Rust stable 和 Xcode Command Line Tools：

npm install
npm run ci
npm run build

开发运行：

npm run dev

Tauri 产物位于：

apps/desktop/src-tauri/target/release/bundle/macos/VibeMeter.app

本地构建默认采用 ad-hoc 签名，未做 Apple notarization；实机与自动化记录见 VALIDATION.md。

发布新版本时，先同步 package.json、桌面端 package.json、Cargo.toml 与 tauri.conf.json 的版本号，再推送对应的 vX.Y.Z 标签。GitHub Actions 会先运行完整校验，然后分别构建 Apple Silicon 与 Intel 的 DMG 和 ZIP，并创建 GitHub Release。构建产物采用 ad-hoc 签名，Apple 公证仍是独立的分发步骤。

🤝 参与贡献

欢迎提交 Issue 和 Pull Request。开始前请先阅读 贡献指南 与 安全政策。测试和截图请使用合成数据，不要提交真实会话、凭据、数据库或本机构建产物。

🧭 项目边界

• Bundle ID：com.vibemeter.desktop
• 数据库：vibemeter.sqlite
• 主品牌：VibeMeter
• 技术包名：vibemeter
• 许可证：MIT

实时集成参考了 notchi 与 VibeHub 的公开产品机制，但本仓库采用独立实现，没有复制其源码。notchi 为 GPL-3.0，VibeHub 为 Apache-2.0。

VibeMeter 采用 MIT License。内置 Space Grotesk 字体遵循 SIL Open Font License 1.1。本项目与文中提到的各 AI 编程工具及其提供商无隶属或背书关系。