G-Code/项目资料

QozeCode 学习与改写档案

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

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

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

怎么用这套文档

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

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

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

一句话定位

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

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

建议的改写原则

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