diff --git a/README.md b/README.md
index 05ac21b..b1d9b33 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,17 @@
 
 ---
 
+## Table of Contents
+
+- [Deep Analysis Reports (`docs/`)](#deep-analysis-reports-docs) — Telemetry, codenames, undercover mode, remote control, future roadmap
+- [Missing Modules Notice](#missing-modules-notice-108-modules) — 108 feature-gated modules not in the npm package
+- [Architecture Overview](#architecture-overview) — Entry → Query Engine → Tools/Services/State
+- [Tool System & Permissions](#tool-system-architecture) — 40+ tools, permission flow, sub-agents
+- [The 12 Progressive Harness Mechanisms](#the-12-progressive-harness-mechanisms) — How Claude Code layers production features on the agent loop
+- [Build Notes](#build-notes) — Why this source isn't directly compilable
+
+---
+
 ## Deep Analysis Reports (`docs/`)
 
 Source code analysis reports derived from decompiled v2.1.88. Bilingual (EN/ZH).
diff --git a/README_CN.md b/README_CN.md
index 25e9a41..614623c 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -7,6 +7,15 @@
 
 ---
 
+## 目录
+
+- [深度分析文档 (`docs/`)](#深度分析文档-docs) — 遥测、模型代号、卧底模式、远程控制、未来路线图
+- [缺失模块说明](#缺失模块说明108-个模块) — 108 个被 feature gate 移除的模块
+- [架构概览](#架构概览) — 入口 → 查询引擎 → 工具/服务/状态
+- [构建说明](#构建说明) — 为什么不能直接编译
+
+---
+
 ## 深度分析文档 (`docs/`)
 
 基于 v2.1.88 反编译源码的分析报告，中英双语。