koishi-plugin-tgd-sign

塔吉多（完美游戏旗下游戏社区 APP）签到 Koishi 插件，参考 Loping151/TGDSign 与 tyql688/NTEUID 的 gsuid_core 实现移植而来。

功能

• tgd login —— 私聊向机器人发起登录，按提示回复手机号 + 短信验证码即可绑定塔吉多账号。
• tgd sign —— 立即对自己已绑定的全部账号执行一次社区签到 + 游戏角色签到。
• 每日 00:01（可配置）自动执行所有订阅账号签到，可选择把结果汇总推送给配置的管理员 ID。
• tgd list / tgd logout / tgd auto on|off / tgd status 管理已绑定账号与调度状态。
• 全部命令以 tgd 为前缀，所有面向用户的文本均集中在 src/locales/zh-CN.json 与 src/config/locales/zh-CN.json 中，便于二次定制。

安装

pnpm add koishi-plugin-tgd-sign

需要 database 服务（任意数据库适配器即可，例如 @koishijs/plugin-database-sqlite）。

配置

| 配置项 | 默认 | 说明 | | :--- | :--- | :--- | | enableAutoSign | true | 是否启用每日自动签到调度 | | autoSignTime | 00:01 | 调度执行时间（HH:mm） | | concurrency | 1 | 自动签到时并发账号数（1-10） | | perAccountDelayMs | 300 | 同一账号内不同游戏角色之间的随机延迟基数（ms） | | betweenAccountDelayMs | 500 | 不同账号之间的随机延迟基数（ms） | | adminIds | [] | 接收每日汇总的管理员账号 ID 列表 | | notifyUserOnAutoSign | true | 自动签到完成后是否私聊用户结果 | | notifyAdminOnAutoSign | true | 自动签到完成后是否推送管理员汇总 | | loginCaptchaTimeout | 300 | 登录流程等待回复的超时（秒） | | requestTimeoutMs | 30000 | 塔吉多 API 请求超时（毫秒） | | proxy | '' | 可选 HTTP/HTTPS 代理 | | logLevel | info | 日志级别 |

命令

| 命令 | 说明 | 备注 | | :--- | :--- | :--- | | tgd login | 启动登录流程 | 仅私聊有效，按提示输入手机号 + 验证码 | | tgd sign | 立即执行签到 | 私聊或群聊均可 | | tgd list | 列出已绑定账号 | | | tgd logout [tgdUid] | 解绑账号 | 不带参数时需回复 yes 确认全部解绑 | | tgd auto on/off [tgdUid] | 切换自动签到 | 不带 tgdUid 时对全部账号生效 | | tgd status | 查看调度状态 | 包含上次/下次执行时间、订阅账号数 |

开发

pnpm install
pnpm run lint     # oxlint
pnpm run fmt      # oxfmt
pnpm run build    # esbuild + tsc --emitDeclarationOnly

鸣谢

• Loping151/TGDSign — 提供了完整的塔吉多 APP 接口实现与签到流程。
• tyql688/NTEUID — 提供了 gsuid_core 上类似插件的整体结构与调度模式。
• echo-cave — Koishi 插件的目录结构、构建工具链与发布流程模板。

License

MIT