已注释文件列表
2026/4/27大约 2 分钟
已注释文件列表
项目快照
- 项目目录：
/Users/util6/fork-code/claude-code-rev - 学习模式：阅读学习模式
- 学习分支：
claude-code-rev-learn - 当前源码分支来源：
main - 远程仓库：
origin = https://github.com/oboard/claude-code-rev.git - 包名：
@anthropic-ai/claude-code - 版本：
999.0.0-restored - 更新时间：
2026-04-02
学习目录
- 注释镜像目录：
claude-code-rev-learn-comment/ - 跟踪文档：
claude-code-rev-learn-docs/已注释文件列表.md - 架构阅读目录：
claude-code-rev-learn-docs/架构图阅读目录.md
专题知识文档
claude-code-rev-learn-docs/query.ts用户消息主线解析.mdclaude-code-rev-learn-docs/SnipCompact与Microcompact解析.mdclaude-code-rev-learn-docs/CachedMicrocompact机制解析.mdclaude-code-rev-learn-docs/ToolOrchestration工具批执行解析.mdclaude-code-rev-learn-docs/StreamingToolExecutor流式工具执行解析.mdclaude-code-rev-learn-docs/StopHooks续跑判定解析.mdclaude-code-rev-learn-docs/learn-compare-opencode-claudecode/CLI模块架构差异.md
当前理解
- 这是一个通过 source map 和兼容 shim 恢复出来的 Claude Code 源码树，不是上游原始仓库。
- 默认启动命令是
bun run dev，实际走src/bootstrap-entry.ts，随后导入src/entrypoints/cli.tsx。 src/dev-entry.ts是恢复阶段的兜底入口：它会扫描src/和vendor/的相对导入是否缺失，并在缺件时输出降级信息。src/main.tsx是真正的主 CLI 入口，负责启动前预热、副作用初始化、命令行参数解析、配置读取、服务装配与 REPL/任务流程调度。src/commands.ts是命令注册中心，集中挂载大量内建命令，并按 feature flag 做条件加载。src/query.ts是 Claude Code runtime 的总控对话循环，统一编排上下文治理、模型流式采样、工具执行、恢复重试、附件注入与下一轮续跑。
已建立的注释镜像
| 状态 | 源文件 | 镜像文件 | 用途 |
|---|---|---|---|
| 已注释 | src/bootstrap-entry.ts | claude-code-rev-learn-comment/src/bootstrap-entry.ts | 理解真实 CLI 的最外层启动壳 |
| 已注释 | src/dev-entry.ts | claude-code-rev-learn-comment/src/dev-entry.ts | 理解恢复阶段的缺失依赖扫描与降级入口 |
| 已注释 | src/query.ts | claude-code-rev-learn-comment/src/query.ts | 理解 Query Loop、工具执行、上下文压缩与恢复状态机 |
下一批建议阅读
src/services/tools/toolOrchestration.ts：继续下钻 query.ts 里的工具批执行路径。src/services/tools/StreamingToolExecutor.ts：理解流式工具执行为何能与模型流式输出并行。src/query/stopHooks.ts：理解“模型已答完但系统仍继续”的 stop hook 机制。claude-code-rev-learn-docs/架构图阅读目录.md：按外部架构图建立分模块阅读路径。