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.
2.2 KiB
2.2 KiB
QozeCode 学习与改写档案
这套文档的目标不是“照抄一个开源 Agent”，而是：
- 读懂 QozeCode 为什么这样拆、数据怎么流、每一层在解决什么问题
- 练熟 ReAct / LangGraph / Tool Calling / 流式 TUI 这几块硬知识点
- 改写成自己的项目（新名字、新结构、自己能讲清楚的代码）
- 再往上加自己的东西（公司场景、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）放到增强阶段，不要一开始就塞进去