Appearance
Context Mode 的 Insight 是一个本地 Web 仪表盘,追踪你在 AI 编程会话中的 90 项指标。它覆盖 23 种事件类别,提供 37 种自动洞察模式和 4 个综合评分:生产力指数、代码质量、委派效率、上下文健康度。所有数据 100% 本地存储,零遥测。对 Claude Code 用户,直接用 /context-mode:ctx-insight 打开。
Insight 是什么
当你用 AI 编程工具写了一周代码后,有没有想过:
- 我和 AI 的配合效率怎么样?
- 我花多少时间在"纠正 AI 的方向"上?
- 上下文压缩发生了几次?每次都丢了什么信息?
- 哪个 AI 工具调用最费上下文?
Insight 就是来回答这些问题的。它是 Context Mode 内置的个人分析面板——一个 Vite + Tailwind 构建的本地 Web 应用,读取 Context Mode 在会话中记录的 SQLite 事件数据,生成可视化报告。
打开方式
Claude Code
/context-mode:ctx-insight自动在浏览器中打开本地 Web UI。
其他平台
在对话中输入 "ctx insight",模型会调用 ctx_insight MCP 工具,返回分析报告。
四个综合评分
Insight 的核心是 4 个综合评分,每个都是多个指标的加权组合:
1. 生产力指数(Productivity Score)
衡量你和 AI 的协作效率。
| 指标 | 含义 |
|---|---|
| 任务完成率 | 标记为"完成"的任务占总任务的比例 |
| 任务周转时间 | 从开始到完成的平均耗时 |
| 工具调用效率 | 每个任务平均用了多少次工具调用 |
| 会话持续时间 | 一次有效编程会话的平均时长 |
解读:生产力指数高意味着你和 AI 的协作顺畅——任务能按计划完成,不需要反复纠正。指数低可能意味着 Prompt 不够精确,或者 AI 的方案经常被你否定。
2. 代码质量(Quality Score)
衡量 AI 产出的代码质量。
| 指标 | 含义 |
|---|---|
| 错误修复比 | 编辑文件 vs 修复错误的比例 |
| 类型错误频率 | TypeScript 类型错误的出现次数 |
| 测试通过率 | 测试运行的成功比例 |
| 回退次数 | AI 的改动被撤销的次数 |
解读:质量分高意味着 AI 写的代码不需要你手动修正。低分可能需要更好的 Prompt 设计(给更多上下文、更明确的约束)。
3. 委派效率(Delegation Score)
衡量你把任务交给 AI 的能力。
| 指标 | 含义 |
|---|---|
| 子代理使用率 | 使用 Agent 工具的频率 |
| 子代理成功率 | 子代理任务的完成率 |
| 任务粒度 | 你交给 AI 的任务是否足够具体 |
| 干预频率 | 你在 AI 工作中打断/纠正的次数 |
解读:委派效率高意味着你很会"管理 AI"——知道什么任务适合交给 AI、怎么描述任务、什么时候该打断。这是 AI 时代最重要的技能之一。
4. 上下文健康度(Context Health)
衡量上下文窗口的使用效率。
| 指标 | 含义 |
|---|---|
| 压缩次数 | Compaction 触发的次数 |
| 上下文利用率 | 已用上下文 / 总上下文的比率 |
| 沙盒使用率 | 使用 ctx_execute vs 直接 Bash 的比例 |
| 知识库命中率 | ctx_search 返回有用结果的比例 |
解读:上下文健康度直接反映 Context Mode 的使用效果。沙盒使用率高意味着你(或 AI)在积极用沙盒工具节省上下文。压缩次数少意味着有效会话时间长。
90 项指标分类
Insight 追踪的 90 项指标分布在 23 种事件类别中:
| 类别 | 指标数 | 示例 |
|---|---|---|
| 文件操作 | 12 | 编辑次数、创建次数、每文件平均编辑数 |
| Git 操作 | 8 | commit 数量、分支切换、merge 次数 |
| 任务管理 | 7 | 创建/完成/取消、平均周期 |
| 错误处理 | 10 | 类型错误、运行时错误、修复耗时 |
| 工具使用 | 15 | 各工具调用频率、上下文消耗 |
| 用户交互 | 8 | 提问次数、纠正频率、满意度信号 |
| 会话统计 | 10 | 会话时长、压缩次数、恢复成功率 |
| 子代理 | 6 | 创建/完成/失败、平均耗时 |
| 安全事件 | 4 | 被阻止的工具调用、权限变更 |
| 其他 | 10 | 配置变更、升级事件、诊断运行 |
37 种洞察模式
Insight 不只是堆数字——它会自动识别行为模式并给出建议:
效率洞察
| 模式 | 触发条件 | 建议 |
|---|---|---|
| "频繁修正" | 干预率 > 30% | 把任务拆得更小,给更多上下文 |
| "上下文瓶颈" | 压缩 > 3 次/会话 | 增加沙盒工具使用,减少直接 Read |
| "单次巨量" | 单次工具输出 > 50 KB | 用 ctx_execute 脚本替代 |
| "重复调用" | 同一工具同参数 > 3 次 | 缓存结果或用 ctx_index 索引 |
质量洞察
| 模式 | 触发条件 | 建议 |
|---|---|---|
| "类型地狱" | 类型错误 > 10 次/会话 | 先写类型定义再实现 |
| "测试缺失" | 编辑 > 测试 × 5 | 先写测试再实现(TDD) |
| "回退循环" | 同文件回退 > 2 次 | 重新讨论方案,不要继续微调 |
协作洞察
| 模式 | 触发条件 | 建议 |
|---|---|---|
| "指令模糊" | 任务取消率 > 20% | 用更具体的动词描述任务 |
| "过度委派" | 子代理失败率 > 40% | 简化子代理任务描述 |
| "完美主义" | 每任务编辑 > 20 次 | 设定"够好"标准,不要无限精调 |
会话事件追踪
23 种事件类别
| 优先级 | 事件类别 | 数据 |
|---|---|---|
| P1 Critical | 文件变更、任务状态、计划、规则、用户提示 | 路径、状态、摘要 |
| P2 High | 决策、Git、错误、错误解决、约束、阻塞项、被拒方案、环境、代理发现、迭代 | 操作、结果、上下文 |
| P3 Normal | 延迟、MCP 工具、子代理、技能、外部引用 | 耗时、工具名、参数摘要 |
| P4 Low | 意图、角色、数据引用 | 用户意图分类 |
数据隐私
- 所有数据存储在本地 SQLite(
~/.claude/context-mode/sessions/等) - 不上传任何数据到云端
- 不采集 IP、用户名或真实联系方式
- 每个项目独立数据库,互不干扰
技术栈
| 组件 | 技术 |
|---|---|
| 前端框架 | Vite + Tailwind CSS |
| 数据源 | SQLite(会话事件表) |
| 分析引擎 | session/analytics.ts(90 项指标、37 种模式) |
| 图表 | 轻量 Canvas 渲染 |
FAQ
Q: Insight 数据会被清除吗?
手动删除对应的 .db 文件会清除数据。执行 /context-mode:ctx-purge 会清除知识库数据(不影响 Insight 的事件数据)。开新会话(非 --continue)会删除之前的 Session 数据。
Q: 指标数据有时间范围吗?
Insight 默认显示最近 7 天的数据,支持自定义时间范围。历史数据不会自动清理(除非 Session 被删除)。
Q: 我怎么知道自己在用 Context Mode 的哪个功能最多?
执行 /context-mode:ctx-stats 查看沙盒工具的使用统计——每个工具的调用次数、上下文消耗、节省比例。Insight 面板则提供更全面的趋势分析。