21 国内置地址样本、街道插值与可回溯 OSM 建筑门牌
个人资料为合成测试数据；地址不代表可投递、真实住户、房号或 AVS 认证
🌐 线上演示与正式访问：https://vllme.com/ （备用镜像：https://address.vllme.com/）
- 恢复多地区地址选择：21 国内置住宅与公寓样本、街道门牌区间插值可在网页及批量生成中选择。插值门牌并非逐条核验的真实建筑，内置样本不保证投递或 AVS。
- 可核对来源模式：另收录美国 Wilmington（DE）和 Portland（OR）的 OSM 住宅建筑门牌，每条附原始对象链接；当前数量以地址库监控页的数据快照为准。此模式无匹配时不跨地区兜底。
- 边界：OSM 是众包数据；仅说明建筑门牌有来源对象，不代表房号、住户、产权、邮政投递或 AVS 认证。合成身份与建筑没有任何居住关联。
- 🗺️ 三地图引擎与防“IP 送中”安全沙箱：
- 默认首选 OpenStreetMap (OSM)：国内 100% 免翻直连秒开，真实建筑门牌无偏移，零送中风险；
- 备选 Bing Maps (必应地图)：微软官方全球道路图与高分辨率卫星图；
- Google Maps 隔离门禁：默认绝不发起静默请求，支持点击确认加载；生成新身份自动重新上锁 (Auto-Relock)；物理拦截浏览器 HTML5 定位回传，保护海外 VPS 原生 IP。
- 📦 电商与转运仓合规双行地址生成：
- Address Line 1：所选模式的地址样本或插值门牌；仅 OSM 模式可核对来源对象。
- Address Line 2：OSM 模式保持空白；旧模式可能生成供排版测试的虚拟单元号。
- 多行格式复制：仅用于合规开发测试，不用于真实收件或付款验证。
- 🛠️ 全套生产力工具：
- 单字段一键复制（带打勾动画与 Toast 反馈）。
- 一键复制完整结构化测试档案。
- 批量生成（5/10/20/50 条）与 CSV / JSON 导出（含 Address Mode 与 AVS Tier）。
- 本地 LocalStorage 历史记录抽屉与星标收藏夹。
- 深色 / 浅色模式自适应，中英双语国际化无缝切换。
本项目为纯静态 SPA（单页面应用），天生完美契合 Cloudflare Pages 全球边缘分发网络，具备全球极速访问、自动 HTTPS 证书、DDoS 防护和 100% 免费额度。
address.vllme.com 绑定到 geo-identity Pages 项目。该项目当前未连接 Git 提供商：只推送 GitHub 不会自动更新网站，必须运行下方的每日任务或手动上传构建产物。
手动发布（不要提交 .env 或 dist）：
# 1. 在本地克隆并进入项目目录
git clone https://github.com/AiLi1337/GeoIdentity.git
cd GeoIdentity
# 2. 安装项目依赖
npm install
# 3. 打包生成 dist
npm run build
# 4. 首次使用请登录 Cloudflare 账户 (会弹出浏览器授权)
npx wrangler login
# 5. 发布构建产物到 Cloudflare Pages
npx wrangler pages deploy dist --project-name geo-identity --branch main部署完成后，终端会立即输出本次部署的生产预览链接。
想要使用自己的域名（如 vllme.com 或 address.yourdomain.com）：
- 进入 Cloudflare Dashboard ➔ Workers & Pages ➔ 点击你的 Pages 项目；
- 切换到 自定义域 (Custom domains) 选项卡；
- 点击 设置自定义域 (Set up a custom domain)，输入你的域名并按提示一键完成 DNS 解析绑定；
- Cloudflare 会在数分钟内自动完成全球 CDN 广播并签发免费的 SSL/TLS 证书。
项目仓库内已内置每日自动化调度工作流 .github/workflows/daily-address-sync.yml：
- 定时运行：计划每天 UTC 00:00（北京时间 08:00）运行；GitHub 的定时任务可能延迟。
- 公开数据采样：从 OpenStreetMap contributors (ODbL) 获取特拉华州 Wilmington 与俄勒冈州 Portland 的公开住宅建筑门牌、邮编、城市和坐标，过滤无效或重复记录，写入
osmApartments.json。只代表 OSM 有建筑门牌，不保证可投递或通过 AVS，不关联住户。 - 失败处理：上游暂不可用时跳过本次同步，保留仓库数据和上次成功时间；响应格式错误或旧地址异常大量消失时任务失败，不覆盖快照。页面显示的是已部署包的数据快照，并非实时查询；页面按钮只校验本地字段和数量。
- 部署设置：在 GitHub 仓库 Secrets 设置
CLOUDFLARE_API_TOKEN（对目标 Pages 项目有部署权限）与CLOUDFLARE_ACCOUNT_ID，在 Variables 设置CF_PAGES_PROJECT（当前为geo-identity）。任务先校验并同步数据，有变化才提交 GitHub；定时运行每次都尝试部署已验证的快照，以便重试此前失败的发布。手动运行可通过deploy开关在地址无变化时部署。缺少部署配置时会在发布前失败。 - 许可：新增 OSM 数据受 Open Database License 约束，使用或再分发时保留归属与许可要求。原有静态地址库不由 OSM 同步验证。
确保本地已安装 Node.js (推荐 v18+ 或 v20+)。
# 1. 安装依赖
npm install
# 2. 运行自动化测试套件
npm test
# 3. 运行地址库同步与元数据校验
npm run sync:addresses
# 4. 启动本地开发服务器 (支持 Vite HMR 热更新)
npm run dev
# 5. 构建生产代码
npm run build
# 6. 本地预览生产构建产物
npm run preview本项目基于 MIT License 协议完全开源。欢迎 Star ⭐、Fork 与提交 Pull Request！
- 本项目所生成的个人姓名、证件号码、虚拟银行卡号及联系电话等均为前端算法伪随机生成的虚拟合成测试数据 (Synthetic Data)，仅供合规软件开发、UI排版与表单校验测试使用。
- 地址来源有别：OSM 建筑门牌附可核对的对象链接；其他地区包含未逐条核验的内置样本及街道插值，不能据此证明建筑存在或可以投递。所有地址均与合成身份没有居住、产权或收件关联。
- 严禁将本项目用于任何金融欺诈、电信网络诈骗、冒用他人身份等违法犯罪行为。