yindan/genshinhelper

genshinhelper

自动获取《原神》每日签到奖励的工具，支持米游社、HoYoLAB社区等平台，提供多账户管理和多种通知方式。

!https://img.shields.io/github/stars/y1ndan/genshinhelper?style=flat-square !https://img.shields.io/github/forks/y1ndan/genshinhelper?style=flat-square !https://img.shields.io/github/issues/y1ndan/genshinhelper?style=flat-square !https://img.shields.io/docker/stars/yindan/genshinhelper?style=flat-square !https://img.shields.io/docker/pulls/yindan/genshinhelper?style=flat-square !https://img.shields.io/pypi/v/genshinhelper?style=flat-square !https://img.shields.io/pypi/dm/genshinhelper?style=flat-square

目录

• 核心功能
• 安装方式
• 使用方法
  • Docker部署
  • PyPI包安装
  • Serverless部署
    • 腾讯云SCF
    • 阿里云FC
    • AWS Lambda
• 配置说明
  • 环境变量
  • 配置文件
  • 多账户支持
• 贡献指南
• 帮助与支持
• 致谢
• 许可证

核心功能

• ✅ 米游社《原神》每日签到
• ✅ HoYoLAB社区《原神》每日签到
• ✅ 微博超话每日签到
• ✅ 支持订阅推送通知
• ✅ 支持多账户管理
• ✅ 支持多角色切换（国服）

安装方式

本项目支持通过https://www.docker.com/%E6%88%96https://www.python.org/%E8%BF%90%E8%A1%8C%EF%BC%8C%E9%9C%80%E6%8F%90%E5%89%8D%E5%AE%89%E8%A3%85%E5%AF%B9%E5%BA%94%E7%8E%AF%E5%A2%83%E3%80%82

Docker

使用以下命令拉取镜像：

sh
$ docker pull yindan/genshinhelper

该命令将拉取genshinhelper的最新版本，镜像可在https://registry.hub.docker.com/r/yindan/genshinhelper/%E6%9F%A5%E7%9C%8B%E3%80%82

PyPI包

也可通过PyPI包安装：

sh
$ pip install genshinhelper

使用方法

Docker部署

以下命令中，COOKIE_MIHOYOBBS为变量名，<COOKIE_MIHOYOBBS>为实际Cookie值，DISCORD_WEBHOOK等同理。所有环境变量详见配置说明。

基本用法

sh
$ docker run -d --name=genshinhelper \
-e COOKIE_MIHOYOBBS="<COOKIE_MIHOYOBBS>" \
-e DISCORD_WEBHOOK="<DISCORD_WEBHOOK>" \
--restart always \
yindan/genshinhelper:latest

高级用法

Docker默认每天6:00（UTC+8）触发签到任务，可通过CRON_SIGNIN变量自定义触发时间（注：时间基于UTC+8时区）。

sh
$ docker run -d --name=genshinhelper \
-e COOKIE_MIHOYOBBS="<COOKIE_MIHOYOBBS>" \
-e DISCORD_WEBHOOK="<DISCORD_WEBHOOK>" \
-e CRON_SIGNIN="0 7 * * *" \  # 每天7:00触发
--restart always \
yindan/genshinhelper:latest

如需使用config.json配置文件，可映射本地配置目录（假设配置文件位于/etc/genshin/config.json）：

sh
$ docker run -d --name=genshinhelper \
-v /etc/genshin:/app/genshincheckinhelper/config \
--restart always \
yindan/genshinhelper:latest

常用命令

sh
# 查看日志（显示最后100行）
$ docker logs -f genshinhelper --tail 100

# 重启容器
$ docker restart genshinhelper

# 更新镜像
$ docker pull yindan/genshinhelper
$ docker rm -f genshinhelper
# 按基本/高级用法重新创建容器

# 卸载
$ docker rm -f genshinhelper
$ docker image rm genshinhelper

PyPI包安装

需先在主机中配置环境变量（详见配置说明），然后执行：

sh
$ python -m genshinhelper

Serverless部署

无服务器环境下可通过云函数实现每日自动签到，需先下载最新的genshinhelper-xxx-serverless.zip压缩包，入口函数为index.main_handler。

腾讯云SCF

注：Cron表达式为7位

1. 进入云函数SCF管理控制台 → 函数服务 → 新建 → 自定义创建 → 基础配置 → 本地上传zip包 → 选择下载的genshinhelper-xxx-serverless.zip → 完成。

2. 进入函数详情 → 函数管理 → 函数配置 → 编辑，将执行超时时间修改为300秒，并添加环境变量（变量列表见配置说明）。

3. 进入触发管理 → 新建触发器，配置定时触发（如每天6:00）。

阿里云FC

注：Cron表达式为6位

1. 进入https://fc.console.aliyun.com/fc/ → 新建函数 → 事件函数 → 代码包上传 → 选择下载的genshinhelper-xxx-serverless.zip，入口函数设为index.main_handler → 新建。

2. 进入函数详情 → 概览 → 修改配置，添加环境变量（变量列表见配置说明）。

3. 进入触发器 → 创建触发器，配置定时触发。

AWS Lambda

注：Cron表达式规则参考https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html

1. 进入https://aws.amazon.com/lambda/ → 创建函数 → 从头开始创作，运行时选择Python 3.8。

2. 在代码页面上传genshinhelper-xxx-serverless.zip，并在运行时设置中将处理器修改为index.main_handler。

3. 添加EventBridge触发器配置定时任务，在配置 → 环境变量中添加所需变量。

配置说明

支持通过环境变量或配置文件两种方式自定义配置。

环境变量

以下为所有支持的环境变量列表：

配置文件

推荐将config.example.json复制并重命名为config.json使用，配置文件示例如下：

json
{
  "LANGUAGE": "en-us",
  "COOKIE_MIHOYOBBS": "",
  "COOKIE_MIYOUBI": "",
  "COOKIE_HOYOLAB": "",
  "COOKIE_WEIBO": "",
  "COOKIE_KA": "",
  "BARK_KEY": "",
  "BARK_SOUND": "healthnotification",
  "COOL_PUSH_SKEY": "",
  "COOL_PUSH_MODE": "send",
  "CUSTOM_NOTIFIER": {
    "method": "post",
    "url": "",
    "data": {},
    "retcode_key": "",
    "retcode_value": 200,
    "data_type": "data",
    "merge_title_and_desp": false,
    "set_data_title": "",
    "set_data_sub_title": "",
    "set_data_desp": ""
  },
  "DD_BOT_TOKEN": "",
  "DD_BOT_SECRET": "",
  "DISCORD_WEBHOOK": "",
  "IGOT_KEY": "",
  "PUSH_PLUS_TOKEN": "",
  "PUSH_PLUS_USER": "",
  "SCKEY": "",
  "SCTKEY": "",
  "TG_BOT_API": "api.telegram.org",
  "TG_BOT_TOKEN": "",
  "TG_USER_ID": "",
  "WW_ID": "",
  "WW_APP_SECRET": "",
  "WW_APP_USERID": "@all",
  "WW_APP_AGENTID": "",
  "WW_BOT_KEY": ""
}

多账户支持

多账户Cookie需用#符号分隔，例如：COOKIE_MIHOYOBBS="<cookie1>#<cookie2>#<cookie3>"

贡献指南

欢迎参与贡献！可提交https://github.com/y1ndan/genshinhelper/issues%E6%88%96PR%E3%80%82

帮助与支持

如需帮助，可加入以下交流群组：

https://qm.qq.com/cgi-bin/qm/qr?k=_M9lYFxkYD7yQQR2btyG3pkZWFys_I-l | *** | ***

致谢

miyoubi功能灵感来源于XiaoMiku01的https://github.com/XiaoMiku01/miyoubiAuto%E9%A1%B9%E7%9B%AE%E3%80%82

感谢https://github.com/y1ndan/genshin-impact-helper%E9%A1%B9%E7%9B%AE%E7%9A%84%E8%B4%A1%E7%8C%AE%E8%80%85%EF%BC%9A

PomeloWang、Celeter、Arondight、chenkid999、xe5700、Renari、journey-ad、aflyhorse、thesadru、PeterPanZH、cainiaowu、alwaysmiddle、qianxu2001

许可证

!https://img.shields.io/pypi/l/genshinhelper?style=flat-square