# G-CODE 开发方案

本目录是 **G-CODE 要做成什么样、先做什么**。  
上级目录（`../01-架构与调用链.md` 起）是 **怎么读懂 QozeCode**。先精读，再按这里开工。

| 路径 | 用途 |
|------|------|
| 参考实现 | `D:\ideaProject\QozeCode-main`（只借鉴架构，不换皮复制） |
| G-CODE 源码 | `D:\ideaProject\gcode`（尚未建库；按 [03-分期实施与优化清单.md](./03-分期实施与优化清单.md) 再开） |
| 本方案 | `D:\myProgram\Learning\ai-coding改写\开发方案` |

许可证：QozeCode 为 Apache 2.0。G-CODE 自己重写同构实现，保留「能讲清楚」优先于「功能一样全」。

## 怎么读

| 顺序 | 文件 | 用途 |
|------|------|------|
| 1 | [00-产品定义.md](./00-产品定义.md) | 一句话、做/不做、已拍板决策 |
| 2 | [01-Windows中文输入方案.md](./01-Windows中文输入方案.md) | 方案 C：检测终端、TUI / REPL |
| 3 | [02-架构与目录.md](./02-架构与目录.md) | 分层、prompt、多模型、HITL、Playwright MCP |
| 4 | [03-分期实施与优化清单.md](./03-分期实施与优化清单.md) | 阶段、验收、相对 Qoze 的优化 |

## 一句话

> G-CODE：跑在 Windows 上的个人 Coding Agent。主界面是自研 TUI；经典 CMD 里自动回退 REPL 以保证能打中文。默认 OpenAI 兼容协议；改文件和跑命令前要确认；浏览器只走 Playwright MCP。

## 已拍板（摘要）

- 主界面：自研 Textual TUI（观感可接近 Qoze，实现自己写）
- Windows：方案 C（conhost 拒绝 TUI → 提示 Windows Terminal → 回退 REPL）
- 多模型：yaml 注册表 + `openai_compatible`
- 浏览器：只接 `@playwright/mcp`，无 Node 则提示不可用，无 Python 备选
- 安全：写文件出 diff 确认；shell 出命令确认
- 一期不做：Skills、Subagent、Plan 模式、Island、语音、飞书、Vertex/Anthropic 原生协议