# QozeCode 学习与改写档案

这套文档的目标不是“照抄一个开源 Agent”，而是：

1. **读懂** QozeCode 为什么这样拆、数据怎么流、每一层在解决什么问题
2. **练熟** ReAct / LangGraph / Tool Calling / 流式 TUI 这几块硬知识点
3. **改写成自己的项目**（新名字、新结构、自己能讲清楚的代码）
4. **再往上加自己的东西**（公司场景、Windows 体验、审批、内部工具）

源码位置：`D:\ideaProject\QozeCode-main`  
许可证：Apache 2.0（可以基于它做自己的项目，但**不要**直接换皮发布；改写时建议“架构借鉴 + 代码重写”）

## 怎么用这套文档

按这个顺序读，不要跳着抄：

| 顺序 | 文件 | 用途 |
|------|------|------|
| 1 | [01-架构与调用链.md](./01-架构与调用链.md) | 先建立全局图：模块、启动、一轮对话怎么走完 |
| 2 | [02-知识点地图.md](./02-知识点地图.md) | 每个模块对应要掌握的概念、该看哪段源码 |
| 3 | [03-学习与改写计划.md](./03-学习与改写计划.md) | 分阶段时间表：精读 → 最小复刻 → 增强 |
| 4 | [04-最小复刻清单.md](./04-最小复刻清单.md) | 自己项目的 MVP 文件清单和验收标准 |
| 5 | [05-差异化增强方向.md](./05-差异化增强方向.md) | 读懂之后往上加什么，避免做成第二个 Qoze |
| 6 | [开发方案/](./开发方案/README.md) | G-CODE 工程方案：产品决策、Windows 输入、架构、分期 |

G-CODE 源码目录（尚未建库）：`D:\ideaProject\gcode`

## 一句话定位

QozeCode = **LangGraph 上的 ReAct 循环** + **给模型的一篮子工具** + **Textual 终端聊天气泡** + **Skill / MCP / Subagent 三套插件层**。

README 里写得很满（Plan 模式、浏览器、语音）。当前这份源码里，有些能力已经注释或未落地。精读时以**代码为准**，宣传文案只当“产品愿景”。

## 建议的改写原则

- 先跑通「用户一句话 → 模型思考 → 调工具 → 再思考 → 回答」
- 每一层都自己写一遍，能向别人讲清楚
- 不追求一开始就有 TUI、MCP、Subagent
- 公司场景（GitLab / Jenkins / Java）放到增强阶段，不要一开始就塞进去