cursor-thinking-stat

本项目是一个基于 Cursor Hooks 的数据采集与可视化工具，自动收集AI 的思考推理过程，并提供 Web 前端页面进行可视化展示，梳理高频单词短语等信息，提升英语阅读能力。

预览视频

B站视频-使用录屏

预览图片

Cursor Hooks 配置

采集依赖 Cursor 的 用户级 Hooks，配置在 ~/.cursor/ 下。

1. 目录与脚本

用跨平台安装器一键写入（推荐）：

# 默认 dataDir = 本仓库 ./data
node scripts/setup-cursor-hooks.mjs

# WSL 且还有 Windows 侧 Cursor 项目时：本机 + Windows 一并安装，共用同一 data/
node scripts/setup-cursor-hooks.mjs --also-windows

安装后目录大致为：

~/.cursor/
├── hooks.json                              # Hooks 入口
├── cursor-learn-english.paths.json         # 共享 dataDir（安装器写入）
└── scripts/
    ├── capture-event.mjs                   # 统一事件 → cursor-events.jsonl
    ├── capture-prompt.mjs                  # 用户提问 → prompt-corpus.jsonl
    ├── capture-thinking.mjs                # Thinking → thinking-corpus.jsonl
    ├── default-paths.mjs
    ├── jsonl-daily.mjs
    └── …

用户级 Hooks 的工作目录为 ~/.cursor/，因此 hooks.json 中的命令使用 ./scripts/xxx.mjs 即可。

重要：改了仓库里的采集脚本，必须重新安装到 ~/.cursor/

Cursor 实际执行的是 ~/.cursor/scripts/*.mjs 的副本，不是本仓库 scripts/ 下的源文件。
修改 scripts/capture-*.mjs、thinking-dedupe.mjs、jsonl-daily.mjs、default-paths.mjs 或 hooks/hooks.json 后，请立刻再跑一次：
node scripts/setup-cursor-hooks.mjs --also-windows   # 或 npm run hooks:install:also-windows
也可在 Cursor 里用任务 「新用户一键配置」 / 「更新 Cursor Hooks」。只改仓库、不重装时，去重/路径等修复不会生效。

打开仪表盘 /setup 可体检：数据目录是否可写、本机/Windows Hooks 是否安装、路径是否一致，并复制安装命令。

跨环境（Windows / WSL / Linux）

设计原则：多个采集端 → 一个 dataDir → 一个仪表盘。

拓扑	仪表盘	数据目录	Hooks
纯 Linux / 纯 Windows	同机	同机 `data/`	安装一次即可
WSL + Windows 混用（常见）	只跑在 WSL	放在 WSL 原生盘（本仓库 `data/`）	WSL 装一份；Windows 用 `--also-windows`：Hooks 经 `wsl.exe` 调 Linux 脚本写入（避免直接写 `\\wsl$\...` 被静默失败）

路径解析优先级（Hooks 与 Web 一致）：

环境变量 CURSOR_DASHBOARD_DATA_DIR（及单文件变量）
~/.cursor/cursor-learn-english.paths.json 的 dataDir
默认 ~/projects/cursor-learn-english/data

不要让 Windows / WSL 各写一份 jsonl 再合并；用 --also-windows 或 /setup 页给出的 UNC 命令，让 Windows Hooks 直接写入 WSL 数据目录。

2. hooks.json 配置示例

{
  "version": 1,
  "hooks": {
    "beforeSubmitPrompt": [
      { "command": "node ./scripts/capture-prompt.mjs" },
      { "command": "node ./scripts/capture-event.mjs" }
    ],
    "afterAgentResponse": [{ "command": "node ./scripts/capture-event.mjs" }],
    "afterAgentThought": [
      { "command": "node ./scripts/capture-thinking.mjs" },
      { "command": "node ./scripts/capture-event.mjs" }
    ],
    "postToolUse": [{ "command": "node ./scripts/capture-event.mjs" }],
    "postToolUseFailure": [{ "command": "node ./scripts/capture-event.mjs" }],
    "sessionStart": [{ "command": "node ./scripts/capture-event.mjs" }],
    "sessionEnd": [{ "command": "node ./scripts/capture-event.mjs" }],
    "subagentStart": [{ "command": "node ./scripts/capture-event.mjs" }],
    "subagentStop": [{ "command": "node ./scripts/capture-event.mjs" }],
    "stop": [{ "command": "node ./scripts/capture-event.mjs" }],
    "preCompact": [{ "command": "node ./scripts/capture-event.mjs" }],
    "afterFileEdit": [{ "command": "node ./scripts/capture-event.mjs" }]
  }
}

3. 数据输出路径

文件	来源	说明
`~/projects/cursor-learn-english/data/thinking-corpus.jsonl`	`capture-thinking.mjs`	每行一条 Thinking 记录（text、timestamp、model、duration_ms 等）
`~/projects/cursor-learn-english/data/prompt-corpus.jsonl`	`capture-prompt.mjs`	每行一条用户提问（prompt、timestamp、conversation_id）
`~/projects/cursor-learn-english/data/cursor-events.jsonl`	`capture-event.mjs`	每行一条事件（event_type、timestamp、conversation_id 及事件字段）

可通过环境变量覆盖路径（Hooks 与 Web 使用同一套变量名，见下表）。Web 端在项目根目录复制 .env.local.example 为 .env.local 后按需取消注释；Hooks 脚本从进程环境读取，可在 shell 配置中 export，或确保与 .env.local 指向相同绝对路径。

路径变量总览

数据	默认文件	变量（优先级从高到低）	读/写方
事件	`~/projects/cursor-learn-english/data/cursor-events.jsonl`	`EVENTS_JSONL_PATH` → `CURSOR_EVENTS_PATH`	`capture-event.mjs`、Web API
Thinking 语料	`~/projects/cursor-learn-english/data/thinking-corpus.jsonl`	`CORPUS_JSONL_PATH` → `THINKING_CORPUS_PATH`	`capture-thinking.mjs`、会话/词汇页
用户提问	`~/projects/cursor-learn-english/data/prompt-corpus.jsonl`	`PROMPT_CORPUS_PATH`	`capture-prompt.mjs`、Web API
关键词（可选）	—	`KEYWORD_JSONL_PATH`	仅 Web `/api/keyword`；未配置时返回 503

Thinking 语料：`CORPUS_` ↔ `THINKING_` 对照

两套名称指向同一文件，任选其一即可；若同时设置，以 CORPUS_JSONL_PATH 为准。

变量	常见来源	说明
`CORPUS_JSONL_PATH`	Web / 新版文档	Next.js（`lib/thinking.ts`）与 `capture-thinking.mjs` 优先使用
`THINKING_CORPUS_PATH`	Hooks / 旧版 README	与上式等价；`capture-response-to-txt.mjs` 仅识别此名

事件文件：`EVENTS_` ↔ `CURSOR_` 对照

变量	常见来源	说明
`EVENTS_JSONL_PATH`	Web / 新版文档	Next.js（`lib/events.ts`）与 `capture-event.mjs` 优先使用
`CURSOR_EVENTS_PATH`	Hooks / 旧版 README	与上式等价，次优先

对齐建议：本地开发时在 .env.local 中写 CORPUS_JSONL_PATH 与 EVENTS_JSONL_PATH；若 Hooks 与 Web 不同机或不同用户，请在 Hooks 运行环境中 export 相同绝对路径，避免仪表盘读不到采集文件。

按日切分、保留与清理（#5 中期）

默认开启按日写入：在配置的基路径旁生成 *-YYYY-MM-DD.jsonl 分片（例如 data/thinking-corpus-2026-06-02.jsonl），避免单文件无限增大。读侧会合并旧版单文件（若仍存在）与所有分片。可用环境变量 CURSOR_DASHBOARD_DATA_DIR 覆盖整个数据目录。

变量	默认	说明
`JSONL_DAILY_SPLIT`	开启	设为 `0` 或 `false` 时采集仍只追加到基路径单文件
`JSONL_RETENTION_DAYS`	`0`（不自动删）	自动删除早于该天数的分片；设为正数（如 `90`）可恢复 TTL
`MAX_JSONL_BYTES`	`52428800`（50MB）	单分片超过此大小时 API 只读尾部（见 `lib/jsonl.ts`）
`MAX_JSONL_TAIL_LINES`	`100000`	尾部截断时最多保留行数

采集脚本在追加时会至多每 24 小时触发一次 TTL 清理；也可手动执行：

node scripts/prune-jsonl.mjs

旧版家目录下的 ~/thinking-corpus.jsonl 等单文件不会被 TTL 删除，可在确认分片已包含历史数据后自行归档或删除。

4. 依赖与运行

脚本需 Node.js（无 npm 依赖）。
Web 端：在项目根目录执行 npm install 后 npm run dev，浏览器打开仪表盘。路径覆盖见上文对照表，亦可复制 .env.local.example → .env.local。Thinking 页「我的问题」依赖 data/prompt-corpus.jsonl（或 PROMPT_CORPUS_PATH），需确保 beforeSubmitPrompt 已挂载 capture-prompt.mjs。
可选关键词页：设置 KEYWORD_JSONL_PATH 指向外部 keyword JSONL；未配置时 /api/keyword 返回 503 而非 500。

更多事件字段说明见 hooks.md。

5. 终端任务使用指引

本仓库在 .vscode/tasks.json 中配置了可在 Cursor 中直接运行的任务。终端 → 运行任务... 中可选：

任务	说明
新用户一键配置	`npm install` + 安装 Hooks（WSL 下默认 `--also-windows`）。
更新 Cursor Hooks（改脚本后必跑）	同步 hooks 运行时脚本与 `hooks.json`（WSL 下顺带更新 Windows）。
仅更新本机 Hooks（不含 Windows）	只写当前环境的 `~/.cursor`。
本地访问：启动 dev（仅本机）	开发服务，仅本机 http://localhost:3000 。
WSL/宿主机访问：启动 dev	监听 `0.0.0.0`，宿主机浏览器也可访问。

也可手动执行：node scripts/setup-cursor-hooks.mjs（或 bash scripts/setup-cursor-hooks.sh，二者等价）。

项目结构

thinking-get-hook/
├── .cursor-plugin/
│   └── plugin.json              # Cursor Plugin 清单（可选，用于插件形式分发）
├── app/
│   ├── layout.tsx
│   ├── page.tsx                 # 仪表盘首页
│   ├── setup/page.tsx           # 环境配置 / 体检页
│   ├── globals.css
│   ├── api/
│   │   ├── events/route.ts      # GET 事件聚合（按日/类型）
│   │   ├── setup/route.ts       # GET 环境诊断
│   │   ├── vocab/route.ts       # GET 词频统计（提问/Thinking/回复）
│   │   └── sessions/route.ts    # GET 会话列表
│   ├── vocab/page.tsx           # 词频统计页
│   └── sessions/page.tsx       # 会话列表与轮次详情
├── components/
│   ├── VocabStats.tsx           # 词频图表与表格
│   ├── SessionTable.tsx         # 会话表格
│   └── SetupPanel.tsx           # /setup 体检 UI
├── lib/
│   ├── events.ts                # 读 cursor-events.jsonl、按日聚合
│   ├── thinking.ts              # thinking / prompt 语料路径与类型
│   ├── dialogue.ts              # 轮次语料拼接（会话详情用）
│   ├── default-paths.ts         # 共享 dataDir 解析（env / paths.json / 默认）
│   ├── setup-diagnostics.ts     # /api/setup 诊断逻辑
│   └── vocab.ts                 # 多源词频聚合
├── .vscode/
│   └── tasks.json               # Cursor/VS Code 一键任务
├── hooks/
│   └── hooks.json               # 本仓库内 Hooks 配置（可复制到 ~/.cursor）
├── scripts/
│   ├── capture-event.mjs        # 统一事件采集 → cursor-events.jsonl
│   ├── capture-prompt.mjs       # 用户提问采集 → prompt-corpus.jsonl
│   ├── capture-thinking.mjs     # Thinking 采集 → thinking-corpus.jsonl
│   ├── setup-cursor-hooks.mjs   # 跨平台 Hooks 安装（支持 --data-dir / --also-windows）
│   ├── setup-cursor-hooks.sh    # 薄封装 → 调用 .mjs
│   └── test.sh
├── hooks.md                     # Hooks 事件说明文档
├── package.json
├── next.config.ts
└── README.md

参考文档

https://cursor.com/cn/docs/hooks#hook-5

Navigation Menu

Repository files navigation

cursor-thinking-stat

预览视频

预览图片

Cursor Hooks 配置

1. 目录与脚本

跨环境（Windows / WSL / Linux）

2. hooks.json 配置示例

3. 数据输出路径

路径变量总览

Thinking 语料：`CORPUS_` ↔ `THINKING_` 对照

事件文件：`EVENTS_` ↔ `CURSOR_` 对照

按日切分、保留与清理（#5 中期）

4. 依赖与运行

5. 终端任务使用指引

项目结构

参考文档

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 173 Commits
.cursor-plugin		.cursor-plugin
.vscode		.vscode
app		app
components		components
data		data
hooks		hooks
lib		lib
public		public
scripts		scripts
.env.local.example		.env.local.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
README-en.md		README-en.md
README.md		README.md
eslint.config.mjs		eslint.config.mjs
hooks.md		hooks.md
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
test-corpus.jsonl		test-corpus.jsonl
tsconfig.json		tsconfig.json
中英文prompt差异对比.md		中英文prompt差异对比.md

Folders and files

Latest commit

History

Repository files navigation

cursor-thinking-stat

预览视频

预览图片

Cursor Hooks 配置

1. 目录与脚本

跨环境（Windows / WSL / Linux）

2. hooks.json 配置示例

3. 数据输出路径

路径变量总览

Thinking 语料：CORPUS_* ↔ THINKING_* 对照

事件文件：EVENTS_* ↔ CURSOR_* 对照

按日切分、保留与清理（#5 中期）

4. 依赖与运行

5. 终端任务使用指引

项目结构

参考文档

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Thinking 语料：`CORPUS_` ↔ `THINKING_` 对照

事件文件：`EVENTS_` ↔ `CURSOR_` 对照