README_ZH.md

pwsh-anime-attendance

English | 繁體中文

使用 PowerShell 編寫的多功能遊戲自動簽到工具，支持 HoYoLAB 及 Skport 等遊戲官方社群平台。

功能特性

• 多平台支持：
  • HoYoLAB：支持《原神》、《崩壞：星穹鐵道》、《絕區零》等遊戲簽到。
  • Skport：支持《明日方舟：終末地》的簽到。
• Discord 整合通知：
  • 訊息重用：智能更新同一條 Discord 訊息，避免每天產生新的通知洗版。
  • 精簡模式：可選擇顯示詳細獎勵資訊或精簡的一行摘要。
  • 錯誤標記：當 Cookie 過期或需要手動輸入驗證碼時，自動 Tag 指定用戶或身份組。
• 高度自定義：
  • 支持多帳號、多機器人配置。
  • 可針對不同平台設定不同的 User-Agent 及語言。
• 自動補簽：針對 HoYoLAB 提供自動執行任務並補簽的功能。

快速開始

1. 安裝環境

確保你的系統已安裝 PowerShell Core (7+) 或 Windows PowerShell 5.1 (通常為系統內建)。

2. 獲取專案

將本倉庫複製或下載到本地目錄。

3. 配置參數

1. 將 sign.example.json 修改或另存為 sign.json。
2. 根據需求填入憑證資訊：
   • HoYoLAB: 登入 HoYoLAB 官網，打開瀏覽器開發者工具，獲取 Cookie 中的 ltoken_v2、ltmid_v2 與 ltuid_v2。
   • Skport: 參考下方 如何獲取 Skport 憑證 章節。
3. 配置 Discord Webhook:
   • 在 display.discord.bots 中填入你的 Webhook 網址（如不需要可留空）。
   • 若想啟用訊息更新功能，將 reuse_msg 設為 true。

如何獲取 Skport 憑證

1. 安裝 Violentmonkey 擴充功能（官網）。
2. 前往 腳本鏈接 並安裝/匯入。
3. 打開 終末地簽到頁面 並稍等片刻。
4. 頁面會彈出包含 cred 的視窗，將其複製到 sign.json 即可。

4. 運行腳本

打開 PowerShell 並切換到專案目錄，執行：

./sign.ps1

配置細項說明

Discord 機器人配置 (bots)

• discord_name: 機器人顯示名稱。
• reuse_msg:
  • false: 每次發送新訊息。
  • true: 首次發送後自動記錄 ID，並在之後執行時更新該訊息。
  • [訊息ID]: 手動指定要更新的訊息 ID。
• minimal: 是否開啟精簡顯示（僅顯示獎勵簡稱）。
• profiles: 列表形式，可填入帳號索引 (以 0 開始) 或特定帳號的 console_name。

帳號配置 (profiles)

• platform: hoyolab 或 skport。
• cookies/cred: 對應平台的憑證。
• console_name: 用於日誌顯示及機器人匹配的自定義名稱。

自動化運行

可以使用內置的 sign_schedule.ps1 自動註冊 Windows 工作排程器 (Task Scheduler)：

1. 以 管理員權限 開啟 PowerShell。
2. 執行：./sign_schedule.ps1。
3. 該腳本會自動建立名為 AnimeAttendance 的定時任務，設定在 每日 00:00 (UTC+8) 以及 系統啟動時 自動執行。

免責聲明

本專案僅供學習與交流使用，請勿用於任何商業用途。使用本工具引發的任何帳號問題（如封號、異常等）由使用者自行承擔。