95 lines
3.2 KiB
Markdown
95 lines
3.2 KiB
Markdown
# autman-plugins
|
||
|
||
Autman 插件集合仓库。
|
||
|
||
这个仓库后续统一存放 BOSS 的 Autman 插件，包括但不限于 SimAdmin API 集成插件。
|
||
|
||
## 目录规划
|
||
|
||
```text
|
||
py/ # 实机 Python 脚本插件（参考已有可用插件，优先复制这里的一层 .py 文件）
|
||
js/ # 实机 JS 插件 / 路由插件
|
||
plugins/ # 插件说明、归档和按插件名组织的源码副本
|
||
examples/ # 示例配置 / 调用示例
|
||
docs/ # 设计说明、接口说明、参考资料
|
||
```
|
||
|
||
## 已规划插件
|
||
|
||
### SimAdmin API 插件
|
||
|
||
目标能力：
|
||
|
||
- 获取 SimAdmin 运行状态
|
||
- 获取设备 / SIM / 蜂窝网络状态
|
||
- 发送短信
|
||
- 查询短信列表和短信统计
|
||
|
||
参考 SimAdmin 默认地址：
|
||
|
||
```text
|
||
http://<simadmin-host>:3000
|
||
```
|
||
|
||
常用接口：
|
||
|
||
```text
|
||
GET /api/health
|
||
GET /api/device
|
||
GET /api/sim
|
||
GET /api/network
|
||
GET /api/data
|
||
GET /api/stats
|
||
POST /api/sms/send
|
||
GET /api/sms/list
|
||
GET /api/sms/stats
|
||
```
|
||
|
||
短信发送请求体：
|
||
|
||
```json
|
||
{
|
||
"phone_number": "13800138000",
|
||
"content": "测试短信"
|
||
}
|
||
```
|
||
|
||
## 安全注意
|
||
|
||
插件侧应增加 `access_token` 或 Autman 自身权限校验，避免未授权调用短信发送等敏感操作。
|
||
|
||
## 当前状态
|
||
|
||
初始通用仓库骨架已创建。等待 BOSS 上传既有 Autman 插件后，再按实际风格补齐实现。
|
||
|
||
### 启点读书 QDReader 签到插件
|
||
|
||
- 正式源码：`plugins/qdreader/qdreader_sign_autman.js`
|
||
- 实机 JS 副本：`js/qdreader_sign_autman.js`
|
||
- 定时运行：`cron: 1 7 * * *`，每日 07:01 自动签到；签到结束后立即归档并清空最近运行日志
|
||
- 手动运行：`启点签到` / `启点签到 <uid>`
|
||
- Cookie 维护：`启点账号` / `启点ck <cookie>` / `启点查询`
|
||
- 任务配置入口：`启点账号` → `账号任务配置`，按账号保存到 `qdreader_task_pref_json`；`all on/off` 只影响选中的账号
|
||
- 默认执行：主签到 `/argus/api/v3/checkin/checkin` + 固定低风险领取奖励 `/argus/api/v3/checkin/receivegifts`
|
||
- 可选任务（默认关闭）：激励任务 `mainPage`/`finishWatch`、每日任务 `packagelist`/`finishWatch`、每日抽奖 `detail`/`lottery`、每周兑换 `checkinexchangepage`/`exchangegoods`（仅周日；按上游 `Goods`/`GoodsScore` 选择并提交 `goodId`）、章节卡片 `chaptercardwithbook`、大咖荐书 `pullmessage`
|
||
- 签名环境：相对路径走 `https://h5.if.qidian.com`；大咖荐书使用绝对地址 `https://magev6.if.qidian.com/argus/api/v2/message/pullmessage`；请求签名 method 使用小写；Autman 运行时需支持 `BigInt`（插件避免使用 BigInt 字面量以兼容较旧 JS 解析器）
|
||
- v2.10.3：复核全部任务矩阵、补齐执行窗口/接口文档，并移除 BigInt 字面量，保留 Autman 单插件、独立 bucket、多用户隔离、手动只跑当前用户、cron 跑全部账号、运行后立即归档清日志。
|
||
|
||
Raw 导入：
|
||
|
||
```text
|
||
https://gitea.chickliu.fun/Hermes/autman-plugins/raw/branch/main/plugins/qdreader/qdreader_sign_autman.js
|
||
```
|
||
|
||
验证：
|
||
|
||
```bash
|
||
node tests/qdreader_plugin.test.mjs
|
||
```
|
||
|
||
## 文档
|
||
|
||
- [Autman 插件开发规则与仓库约定](docs/autman-plugin-rules.md)
|
||
- [JS 微服务路由插件模板](templates/js-router-plugin-template.js)
|
||
- [Python middleware 插件模板](templates/python-middleware-plugin-template.py)
|