karin-plugin-mys-core 1.0.0

package/README.md

@@ -0,0 +1,123 @@
+# Karin TypeScript 插件开发模板
+
+## 📖 目录
+
+- [前言](#前言)
+- [快速开始](#快速开始)
+- [详细开发流程](#详细开发流程)
+- [常见问题与建议](#常见问题与建议)
+- [贡献与反馈](#贡献与反馈)
+
+---
+
+## 前言
+
+TypeScript 插件开发流程现在更加简单，无需手动克隆模板仓库，只需一条命令即可快速开始！
+
+> TypeScript 编写 → 编译为 JS → 发布 NPM 包 → 用户安装
+
+---
+
+## 🚀 快速开始
+
+```bash
+pnpm create karin
+```
+
+- 按提示选择“ts插件开发模板”即可自动初始化项目。
+- 进入新建的项目目录，继续开发。
+
+---
+
+## 详细开发流程
+
+1. **一键创建项目**
+
+   ```bash
+   pnpm create karin
+   ```
+
+   - 选择“ts插件开发模板”
+   - 填写你的插件名称（会自动作为 package.json 的 name）
+   - 其余信息按提示填写
+
+2. **安装依赖**
+
+   ```bash
+   pnpm install
+   ```
+
+3. **开发与调试**
+
+   - 启动开发命令：
+     ```bash
+     pnpm dev
+     ```
+   - 编写你的插件代码于 `src/` 目录。
+   - 编译输出：
+     ```bash
+     pnpm build
+     ```
+   - 调试编译之后的代码：
+     ```bash
+     pnpm app
+     ```
+   - 本地调试建议：
+     - 可用 `pnpm link --global` 进行全局软链测试。
+     - 或在 karin 根目录用 `pnpm add ../your-plugin-repo -w` 进行本地依赖测试。
+
+4. **配置 NPM 秘钥**
+
+   > 用于自动化发布，建议开启 2FA。
+
+   1. 注册 [npmjs](https://www.npmjs.com/) 账号。
+   2. 进入 `Access Tokens`，新建 `Classic Token`，类型选 `Automation`。
+   3. 复制生成的 Token。
+   4. 打开你的 GitHub 仓库 → Settings → Secrets and variables → Actions。
+   5. 新建 `NPM_TOKEN`，粘贴 Token。
+   6. 允许 GitHub Actions 创建和批准 PR（Settings → Actions）。
+
+5. **设置包信息**
+
+   > 包名必须唯一，建议先在 [npm](https://www.npmjs.com/) 搜索确认。
+
+   - 初始化时填写的插件名会自动作为 package.json 的 name，无需手动修改。
+   - 其他如 `author`、`description`、`homepage`、`bugs.url`、`repository` 可在 package.json 中补充完善。
+   - **CI 配置无需再手动修改 package-name，已自动同步。**
+
+6. **自动化发布**
+
+   > 推送代码后，GitHub Actions 会自动编译并发布到 npm。
+
+   - 常规开发流程：
+     1. `git add . && git commit -m "feat: ..." && git push`
+     2. 等待 CI 自动发布
+     3. 发布成功后可在 npm 页面看到新版本
+
+7. **安装与验证**
+
+   - 在 karin 根目录下安装你的插件：
+     ```bash
+     pnpm add your-package-name -w
+     ```
+   - 验证插件是否生效，可查看 karin 启动日志或相关功能。
+
+---
+
+## 💡 常见问题与建议
+
+- **Q: 发布失败怎么办？**
+  - 检查 NPM_TOKEN 是否配置正确，权限是否足够。
+  - 包名是否唯一，未被占用。
+  - Actions 日志可定位具体报错。
+- **Q: 如何本地调试插件？**
+  - 推荐用 `pnpm link` 或本地依赖安装。
+- **Q: 如何贡献代码？**
+  - 欢迎 PR，建议先提 issue 讨论。
+
+---
+
+## 贡献与反馈
+
+- 有任何建议或问题，欢迎在 [Issues](https://github.com/KarinJS/karin-plugin-template-ts/issues) 提出。
+- 也可加入官方交流群交流经验。

package/config/config.json

@@ -0,0 +1,3 @@
+{
+  "yiyanApi": "https://api.yujn.cn/api/sjyy.php"
+}

package/lib/app.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/lib/apps/MiHoYoLogin.d.ts

@@ -0,0 +1,5 @@
+import * as node_karin from 'node-karin';
+
+declare const MiHoYoLoginQRCode: node_karin.Command<keyof node_karin.MessageEventMap>;
+
+export { MiHoYoLoginQRCode };

package/lib/apps/MiHoYoLogin.js

@@ -0,0 +1,241 @@
+import {
+  UserInfo,
+  common_exports,
+  fetchQRcode,
+  getCookieAccountInfoByGameToken,
+  getTokenByGameToken,
+  getUserFullInfo,
+  queryQRcode
+} from "../chunk-4JTLXC2G.js";
+import "../chunk-7QISGXVH.js";
+import "../chunk-JML6VYXN.js";
+import "../chunk-JIO4GOQA.js";
+import "../chunk-MLKGABMK.js";
+
+// src/apps/MiHoYoLogin.ts
+import karin, { common as karinCommon, logger, segment } from "node-karin";
+import lodash from "node-karin/lodash";
+import QR from "qrcode";
+var QRCodes = /* @__PURE__ */ new Map();
+var MiHoYoLoginQRCode = karin.command(
+  /^#?(扫码|二维码|辅助)(登录|绑定|登陆)$/i,
+  async (e) => {
+    const qrcode = QRCodes.get(e.userId);
+    if (qrcode) {
+      if (qrcode === true) return true;
+      e.reply(["\u8BF7\u4F7F\u7528\u7C73\u6E38\u793E\u626B\u7801\u767B\u5F55", qrcode], {
+        at: true,
+        recallMsg: 60
+      });
+      return true;
+    }
+    QRCodes.set(e.userId, true);
+    const device = common_exports.randomString(64, "All");
+    const QRcode = await fetchQRcode().request({ device });
+    if (!QRcode?.data?.url) {
+      QRCodes.delete(e.userId);
+      e.reply("\u83B7\u53D6\u4E8C\u7EF4\u7801\u5931\u8D25\u3001\u8BF7\u7A0D\u540E\u518D\u8BD5", { at: true });
+      return true;
+    }
+    const image = (await QR.toDataURL(QRcode.data.url)).replace("data:image/png;base64,", "base64://");
+    if (!image) {
+      QRCodes.delete(e.userId);
+      e.reply("\u751F\u6210\u4E8C\u7EF4\u7801\u5931\u8D25\u3001\u8BF7\u7A0D\u540E\u518D\u8BD5", { at: true });
+      return true;
+    }
+    QRCodes.set(e.userId, image);
+    e.reply(["\u8BF7\u4F7F\u7528\u7C73\u6E38\u793E\u626B\u7801\u767B\u5F55", segment.image(image)], { at: true, recallMsg: 60 });
+    let data, Scanned;
+    const ticket = QRcode.data.url.split("ticket=")[1];
+    for (let n = 1; n < 60; n++) {
+      await karinCommon.sleep(5e3);
+      try {
+        const res3 = await queryQRcode().request({ device, ticket });
+        if (!res3) continue;
+        if (res3.retcode === 3503) {
+          e.reply(res3.message, { at: true, recallMsg: 60 });
+          QRCodes.delete(e.userId);
+          return true;
+        }
+        if (res3.retcode !== 0) {
+          e.reply("\u4E8C\u7EF4\u7801\u5DF2\u8FC7\u671F\uFF0C\u8BF7\u91CD\u65B0\u767B\u5F55", { at: true, recallMsg: 60 });
+          QRCodes.delete(e.userId);
+          return true;
+        }
+        if (res3.data.stat === "Scanned") {
+          if (Scanned) {
+            e.reply("\u4E8C\u7EF4\u7801\u5DF2\u626B\u63CF\uFF0C\u8BF7\u786E\u8BA4\u767B\u5F55", { at: true, recallMsg: 60 });
+          } else {
+            Scanned = true;
+            QRCodes.set(e.userId, true);
+          }
+        }
+        if (res3.data.stat === "Confirmed") {
+          data = JSON.parse(res3.data.payload.raw);
+          break;
+        }
+      } catch (err) {
+        logger.error(err);
+        break;
+      }
+    }
+    if (!data?.uid && !data?.token) {
+      e.reply("\u7C73\u6E38\u793E\u767B\u5F55\u5931\u8D25", { at: true });
+      QRCodes.delete(e.userId);
+      return true;
+    }
+    const res = await getTokenByGameToken().request({
+      account_id: parseInt(data.uid),
+      game_token: data.token
+    });
+    if (!res) {
+      e.reply("\u83B7\u53D6Token\u5931\u8D25", { at: true });
+      QRCodes.delete(e.userId);
+      return true;
+    }
+    const stoken = `stoken=${res.data.token.token};stuid=${res.data.user_info.aid};mid=${res.data.user_info.mid};`;
+    const res2 = await getCookieAccountInfoByGameToken().request({
+      account_id: data.uid,
+      game_token: data.token
+    });
+    const cookie = `ltuid=${res.data.user_info.aid};ltoken=${res.data.token.token};cookie_token=${res2.data.cookie_token};account_id=${res.data.user_info.aid}`;
+    const message = await bingStoken(e.userId, stoken, { cookie, Serv: "mihoyo" /* cn */ });
+    e.reply(message, { at: true });
+    QRCodes.delete(e.userId);
+    return true;
+  }
+);
+var bingCookie = async (userId, cookie, Serv = "mihoyo" /* cn */) => {
+  const cookieObj = common_exports.StrToObj(cookie.replace(/[#'" ]/g, ""), ";");
+  if (!cookieObj.cookie_token && !cookieObj.cookie_token_v2) {
+    return "\u53D1\u9001Cookie\u4E0D\u5B8C\u6574\uFF0C\u5EFA\u8BAE\u4F7F\u7528#\u626B\u7801\u767B\u5F55";
+  }
+  const ltuid = cookieObj.ltuid || cookieObj.login_uid || cookieObj.ltuid_v2 || cookieObj.account_id_v2 || cookieObj.ltmid_v2;
+  if (!ltuid) {
+    return "\u53D1\u9001Cookie\u4E0D\u5B8C\u6574\uFF0C\u5EFA\u8BAE\u4F7F\u7528#\u626B\u7801\u767B\u5F55";
+  }
+  let cookieParams = {};
+  let flagV2 = false;
+  if (cookieObj.cookie_token_v2 && (cookieObj.account_mid_v2 || cookieObj.ltmid_v2)) {
+    flagV2 = true;
+    cookieParams = {
+      ltuid,
+      account_mid_v2: cookieObj.account_mid_v2,
+      cookie_token_v2: cookieObj.cookie_token_v2,
+      ltoken_v2: cookieObj.ltoken_v2,
+      ltmid_v2: cookieObj.ltmid_v2
+    };
+  } else {
+    cookieParams = {
+      ltuid,
+      account_id: ltuid,
+      ltoken: cookieObj.ltoken,
+      cookie_token: cookieObj.cookie_token || cookieObj.cookie_token_v2
+    };
+  }
+  if (cookieObj.mi18nLang) {
+    cookieParams.mi18nLang = cookieObj.mi18nLang;
+  }
+  const cookieStr = common_exports.ObjToStr(cookieParams, ";");
+  let uidList = {
+    Serv,
+    uids: { data: {}, names: {} },
+    message: "\u5237\u65B0UID\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\uFF01"
+  };
+  for (const serv of Serv ? [Serv] : ["mihoyo" /* cn */, "hoyolab" /* os */]) {
+    uidList = await UserInfo.refreshUid({
+      type: serv,
+      ltuid,
+      cookie: cookieStr
+    });
+    if (!uidList.message) break;
+  }
+  if (uidList.message) {
+    return uidList.message;
+  }
+  if (flagV2 && isNaN(Number(cookieParams.ltuid))) {
+    const userFullInfo = await getUserFullInfo({
+      type: uidList.Serv,
+      ltuid,
+      cookie: cookieStr
+    }).request({});
+    if (userFullInfo?.data?.user_info) {
+      if (userFullInfo.data.user_info.uid) {
+        cookieParams.ltuid = cookieParams.account_id = userFullInfo.data.user_info.uid;
+      }
+    } else {
+      logger.mark(`\u7ED1\u5B9ACookie\u9519\u8BEF2\uFF1A${userFullInfo?.message || "Cookie\u9519\u8BEF"}`);
+      return `\u7ED1\u5B9ACookie\u5931\u8D25\uFF1A${userFullInfo?.message || "Cookie\u9519\u8BEF"}`;
+    }
+  }
+  const userInfo = await UserInfo.create(userId);
+  await userInfo.saveUserInfo({
+    userId,
+    ...uidList.uids.data,
+    ltuids: lodash.uniq([...userInfo.ltuids, cookieParams.ltuid]),
+    stuids: userInfo.stuids,
+    deviceList: userInfo.deviceList
+  });
+  const ltuidInfo = userInfo.getLtuidInfo(cookieParams.ltuid);
+  await userInfo.saveMysAccountInfo({
+    ltuid: cookieParams.ltuid,
+    type: uidList.Serv,
+    cookie: common_exports.ObjToStr(cookieParams, ";"),
+    stoken: ltuidInfo?.stoken || "",
+    deviceId: ltuidInfo?.deviceId || ""
+  });
+  logger.mark(`[${userId}] \u4FDD\u5B58Cookie\u6210\u529F [ltuid:${cookieParams.ltuid}]`);
+  const sendMsg = [];
+  lodash.forEach(uidList.uids.data, (uids, game) => {
+    sendMsg.push(`\u3010${uidList.uids.names[game]}\u3011\uFF1A${uids.join("\u3001")}`);
+  });
+  return `Cookie\u7ED1\u5B9A\u6210\u529F\uFF01
+${sendMsg.join("\n")}`;
+};
+var bingStoken = async (userId, stoken, option) => {
+  const { cookie = "", Serv = "mihoyo" /* cn */ } = option || {};
+  const stokenObj = common_exports.StrToObj(stoken.replace(/[#'" ]/g, ""), ";");
+  if (!stokenObj.stoken || !(stokenObj.stuid || stokenObj.ltuid) || !stokenObj.mid) {
+    return "\u53D1\u9001Stoken\u4E0D\u5B8C\u6574\uFF0C\u5EFA\u8BAE\u4F7F\u7528#\u626B\u7801\u767B\u5F55";
+  }
+  const stokenParams = {
+    stuid: stokenObj.stuid || stokenObj.ltuid,
+    stoken: stokenObj.stoken,
+    mid: stokenObj.mid
+  };
+  let updata = { Serv, cookie, message: "" };
+  if (!updata.cookie) {
+    for (const serv of Serv ? [Serv] : ["mihoyo" /* cn */, "hoyolab" /* os */]) {
+      updata = await UserInfo.refreshCookie(stokenParams, serv);
+      if (updata.cookie) break;
+    }
+    if (updata.message) {
+      return updata.message;
+    }
+  }
+  const Stoken = common_exports.ObjToStr(stokenParams, ";");
+  const userInfo = await UserInfo.create(userId);
+  await userInfo.saveUserInfo({
+    userId,
+    ltuids: userInfo.ltuids,
+    stuids: lodash.uniq([...userInfo.stuids, stokenParams.stuid]),
+    deviceList: userInfo.deviceList
+  });
+  const ltuidInfo = userInfo.getLtuidInfo(stokenParams.stuid);
+  await userInfo.saveMysAccountInfo({
+    ltuid: stokenParams.stuid,
+    type: updata.Serv,
+    cookie: ltuidInfo?.cookie || "",
+    stoken: Stoken,
+    deviceId: ltuidInfo?.deviceId || ""
+  });
+  logger.mark(`[${userId}] \u4FDD\u5B58Stoken\u6210\u529F [stuid: ${stokenParams.stuid}]`);
+  const sendMsg = [];
+  sendMsg.push(`\u7C73\u6E38\u793EID\uFF1A${stokenParams.stuid}
+Stoken\u7ED1\u5B9A\u6210\u529F\uFF01`);
+  sendMsg.push(await bingCookie(userId, updata.cookie, updata.Serv));
+  return sendMsg.join("\n");
+};
+export {
+  MiHoYoLoginQRCode
+};

package/lib/base-B1BvQ4ol.d.ts

@@ -0,0 +1,99 @@
+import { ModelStatic, Model, ModelAttributeColumnOptions, DataTypes } from 'sequelize';
+
+interface MysAccountInfoType {
+    ltuid: string;
+    type: MysAccountType;
+    cookie: string;
+    stoken: string;
+    /** 绑定的设备ID */
+    deviceId: string;
+}
+declare const enum MysAccountType {
+    cn = "mihoyo",
+    os = "hoyolab"
+}
+
+interface BaseUserInfoType {
+    userId: string;
+    ltuids: string[];
+    stuids: string[];
+    deviceList: string[];
+}
+
+declare const enum Dialect {
+    Sqlite = "sqlite",
+    MySQL = "mysql",
+    MariaDB = "mariadb",
+    PostgreSQL = "postgres",
+    MSSQL = "mssql",
+    Oracle = "oracle",
+    DB2 = "db2",
+    Snowflake = "snowflake"
+}
+declare enum DatabaseType {
+    File = "file",
+    Dir = "dir",
+    Db = "db"
+}
+type ModelAttributes<M extends Model = Model, TAttributes = any> = {
+    [name in keyof TAttributes]: ModelAttributeColumnOptions<M>;
+};
+type DatabaseReturn<T> = T & {
+    _save: (data: T) => Promise<void>;
+};
+type DatabaseClassInstance<T extends Record<string, any>> = {
+    /** 数据库标识 */
+    dialect: Dialect;
+    model: ModelStatic<Model>;
+    databasePath: string;
+    databaseType: DatabaseType;
+    /** 表名 */
+    modelName: string;
+    /** 表定义 */
+    modelSchema: ModelAttributes<Model>;
+    /** 检查数据库是否可用 */
+    check(): Promise<boolean>;
+    /**
+     * 初始化表
+     * @param DataDir 插件数据目录
+     * @param modelName 表名
+     * @param modelSchema 表定义
+     * @param type 数据库类型
+     */
+    init(DataDir: string, modelName: string, modelSchema: ModelAttributes<Model>, type: DatabaseType): Promise<DatabaseClassInstance<T>>;
+    /** 将表定义转换为 JSON 对象 */
+    schemaToJSON(pk: string): T;
+    /** 获取用户数据文件路径 */
+    userPath(pk: string): string;
+    /** 根据主键读取用户数据文件 */
+    readSync(path: string, pk: string): DatabaseReturn<T>;
+    /** 根据主键读取用户数据目录 */
+    readDirSync(pk: string): DatabaseReturn<T>;
+    /** 写入用户数据文件 */
+    writeFileSync(pk: string, data: Record<string, any>): boolean;
+    /** 写入用户数据目录 */
+    writeDirSync(pk: string, data: Record<string, any>): boolean;
+    /** 保存用户数据到文件 */
+    saveFile(pk: string): (data: T) => Promise<void>;
+    /** 保存用户数据到目录 */
+    saveDir(pk: string): (data: T) => Promise<void>;
+    /** 保存用户数据到 SQL 数据库 */
+    saveSql(model: Model<any, any>, pk: string): (data: T) => Promise<void>;
+    /** 根据主键查找或创建用户数据 */
+    findByPk(pk: string, create: true): Promise<DatabaseReturn<T>>;
+    /** 根据主键查找用户数据 */
+    findByPk(pk: string, create: boolean): Promise<DatabaseReturn<T> | undefined>;
+    /** 根据主键数组查找用户数据 */
+    findAllByPks(pks: string[]): Promise<DatabaseReturn<T>[]>;
+    /** 删除用户数据 */
+    destroy(pk: string): Promise<boolean>;
+};
+interface DatabaseClassStatic {
+    Column(type: keyof typeof DataTypes, def: any, option?: Partial<ModelAttributeColumnOptions<Model>>): ModelAttributeColumnOptions<Model>;
+    ArrayColumn(key: string, fn?: (data: string[]) => string[]): ModelAttributeColumnOptions<Model>;
+    JsonColumn(key: string, def: {
+        [key in string]: any;
+    }): ModelAttributeColumnOptions<Model>;
+}
+
+export { type BaseUserInfoType as B, Dialect as D, type ModelAttributes as M, DatabaseType as a, type DatabaseReturn as b, type DatabaseClassInstance as c, type DatabaseClassStatic as d, type MysAccountInfoType as e, MysAccountType as f };