docs: add repository analysis overview

REPO_ANALYSIS.md

@@ -0,0 +1,88 @@
+# 仓库分析（2026-05-02）
+
+## 1. 仓库定位
+
+`learn-likecc` 是一个“课程 + 源码镜像 + 可运行复刻 + Web 展示”的复合型仓库：
+
+- **学习层**：`course/` 提供章节化文档与示例，面向 Claude Code / Agent Harness 机制学习。
+- **产品层**：`site/` 提供静态课程站点与大量可视化 JS 组件。
+- **实验层**：`reflective-loop-simulator/` 提供独立模拟器页面。
+- **源码层**：`ccsource/` 存放超大规模源码资产（原始快照、重建版本、like-code 主线等）。
+
+## 2. 目录结构与规模
+
+根据当前仓库扫描结果，关键目录规模如下：
+
+- `ccsource/`：约 **3908** 个文件（绝对主仓内容，体量最大）
+- `site/`：约 **351** 个文件（课程展示站点）
+- `course/`：约 **25** 个文件（讲义与示例）
+- `reflective-loop-simulator/`：约 **7** 个文件（轻量 demo）
+
+这说明仓库当前重心偏向“**源码资产沉淀 + 内容分发**”，而不是轻量应用仓库。
+
+## 3. 技术栈观察
+
+从 `package.json` 可见，根目录工具链非常轻：
+
+- `markdownlint-cli`：文档质量检查
+- `playwright`、`puppeteer`：浏览器自动化/抓取/截图类能力
+- 当前暴露脚本主要是 `lint:md`，偏文档治理而非统一构建链
+
+这与仓库“课程与研究型”定位一致：核心产出是文档、源码拆解与网页内容，而非单一 npm 应用。
+
+## 4. 子系统职责拆分
+
+### 4.1 `course/`
+- 以章节（s01~s12）覆盖 Agent Loop、工具系统、权限、MCP、Tasks、Vim、Git 等主题。
+- `examples/` 提供与章节对应的教学代码。
+- 适合作为“结构化学习入口”。
+
+### 4.2 `site/`
+- 静态 HTML 页面 + `site/js/` 交互脚本。
+- 主题覆盖广（agent runtime、RAG、论文拆解、可视化播放器等）。
+- 是外部访问与课程传播的主要载体。
+
+### 4.3 `ccsource/`
+- 含大量 Claude Code 相关源码快照、重建工程与衍生代码。
+- 从命名可见存在多条线：`claude-code-main`、`claude-code-rebuild`、`like-code-main`（README 中也明确了分层策略）。
+- 对学习者价值高，但也带来仓库体积、索引速度与维护成本挑战。
+
+### 4.4 `reflective-loop-simulator/`
+- 独立前端模拟器（HTML/CSS/JS + 场景数据）。
+- 适合作为教学互动 demo，与主站内容形成互补。
+
+## 5. 当前优势
+
+- **知识密度高**：课程、源码、可视化材料一体化。
+- **实践导向强**：不仅讲原理，也在推进可运行恢复（README 大量变更记录体现持续迭代）。
+- **分层意识清晰**：已显式区分“原始快照 / 重建基线 / 主开发线”。
+
+## 6. 主要风险与成本点
+
+- **仓库过大**：`ccsource/` 体量大，可能影响 clone、CI、IDE 索引体验。
+- **入口信息过载**：根 README 信息量极高，首次进入者可能难以抓住最短路径。
+- **工程流程分散**：根脚本较少，子目录可能各自为战，自动化规范一致性需持续治理。
+
+## 7. 建议的演进方向（按优先级）
+
+1. **建立清晰“新手入口”**
+   - 在 README 顶部增加 3 条路径：学习者、开发者、源码研究者。
+2. **为 `ccsource/` 做索引清单**
+   - 提供 machine-readable 的目录索引（例如 `ccsource-index.json`）与版本说明。
+3. **统一任务脚本门面**
+   - 根目录增加 `scripts`：如 `site:dev`、`course:check`、`analyze:repo`，降低协作门槛。
+4. **文档分层**
+   - 将“里程碑日志”与“快速开始”拆分，降低 README 认知负担。
+5. **体积治理策略**
+   - 明确大文件与历史资产策略（必要时拆分子仓或使用发布制品方式承载）。
+
+## 8. 结论
+
+这是一个典型的“**研究-教学-工程复刻混合仓库**”。
+短期最值得做的是：
+
+- 把“怎么学 / 怎么跑 / 去哪里看源码”三条路径做成明确导航；
+- 持续降低 `ccsource/` 大体量带来的协作摩擦；
+- 给站点与课程建立更统一的工程化脚本入口。
+
+这样可以在不牺牲深度内容的前提下，显著提升可用性和可维护性。

site/css/style.css

@@ -15491,6 +15491,19 @@ body.site-shell-overlay-open {
     max-width: 1180px;
 }
 
+.ds-hero-layout {
+    align-items: start;
+}
+
+.ds-hero-main {
+    display: grid;
+    gap: 14px;
+}
+
+.ds-hero-side {
+    align-self: center;
+}
+
 .vibe-unpacked-hero .hero-badge,
 .vibe-unpacked-hero .hero-title,
 .vibe-unpacked-hero .hero-subtitle,
@@ -15503,8 +15516,8 @@ body.site-shell-overlay-open {
     grid-column: 2;
     grid-row: 1 / span 5;
     position: relative;
-    min-height: 420px;
-    padding: 26px;
+    min-height: 390px;
+    padding: 24px;
     border-radius: 34px;
     overflow: hidden;
     background:
@@ -15547,7 +15560,7 @@ body.site-shell-overlay-open {
     display: flex;
     flex-wrap: wrap;
     gap: 8px;
-    margin-bottom: 42px;
+    margin-bottom: 26px;
 }
 
 .vibe-hero-console__rail span {
@@ -15567,12 +15580,12 @@ body.site-shell-overlay-open {
     position: relative;
     z-index: 1;
     display: grid;
-    gap: 14px;
+    gap: 10px;
 }
 
 .vibe-hero-console__node {
     position: relative;
-    padding: 18px 18px 17px;
+    padding: 14px 15px;
     border-radius: 22px;
     color: #f8fafc;
     background: rgba(255, 255, 255, 0.1);
@@ -15581,11 +15594,11 @@ body.site-shell-overlay-open {
 }
 
 .vibe-hero-console__node:nth-child(2) {
-    --node-shift: 28px;
+    --node-shift: 20px;
 }
 
 .vibe-hero-console__node:nth-child(3) {
-    --node-shift: 58px;
+    --node-shift: 34px;
 }
 
 .vibe-hero-console__node--hot {
@@ -15782,16 +15795,36 @@ body.site-shell-overlay-open {
 .ds-hero .hero-subtitle {
     color: #4b3d32;
     font-size: 1.05rem;
-    max-width: 680px;
+    max-width: 640px;
+    margin: 0;
 }
 
 .ds-hero-meta {
-    margin-top: 22px;
+    margin-top: 6px;
     display: flex;
     flex-wrap: wrap;
     gap: 12px;
 }
 
+.ds-hero .cc-unpacked-hero-stats {
+    margin-top: 6px;
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 10px;
+    max-width: 680px;
+}
+
+.ds-hero .cc-unpacked-hero-stats .stat-item {
+    min-height: auto;
+    padding: 14px 12px;
+    border-radius: 14px;
+}
+
+.ds-hero .cc-unpacked-hero-subtitle-note {
+    font-size: 0.93rem;
+    margin-top: 2px;
+}
+
 .ds-hero-chip {
     padding: 8px 14px;
     border-radius: 9999px;
@@ -16041,6 +16074,10 @@ body.site-shell-overlay-open {
     .ds-gallery {
         grid-template-columns: 1fr;
     }
+
+    .ds-hero .cc-unpacked-hero-stats {
+        grid-template-columns: 1fr;
+    }
 }
 
 @media (max-width: 1180px) {
@@ -17801,4 +17838,3 @@ body.site-shell-overlay-open {
     font-size: 0.9rem;
     padding: 1rem;
 }
-

site/topic-deepscientist-unpacked.html

@@ -35,7 +35,8 @@
     </nav>
 
     <section class="hero ds-hero vibe-unpacked-hero">
-        <div class="hero-content">
+        <div class="hero-content ds-hero-layout">
+            <div class="ds-hero-main">
             <div class="hero-badge">
                 <span>VibePaper · 子专题</span>
                 <span>Research Studio / Quest Repo</span>
@@ -66,6 +67,8 @@ <h1 class="hero-title">
                 <a href="#why" class="btn btn-primary">先看 01 为什么重要</a>
                 <a href="topic-vibepaper.html" class="btn btn-secondary">回到 VibePaper 总页</a>
             </div>
+            </div>
+            <aside class="ds-hero-side">
             <div class="vibe-hero-console" aria-label="DeepScientist 研究工作台视觉摘要">
                 <div class="vibe-hero-console__rail">
                     <span>quest repo</span>
@@ -88,6 +91,7 @@ <h1 class="hero-title">
                     </div>
                 </div>
             </div>
+            </aside>
         </div>
     </section>