mcd-china-map

<p align="center"> <img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/cover-v1.png" alt="麦麦中国地图｜把麦当劳吃成一张中国地图" width="960"> </p> <p align="center"> <a href="https://jay1023cn.github.io/mcd-china-map/"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/open-web.svg" alt="打开麦麦中国地图网页版" width="220"></a> &nbsp;&nbsp; <a href="https://github.com/Jay1023CN/mcd-china-map/releases/latest"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/download-local.svg" alt="下载 Windows 本地完整版" width="220"></a> </p> <p align="center"> <strong>吃一顿麦，留一页手账，点亮一座城。</strong><br> _{网页版无需安装、无需 MCP Token · 记录保存在当前浏览器}<br> <a href="https://github.com/Jay1023CN/mcd-china-map"><strong>喜欢这个创意？在本仓库点 ☆ Star 支持</strong></a><br> _{登录 GitHub 后，点击仓库顶部的 Star；显示 Starred 就已收藏。<a href="https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/TRY-AND-SUPPORT.md">体验与 Star 指引</a>}<br> _{电脑和手机浏览器都能用 · <a href="https://github.com/M-China/mcd-developer-innovation-challenge/issues/139">参赛作品</a> · <a href="https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/ROADMAP.md">接下来做什么</a>} </p> <p align="center"> <strong>「下次旅行，哪家麦值得顺路去？」</strong><br> 先花一分钟，收藏你的下一站：<br> 打开网页版 → 选一座城或点门店标签 → 看照片和介绍 → 点「想去这家」。<br> _{得到一份自己的想去清单；到店后再把照片和随手记写成探店卡。}<br> _{适合找特色店的麦门朋友、旅行顺路探店的人，也适合想留住日常一餐的人。}<br> _{收藏不算到访；去过的店再点「我去过，记一餐」。需要同步官方订单时使用本机版。}<br> <a href="https://jay1023cn.github.io/mcd-china-map/">现在试试</a> · <a href="https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/TRY-AND-SUPPORT.md">怎样记一餐、分享和备份</a> </p> <br> <p><picture><source media="(max-width: 600px)" srcset="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/share-heading-mobile.svg"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/share-heading.svg" alt="01 把你的麦麦足迹，晒给朋友看：足迹卡、探店卡与下一站邀约卡" width="960"></picture></p> <p align="center"> <a href="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/share-card-paper.png"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/share-card-paper.png" alt="中国足迹分享卡：完整底图、省份与城市足迹，公开示例" width="260"></a> &nbsp; <a href="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/memory-card-preview.png"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/memory-card-preview.png" alt="探店分享卡：北京首钢园公开照片与示例手账" width="260"></a> &nbsp; <a href="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/plan-card-preview.png"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/plan-card-preview.png" alt="下一站计划卡：杭州千岛湖公开门店照片与想去理由" width="260"></a> </p> <p align="center">_{点图看完整卡片 · 支持修改标题、上传照片、系统分享、复制图片与保存<br>卡片为公开示例，门店照片附来源。}</p> <br> <p><picture><source media="(max-width: 600px)" srcset="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/stores-heading-mobile.svg"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/stores-heading.svg" alt="02 找一家特别的麦：19 座城市，28 家特色门店，按城市找照片与介绍" width="960"></picture></p> <p align="center"> <img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/mobile-map-preview.png" alt="手机地图：按城市找特色门店，点击地图标签展开照片与介绍" width="290"> &nbsp;&nbsp; <img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/store-detail-preview.png" alt="杭州千岛湖门店详情：公开照片、地址、介绍与收藏入口" width="290"> </p> <p align="center"><strong>v0.15 · 不只找特色店，也能找家门口的麦。</strong><br>_{大陆官方公示 8,448 条 · 香港官方目录 269 条 · 按省份、城市、店名或路名查找，收藏后可直接记一餐。}</p> <p align="center"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/national-store-search-preview.png" alt="全国门店手机目录：搜索石河子，查看普通门店；没有核实坐标时保留文字资料" width="290"></p> <p align="center">_{另含澳门 39 条公开资料、台湾 508 条餐饮登记，其中 265 条已有分店名称、172 条对应营业税籍资料。出发前请确认营业时间；<a href="https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/NATIONAL-STORES.md">查看来源、覆盖与点位说明</a>。}</p> <p align="center"><strong>找店时，也能翻翻自己收藏的麦。</strong><br>_{在全国门店页点「已收藏」，继续按城市、店名或路名查找；详情里可以收藏或取消，想去清单会同步更新。}</p> <p align="center"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/national-store-saved-preview.png" alt="手机全国找店：按桃园筛选已收藏门店，旧收藏与新分店名对应，资料来源保留" width="290"></p> <p align="center"><a href="https://github.com/Jay1023CN/mcd-china-map/blob/main/assets/data/STORE-SOURCES.md">看看收录了哪些特色门店</a> · <a href="https://github.com/Jay1023CN/mcd-china-map/issues/new/choose">推荐你喜欢的那家</a></p> <br> <p><picture><source media="(max-width: 600px)" srcset="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/plans-heading-mobile.svg"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/plans-heading.svg" alt="03 下一站，去吃哪家麦：收藏、选日期、约朋友，到店后把计划写成手账" width="960"></picture></p> <p align="center"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/wishlist-planner-preview.png" alt="下一站计划实际页面：按城市与日期筛选、优先想去、帮我挑一家、复制给朋友。公开门店与计划示例" width="960"></p> <p align="center">_{今天 / 未来 7 天 / 还没定日期 · 城市与理由搜索 · 连续挑店会换一家 · 排期随备份恢复}</p> <br> <p><picture><source media="(max-width: 600px)" srcset="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/collections-heading-mobile.svg"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/readme-assets/collections-heading.svg" alt="04 把这一城、这一月，好好收藏：城市回忆册与月度麦麦小报" width="960"></picture></p> <p align="center"> <a href="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/city-album-card-preview.png"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/city-album-card-preview.png" alt="城市回忆册分享图：挑选一页上海公开门店的演示手账，选择封面并写一句随记" width="340"></a> &nbsp;&nbsp; <a href="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/monthly-newspaper-preview.png"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/monthly-newspaper-preview.png" alt="月度麦麦小报：按月份整理照片、城市与常吃的餐品。数据为演示记录" width="310"></a> </p> <p align="center">_{城市回忆册选页、换封面，装订成分享长图 · 小报指定三张照片、交换顺序、选版式、写一句随记<br>v0.14 更新 · 选择随手账备份保存 · 以上为公开门店照片与演示记录 · 门店详情与下一站清单可打开高德地图}</p> <br> <details> <summary><strong>看一段操作演示：打开地图，翻一页手账</strong></summary> <p align="center"><img src="https://raw.githubusercontent.com/Jay1023CN/mcd-china-map/main/docs/product-preview.gif" alt="地图与手账操作演示动图，记录为公开示例" width="850"></p> </details> <details> <summary><strong>第一次用：网页版与本地版怎么选？</strong></summary> **想先试试：** [打开网页版](https://jay1023cn.github.io/mcd-china-map/)，直接记一餐、上传照片、收藏门店、排期、翻城市回忆册、生成月度小报和分享卡。无需安装。 **想同步自己的麦当劳订单：** [下载 Windows 完整包](https://github.com/Jay1023CN/mcd-china-map/releases/latest)，解压后双击 `启动.cmd`。普通手账无需 Python；安装 Python 3.10+ 后，可连接自己的 [麦当劳中国 MCP Token](https://open.mcd.cn/mcp)，自动整理完成订单、查询官方附近门店。门店资料与默认照片自动带入，仍可编辑随记、换照片或删除记录。 当前 GitHub Pages 提供地图与手账，MCP 连接通过本机版使用。更多入口和步骤见 [Windows 使用说明](https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/LOCAL_WINDOWS.md)、[网页版与部署](https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/WEB.md)。 </details> <details> <summary><strong>我的照片、记录和备份放在哪里？</strong></summary> 手账和想去清单保存在当前浏览器。导出 JSON 可以带上照片、日期与优先标记，换设备时导入恢复；也能打印或保存 PDF。 目前没有云同步，换浏览器、清理网站数据或换地址前请导出备份。最多保存 1000 页手账、100 家想去门店，处理后的单张照片不超过 1.5 MiB，完整归档不超过 8 MiB。旧版中国记录可恢复。 地图提供 34 个省份 / 地区选项。公开门店只标已匹配点位；尚未核实坐标的店仍可搜索、收藏、打卡。手账可以选择门店位置、城市参考位置或本人填写的坐标。麦当劳中国 MCP 服务范围为中国大陆。公开截图使用独立公开门店或示例记录，个人 Token、订单、地址和照片不进入 GitHub。 </details> <details> <summary><strong>参与开发：源码、构建、验证与素材</strong></summary> ```powershell py scripts/build_global_journal.py --output index.html node --test tests/journal-engine.test.js tests/wishlist-engine.test.js py -m unittest discover -s tests -p 'test_*.py' -v py scripts/package_skill.py ``` [开发与文件管理](https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/DEVELOPMENT.md) · [运行验证](https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/VALIDATION.md) · [MCP 接入](https://github.com/Jay1023CN/mcd-china-map/blob/main/MCP_INTEGRATION.md) · [Skill](https://github.com/Jay1023CN/mcd-china-map/blob/main/SKILL.md) · [素材来源](https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/SOURCES.md) · [宣传素材](https://github.com/Jay1023CN/mcd-china-map/blob/main/docs/GROWTH.md) 页面模板位于 `templates/`，交互和归档位于 `web/`，构建与服务入口位于 `scripts/`。GitHub Actions 自动检查并发布网页版；预览图、字标和宣传图按目录分别管理。 </details> <br> <p align="center"> <strong>下一座城，你想去吃哪家麦？</strong><br><br> <a href="https://jay1023cn.github.io/mcd-china-map/">打开地图，收藏下一站</a> · <a href="https://github.com/Jay1023CN/mcd-china-map/issues/new/choose">反馈体验 / 推荐门店</a><br> <a href="https://github.com/Jay1023CN/mcd-china-map"><strong>回到仓库，点 ☆ Star 收藏作品</strong></a><br> _{登录后点仓库顶部的 Star，显示 Starred 即已收藏。也欢迎反馈体验。} </p> <p align="center">_{社区独立作品，非麦当劳官方产品 · 原创代码 <a href="https://github.com/Jay1023CN/mcd-china-map/blob/main/LICENSE">MIT</a> · 第三方素材按来源与许可使用 · <a href="https://github.com/Jay1023CN/mcd-china-map/blob/main/CONTEST_DECLARATION.md">参赛声明</a>}</p>