Atoms Demo

一句话描述想法 → Emma 产品方案 → 你批准 → Alex 生成可交互网页 → 右侧预览 / 对话迭代 / 版本回滚 / 分享导出

面向 ROOT / 深度赋智研发笔试的可运行 Demo，对标 Atoms 的核心工作流：用 AI 把场景快速做成可体验产品，而不是重造整个 Atoms 平台。

在线地址

项	链接
可访问 Demo	https://atoms-demo-drab.vercel.app/grkj （一点即开 Lab）
工坊首页	https://atoms-demo-drab.vercel.app/
GitHub 仓库	https://github.com/admin12336/atoms-demo

能力实验室（简历配套）

路径：/grkj → /lab（无模型 Key 可完整体验）

模块	展示能力	接口
SSE 流式	POST+JSON Body、Abort、有 Key 真流	POST /api/lab/sse
迷你 RAG	BM25、空结果禁编造、requestId	POST /api/lab/rag
两阶段 Agent	Mock≠软超时；ContractGuard 跳点	POST /api/lab/planner
填表 Agent	槽位 + lookupCompany mock	POST /api/lab/form-agent
Java 契约	Spring Result 风格 code/message/data/requestId；驾驶舱指标	POST /api/lab/java
业务机器人	行程 / RAG / 填表 / 审批 意图路由	POST /api/lab/bot
工坊 Agent	build/iterate SSE + Abort + 限流	POST /api/projects/[id]/agent

对应简历：TripPal、私域知识库、表单 Agent、园区驾驶舱、档案审批；覆盖 Java / 前端 / 后端 / 机器人 / AI。

3 分钟面试话术（打开 /grkj）

1. 开场：这是简历配套能力实验室，无 Key 可演示；Java 模块演示 Spring Result 契约，宿主是 Next.js。
2. 点「一键跑通」：自动覆盖机器人四意图、驾驶舱指标、RAG 空结果、Planner 软超时、填表、SSE。
3. 对齐简历讲：
   • 机器人行程 → TripPal
   • 故障码 / RAG → 私域知识库 + H5
   • 查询公司 grkj → 表单 Agent
   • 档案审批 → 审批后台
   • Java 驾驶舱 → 园区可视化数据面
4. 深潜 1～2 个点：SSE Abort、Planner「Mock ≠ 软超时」、空结果不编造。
5. 收口：可演示、可降级、可对齐项目边界；需要完整工坊生成网页可回首页注册进入 Studio。

5 分钟自测

1. 打开 https://atoms-demo-drab.vercel.app/grkj → 点 一键跑通
2. 顶部勾选应变绿（机器人 / Java / SSE / RAG / Planner / 填表）
3. （可选）注册 → 进入工坊
4. 点模板「习惯打卡」或输入任意中文需求
5. 查看 Emma 方案 → 批准并生成
6. 右侧预览可点击交互；切换手机/平板尺寸
7. 对话「把主色换成绿色」触发迭代；版本下拉可回滚
8. 导出 HTML / 分享预览；侧栏可见 Open-Meteo 天气

笔试要求对照

要求	实现
真实交互 UI	沙箱 iframe 内可操作的完整 HTML 应用
数据持久化	用户/项目/版本写入服务端 data/store.json；生成应用内用 localStorage
初始化 / 注册登录 / 主流程	注册登录 → 建项目 → 方案批准 → 生成 → 迭代
至少一个第三方能力	OpenAI 兼容 LLM（DeepSeek 等）+ Open-Meteo 天气
可公网访问	支持 Vercel / Railway 部署（见下方）
说明文档	本 README + DELIVERY.md

主流程

注册/登录
  → 描述需求（或选模板）
  → Emma 产出方案
  → 批准并生成
  → Alex 输出单文件 HTML
  → Canvas 预览 + 迭代 + 回滚 / 导出 / 分享

角色说明：

• Mike：本地状态机协调（不单独调模型）
• Emma：需求 → 结构化 BuildPlan
• Alex：按方案生成 / 迭代完整 HTML

本地启动

cd atoms-demo
cp .env.example .env.local
npm install
npm run dev

打开 http://localhost:3000。

环境变量

变量	说明
OPENAI_API_KEY	DeepSeek / OpenAI 等兼容平台密钥
OPENAI_BASE_URL	默认 https://api.deepseek.com/v1
OPENAI_MODEL	默认 deepseek-chat
AUTH_SECRET	Cookie 签名密钥
ALLOW_DEMO_MODE	无密钥时启用内置演示生成（默认 true）

未配置 API Key 时，系统自动进入演示模式，仍可走完全流程，便于先交可运行版本。

部署建议

Vercel（前端公网最快）

1. 把本仓库推到 GitHub（Public）
2. vercel.com Import 项目
3. 配置环境变量（同上）
4. Deploy → 得到公网 URL

注意：Vercel Serverless 无持久磁盘，默认内存+冷启动可能导致进程重启后本地 JSON 丢失。演示账号/项目若需跨实例持久，可改接 Neon / Turso；笔试 PoC 也可用「演示模式 + 当场注册体验」说明边界。

Railway（推荐有持久化）

1. New Project → Deploy from GitHub
2. Root Directory: atoms-demo（若仓库根在上一级）
3. Start: npm run build && npm run start
4. 挂载持久卷到 /app/data（如使用）

技术栈

• Next.js 15 App Router + TypeScript
• 服务端 JSON 存储、HttpOnly Cookie 会话、bcrypt 密码哈希
• OpenAI SDK（兼容 DeepSeek）
• Open-Meteo REST API

目录

src/app/api/          注册登录、项目、Agent、天气、分享
src/app/studio/       工坊三栏：项目 / 对话 / 预览
src/lib/llm.ts        Emma / Alex 调用与演示回退
src/lib/db.ts         持久化
DELIVERY.md           设计思路与完成度说明