1. 软件用途
该软件用于自动完成 wcplusPro Max Windows 微信参数获取流程：
- 激活已经打开的微信窗口，通常是文件助手。
- 在当前聊天窗口的输入框中发送文章链接。
- 点击刚发送出去的文章链接。
- 等待文章窗口打开。
- 按配置刷新文章若干次。
- 关闭文章窗口。
- 在监控模式下，定时查询本地 wcplusPro API，发现需要刷新参数的任务后自动选择近期文章执行刷新。
当前版本默认你已经把微信切到“文件传输助手”聊天窗口。软件不会再搜索联系人，也不会切换聊天对象。
2. 使用前准备
2.1 Windows 微信
先在 Windows 桌面打开微信，并登录账号。
建议手动打开“文件传输助手”聊天窗口，并保持主微信窗口可见。软件会激活微信窗口，然后点击配置中的输入框相对位置，直接发送链接。
2.2 wcplusPro API
监控模式依赖本地 API，默认地址是：
http://localhost:5001/api
代理切换 API 默认地址是：
http://localhost:5001/api/settings/proxy
如果 API 不在当前 Windows 机器上，需要在软件里修改 Endpoint 配置。
启动 Monitor 或 Single 前，软件会先检查：
API是否可访问，也就是默认的localhost:5001服务是否已启动。{API}/settings/license是否能返回授权信息。- 授权信息是否允许使用微信参数自动化功能。
仅Max版支持微信参数自动化获取
如果无法访问 API，通常说明 wcplusPro 没有启动、5001 端口不可访问，或者 Endpoint 中的 API 地址配置错误。
3. 两种运行模式
3.1 Monitor
Monitor 是自动监控模式。点击 Start Monitor 后，软件会按照 Poll 间隔调用：
GET /task/recent
如果最近任务满足下面条件，就会触发刷新：
CrawlerType是wx_article_link或reading_dataStatusError不为空，并且不是无
触发后，软件会调用近期文章接口：
GET /report/gzh_articles?biz=...&offset=0&num=...&sort=p_date&direction=desc
然后从返回的文章中随机选择一篇，发送到当前微信聊天窗口并打开刷新。
3.2 Single
Single 是单链接模式。切换到 Single 后，把文章链接粘贴到输入框，点击 Run Single。
这个模式不会查询任务 API，只会刷新你输入的这一条文章链接。
4. 第一次必须配置文章链接坐标
软件需要知道“刚发送出去的文章卡片/链接”在屏幕上的点击位置。
配置方法：
- 打开微信文件传输助手。
- 在软件里点击
Pick。 - 软件状态会显示
Pick F8。 - 把鼠标移动到微信里文章链接应被点击的位置。
- 按键盘
F8。 - 软件会保存当前鼠标坐标到
X和Y。
保存后的坐标会自动写入配置文件，重启软件后仍会保留。
如果微信窗口位置、缩放、显示器布局发生变化，需要重新 Pick 一次。
5. 主界面说明
顶部状态
Idle：软件空闲。Live：Monitor 或 Single 正在运行。Pick F8：正在等待你按 F8 拾取文章链接坐标。
标题下方会显示最近一条运行事件，例如正在检查任务、已选择文章、打开文章失败等。
Monitor / Single
Monitor：定时检查 wcplusPro API，自动选择文章刷新。Single：手动输入一条文章链接并刷新。
运行中不能切换模式。
Running / Ready 卡片
Ready：可以开始运行。Running：正在运行。Pick Coordinate：正在等待 F8 拾取坐标。
运行按钮说明：
- 蓝色
Start Monitor/Run Single：开始执行。 - 浅红背景 + 大红进度条
Stop 19s：正在运行，按钮上显示距离下一次检查的剩余秒数。 - 大红进度条会随着倒计时逐渐变短。
- 点击
Stop会请求停止。正在执行微信操作时，需要等当前步骤结束后才会完全停下。
Cycles
监控循环次数。
- 主数字：已经执行的检查轮数。
skipped：检查到了任务但没有触发刷新，或没有返回任务的次数。
Refresh
刷新统计。
- 主数字：成功完成刷新流程的次数。
failed：刷新失败次数。
6. 配置项说明
Timing
Poll
监控模式每隔多少秒检查一次任务 API。
默认：60
数值越小，检查越频繁；数值太小可能增加本地 API 压力。
Open
文章打开后，等待多少秒再开始第一次刷新。
默认：4
如果文章窗口打开慢，或网络较慢，可以调大。
After send
发送链接后，等待多少秒再点击文章链接坐标。
默认：1
如果微信发送消息有延迟，可以调大。
Window wait
点击文章链接后，等待文章窗口出现的最长秒数。
默认：12
如果微信文章窗口打开慢，可以调大。
Refresh
Reloads
每篇文章打开后刷新多少次。
默认：1
设置为 0 表示打开文章后不刷新，只等待并关闭。
Articles
Monitor 模式从最近多少篇文章中随机选择一篇。
默认：5
对应 API 参数里的 num。
Wait min
每次刷新后等待的最短秒数。
默认：3
Wait max
每次刷新后等待的最长秒数。
默认：5
软件会在 Wait min 和 Wait max 之间随机等待。
要求：
0 <= Wait min <= Wait max
Article Link Coordinate
X
文章链接点击点的屏幕绝对 X 坐标。
通常不要手动填写，使用 Pick + F8 获取。
Y
文章链接点击点的屏幕绝对 Y 坐标。
通常不要手动填写，使用 Pick + F8 获取。
Pick
进入坐标拾取模式。
点击后，把鼠标移动到文章链接点击点，按 F8 保存坐标。
Endpoint
Proxy
是否启用代理切换。
开启时，每次打开文章前会调用：
POST {Proxy API}/set
文章处理结束后会调用：
POST {Proxy API}/unset
关闭时不会调用代理 API。
API
wcplusPro 本地 API 根地址。
默认：
http://localhost:5001/api
Monitor 模式会使用这个地址查询任务和文章。
Proxy API
代理切换 API 地址。
默认：
http://localhost:5001/api/settings/proxy
软件会在后面拼接 /set 和 /unset。
Request
查询任务 API 和文章 API 的超时时间，单位秒。
默认：5
Proxy
代理切换 API 的超时时间，单位秒。
默认：5
其他选项
未发现微信窗口时尝试启动微信
开启后，如果软件找不到可见微信窗口，会尝试从常见路径启动 Weixin.exe 或 WeChat.exe。
建议平时关闭。最稳定的方式是先手动打开并登录微信。
使用 F5 刷新文章
开启后使用 F5 刷新文章窗口。
关闭时使用 Ctrl + R 刷新。
默认关闭。
7. 配置保存位置
点击 Save Config 会保存当前配置。
使用 Pick + F8 拾取坐标后，也会自动保存配置。
配置文件保存在 Tauri 的应用数据目录中，文件名是：
config.json
具体目录由 Windows 系统和 Tauri 决定，通常在用户 AppData 目录下。
8. 输出文件
Monitor 模式停止或结束时，会生成一份运行报告：
refresh_req_data_report_YYYYMMDD_HHMMSS.txt
报告包含：
- API 配置
- 轮询次数
- 成功刷新次数
- 失败次数
- 最近错误
- 运行日志
9. 常见问题
F8 没有保存坐标
先确认软件状态显示 Pick F8。
如果没有显示，先点击 Pick。
如果已经显示但没有保存，确认当前键盘的 F8 没有被系统、键盘驱动或其他软件拦截。
点击文章链接失败
通常是坐标不对。
重新执行：
- 点击
Pick - 移动鼠标到文章链接点击位置
- 按
F8
如果微信窗口移动到了其他显示器，或者系统缩放变化，也需要重新 Pick。
找不到微信窗口
确认：
- 微信已经登录。
- 主窗口不是最小化到托盘。
- 文件传输助手聊天窗口可见。
必要时开启“未发现微信窗口时尝试启动微信”。
启动时提示无法读取授权信息
软件启动 Monitor 或 Single 前会访问：
{API}/settings/license
请确认：
- wcplusPro 已经启动。
- 5001 端口可以访问。
- Endpoint 里的
API地址正确。
启动时提示仅Max版支持微信参数自动化获取
表示授权校验没有通过。
请确认当前 wcplusPro 授权是 Max，或者授权还在有效期内。
已经保存配置但重启后没生效
确认点击了 Save Config，或者坐标是通过 Pick + F8 保存的。
如果仍然没生效，可能是应用数据目录没有写权限，可以查看日志中是否有 Config save failed。
Windows 提示软件不安全
当前 exe 和安装包没有代码签名。Windows 第一次运行时可能提示安全警告，这是未签名软件的正常现象。
10. 推荐使用流程
- 打开 Windows 微信，进入文件传输助手。
- 打开本软件。
- 点击
Pick，移动鼠标到文章链接点击点，按F8。 - 检查 API、Timing、Refresh 配置。
- 点击
Save Config。 - 使用
Single跑一条文章测试。 - 测试稳定后切换到
Monitor，点击Start Monitor。