# 收录助手

## 功能介绍

这是一个为 Xiuno BBS 开发的搜索引擎自动提交收录插件，支持百度、必应、Google 等主流搜索引擎。插件提供美观的后台管理界面，支持自助配置API，实时查看收录状态。

### 主要功能

1. **自动提交** - 发帖后自动添加到提交队列

2. **多引擎支持** - 支持百度、必应、Google

3. **收录状态显示** - 文章页面显示各搜索引擎的收录状态

4. **统计图表** - 后台提供详细的提交统计和趋势图表

5. **定时任务** - 自动提交和清理日志

6. **防重复提交** - 已收录的文章不会重复提交

## 安装说明

1. 将插件文件夹上传到 `plugin/kkb_seo_up/` 目录

2. 登录后台，进入插件管理

3. 找到"收录助手"插件，点击安装

4. 安装完成后，点击启用

5. 点击"收录设置"按钮，配置搜索引擎API

## 配置说明

插件启用后，会在插件列表中显示两个按钮：

- **收录设置** - 配置搜索引擎API和功能参数

- **提交统计** - 查看提交情况和收录统计

### 1. 百度推送API

登录百度站长平台：https://ziyuan.baidu.com/

- 进入"普通收录" -> "资源提交" -> "API提交"

- 复制接口调用地址，格式如：`http://data.zz.baidu.com/urls?site=https://example.com&token=xxxxx`

- 将地址填入插件设置的"百度推送API"

### 2. 必应推送API

登录必应网站管理员工具：https://www.bing.com/webmasters/

- 进入"设置" -> "API访问" -> "API密钥"

- 获取API密钥后，构建API地址：`https://ssl.bing.com/webmaster/api.svc/json/SubmitUrlbatch?apikey=你的密钥`

- 将地址填入插件设置的"必应推送API"

### 3. Google推送API

使用 Google Indexing API 需要更复杂的配置：

- 访问 Google Cloud Console

- 创建项目并启用 Indexing API

- 创建服务账号并下载凭证

- 配置 OAuth 认证

## 使用说明

### 后台管理

1. **插件设置** - 配置各搜索引擎的API地址和提交参数

2. **提交统计** - 查看提交情况、收录统计和趋势图表

### 前台显示

在文章页面会自动显示该文章在各搜索引擎的收录状态：

- 待提交（灰色）

- 已提交（蓝色）

- 已收录（绿色）

- 提交失败（红色）

### 定时任务

插件包含两个定时任务：

1. **自动提交** - 每30分钟执行一次，提交待提交的URL

2. **清理日志** - 每天凌晨3点执行，清理过期日志

## 文件结构

```

kkb_seo_up/

├── conf.json                           # 插件配置文件

├── unstall.php                         # 安装/卸载脚本

├── kkb_seo_up.class.php               # 插件主类

├── README.md                           # 使用说明

├── admin/                              # 后台管理

│   ├── setting.htm                     # 设置页面

│   ├── setting.php                     # 设置控制器

│   ├── statistics.htm                  # 统计页面

│   └── statistics.php                  # 统计控制器

├── model/                              # 数据模型

│   └── kkb_seo_submit.class.php       # 提交记录模型

├── hook/                               # 前台钩子

│   └── thread_read_after.htm          # 文章页面钩子

├── cron/                               # 定时任务

│   ├── auto_submit.php                 # 自动提交任务

│   └── clean_logs.php                  # 清理日志任务

└── lang/                               # 语言包

    └── zh-cn.php                       # 中文语言包

```

## 数据库表

插件会创建一个数据表 `bbs_kkb_seo_submit`，用于记录提交历史：

- `id` - 记录ID

- `tid` - 主题ID

- `url` - 提交的URL

- `engine` - 搜索引擎（baidu/bing/google）

- `status` - 状态（0-待提交，1-已提交，2-已收录，3-提交失败）

- `submit_time` - 提交时间

- `check_time` - 检查时间

- `response` - 响应信息

## 注意事项

1. 确保服务器支持 cURL 扩展

2. 各搜索引擎对提交频率有限制，请合理设置提交限制

3. Google API 配置较复杂，建议先配置百度和必应

4. 定期查看后台统计，了解提交情况

## 版本信息

- 版本：1.0.0

- 适用于：Xiuno BBS 4.0+

- 作者：KKB

- 更新日期：2026-01-13

## 技术支持

如有问题，请联系插件作者或访问官方论坛。