KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

roco-merchant-notifier

★ 37 Open GitHub ↗

洛克王国远行商人提醒

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 洛克王国世界：远行商人自动提醒助手 🛒

这是一个基于 **GitHub Actions** 的轻量化自动化工具，专门用于监控《洛克王国世界》中“远行商人”的刷新状态。每当商人带着道具刷新时，系统会自动抓取图文数据，并精准推送到你的手机（支持 iOS 和 Android）。

### ✨ 特性

* **精准过滤**：内置北京时间校准，自动计算当前商人轮次（1-4轮）与倒计时，彻底过滤上一轮过期商品。
* **完美 UI 渲染**：结合 `Jinja2` 模板引擎与 `Playwright` 无头浏览器，直接读取本地字体和背景图，实现与原版完全一致的极致视觉效果。
* **极速图床托管**：集成 ImgBB API，自动将高质量截图转化为网络链接，减轻推送通道压力。
* **双通道推送**：
  * 🍏 **iOS**: 通过 [Bark](https://github.com/Finb/Bark) 实现带大图的系统级通知。
  * 🤖 **Android**: 通过 [NotifyMe](https://notifyme.wzn556.top/)  实现高优先级通知推送。
* **防拥堵机制**：GitHub Actions 定时任务设置“提前 5 分钟”排队策略，有效对抗官方节点延迟。

### 📸 效果预览
<div align="center">
  <img src="https://github.com/user-attachments/assets/22d6f77f-7525-439b-a47e-6b93473ef87e" width="320" alt="手机通知预览" />
  <br>
</div>

### 🚀 快速上手

#### 1. Fork 仓库或创建新仓库
点击页面右上角的 `Fork` 按钮，将本项目复制到你的账号下；或者直接新建一个私有/公开仓库，并上传 `main.py`。

#### 2. 申请 API Key
本项目的数据源由 [Entropy-Increase-Team](https://github.com/Entropy-Increase-Team/) 提供。
[key申请点这里](https://rocom.shallow.ink/) (收费)

#### 3. 配置 GitHub Secrets (核心步骤)
进入你的 GitHub 仓库 -> `Settings` -> `Secrets and variables` -> `Actions`，点击 `New repository secret`，依次添加以下 **4 个环境变量**：

| Secret 名称 | 必填 | 说明 | 获取方式 |
| :--- | :---: | :--- | :--- |
| `ROCOM_API_KEY` | ✅ | 游戏数据接口访问凭证 | [社区网关](https://rocom.shallow.ink/)提供（收费） |
| `IMGBB_KEY` | ✅ | 图床上传 API Key | 注册 [ImgBB](https://api.imgbb.com/) 获取 |
| `BARK_KEY` | 选填 | iOS 推送 Key | Bark App 内复制 |
| `NOTIFYME_UUID` | 选填 | Android 推送 UUID | NotifyMe App 内获取 |

*(注：`BARK_KEY` 和 `NOTIFYME_UUID` 至少填入一个即可接收通知，未填写的通道脚本会自动跳过，不会报错。)*

#### 4. 开启 GitHub Actions
点击仓库上方的 `Actions` 选项卡，确保它已启用（点击 `I understand my workflows, go ahead and enable them`）。

---

### ⏰ 定时任务说明

本项目默认在 `.github/workflows/schedule.yml` 中配置了 GitHub 定时任务，对应北京时间 **08:00、12:00、16:00、20:00** 运行。

**💡 进阶技巧：如何保证秒级准时？**
由于 GitHub 默认的定时器存在严重延迟，我们使用免费的 [cron-job.org](https://cron-job.org/) 来精准触发。

1. **获取 GitHub Token**：去 GitHub 设置页生成一个 Personal Access Token (Classic)，勾选 `workflow` 权限并复制保存。
2. **创建定时任务**：在 cron-job.org 创建新任务，设为你需要的时间。
3. **配置 API 请求**：
   - **URL**: `https://api.github.com/repos/你的用户名/你的仓库名/actions/workflows/你的 yml 文件名.yml/dispatches`
   - **Method**: `POST`
   - **Request Body**: `{"ref":"master"}` *(如果你的默认分支是 main，请改为 main)*
   - **Headers** :
     - `Accept`: `application/vnd.github+json`
     - `Authorization`: `Bearer 你的 Token` *(注意 Bearer 后有空格)*
     - `Content-Type`: `application/json`
     - `User-Agent`: `cron-job-org`

---

### 🛠️ 技术实现

* **Python 3.10**: 核心逻辑编写。
* **Requests**: 数据抓取与网络请求。
* **Playwright**: 驱动 Chromium 浏览器进行 HTML 解析与精准截图。
* **Jinja2**: 将动态商品数据注入到静态 HTML 模板中。

---

### ⚖️ 免责声明
本项目仅供学习交流使用，数据来源于第三方开源社区。作者对接口的稳定性不作保证，请勿用于商业用途。

---

## 🙏 鸣谢

* 数据接口及原始前端 UI 模板设计来自：[Entropy-Increase-Team/astrbot_plugin_rocom](https://github.com/Entropy-Increase-Team/astrbot_plugin_rocom)

roco-merchant-notifier

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README