麦当劳 × Rokid 眼镜点餐助手

一句话说出想吃的，眼镜帮你找店、选餐、核价；真正提交，仍由你按键确认。

面向 Rokid 眼镜使用者及 麦当劳 MCP 应用开发者的语音点餐项目。使用 AIUI 原生 Page，在 480 × 352 画布中结合语音与按键操作。真实模式下，眼镜直接连接麦当劳 MCP；电脑不必常开，支付仍在手机麦当劳端完成。

本项目为独立开发的参赛作品，非麦当劳或 Rokid 官方产品。餐品、库存、价格与优惠可用性以官方实时响应为准。

快速导航： 界面演示 · 快速开始 · 语音示例 · 架构 · MCP 接入 · 验证与限制 · 参赛声明

当你不方便拿出手机时，先把“想吃什么”说清楚，再用眼前的小屏核对细节。眼镜承担查询和选择，用户保留对门店、规格、数量、金额和最终提交的控制。

• 一句话，多个需求。 “两份巨无霸、一份薯条，到店自取”，分别保留餐品、数量和就餐方式，不把整句话当作搜索词。
• 先核实，再选餐。 选择真实门店后，根据其 MCP 菜单匹配；唯一明确餐名可打开详情，模糊或同名结果交给用户选择，不自动加购。
• 为眼镜收紧列表。 每批最多5项，编号从 (1) 开始，支持本地换批和按序号选择，减少页面数据与渲染负担。
• 购物车可以反悔。 支持修改数量、按序号或完整餐名删除整行、清空购物车、撤销最近一次删除。
• 金额来自真实算价。 商品小计使用算价返回值；无法可靠对应时显示“价格待核实”。没有可匹配优惠券时跳过选择页。
• 提交留给确认键。 语音可以准备流程，新增地址、领券、创建及取消订单仍需在对应确认页按键提交；结果不明时先核实，不自动重试。

GIF 来自本地真机演示窗口，约 19 秒；展示语音点餐、餐品规格、购物车和支付前确认流程，不代表完整真实交易验收。

下列图片包含个人工程的既有真机记录，以及本次基于1.5.52源码重跑的隔离 Ink / Mock 场景。真机、Mock 与 Figma 设计稿分开标注，不是在线演示或公开版全流程真机验收。订单图已遮盖订单号、取餐号及门店信息。

真机首页 · 原应用1.5.46	隔离 Ink / Mock · 语音选餐与批次
隔离 Ink / Mock · 购物车操作	隔离 Ink / Mock · 清空后撤销
隔离 Ink / Mock · 规格多选	真机订单状态 · 原应用1.5.52，已脱敏
隔离 Ink / Mock · 1.5.52 · 就餐方式	隔离 Ink / Mock · 1.5.52 · 门店地址与编号
隔离 Ink / Mock · 1.5.52 · 餐品详情	隔离 Ink / Mock · 1.5.52 · 算价确认样本

可编辑设计稿及流程总览见真机同步设计说明。画面内文案保留中文；英文项目说明见English README。

完整操作路线见演示指南。Mock 中的餐品、价格和状态是隔离样本，不能据此判断真实可售性或报价。

aiui/
├── pages/index/index.ink        原生 AIUI 页面入口
├── components/                  页面布局、控件和展示逻辑
├── runtime/                     设备 bundle、定位与运行时适配
├── config/                      配置示例与本地生成凭证
├── assets/                      品牌、图标和第三方声明
├── app.js / app.json            AIUI 应用入口配置
device/
├── gateway/                     MCP 网关、传输和请求
├── storage/                     设备存储与提交记录
├── validation/                  生成的契约校验器
├── entry.ts                     设备 bundle 入口
└── test/                        设备与网关测试
server/
├── api/                         HTTP 入口
├── domain/                      服务端领域适配
├── mock/                        隔离 Mock 网关与 fixture
├── service/                     Node 服务编排与 MCP 适配
├── db/                          数据库访问
├── types/                       服务端类型
└── test/                        服务端测试
shared/
├── domain/                      领域模型、类型与存储契约
├── menu/                        菜单与餐品匹配
├── order/                       订单意图
├── contracts/                   MCP 结果与服务契约
├── view/                        页面视图状态
└── platform/                    平台兼容工具
scripts/                         配置、构建、打包和 Ink 验证
docs/                           PRD、设计说明、验证记录和公开演示素材

local/、artifacts/ 和 node_modules/ 是本地配置或构建目录，不属于公开运行必需文件。

需要 Node.js 22.13 或以上版本及 npm。

git clone https://github.com/JellyFlow/Mcdonalds_in_RokidGlasses.git
cd Mcdonalds_in_RokidGlasses
npm ci
npm run build:device
npm test
npm run typecheck
npm run check:docs
npm run check:public

这条路线使用隔离 Mock 测试，不需要眼镜、不连接真实业务账号，也不执行真实业务写操作。

另外安装可用的 aix CLI。项目曾在 CLI 0.10.1、Ink预览0.18.0及真机Ink0.20.0环境验证；宿主版本差异可能影响按键和语音。

# 在项目根目录执行，无需真实 MCP Token
npm ci
npm run configure:mock
npm run build:device
npm test
npm run verify:ink

此命令运行实际 Ink Page，使用原生键事件、Mock 网关及模拟识别文本；不代表真实麦克风通过。自动化脚本默认使用 macOS 的 Chrome 路径，需要该浏览器；其他系统需调整脚本中的 Chrome 启动路径。

configure:mock 自动生成被 Git 忽略的 aiui/config/credentials.js、aiui/agent.json 和 local/app-identity.json，无需手动填写凭证。它会覆盖本地连接配置，但保留已有应用身份。

Mock Token 不会自动切换业务网关。 只有上述 verify:ink 路线会在临时 Page 中注入 Mock 网关和模拟识别文本；普通 preview 以及直接打包、安装均不能当作隔离 Mock。修改模拟数据的位置及恢复真实配置的方法见开发文档的 Mock 步骤。

先在麦当劳 MCP 平台申请自己的 Token，再按本地配置与安装指南配置环境变量、生成本地凭证和独立应用身份，执行打包及安装。

# 先在当前终端设置自己的 MCD_MCP_TOKEN，再执行：
npm run configure
npm run pack
npm run install:device
# 单设备且已完成 ADB 授权；多设备须显式传入序列号

本仓库不分发个人版 AIX 或含凭证源码压缩包。 本地生成的 AIX 会包含你的设备端连接凭证，只能由你私下使用，不能上传或当作通用安装包分发。首次本地配置会生成独立应用身份，不复用作者个人版身份；后续升级复用自己的 local/app-identity.json，不提供清数据操作。

高德 Web Key 是可选的地址解析辅助配置，未配置时使用现有位置输入恢复入口；门店距离始终展示麦当劳 MCP 返回值，不使用高德计算距离。

首页先说“乐奇”唤醒；支持自动监听的页面进入后监听一次，最长15秒，再等待最终结果最多3秒，不无限重录。结束后可再次唤醒。

方向键移动焦点，确认键激活；录音时 Enter 结束、返回取消。语音“返回”走上一级。订单状态页的物理双击退出属于宿主相关能力，独立真机验收仍待明确确认，详见验证与限制。

flowchart TD
    User[用户语音与按键] --> Page[AIUI 原生 Page / Ink]
    Page --> Core[共享业务状态机 / TypeScript]
    Core --> Gateway[MCP 网关 / 官方 SDK]
    Gateway --> Protocol[协议解析与工具契约校验]
    Protocol <--> MCP[麦当劳 MCP Server]
    Core --> View[展示映射 / 当前批次 / 焦点滚动]
    View --> Page
    Core <--> Storage[设备本地会话与待核实记录]
    Core -.隔离测试.-> Mock[Mock Gateway]
    Core -.兼容入口.-> Node[可选 Node HTTP 服务]

• UI： 原生 AIUI .ink、WXSS；不依赖 React 页面，也不要求触屏。
• 业务： TypeScript共享核心，支持设备本地运行及Node兼容服务。
• MCP： 官方 SDK + Streamable HTTP；解析JSON/TOON，校验入参、响应及运行时工具契约。
• 状态： 设备本地存储会话；删除撤销快照仅内存保存，不持久化。
• 测试： Node测试运行器、隔离Mock、类型检查及实际Ink键控验证。

详见MCP调用流程与工具说明及工程目录与构建说明。精简显示只能降低本地渲染负担，不等于缩短上游网络耗时。

公开版基于原工程1.5.52；原工程已有189项业务与Page测试，本仓库新增公开配置测试。当前实际执行结果及版本范围见验证记录。

• 已有真机证据和佩戴者反馈覆盖部分查询、语音选餐及购物车操作，不等于新账号从安装到下单的完整验收。
• 原工程“订单状态页双击到系统桌面”尚未取得明确独立验收，不能仅凭 window.close() 模拟调用判定通过。
• 实际菜单、价格、可用券及预约能力受门店、账号、网络和平台工具契约影响；变化时拒绝冒险提交。
• 本次公开整理不执行真实领券、地址新增、下单或取消，不处理支付，不声称完成全部交易链路。

• 产品需求与范围：本仓库可独立阅读的需求摘要。
• 设计与交互说明：布局、编号、监听与确认规则，附设计样例。
• 来源与版本历史：工程、PRD及设计仓库关系与基线。
• MCP 接入说明、脱敏配置示例、官方参赛声明。
• 本项目拟参与麦当劳程序员创意开发大赛，报名结果以官方Issue系统回复为准，见报名记录。

欢迎通过Issue报告设备版本、复现步骤及脱敏画面；请勿提交Token、个人订单或地址。代码修改先阅读贡献指南，运行测试并保持确认保护。

自有代码采用MIT许可。品牌、食品图片、第三方图标等不随代码授予商标或素材使用权，详见第三方声明。