# TaJiDuo-plugin

**Repository Path**: fjcq/TaJiDuo-plugin

## Basic Information

- **Project Name**: TaJiDuo-plugin
- **Description**: No description available
- **Primary Language**: NodeJS
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-08-29
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# TaJiDuo-plugin

基于 TaJiDuo 的 Yunzai-Bot **塔吉多 / 幻塔 / 异环**插件

[安装](#安装) · [快速上手](#快速上手) · [命令](#命令) · [配置](#配置) · [常见问题](#常见问题)

</div>

> **维护说明**：本仓库 Fork 自 [Entropy-Increase-Team/TaJiDuo-plugin](https://github.com/Entropy-Increase-Team/TaJiDuo-plugin)（已停止维护），现由 [@fjcq](https://gitee.com/fjcq) 在 Gitee 继续维护。
> 问题反馈与功能建议请前往 [本仓库 Issues](https://gitee.com/fjcq/TaJiDuo-plugin/issues)。

***

## 功能

* **账号**：网页 / 短信两种登录方式，一个 QQ 可绑定多个游戏账号并随时切换。

* **签到**：幻塔、异环游戏签到，签到日历一览，支持定时自动签到与结果通知。

* **幻塔**：角色档案总览（等级、战力、成就点、拟态数等）与武器 / 拟态 / 时装 / 载具查询。

* **异环**：玩家主页、角色面板、成就、区域探索、房产、载具、实时体力查询。

* **抽卡**：异环抽卡记录同步与统计分析，支持导出记录文件（JSON），卡片 / 经典列表两套模版。

* **便捷功能**：角色别名、帮助菜单、插件自更新与更新日志。

* 当前版本：`0.1.5`；官方反馈群聊: 1090940860

## 安装

在 Yunzai 根目录执行：

```bash
git clone https://gitee.com/fjcq/TaJiDuo-plugin.git ./plugins/TaJiDuo-plugin
```

安装依赖：

```bash
cd ./plugins/TaJiDuo-plugin
pnpm install
```

没有使用 pnpm 的环境可改用 `npm install`。

插件直接依赖：

| 依赖         | 用途             |
| ---------- | -------------- |
| `express`  | 网页登录本地 HTTP 服务 |
| `yaml`     | 读取与解析 YAML 配置  |
| `chokidar` | 监听配置文件变更       |

## 快速上手

1. 重启 Yunzai，发送 `塔吉多帮助` 或 `tjd帮助` 确认插件已载入。

2. 发送 `tjd登录`，在返回的网页里完成短信验证，账号会自动保存并设为当前默认账号。

3. 发送 `yh签到`、`yh主页`、`yh抽卡分析` 等命令开始使用；幻塔同理使用 `ht签到`、`ht档案`。

## 命令

命令前缀支持中文、英文缩写、`#` 与 `/`，例如 `异环主页` / `yh主页` / `#yh主页` 均可：

| 类型  | 前缀                              |
| --- | ------------------------------- |
| 塔吉多 | `塔吉多` / `tjd` / `#tjd` / `/tjd` |
| 幻塔  | `幻塔` / `ht` / `#ht` / `/ht`     |
| 异环  | `异环` / `yh` / `#yh` / `/yh`     |

### 账号与登录

| 命令                            | 说明               |
| ----------------------------- | ---------------- |
| `塔吉多帮助` / `tjd帮助`             | 打开帮助菜单           |
| `塔吉多登录` / `tjd登录`             | 获取网页登录链接         |
| `塔吉多登录 <手机号>` / `tjd登录 <手机号>` | 关闭网页登录后发送短信验证码   |
| `塔吉多登录 <验证码>` / `tjd登录 <验证码>` | 使用短信验证码完成登录      |
| `塔吉多登录列表`                     | 查看本地缓存的账号列表      |
| `塔吉多切换登录 <序号>`                | 切换当前默认账号         |
| `塔吉多删除登录 <序号>`                | 删除指定账号           |
| `塔吉多刷新登录`                     | 刷新当前账号登录态        |
| `塔吉多更新` / `tjd更新`             | 主人命令，拉取并更新插件     |
| `塔吉多强制更新` / `tjd强制更新`         | 主人命令，覆盖插件本地改动后更新 |
| `异环更新记录` / `yh更新日志`           | 查看插件更新记录         |

### 签到

| 命令                  | 说明                     |
| ------------------- | ---------------------- |
| `塔吉多签到` / `tjd签到`   | 为当前 QQ 的所有账号执行幻塔、异环签到  |
| `幻塔签到` / `ht签到`     | 为当前 QQ 的所有账号执行幻塔签到     |
| `异环签到` / `yh签到`     | 为当前 QQ 的所有账号执行异环签到     |
| `幻塔签到状态` / `异环签到状态` | 查询游戏签到状态               |
| `幻塔签到日历` / `异环签到日历` | 查看签到日历（别名：签到一览 / 签到记录） |

### 幻塔

| 命令                             | 说明                              |
| ------------------------------ | ------------------------------- |
| `幻塔档案 [角色ID/名称] [武器/拟态/时装/载具]` | 查询角色游戏数据，不填角色则使用第一个角色，也可按条目名称过滤 |

### 异环

| 命令                                    | 说明                                 |
| ------------------------------------- | ---------------------------------- |
| `异环主页 [角色ID/名称]`                      | 查询角色主页并展示 UID，不填则使用第一个角色           |
| `异环刷新面板` / `yh强制刷新`                   | 强制联网刷新当前角色面板缓存并渲染                  |
| `异环<角色名>面板`                           | 查询角色详细面板（优先读缓存），例如 `yh早雾面板`        |
| `异环成就 [角色ID/名称]`                      | 查询成就进度，可按成就名称过滤                    |
| `异环探索 [角色ID/名称]`                      | 查询区域探索，可按区域名称过滤                    |
| `异环房产 [角色ID/名称]`                      | 查询房产数据，可按房产名称过滤                    |
| `异环载具 [角色ID/角色名/载具名]`                 | 查询载具数据；带载具名时展示详细参数，例如 `yh载具 C2000` |
| `异环体力` / `yh活力` / `yhMR`              | 查询实时体力                             |
| `异环抽卡分析` / `yh抽卡统计` / `yh抽卡记录`        | 查询当前账号抽卡缓存统计                       |
| `异环更新抽卡` / `yh同步抽卡` / `异环更新抽卡分析`      | 联网同步并合并抽卡记录，再查看统计                  |
| `异环导出抽卡` / `yh导出抽卡记录`                 | 导出当前账号抽卡记录为 JSON 文件（仅限私聊）          |
| `异环<角色名>别名`                           | 查看角色别名                             |
| `异环添加<角色名>别名<别名>` / `异环删除<角色名>别名<别名>` | 添加 / 删除角色别名                        |

## 登录

### 网页登录

默认开启网页登录。发送 `塔吉多登录` / `tjd登录`，机器人会返回登录链接。用户在网页完成短信验证后，账号会自动保存，并设为当前默认账号。

如果机器人部署在服务器或反向代理后面，请把 `config/common.yaml` 里的 `login_server.public_link` 改成公网可访问地址。

### 短信登录

关闭 `login_server.enabled` 后，`tjd登录` 不再生成网页登录链接，改为短信验证码模式：

```text
tjd登录 13800138000
tjd登录 123456
```

也兼容旧命令 `塔吉多验证码 13800138000`、`塔吉多登录 123456`。

### 多账号

同一平台用户下可保存多个账号，插件本地会缓存账号列表，使用 `tjd登录列表` 查看、`tjd切换登录 <序号>` 切换、`tjd删除登录 <序号>` 删除。

`tjd签到`、`ht签到`、`yh签到` 会遍历当前 QQ 绑定的所有账号执行签到。数据查询默认使用当前账号，可通过 `tjd切换登录 <序号>` 切换。

## 配置

配置文件位于 `plugins/TaJiDuo-plugin/config/`。默认配置位于 `plugins/TaJiDuo-plugin/defSet/`，插件更新默认项时只改 `defSet/`。

首次启动会从 `defSet/` 自动复制常规配置到 `config/`，但 `help.yaml` 与 `message.yaml` 不会自动复制。需要自定义帮助或回复文案时，手动把 `defSet/help.yaml`、`defSet/message.yaml` 复制到 `config/` 后再修改。

### common.yaml

```yaml
timeout: 25000

login_server:
  enabled: true
  port: 25188
  public_link: "http://127.0.0.1:25188"

yihuan_gacha_template: "card"
```

| 配置                         | 说明                                       |
| -------------------------- | ---------------------------------------- |
| `timeout`                  | 请求超时时间，单位毫秒                              |
| `login_server.enabled`     | 是否启用网页登录；关闭后使用 `tjd登录 <手机号>` 短信登录        |
| `login_server.port`        | 本地 HTTP 登录服务端口                           |
| `login_server.public_link` | 发给用户打开的登录地址                              |
| `yihuan_gacha_template`    | 异环抽卡分析图片模版：`card`（卡片网格）或 `classic`（经典列表） |

### sign.yaml

```yaml
auto_sign: true
auto_sign_cron: "30 0 * * *"
notify_list:
  friend: []
  group: []
```

开启 `auto_sign` 后，会按 cron 自动执行 `塔吉多签到` 聚合任务，并向通知列表发送结果。

### Guoba

安装并启用 Guoba-Plugin 后，可在锅巴面板中配置网页登录、自动签到与通知参数、常用回复文案与帮助菜单。

## 常见问题

**网页登录链接打不开或别人无法访问？**

`login_server.public_link` 默认是本机地址。机器人部署在服务器或反向代理后面时，需要改成公网可访问地址。

**想用短信验证码登录？**

把 `login_server.enabled` 改为 `false`，然后发送 `tjd登录 <手机号>` 接收验证码，再发送 `tjd登录 <验证码>` 完成登录。

**绑定多个账号后签到会签到哪个？**

签到命令会自动遍历当前 QQ 绑定的所有账号逐一执行，无需手动切换。

**图片渲染失败？**

图片由 Yunzai 自带的 puppeteer 渲染，请确认 Yunzai 的 Chromium 已正确安装。

## 数据与安全

* 账号数据保存到 Redis：`TJD:USER:${QQ}`。

* 短信验证码临时数据保存到 Redis：`TJD:CAPTCHA:${QQ}`，有效期 10 分钟。

* 网页登录会话保存在插件内存中，登录完成或超时后会清理。

* 本地账号数据会保存登录态凭据、昵称、UID、平台账号 ID、绑定时间等字段，请不要公开 Redis 数据。

* 账号归属按平台用户隔离，同一平台用户下的账号按塔吉多 UID 区分。

## 开发

语法检查：

```bash
npm test
```

提交规范与协作约定见 [CONTRIBUTING.md](./CONTRIBUTING.md)。

目录结构：

```text
plugins/TaJiDuo-plugin
├── apps/          # 命令入口
├── components/    # 网页登录服务
├── config/        # 用户配置
├── defSet/        # 默认配置
├── guoba/         # 锅巴配置面板
├── model/         # 请求与账号模型
├── resources/     # 帮助图与渲染模板
├── DOCS-API/      # 接口参考文档
├── scripts/       # 开发辅助脚本
└── utils/         # 通用工具
```

## 更新记录

### 0.1.5

* 登录、签到、签到日历恢复稳定可用，支持多账号同时展示，不再因上游服务异常中断。

* 异环主页、角色、成就、探索、房产、载具等数据查询恢复正常；幻塔档案总览展示等级、战力、成就点、拟态数、创角时间。

* 异环抽卡分析与角色面板整体重构修复。

* 异环抽卡分析「经典列表」模版整体重绘，补充总抽数、平均保底、每池当前保底进度与最欧/最非等统计；角色出货不再误标「小保底」，「超过玩家」改用官方数值。

* 新增实时体力、签到日历、角色别名、配队、公告与更新日志查询命令；新增抽卡分析模版切换配置。

* 异环抽卡命令收敛为查询 / 更新 / 导出三入口，新增 `yh导出抽卡` 导出 JSON 记录文件（仅私聊）。

### 0.1.4

* 异环抽卡分析优先使用图卡渲染，失败时自动降级为文本转发。

### 0.1.3

* 自动签到通知分开展示幻塔、异环的账号数、成功数与失败数。

## 鸣谢

* 原仓库 [Entropy-Increase-Team/TaJiDuo-plugin](https://github.com/Entropy-Increase-Team/TaJiDuo-plugin)

* TaJiDuo 后端与文档维护者

* Yunzai 系列机器人框架

* 幻塔、异环相关官方数据来源

* 渲染模板参考早柚核心 [NTEUID](https://github.com/tyql688/NTEUID)

## 开源协议

本项目采用 `AGPL-3.0-only`（GNU Affero 通用公共许可证 v3.0，仅限该版本）开源协议，完整协议文本见 [LICENSE](./LICENSE)。

* 本项目为 [Entropy-Increase-Team/TaJiDuo-plugin](https://github.com/Entropy-Increase-Team/TaJiDuo-plugin) 的修改版本，原作品版权归原作团队所有。

* 本仓库自 `0.1.5` 起的变更均由现维护者发布，`0.1.4` 及之前版本的版权归原作团队所有。

* 依据 AGPL-3.0 第 5 条，本仓库的修改版本继续以相同协议分发，不附加任何额外限制。

* 依据 AGPL-3.0 第 13 条（网络交互条款）：即使不在本机分发、仅通过网络（如 QQ 机器人）向用户提供服务，也须向该用户提供对应版本完整的源代码——本仓库公开即是为此义务提供保障。

* 任何基于本项目二次开发、修改或再分发的作品，必须同样遵循 `AGPL-3.0-only`，保留版权与许可声明，并同样履行网络交互的源码提供义务。