Locoy Publisher v3.1.0：WordPress火车头采集器免登录发布插件

Locoy Publisher v3.1.0

WordPress 火车头采集器免登录发布接口插件

发得快 · 删得净 · 不误删

---

一、插件简介

Locoy Publisher 是一款专为 WordPress 开发的火车头采集器免登录发布接口插件，完美兼容火车头采集器 7.6 - 9.6 版本（含高铁采集器）。插件采用标准 WordPress 插件架构，支持后台一键启用/停用，所有参数可视化配置，无需修改任何代码文件。

本插件由以名知名开发维护，核心解决采集发布的两大痛点："发得快"（中文作者自动处理、分类自动创建、全字段支持）和"删得净"（删除文章时自动清理关联附件，且通过四维引用检测避免误删共享图片）。

插件官网：https://qqditu.com/

---

二、系统要求

<

项目	要求	说明
WordPress	5.0+	已在 6.9.4 上测试通过
PHP	7.2+	已在 PHP 8.x 测试通过，向下兼容 7.x
火车头采集器	7.6 - 9.6	支持高铁采集器（新版火车头）
编码	UTF-8	火车头发布配置选择 UTF-8

---

三、文件结构

插件采用标准 WordPress 插件架构，代码规范，职责分离，共 6 个 PHP 文件：

locoy-publisher/                          # 插件主目录
├── locoy-publisher.php                   # 主插件入口：定义常量、加载核心类
├── publish.php                           # Web 发布入口：火车头采集器调用此地址
└── includes/                             # 核心类目录
    ├── class-publisher.php               # 发布核心：接收 POST 数据、校验、保存文章
    ├── class-admin.php                   # 后台面板：设置页面 + 发布日志页 + 清理日志页
    ├── class-attachment-cleaner.php      # 附件清理：四维引用检测 + 物理文件删除
    └── class-logger.php                  # 双轨日志：本地文件日志 + 数据库日志

架构设计原则：单一职责，每个类只负责一块功能；标准插件架构，支持后台一键启用/停用/升级；异常自动回退，确保发布流程不中断。

---

四、核心功能详解

1. 火车头采集器免登录发布接口

• 免登录发布：安装激活后，直接在火车头 Web 发布配置中填入地址即可使用
• 密码验证：支持设置接口密码，防止恶意调用和垃圾数据注入
• 三模式操作：list 获取分类列表、<save 保存文章、<update 发布定时文章
• 标题防重复：可选开启，检测到重复标题时终止发布并返回提示
• 智能发布时间：支持 now（当前时间）、<next（最后一篇+间隔）、固定时间三种模式
• GMT 自动换算：自动根据 WordPress 时区设置换算 GMT 时间
• 发布后 Ping：可选通知搜索引擎更新，有利于 SEO 收录

2. 附件自动清理系统（核心亮点）

删除文章时，插件会自动清理关联的特色图、正文图片及上传文件，<彻底释放服务器磁盘空间。更关键的是，内置四维引用防误删机制，当图片被多篇文章共用时自动保留，避免传统"连带删除"导致的误删悲剧。

四维引用检测机制

<

检测维度	说明	实现方式
特色图引用	其他文章将该图片设为特色图	查询 _thumbnail_id 元数据
附件记录引用	其他文章的火车头附件记录中包含该 ID	查询 _hm_attachment_ids 元数据
正文内容引用	其他文章正文中包含该图片 URL	LIKE 匹配 post_content
父级关联引用	附件的 post_parent 指向其他有效文章	检查父文章状态

判断逻辑：删除文章前，系统依次检测上述四处引用，<任一被引用即保留附件；仅当四处均未被引用时，才执行安全删除。物理文件同步清理，不残留空记录。

3. 中文作者名智能处理

火车头采集的中文作者名（如"张三"、"李四"）无法直接作为 WordPress 用户名（仅允许英文、数字、下划线），插件自动完成全流程处理：

<
• 拼音转换：内置 300+ 常用汉字拼音对照表，"张三"→"zhangsan"
• 用户名查重：检测 user_login 是否已存在，存在则追加数字序号
• 显示名匹配：同时检测 display_name，避免同一作者创建多个账号
• 邮箱生成：按模板自动生成邮箱（如 zhangsan@qqditu.com），支持冲突处理
• 自动注册：新作者自动注册为 contributor 角色，密码随机生成
• 失败回退：创建失败时自动回退到默认作者 ID，确保发布不中断

4. 分类与内容扩展

• 分类自动创建：传入分类名不存在时自动创建，无需提前手动添加
• 多级父分类：支持指定父分类，父分类不存在时也会自动创建
• 分类描述：同步写入 category_description
• 自定义分类法：支持非 category 的分类法（如自定义 Taxonomy）
• 多分类法批量写入：一次发布可同时写入多个分类法的多个分类
• 标签批量导入：支持 ||| 分隔的多标签
• 文章形式：支持 post-format-image 和 post-format-video
• 自定义字段：支持文章自定义字段（<post_meta）和分类自定义字段（<term_meta）
• 评论批量导入：支持多条评论、评论日期、评论作者批量写入，日期支持口语化（如 "today at 10:00"）

5. 双轨日志系统

日志不仅要能看，还要能长期追溯。插件采用文件日志 + 数据库日志双轨并行设计：

• 附件清理日志：记录每次删除文章时的附件处理详情（成功/跳过/错误）
• 发布日志（v3.1 新增）：独立追踪每次火车头发布的文章 ID、标题、作者、状态
• 文件日志：按日期存档，长期保存于 wp-content/locoy-publisher-logs/ 目录
• 后台可视化：WordPress 后台独立页面查看，带颜色区分（绿/橙/红/蓝）
• 一键清空：支持后台一键清空日志，方便定期维护

---

五、安装使用教程

详细安装教程请访问插件官网：https://qqditu.com/

Step 1：安装 WordPress 插件

<

1. 将 locoy-publisher 文件夹上传到 wp-content/plugins/ 目录（或通过后台上传 zip 压缩包）
2. 进入 WordPress 后台 → 插件 → 找到 Locoy Publisher → 点击启用
3. 左侧菜单出现「火车头发布」，点击进入设置页面

Step 2：配置插件参数

在「火车头发布 → 发布设置」中配置：

• 接口密码：设置复杂密码，防止恶意调用（留空则不验证）
• 默认作者 ID：1（创建作者失败时的 fallback 用户）
• 发布状态：future（定时发布）/ publish（立即发布）/ pending（待审核）/ draft（草稿）
• 时间间隔：1 秒（多篇文章连续发布的时间间隔）
• 检测标题重复：建议开启
• 删除文章时自动清理附件：建议开启
• 仅清理未引用附件：强烈建议开启，防误删共享图片

保存后，页面下方会显示两个地址，<复制备用：

• 文章发布接口：https://你的域名/wp-content/plugins/locoy-publisher/publish.php?action=save&secret=你的密码
• 分类列表接口：https://你的域名/wp-content/plugins/locoy-publisher/publish.php?action=list（无需密码）

Step 3：导入火车头模块

<

1. 打开火车头/高铁采集器
2. 进入 Web 发布配置 / 发布模块管理
3. 点击导入，选择 WordPress免登陆发布接口6.9.4.wpm 文件
4. 导入成功后，模块列表会出现相关条目

Step 4：配置火车头发布

选中导入的模块，配置以下参数：

• 发布地址：粘贴 WP 插件后台复制的「文章发布接口」完整 URL
• 分类列表获取地址：粘贴「分类列表接口」完整 URL
• 编码：UTF-8
• 发布方式：Web发布
• 数据提交方式：POST

配置完成后，点击测试发布。成功返回 发布成功，即可开始正式采集发布。

---

六、适用场景

• 新闻采集站：采集各大新闻源，自动发布到 WordPress，中文作者名自动转拼音创建用户
• 资源下载站：采集软件、教程内容，附带截图附件；删除过期文章时自动清理截图释放空间，共享素材图因被多篇文章引用而保留
• 多作者博客：采集内容分配给不同虚拟作者，每个作者独立账号便于前端展示作者页，邮箱自动生成无需手动维护
• 电商商品采集：批量导入商品分类、标签、自定义字段，支持多级父分类自动创建
• 影视资源站/教程聚合站：支持文章形式（image/video）、评论批量导入，满足内容展示多样化需求

---

七、更新日志

v3.1.0（2026-05-18）

• 全面兼容 PHP 7.2+，降低运行环境门槛，新老服务器均可运行
• 后台界面全面美化，采用标签页导航与卡片式布局，体验更佳
• 新增发布日志功能，独立记录每次火车头发布的详细记录，便于审计追踪
• 优化附件清理正则匹配逻辑，修复正文图片匹配异常
• 更新插件作者信息

v3.0.0（2026-05-16）

• 重构为标准 WordPress 插件架构，支持后台一键启用/停用/升级
• 新增附件自动清理系统（删除文章时自动删除关联附件）
• 新增四维引用检测防误删机制（特色图 / 正文图片 / 附件记录 / 父级关联）
• 新增双轨日志系统（本地文件日志 + 后台可视化查看）
• 新增后台设置面板，所有参数可视化配置，无需修改代码
• 新增中文作者名自动转拼音用户名功能
• 全面兼容 WordPress 6.9.4 + PHP 8.0+
• 优化 GBK 编码文件名兼容性处理（火车头 Windows 环境）
• 修复 add_magic_quotes 弃用函数警告
• 修复 iconv 非法字符处理导致的 PHP 8.0 报错

---

---

八、获取插件与技术支持

插件官网：https://qqditu.com/（可了解功能详情与更新动态）

授权与定价

• 一次性付费，永久使用：50 元买断，无订阅续费，无域名限制
• 代码完全开源：购买后获得全部源码，可自行二次开发或定制修改
• 无需联网授权：插件可离线运行，不依赖外部服务器验证，数据完全自主可控
• 免费升级保障：付费用户可持续获取后续版本更新，无需额外付费

购买与咨询

如需购买或咨询相关问题，可通过以下方式联系：

• QQ：1677027677（添加时请备注"Locoy"或"火车头插件"，优先通过）
• 邮箱：1677027677@qq.com（支持发送截图与附件，适合复杂问题描述）
• 微信：zhaoshukefu（扫码添加，日常在线，响应更快）

<

通常工作日 9:00-22:00 在线，一般问题当天回复，复杂技术问题 24 小时内响应。购买后提供完整安装包、图文配置教程及火车头发布规则示例，确保到手即用。

---

发得快 · 删得净 · 不误删