将模糊的成长思绪，转化为立刻能做的第一步。
MindEcho 是一款交互式 AI 成长伙伴应用。通过 提炼 → 排序 → 拆解 三阶段流水线，把"我想学一门新乐器"这样模糊的想法，变成"今天打开 XX 网站注册账号"这样具体的行动。
核心特点：
- 降低行动门槛 — AI 将大目标拆解为"第一步就能做"的微任务
- 逐步引导执行 — 每个子步骤都有 AI 实时指导，遇到问题随时提问
- 自带 Key 更自由 — 填入自己的 API Key，AI 调用无上限，数据不经过服务端存储
- 玻璃态 UI — 鼠尾草绿浅色模式 + 暗黑模式一键切换
- Go 1.21+
- Node.js 18+（npm 9+）
cd backend
cp .env.example .env # 可选：配置默认 API Key 等
go mod download
go run cmd/server/main.go后端监听 http://localhost:8080。
cd frontend
npm install
npm run dev前端监听 http://localhost:5173，Vite proxy 自动转发 /api 到后端。
打开 http://localhost:5173 ，使用开发测试账号：
| 用户名 | 密码 | 配额 |
|---|---|---|
dev01 |
Dev@1234 |
任务数 ∞ / AI 调用 ∞ |
登录后进入 设置 → AI 配置，填入你的 OpenAI 兼容 API Key：
- API Key — 如
sk-... - Base URL — 如
https://api.openai.com/v1（也支持 DeepSeek、Qwen、本地 LLM） - Model — 如
gpt-4o-mini
保存后立即生效。不配置则使用后端默认 Key 或 Mock 模式。
输入想法，AI 提炼核心目标、识别情绪、给出包含预期效果的建议。
AI 生成 3-5 个步骤，你可以拖拽调整顺序，然后让 AI 细化为每步 2-3 个可执行子步骤。
执行子步骤时点击"AI 指导"，获得 3-5 条"打开什么网站、点什么按钮"级别的具体步骤，逐条确认。遇到问题随时提问，AI 简短回答。
| 角色 | 任务数 | AI 调用 |
|---|---|---|
开发测试账号 (dev01) |
∞ | ∞ |
| 使用自有 API Key 的用户 | — | ∞ |
| 普通用户 | 3 次/天 | 5 次/天 |
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /api/auth/login |
否 | 登录 |
| POST | /api/auth/register |
否 | 注册 |
| GET | /api/auth/me |
是 | 当前用户信息 |
| POST | /api/v1/analyze |
是 | 思绪分析 + 初始计划 |
| POST | /api/v1/finalize_plan |
是 | 计划细化（生成子步骤） |
| POST | /api/v1/chat |
是 | AI 聊天（非流式） |
| POST | /api/v1/chat/stream |
是 | AI 聊天（SSE 流式） |
| GET | /api/v1/ai/config |
是 | AI 配置状态 |
| 变量 | 默认值 | 说明 |
|---|---|---|
PORT |
8080 |
监听端口 |
SECRET_KEY |
change-this-in-production |
JWT 签名密钥（生产必须修改） |
ACCESS_TOKEN_EXPIRE_MINUTES |
60 |
Token 过期时间（分钟） |
USE_MOCK_API |
true |
无 API Key 时是否回退 Mock |
OPENAI_API_KEY |
— | 后端默认 API Key |
OPENAI_BASE_URL |
https://api.openai.com/v1 |
API 地址 |
OPENAI_MODEL |
gpt-4o-mini |
默认模型 |
DEV_USERNAME / DEV_PASSWORD |
dev01 / Dev@1234 |
开发测试账号 |
前端通过设置页动态配置 API Key，无需环境变量文件。API Key 存储于浏览器 localStorage，仅在本机使用。
详见 CONTRIBUTING.md，包含技术架构、目录结构、编码规范与开发约束。
变更记录详见 CHANGELOG.md。
MIT