# 文档与站点索引（**存档快照 · 冻结于 2026-07-31 / CHANGELOG 阶段 17**）

> ⚠️ **本文件已被 [`总目录.md`](./总目录.md) 取代，仅保留作历史快照。**新增内容（阶段 18 起，含 CodePilot / Pi / Cline / Kanban / CodexMonitor 专线与 OpenWorker 企业方案）**不再回填到本文件**，请以 `总目录.md` 与 `html-hub.html` 为准。
>
> 工作区根目录：`/Users/mikayiyanglin/Documents/Github claude-code/claude code源码分析`  
> 本快照对齐 `CHANGELOG.md` 阶段 1–17 + 当时的产物总览。不含 `node_modules` / 参考仓库内部海量文档。

---

## 一、本机学习站 / HTML（全部可打开 · 已梳理）

> **总入口（请收藏）：** html-hub.html  
> Vite 应用**不要**双击目录里的 `index.html`（会白屏）；请用下方 HTTP 地址。  
> 避开 Kimi 常用端口 **7100 / 7101**。

| 页面 | 打开地址 |
|---|---|
| **总入口 Hub** | html-hub.html |
| OpenManus × Suna 学习站 | learn/manus/ |
| Manus 从零构建（站内） | learn/manus/build-guide.html |
| Claude Code 学习站 v1 | learn/claude-v1/ |
| Claude Code 学习站 v2 | learn/claude-v2/ |
| 从零构建编程助手指南站 | learn/agent-guide/ |
| Manus 教程（根目录 HTML） | 从零构建通用任务Agent-Manus系-开发全流程教程.html |
| 从零构建 Claude Code 交互课 | build-claude-code.html |

重启电脑后在仓库根目录按端口再起 preview / `python3 -m http.server 7400` 即可（见 `html-hub.html` 页脚说明）。

---

## 二、项目自有 Markdown（推荐阅读顺序）

### 0. 总览 / 交接

| 文件 | 说明 |
|---|---|
| [`CHANGELOG.md`](./CHANGELOG.md) | 全部阶段演进与产物表（**始终最新**） |
| [`总目录.md`](./总目录.md) | **现行总索引**（本文件的升级替代） |
| [`handoff.md`](./handoff.md) | 零上下文交接 |
| [`文档与站点索引.md`](./文档与站点索引.md) | 本文件 |

### 1. Claude Code 主线

| 文件 | 说明 |
|---|---|
| [`Claude-Code-工作原理科普.md`](./Claude-Code-工作原理科普.md) | 初版存档 |
| [`Claude-Code-工作原理科普-深入版.md`](./Claude-Code-工作原理科普-深入版.md) | **主文档** 14 章 + 多图 |
| [`调查报告/01-工具盘点.md`](./调查报告/01-工具盘点.md) | 43 工具 |
| [`调查报告/02-核心功能组件盘点.md`](./调查报告/02-核心功能组件盘点.md) | 插件/技能/MCP 等 |
| [`调查报告/03-斜杠命令盘点.md`](./调查报告/03-斜杠命令盘点.md) | 60+ 命令 |
| [`从零构建AI编程助手-开发全流程教程.md`](./从零构建AI编程助手-开发全流程教程.md) | 编程助手从零构建（含客户端章） |

### 2. 八大编程 Agent 分析 + 横向

| 文件 | 说明 |
|---|---|
| [`项目分析/opencode-源码分析.md`](./项目分析/opencode-源码分析.md) | |
| [`项目分析/hermes-agent-源码分析.md`](./项目分析/hermes-agent-源码分析.md) | |
| [`项目分析/Raven-源码分析.md`](./项目分析/Raven-源码分析.md) | |
| [`项目分析/CodeWhale-源码分析.md`](./项目分析/CodeWhale-源码分析.md) | |
| [`项目分析/goose-源码分析.md`](./项目分析/goose-源码分析.md) | |
| [`项目分析/nanobot-源码分析.md`](./项目分析/nanobot-源码分析.md) | |
| [`项目分析/grok-build-源码分析.md`](./项目分析/grok-build-源码分析.md) | |
| [`项目分析/横向对比与总结评价.md`](./项目分析/横向对比与总结评价.md) | 八大 Agent 总评 |

### 3. Manus 系（OpenManus × Kortix/Suna）

| 文件 | 说明 |
|---|---|
| [`项目分析/OpenManus-源码分析.md`](./项目分析/OpenManus-源码分析.md) | 加深版 ~1546 行 / 11 图 |
| [`项目分析/Suna-源码分析.md`](./项目分析/Suna-源码分析.md) | 完整检出加深版 / 8 图 |
| [`项目分析/OpenManus-vs-Suna-横向对比.md`](./项目分析/OpenManus-vs-Suna-横向对比.md) | 选型 + 决策图 |
| [`从零构建通用任务Agent-Manus系-开发全流程教程.md`](./从零构建通用任务Agent-Manus系-开发全流程教程.md) | **跟任务走** 深挖版 ~1037 行 / 12 图 |

### 4. 站点脚手架说明（次要）

| 文件 | 说明 |
|---|---|
| `claude-code-learn/README.md` / `template-info.md` | v1 模板说明 |
| `claude-code-learn-v2/README.md` / `template-info.md` | v2 模板说明 |
| `build-an-agent-guide/README.md` | 编程助手指南站 |
| `claude-code/README.md` | 上游 Claude Code 源码树说明（分析对象，非本项目产出） |

---

## 三、本机已装：OpenManus / Suna（Kortix）

### OpenManus

| 项 | 值 |
|---|---|
| 路径 | `参考项目/OpenManus/` |
| Python | `.venv` · **3.12.13**（uv） |
| 依赖 | 已装（`pillow` 放宽为 `~=10.4` 以兼容 crawl4ai；另补 `structlog`） |
| Playwright | Chromium 已下载 |
| 配置 | `config/config.toml`（由 example 复制；**需自行填入 `api_key`**） |
| 本地补丁 | `app/config.py`：无 `[daytona]` 时不再强制 `daytona_api_key`（否则无法 import） |

启动：

```bash
cd "参考项目/OpenManus"
source .venv/bin/activate
# 编辑 config/config.toml 填入真实 API Key
python main.py
```

### Kortix / Suna

| 项 | 值 |
|---|---|
| 源码路径 | `参考项目/suna/`（VERSION **0.10.14**） |
| CLI | `~/.local/bin/kortix` · **v0.10.13** |
| 包管理 | pnpm **8.11.0** + bun **1.3.14**；`pnpm install` **已完成** |
| 全栈本地 | 官方推荐：`kortix self-host …`（Docker）或 `pnpm dev`（需 Dotenv Armor 解密 `apps/api/.env`） |
| Docker | Desktop 已可连上（本机另有 supabase/studio 等容器） |

常用下一步：

```bash
# A. 云端零本地栈
kortix login
kortix init
kortix ship

# B. 本机 Docker 自托管（交互配置）
kortix self-host doctor
kortix self-host init --tunnel cloudflare   # 或 --domain <你的域名>
kortix self-host start
kortix self-host open

# C. 贡献者开发栈（仓库内）
cd "参考项目/suna"
# 需：curl -sfS https://dotenvx.sh/armor | sh && dotenvx-armor login
pnpm dev          # web + API
pnpm nuke         # 拆本地 Docker
```

**说明：** 完整 `pnpm dev` / `self-host start` 还要密钥解密或引导式环境变量；安装层（CLI + node_modules + Docker 可用）已就绪，跑通产品还需你登录/填密钥。

---

## 四、参考源码树（分析对象，非本项目文档）

> 快照当时：`OpenManus` · `suna` · `opencode` · `hermes-agent` · `Raven` · `CodeWhale` · `goose` · `nanobot`。

**当前实际已检出**（以 `总目录.md` 第十一节为准）：`OpenManus` · `suna` · `opencode` · `hermes-agent` · `Raven` · `CodeWhale` · `goose` · `nanobot` · `openworker` · `open-design` · `MiMo-Code` · `MiroFish` · `codex` · `codepilot` · `pi` · `cline` · `kanban` · `codexmonitor`（+ 各仓库自带 README，未逐一列入上表）。

---

## 五、外部官方链接（安装/文档）

| 项目 | 链接 |
|---|---|
| OpenManus GitHub | https://github.com/FoundationAgents/OpenManus |
| Kortix / Suna GitHub | https://github.com/kortix-ai/suna |
| Kortix 文档 | https://kortix.com/docs |
| Kortix Cloud | https://kortix.com |
| Kortix 自托管指南 | https://kortix.com/docs/guides/self-hosting |
| Kortix CLI 安装 | `curl -fsSL https://kortix.com/install \| bash` |

---

*本文件是冻结于 CHANGELOG 阶段 17 的存档快照；现行索引见 [`总目录.md`](./总目录.md)，站点入口见 `html-hub.html`。安装状态见第三节。*