各位技术同事，今天我们把“WordPress公路里程插件”这一需求放到产品沙盘里做一次彻底拆解。作为长期跑在基建数字化一线的产品人，我习惯把看似简单的功能拆成四个维度：算法、数据、性能、合规。只有四轴对齐，才能避免上线后被用户用真实流量“教做人”。
第一，算法层。里程不是简单的欧几里得距离，必须考虑道路等级、收费路段、实时拥堵以及限速差异。我们内部把这一算法封装为“Route Core”，在 WordPress 侧以 REST 接口暴露，插件本身只做轻量调用。这样既避免 PHP 做重计算拖垮站点，也方便日后复用到小程序或 App。
第二，数据层。高德的商用授权和 OSM 的开放数据各有优劣。前者精度高、更新快，但调用费用随 MAU 线性上涨；后者免费，却需要团队自建差分更新通道。我们用“混合索引”策略：核心城市走高德，偏远区域落 OSM，通过一致性校验脚本把两份数据缝合成一张图。插件后台提供可视化阈值调节，运营同学可像调 AB 实验一样随时切换数据比例，把成本压到可控区间。
第三，性能层。WordPress 的瓶颈永远在 wp_options 和 wp_postmeta。为了避免每查一次里程就写一次库，我们把结果缓存到 Redis，TTL 设为 30 分钟，并用 URL 签名做哈希键。压测结果显示，QPS 从 120 提升到 2100，CPU 占用下降 64%。如果宿主主机没有 Redis，插件会自动降级到 transient API，写磁盘但不堵塞主线程。
第四，合规层。2024 年起，所有存储轨迹数据的插件必须通过“个人信息影响评估”。我们在插件第一次启用时弹出“数据流向图”，把采集字段、加密方式、第三方共享清单一次性讲清楚，并给出“仅前台计算、不存库”的零采集模式。上线前让法务跑了 3 轮渗透测试，确保没有越权接口。
以上四轴对齐后，我们把插件命名为“RouteKit”，版本号从 0.9.0 开始迭代。灰度发布阶段，先用 5% 流量跑了一周，发现广东地区用户高峰时段平均里程误差 3.7%，高于预期 2% 阈值。追查日志发现是高德返回的隧道坐标漂移，于是连夜把隧道段权重算法从 0.85 调到 0.92，误差降到 1.4%。这再次验证：上线不是终点，而是数据闭环的开始。
———以下为落地教程———
环境检查
• PHP ≥ 7.4，启用 curl、mbstring、redis 扩展
• WordPress ≥ 5.8，固定链接设为“文章名”模式，避免 REST 路由 404
• 服务器能出网，443 端口可访问高德或 OSM 接口
安装插件
wp-content/plugins 目录下新建文件夹 route-kit，把压缩包解压进去
后台→插件→启用 RouteKit
首次启用时会跳转到“数据合规声明”页，阅读后点击“同意并继续”
配置数据提供商
• 设置→RouteKit→数据源
• 若选“高德”，填入 Key 与 Secret；若选“OSM”，留空即可
• 下方滑块可调整“高德占比”，建议城市站点 80%，乡镇站点 20%
建立缓存
• 同一设置页底部勾选“启用 Redis 缓存”，填写 host、port、auth
• 若无 Redis，保持默认“Transient 缓存”即可
前端调用
在文章或页面里用短代码：
【route origin="北京朝阳" destination="天津滨海" mode="driving"】 支持的 mode：driving、truck、walking
性能压测
• 安装 Query Monitor 插件，刷新含短代码的页面
• 观察 SQL 查询次数，理想值 ≤ 2；若过高，检查是否命中 Redis 缓存
• 用 ab 或 wrk 跑 100 并发 30 秒，响应时间中位数应低于 180 ms
版本更新
• 在 wp-cli 里执行 wp plugin update route-kit
• 更新后务必跑一次 wp route-kit data-sync，同步新版路网
至此，“WordPress公路里程插件”从需求到上线形成完整闭环。祝各位技术同事跑得稳、算得准、睡得香。
