本章总览
核心文件索引是必读文件清单：按行数与职责排序，适合作为第一周的阅读 todo list。
学完本章你应该能
- 记住 Top 文件列表
- 为每个文件写一句「它负责什么」
核心概念（先读懂这些）
上帝对象要精读
main、REPL、messages、hooks 超大文件是系统枢纽，值得打印/标注。
Top 30 最大文件
| 文件 | 行数 |
|---|---|
messages.ts | 5,513 |
sessionStorage.ts | 5,106 |
hooks.ts | 5,023 |
main.tsx | 4,684 |
attachments.ts | 3,998 |
auth.ts | 2,003 |
config.ts | 1,818 |
query.ts | 1,730 |
Cursor.ts | 1,531 |
worktree.ts | 1,520 |
ide.ts | 1,495 |
claudemd.ts | 1,480 |
analyzeContext.ts | 1,383 |
QueryEngine.ts | 1,296 |
teleport.tsx | 1,226 |
teammateMailbox.ts | 1,184 |
fileHistory.ts | 1,116 |
collapseReadSearch.ts | 1,110 |
stats.ts | 1,062 |
toolResultStorage.ts | 1,041 |
commitAttribution.ts | 962 |
git.ts | 927 |
imageResizer.ts | 881 |
tasks.ts | 863 |
words.ts | 801 |
sessionStoragePortable.ts | 794 |
Tool.ts | 793 |
fsOperations.ts | 771 |
toolSearch.ts | 757 |
commands.ts | 755 |
query 核心链
| 文件 | 行数 | 职责 |
|---|---|---|
| query.ts | ~800 | Agent 主循环 |
| QueryEngine.ts | ~400 | SDK 查询引擎 |
| main.tsx | 4684 | CLI 引导 |
| screens/REPL.tsx | 5006 | REPL 主屏幕 |
| utils/messages.ts | 5513 | Message 格式化 |
| utils/hooks.ts | 5023 | Hooks 系统 |
本章小结与延伸
把索引当课程大纲，逐项勾选已读。 继续学习：