GoCode 是一个面向开发者的 AI 桌面应用，用来从一个空文件夹开始，通过「需求头脑风暴 -> Harness 文件生成 -> feature 逐项执行」的流程，把项目想法推进成可运行的工程。它将 Electron 桌面端、Hono API、React 前端和 DeepAgentsJS 执行引擎组合在一起，让 AI 既能参与需求澄清，也能按任务清单持续落地代码。
本项目的 Harness 工作流学习并参考了 Learn Harness Engineering 的理念：通过明确的规则、状态文件、任务边界和验证闭环，让 AI 编程智能体在跨会话、长任务和真实工程环境中更可靠地推进开发。GoCode 将这些方法产品化为桌面应用流程，用可视化配置、文件审查、功能清单和执行页面来管理从需求到代码落地的全过程。
- AI 头脑风暴：通过对话澄清项目目标、用户流程、技术选择和交付范围。
- Harness 文件生成：自动生成项目说明、产品文档、架构文档、功能清单、进度记录等开发入口文件。
- 文件审查与确认：在写入目标目录前预览 AI 生成的文件内容。
- 任务执行页：读取
feature_list.json，按功能状态执行「实现下一个」或「实现全部」。 - 流式交互体验：支持 Markdown 消息、SSE 流式输出和工具调用状态展示。
- 本地优先：Electron 内嵌 Hono 服务，配置和目标项目目录都在本机管理。
- 想用 AI 从零启动项目的独立开发者。
- 希望先把需求、架构和任务拆分固化下来，再让 AI 执行的团队或个人。
- 想把「一次性聊天写代码」升级为「有计划、有文档、有进度记录」工作流的用户。
- TypeScript
- Bun workspace
- Electron
- React + Vite
- Hono
- DeepAgentsJS
- DeepSeek
- 已安装 Bun
- 已准备 DeepSeek API Key
- 可选：Tavily API Key，用于搜索增强能力
bun installbun run dev启动后打开：
- Web 前端：
http://localhost:5173 - Hono API：
http://localhost:61405
开发命令会同时启动 Hono API 服务和 Vite 开发服务器，前端的 /api 请求会代理到本地 Hono 服务。
- 打开配置页，填写 DeepSeek API Key、可选 Tavily API Key，并选择目标项目目录。
- 进入头脑风暴页，与 AI 对话澄清项目需求。
- 在右侧面板审查 AI 生成的 Harness 文件。
- 确认后将 Harness 文件写入目标项目目录。
- 进入执行页，按
feature_list.json自动或手动执行任务。 - 每个任务完成后更新进度文档，并生成对应的 Git 提交。
bun run dev # 启动本地开发环境
bun run check # TypeScript 类型检查
bun run test # 运行服务端测试
bun run test:all # 运行服务端和前端测试
bun run build:web # 构建前端GoCode/
├── apps/
│ ├── electron/ # Electron 主进程、窗口创建、本地配置加密
│ ├── server/ # Hono API、Agent 工厂、DeepAgents 管理
│ └── web/ # React 前端、SSE 消费、交互界面
├── packages/
│ └── shared/ # 共享类型定义
├── scripts/
│ └── dev.ts # 开发环境启动脚本
├── docs/ # 产品、架构、设计文档和演示视频
├── feature_list.json
├── progress.md
└── PROJECT_BRIEF.md
GoCode 运行时需要以下配置：
- DeepSeek API Key：用于 AI 对话和任务执行。
- Tavily API Key：可选，用于联网搜索能力。
- 项目目录：AI 生成 Harness 文件和执行任务的目标目录。
MVP 阶段采用本地桌面应用形态，Electron 主进程负责窗口与安全存储，Hono 负责 API 和 Agent 调度，React 前端通过 HTTP/SSE 与后端通信。
项目处于 MVP 开发阶段，核心目标是完成配置页、头脑风暴页和执行页三段式流程。详细进度见 progress.md，功能拆分见 feature_list.json。