You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

40 lines
2.2 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 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放到增强阶段不要一开始就塞进去