用途
code-insights 用于把 AI 编程会话转化为可积累的知识。它分析你在 Claude Code、Cursor、Codex CLI、Copilot CLI 和 VS Code Copilot Chat 等工具中的会话记录,从中提取结构化洞察,帮助你更了解自己与 AI 协作的方式,并据此改进。
主要能力
- 决策、经验与提示词质量:每个会话都会被分析,提取结构化洞察,包括带权衡与备选方案的决策、带根因的经验教训,以及覆盖 5 个维度的提示词质量评分,并附带可操作的改进前后对比要点。
- 跨会话模式:每周综合会检测所有会话中的摩擦点、有效模式和提示词质量趋势。支持按周浏览,观察习惯变化,并可导出生成的规则用于你的 CLAUDE.md 或 .cursorrules。
- AI 流畅度评分:将上述分析汇总为 AI Fluency Score,作为可分享的编码指纹、工作风格与主要模式快照。
- 分析与成本追踪:活动图表、按项目和模型划分的成本明细、会话类型以及多工具使用情况,集中在一个仪表盘中。
- 终端分析:无需浏览器,运行 code-insights stats 即可在终端获得完整视图。
使用方式
- 会话数据在同步时自动发现。支持的 AI 工具会话会被自动纳入分析。
- Claude Code 用户可零配置分析、零成本:安装一次 hook,之后每个会话都会使用你的 Claude 订阅自动分析。
- 支持 Ollama:免费、本地、无需 API 密钥。若已安装 Ollama,code-insights 会自动检测并用其进行 AI 分析,无需账号、无成本、数据不离开本机。
- 完整 CLI 参考见 cli/README.md。
项目结构
这是一个 monorepo,包含三个包:
- cli/ — Node.js CLI、会话提供方、SQLite 写入、终端分析
- server/ — Hono API 服务器、REST 端点、LLM 代理(API 密钥保留在服务端)
- dashboard/ — Vite + React SPA,由 Hono 服务器提供
隐私与数据
会话数据保留在你的机器上,位置为 ~/.code-insights/data.db。无需账号、无云端同步。匿名使用遥测可退出(code-insights telemetry disable)。LLM 分析使用你自己的 API 密钥(或本地 Ollama)——会话内容只会发送到你配置的提供方。
许可
MIT,详见 LICENSE。