G-Code/项目资料/开发方案/00-产品定义.md

00 产品定义

一句话

G-CODE 是跑在 Windows 上的个人 Coding Agent：用户在终端里下任务，模型按 ReAct 循环读文件、改文件、跑命令、必要时开浏览器；过程画在自研 TUI 上。经典 CMD 无法承载 TUI 中文输入时，自动回退 REPL，保证还能干活。

它不是什么

• 不是 QozeCode 换皮
• 不是 IDE 插件，也不是 Web 对话页
• 不是「十家模型 + 语音 + 菜单栏」的功能全集

两条路径

路径	作用
参考	D:\ideaProject\QozeCode-main
实现	D:\ideaProject\gcode
方案	本目录

已拍板

决策	选择
主界面	自研 Textual TUI。模块：消息列表、思考区、工具状态、底部输入。观感可与 Qoze 大差不差，品牌 / CSS / 文案自己写
Windows 输入	方案 C：能跑 TUI 的终端开 TUI；conhost / 经典 cmd 拒绝 TUI，提示改用 Windows Terminal，并自动进入 REPL
cmd 里 TUI 打中文	不作为验收项（业界基本做不到）
多模型	yaml 注册表；一期只实现 openai_compatible（DeepSeek / 千问 / 智谱 / Kimi / Azure 兼容 / LiteLLM / Agicto）
浏览器	只做 Microsoft @playwright/mcp。无 Node 则提示不可用，不做 Python Playwright 备选
人在回路	写文件展示 diff 后 y/N；跑命令展示命令后 y/N。拒绝则写回 ToolMessage，模型改方案
配置根	单一 home：Windows 用 %APPDATA%\gcode，项目级用 <cwd>/.gcode

一期做

• LangGraph 两节点 ReAct：llm_call ⇄ tool_node
• 工具：读文件、列目录、精确替换、执行命令（含 Windows 编码与超时杀进程）
• HITL、SQLite 会话、短静态 prompt + 动态上下文
• 终端探测 + TUI + REPL 回退 + /edit
• 模型注册表与启动选模型
• 薄 MCP 客户端，默认只接 Playwright MCP

一期不做

• Skills、Subagent、Plan 模式（Qoze README 有、代码无，G-CODE 不宣传未实现功能）
• Island 菜单栏、语音 / PyAudio、飞书
• 进程内 Playwright、chrome-devtools-mcp（附着已开 Chrome，不是 Playwright）
• Vertex / Anthropic / Bedrock 原生协议
• 全局单例 llm / agent；工具反向 import 图模块

验收原则

1. 以代码为准，文档不写没做的功能
2. 核心图不依赖 TUI：REPL 与 TUI 都只消费 astream
3. 能 15 分钟讲完：输入从哪进、图怎么转、工具如何确认、会话存在哪
4. 密钥只放用户目录或环境变量，不进 git