七夏（牛马）

应用数
49
安装量
329

应用圈

最后在线：: 2026-09-29
客服时间：: 工作日 9时~20时

其他应用

热门应用

牛马旅行地图尝鲜版

收藏分享投诉

还剩促销结束

¥198.00

~~¥298.00~~|6.6 折|节省 ¥100|请抓紧时间抢购

统　　计:共 1 次下载
更新日期:2026-09-28
适配编码:UTF8SC
兼容版本:X3.4 X3.5 X5.0 X5.1
PHP版本:7.0 ~ 7.4 8.0 ~ 8.2
标签分类:其他功能
移动属性:该版本安装后自带手机版（触屏版）
开发方式:作者申明该应用少量使用 AI 辅助开发

购买应用 免责声明

# 牛马旅行地图

把每一次旅行，变成一张可以看的地图。照片自动拼贴进中国省份轮廓，去过的地方亮起你的照片；点开一个省，就是那一段旅程的明信片墙。

演示地址：
https://www.niumabbs.com/nm_travelmap-index.html

---

## 一、它和点亮式地图有什么不同

市面上的旅行地图插件，大多是把去过的省份涂上颜色。颜色能说明「去过」，但说明不了「去过是什么样的」。

牛马旅行地图换了一种呈现方式：**照片本身就是地图的填充**。

- 有照片的省份，边界内铺满你的旅行照片，像一张拼贴海报；
- 没有照片的省份，保留纸面底色，边界线清晰，一眼分清「去过」和「没去过」；
- 拖动密度滑杆，可以从「整张大图」调到「细密马赛克」，同一份数据呈现完全不同的观感。

页面整体采用「旅行手账」视觉：纸面底色、双线图框、和纸胶带、省份印章、票根式分页。它不像一个功能面板，更像一本摊开的旅行手记。

---

## 二、功能清单

### 1. 照片拼贴地图（核心）

- 照片按省份轮廓裁切填充，边界处无留缝，小省份在低密度下也保证显示一张；
- 省份角标显示打卡次数，省名带纸色光晕，叠在照片上同样清晰可读；
- 省级视图与市级视图切换：点进一个省，看到该省下辖市区的照片分布；
- 滚轮缩放、拖动平移、双击复位，另有放大/缩小/复位控件，触屏可拖动与双击操作；
- 点击地图上的任意省/市，弹出该地区的照片抽屉。

### 2. 足迹记录

每条足迹包含以下信息，全部在弹窗表单内完成，无页面跳转：

| 字段 | 说明 |
|---|---|
| 省份 | 34 个省级行政区下拉选择，服务端白名单校验 |
| 城市 / 区县 | 联动选择 |
| 标题 | 如「洱海骑行」 |
| 相册 / 文件夹 | 自由命名，支持历史相册联想 |
| 旅行日期 | 日期选择，可留空 |
| 照片 | 单条足迹至多 12 张，可多选上传、可填外链、可混合 |
| 标签 | 空格分隔，至多 10 个，自动去重 |
| 评分 | 1 至 5 星 |
| 记忆 / 备注 | 至多 1000 字，保存换行 |

### 3. 批注模式（照片回看）

- 单张大图浏览，缩略图画廊切换同一条足迹的多张照片，带「第几张」计数；
- 大图区弹性布局，无论图片多大，翻页按钮与缩略图始终在屏幕内，不会被图片挤出；
- 自动回看：开启后每 4 秒切换下一张，适合挂在屏幕上翻旧照片；
- 支持键盘左右键翻页；
- 浏览中可直接修改拍摄日期、地点、相册、标签、评分与照片记忆，即看即改。

### 4. 照片墙与筛选

- 左侧栏四组筛选：地点（省/市）、相册、标签云、只看已固定，可叠加组合；
- 卡片带多图角标（1/N）、固定图钉、评分星标；
- 票根式自定义分页，每页条数后台可调（建议 9 至 18，接口上限 60）；
- 照片总量较大时自动提示当前加载范围，不会无声截断。

### 5. 批量管理

勾选多张照片后统一处理，单次至多 100 条：

- 统一修改省份、城市；
- 统一相册名；
- 批量追加标签、批量移除标签；
- 批量固定 / 取消固定；
- 批量删除。

所有批量操作逐条校验归属，只能操作自己的数据。

### 6. 上传方案（双通道）

| 方案 | 说明 |
|---|---|
| 自建上传 | 照片存入站点 `data/plugin/nm_travelmap/&lt;uid&gt;/` 目录，支持 jpg / png / gif / webp，单张体积后台可调（1 至 20MB，默认 8MB） |
| 网盘直传 | 联动牛马网盘（nm_alist_upload）插件，照片直传网盘取直链，不占站点磁盘；未安装网盘插件时自动回退到自建上传 |

两种方式均带上传进度条，网盘大文件进入转码、入库阶段时显示「处理中 / 入库中」状态。

### 7. 外链图片同源代理

外链与网盘直链图片经常 302 跳转到 CDN，且 CDN 通常不返回跨域许可头，导致地图拼贴与导出失败。本插件内置同源图片代理：

- 服务端拉回远程图片后以同源方式输出，地图拼贴与导出不再受跨域限制；
- 不轻信响应头，按文件头判定真实图片类型，CDN 将图片标为 `application/octet-stream` 也能正常显示；
- 自动跟随 302 跳转，每一跳目标主机均做内网/保留地址校验，并固定校验通过的 IP，防止域名重绑定；
- 限制单次 12MB，仅输出位图类型，拒绝 SVG 等可携带脚本的内容；
- 校验同站 Referer，避免代理带宽被站外站点占用。

### 8. 分享图导出

- 一键导出当前地图为高清 PNG，可选 1080 / 1440 / 2160 三档尺寸；
- 自定义标题、边框样式（细边框 / 粗双线 / 无边框）、文字颜色（墨色 / 印泥红 / 纸白）与字重；
- 导出图自带点亮省份数与照片总数统计行，直接可发朋友圈、微博、小红书。

### 9. 隐私控制

- 每位用户可一键切换「公开中 · 他人可见 / 私有 · 仅自己可见」，按钮与提示均为状态语义；
- 私有状态下，地图页、数据接口、空间页卡片对其他访客一律不可见；
- 新用户默认公开与否由后台设置决定。

### 10. 个人空间卡片

在会员空间资料区注入「旅行地图」入口卡片，展示已点亮省份数与足迹总数，后台可单独关闭。

### 11. 移动端适配

- 独立移动端模板（非简单缩放）：侧栏横向滑动、照片墙双列、操作按钮满宽；
- 编辑弹窗限高并在内部滚动，底部按钮不被遮挡；
- 页面底部预留论坛导航条高度，内容滚动到底不被覆盖；
- 表单控件做了作用域样式隔离，不被站点全局样式污染。

---

## 三、特性优势

| 常见做法 | 牛马旅行地图 |
|---|---|
| 省份填色高亮，看到的是颜色 | 照片拼贴填充，看到的是你的旅程 |
| 依赖第三方地图服务，需申请密钥 | 边界数据本地分发，全程离线渲染，无外部请求、无密钥 |
| 单条记录一张图 | 单条足迹至多 12 张，多图画廊与角标计数 |
| 逐条手动编辑 | 批量修改 + 批注回看，大量照片也能快速整理 |
| 分享靠截图拼接 | 站内直接导出带统计行的分享图 |
| 移动端套用 PC 模板 | 独立触屏模板，交互与布局按手机习惯重排 |
| 深色模式下地图发灰 | 明暗双主题配色各自调校，跟随系统与站点深色模式 |

其他工程层面的特点：

- **零第三方前端依赖**：不加载 ECharts、不请求地图服务，前端为插件自带的 Canvas 拼贴引擎；
- **安全设计**：SQL 全参数化、写操作双重校验（登录 + 表单令牌）、全部输出转义、上传双重校验（真实图片类型判定 + 随机文件名）、数据归属逐条校验、代理多层防内网探测；
- **安装卸载干净**：安装仅创建 2 张自建表与照片目录，卸载时数据表与照片文件一并清理，不残留、不改动系统表；
- **性能考虑**：边界数据按省懒加载并缓存，照片列表分页拉取，代理输出带浏览器缓存头。

---

## 四、后台设置项（共 7 项）

| 设置项 | 说明 |
|---|---|
| 总开关 | 关闭后隐藏导航菜单、空间卡片与地图页 |
| 每页足迹数 | 照片墙每页条数，建议 9 至 18 |
| 默认允许他人查看 | 新用户地图的初始公开状态 |
| 空间页入口 | 是否在会员空间显示打卡卡片 |
| 地图主题色 | 石墨蓝 / 黛紫 / 松绿 / 秋褐 / 豆沙 / 青灰，共 6 种 |
| 照片上传方式 | 自建上传 / 调用牛马网盘 |
| 单张照片上限 | 自建上传的体积上限（MB） |

---

## 五、环境要求

- Discuz! X3.4 / X3.5 / X5.0 / X5.1，UTF-8 编码；
- 图片类型校验使用 PHP 内置函数，无需额外扩展；
- 前台使用 Canvas 与 Fetch，支持这些特性的主流浏览器均可正常使用；
- 如使用外链或网盘直链图片，服务器需能出站访问对应图片源；
- 如使用网盘直传，需另行安装并启用牛马网盘（nm_alist_upload）插件。

---

## 六、注意事项

1. **照片文件随卸载删除**：自建上传的照片保存在 `data/plugin/nm_travelmap/` 目录，卸载插件会连同该目录一并删除。如需保留照片，请在卸载前自行备份该目录。
2. **地图数据体积**：34 个省级行政区的市级边界数据（约 3.7MB）随插件本地分发，安装包体积主要来自这部分数据，换来的是运行期零外部地图请求。
3. **加载范围**：照片墙单次至多加载 720 条足迹（60 条 × 12 页），超出部分会给出明确提示；个人相册规模远超此数量时，建议按年份整理相册、配合筛选使用。
4. **港澳台边界**：香港、澳门、台湾呈现省级轮廓，暂无市级细分。
6. **空间卡片显示**：取决于后台「空间页入口」开关与会员空间模板的对应挂载点，模板被深度改动的站点请先在前台确认。

---

## 七、适用场景

- 旅行类、摄影类、生活分享类社区：给会员一个「晒旅程」的沉淀页；
- 城市同城站：按省市维度组织会员的本地探索记录；
- 车友会、徒步群、骑行团：路书与打卡记录的长期归档；
- 个人站长：作为会员成长体系中的「足迹」维度，与积分、等级形成互补。

去过多少地方，不该只是一个数字。装上它，让会员的照片替他们讲去过哪里。