[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83026":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},83026,"map-of-us-template","zkeyoned\u002Fmap-of-us-template","zkeyoned","Open-source private memory map template built with Next.js and Supabase",null,"TypeScript",119,24,55,1,0,34,46,6,4.19,false,"main",true,[],"2026-06-12 02:04:30","![Uploading 8ec0e6225ad10b616db7f0fbd7c51b92.png…]()\n\n# Map of Us\n\nMap of Us 是一个本地优先的个人情侣记忆地图应用。它使用 Next.js 16 App Router、React 19、Tailwind 4 和 Electron，可以在浏览器里开发，也可以打包成桌面应用。\n\n当前版本的目标是：数据全部保存在用户自己的电脑上，不依赖 Supabase，不需要联网认证。\n\n## 功能\n\n- 密码入口页，输入站点密码后进入地图。\n- 中国地图、省份详情、城市回忆、照片、多图封面、编辑和删除。\n- 设置页可管理管理员模式、纪念日、沿途天气城市、右下角情侣 logo、登录页照片和文案。\n- 设置页支持完整备份导出、导入恢复、清空数据。\n- Electron 桌面版使用 Next.js standalone 生产服务，不运行 `next dev`。\n- 桌面版数据写入 Electron `userData` 目录，安装包资源目录保持只读。\n\n## 桌面版密码\n\n**首次安装后的初始密码：**\n\n```text\n进入密码：1234\n管理员密码：admin1234\n```\n\n第一次打开请用上面的初始密码登录。进入后请尽快改成自己的：\n\n- 进入 **设置 → 密码设置**（需先用管理员密码开启管理员模式）。\n- **进入密码**建议填你们在一起的日期（月日，例如 12 月 23 日就填 `1223`），它就是打开 app 时输入的数字密码。\n- **管理员密码**自己设置。\n- 修改后立即生效，关机重开也用新密码。\n\n技术说明：桌面版不依赖 `.env.local`。首次启动时 Electron 会在用户数据目录创建本地认证配置 `auth.local.json`，保存这两个密码；`AUTH_COOKIE_SECRET` 会随机生成并存在同一文件里。在设置页改密码会直接写回这个文件。若启动环境显式设置了 `SITE_PASSWORD`、`ADMIN_PASSWORD` 或 `AUTH_COOKIE_SECRET`，则优先使用环境变量。\n\n## 安装与首次打开（给使用者）\n\n本应用是个人\u002F开源分发，**没有做苹果付费签名和公证**，所以从网上下载后第一次打开会被系统拦一下。这是正常现象，按下面操作放行即可，**只需要做一次**，之后正常双击打开。\n\n### macOS\n\n1. 双击 `Map of Us-0.1.0-arm64.dmg`，把里面的 **Map of Us** 拖进「应用程序」。\n2. 在「应用程序」里 **右键点 Map of Us → 打开**，弹窗里再点一次 **打开**。\n3. 若新版 macOS 没有「打开」选项：打开 **系统设置 → 隐私与安全性**，往下找到关于 Map of Us 的提示，点 **仍要打开**。\n4. 若提示 **「已损坏，应移到废纸篓」**：打开「终端」运行下面这句去掉隔离标记，然后再打开：\n\n   ```bash\n   xattr -cr \"\u002FApplications\u002FMap of Us.app\"\n   ```\n\n### Windows\n\n1. 运行 `Map of Us-0.1.0-x64-Setup.exe` 安装。\n2. 若出现蓝色 **SmartScreen** 提示：点 **更多信息 → 仍要运行**。\n\n\n\n\n\n## 桌面打包\n\n生成 Next.js standalone 生产产物：\n\n```bash\nnpm run desktop:prepare\n```\n\n生成未压缩的 macOS app，用于快速验证：\n\n```bash\nnpm run dist:dir\n```\n\n生成 macOS 安装包：\n\n```bash\nnpm run dist:mac\n```\n\n产物示例：\n\n```text\ndist\u002Fmac-arm64\u002FMap of Us.app\ndist\u002FMap of Us-0.1.0-arm64.dmg\n```\n\n生成 Windows x64 安装包：\n\n```bash\nnpm run dist:win\n```\n\n产物示例：\n\n```text\ndist\u002Fwin-unpacked\u002FMap of Us.exe\ndist\u002FMap of Us-0.1.0-x64-Setup.exe\n```\n\n在 macOS 上可以生成 Windows 安装包，但不能完整验证 Windows 运行效果；最终发布前建议在 Windows 真机或 CI 上再安装运行一次。\n\n当前打包未配置正式应用图标、Apple 开发者签名和公证。macOS 产物使用 ad-hoc signing，公开分发前需要配置证书、公证和图标。\n\n\n## 数据保存位置\n\n浏览器开发模式默认写入项目目录：\n\n```text\ndata\u002FlocalMemories.private.json\ndata\u002FcityAssets.private.json\ndata\u002FloginPhotos.private.json\n```\n\n桌面打包版写入 Electron `userData\u002Fdata`。常见位置：\n\n```text\nmacOS: ~\u002FLibrary\u002FApplication Support\u002FMap of Us\u002Fdata\nWindows: %APPDATA%\u002FMap of Us\u002Fdata\n```\n\n可用环境变量覆盖桌面数据目录：\n\n```text\nMAP_OF_US_DATA_DIR=\u002Fpath\u002Fto\u002Fdata\n```\n\n打包版会强制启用本地文件存储：\n\n```text\nMAP_OF_US_STORAGE_MODE=local\nMAP_OF_US_DESKTOP=1\n```\n\n因此即使 `NODE_ENV=production`，新增、编辑、删除和导入回忆也不会要求 Supabase。\n\n## 可自定义内容\n\n在设置页开启管理员模式后，可以自定义：\n\n- 纪念日名称和开始日期。\n- 首页“沿途天气”的城市。\n- 右下角情侣 logo。\n- 登录页九宫格照片。\n- 登录页每张照片的城市名和标签文案。\n- 城市地标图。\n\n这些设置会随完整备份一起导出。登录页照片、城市地标和回忆照片以本地数据形式保存。\n\n## 备份和迁移\n\n在设置页使用“导出备份”保存完整备份文件。文件名会包含日期。\n\n换电脑或重装后：\n\n1. 安装并打开桌面应用。\n2. 输入站点密码进入地图。\n3. 进入设置页，用管理员密码开启管理员模式。\n4. 导入备份文件。\n\n导入会恢复回忆、城市地标、登录照片、纪念日、天气城市、logo，以及地点收藏、纪念日页面、时光宝盒等辅助数据。\n\n```\n\n## 目录速览\n\n```text\napp\u002F                     App Router 页面和 API\ncomponents\u002F              地图、入口页、回忆页和设置页组件\ndata\u002F                    省份、城市、进度和浏览器侧数据工具\nelectron\u002F                Electron 主进程入口\nlib\u002F                     地理数据、隐私模式和服务端存储工具\nscripts\u002F                 standalone 准备脚本\npublic\u002Flogo\u002F             logo 占位图\npublic\u002Fphotos\u002F           默认照片素材\npublic\u002Fsprites\u002F          城市地标、图标和像素素材\ndist\u002F                    本地打包产物\n```\n\n","Map of Us 是一个本地优先的个人情侣记忆地图应用，基于 Next.js 和 Electron 构建。其核心功能包括密码保护的地图入口、中国地图上的省份详情和城市回忆展示、照片管理和编辑功能，以及设置页中的管理员模式、纪念日管理、天气城市配置等。该应用特别适合情侣或个人用于记录和回顾重要时刻与地点。所有数据均保存在用户本地，无需联网认证，确保了隐私安全。支持浏览器开发及桌面应用打包，方便用户在不同环境下使用。",2,"2026-06-11 04:09:56","CREATED_QUERY"]