1. 项目概述你的本地AI编程效率分析专家如果你和我一样每天都在和Claude Code、Codex这类AI编程助手打交道那你肯定也遇到过这样的困惑今天到底用AI写了多少代码哪些提示词Prompt真正高效我的开发节奏是更聚焦了还是更分散了过去一周我在AI辅助编程上投入的时间到底产出了多少有价值的成果这些问题以前只能靠模糊的感觉来回答直到我遇到了Vibe-Log CLI。Vibe-Log CLI 是一个开源命令行工具它的核心使命非常明确帮你深度分析本地Claude Code和Codex的会话记录从中提取关于你开发效率和协作模式的硬核洞察并生成可视化的报告。最吸引我的一点是它的核心分析流程可以完全在你的本地机器上运行通过你本地的AI编程工具ACP来处理这意味着你的代码、对话记录等敏感数据无需离开你的电脑。它不仅仅是一个分析工具还内置了一个“Claude Code状态栏教练”能在你写提示词时实时给出策略性建议推着你把事情做完。简单来说它就像给你的AI编程工作流装上了一套“仪表盘”和“副驾驶”让你从凭感觉开发转向数据驱动的、更高效的开发。2. 核心功能深度解析与设计哲学2.1 今日站会三分钟梳理你的AI编程日报这个功能是我每天开工前必做的第一件事。运行npx vibe-log-cli后选择“今日站会”工具会快速扫描你最近的Claude Code/Codex会话并在终端里生成一份简洁的总结。这绝不仅仅是罗列会话记录而是经过本地AI分析后的结构化输出。它通常会告诉你你做了什么基于会话内容概括出你主要攻克的技术问题或开发模块。关键成果识别出已完成的代码块、解决的问题或实现的功能点。后续步骤根据未完成的对话或你提到的“TODO”给出接下来的行动建议。设计背后的考量这个功能解决了远程办公或异步协作中的一个痛点——如何快速、清晰地同步进展。传统站会可能需要你临时回忆和总结而Vibe-Log基于客观的会话数据生成的内容更具体、不易遗漏。它强制你通过AI对过去一段时间的工作进行了一次快速的复盘和结构化这种“微复盘”习惯对提升个人效率非常有帮助。2.2 本地生产力报告生成你的私人效率审计师这是Vibe-Log的基石功能。你可以选择时间范围如最近7天、本月和特定项目工具会提取相关会话数据在本地调用你的AI编程助手如Claude Code进行分析最终生成一份详细的HTML报告。报告里有什么会话概览会话数量、总时长、平均会话时长分布。活动热图一天中你在哪些时间段最活跃地使用AI编程。主题聚类AI自动将你的会话归类到不同的开发主题如“前端调试”、“API设计”、“数据库查询优化”让你看清时间花在了哪里。提示词效率分析评估你的提示词质量指出哪些提示获得了更精准、高效的代码回复。代码产出趋势结合会话中的代码块分析你的产出节奏。为什么强调“本地”在数据隐私至关重要的今天将包含可能业务逻辑和代码片段的会话数据上传到第三方服务器存在风险。Vibe-Log的本地分析模式意味着所有原始数据都在你的机器上处理只有分析后的聚合指标或经过深度脱敏的模式如果你选择同步到云端才会被分享。这种“隐私优先”的设计给了开发者极大的安全感。2.3 Claude Code 状态栏教练嵌入工作流的策略顾问这是最具创新性的功能。安装后它会在Claude Code的状态栏中集成一个实时反馈区域。每当你提交一个提示词Prompt时这个“教练”会在后台通过本地Claude Code SDK快速分析你的提示并立即在状态栏给出评分和建议。教练是如何工作的拦截与分析当你按下回车提交提示时Vibe-Log的钩子Hook会触发将提示词和当前会话的上下文如果是连续对话发送给本地分析引擎。个性评分分析引擎会评估提示词的清晰度、具体性和上下文完整性并给出一个分数如85/100。策略性反馈根据你选择的“教练人格”给出具体的改进建议或行动推动。例如Gordon人格可能会说“这个需求描述太模糊了厨师把预期的输入输出例子加进去现在就做”教练人格的妙用Gordon戈登模拟那位著名的严厉主厨。语气直接、紧迫感强适合需要鞭策、追求商业结果的时候。他会不断催促你交付关注边界情况和用户体验。Vibe-Log像一位支持你但又要求严格的高级开发伙伴。他会帮你检查MVP清单提醒你核心功能是否完成鼓励你“先交付再优化”。自定义你可以定义自己的教练风格比如专注于代码质量、测试覆盖率或架构设计。实操心得这个功能的价值在于将“提示词优化”这个后置动作变成了实时、沉浸式的体验。你不再需要事后去复习课程来改进提示词而是在每一次交互中就能获得即时反馈。我发现自己为了得到“教练”的高分会下意识地编写更清晰、更具上下文意识的提示这直接提升了与AI协作的效率和代码质量。3. 从安装到上手的完整实操指南3.1 环境准备与快速启动Vibe-Log CLI 基于 Node.js 开发因此你需要先确保本地环境符合要求。系统与依赖检查Node.js版本 16 或以上。可以通过node -v命令检查。如果未安装建议从官网或使用nvm这类版本管理工具安装。包管理器npm或yarn均可通常随 Node.js 安装。AI 编程工具你需要至少安装了Claude Code或Codex其中一款并且近期有过使用记录这样 Vibe-Log 才能找到可分析的会话数据。一分钟快速安装最快的方式是使用npx它可以直接运行 npm 包而无需全局安装。打开你的终端如 iTerm2, Windows Terminal, 或 VS Code 集成终端输入以下命令npx vibe-log-clilatest首次运行这条命令时npx会自动下载最新版本的 Vibe-Log CLI 并启动。你会看到一个交互式的命令行界面TUI引导你完成初始化设置。注意如果你计划频繁使用也可以选择全局安装以获得更快的启动速度npm install -g vibe-log-cli之后直接使用vibe-log命令即可。3.2 初始配置与核心功能设置首次运行后CLI 会引导你进行几个关键配置选择分析引擎工具会检测你本地已安装的 AI 编程工具Claude Code/Codex并让你确认用于本地分析的引擎。通常选择 Claude Code 即可因为它集成了更完善的 SDK。配置状态栏教练在 CLI 主菜单中选择 “Configure prompt coach status line”。从列表中选择你喜欢的教练人格Gordon, Vibe-Log, 或设置 Custom。关键一步工具会自动备份你 Claude Code 现有的状态栏配置如果有的话。这是一个非常贴心的设计意味着你可以零风险尝试卸载时一键恢复原状。配置完成后重启你的 Claude Code你应该就能在状态栏看到 Vibe-Log 的反馈区域了。可选启用令牌用量显示如果你也安装了ccusage这个包可以在这里选择集成让状态栏同时显示当前会话的令牌消耗估算帮助你管理上下文长度。3.3 生成你的第一份本地报告让我们来实际生成一份报告看看你过去几天的 AI 编程活动全景。在 Vibe-Log CLI 主菜单中选择 “Generate productivity report”。选择时间范围使用方向键选择例如 “Last 7 days”。工具支持灵活的范围如昨天、本周、本月或自定义日期区间。选择项目/会话接下来工具会列出在选定时间范围内检测到的所有会话。你可以用空格键勾选你感兴趣的具体会话或者直接选择 “Analyze all sessions” 进行全量分析。启动本地分析确认后CLI 会开始工作。你会看到它正在提取会话数据然后调用本地的 Claude Code 进行分析。这个过程可能会花费几分钟取决于会话的数量和大小。请确保在此期间不要关闭 Claude Code 应用。查看报告分析完成后CLI 会告知你 HTML 报告已生成并给出文件路径通常在当前目录下。直接用浏览器打开这个.html文件即可。报告解读小技巧首次查看报告时重点关注“主题聚类”和“活动热图”。前者能告诉你时间花在了哪里后者能帮你识别出最高效的工作时间段。结合两者你可以尝试把核心、复杂的工作安排在你效率最高的时段并用 AI 来辅助。3.4 可选配置云端同步与自动同步如果你希望获得跨时间维度的趋势分析比如观察自己一个月内提示词质量的进步可以使用 Vibe-Log 的可选云端同步功能。身份验证在 CLI 主菜单选择 “Cloud Sync Dashboard”然后选择 “Authenticate”。这会引导你通过 GitHub 账号进行 OAuth 授权。Vibe-Log 使用 GitHub 作为可信的身份提供商。理解隐私处理在同步前务必了解其隐私策略。Vibe-Log 的同步不是上传原始对话。它会执行一次“上下文保留的脱敏”处理移除所有代码块会被替换为标记如[CODE_BLOCK_1: javascript]、API密钥、文件路径、URL、邮箱等敏感信息。保留对话的流程、你提出的问题、AI 的解释和思路保持不变。 你可以在 CLI 中使用 “Preview sanitized data” 功能亲眼查看即将同步的数据是什么样子做到完全透明。设置自动同步钩子为了省去手动同步的麻烦可以设置自动同步。对于Claude CodeVibe-Log 提供了两个稳定的钩子SessionStart当你启动或恢复 Claude Code 工作时自动同步上一次的会话。PreCompact在 Claude Code 手动或自动压缩上下文清理历史记录之前自动同步完整会话。这个钩子非常关键能确保在上下文被清空前你的工作记录已安全同步。对于Codex自动同步功能目前是实验性的主要提供SessionStart和Stop钩子用于同步会话。配置建议对于 Claude Code 用户我强烈建议同时启用SessionStart和PreCompact钩子。前者保证了工作连续性后者则是防止数据丢失的“安全网”。4. 高级使用技巧与深度定制4.1 利用教练人格达成不同开发目标状态栏教练不仅仅是给提示词打分你可以通过有意识地选择人格来引导自己进入不同的工作状态。攻坚复杂架构时用 Gordon当你需要设计一个微服务或复杂的系统模块时Gordon 的严厉和商业聚焦能逼你思考得更周全。“用户如果每秒发送一万次请求怎么办缓存策略呢厨师别给我看半成品” 这种压力能有效避免考虑不周。日常功能开发用 Vibe-Log在实现具体的业务功能时Vibe-Log 人格就像一位靠谱的搭档。他会提醒你“OK用户登录 API 完成了但忘记密码的流程处理了吗要不要先把这部分的端点测试写了再继续” 帮助你稳步推进清单。创建自定义人格在~/.vibe-log/config.json文件中你可以定义自己的教练。例如定义一个“测试驱动开发”人格让他的反馈专注于“这个提示词生成的代码可测试性如何有没有考虑过给它写个单元测试的例子”4.2 从报告数据中提取 actionable insights生成的 HTML 报告数据很丰富但看报告不是为了欣赏图表而是为了指导行动。识别“提示词债”如果报告显示“模糊需求”或“缺乏上下文”类提示词占比很高说明你存在“提示词债”。可以每周抽 15 分钟专门回顾这些低分提示按照教练的建议重写它们并保存为模板备用。优化工作节奏观察“活动热图”。如果你发现下午 3-5 点 AI 会话非常密集但主题分散而上午 9-11 点会话少但主题集中且产出高那就说明上午是你的深度工作黄金时间。可以尝试把需要高度专注的核心编码工作安排在上午下午则用 AI 来处理调试、编写文档或重构等辅助性任务。量化项目投入通过选择特定项目生成报告你可以客观地看到在某个项目上通过 AI 辅助投入了多少时间主要解决了哪些类型的问题通过主题聚类。这在做项目复盘或时间估算时是非常有价值的数据支撑。4.3 故障排除与常见问题实录即使工具设计得再完善在实际使用中也可能遇到一些小问题。以下是我和社区遇到的一些典型情况及解决方法。问题一运行npx vibe-log-cli后提示“No sessions found”。排查思路确认路径Vibe-Log 会在默认的应用程序数据目录下寻找 Claude Code/Codex 的会话存储文件。确保你是在常用的用户账户下运行命令。确认使用工具只分析已存在的会话。请先打开 Claude Code 或 Codex进行几次对话后再运行分析。手动指定路径高级如果会话存储在非标准位置可以尝试通过环境变量指定。例如对于 Claude Code可以尝试在运行前设置CLAUDE_CODE_SESSION_DIR环境变量指向你的会话目录。根本原因绝大多数情况是工具没有在预期路径找到会话数据库文件可能是因为全新安装还未使用或者使用了便携版/自定义安装路径。问题二状态栏教练没有显示或者反馈延迟。排查步骤重启 Claude Code安装或更新教练后必须完全重启 Claude Code 才能使钩子生效。检查备份运行vibe-log-cli选择教练配置查看是否显示“已安装”。可以尝试“卸载”再“重新安装”触发配置重载。查看日志在终端中设置VIBELOG_DEBUG1环境变量后运行 Claude Code观察终端是否有相关的错误日志输出。这能帮助定位是配置错误还是兼容性问题。实操心得Claude Code 的插件/钩子系统有时在更新后需要“冷启动”。如果遇到问题一个万能的方法是完全退出 Claude Code在终端里用调试模式启动它VIBELOG_DEBUG1 /Applications/Claude\ Code.app/Contents/MacOS/Claude\ Code这样就能看到实时的加载信息。问题三本地报告生成过程卡在“Analyzing...”很久。可能原因与解决会话量过大如果你一次性选择了包含数千条消息的会话本地 AI 分析可能需要较长时间10分钟以上。建议初次使用时先选择最近1-2天的少量会话进行测试。本地 AI 引擎繁忙确保 Claude Code 在前台运行且未处于休眠状态。分析过程需要其 SDK 正常工作。网络问题仅限云分析如果你选择了需要云端辅助的分析选项尽管核心在本地但某些元数据可能需要获取请检查网络连接。纯本地分析模式则无需网络。建议对于大型分析可以考虑在休息时间如午餐时启动报告生成。问题四云端同步失败或认证错误。标准处理流程清除重试在 CLI 中使用 “Cloud Sync Dashboard” 菜单下的 “Logout” 功能。清理浏览器数据前往 Vibe-Log 网站 (vibe-log.dev)在浏览器中登出并清除相关站点的 Cookie 和缓存。重新认证回到 CLI 重新进行 GitHub OAuth 认证流程。深层原因这类问题通常与 OAuth 令牌过期或本地存储的认证状态损坏有关。上述流程相当于进行一次完整的认证重置。5. 安全、隐私与开源透明度解读作为一个处理开发者本地数据的工具安全与隐私是 Vibe-Log 的立身之本。它的设计在多个层面给予了用户充分的控制权和透明度。1. 本地优先架构所有核心分析任务包括站会总结、报告生成、状态栏教练的提示词分析都默认在你的电脑上完成。你的原始会话数据包含代码、错误信息、可能的内网地址永远不会被发送到 Vibe-Log 的服务器。这从根本上消除了源代码和商业机密泄露的风险。2. 可验证的开源与构建整个项目的代码在 GitHub 上完全公开。更重要的是其发布的 npm 包也保持了高度透明非压缩代码发布的dist/index.js是可读的 JavaScript 源码而非难以阅读的压缩混淆代码。你可以直接用文本编辑器打开检查它做了什么。包含源码映射提供了 source map 文件方便调试和逆向对照。自动化构建与证明每个版本都通过 GitHub Actions 自动构建和发布并附有 npm 的 Provenance 证明确保你下载的包确实来自其官方的源码仓库而非被篡改的版本。提供校验和发布包内包含 SHA256 校验和文件你可以通过命令验证下载文件的完整性。3. 可控的云端同步可选即使你选择启用云端同步以获得长期趋势分析其数据脱敏流程也值得信赖。它并非简单替换关键词而是进行“上下文保留的脱敏”。例如它将一段代码替换为[CODE_BLOCK_1: python]的同时会保留你关于这段代码的提问和 AI 的解释逻辑。这样云端服务器分析的是“开发模式”而非“具体代码”既保护了隐私又不失分析价值。你可以在同步前预览脱敏后的数据做到心中有数。4. 无侵入的集成状态栏教练的安装机制充分体现了对用户原有环境的尊重。它会自动备份 Claude Code 的现有状态栏配置。当你通过 CLI 卸载教练时会瞬间恢复原状。这种设计让尝试变得毫无负担避免了“安装容易卸载难”的陷阱。在我个人看来这种将选择权和知情权完全交给用户并通过技术手段本地计算、开源、可验证构建而非单纯靠承诺来保障安全的做法是一个开发者工具能获得社区信任的关键。它让你可以放心地将这个工具深度集成到日常开发流程中而无需担心背后隐藏的成本或风险。