b0fce840a3
包含前端源码、预构建产物（dist/）、零依赖 Node.js 服务器（server.mjs）、 Cloudflare Worker 版本（worker/）、部署文档（DEPLOY.md）和交接文档。 技术总监可直接 clone 后运行 node server.mjs 启动，无需安装 React 或 build。 DEEPSEEK_API_KEY 通过环境变量注入，未纳入仓库。
32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# 脑晴测 H5
|
||
|
||
一个无需登录的中文数字认知评估 H5，包含处理速度、执行功能、注意力和工作记忆四项任务，以及 DeepSeek 辅助生成的非医疗化表现报告。
|
||
|
||
## 技术栈
|
||
|
||
- React 19 + Vite
|
||
- TypeScript/JSX（业务代码不依赖复杂类型系统，后续可平移至 Taro React）
|
||
- Phosphor Icons
|
||
- Cloudflare Worker / Vite 本地中间件代理 DeepSeek
|
||
|
||
## 本地运行
|
||
|
||
1. 复制 `.env.example` 为 `.env`。
|
||
2. 在 `.env` 中设置服务端 `DEEPSEEK_API_KEY`，不要添加 `VITE_` 前缀。
|
||
3. 安装依赖并运行 `pnpm dev`。
|
||
|
||
## 验证命令
|
||
|
||
- `pnpm run check:runtime`
|
||
- `pnpm run build`
|
||
- `pnpm run test:sites`
|
||
|
||
## 隐私与安全
|
||
|
||
- API Key 不进入浏览器构建产物。
|
||
- 测试结果默认仅保存在当前浏览器 `localStorage`，用于显示最近一次报告。
|
||
- 调用 AI 时仅发送基础范围、四维指标和事件数量，不发送姓名、手机号等身份信息。
|
||
- 上线部署时应将 `DEEPSEEK_API_KEY` 配置为服务端 Secret。
|
||
|
||
详细任务规则见 [GAME-DESIGN.md](./GAME-DESIGN.md)。
|