VibeMeter

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

🇨🇳 中文 · 🇺🇸 English

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

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

✨ 三件事，一款 VibeMeter

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

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

📸 关键界面

VCTI 人格	实时活动（含 Notch）
数据	分享

🧬 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 编程工具及其提供商无隶属或背书关系。