AdventureX 2026 参赛项目：一个可查询、可纠错、可行动的智能衣橱 Agent。
AdventureX 2026 · Web · AI Agent · Smart Wardrobe
柜蜜通过衣橱记忆、自然语言任务和可解释证据，帮助用户找衣服、理解衣橱并做购买决策。本仓库包含可独立运行的 Web 演示、本地契约 Agent 和接口文档；真实摄像头识别、线上数据库与第三方模型服务不在公开仓库内。
- 首页按照粉棕纸张拼贴基准设计；
- 单件衣物详情按照参考图的信息层级重做；
- 严格实现两份需求文档中的 P0 路径；
- Web 作为正式演示端，浏览器承载语音、图片、返回和后端连接；
- Agent、视觉识别、位置服务统一经后端网关接入；
- 没有后端时仍能稳定完成现场 Demo。
Web Browser
├── preview.html
├── platform-adapter.js
├── app.js / style.css
└── Agent Gateway
├── 本地 dev-agent（Demo / 契约验证）
└── 正式视觉与算法后端
└── 固定衣柜摄像头
界面继续使用 390 × 844 的移动端画布，在桌面浏览器中居中展示。原 Android 工程暂时保留，Android 构建、APK 和真机运行不在当前演示验收范围。
- 首页默认态；
- 全屏语音/文字/图片输入；
- 找衣服：查找中、唯一匹配、多个候选、位置不确定、未找到；
- 购买建议：等待上传、识别、最低限度追问、分析中、结果、决策收口；
- 空间衣橱总览；
- 黑色 B 站 T恤单件详情；
- 任务历史与继续上次问题；
- 衣橱洞察、今日搭配、衣橱更新时间线、愿景能力轻量页；
- 个人与设置；
- 个人叫法、购买决策、任务历史和想买清单的 Agent JSON 持久化；
- 学习页从 Agent 读取衣橱事实、学习记录并提交位置纠正。
- 首页点击圆形 Agent；
- 点击中央波形调用系统语音识别，或选择演示问题；
- 说“我的黑色 B 站 T恤在哪里？”；
- 查看衣物、右侧挂衣区 07、置信度、红框和事件证据；
- 点击“就是这件”保存个人叫法；
- 进入衣物详情查看完整故事。
- 首页点击“拍照问问该不该买”；
- 选择真实商品图片；
- 确认场景或选择“按现有信息继续”；
- 查看建议指数、相似衣物、搭配、场景增量和不确定性；
- 选择“喜欢 / 考虑中 / 已购买 / 不买”并保存。
在全屏输入页点击“多个候选”“位置不确定”或“未找到”演示问题。
在仓库根目录启动完整 Web Demo：
node dev-agent/server.cjs浏览器打开：
http://127.0.0.1:8766/preview.html
这个进程会同时提供页面和 Agent API，页面会自动连接当前地址，不需要再启动第二个 静态服务器。推荐使用最新版 Chrome 或 Safari。浏览器语音识别依赖本机浏览器能力； 文字输入和图片选择始终可用。
首页语音识别结果和文字输入会统一请求：
POST /v1/agent/route
仓库自带零依赖的本地契约 Agent，用于完整演示和接口验证：
node dev-agent/server.cjs启动后：
- 浏览器预览会自动连接页面当前所在的地址；
- 完整 Demo 为
http://127.0.0.1:8766/preview.html； - 健康检查为
http://127.0.0.1:8766/health。
本地契约 Agent 使用种子衣橱数据，所有业务响应都会返回
source_mode: "demo"，避免把演示结果误标为真实用户数据。真实服务只需实现
docs/API_CONTRACT.md 中的接口，即可替换本地服务。
默认启动时，任务上下文、购买决定、想买清单和用户确认的学习事实会写入
dev-agent/.data/agent-state.json。该目录已被 Git 忽略；可通过
AGENT_DATA_FILE=/受控路径/agent-state.json 覆盖。App 或 Agent 重启后，
“最近聊过”仍可读取原 resume_state 恢复画布，不会重新执行历史分析。
浏览器联调其他后端时，可打开：
http://127.0.0.1:8766/preview.html?backend=http://后端地址:端口
Agent 服务不可用时，前端只保留本地意图导航；需要衣橱事实的页面显示空态或失败态， 不会补入演示衣物、历史、购买证据或最近变化。
详细接口见：
docs/API_CONTRACT.mddocs/REQUIREMENTS_MATRIX.mddocs/WEB_VISION_ALGORITHM_HANDOFF.md
preview.html：正式 Web 演示入口；app/src/main/assets/platform-adapter.js：浏览器能力适配；app/src/main/assets/app.js：页面状态机、任务流和持久化；app/src/main/assets/style.css：完整视觉系统；dev-agent/server.cjs：本地契约 Agent；docs/API_CONTRACT.md：后端接口契约；docs/REQUIREMENTS_MATRIX.md：需求逐项对照。docs/TEAM_HANDOFF_TODO.md：当前进展、未完成能力、UI 接入状态与队友交接顺序。docs/WEB_VISION_ALGORITHM_HANDOFF.md：Web、视觉后端与真实摄像头的交接边界。
本版本没有重建项目，只替换首页表现层：
- 首页按照确认的粉调纸张拼贴参考图实现；
- “继续录入”替换为“衣服风格分析”；
- 所有首页入口均为真实可点击热区；
- 其他页面、任务状态、历史记录、语音/图片 AndroidBridge 和后端预留保持不变；
- 详细入口映射见
docs/HOME_SCREEN_IMPLEMENTATION.md。
解压后，直接打开当前目录（能直接看到 settings.gradle、build.gradle 和 app 的目录）。不要只打开 app 文件夹，也不要再套一层空目录。
进入“问问你的衣橱”页面后会自动启动语音识别，用户可以直接说话，不需要再次点击中央圆圈。第一次运行需要允许麦克风权限；中央圆圈仍可用于提前结束或重新开始识别。详见 docs/AUTO_LISTEN_CHANGE.md。
本批次继续基于同一个 Android 主工程开发，没有创建独立 App，也没有修改首页、自动聆听、找衣服和购买建议的既有接口。
首页点击“查看衣橱”后进入新的“我的衣橱”空间总览，包含：
- 线框式真实衣柜空间分区；
- 左右挂衣区、叠放区、抽屉区和鞋区；
- 衣橱画像、低利用率、最近变化、待确认和衣橱缺口；
- “AI 最近学会了 3 件事”入口；
- 右下角统一 AI Agent 入口。
“AI 学习中”支持：
- 正常学习状态；
- 刚开始认识状态；
- 从 Agent 动态读取已认识衣物、个人叫法、位置变化和最近学习记录；
- 加载、空记录和读取失败状态；
- 点击位置变化事件打开确认弹层；
- 位置正确、位置不对和“我也不确定”三个安全反馈入口；
- 通过右上角更多菜单查看数据来源并重新读取。
实现说明见 docs/WARDROBE_LEARNING_IMPLEMENTATION.md。
本批次继续基于同一个 Android 主工程修改：
- “查看衣物详情”进入用户确认的高保真单件衣物详情页；
- 保留返回、更多、编辑、查看分区、事件视频、完整故事、搭配记录和建议按钮的真实交互；
- 详情页继续使用原有 garmentData、导航状态机和 Agent/后端接口；
- 修正找衣服成功页底部输入栏，把被挤成竖排的文字改为单行“继续提问”；
- 未重写首页、自动聆听、空间衣橱、学习记录、购买建议和任务历史。
实现说明见 docs/GARMENT_DETAIL_EXACT_IMPLEMENTATION.md。
首页“衣服风格分析”现已进入完整的“我的衣橱洞察”页面：
- 总览（数据充足）；
- 总览（数据不足，与衣橱学习阶段联动）；
- 风格；
- 场景；
- 颜色；
- 购买临时页；
- 统一 Agent 浮动入口；
- 分享与完整报告接口占位。
本批次继续使用同一套 WebView 状态机、AndroidBridge、Mock/AgentGateway、衣物数据和导航结构，没有创建新 App，也没有添加第三方依赖。视觉结构沿用参考线框稿，并通过暖白纸张背景、低饱和粉棕、植物线稿、宋体标题和柔和阴影与首页设计统一。实现说明见 docs/WARDROBE_INSIGHT_IMPLEMENTATION.md。