七夏（牛马）

应用数
48
安装量
327

应用圈

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

其他应用

热门应用

牛马公益寻亲公益版

收藏分享投诉

免费

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

安装应用 免责声明

暂无

产品评分

还没有人评分

暂无

服务评分

免费应用不支持服务评分

全部评价0 无法识别您的站点信息，请从网站后台进入应用中心

请从站点后台进入应用中心后查看评价

# 牛马公益寻亲

## 写在前面

本插件完全免费，不设任何付费门槛、功能限制或商业授权。

开发的初衷很简单：让每一个 Discuz! 站点都能零成本接入公益寻人信息，让更多失散家庭有机会被看见。每一条寻亲信息都可能点亮一个家庭的团圆之路，这正是本插件存在的全部意义。

如果你觉得插件对你有帮助，我们能给你的只有一句感谢，没有付费入口、没有赞助二维码、没有解锁高级版的引导。把插件用起来，让信息传播出去，就是对我们蕞大的支持。

# **请务必阅读下方的【使用须知与免责声明】**

---

## 一、插件定位

本插件是一个面向 Discuz! 社区的公益信息聚合与展示工具。它自动同步让爱回家公益寻人平台公开的寻亲信息，并在论坛前台以杂志式排版呈现，同时提供侧边栏轮播挂件，让寻亲信息出现在站点的各个角落。

插件不收集用户数据、不接入第三方统计、不植入任何商业推广。它只做一件事：把公益寻亲信息展示出去。

---

## 二、核心功能

### 1. 寻亲信息自动同步

插件内置同步引擎，可定时从让爱回家公益寻人平台抓取公开的寻亲信息并入库。

- 支持全量同步与增量同步两种模式
- 全量同步采用分批次抓取策略，避免单次请求量过大触发源站防护
- 增量同步仅拉取上次同步后的新增数据，日常运行对服务器资源消耗极低
- 同步过程设有单任务 * ** * 执行时间保护，接近上限时自动安全退出，避免网关超时
- 请求间隔可配置，默认 1 秒一次，对源站保持友好
- 支持 User-Agent 自定义标识，便于源站识别本插件的合法请求
- 同步异常时自动记录告警日志，便于站点管理员排查问题

### 2. 前台寻亲列表页

插件提供独立的前台寻亲页面，访问地址为 `plugin.php?id=nm_xunren:nm_xunren`。

页面采用杂志式排版风格，信息密度高但层次清晰：

- 顶部报头横幅，展示站点标题与公益引导文案
- 多维度筛选：按性别、省份、关键字、失踪年份范围组合查询
- 卡片式列表，每张卡片包含照片、姓名、性别、籍贯、失踪地点、失踪日期、简要情况
- 卡片点击跳转至官方详情页，支持白名单域名校验，防止开放重定向风险
- 图片懒加载，使用 IntersectionObserver 按需加载，首屏不阻塞

### 3. 侧边栏轮播挂件

挂件可嵌入站点任意页面的侧边栏或任意位置，以紧凑卡片形式循环展示寻亲信息。用户无需进入寻亲列表页，在日常浏览论坛的过程中就能看到寻亲信息。

### 4. 图片代理服务

寻亲信息中的照片来源于官方平台，直接外链存在两个问题：一是源站可能防盗链导致图片无法显示，二是外链会暴露用户 IP 给第三方。
插件内置图片代理服务，所有寻亲照片通过本站中转获取

### 5. 主题色自定义

内置 6 套主题配色方案，一键切换前台页面与挂件的视觉风格
主题色通过 CSS 变量驱动，前台页面与挂件同步生效，无需修改任何代码。

## 三、常见问题

**Q：插件安装后看不到数据？**

A：插件安装后默认不会自动同步数据。请到后台同步管理手动触发一次全量同步，或等待计划任务首次执行。

**Q：挂件不显示或样式错乱？**

A：请检查两点：一是挂件 JS 是否正确加载（浏览器开发者工具 Network 面板），二是 Discuz 模板缓存是否已清理。插件升级后建议清理一次模板缓存。

**Q：图片显示不出来？**

A：可能是图片代理服务被限制。检查后台图片代理白名单域名配置，确保包含 `rangaihuijia.com`。同时检查缓存目录 `data/plugin/nm_xunren/cache` 是否存在且可写。

**Q：同步一直失败怎么办？**

A：到后台同步日志查看失败原因。常见原因包括：源站临时不可用、服务器网络出口受限、PHP `allow_url_fopen` 或 curl 扩展未启用。日志中会记录具体错误信息。

**Q：可以修改寻亲信息的内容吗？**

A：可以。后台数据管理支持单条编辑。但请注意，修改后的内容不会与源站同步更新，下次增量同步时若源站数据有变更，可能会覆盖你的修改。**（注：请勿随意变更寻亲数据，因此而产生的后果本人概不负责）**

**Q：挂件可以嵌入到非 Discuz 页面吗？**

A：可以。使用挂件独立页面地址 `plugin.php?id=nm_xunren:nm_xunren&amp;amp;amp;amp;op=widget`，通过 iframe 嵌入即可。也可直接引用 widget.js 在任意 HTML 页面中初始化。

---

## 四、数据来源声明

本插件展示的所有寻亲信息来源于让爱回家公益寻人平台（rangaihuijia.com），数据所有权归属官方平台。

插件仅用于公益传播，不对数据内容做任何担保。如发现信息有误或已过时，请以官方平台蕞新数据为准。

---

## 五、使用须知与免责声明

### 使用须知

1. 本插件仅供合法的公益信息传播使用
2. 安装即表示你已阅读并同意以下全部条款

### 禁止行为

严禁利用本插件从事以下行为：

1. 伪造、篡改寻亲信息进行诈骗、敲诈勒索等违法犯罪活动
2. 将寻亲信息用于商业推销、流量变现等非公益用途
3. 爬取、采集本插件展示的数据用于二次售卖或非法传播
4. 利用插件的图片代理功能访问内网资源或进行端口扫描
5. 移除、篡改插件中的数据来源声明与版权信息
6. 将插件部署在涉及违法内容的站点上

### 免责声明

1. 本插件由开发者独立开发，与让爱回家公益寻人平台无隶属关系
2. 插件展示的数据来源于公开渠道，开发者不对数据的真实性、准确性、完整性承担责任
3. 因源站数据变更、服务中断、接口调整等原因导致插件功能异常，开发者不承担责任
4. 因站点管理员配置不当、服务器环境问题、第三方模板冲突等原因导致的任何损失，开发者不承担责任
5. 使用者因违反上述禁止行为而引发的一切法律后果，由使用者自行承担，开发者不承担任何连带责任
6. 开发者不对插件的持续维护、功能更新、漏洞修复做任何承诺
7. 插件按现状提供，不附带任何明示或暗示的担保

---

## 六、关于免费

再次强调：本插件完全免费。

- 没有免费版与付费版的区分
- 没有功能限制
- 没有域名授权
- 没有解锁高级特性的入口
- 没有赞助二维码
- 没有广告植入

如果你在任何渠道看到有人售卖本插件，那不是我们授权的。请到应用市场或开发者站点免费获取。

我们做这个插件，不是为了赚钱。如果它能让哪怕一个家庭早日团圆，这一切就值得了。

---

## 七、开发者信息

- 开发者：七夏
- 开发者站点：牛马论坛（niumabbs.com）
- 应用市场主页：https://addon.dismall.com/developer-102775.html
- 数据来源：让爱回家公益寻人平台（rangaihuijia.com）
- 兼容版本：Discuz! X3.4 / X3.5 / X5.0 / X5.1

当前版本
公益版
更新1.0.2 修复后台链接跳转路径不正确
2026-07-09 11:15
公益版

更新1.0.1 优化插件兼容性。
2026-07-09 04:18
公益版

更多历史版本信息