Director AI 形象总监 MVP

Director 是一个面向个人用户的 AI 形象咨询 MVP。用户上传正面、侧面和头顶/整体造型三张照片后，系统生成形象完成度评分、气质定位、发型建议、穿搭建议和可直接交给发型师的沟通卡。

在线体验：Director AI 形象顾问

当前仓库同时包含 Web 原型、微信小程序和共用的 Node.js AI 代理。第一阶段用于邀请种子用户验证“用户是否愿意上传照片、信任报告并实际采用沟通卡”。

当前状态

• Web：React 19、TypeScript、Vite。
• 微信小程序：Taro 4.2、React 18、TypeScript。
• 后端：Node.js，同源提供静态 Web 与 /api/analyze。
• 模型：小米 MiMo OpenAI 兼容接口，默认 mimo-v2.5。
• 安全边界：API Key 仅保存在服务端环境变量；照片只在内存中处理，不写入数据库或对象存储。
• 输入保护：服务端拒绝无人脸、多人、严重模糊、过暗或大面积遮挡的照片，不为不合格输入生成评分。

Web 演示已部署到公网 HTTPS 地址。当前仍无正式微信 AppID 和已备案自定义域名，因此该地址用于简历和 Web 体验，不能直接作为微信小程序正式发布条件。发布体验版前请参考 部署与发布清单。

目录

src/                  Web 源码
miniapp/src/          微信小程序源码
server.mjs            HTTP 服务与 MiMo 请求
server-utils.mjs      输入校验、报告解析和限流
docs/                 需求、架构、隐私与部署文档
test-assets/README.md 测试素材来源说明（第三方图片不提交）

本地运行

需要 Node.js 18 或更高版本。

npm ci
npm ci --prefix miniapp

复制环境变量模板并填写新的服务端 Key：

cp .env.example .env.local

不要将 .env.local、用户照片或微信开发者工具私有配置提交到 Git。

启动后端与 Web：

npm run dev

启动小程序增量构建：

npm run miniapp:dev

随后使用微信开发者工具导入 miniapp/。当前测试 AppID 为 touristappid。

验证

npm test
npm run build
npx tsc --noEmit --project miniapp/tsconfig.json
npm run miniapp:build

GitHub Actions 会对每次推送和拉取请求执行同样的测试与双端构建。

隐私与部署

• 照片与隐私政策草案
• Docker、HTTPS 与微信发布说明
• 产品需求
• 架构设计
• App 任务交接

公开测试前需要补充正式运营主体与隐私联系渠道，并轮换所有曾在聊天、日志或截图中出现过的 API Key。

许可

仓库当前未声明开源许可证。在版权所有者明确选择许可证前，默认不授予复制、修改或再分发权利。