feat: harden QDReader Autman plugin

2026-05-17 03:57:11 +08:00
parent b5c9c18840
commit d9ff1d94b2
5 changed files with 593 additions and 166 deletions
@@ -1,5 +1,9 @@
 # 起点读书签到 Autman 插件

+起点读书（QDReader）Autman 签到插件。QX 只负责抓取 Cookie，签到由本插件在 Autman 内完成。
+
+## 文件位置
+
 正式插件文件：

 ```text
@@ -22,10 +26,22 @@ https://gitea.chickliu.fun/Hermes/autman-plugins/raw/branch/main/js/qdreader_sig
 ## 功能

 - QX 抓到 Cookie 后，把 `起点ck <cookie>` 发给 Autman 保存。
- 手动执行：`起点签到`。
- 手动单账号：`起点签到 <uid>`。
- 定时执行：头注 `//[cron: 15 7 * * *]`，每日 07:15 自动签到。
- 查询/维护：`起点ck 查询`、`起点ck 导出`、`起点ck 删除 <uid>`。
+- 手动全部签到：`起点签到`。
+- 手动单账号签到：`起点签到 <uid>`。
+- 定时签到：头注 `//[cron: 15 7 * * *]`，每日 07:15 自动签到。
+- 查询/维护：`起点ck 查询`、`起点ck 导出`、`起点ck 删除 <uid|all>`。
+- 签到结果按成功/失败汇总；普通状态输出 uid 会脱敏，导出命令除外。
+
+## v2.2.0 优化点
+
+- 存储兼容：同时兼容 `get/set` 和 `bucketGet/bucketSet("otto", key)`。
+- 消息兼容：兼容 `getContent/GetContent/input/sender.getContent/sender.getMessage`。
+- 请求兼容：兼容 `request/$request`，并统一解析 `body/data` JSON。
+- 签名兼容：兼容 `{code:0,data:{headers:{...}}}`、`{code:200,data:{...}}`、`{headers:{...}}` 等签名网关返回形态。
+- 网络健壮性：新增 `otto.qdreader_retry_count`，默认重试 1 次，最大 3 次。
+- 定时体验：新增 `otto.qdreader_cron_silent`，可让定时触发且无账号时静默。
+- 安全脱敏：保存/查询/签到结果不直接输出完整 Cookie；`导出` 是管理员主动行为，会输出完整 JSON。
+- 测试覆盖：`tests/qdreader_plugin.test.mjs` 覆盖手动、定时、bucket 存储、重试、查询脱敏、删除全部。

 ## 配置

@@ -34,10 +50,44 @@ Autman 参数：
 ```text
 otto.qdreader_cookie_json = {"uid":"cookie"}
 otto.qdreader_sign_api = https://api.120399.xyz
+otto.qdreader_retry_count = 1
+otto.qdreader_cron_silent = false
 ```

+说明：
+
+- `qdreader_cookie_json`：机器人命令维护，JSON Map 格式。
+- `qdreader_sign_api`：兼容 `/sign` 的签名网关，默认 `https://api.120399.xyz`。
+- `qdreader_retry_count`：请求异常重试次数，默认 1，范围 0-3。
+- `qdreader_cron_silent`：`true` 时，如果定时触发但没有账号，不发送提醒。
+
+## 命令
+
+```text
+起点ck <QX抓到的完整cookie>
+起点ck json {"uid":"cookie"}
+起点ck 查询
+起点ck 导出
+起点ck 删除 <uid>
+起点ck 删除 all
+起点签到
+起点签到 <uid>
+qdreader sign
+```
+
+## 签名与签到流程
+
 签名与签到流程沿用上游 QDReader：

 1. 从 Cookie 解析 `QDHeader/qdh/uid/guid/qimei/qimei36`。
-2. `POST https://api.120399.xyz/sign` 获取签名头。
+2. `POST https://api.120399.xyz/sign` 获取起点请求签名头。
 3. `POST https://h5.if.qidian.com/argus/api/v3/checkin/checkin` 完成签到。
+4. 汇总每个账号签到结果。
+
+## 本地验证
+
+```bash
+node -c plugins/qdreader/qdreader_sign_autman.js
+node -c js/qdreader_sign_autman.js
+node tests/qdreader_plugin.test.mjs
+```