HelloLLM

依据论文《Dive into Claude Code》(arXiv:2604.14228v2) 图1 七组件模型重建的最简可交互 AI 编码 Agent。

仓库结构（教程式：每个阶段 = 完整项目包）

HelloLLM/
├── S01-basic-loop/             # 阶段一：CLI 入口层 + Agent-Loop（完整项目）
└── S02-basic-permission/       # 阶段二：S01 fork + Permission System 最小子集（完整项目）
    ├── hello_llm/              #   Python 包（entrypoints / query / config / providers / tools / logging / permissions）
    ├── tests/                  #   47 项单元测试
    ├── docs/                   #   开发规范文档（v2.0，带可伸缩侧边导航）
    ├── pyproject.toml          #   项目配置
    ├── README.md               #   项目说明
    └── requirements.txt        #   运行时零第三方依赖（纯标准库）

后续阶段（权限系统 / 会话持久化 / MCP / 压缩流水线 / Hook / 子 Agent）将作为 S02-*、S03-* 并列完整项目包放入仓库根。

阶段结构约定： 每个阶段目录 = 截至该阶段的完整最新版项目包 （自包含、可直接运行，不是增量补丁）；新阶段在上一阶段基础上按开发需求新增， 同时继承并升级全部既有内容；每阶段 docs/ 均保留截至该阶段的开发规范。

快速开始

cd S01-basic-loop
python3 -m venv .venv
.venv/bin/python -m pip install -e .
# 配置 API key：~/.hellollm/config.json（详见 S01-basic-loop/README.md）
.venv/bin/python -m hello_llm          # 交互 REPL
.venv/bin/python -m hello_llm -p "你好" # 无头单次