diff --git a/REPO_ANALYSIS.md b/REPO_ANALYSIS.md new file mode 100644 index 0000000..74229e0 --- /dev/null +++ b/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/` 大体量带来的协作摩擦; +- 给站点与课程建立更统一的工程化脚本入口。 + +这样可以在不牺牲深度内容的前提下,显著提升可用性和可维护性。 diff --git a/site/css/style.css b/site/css/style.css index 992706f..30f432a 100644 --- a/site/css/style.css +++ b/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; } - diff --git a/site/topic-deepscientist-unpacked.html b/site/topic-deepscientist-unpacked.html index fc8834d..9fb0daf 100644 --- a/site/topic-deepscientist-unpacked.html +++ b/site/topic-deepscientist-unpacked.html @@ -35,7 +35,8 @@
-
+
+
VibePaper · 子专题 Research Studio / Quest Repo @@ -66,6 +67,8 @@

先看 01 为什么重要 回到 VibePaper 总页

+
+
+