云采助手

安装启用

1. 后台应用中心安装「云采助手」
2. 后台进入 插件，启用「云采助手」
3. 启用后自动创建规则数据表并生成默认配置（含 API 密钥）
4. 侧栏点击 云采助手 进入管理页

首次配置

进入 插件配置 标签：

1. 自定义验证（key）：至少 6 位，用于采集 API 鉴权；计划任务 URL 中的 key 即此值，请勿泄露
2. 按需开启 HTML 转 Markdown、robots 协议、自动采集
3. 设置运行间隔、抓取间隔、失败等待与重试次数
4. 在 图片配置 中选择储存方式（本地 / OSS / COS / 七牛），并指定附件资源分类
5. 点击页面底部 立即提交 保存

提示：开启伪静态后，请使用插件配置页展示的伪静态采集地址；旧式 ?plugin=yuncai&task=… 将失效。

创建采集规则

1. 打开 会员中心（远程不可用时可「游客进入」）
2. 在规则管理中 新增规则，填写规则名称与目标站点
3. 按标签页配置：
   • 采集设置：站点网址、编码、简介等
   • 采集网址：列表页 URL 生成规则（数字/字母/自定义等）
   • 内容列表：从列表页提取文章链接
   • 获取内容：配置标题、正文、摘要、封面、标签等字段
4. 可为字段添加 处理过程（如批量替换、提取首图等）
5. 保存后用 试抓 验证列表与字段是否正确
6. 试抓页确认无误后可直接 发布 到本站

字段映射说明

插件配置中的参数映射（默认示例）：
标题=title 内容=content 摘要=excerpt 封面=cover 标签=tag

请保证规则字段名与发布映射一致，否则无法正确写入文章。

批量采集与定时任务

1. 在规则 设置 中填写 任务名（英文/数字，供 Cron 调用）
2. 开启插件配置中的 自动采集
3. 任选一种触发方式：
   • 伪静态：Url::plugin 形式的采集地址（配置页有完整示例）
   • 直接 API：/content/plugin/yuncai/lib/api.php?act=collection&task=任务名&key=密钥
4. 可选：配置宝塔面板地址与 API 密钥，使用「一键添加采集计划任务」
5. 重新全量扫描时可在 URL 后加 &reset=1

批量采集采用「磁盘队列 + 每次 1 篇」续跑，适合长时间任务，不易因内存过高中断。

写文章页一键采集

1. 进入后台 写文章 或 写页面
2. 工具栏点击 云采
3. 粘贴文章网址，可选「采集后转 Markdown」
4. 点击 开始采集，标题/正文/摘要/封面等将填入当前编辑页
5. 也可使用 转 Markdown 将当前编辑器 HTML 转为 Markdown

规则市场

1. 打开 规则市场 标签，浏览或搜索规则
2. 安装到本地后可按需修改再采集
3. 本地规则可 导出 备份，或 发布 到市场（需会员登录且远程接口可用）
4. 远程市场不可用时进入 本地模式：游客仍可管理本地规则并完成采集发布

常见问题

合规提示

请遵守目标网站的 robots 协议与版权要求，勿采集隐私、侵权或法律禁止的内容。因违规采集产生的风险由使用者自行承担。