蓝天采集器（skycaiji）

对接 蓝天采集器 SkyCaiji 的接收端插件。远程蓝天采集器负责采集，本插件提供「自定义发布接口」，把采集数据自动发布到 Zsens Admin 社区版块。

功能

• 蓝天采集器通过自定义发布接口 POST 数据，本站自动创建社区帖子
• 接口令牌鉴权，支持参数、X-Skycaiji-Token Header、Authorization: Bearer 三种方式
• 字段别名兼容（标题、正文、来源、作者、时间、标签、封面等）
• 正文 HTML 清洗：移除脚本 / iframe / 表单等危险标签、事件属性，相对地址自动补全
• 基于来源唯一标识去重；内容未变化跳过，内容变化可自动更新原帖
• 自动同步标签、原文发布时间
• 完整的发布日志（发布 / 更新 / 跳过 / 失败），支持筛选、删除、清空

安装

1. 后台进入「插件管理」，找到「蓝天采集器」并安装
2. 安装完成后在「插件配置」中设置默认版块、发帖用户、发布状态等
3. 打开后台菜单「蓝天采集器」，复制接口地址与接口令牌

蓝天采集器配置

1. 在蓝天采集器中编辑任务，进入「发布设置」
2. 发布方式选择「自定义发布接口」
3. 接口地址填写：https://你的域名/skycaiji/api
4. 保存后蓝天采集器会自动 GET 本接口，读取参数列表
5. 在参数中填入后台显示的 接口令牌
6. 绑定采集字段：

  - title → 标题

  - content → 正文

  - source_url → 原文链接

  - sourcekey → 来源唯一标识（可选，留空自动使用 sourceurl）

  - category_id → 发布版块（可选，留空使用插件默认版块）

  - author / publish_time / tags / cover / digest 按需绑定

字段说明

同时兼容常见别名，例如 subject / body / url / guid / pubdate / keywords / thumbnail 等。

去重与更新

1. 优先按 source_key 查找发布映射
2. 没有映射时按「标题 + 版块」兜底判重
3. 正文哈希未变化 → 跳过（日志记为「跳过」）
4. 正文有变化且开启「重复内容自动更新」→ 更新原帖标题与正文
5. 关闭自动更新 → 跳过并记录日志

常见问题

返回「接口令牌无效」

在后台「蓝天采集器」页面复制最新令牌，并确认蓝天采集器中已保存。重置令牌后必须同步更新。

返回「未指定发布版块」

在插件配置中选择默认发布版块，或在采集参数中传入有效的 category_id。

返回「发帖用户不存在」

在插件配置中填写有效的用户 ID；也可让传入的 author 与本站用户名或昵称一致。

图片无法显示

正文中的相对地址会按 source_url 自动补全，请确保绑定了正确的原文链接。

接口返回「蓝天采集器接口已关闭」

在「插件配置」中开启「启用接收接口」。