慢慢点 · ManManDian

愿陪这一程，把每一步都放慢，
由你来作主，把真菜单摊开来看。
声音可以化成字，字大路也宽，
手上节奏跟着你，一项一项稳稳选完。
三十元守住三十元，预算清清楚楚算，
每个排除项原样保留，选择由你来判断。
愿每一次“我自己来”，都有耐心作伴，
愿一顿寻常的热饭，入口有味，心里有暖。

Take every step at your own steady pace;
The facts stay clear, your choices keep their place.
Soft-spoken wishes bloom in letters clear;
Larger paths bring every screen more near.
A budget stays a promise, line by line;
Each choice is yours; the final word is thine.
May every simple meal you choose and share
Be served with truth, with dignity, with care.

用户只说“两个人、三十元以内、夹鸡肉的、希望避开辣味”。Skill 会逐项保留原话，查询用户选择的门店，最多给三个候选。只有官方详情明确的属性才写“符合”；缺少辣度字段时标为“未知”，所有答案都来自可核验信息。

Skill 可以生成：

【沟通卡｜请协助核对｜尚未下单】
门店：……（编码：……）
取餐方式：……
我想要：
1. …… × 1（选项：……）
请协助确认并避开：……
优惠：保持原样（当前未选择优惠）
当前核价：¥……
核价时间：……
核对完成后，请把选择交给食客本人。

这张卡由用户自己出示，并始终写明“尚未下单”；门店收银、叫号与后台系统继续保持各自独立。

1. 一轮只问一个主要问题。
2. 第一屏最多三个候选，并保留“全部跳过”。
3. 排除项、数量和预算属于硬约束。
4. 超预算先说明差额，再由用户选择调整方式。
5. 辣度、配料和过敏信息缺少官方字段时标为未知。
6. 改饮料就只改饮料，其他选择维持原样。
7. 核价、下单、付款、可取餐分别表述。
8. 用户随时可以停止；退出同样是完整结果。

• 2026-10-10 的 WorkBuddy 导出含 35 个唯一工具名、35 份输入 Schema 与 35 个可复算哈希。
• 这次导出专门采集定义，业务调用与状态变更调用均为 0 次。
• 2026-10-09 的历史证据记录了 6 个工具的有限范围真实返回：账户、门店、菜单、餐品详情、门店优惠与核价。
• 取得定义说明我们知道怎样提问；取得真实回执才说明这一次确实办到了。
• 麦当劳公开指南当前列 33 项；运行时另有团餐促销与订单问卷券，并存在两处派对工具命名差异，所以每轮优先采用当前运行时名称。
• 28 项读取、时间与核价能力按用户意图使用；7 项状态变更能力进入 GUIDE_ONLY，由官方渠道承接最终动作。

完整路由见 35 工具手册，字段级脱敏契约见 机器可读快照。

python -X utf8 -m src.core.cli examples/accessible-order.fixture.json
python -X utf8 -m unittest discover -s tests -v

当前结果：66 项 fixture 自动测试通过。测试证明本地决定逻辑在这些用例内成立；真实菜单、价格与供应继续以本轮 MCP 返回为准。输入契约见 决定权护栏说明，四种无障碍回应策略见 无障碍回应模式。

证据与限制：

• MCP_INTEGRATION.md
• docs/EVIDENCE_LEDGER.jsonl
• docs/MCP_CAPABILITY_MATRIX.md
• docs/KNOWN_LIMITATIONS.md
• .codebuddy/skills/manmandian-builder/references/sources.md

• Token 仅进入本人设备的受保护连接器配置。
• 请求信息限于完成点餐所需的最小范围，支付密码、身份证号与银行卡号始终由用户保管。
• 查询优惠与领取优惠分开处理；默认执行查询，领取由用户主动选择，餐品保持用户原有需求。
• 第三方 AI 可能误解接口数据，优惠、权益和最终订单状态以官方渠道为准。
• 如果未来开放写操作，必须同时具备：规则允许、用户对本次具体订单明确授权、代码级防重复门禁、完整报价快照、超时后优先查单，以及创建、付款、可取餐、取消、退款的状态分离。
• 真实交易保护需要明确授权、代码门禁与官方回执共同成立。

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

只在 WorkBuddy 本机配置里替换 YOUR_MCP_TOKEN。仓库中的 mcp-config.example.json 继续使用 ${MCD_MCP_TOKEN} 占位符，真实 Token 始终留在本机。

这五项组成日常点餐快线。其余账户、订单、外送、团餐、活动、积分、抽奖、营养与时间能力按用户意图进入对应路线；七项状态变更能力统一进入引导模式。完整 35 项名称、依赖和参数见 工具路由手册。接口 Schema 以当前运行时工具定义与真实返回为准。

一份有效报价必须绑定：

门店 + 四类履约画像 + 商品编码 + 数量 + 套餐选项编码 + 优惠标识 + 调用方核价请求摘要

以上身份字段经过规范化后形成指纹；任一项改变，状态从 VALID 变为 STALE。总价、观察时间和新鲜度保存在指纹旁边：调用方根据本轮回执显式写入 CURRENT / EXPIRED / UNKNOWN，本地核心校验带时区时间、复核先后与状态联动。当前仓库尚在建设真实 MCP 适配器；现有核心只校验调用方摘要格式、绑定与变化关系，真实适配器完成后须从实际发出的完整核价请求计算摘要。

未来独立界面以 WCAG 2.2 AA 为设计与测试基线。以下内容属于待实现目标，当前状态已在上方看板明确标注：

• 所有非文字内容都有等价文本，颜色与图标同时配有文字状态。
• 全流程可用键盘完成，无键盘陷阱，焦点顺序合理并始终可见。
• 正文对比度至少 4.5:1，大号文字至少 3:1。
• 指针目标至少满足 24×24 CSS px；主要操作建议采用 44×44 CSS px。
• 支持文字放大与窄屏重排。
• 核价完成、报价失效和网络状态变化可被辅助技术读取。
• 拖拽、长按、双击和手势都有普通点击或键盘替代。
• 使用 NVDA、VoiceOver、TalkBack 完成真实任务测试并记录每次结果与改进过程。

手语是一套完整语言。项目将在中国手语使用者共创、合法数据与模型、限定词表、低置信度回退机制和真实评估全部到位后，再开放相机与手语识别。

任何未来识别结果都只作为候选，交易永远由食客决定。

• G0：命名为通用手势快捷操作。
• S1：限定词汇实验，只在词表内给候选，低置信度时回到文字确认。
• S2：连续手语理解属于后续研究。

• 用户是否能说清自己想要的东西。
• 用户能否复述数量与总价。
• 预算、排除项和局部修改是否被严格保留。
• 发生误解后能否只改一项而恢复。
• 用户是否清楚当前状态为“未下单”并能随时停止。
• 使用读屏、键盘、放大或纯文字模式时，完整任务是否成功。
• 员工看沟通卡后还需要补问几次。
• 用户的感受是否突出“我自己完成了”。

指标必须来自取得同意的真实研究；数据范围限于改进任务所需的最少信息，退出被视为用户作出的有效选择。

MM-helper/
├── README.md
├── CONTEST_DECLARATION.md
├── MCP_INTEGRATION.md
├── mcp-config.example.json
├── workbuddy.md
├── LICENSE
├── .codebuddy/
│   ├── CODEBUDDY.md
│   ├── rules/manmandian.md
│   └── skills/
│       ├── manmandian/
│       │   ├── SKILL.md
│       │   ├── scripts/validate_contracts.py
│       │   └── references/
│       │       ├── mcd-tool-router.md
│       │       ├── mcd-tool-contracts.json
│       │       ├── decision-contract.md
│       │       └── accessible-response-modes.md
│       └── manmandian-builder/
├── src/core/
│   ├── decision_guard.py
│   └── cli.py
├── examples/accessible-order.fixture.json
├── tests/test_decision_guard.py
├── docs/
│   ├── EVIDENCE_LEDGER.jsonl
│   ├── MCP_CAPABILITY_MATRIX.md
│   ├── KNOWN_LIMITATIONS.md
│   └── FILE_MAP.md
└── assets/
    ├── manmandian-hero-16x9.png
    ├── manmandian-story-4-panels.png
    ├── manmandian-accessible-ways.png
    ├── manmandian-co-design.png
    ├── manmandian-three-steps.svg
    ├── manmandian-eight-guardrails.svg
    ├── manmandian-status-board.svg
    ├── manmandian-poems.svg
    └── manmandian-mcp-35-map.svg

• 核验比赛文件、官方声明、MCP 指南与服务规则。
• 建立运行 Skill、35 工具分级路由、事实分层、证据台账和限制说明。
• 记录有限范围的真实只读链路证据。
• 建立零依赖决定权护栏与命令行演示，66 项 fixture 自动测试通过。
• 完成视觉叙事版 README、四张卡通插画和五张 SVG 信息图。

• 在干净 WorkBuddy 环境复测 Skill 触发与完整只读任务。
• 为当前会话草稿接入真实 MCP 适配层，并保留 fixture / live 证据隔离。
• 实现键盘可达、读屏可读、大字与窄屏界面。
• 用真实辅助技术与真实任务测试，记录每次结果与改进过程。
• 手语与写操作将在条件成熟后进入开放评估。

参赛说明要求源代码或可运行内容。本仓库现有可加载 Skill、命令行演示与 fixture 自动测试；独立可访问界面、真实 WorkBuddy 端到端复测和辅助技术实测属于下一阶段。

• 仓库保持 Public，创建时间符合官方窗口。
• README 包含项目介绍、安装、使用示例和目标用户。
• CONTEST_DECLARATION.md 与官方原文逐字一致。
• MCP_INTEGRATION.md 如实说明 Server、Tool、流程和价值。
• mcp-config.example.json 只保留占位符，真实 Token 位于本机配置。
• 本地决定权护栏、命令行演示与 fixture 自动测试已提供。
• 在干净 WorkBuddy 环境完成一次真实只读主流程复测并脱敏留证。
• 若申请 WorkBuddy 专项奖励，将 WorkBuddy 原生导出的真实、完整、脱敏上下文放入 workbuddy.md，并与结构化索引逐项对账。
• 作者确认参赛资格；未满 18 岁者取得父母或法定监护人同意。
• 在 2026-10-25 23:59（北京时间）前按最新模板报名。
• Token、手机号、地址、订单、支付信息与他人个人信息扫描结果为零。
• 已添加标准 MIT 开源许可证；作者署名与第三方权利范围在发布前复核。

先检查：

git status --short
git diff --check
git diff
python -X utf8 .codebuddy/skills/manmandian/scripts/validate_contracts.py
python -X utf8 -m unittest discover -s tests -v
python -X utf8 -m src.core.cli examples/accessible-order.fixture.json

请逐个添加本次确认过的文件：

git add README.md MCP_INTEGRATION.md PROJECT_STATUS.md CONTEXT_HANDOFF.md DECISIONS.md
git add LICENSE workbuddy.md THIRD_PARTY_NOTICES.md
git add .codebuddy/skills/manmandian .codebuddy/skills/manmandian-builder .codebuddy/CODEBUDDY.md
git add src tests examples docs requirements.lock.json .gitignore
git add assets/manmandian-mcp-35-map.svg
git diff --cached

如果当前就在 main：

git commit -m "docs: update ManManDian skill and evidence"
git pull --rebase origin main
git push origin main

如果当前分支类似 workbuddy/main-xxxx：

git commit -m "docs: update ManManDian skill and evidence"
git push -u origin HEAD

随后在 GitHub 创建 Pull Request，采用普通合并流程。提交前再次检查官方声明逐字一致，真实 Token 仍在本机，暂存区只包含本次项目文件。

【参赛申请】
项目名称：慢慢点（ManManDian）
项目地址：https://github.com/siyunhao2025-beep/MM-helper
项目简介：一个基于麦当劳中国 MCP 的无障碍自主生活服务 Skill。它动态识别 35 项工具，把点餐核价、账户优惠、订单售后、外送地址、团餐活动、积分商城、抽奖奖品与营养时间分成八条清楚路线；核心点餐流程将自然表达变成可修改草稿，从真实菜单给出最多三个候选并完成官方核价。预算护栏、局部修改、证据分层与“未下单”沟通卡帮助每个人自己作决定；28 项读取与核价能力按本人意图使用，7 项状态变更能力由官方渠道承接最终动作。