塔吉多自动签到

部署页面只需要填写以下两个 Secret。建议分别运行一次 openssl rand -hex 32，生成两段不同的随机字符串：

TAYGEDO_ADMIN_TOKEN=第一段随机字符串
TAYGEDO_CREDENTIAL_KEY=第二段随机字符串

安全提醒：TAYGEDO_CREDENTIAL_KEY 必须使用高强度随机密钥，不要使用手机号、生日、短密码或常用短语。它只需要保存在 Cloudflare Secret 中供 Worker 解密账号密码使用，不需要自己记住；丢失后重新 password 登录生成新的加密密码即可。

KV 命名空间会由 Cloudflare 自动创建和绑定。账号、通知地址、重试次数等可选配置不需要在首次部署时填写；账号可以在部署完成后通过 Worker 登录页写入 KV。

可选：

TAYGEDO_ACCOUNTS=[账号 JSON]
TAYGEDO_NOTIFICATION_URLS=webhook 地址
TAYGEDO_SERVERCHAN_SENDKEY=Server 酱 SendKey

Worker 使用绑定名为 KV 的 Cloudflare KV。可以从 TAYGEDO_ACCOUNTS 初始化，也可以通过登录接口生成账号配置。

访问 Worker 根路径可以打开 Web 登录页：

https://你的-worker.workers.dev/

管理页仅 Cloudflare Worker 支持，用 TAYGEDO_ADMIN_TOKEN 授权；未配置该 Secret 时，/login、/run 和 /status 都会拒绝访问。密码登录可以直接提交；验证码登录会在同一页面先发送验证码，再自动复用设备信息完成登录，并把生成的账号配置写入 KV。页面下方还会显示最近一次签到结果和最近 30 次执行历史，并区分定时任务、手动运行和强制重跑。

通过密码登录并写入 KV：

curl -X POST \
  -H "Authorization: Bearer <TAYGEDO_ADMIN_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"password","phone":"13800138000","password":"你的塔吉多密码","accountId":"main","accountName":"主账号"}' \
  https://你的-worker.workers.dev/login

手动触发签到：

curl -H "Authorization: Bearer <TAYGEDO_ADMIN_TOKEN>" https://你的-worker.workers.dev/run

强制忽略今日去重并重跑：

curl -H "Authorization: Bearer <TAYGEDO_ADMIN_TOKEN>" "https://你的-worker.workers.dev/run?force=1"

读取脱敏后的签到状态：

curl -H "Authorization: Bearer <TAYGEDO_ADMIN_TOKEN>" https://你的-worker.workers.dev/status

状态接口带有 Cache-Control: no-store，只返回签到统计、APP / 游戏签到明细和通知失败数量，不返回 access token、refresh token、密码、通知 URL 或 SendKey。Worker 会把这份脱敏状态保存在 KV 的 <状态前缀>:worker-status；默认 key 为 taygedo:worker-status。状态历史写入采用 best-effort，不会反过来把已完成的签到判为失败；读取时还会与 runner 的 last-run 比较完成时间，避免状态写入偶发失败后页面长期停留在旧结果。

先用本地 CLI 或 Docker 生成账号配置。推荐先在本地确认能正常签到，再部署云函数。

pnpm install
pnpm local login \
  --mode password \
  --phone 13800138000 \
  --account-id main \
  --account-name 主账号 \
  --accounts-file accounts.json

如果账号里包含 encryptedPassword，云函数环境变量里必须配置同一段 TAYGEDO_CREDENTIAL_KEY。

1. 打开 https://console.upstash.com/ 并创建 Redis 数据库。
2. 进入数据库详情，复制 REST URL 和 REST Token。
3. 云函数不需要挂载 Upstash，也不需要 Redis TCP 连接；只要函数能访问公网 HTTPS 即可。

账号初始化有两种方式。

小账号配置可以把 accounts.json 内容临时放入云函数环境变量：

TAYGEDO_ACCOUNTS=[accounts.json 的完整 JSON]

首次运行时程序会把它写入 Upstash 的 TAYGEDO_ACCOUNTS key。确认 Upstash 已有账号配置后，可以删除云函数里的 TAYGEDO_ACCOUNTS，避免环境变量过长。

账号 JSON 较大时，建议直接从本地写入 Upstash，避开云函数环境变量大小限制：

curl -X POST \
  -H "Authorization: Bearer <UPSTASH_REDIS_REST_TOKEN>" \
  --data-binary @accounts.json \
  "<UPSTASH_REDIS_REST_URL>/set/TAYGEDO_ACCOUNTS"

验证写入：

curl -H "Authorization: Bearer <UPSTASH_REDIS_REST_TOKEN>" \
  "<UPSTASH_REDIS_REST_URL>/get/TAYGEDO_ACCOUNTS"

pnpm install
pnpm cloud:function:pack

上传 dist/cloud-function.zip。压缩包根目录包含 index.js，入口方法固定填写：

index.main_handler

必填：

可选：

云函数版会强制使用 Upstash，不需要配置 TAYGEDO_ACCOUNT_STORE 和 TAYGEDO_STATE_STORE。

1. 创建事件函数，运行环境选择 Node.js 18.15 或 Node.js 20.19。
2. 上传 dist/cloud-function.zip。
3. 执行方法填写 index.main_handler。
4. 超时时间建议设置为 300 秒。
5. 添加上面的环境变量。
6. 创建定时触发器，例如每天北京时间凌晨后执行一次。

腾讯云定时触发器会异步调用函数；日志里看到 塔吉多每日签到结果 即表示执行完成。

1. 创建事件函数，请求处理程序类型选择处理事件请求。
2. 运行环境选择 Node.js 18 或 Node.js 20。
3. 上传 dist/cloud-function.zip。
4. 请求处理程序填写 index.main_handler。
5. 超时时间建议设置为 300 秒。
6. 添加上面的环境变量。
7. 创建定时触发器，调用方式选择异步调用。

阿里云定时触发器只需要事件函数，不需要 HTTP 触发器。日志里看到 塔吉多每日签到结果 即表示执行完成。

点击页面右上角 Fork，把仓库复制到自己的 GitHub 账号下。

进入 Fork 后的仓库，打开 Actions。如果 GitHub 提示启用 workflow，点击确认启用。

这个 token 用来让 workflow 自动更新账号 Secret。

1. 打开 GitHub 右上角头像 -> Settings
2. 进入 Developer settings -> Personal access tokens
3. 创建一个 fine-grained token
4. Repository access 选择你 Fork 的仓库
5. Repository permissions 里把 Secrets 设为 Read and write
6. 复制生成的 token

进入 Fork 后仓库：

Settings -> Secrets and variables -> Actions -> New repository secret

添加：

进入 Actions -> 塔吉多登录 -> Run workflow。

推荐使用密码模式：

mode=password
phone=你的手机号
account_id=main
account_name=主账号

mode、account_id、account_name 已有默认值，第一次通常只需要填手机号。password 输入框可以留空，workflow 会读取 TAYGEDO_LOGIN_PASSWORD Secret。

运行成功后，会自动创建或更新 TAYGEDO_ACCOUNTS Secret。

进入 Actions -> 塔吉多签到 -> Run workflow。如果需要忽略今日去重并补跑，把 force_run 设为 true。

看到类似下面的日志就说明部署完成：

塔吉多每日签到结果
总账号：1，成功：1，失败：0

之后 workflow 会按计划每天自动运行。定时运行时会自动调用 liskin/gh-workflow-keepalive@v1，防止仓库长期无活动导致 GitHub Actions 被停用，且不会产生额外的空提交。

Docker Compose 默认使用 GHCR 镜像：

mkdir -p data

创建 .env：

TAYGEDO_LOGIN_PASSWORD=your-password
TAYGEDO_CREDENTIAL_KEY_PATH=/data/credential-key
TAYGEDO_NOTIFICATION_URLS=
TAYGEDO_SERVERCHAN_SENDKEY=
TAYGEDO_MAX_RETRIES=3
TAYGEDO_ACCOUNT_CONCURRENCY=1
TAYGEDO_FORCE_RUN=false
TAYGEDO_LOOP_SECONDS=
TAYGEDO_RUN_AT=

生成账号文件：

docker compose run --rm taygedo-attendance \
  pnpm local login \
  --mode password \
  --phone 13800138000 \
  --account-id main \
  --account-name 主账号 \
  --accounts-file /data/accounts.json

运行一次签到：

docker compose run --rm taygedo-attendance

强制忽略今日去重：

TAYGEDO_FORCE_RUN=true docker compose run --rm taygedo-attendance

以上一次性命令同样会读取 .env。若 .env 中设置了 TAYGEDO_RUN_AT 或 TAYGEDO_LOOP_SECONDS，容器会进入常驻模式而不退出，请显式清空：TAYGEDO_RUN_AT= TAYGEDO_LOOP_SECONDS= docker compose run --rm taygedo-attendance。

常驻定时模式：

TAYGEDO_RUN_AT=09:30 docker compose up -d

设置 TAYGEDO_RUN_AT（24 小时制 HH:MM，上海时区）后，容器启动会先立即执行一次，之后每日固定在该时刻执行，不再受启动时间影响；进程会一直常驻，请用 docker compose up -d 启动，并建议设置 TAYGEDO_DOCKER_RESTART=always，避免宿主机重启后定时任务静默停止。首次执行失败不会让进程退出，日志会记录失败原因并继续等待下一时刻；若首次执行耗时超过当天定时时刻，当天这一次会被跳过并在日志中提示。配合今日去重，当天已签到时重复触发不会重复执行；去重依赖持久化状态存储，请勿同时设置 TAYGEDO_STATE_STORE=memory。

也仍支持按间隔秒数循环（首次执行结束后开始倒计时）：

TAYGEDO_LOOP_SECONDS=86400 docker compose up -d

两者同时设置时 TAYGEDO_RUN_AT 优先。默认留空仍是一次性任务，启动即执行一次后退出。

本地构建镜像：

docker compose build
docker compose run --rm taygedo-attendance

镜像 workflow 会推送 linux/amd64 和 linux/arm64。

在青龙面板的订阅管理中添加仓库，或进入青龙容器后手动拉取：

cd /ql/data/scripts
git clone https://github.com/zzstar101/taygedo-auto-attendance.git
cd taygedo-auto-attendance

scripts/qinglong.sh 顶部带有青龙可识别的任务名和定时注释：

# new Env('塔吉多自动签到')
# cron: 15 1 * * *

拉库后青龙可以自动识别任务名和默认定时。青龙需要 Node.js 18 或更高版本。首次执行 scripts/qinglong.sh 时会自动安装项目依赖；如果青龙没有 pnpm，脚本会依次尝试 corepack pnpm 和 npm install。

在青龙环境变量中添加：

TAYGEDO_LOGIN_MODE=password
TAYGEDO_LOGIN_PHONE=你的手机号
TAYGEDO_LOGIN_PASSWORD=你的塔吉多密码
TAYGEDO_LOGIN_ACCOUNT_ID=main
TAYGEDO_LOGIN_ACCOUNT_NAME=主账号

然后在青龙任务中手动运行一次：

cd /ql/data/scripts/taygedo-auto-attendance && bash scripts/qinglong.sh login

脚本会生成：

/ql/data/taygedo-auto-attendance/accounts.json
/ql/data/taygedo-auto-attendance/credential-key

如果你已经有账号 JSON，也可以直接把它放进青龙环境变量 TAYGEDO_ACCOUNTS。脚本首次运行时会写入 /ql/data/taygedo-auto-attendance/accounts.json；如需强制覆盖已有账号文件，设置：

TAYGEDO_ACCOUNTS_OVERWRITE=true

青龙定时任务命令：

cd /ql/data/scripts/taygedo-auto-attendance && bash scripts/qinglong.sh

建议定时规则设置为每天北京时间凌晨后执行一次，例如：

15 1 * * *

强制忽略今日去重并重跑：

cd /ql/data/scripts/taygedo-auto-attendance && TAYGEDO_FORCE_RUN=true bash scripts/qinglong.sh

脚本也支持把参数继续传给本地 CLI，例如只打印当前账号文件中的设备信息：

cd /ql/data/scripts/taygedo-auto-attendance && bash scripts/qinglong.sh device --print

TAYGEDO_SERVERCHAN_SENDKEY=SCTxxxxxxxxxxxxxxxxxxxxxxxx
TAYGEDO_NOTIFICATION_URLS=https://example.com/webhook
TAYGEDO_MAX_RETRIES=3
TAYGEDO_ACCOUNT_CONCURRENCY=1
TAYGEDO_COIN_TASKS=true
TAYGEDO_CLOUD_DURATION=true
TAYGEDO_SHARE_PLATFORM=qq

如果不想使用默认数据目录，可以指定：

TAYGEDO_DATA_DIR=/ql/data/taygedo-auto-attendance
TAYGEDO_ACCOUNTS_FILE=/ql/data/taygedo-auto-attendance/accounts.json
TAYGEDO_STATE_DIR=/ql/data/taygedo-auto-attendance/state
TAYGEDO_CREDENTIAL_KEY_PATH=/ql/data/taygedo-auto-attendance/credential-key

安装依赖：

pnpm install

生成账号文件：

TAYGEDO_LOGIN_PASSWORD=your-password pnpm local login \
  --mode password \
  --phone 13800138000 \
  --account-id main \
  --account-name 主账号 \
  --accounts-file data/accounts.json \
  --credential-key-file data/credential-key

执行签到：

TAYGEDO_CREDENTIAL_KEY_PATH=data/credential-key pnpm local attendance \
  --accounts-file data/accounts.json \
  --state-dir data/state

打印或生成设备指纹：

pnpm local device --accounts-file data/accounts.json --print
pnpm local device --accounts-file data/accounts.json --account-id main --force