
## 一、它能做什么
| 能力 | 说明 |
|---|---|
| **自动采集 ZBlog 站点** | 内置 ZBlog 站点识别,自动判断目标是否为 ZBlog 且可评论 |
| **友链滚雪球** | 从种子站出发,顺着友情链接向外扩散,自动发现同类 ZBlog 博客 |
| **评论区挖掘** | 从已开放评论的站点评论区,提取其他留言者的网站,作为高质量种子 |
| **多引擎搜索** | 支持谷歌 / 百度 / 必应 / 360 / 搜狗 / 神马 / 雅虎 / Yandex / 头条等 |
| **自动评论提交** | 自动解析评论表单、构造提交数据、模拟浏览器请求 |
| **评论回访验证** | 提交后重新抓取页面,确认页面上真的出现了你的评论,才算成功 |
| **整站评论** | 首评成功后可自动把该站其他文章全部评论一遍 |
| **双通道并发** | 通道1「边采集边评论」、通道2「专门跑导入」,两路同时运行 |
| **代理支持** | 支持代理API与代理列表,带可用性预检 |
---
## 二、核心设计:只有"看得见"才算成功
工具不会因为服务器回了一句"成功"就记成功。提交流程是**三步**:
```
① 解析评论表单 → ② 提交评论 → ③ 回访页面,确认评论真的显示了
```
回访验证会做这些判断:
- 页面上**能不能找到你刚发的那句话**(自动穿透 HTML 转义、`<br>` 断行、多余空格、内容截断)
- 页面提示"需审核" → 归类为 **审核中**(不算成功)
- 服务器说"重复评论" → 归类为 **重复评论**
- 什么都没找到 → 归类为 **未确认**
**只有第③步在页面上真的看到你的评论,才会记为「成功」。**
---
## 三、结果分类
所有结果都会自动写进 exe 同目录的 `data` 文件夹,一个类别一个文件:
| 结果 | 含义 | 能否改善 |
|---|---|---|
| **成功** | 页面上已能看到你的评论 | ✅ 目标 |
| 审核中 | 服务器接受,但需人工审核后才显示 | 只能等 |
| 未确认 | 提交了,但页面找不到 | 多半被拦 |
| 重复评论 | 该站已评论过 | 换站 |
| **评论已关闭** | 该站评论功能关闭 | ❌ 结构性不可能 |
| **需登录** | 评论框为 disabled,要求登录 | ❌ 结构性不可能 |
| **需验证码** | 表单含验证码字段 | ❌ 结构性不可能 |
| IP不合法 | IP 被限制 | 开代理 |
| 失败 | 服务器拒绝,会显示真实原因(如 `code=15 名称格式不正确`) | 看原因 |
> 界面结果列表可勾选**「只显示评论成功」**,也可以右键**导出成功列表到文件**。
---
## 四、界面说明
底部四个页面:
### 首页
- 顶部显示统计:`任务 · 成功 · 采集`
- 状态指示:`● 运行中 排队 N 条` / `○ 已停止`
- **启动/停止** 切换按钮、**清空队列** 按钮
- 运行日志窗口(实时输出采集与评论过程)
### 采集
- **采集关键词**(搜索用,一行一个)
- **站点校验特征**(判定用,支持 XPath,一行一个)
- **种子站点**(友链滚雪球起点,一行一个)
- **循环采集**开关 + **每轮间隔**
- 抓取页数、并发线程
- 搜索引擎勾选(建议只留**必应 / 谷歌 / 百度**)
- 采集结果列表
### 评论
- **导入URL** / **导入评论**
- 通道2开关、整站评论开关、随机邮箱开关
- **评论后回访确认** + 回访次数
- 评论内容(一行一个,随机取用)
- 用户名 / 邮箱 / 网站
- 结果列表(**双击打开网址**,右键可复制/清空/导出)
### 设置
- 代理(开关 / API 地址 / 列表)
- User-Agent / Referer / 超时
- 评论数据文件路径
- 保存设置(同时会实时自动保存)
---
## 五、使用步骤
### 1. 先填好"身份信息"(最重要)
在**评论**页填写:
- **网站**:填 **`https://jta.mobi`** —— 这是外链的目的,评论成功后会作为你的主页地址留下
- **评论内容**:填 **20 条以上不同的话**,一行一个。全部站点共用同一句话极易被判垃圾
- **用户名**:用自然的昵称,不要留空(留空会自动生成随机名)
- **邮箱**:可留空,留空会自动随机生成
### 2. 配置采集源
在**采集**页:
- **采集关键词**:填产品关键词(如 `zblog 主题`、`zblog 模板`),不要填隐藏代码串
- **种子站点**:填几个你已知的真实 ZBlog 博客网址(已内置一批)
- **搜索引擎**:建议只勾选 **必应**,谷歌在国内直连会超时,百度容易触发反爬
### 3. 启动
点首页 **「启动/停止」** 开始运行。
运行中会看到:
```
通道1 第 N 轮采集:N 条关键词 × N 引擎 × N 页
友链滚雪球:投入 N 个种子站点
本轮深挖 N 个站点
✓ 首评成功 → 整站展开 +N 篇
```
### 4. 查看结果
在**评论**页结果列表双击可打开网址,右键可导出成功列表。
---
## 六、配置文件与数据
| 位置 | 内容 |
|---|---|
| `%APPDATA%\ZblogTool\settings.json` | 全部设置(**实时自动保存**,与 exe 位置无关,移动程序不会丢配置) |
| exe 同目录 `data\` | 各结果分类文件(评论成功.txt / 评论已关闭.txt / 需登录.txt …) |
| exe 同目录 `log\` | 运行日志 |
> 设置页有 **「打开配置目录」** 按钮,可直接跳转备份。
---
## 七、常见问题
**Q:为什么一个评论都没成功?**
A:绝大多数 ZBlog 站的评论是**关闭的、要求登录的、或带验证码的**。工具会自动把这三类识别出来并归到 `评论已关闭.txt` / `需登录.txt` / `需验证码.txt`。真正能留下评论的是少数个人博客。
**Q:结果列表里全是失败,看不出原因?**
A:新版每一条失败都会显示**服务器返回的真实原因**,例如:
```
失败 服务器拒绝:名称格式不正确,可能过长或为空 (code=15)
```
看原因就知道该改什么(补用户名、换代理、或者这个站直接放弃)。
**Q:怎么提高成功率?**
1. 评论主页**一定填 `https://jta.mobi`**
2. 评论内容准备 **20 条以上**不同的话
3. 用户名用自然昵称
4. 开代理(能恢复谷歌/百度两个采集源,也避免 IP 被限)
5. 优先评论**最新文章**(老文章评论多已关闭)
**Q:为什么采集到的站很少?**
- 关键词太窄 → 增加关键词
- 种子太少 → 在种子站点里多填几个真实 ZBlog 博客
- 连续多轮挖不到新站时,日志会明确提示「当前关键词/种子基本挖透了」
**Q:程序会不会闪退?**
不会。所有网络异常、解析异常都被单独捕获,只记日志不中断线程。UI 更新全部线程安全回投。配置文件采用原子写入,损坏时自动回退默认值。
---
## 八、稳定性设计
- **高并发**:固定线程池 + 队列,长时间运行不涨内存
- **不闪退**:全局异常兜底 + 每条任务独立 try/catch
- **不空转**:连续连接失败会大声报警;连续挖不到新站会提示该补种子
- **代理容错**:代理预检失败会自动退回直连,不会抱着死代理空跑
- **引擎容错**:连续取不到结果的引擎会临时停用,避免每轮白等超时
- **编码兼容**:自动识别 UTF-8 / GBK / GB18030,中文站点不会乱码
- **配置安全**:原子写入 + 位置固定,移动或重命名程序都不会丢配置
---
## 九、源码
`源码` 文件夹内为完整 C# 源码(WinForms / .NET 8):
| 文件 | 职责 |
|---|---|
| `Program.cs` | 程序入口与全局异常兜底 |
| `MainForm.cs` | 主界面(手机竖屏 + 底部导航) |
| `RetroTheme.cs` | 复古 Win98 风格控件库 |
| `Models.cs` | 数据模型与配置项 |
| `SettingsStore.cs` | 配置持久化(实时自动保存) |
| `HttpService.cs` | 网络请求(代理解码、编码识别、TLS 兼容) |
| `UrlUtil.cs` | URL 规范化、垃圾域名过滤 |
| `ZblogDetector.cs` | ZBlog 站点与评论表单识别 |
| `ZblogFeatures.cs` | 采集关键词 / 校验特征 / 种子 |
| `CommentEngine.cs` | 评论提交、结果判定、回访验证 |
| `CollectorEngine.cs` | 多引擎采集、友链滚雪球、评论区挖掘 |
| `DualChannelEngine.cs` | 双通道并发引擎 |
| `SearchUrlUnwrapper.cs` | 搜索引擎跳转链接还原 |
编译:
```bash
dotnet publish -c Release -r win-x64 --self-contained true ^
-p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true
```
---
## 十、使用提醒
- 请勿在短时间内对同一站点高频提交,工具已内置每站评论篇数上限与队列上限
- 评论能否显示取决于对方站点的审核策略,工具只能保证**提交动作被正确执行并验证**
- 建议先用「导入」通道跑一批你确认过的站点,确认链路正常后再放开自动采集
---
## 十一、联系与支持
| 渠道 | 地址 |
|---|---|
| **官网** | **jta.mobi** |
| **QQ 群** | **1039545483** |
使用中遇到问题、想反馈建议、或需要定制功能,欢迎加群交流。
> 加群请注明来意,方便快速通过。