Merge pull request #394 from LLOneBot/dev

3.31.7

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,81 @@
+name: Bug 反馈
+description: 报告可能的 LLOneBot 异常行为
+title: '[BUG] '
+labels: bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        欢迎来到 LLOneBot 的 Issue Tracker！请填写以下表格来提交 Bug。
+        在提交新的 Bug 反馈前，请确保您：
+        * 已经搜索了现有的 issues，并且没有找到可以解决您问题的方法
+        * 不与现有的某一 issue 重复
+  - type: input
+    id: system-version
+    attributes:
+      label: 系统版本
+      description: 运行 QQNT 的系统版本
+      placeholder: Windows 10 Pro Workstation 22H2
+    validations:
+      required: true
+  - type: input
+    id: qqnt-version
+    attributes:
+      label: QQNT 版本
+      description: 可在 QQNT 的「关于」或是在 LiteLoaderQQNT 的设置页中找到
+      placeholder: 9.9.7-21804
+    validations:
+      required: true
+  - type: input
+    id: llonebot-version
+    attributes:
+      label: LLOneBot 版本
+      description: 可在 LiteLoaderQQNT 的设置页或是 QQNT 的设置页侧栏中找到
+      placeholder: 3.18.0
+    validations:
+      required: true
+  - type: input
+    id: onebot-client-version
+    attributes:
+      label: OneBot 客户端
+      description: 连接至 LLOneBot 的客户端版本信息
+      placeholder: Overflow 2.16.0-2cf7991-SNAPSHOT
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: 发生了什么?
+      description: 填写你认为的 LLOneBot 的不正常行为
+    validations:
+      required: true
+  - type: textarea
+    id: how-reproduce
+    attributes:
+      label: 如何复现
+      description: 填写应当如何操作才能触发这个不正常行为
+      placeholder: |
+        1. xxx
+        2. xxx
+        3. xxx
+    validations:
+      required: true
+  - type: textarea
+    id: what-expected
+    attributes:
+      label: 期望的结果?
+      description: 填写你认为 LLOneBot 应当执行的正常行为
+    validations:
+      required: true
+  - type: textarea
+    id: llonebot-log
+    attributes:
+      label: LLOneBot 运行日志
+      description: 在 LLOneBot 的设置页中打开「写入日志」然后粘贴相关日志内容到此处
+      render: shell
+  - type: textarea
+    id: onebot-client-log
+    attributes:
+      label: OneBot 客户端运行日志
+      description: 粘贴 OneBot 客户端的相关日志内容到此处
+      render: shell

.github/workflows/publish.yml

@@ -1,36 +1,43 @@
-name: "publish"
+name: Publish
 on:
   push:
     tags:
-      - "v*"
+      - 'v*'
 
 jobs:
   build-and-publish:
     runs-on: ubuntu-latest
     steps:
-    - name: checkout
+      - name: Checkout
-      uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-    - name: setup node
+      - name: Setup node
-      uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
         with:
-        node-version: 18
+          node-version: 20
 
-    - name: install dependenies
+      - name: Install dependenies
-      run: npm install
+        run: |
+          export ELECTRON_SKIP_BINARY_DOWNLOAD=1
+          npm install
 
-    - name: build
+      - name: Build
         run: npm run build
 
-    - name: zip
+      - name: Compress
         run: |
           sudo apt install zip -y
-        cp manifest.json ./dist/manifest.json
+          cd ./dist/
-        zip LLOneBot.zip ./dist/* -j
+          zip -r ../LLOneBot.zip ./*
 
-    - name: publish
+      - name: Extract version from tag
+        id: get-version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> "$GITHUB_OUTPUT"
+
+      - name: Release
         uses: ncipollo/release-action@v1
         with:
-        artifacts: "LLOneBot.zip"
+          artifacts: 'LLOneBot.zip'
           draft: true
           token: ${{ secrets.RELEASE_TOKEN }}
+          name: LLOneBot v${{ steps.get-version.outputs.VERSION }}

.gitignore

@@ -1,3 +1,15 @@
-node_modules/
+.yarn/*
-dist/
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+package-lock.json
+yarn.lock
+node_modules
+dist
+out
+
 .idea/
+.DS_Store

.prettierrc.yml

@@ -0,0 +1,4 @@
+semi: false
+singleQuote: true
+trailingComma: all
+printWidth: 120

.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

LICENSE

@@ -0,0 +1,25 @@
+MIT Without Public Social Media Promotion License
+
+Copyright (c) 2024 LLOneBot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+You may use this software in accordance with the above terms, but you are not 
+allowed to promote this project or your projects based on this project on any 
+public social media.

README.md

@@ -1,130 +1,36 @@
-# LLOneBot API
+# LLOneBot
 
+LiteLoaderQQNT 插件，实现 OneBot 11 协议，用于 QQ 机器人开发
 
-将NTQQLiteLoaderAPI封装成OneBot11/12标准的API, V12没有完整测试
+> [!CAUTION]\
+> 请不要在 QQ 官方群聊和任何影响力较大的简中互联网平台（包括但不限于: 哔哩哔哩，微博，知乎，抖音等）发布和讨论任何与本插件存在相关性的信息
 
-*注意：本文档对应的是 LiteLoader 1.0.0及以上版本，如果你使用的是旧版本请切换到本项目v1分支查看文档*
+TG 群：<https://t.me/+nLZEnpne-pQ1OWFl>
 
 ## 安装方法
 
-1.安装[LiteLoaderQQNT](https://liteloaderqqnt.github.io/guide/install.html)
+见 <https://llonebot.github.io/zh-CN/guide/getting-started>
 
-2.安装修改后的[LiteLoaderQQNT-Plugin-LLAPI](https://github.com/linyuchen/LiteLoaderQQNT-Plugin-LLAPI/releases)，原版的功能有缺陷
+## 设置界面
 
-3.安装本项目插件[OneBotApi](https://github.com/linyuchen/LiteLoaderQQNT-OneBotApi/releases/), 注意本插件2.0以下的版本不支持LiteLoader 1.0.0及以上版本
+<img src="./doc/image/setting.png" width="400px" alt="设置界面"/>
-
-*关于插件的安装方法: 上述的两个插件都没有上架NTQQLiteLoader插件市场，需要自己下载复制到插件目录*
-
-*插件目录:`LiteLoaderQQNT/plugins`*
 
 ## 支持的 API
 
-目前只支持http协议POST方法，不支持websocket，事件上报也是http协议
+见 <https://llonebot.github.io/zh-CN/develop/api>
 
-主要功能:
+## Stargazers over time
-- [x] 发送好友消息
-- [x] 发送群消息
-- [x] 获取好友列表
-- [x] 获取群列表
-- [x] 获取群成员列表
-- [x] 撤回消息
-- [x] 上报好友消息
-- [x] 上报群消息
 
-消息格式支持:
+[![Stargazers over time](https://starchart.cc/LLOneBot/LLOneBot.svg?variant=adaptive)](https://starchart.cc/LLOneBot/LLOneBot)
-- [x] 文字
-- [x] 图片
-- [x] 引用消息
-- [x] @群成员
-- [x] 语音
-- [x] json消息(只上报)
-- [ ] 红包
-- [ ] 转发消息记录
-- [ ] xml
 
-支持的api:
+## 鸣谢
-- [x] get_login_info
-- [x] send_msg
-- [x] send_group_msg
-- [x] send_private_msg
-- [x] delete_msg
-- [x] get_group_list
-- [x] get_group_member_list
-- [x] get_group_member_info
-- [x] get_friend_list
 
-**自己发送成功的消息也会上报，可以用于获取需要撤回消息的id**
+- [NapCatQQ](https://github.com/NapNeko/NapCatQQ)
+- [LiteLoaderQQNT](https://liteloaderqqnt.github.io/guide/install.html)
+- [Chronocat](https://github.com/chrononeko/chronocat)
+- [koishi-plugin-adapter-onebot](https://github.com/koishijs/koishi-plugin-adapter-onebot)
+- [silk-wasm](https://github.com/idranme/silk-wasm)
 
-## 示例
+## 友链
 
-![](doc/image/example.jpg)
+- [Lagrange.Core](https://github.com/LagrangeDev/Lagrange.Core): An Implementation of NTQQ Protocol
-
-*暂时不支持`"message": "hello"`这种message为字符串的形式*
-
-## 一些坑
-
-<details>
-    <summary>下载了插件但是没有看到在NTQQ中生效</summary>
-<br/>
-    检查是否下载的是插件release的版本，如果是源码的话需要自行编译。依然不生效请查阅<a href="https://liteloaderqqnt.github.io/guide/plugins.html">LiteLoaderQQNT的文档</a>
-</details>
-<br/>
-
-<details>
-    <summary>调用接口报404</summary>
-<br/>
-    目前没有支持全部的onebot规范接口，请检查是否调用了不支持的接口，并且所有接口都只支持POST方法，调用GET方法会报404
-</details>
-<br/>
-
-<details>
-    <summary>发送不了图片和语音</summary>
-<br/>
-    检查当前操作用户是否有LiteLoaderQQNT/data/LLOneBot的写入权限，如Windows把QQ上安装到C盘有可能会出现无权限导致发送失败
-</details>
-<br/>
-
-<details>
-    <summary>不支持cq码</summary>
-<br/>
-    cq码已经过时了，没有支持的打算(主要是我不用这玩意儿，加上我懒)
-</details>
-<br/>
-
-<details>
-    <summary>onebot 12对接不了</summary>
-<br/>
-    onebot 12只写了部分兼容，没有完整测试，不保证能用，慎用
-</details>
-<br/>
-
-<details>
-    <summary>QQ变得很卡</summary>
-<br/>
-    这是你的群特别多导致的，因为启动后会批量获取群成员列表，获取完之后就正常了
-</details>
-<br/>
-
-<details>
-    <summary>撤回消息无效</summary>
-<br/>
-    如果接口调用的传的`message`是number类型会导致精度丢失，使用string类型可解决，详情见<a href="https://github.com/linyuchen/LiteLoaderQQNT-OneBotApi/issues/17">issue#17</a>
-</details>
-<br/>
-
-<details>
-    <summary>如何查看日志</summary>
-<br/>
-    LiteLoaderQQNT/data/LLOneBot/*.log
-</details>
-<br/>
-
-## TODO
-
-- [x] 接口返回更详细的错误信息，目前消息发不出去也会返回发送成功(这河里吗)
-- [ ] 转发消息记录 
-- [ ] 支持websocket，等个有缘人提PR实现
-- [ ] 重构摆脱LLAPI，目前调用LLAPI只能在renderer进程调用，需重构成在main进程调用
-
-## onebot11文档
-<https://11.onebot.dev/>

electron.vite.config.ts

@@ -0,0 +1,81 @@
+import cp from 'vite-plugin-cp'
+import path from 'node:path'
+import './scripts/gen-manifest'
+import type { ElectronViteConfig } from 'electron-vite'
+
+const external = [
+  'silk-wasm',
+  'ws',
+  '@minatojs/sql.js',
+]
+
+function genCpModule(module: string) {
+  return { src: `./node_modules/${module}`, dest: `dist/node_modules/${module}`, flatten: false }
+}
+
+const config: ElectronViteConfig = {
+  main: {
+    build: {
+      outDir: 'dist/main',
+      emptyOutDir: true,
+      lib: {
+        formats: ['cjs'],
+        entry: { main: 'src/main/main.ts' },
+      },
+      rollupOptions: {
+        external,
+        input: 'src/main/main.ts',
+      },
+      minify: true,
+    },
+    resolve: {
+      alias: {
+        '@': path.resolve(__dirname, './src'),
+        './lib-cov/fluent-ffmpeg': './lib/fluent-ffmpeg',
+      },
+    },
+    plugins: [
+      cp({
+        targets: [
+          ...external.map(genCpModule),
+          { src: './manifest.json', dest: 'dist' },
+          { src: './icon.webp', dest: 'dist' },
+        ],
+      }),
+    ],
+  },
+  preload: {
+    // vite config options
+    build: {
+      outDir: 'dist/preload',
+      emptyOutDir: true,
+      lib: {
+        formats: ['cjs'],
+        entry: { preload: 'src/preload.ts' },
+      },
+      rollupOptions: {
+        // external: externalAll,
+        input: 'src/preload.ts',
+      },
+    },
+    resolve: {},
+  },
+  renderer: {
+    // vite config options
+    build: {
+      outDir: 'dist/renderer',
+      emptyOutDir: true,
+      lib: {
+        formats: ['es'],
+        entry: { renderer: 'src/renderer/index.ts' },
+      },
+      rollupOptions: {
+        // external: externalAll,
+        input: 'src/renderer/index.ts',
+      },
+    },
+    resolve: {},
+  },
+}
+
+export default config

manifest.json

@@ -3,15 +3,17 @@
   "type": "extension",
   "name": "LLOneBot",
   "slug": "LLOneBot",
-    "description": "LiteLoaderQQNT的OneBotApi",
+  "description": "实现 OneBot 11 协议，用于 QQ 机器人开发",
-    "version": "2.3.0",
+  "version": "3.31.7",
-    "thumbnail": "./icon.png",
+  "icon": "./icon.webp",
-    "authors": [{
+  "authors": [
+    {
       "name": "linyuchen",
       "link": "https://github.com/linyuchen"
-    }],
+    }
+  ],
   "repository": {
-    "repo": "linyuchen/LiteLoaderQQNT-OneBotApi",
+    "repo": "LLOneBot/LLOneBot",
     "branch": "main",
     "release": {
       "tag": "latest",
@@ -24,8 +26,8 @@
     "darwin"
   ],
   "injects": {
-        "renderer": "./renderer.js",
+    "renderer": "./renderer/index.js",
-        "main": "./main.js",
+    "main": "./main/main.cjs",
-        "preload": "./preload.js"
+    "preload": "./preload/preload.cjs"
   }
 }

package.json

@@ -1,34 +1,45 @@
 {
   "name": "llonebot",
   "version": "1.0.0",
-  "description": "NTQQLiteLoaderOneBotApi",
+  "type": "module",
+  "description": "",
   "main": "dist/main.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "electron-vite build",
-    "build": "npm run build-main && npm run build-preload && npm run build-renderer",
+    "build-mac": "npm run build && npm run deploy-mac",
-    "build-main": "webpack --config webpack.main.config.js",
+    "deploy-mac": "cp -r dist/* ~/Library/Containers/com.tencent.qq/Data/LiteLoaderQQNT/plugins/LLOneBot/",
-    "build-preload": "webpack --config webpack.preload.config.js",
+    "build-win": "npm run build && npm run deploy-win",
-    "build-renderer": "webpack --config webpack.renderer.config.js",
+    "deploy-win": "cmd /c \"xcopy /C /S /Y dist\\* %USERPROFILE%\\documents\\LiteLoaderQQNT\\plugins\\LLOneBot\\\"",
-    "build-mac": "npm run build && cp manifest.json dist/ && npm run deploy-mac",
+    "format": "prettier -cw .",
-    "deploy-mac": "cp dist/* ~/Library/Containers/com.tencent.qq/Data/Documents/LiteLoaderQQNT/plugins/LLOnebot/",
+    "check": "tsc"
-    "build-win": "npm run build && cp manifest.json dist/ && npm run deploy-win",
-    "deploy-win": "cmd /c \"copy dist\\* %USERPROFILE%\\documents\\LiteLoaderQQNT\\plugins\\LLOnebot\\\""
   },
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
-    "express": "^4.18.2",
+    "@minatojs/driver-sqlite": "^4.5.0",
-    "json-bigint": "^1.0.0",
+    "compressing": "^1.10.1",
-    "uuid": "^9.0.1"
+    "cordis": "^3.18.0",
+    "cors": "^2.8.5",
+    "cosmokit": "^1.6.2",
+    "express": "^4.19.2",
+    "fast-xml-parser": "^4.5.0",
+    "file-type": "^19.4.1",
+    "fluent-ffmpeg": "^2.1.3",
+    "minato": "^3.5.1",
+    "silk-wasm": "^3.6.1",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.23.2",
+    "@types/cors": "^2.8.17",
-    "@types/express": "^4.17.20",
+    "@types/express": "^4.17.21",
-    "babel-loader": "^9.1.3",
+    "@types/fluent-ffmpeg": "^2.1.26",
-    "electron": "^27.0.2",
+    "@types/node": "^20.14.15",
-    "ts-loader": "^9.5.0",
+    "@types/ws": "^8.5.12",
-    "typescript": "^5.2.2",
+    "electron": "^31.4.0",
-    "webpack": "^5.89.0",
+    "electron-vite": "^2.3.0",
-    "webpack-cli": "^5.1.4"
+    "typescript": "^5.5.4",
-  }
+    "vite": "^5.4.3",
+    "vite-plugin-cp": "^4.0.8"
+  },
+  "packageManager": "yarn@4.4.1"
 }

scripts/gen-manifest.ts

@@ -0,0 +1,38 @@
+import { version } from '../src/version'
+import { writeFileSync } from 'node:fs'
+
+const manifest = {
+  manifest_version: 4,
+  type: 'extension',
+  name: 'LLOneBot',
+  slug: 'LLOneBot',
+  description: '实现 OneBot 11 协议，用于 QQ 机器人开发',
+  version,
+  icon: './icon.webp',
+  authors: [
+    {
+      name: 'linyuchen',
+      link: 'https://github.com/linyuchen'
+    }
+  ],
+  repository: {
+    repo: 'LLOneBot/LLOneBot',
+    branch: 'main',
+    release: {
+      tag: 'latest',
+      name: 'LLOneBot.zip'
+    }
+  },
+  platform: [
+    'win32',
+    'linux',
+    'darwin'
+  ],
+  injects: {
+    renderer: './renderer/index.js',
+    main: './main/main.cjs',
+    preload: './preload/preload.cjs'
+  }
+}
+
+writeFileSync('manifest.json', JSON.stringify(manifest, null, 2))

src/common/IPCChannel.ts

@@ -1,14 +0,0 @@
-export const CHANNEL_SEND_MSG = "llonebot_send_msg"
-export const CHANNEL_RECALL_MSG = "llonebot_recall_msg"
-export const CHANNEL_GET_CONFIG = "llonebot_get_config"
-export const CHANNEL_SET_CONFIG = "llonebot_set_config"
-export const CHANNEL_START_HTTP_SERVER = "llonebot_start_http_server"
-export const CHANNEL_UPDATE_GROUPS = "llonebot_update_groups"
-export const CHANNEL_UPDATE_FRIENDS = "llonebot_update_friends"
-export const CHANNEL_LOG = "llonebot_log"
-export const CHANNEL_POST_ONEBOT_DATA = "llonebot_post_onebot_data"
-export const CHANNEL_SET_SELF_INFO= "llonebot_set_self_info"
-export const CHANNEL_DOWNLOAD_FILE= "llonebot_download_file"
-export const CHANNEL_DELETE_FILE= "llonebot_delete_file"
-export const CHANNEL_GET_RUNNING_STATUS= "llonebot_get_running_status"
-export const CHANNEL_FILE2BASE64= "llonebot_file2base64"

src/common/channels.ts

@@ -0,0 +1,8 @@
+export const CHANNEL_GET_CONFIG = 'llonebot_get_config'
+export const CHANNEL_SET_CONFIG = 'llonebot_set_config'
+export const CHANNEL_SET_CONFIG_CONFIRMED = 'llonebot_set_config_confirmed'
+export const CHANNEL_LOG = 'llonebot_log'
+export const CHANNEL_ERROR = 'llonebot_error'
+export const CHANNEL_UPDATE = 'llonebot_update'
+export const CHANNEL_CHECK_VERSION = 'llonebot_check_version'
+export const CHANNEL_SELECT_FILE = 'llonebot_select_ffmpeg'

src/common/config.ts

@@ -0,0 +1,98 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { Config, OB11Config } from './types'
+import { selfInfo, DATA_DIR } from './globalVars'
+import { mergeNewProperties } from './utils/misc'
+
+export class ConfigUtil {
+  private readonly configPath: string
+  private config: Config | null = null
+
+  constructor(configPath: string) {
+    this.configPath = configPath
+  }
+
+  getConfig(cache = true) {
+    if (this.config && cache) {
+      return this.config
+    }
+
+    return this.reloadConfig()
+  }
+
+  reloadConfig(): Config {
+    const ob11Default: OB11Config = {
+      httpPort: 3000,
+      httpHosts: [],
+      httpSecret: '',
+      wsPort: 3001,
+      wsHosts: [],
+      enableHttp: true,
+      enableHttpPost: true,
+      enableWs: true,
+      enableWsReverse: false,
+      messagePostFormat: 'array',
+      enableHttpHeart: false,
+      enableQOAutoQuote: false,
+      listenLocalhost: false
+    }
+    const defaultConfig: Config = {
+      enableLLOB: true,
+      ob11: ob11Default,
+      heartInterval: 60000,
+      token: '',
+      enableLocalFile2Url: false,
+      debug: false,
+      log: false,
+      reportSelfMessage: false,
+      autoDeleteFile: false,
+      autoDeleteFileSecond: 60,
+      musicSignUrl: '',
+      msgCacheExpire: 120
+    }
+
+    if (!fs.existsSync(this.configPath)) {
+      this.config = defaultConfig
+      return this.config
+    } else {
+      const data = fs.readFileSync(this.configPath, 'utf-8')
+      let jsonData: Config = defaultConfig
+      try {
+        jsonData = JSON.parse(data)
+      } catch (e) {
+        this.config = defaultConfig
+        return this.config
+      }
+      mergeNewProperties(defaultConfig, jsonData)
+      this.checkOldConfig(jsonData.ob11, jsonData, 'httpPort', 'http')
+      this.checkOldConfig(jsonData.ob11, jsonData, 'httpHosts', 'hosts')
+      this.checkOldConfig(jsonData.ob11, jsonData, 'wsPort', 'wsPort')
+      this.config = jsonData
+      return this.config
+    }
+  }
+
+  setConfig(config: Config) {
+    this.config = config
+    fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2), 'utf-8')
+  }
+
+  private checkOldConfig(
+    currentConfig: OB11Config,
+    oldConfig: Config,
+    currentKey: 'httpPort' | 'httpHosts' | 'wsPort',
+    oldKey: 'http' | 'hosts' | 'wsPort',
+  ) {
+    // 迁移旧的配置到新配置，避免用户重新填写配置
+    const oldValue = oldConfig[oldKey]
+    if (oldValue) {
+      currentConfig[currentKey] = oldValue as any
+      delete oldConfig[oldKey]
+    }
+  }
+}
+
+export function getConfigUtil() {
+  const configFilePath = path.join(DATA_DIR, `config_${selfInfo.uin}.json`)
+  return new ConfigUtil(configFilePath)
+}

src/common/globalVars.ts

@@ -0,0 +1,22 @@
+import { LLOneBotError } from './types'
+import { SelfInfo } from '../ntqqapi/types'
+import path from 'node:path'
+
+export const llonebotError: LLOneBotError = {
+  ffmpegError: '',
+  httpServerError: '',
+  wsServerError: '',
+  otherError: 'LLOneBot 未能正常启动，请检查日志查看错误',
+}
+
+export const DATA_DIR: string = global.LiteLoader.plugins['LLOneBot'].path.data
+export const TEMP_DIR: string = path.join(DATA_DIR, 'temp')
+export const PLUGIN_DIR: string = global.LiteLoader.plugins['LLOneBot'].path.plugin
+export const LOG_DIR = path.join(DATA_DIR, 'logs')
+
+export const selfInfo: SelfInfo = {
+  uid: '',
+  uin: '',
+  nick: '',
+  online: true,
+}

src/common/types.ts

@@ -1,196 +1,73 @@
-export enum AtType {
+export interface OB11Config {
-    notAt = 0,
+  httpPort: number
-    atAll = 1,
+  httpHosts: string[]
-    atUser = 2
+  httpSecret?: string
+  wsPort: number
+  wsHosts: string[]
+  enableHttp?: boolean
+  enableHttpPost?: boolean
+  enableWs?: boolean
+  enableWsReverse?: boolean
+  messagePostFormat?: 'array' | 'string'
+  enableHttpHeart?: boolean
+  enableQOAutoQuote: boolean  // 快速操作回复自动引用原消息
+  listenLocalhost: boolean
 }
 
-export enum ChatType {
+export interface CheckVersion {
-    friend = 1,
+  result: boolean
-    group = 2,
+  version: string
-    temp = 100
-}
-
-export interface GroupMemberInfo {
-    avatarPath: string;
-    cardName: string;
-    cardType: number;
-    isDelete: boolean;
-    nick: string;
-    qid: string;
-    remark: string;
-    role: number;  // 群主:4, 管理员:3，群员:2
-    shutUpTime: number;  // 禁言时间，单位是什么暂时不清楚
-    uid: string; // 加密的字符串
-    uin: string; // QQ号
-}
-
-export const OnebotGroupMemberRole = {
-    4: 'owner',
-    3: 'admin',
-    2: 'member'
-}
-
-
-export interface SelfInfo {
-    user_id: string;
-    nickname: string;
-}
-
-export interface User {
-    avatarUrl?: string;
-    bio?: string;  // 签名
-    nickName: string;
-    uid?: string;  // 加密的字符串
-    uin: string; // QQ号
-}
-
-export interface Group {
-    uid: string; // 群号
-    name: string;
-    members?: GroupMemberInfo[];
-}
-
-export interface Peer {
-    chatType: ChatType
-    name: string
-    uid: string  // qq号
-}
-
-export interface PttElement {
-    canConvert2Text: boolean
-    duration: number  // 秒数
-    fileBizId: null
-    fileId: number // 0
-    fileName: string // "e4d09c784d5a2abcb2f9980bdc7acfe6.amr"
-    filePath: string // "/Users//Library/Containers/com.tencent.qq/Data/Library/Application Support/QQ/nt_qq_a6b15c9820595d25a56c1633ce19ad40/nt_data/Ptt/2023-11/Ori/e4d09c784d5a2abcb2f9980bdc7acfe6.amr"
-    fileSize: string // "4261"
-    fileSubId: string // "0"
-    fileUuid: string // "90j3z7rmRphDPrdVgP9udFBaYar#oK0TWZIV"
-    formatType: string // 1
-    invalidState: number // 0
-    md5HexStr: string // "e4d09c784d5a2abcb2f9980bdc7acfe6"
-    playState: number // 0
-    progress: number // 0
-    text: string // ""
-    transferStatus: number // 0
-    translateStatus: number // 0
-    voiceChangeType: number // 0
-    voiceType: number // 0
-    waveAmplitudes: number[]
-}
-
-export interface ArkElement{
-    bytesData: string
-}
-
-export interface MessageElement {
-    raw: {
-        msgId: string,
-        msgTime: string,
-        msgSeq: string,
-        senderUin: string; // 发送者QQ号
-        chatType: ChatType,
-        elements: {
-            replyElement: {
-                senderUid: string,  // 原消息发送者QQ号
-                sourceMsgIsIncPic: boolean;  // 原消息是否有图片
-                sourceMsgText: string;
-                replayMsgSeq: string;  // 源消息的msgSeq，可以通过这个找到源消息的msgId
-            },
-            textElement: {
-                atType: AtType
-                atUid: string,
-                content: string,
-                atNtUid: string
-            },
-            picElement: {
-                sourcePath: string // 图片本地路径
-                picWidth: number
-                picHeight: number
-                fileSize: number
-                fileName: string
-                fileUuid: string
-            },
-            pttElement: PttElement,
-            arkElement: ArkElement
-        }[]
-    }
-    peer: Peer,
-    sender: {
-        uid: string  // 一串加密的字符串
-        memberName: string
-        nickname: string
-    }
-}
-
-export enum MessageType {
-    text = "text",
-    image = "image",
-    voice = "record",
-    at = "at",
-    reply = "reply",
-    json = "json"
-}
-
-export type SendMessage = {
-    type: MessageType.text,
-    content: string,
-    data?: {
-        text: string, // 纯文本
-    }
-} | {
-    type: "image" | "voice" | "record",
-    file: string, // 本地路径
-    data?: {
-        file: string // 本地路径
-    }
-} | {
-    type: MessageType.at,
-    atType?: AtType,
-    content?: string,
-    atUid?: string,
-    atNtUid?: string,
-    data?: {
-        qq: string // at的qq号
-    }
-} | {
-    type: MessageType.reply,
-    msgId: string,
-    msgSeq: string,
-    senderUin: string,
-    data: {
-        id: string,
-    }
-}
-
-export type PostDataAction = "send_private_msg" | "send_group_msg" | "get_group_list"
-    | "get_friend_list" | "delete_msg" | "get_login_info" | "get_group_member_list" | "get_group_member_info"
-
-export interface PostDataSendMsg {
-    action: PostDataAction
-    message_type?: "private" | "group"
-    params?: {
-        user_id: string,
-        group_id: string,
-        message: SendMessage[];
-    },
-    user_id: string,
-    group_id: string,
-    message: SendMessage[];
-    ipc_uuid?: string
 }
 
 export interface Config {
-    port: number
+  enableLLOB: boolean
-    hosts: string[]
+  ob11: OB11Config
-    enableBase64?: boolean
+  token?: string
+  heartInterval: number // ms
+  enableLocalFile2Url?: boolean // 开启后，本地文件路径图片会转成http链接, 语音会转成base64
   debug?: boolean
+  reportSelfMessage?: boolean
   log?: boolean
+  autoDeleteFile?: boolean
+  autoDeleteFileSecond?: number
+  ffmpeg?: string // ffmpeg路径
+  musicSignUrl?: string
+  ignoreBeforeLoginMsg?: boolean
+  /** 单位为秒 */
+  msgCacheExpire?: number
+  /** @deprecated */
+  http?: string
+  /** @deprecated */
+  hosts?: string[]
+  /** @deprecated */
+  wsPort?: string
 }
 
-export interface SendMsgResult {
+export interface LLOneBotError {
-    status: number
+  httpServerError?: string
-    retcode: number
+  wsServerError?: string
-    data: any
+  ffmpegError?: string
-    message: string
+  otherError?: string
+}
+
+export interface FileCache {
+  fileName: string
+  fileSize: string
+  msgId: string
+  peerUid: string
+  chatType: number
+  elementId: string
+  elementType: number
+}
+
+export interface FileCacheV2 {
+  fileName: string
+  fileSize: string
+  fileUuid: string
+  msgId: string
+  msgTime: number
+  peerUid: string
+  chatType: number
+  elementId: string
+  elementType: number
 }

src/common/utils/audio.ts

@@ -0,0 +1,119 @@
+import path from 'node:path'
+import ffmpeg from 'fluent-ffmpeg'
+import fsPromise from 'node:fs/promises'
+import { decode, encode, getDuration, getWavFileInfo, isWav, isSilk, EncodeResult } from 'silk-wasm'
+import { TEMP_DIR } from '../globalVars'
+import { getConfigUtil } from '../config'
+import { randomUUID } from 'node:crypto'
+import { Readable } from 'node:stream'
+import { Context } from 'cordis'
+
+interface FFmpegOptions {
+  input?: string[]
+  output?: string[]
+}
+
+type Input = string | Readable
+
+function convert(ctx: Context, input: Input, options: FFmpegOptions): Promise<Buffer>
+function convert(ctx: Context, input: Input, options: FFmpegOptions, outputPath: string): Promise<string>
+function convert(ctx: Context, input: Input, options: FFmpegOptions, outputPath?: string): Promise<Buffer> | Promise<string> {
+  return new Promise<any>((resolve, reject) => {
+    const chunks: Buffer[] = []
+    let command = ffmpeg(input)
+      .on('error', err => {
+        ctx.logger.error(`FFmpeg处理转换出错: `, err.message)
+        reject(err)
+      })
+      .on('end', () => {
+        if (!outputPath) {
+          resolve(Buffer.concat(chunks))
+        } else {
+          resolve(outputPath)
+        }
+      })
+    if (options.input) {
+      command = command.inputOptions(options.input)
+    }
+    if (options.output) {
+      command = command.outputOptions(options.output)
+    }
+    const ffmpegPath = getConfigUtil().getConfig().ffmpeg
+    if (ffmpegPath) {
+      command = command.setFfmpegPath(ffmpegPath)
+    }
+    if (!outputPath) {
+      const stream = command.pipe()
+      stream.on('data', chunk => {
+        chunks.push(chunk)
+      })
+    } else {
+      command.save(outputPath)
+    }
+  })
+}
+
+export async function encodeSilk(ctx: Context, filePath: string) {
+  try {
+    const file = await fsPromise.readFile(filePath)
+    if (!isSilk(file)) {
+      ctx.logger.info(`语音文件${filePath}需要转换成silk`)
+      let result: EncodeResult
+      const allowSampleRate = [8000, 12000, 16000, 24000, 32000, 44100, 48000]
+      if (isWav(file) && allowSampleRate.includes(getWavFileInfo(file).fmt.sampleRate)) {
+        result = await encode(file, 0)
+      } else {
+        const input = await convert(ctx, filePath, {
+          output: [
+            '-ar 24000',
+            '-ac 1',
+            '-f s16le'
+          ]
+        })
+        result = await encode(input, 24000)
+      }
+      const pttPath = path.join(TEMP_DIR, randomUUID())
+      await fsPromise.writeFile(pttPath, result.data)
+      ctx.logger.info(`语音文件${filePath}转换成功!`, pttPath, `时长:`, result.duration)
+      return {
+        converted: true,
+        path: pttPath,
+        duration: result.duration / 1000,
+      }
+    } else {
+      const silk = file
+      let duration = 1
+      try {
+        duration = getDuration(silk) / 1000
+      } catch (e: any) {
+        ctx.logger.warn('获取语音文件时长失败, 默认为1秒', filePath, e.stack)
+      }
+      return {
+        converted: false,
+        path: filePath,
+        duration,
+      }
+    }
+  } catch (error: any) {
+    ctx.logger.error('convert silk failed', error.stack)
+    return {}
+  }
+}
+
+type OutFormat = 'mp3' | 'amr' | 'wma' | 'm4a' | 'spx' | 'ogg' | 'wav' | 'flac'
+
+export async function decodeSilk(ctx: Context, inputFilePath: string, outFormat: OutFormat = 'mp3') {
+  const silk = await fsPromise.readFile(inputFilePath)
+  const { data } = await decode(silk, 24000)
+  const tmpPath = path.join(TEMP_DIR, path.basename(inputFilePath))
+  const outFilePath = tmpPath + `.${outFormat}`
+  const pcmFilePath = tmpPath + '.pcm'
+  await fsPromise.writeFile(pcmFilePath, data)
+  return convert(ctx, pcmFilePath, {
+    input: [
+      '-f s16le',
+      '-ar 24000',
+      '-ac 1'
+    ]
+  }, outFilePath)
+}

src/common/utils/eventTask.ts

@@ -0,0 +1,234 @@
+import { NodeIQQNTWrapperSession } from '@/ntqqapi/wrapper'
+import { randomUUID } from 'node:crypto'
+
+interface Internal_MapKey {
+  timeout: number
+  createtime: number
+  func: (...arg: any[]) => any
+  checker: ((...args: any[]) => boolean) | undefined
+}
+
+export class ListenerClassBase {
+  [key: string]: string
+}
+
+export interface ListenerIBase {
+  new(listener: any): ListenerClassBase
+}
+
+// forked from https://github.com/NapNeko/NapCatQQ/blob/6f6b258f22d7563f15d84e7172c4d4cbb547f47e/src/common/utils/EventTask.ts#L20
+export class NTEventWrapper {
+  private ListenerMap: { [key: string]: ListenerIBase } | undefined//ListenerName-Unique -> Listener构造函数
+  private WrapperSession: NodeIQQNTWrapperSession | undefined//WrapperSession
+  private ListenerManger: Map<string, ListenerClassBase> = new Map<string, ListenerClassBase>() //ListenerName-Unique -> Listener实例
+  private EventTask = new Map<string, Map<string, Map<string, Internal_MapKey>>>()//tasks ListenerMainName -> ListenerSubName-> uuid -> {timeout,createtime,func}
+  public initialised = false
+
+  constructor() {
+  }
+
+  createProxyDispatch(ListenerMainName: string) {
+    const current = this
+    return new Proxy({}, {
+      get(target: any, prop: any, receiver: any) {
+        // console.log('get', prop, typeof target[prop])
+        if (typeof target[prop] === 'undefined') {
+          // 如果方法不存在，返回一个函数，这个函数调用existentMethod
+          return (...args: any[]) => {
+            current.dispatcherListener.apply(current, [ListenerMainName, prop, ...args]).then()
+          }
+        }
+        // 如果方法存在，正常返回
+        return Reflect.get(target, prop, receiver)
+      }
+    })
+  }
+
+  init({ ListenerMap, WrapperSession }: { ListenerMap: { [key: string]: typeof ListenerClassBase }, WrapperSession: NodeIQQNTWrapperSession }) {
+    this.ListenerMap = ListenerMap
+    this.WrapperSession = WrapperSession
+    this.initialised = true
+  }
+
+  createEventFunction<T extends (...args: any) => any>(eventName: string): T | undefined {
+    const eventNameArr = eventName.split('/')
+    type eventType = {
+      [key: string]: () => { [key: string]: (...params: Parameters<T>) => Promise<ReturnType<T>> }
+    }
+    if (eventNameArr.length > 1) {
+      const serviceName = 'get' + eventNameArr[0].replace('NodeIKernel', '')
+      const eventName = eventNameArr[1]
+      //getNodeIKernelGroupListener,GroupService
+      //console.log('2', eventName)
+      const services = (this.WrapperSession as unknown as eventType)[serviceName]()
+      let event = services[eventName]
+      //重新绑定this
+      event = event.bind(services)
+      if (event) {
+        return event as T
+      }
+      return undefined
+    }
+  }
+
+  createListenerFunction<T>(listenerMainName: string, uniqueCode: string = ''): T {
+    const ListenerType = this.ListenerMap![listenerMainName]
+    let Listener = this.ListenerManger.get(listenerMainName + uniqueCode)
+    if (!Listener && ListenerType) {
+      Listener = new ListenerType(this.createProxyDispatch(listenerMainName))
+      const ServiceSubName = listenerMainName.match(/^NodeIKernel(.*?)Listener$/)![1]
+      const Service = 'NodeIKernel' + ServiceSubName + 'Service/addKernel' + ServiceSubName + 'Listener'
+      const addfunc = this.createEventFunction<(listener: T) => number>(Service)
+      addfunc!(Listener as T)
+      //console.log(addfunc!(Listener as T))
+      this.ListenerManger.set(listenerMainName + uniqueCode, Listener)
+    }
+    return Listener as T
+  }
+
+  //统一回调清理事件
+  async dispatcherListener(ListenerMainName: string, ListenerSubName: string, ...args: any[]) {
+    //console.log("[EventDispatcher]",ListenerMainName, ListenerSubName, ...args)
+    this.EventTask.get(ListenerMainName)?.get(ListenerSubName)?.forEach((task, uuid) => {
+      //console.log(task.func, uuid, task.createtime, task.timeout)
+      if (task.createtime + task.timeout < Date.now()) {
+        this.EventTask.get(ListenerMainName)?.get(ListenerSubName)?.delete(uuid)
+        return
+      }
+      if (task.checker && task.checker(...args)) {
+        task.func(...args)
+      }
+    })
+  }
+
+  async CallNoListenerEvent<EventType extends (...args: any[]) => Promise<any> | any>(EventName = '', timeout: number = 3000, ...args: Parameters<EventType>) {
+    return new Promise<Awaited<ReturnType<EventType>>>(async (resolve, reject) => {
+      const EventFunc = this.createEventFunction<EventType>(EventName)
+      let complete = false
+      const Timeouter = setTimeout(() => {
+        if (!complete) {
+          reject(new Error('NTEvent EventName:' + EventName + ' timeout'))
+        }
+      }, timeout)
+      const retData = await EventFunc!(...args)
+      complete = true
+      resolve(retData)
+    })
+  }
+
+  async RegisterListen<ListenerType extends (...args: any[]) => void>(ListenerName = '', waitTimes = 1, timeout = 5000, checker: (...args: Parameters<ListenerType>) => boolean) {
+    return new Promise<Parameters<ListenerType>>((resolve, reject) => {
+      const ListenerNameList = ListenerName.split('/')
+      const ListenerMainName = ListenerNameList[0]
+      const ListenerSubName = ListenerNameList[1]
+      const id = randomUUID()
+      let complete = 0
+      let retData: Parameters<ListenerType> | undefined = undefined
+      const databack = () => {
+        if (complete == 0) {
+          reject(new Error(' ListenerName:' + ListenerName + ' timeout'))
+        } else {
+          resolve(retData!)
+        }
+      }
+      const Timeouter = setTimeout(databack, timeout)
+      const eventCallbak = {
+        timeout: timeout,
+        createtime: Date.now(),
+        checker: checker,
+        func: (...args: Parameters<ListenerType>) => {
+          complete++
+          retData = args
+          if (complete >= waitTimes) {
+            clearTimeout(Timeouter)
+            databack()
+          }
+        }
+      }
+      if (!this.EventTask.get(ListenerMainName)) {
+        this.EventTask.set(ListenerMainName, new Map())
+      }
+      if (!(this.EventTask.get(ListenerMainName)?.get(ListenerSubName))) {
+        this.EventTask.get(ListenerMainName)?.set(ListenerSubName, new Map())
+      }
+      this.EventTask.get(ListenerMainName)?.get(ListenerSubName)?.set(id, eventCallbak)
+      this.createListenerFunction(ListenerMainName)
+    })
+  }
+
+  async CallNormalEvent<EventType extends (...args: any[]) => Promise<any>, ListenerType extends (...args: any[]) => void>
+    (EventName = '', ListenerName = '', waitTimes = 1, timeout: number = 3000, checker: (...args: Parameters<ListenerType>) => boolean, ...args: Parameters<EventType>) {
+    return new Promise<[EventRet: Awaited<ReturnType<EventType>>, ...Parameters<ListenerType>]>(async (resolve, reject) => {
+      const id = randomUUID()
+      let complete = 0
+      let retData: Parameters<ListenerType> | undefined = undefined
+      let retEvent: any = {}
+      const databack = () => {
+        if (complete == 0) {
+          reject(new Error('Timeout: NTEvent EventName:' + EventName + ' ListenerName:' + ListenerName + ' EventRet:\n' + JSON.stringify(retEvent, null, 4) + '\n'))
+        } else {
+          resolve([retEvent as Awaited<ReturnType<EventType>>, ...retData!])
+        }
+      }
+
+      const ListenerNameList = ListenerName.split('/')
+      const ListenerMainName = ListenerNameList[0]
+      const ListenerSubName = ListenerNameList[1]
+
+      const Timeouter = setTimeout(databack, timeout)
+
+      const eventCallbak = {
+        timeout: timeout,
+        createtime: Date.now(),
+        checker: checker,
+        func: (...args: any[]) => {
+          complete++
+          //console.log('func', ...args)
+          retData = args as Parameters<ListenerType>
+          if (complete >= waitTimes) {
+            clearTimeout(Timeouter)
+            databack()
+          }
+        }
+      }
+      if (!this.EventTask.get(ListenerMainName)) {
+        this.EventTask.set(ListenerMainName, new Map())
+      }
+      if (!(this.EventTask.get(ListenerMainName)?.get(ListenerSubName))) {
+        this.EventTask.get(ListenerMainName)?.set(ListenerSubName, new Map())
+      }
+      this.EventTask.get(ListenerMainName)?.get(ListenerSubName)?.set(id, eventCallbak)
+      this.createListenerFunction(ListenerMainName)
+      const EventFunc = this.createEventFunction<EventType>(EventName)
+      retEvent = await EventFunc!(...(args as any[]))
+    })
+  }
+}
+
+export const NTEventDispatch = new NTEventWrapper()
+
+// 示例代码 快速创建事件
+// let NTEvent = new NTEventWrapper()
+// let TestEvent = NTEvent.CreatEventFunction<(force: boolean) => Promise<Number>>('NodeIKernelProfileLikeService/GetTest')
+// if (TestEvent) {
+//     TestEvent(true)
+// }
+
+// 示例代码 快速创建监听Listener类
+// let NTEvent = new NTEventWrapper()
+// NTEvent.CreatListenerFunction<NodeIKernelMsgListener>('NodeIKernelMsgListener', 'core')
+
+
+// 调用接口
+//let NTEvent = new NTEventWrapper()
+//let ret = await NTEvent.CallNormalEvent<(force: boolean) => Promise<Number>, (data1: string, data2: number) => void>('NodeIKernelProfileLikeService/GetTest', 'NodeIKernelMsgListener/onAddSendMsg', 1, 3000, true)
+
+// 注册监听 解除监听
+// NTEventDispatch.RigisterListener('NodeIKernelMsgListener/onAddSendMsg','core',cb)
+// NTEventDispatch.UnRigisterListener('NodeIKernelMsgListener/onAddSendMsg','core')
+
+// let GetTest = NTEventDispatch.CreatEvent('NodeIKernelProfileLikeService/GetTest','NodeIKernelMsgListener/onAddSendMsg',Mode)
+// GetTest('test')
+
+// always模式
+// NTEventDispatch.CreatEvent('NodeIKernelProfileLikeService/GetTest','NodeIKernelMsgListener/onAddSendMsg',Mode,(...args:any[])=>{ console.log(args) })

src/common/utils/file.ts

@@ -0,0 +1,195 @@
+import fs from 'node:fs'
+import fsPromise from 'node:fs/promises'
+import path from 'node:path'
+import { TEMP_DIR } from '../globalVars'
+import { randomUUID, createHash } from 'node:crypto'
+import { fileURLToPath } from 'node:url'
+
+export function isGIF(path: string) {
+  const buffer = Buffer.alloc(4)
+  const fd = fs.openSync(path, 'r')
+  fs.readSync(fd, buffer, 0, 4, 0)
+  fs.closeSync(fd)
+  return buffer.toString() === 'GIF8'
+}
+
+// 定义一个异步函数来检查文件是否存在
+export function checkFileReceived(path: string, timeout: number = 3000): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const startTime = Date.now()
+
+    function check() {
+      if (fs.existsSync(path)) {
+        resolve()
+      } else if (Date.now() - startTime > timeout) {
+        reject(new Error(`文件不存在: ${path}`))
+      } else {
+        setTimeout(check, 200)
+      }
+    }
+
+    check()
+  })
+}
+
+export function calculateFileMD5(filePath: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    // 创建一个流式读取器
+    const stream = fs.createReadStream(filePath)
+    const hash = createHash('md5')
+
+    stream.on('data', (data: Buffer) => {
+      // 当读取到数据时，更新哈希对象的状态
+      hash.update(data)
+    })
+
+    stream.on('end', () => {
+      // 文件读取完成，计算哈希
+      const md5 = hash.digest('hex')
+      resolve(md5)
+    })
+
+    stream.on('error', (err: Error) => {
+      // 处理可能的读取错误
+      reject(err)
+    })
+  })
+}
+
+export enum FileUriType {
+  Unknown = 0,
+  FileURL = 1,
+  RemoteURL = 2,
+  OneBotBase64 = 3,
+  DataURL = 4,
+  Path = 5
+}
+
+export function checkUriType(uri: string): { type: FileUriType } {
+  if (uri.startsWith('base64://')) {
+    return { type: FileUriType.OneBotBase64 }
+  }
+  if (uri.startsWith('data:')) {
+    return { type: FileUriType.DataURL }
+  }
+  if (uri.startsWith('http://') || uri.startsWith('https://')) {
+    return { type: FileUriType.RemoteURL }
+  }
+  if (uri.startsWith('file://')) {
+    return { type: FileUriType.FileURL }
+  }
+  try {
+    if (fs.existsSync(uri)) return { type: FileUriType.Path }
+  } catch { }
+  return { type: FileUriType.Unknown }
+}
+
+interface FetchFileRes {
+  data: Buffer
+  url: string
+}
+
+export async function fetchFile(url: string, headersInit?: Record<string, string>): Promise<FetchFileRes> {
+  const headers: Record<string, string> = {
+    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36',
+    'Host': new URL(url).hostname,
+    ...headersInit
+  }
+  const raw = await fetch(url, { headers }).catch((err) => {
+    if (err.cause) {
+      throw err.cause
+    }
+    throw err
+  })
+  if (!raw.ok) throw new Error(`statusText: ${raw.statusText}`)
+  return {
+    data: Buffer.from(await raw.arrayBuffer()),
+    url: raw.url
+  }
+}
+
+type Uri2LocalRes = {
+  success: boolean
+  errMsg: string
+  fileName: string
+  path: string
+  isLocal: boolean
+}
+
+export async function uri2local(uri: string, filename?: string): Promise<Uri2LocalRes> {
+  const { type } = checkUriType(uri)
+
+  if (type === FileUriType.FileURL) {
+    const filePath = fileURLToPath(uri)
+    const fileName = path.basename(filePath)
+    return { success: true, errMsg: '', fileName, path: filePath, isLocal: true }
+  }
+
+  if (type === FileUriType.Path) {
+    const fileName = path.basename(uri)
+    return { success: true, errMsg: '', fileName, path: uri, isLocal: true }
+  }
+
+  if (type === FileUriType.RemoteURL) {
+    try {
+      const res = await fetchFile(uri)
+      const match = res.url.match(/.+\/([^/?]*)(?=\?)?/)
+      if (match?.[1]) {
+        filename ??= match[1].replace(/[/\\:*?"<>|]/g, '_')
+      } else {
+        filename ??= randomUUID()
+      }
+      const filePath = path.join(TEMP_DIR, filename)
+      await fsPromise.writeFile(filePath, res.data)
+      return { success: true, errMsg: '', fileName: filename, path: filePath, isLocal: false }
+    } catch (e: any) {
+      const errMsg = `${uri} 下载失败, ${e.message}`
+      return { success: false, errMsg, fileName: '', path: '', isLocal: false }
+    }
+  }
+
+  if (type === FileUriType.OneBotBase64) {
+    filename ??= randomUUID()
+    const filePath = path.join(TEMP_DIR, filename)
+    const base64 = uri.replace(/^base64:\/\//, '')
+    await fsPromise.writeFile(filePath, base64, 'base64')
+    return { success: true, errMsg: '', fileName: filename, path: filePath, isLocal: false }
+  }
+
+  if (type === FileUriType.DataURL) {
+    // https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
+    const capture = /^data:([\w/.+-]+);base64,(.*)$/.exec(uri)
+    if (capture) {
+      filename ??= randomUUID()
+      const [, _type, base64] = capture
+      const filePath = path.join(TEMP_DIR, filename)
+      await fsPromise.writeFile(filePath, base64, 'base64')
+      return { success: true, errMsg: '', fileName: filename, path: filePath, isLocal: false }
+    }
+  }
+
+  return { success: false, errMsg: '未知文件类型', fileName: '', path: '', isLocal: false }
+}
+
+export async function copyFolder(sourcePath: string, destPath: string) {
+  try {
+    const entries = await fsPromise.readdir(sourcePath, { withFileTypes: true })
+    await fsPromise.mkdir(destPath, { recursive: true })
+    for (let entry of entries) {
+      const srcPath = path.join(sourcePath, entry.name)
+      const dstPath = path.join(destPath, entry.name)
+      if (entry.isDirectory()) {
+        await copyFolder(srcPath, dstPath)
+      } else {
+        try {
+          await fsPromise.copyFile(srcPath, dstPath)
+        } catch (error) {
+          console.error(`无法复制文件 '${srcPath}' 到 '${dstPath}': ${error}`)
+          // 这里可以决定是否要继续复制其他文件
+        }
+      }
+    }
+  } catch (error) {
+    console.error('复制文件夹时出错:', error)
+  }
+}

src/common/utils/index.ts

@@ -0,0 +1,7 @@
+export * from './file'
+export * from './misc'
+export * from './legacyLog'
+export * from './misc'
+export * from './upgrade'
+export { getVideoInfo, checkFfmpeg } from './video'
+export { encodeSilk } from './audio'

src/common/utils/legacyLog.ts

@@ -0,0 +1,41 @@
+import fs from 'fs'
+import path from 'node:path'
+import { getConfigUtil } from '../config'
+import { LOG_DIR } from '../globalVars'
+
+function truncateString(obj: any, maxLength = 500) {
+  if (obj !== null && typeof obj === 'object') {
+    Object.keys(obj).forEach((key) => {
+      if (typeof obj[key] === 'string') {
+        // 如果是字符串且超过指定长度，则截断
+        if (obj[key].length > maxLength) {
+          obj[key] = obj[key].substring(0, maxLength) + '...'
+        }
+      } else if (typeof obj[key] === 'object') {
+        // 如果是对象或数组，则递归调用
+        truncateString(obj[key], maxLength)
+      }
+    })
+  }
+  return obj
+}
+
+export const logFileName = `llonebot-${new Date().toLocaleString('zh-CN')}.log`.replace(/\//g, '-').replace(/:/g, '-')
+
+export function log(...msg: any[]) {
+  if (!getConfigUtil().getConfig().log) {
+    return
+  }
+  let logMsg = ''
+  for (const msgItem of msg) {
+    // 判断是否是对象
+    if (typeof msgItem === 'object') {
+      logMsg += JSON.stringify(truncateString(msgItem)) + ' '
+      continue
+    }
+    logMsg += msgItem + ' '
+  }
+  const currentDateTime = new Date().toLocaleString()
+  logMsg = `${currentDateTime} ${logMsg}\n\n`
+  fs.appendFile(path.join(LOG_DIR, logFileName), logMsg, () => { })
+}

src/common/utils/messageUnique.ts

@@ -0,0 +1,163 @@
+import fsPromise from 'node:fs/promises'
+import fs from 'node:fs'
+import path from 'node:path'
+import Database, { Tables } from 'minato'
+import SQLite from '@minatojs/driver-sqlite'
+import { Peer } from '@/ntqqapi/types'
+import { createHash } from 'node:crypto'
+import { LimitedHashTable } from './table'
+import { DATA_DIR } from '../globalVars'
+import { FileCacheV2 } from '../types'
+
+interface SQLiteTables extends Tables {
+    message: {
+        shortId: number
+        msgId: string
+        chatType: number
+        peerUid: string
+    }
+    file_v2: FileCacheV2
+}
+
+interface MsgIdAndPeerByShortId {
+    MsgId: string
+    Peer: Peer
+}
+
+// forked from https://github.com/NapNeko/NapCatQQ/blob/6f6b258f22d7563f15d84e7172c4d4cbb547f47e/src/common/utils/MessageUnique.ts#L84
+class MessageUniqueWrapper {
+    private msgDataMap: LimitedHashTable<string, number>
+    private msgIdMap: LimitedHashTable<string, number>
+    private db: Database<SQLiteTables> | undefined
+
+    constructor(maxMap: number = 1000) {
+        this.msgIdMap = new LimitedHashTable<string, number>(maxMap)
+        this.msgDataMap = new LimitedHashTable<string, number>(maxMap)
+    }
+
+    async init(uin: string) {
+        const dbDir = path.join(DATA_DIR, 'database')
+        if (!fs.existsSync(dbDir)) {
+            await fsPromise.mkdir(dbDir)
+        }
+        const database = new Database<SQLiteTables>()
+        await database.connect(SQLite, {
+            path: path.join(dbDir, `${uin}.db`)
+        })
+        database.extend('message', {
+            shortId: 'integer(10)',
+            chatType: 'unsigned',
+            msgId: 'string(24)',
+            peerUid: 'string(24)'
+        }, {
+            primary: 'shortId'
+        })
+        database.extend('file_v2', {
+            fileName: 'string',
+            fileSize: 'string',
+            fileUuid: 'string(128)',
+            msgId: 'string(24)',
+            msgTime: 'unsigned(10)',
+            peerUid: 'string(24)',
+            chatType: 'unsigned',
+            elementId: 'string(24)',
+            elementType: 'unsigned',
+        }, {
+            primary: 'fileUuid',
+            indexes: ['fileName']
+        })
+        this.db = database
+    }
+
+    async getRecentMsgIds(Peer: Peer, size: number): Promise<string[]> {
+        const heads = this.msgIdMap.getHeads(size)
+        if (!heads) {
+            return []
+        }
+        const data: (MsgIdAndPeerByShortId | undefined)[] = []
+        for (const t of heads) {
+            data.push(await MessageUnique.getMsgIdAndPeerByShortId(t.value))
+        }
+        const ret = data.filter((t) => t?.Peer.chatType === Peer.chatType && t?.Peer.peerUid === Peer.peerUid)
+        return ret.map((t) => t?.MsgId).filter((t) => t !== undefined)
+    }
+
+    createMsg(peer: Peer, msgId: string): number {
+        const key = `${msgId}|${peer.chatType}|${peer.peerUid}`
+        const hash = createHash('md5').update(key).digest()
+        //设置第一个bit为0 保证shortId为正数
+        hash[0] &= 0x7f
+        const shortId = hash.readInt32BE(0)
+        //减少性能损耗
+        // const isExist = this.msgIdMap.getKey(shortId)
+        // if (isExist && isExist === msgId) {
+        //   return shortId
+        // }
+        this.msgIdMap.set(msgId, shortId)
+        this.msgDataMap.set(key, shortId)
+        this.db?.upsert('message', [{
+            msgId,
+            shortId,
+            chatType: peer.chatType,
+            peerUid: peer.peerUid
+        }], 'shortId').then()
+        return shortId
+    }
+
+    async getMsgIdAndPeerByShortId(shortId: number): Promise<MsgIdAndPeerByShortId | undefined> {
+        const data = this.msgDataMap.getKey(shortId)
+        if (data) {
+            const [msgId, chatTypeStr, peerUid] = data.split('|')
+            const peer: Peer = {
+                chatType: parseInt(chatTypeStr),
+                peerUid,
+                guildId: '',
+            }
+            return { MsgId: msgId, Peer: peer }
+        }
+        const items = await this.db?.get('message', { shortId })
+        if (items?.length) {
+            const { msgId, chatType, peerUid } = items[0]
+            return {
+                MsgId: msgId,
+                Peer: {
+                    chatType,
+                    peerUid,
+                    guildId: '',
+                }
+            }
+        }
+        return undefined
+    }
+
+    getShortIdByMsgId(msgId: string): number | undefined {
+        return this.msgIdMap.getValue(msgId)
+    }
+
+    async getPeerByMsgId(msgId: string) {
+        const shortId = this.msgIdMap.getValue(msgId)
+        if (!shortId) return undefined
+        return await this.getMsgIdAndPeerByShortId(shortId)
+    }
+
+    resize(maxSize: number): void {
+        this.msgIdMap.resize(maxSize)
+        this.msgDataMap.resize(maxSize)
+    }
+
+    addFileCache(data: FileCacheV2) {
+        return this.db?.upsert('file_v2', [data], 'fileUuid')
+    }
+
+    getFileCacheByName(fileName: string) {
+        return this.db?.get('file_v2', { fileName }, {
+            sort: { msgTime: 'desc' }
+        })
+    }
+
+    getFileCacheById(fileUuid: string) {
+        return this.db?.get('file_v2', { fileUuid })
+    }
+}
+
+export const MessageUnique: MessageUniqueWrapper = new MessageUniqueWrapper()

src/common/utils/misc.ts

@@ -0,0 +1,34 @@
+import { QQLevel } from '@/ntqqapi/types'
+
+export function isNumeric(str: string) {
+  return /^\d+$/.test(str)
+}
+
+export function calcQQLevel(level: QQLevel) {
+  const { crownNum, sunNum, moonNum, starNum } = level
+  return crownNum * 64 + sunNum * 16 + moonNum * 4 + starNum
+}
+
+/** QQ Build Version  */
+export function getBuildVersion(): number {
+  const version: string = globalThis.LiteLoader.versions.qqnt
+  return +version.split('-')[1]
+}
+
+/** 在保证老对象已有的属性不变化的情况下将新对象的属性复制到老对象 */
+export function mergeNewProperties(newObj: any, oldObj: any) {
+  Object.keys(newObj).forEach((key) => {
+    // 如果老对象不存在当前属性，则直接复制
+    if (!oldObj.hasOwnProperty(key)) {
+      oldObj[key] = newObj[key]
+    } else {
+      // 如果老对象和新对象的当前属性都是对象，则递归合并
+      if (typeof oldObj[key] === 'object' && typeof newObj[key] === 'object') {
+        mergeNewProperties(newObj[key], oldObj[key])
+      } else if (typeof oldObj[key] === 'object' || typeof newObj[key] === 'object') {
+        // 属性冲突，有一方不是对象，直接覆盖
+        oldObj[key] = newObj[key]
+      }
+    }
+  })
+}

src/common/utils/request.ts

@@ -0,0 +1,106 @@
+import https from 'node:https'
+import http from 'node:http'
+
+export class RequestUtil {
+  // 适用于获取服务器下发cookies时获取，仅GET
+  static async HttpsGetCookies(url: string): Promise<{ [key: string]: string }> {
+    const client = url.startsWith('https') ? https : http;
+    return new Promise((resolve, reject) => {
+      client.get(url, (res) => {
+        let cookies: { [key: string]: string } = {};
+        const handleRedirect = (res: http.IncomingMessage) => {
+          //console.log(res.headers.location);
+          if (res.statusCode === 301 || res.statusCode === 302) {
+            if (res.headers.location) {
+              const redirectUrl = new URL(res.headers.location, url);
+              RequestUtil.HttpsGetCookies(redirectUrl.href).then((redirectCookies) => {
+                // 合并重定向过程中的cookies
+                //log('redirectCookies', redirectCookies)
+                cookies = { ...cookies, ...redirectCookies };
+                resolve(cookies);
+              });
+            } else {
+              resolve(cookies);
+            }
+          } else {
+            resolve(cookies);
+          }
+        };
+        res.on('data', () => { }); // Necessary to consume the stream
+        res.on('end', () => {
+          handleRedirect(res);
+        });
+        if (res.headers['set-cookie']) {
+          // console.log(res.headers['set-cookie']);
+          //log('set-cookie', url, res.headers['set-cookie']);
+          res.headers['set-cookie'].forEach((cookie) => {
+            const parts = cookie.split(';')[0].split('=');
+            const key = parts[0];
+            const value = parts[1];
+            if (key && value && key.length > 0 && value.length > 0) {
+              cookies[key] = value;
+            }
+          });
+        }
+      }).on('error', (err) => {
+        reject(err);
+      });
+    });
+  }
+
+  // 请求和回复都是JSON data传原始内容 自动编码json
+  static async HttpGetJson<T>(url: string, method: string = 'GET', data?: any, headers: Record<string, string> = {}, isJsonRet: boolean = true, isArgJson: boolean = true): Promise<T> {
+    let option = new URL(url);
+    const protocol = url.startsWith('https://') ? https : http;
+    const options = {
+      hostname: option.hostname,
+      port: option.port,
+      path: option.href,
+      method: method,
+      headers: headers
+    };
+    return new Promise((resolve, reject) => {
+      const req = protocol.request(options, (res: any) => {
+        let responseBody = '';
+        res.on('data', (chunk: string | Buffer) => {
+          responseBody += chunk.toString();
+        });
+
+        res.on('end', () => {
+          try {
+            if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+              if (isJsonRet) {
+                const responseJson = JSON.parse(responseBody);
+                resolve(responseJson as T);
+              } else {
+                resolve(responseBody as T);
+              }
+            } else {
+              reject(new Error(`Unexpected status code: ${res.statusCode}`));
+            }
+          } catch (parseError) {
+            reject(parseError);
+          }
+        });
+      });
+
+      req.on('error', (error: any) => {
+        reject(error);
+      });
+      if (method === 'POST' || method === 'PUT' || method === 'PATCH') {
+        if (isArgJson) {
+          req.write(JSON.stringify(data));
+        } else {
+          req.write(data);
+        }
+
+      }
+      req.end();
+    });
+  }
+
+  // 请求返回都是原始内容
+  static async HttpGetText(url: string, method: string = 'GET', data?: any, headers: Record<string, string> = {}) {
+    return this.HttpGetJson<string>(url, method, data, headers, false, false);
+  }
+}

src/common/utils/sign.ts

@@ -0,0 +1,37 @@
+import { Context } from 'cordis'
+
+export interface IdMusicSignPostData {
+  type: 'qq' | '163'
+  id: string | number
+}
+
+export interface CustomMusicSignPostData {
+  type: 'custom'
+  url: string
+  audio: string
+  title: string
+  image?: string
+  singer?: string
+}
+
+export type MusicSignPostData = IdMusicSignPostData | CustomMusicSignPostData
+
+export class MusicSign {
+  private readonly url: string
+
+  constructor(protected ctx: Context, url: string) {
+    this.url = url
+  }
+
+  async sign(postData: MusicSignPostData): Promise<string> {
+    const resp = await fetch(this.url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(postData),
+    })
+    if (!resp.ok) throw new Error(resp.statusText)
+    const data = await resp.text()
+    this.ctx.logger.info('音乐消息生成成功', data)
+    return data
+  }
+}

src/common/utils/table.ts

@@ -0,0 +1,72 @@
+// forked from https://github.com/NapNeko/NapCatQQ/blob/6f6b258f22d7563f15d84e7172c4d4cbb547f47e/src/common/utils/MessageUnique.ts#L5
+export class LimitedHashTable<K, V> {
+    private keyToValue: Map<K, V> = new Map()
+    private valueToKey: Map<V, K> = new Map()
+    private maxSize: number
+
+    constructor(maxSize: number) {
+        this.maxSize = maxSize
+    }
+
+    resize(count: number) {
+        this.maxSize = count
+    }
+
+    set(key: K, value: V): void {
+        this.keyToValue.set(key, value)
+        this.valueToKey.set(value, key)
+        while (this.keyToValue.size !== this.valueToKey.size) {
+            console.log('keyToValue.size !== valueToKey.size Error Atom')
+            this.keyToValue.clear()
+            this.valueToKey.clear()
+        }
+        while (this.keyToValue.size > this.maxSize || this.valueToKey.size > this.maxSize) {
+            const oldestKey = this.keyToValue.keys().next().value
+            this.valueToKey.delete(this.keyToValue.get(oldestKey)!)
+            this.keyToValue.delete(oldestKey)
+        }
+    }
+
+    getValue(key: K): V | undefined {
+        return this.keyToValue.get(key)
+    }
+
+    getKey(value: V): K | undefined {
+        return this.valueToKey.get(value)
+    }
+
+    deleteByValue(value: V): void {
+        const key = this.valueToKey.get(value)
+        if (key !== undefined) {
+            this.keyToValue.delete(key)
+            this.valueToKey.delete(value)
+        }
+    }
+
+    deleteByKey(key: K): void {
+        const value = this.keyToValue.get(key)
+        if (value !== undefined) {
+            this.keyToValue.delete(key)
+            this.valueToKey.delete(value)
+        }
+    }
+
+    getKeyList(): K[] {
+        return Array.from(this.keyToValue.keys())
+    }
+
+    //获取最近刚写入的几个值
+    getHeads(size: number): { key: K; value: V }[] | undefined {
+        const keyList = this.getKeyList()
+        if (keyList.length === 0) {
+            return undefined
+        }
+        const result: { key: K; value: V }[] = []
+        const listSize = Math.min(size, keyList.length)
+        for (let i = 0; i < listSize; i++) {
+            const key = keyList[listSize - i]
+            result.push({ key, value: this.keyToValue.get(key)! })
+        }
+        return result
+    }
+}

src/common/utils/upgrade.ts

@@ -0,0 +1,98 @@
+import path from 'node:path'
+import compressing from 'compressing'
+import { writeFile } from 'node:fs/promises'
+import { version } from '../../version'
+import { copyFolder, log, fetchFile } from '.'
+import { PLUGIN_DIR, TEMP_DIR } from '../globalVars'
+
+const downloadMirrorHosts = ['https://mirror.ghproxy.com/']
+const checkVersionMirrorHosts = ['https://kkgithub.com']
+
+export async function checkNewVersion() {
+  const latestVersionText = await getRemoteVersion()
+  const latestVersion = latestVersionText.split('.')
+  //log('llonebot last version', latestVersion)
+  const currentVersion: string[] = version.split('.')
+  //log('llonebot current version', currentVersion)
+  for (let k of [0, 1, 2]) {
+    if (parseInt(latestVersion[k]) > parseInt(currentVersion[k])) {
+      log('')
+      return { result: true, version: latestVersionText }
+    } else if (parseInt(latestVersion[k]) < parseInt(currentVersion[k])) {
+      break
+    }
+  }
+  return { result: false, version: version }
+}
+
+export async function upgradeLLOneBot() {
+  const latestVersion = await getRemoteVersion()
+  if (latestVersion && latestVersion != '') {
+    const downloadUrl = 'https://github.com/LLOneBot/LLOneBot/releases/download/v' + latestVersion + '/LLOneBot.zip'
+    const filePath = path.join(TEMP_DIR, './update-' + latestVersion + '.zip')
+    let downloadSuccess = false
+    // 多镜像下载
+    for (const mirrorGithub of downloadMirrorHosts) {
+      try {
+        const res = await fetchFile(mirrorGithub + downloadUrl)
+        await writeFile(filePath, res.data)
+        downloadSuccess = true
+        break
+      } catch (e) {
+        log('llonebot upgrade error', e)
+      }
+    }
+    if (!downloadSuccess) {
+      log('llonebot upgrade error', 'download failed')
+      return false
+    }
+    const temp_ver_dir = path.join(TEMP_DIR, 'LLOneBot' + latestVersion)
+    let uncompressedPromise = async function () {
+      return new Promise<boolean>((resolve, reject) => {
+        compressing.zip
+          .uncompress(filePath, temp_ver_dir)
+          .then(() => {
+            resolve(true)
+          })
+          .catch((reason: any) => {
+            log('llonebot upgrade failed, ', reason)
+            if (reason?.errno == -4082) {
+              resolve(true)
+            }
+            resolve(false)
+          })
+      })
+    }
+    const uncompressedResult = await uncompressedPromise()
+    // 复制文件
+    await copyFolder(temp_ver_dir, PLUGIN_DIR)
+
+    return uncompressedResult
+  }
+  return false
+}
+
+export async function getRemoteVersion() {
+  let Version = ''
+  for (let i = 0; i < checkVersionMirrorHosts.length; i++) {
+    let mirrorGithub = checkVersionMirrorHosts[i]
+    let tVersion = await getRemoteVersionByMirror(mirrorGithub)
+    if (tVersion && tVersion != '') {
+      Version = tVersion
+      break
+    }
+  }
+  return Version
+}
+
+export async function getRemoteVersionByMirror(mirrorGithub: string) {
+  let releasePage = 'error'
+
+  try {
+    releasePage = (await fetchFile(mirrorGithub + '/LLOneBot/LLOneBot/releases')).data.toString()
+    // log("releasePage", releasePage);
+    if (releasePage === 'error') return ''
+    return releasePage.match(new RegExp('(?<=(tag/v)).*?(?=("))'))?.[0]
+  } catch { }
+  return ''
+}

src/global.d.ts

@@ -1,60 +1,9 @@
-import {
+import type { LLOneBot } from './preload'
-    Config,
+import { Dict } from 'cosmokit'
-    Group,
-    GroupMemberInfo,
-    MessageElement,
-    Peer,
-    PostDataSendMsg, PttElement,
-    SelfInfo,
-    SendMessage, SendMsgResult,
-    User
-} from "./common/types";
-
-
-declare var LLAPI: {
-    on(event: "new-messages" | "new-send-messages", callback: (data: MessageElement[]) => void): void;
-    on(event: "context-msg-menu", callback: (event: any, target: any, msgIds:any) => void): void;
-    getAccountInfo(): Promise<{
-        uid: string  // 一串加密的字符串
-        uin: string  // qq
-    }>
-
-    getUserInfo(uid: string): Promise<User>; // uid是一串加密的字符串
-    sendMessage(peer: Peer, message: SendMessage[]): Promise<any>;
-    recallMessage(peer: Peer, msgIds: string[]): Promise<void>;
-    getGroupsList(forced: boolean): Promise<Group[]>
-    getFriendsList(forced: boolean): Promise<User[]>
-    getGroupMemberList(group_id: string, num: number): Promise<{result: { infos: Map<string, GroupMemberInfo> }}>
-    getPeer(): Promise<Peer>
-    add_qmenu(func: (qContextMenu: Node)=>void): void
-    Ptt2Text(msgId:string, peer: Peer, elements: MessageElement[]): Promise<any>
-
-};
-
-
-declare var llonebot: {
-    postData: (data: any) => void
-    listenSendMessage: (handle: (msg: PostDataSendMsg) => void) => void
-    listenRecallMessage: (handle: (msg: {message_id: string}) => void) => void
-    updateGroups: (groups: Group[]) => void
-    updateFriends: (friends: User[]) => void
-    updateGroupMembers: (data: { groupMembers: User[], group_id: string }) => void
-    startExpress: () => void
-    log(data: any): void,
-    setConfig(config: Config):void;
-    getConfig():Promise<Config>;
-    setSelfInfo(selfInfo: SelfInfo):void;
-    downloadFile(arg: {uri: string, fileName: string}):Promise<{errMsg: string, path: string}>;
-    deleteFile(path: string[]):Promise<void>;
-    getRunningStatus(): Promise<boolean>;
-    sendSendMsgResult(sessionId: string, msgResult: SendMsgResult): void;
-    file2base64(path: string): Promise<{err: string, data: string}>;
-};
 
 declare global {
-    interface Window {
+  var llonebot: LLOneBot
-        LLAPI: typeof LLAPI;
+  var LiteLoader: Dict
-        llonebot: typeof llonebot;
+  var authData: Dict | undefined
-        LiteLoader: any;
+  var navigation: Dict | undefined
-    }
 }

src/main/HttpServer.ts

@@ -1,224 +0,0 @@
-import {log} from "./utils";
-
-const express = require("express");
-const JSONbig = require('json-bigint');
-import {sendIPCRecallQQMsg, sendIPCSendQQMsg} from "./IPCSend";
-import {OnebotGroupMemberRole, PostDataAction, PostDataSendMsg, SendMessage, SendMsgResult} from "../common/types";
-import {friends, groups, selfInfo} from "./data";
-
-// @SiberianHusky 2021-08-15
-function checkSendMessage(sendMsgList: SendMessage[]) {
-    function checkUri(uri: string): boolean {
-        const pattern = /^(file:\/\/|http:\/\/|https:\/\/|base64:\/\/)/;
-        return pattern.test(uri);
-    }
-
-    for (let msg of sendMsgList) {
-        if (msg["type"] && msg["data"]) {
-            let type = msg["type"];
-            let data = msg["data"];
-            if (type === "text" && !data["text"]) {
-                return 400;
-            } else if (["image", "voice", "record"].includes(type)) {
-                if (!data["file"]) {
-                    return 400;
-                } else {
-                    if (checkUri(data["file"])) {
-                        return 200;
-                    } else {
-                        return 400;
-                    }
-                }
-
-            } else if (type === "at" && !data["qq"]) {
-                return 400;
-            } else if (type === "reply" && !data["id"]) {
-                return 400;
-            }
-        } else {
-            return 400
-        }
-    }
-    return 200;
-}
-
-// ==end==
-
-function handlePost(jsonData: any, handleSendResult: (data: SendMsgResult) => void) {
-    log("API receive post:" + JSON.stringify(jsonData))
-    if (!jsonData.params) {
-        jsonData.params = JSON.parse(JSON.stringify(jsonData));
-        delete jsonData.params.params;
-    }
-    let resData = {
-        status: 0,
-        retcode: 0,
-        data: {},
-        message: ''
-    }
-
-    if (jsonData.action == "get_login_info") {
-        resData["data"] = selfInfo
-    } else if (jsonData.action == "send_private_msg" || jsonData.action == "send_group_msg") {
-        if (jsonData.action == "send_private_msg") {
-            jsonData.message_type = "private"
-        } else {
-            jsonData.message_type = "group"
-        }
-        // @SiberianHuskY 2021-10-20 22:00:00
-        resData.status = checkSendMessage(jsonData.message);
-        if (resData.status == 200) {
-            resData.message = "发送成功";
-            resData.data = jsonData.message;
-            sendIPCSendQQMsg(jsonData, handleSendResult);
-            return;
-        } else {
-            resData.message = "发送失败, 请检查消息格式";
-            resData.data = jsonData.message;
-        }
-        // == end ==
-    } else if (jsonData.action == "get_group_list") {
-        resData["data"] = groups.map(group => {
-            return {
-                group_id: group.uid,
-                group_name: group.name,
-                member_count: group.members.length,
-                group_members: group.members.map(member => {
-                    return {
-                        user_id: member.uin,
-                        user_name: member.cardName || member.nick,
-                        user_display_name: member.cardName || member.nick
-                    }
-                })
-            }
-        })
-    } else if (jsonData.action == "get_group_info") {
-        let group = groups.find(group => group.uid == jsonData.params.group_id)
-        if (group) {
-            resData["data"] = {
-                group_id: group.uid,
-                group_name: group.name,
-                member_count: group.members.length,
-            }
-        }
-    } else if (jsonData.action == "get_group_member_info") {
-        let member = groups.find(group => group.uid == jsonData.params.group_id)?.members?.find(member => member.uin == jsonData.params.user_id)
-        resData["data"] = {
-            user_id: member.uin,
-            user_name: member.nick,
-            user_display_name: member.cardName || member.nick,
-            nickname: member.nick,
-            card: member.cardName,
-            role: OnebotGroupMemberRole[member.role],
-        }
-    } else if (jsonData.action == "get_group_member_list") {
-        let group = groups.find(group => group.uid == jsonData.params.group_id)
-        if (group) {
-            resData["data"] = group?.members?.map(member => {
-                return {
-                    user_id: member.uin,
-                    user_name: member.nick,
-                    user_display_name: member.cardName || member.nick,
-                    nickname: member.nick,
-                    card: member.cardName,
-                    role: OnebotGroupMemberRole[member.role],
-                }
-
-            }) || []
-        } else {
-            resData["data"] = []
-        }
-    } else if (jsonData.action == "get_friend_list") {
-        resData["data"] = friends.map(friend => {
-            return {
-                user_id: friend.uin,
-                user_name: friend.nickName,
-            }
-        })
-    } else if (jsonData.action == "delete_msg") {
-        sendIPCRecallQQMsg(String(jsonData.message_id))
-    }
-    return resData
-}
-
-
-export function startExpress(port: number) {
-    const app = express();
-    // 中间件，用于解析POST请求的请求体
-    app.use(express.urlencoded({extended: true, limit: "500mb"}));
-    app.use(express.json({
-        limit: '500mb',
-        verify: (req: any, res: any, buf: any, encoding: any) => {
-            req.rawBody = buf;
-        }
-    }));
-    app.use((req: any, res: any, next: any) => {
-        try {
-            req.body = JSONbig.parse(req.rawBody.toString());
-            next();
-        } catch (error) {
-            // next(error);
-            next();
-        }
-    });
-
-    function parseToOnebot12(action: PostDataAction) {
-        app.post('/' + action, (req: any, res: any) => {
-            let jsonData: PostDataSendMsg = req.body;
-            jsonData.action = action
-            let resData = handlePost(jsonData, (data: SendMsgResult) => {
-                res.send(data)
-            })
-            if (resData) {
-                res.send(resData)
-            }
-        });
-    }
-
-    const actionList: PostDataAction[] = ["get_login_info", "send_private_msg", "send_group_msg",
-        "get_group_list", "get_friend_list", "delete_msg", "get_group_member_list", "get_group_member_info"]
-
-    for (const action of actionList) {
-        parseToOnebot12(action as PostDataAction)
-    }
-
-    app.get('/', (req: any, res: any) => {
-        res.send('llonebot已启动');
-    })
-
-
-    // 处理POST请求的路由
-    app.post('/', (req: any, res: any) => {
-        let jsonData: PostDataSendMsg = req.body;
-        let resData = handlePost(jsonData, (data: SendMsgResult) => {
-            res.send(data)
-        })
-        if (resData) {
-            res.send(resData)
-        }
-    });
-    app.post('/send_msg', (req: any, res: any) => {
-        let jsonData: PostDataSendMsg = req.body;
-        if (jsonData.message_type == "private") {
-            jsonData.action = "send_private_msg"
-        } else if (jsonData.message_type == "group") {
-            jsonData.action = "send_group_msg"
-        } else {
-            if (jsonData.params.group_id) {
-                jsonData.action = "send_group_msg"
-            } else {
-                jsonData.action = "send_private_msg"
-            }
-        }
-        let resData = handlePost(jsonData, (data: SendMsgResult) => {
-            res.send(data)
-        })
-        if (resData) {
-            res.send(resData)
-        }
-    })
-
-    app.listen(port, "0.0.0.0", () => {
-        console.log(`llonebot started 0.0.0.0:${port}`);
-    });
-}

src/main/IPCSend.ts

@@ -1,35 +0,0 @@
-import {ipcMain, webContents} from 'electron';
-import {PostDataSendMsg, SendMsgResult} from "../common/types";
-import {CHANNEL_RECALL_MSG, CHANNEL_SEND_MSG} from "../common/IPCChannel";
-import {v4 as uuid4} from "uuid";
-import {log} from "./utils";
-
-function sendIPCMsg(channel: string, data: any) {
-    let contents = webContents.getAllWebContents();
-    for (const content of contents) {
-        try {
-            content.send(channel, data)
-        } catch (e) {
-            console.log("llonebot send ipc msg to render error:", e)
-        }
-    }
-}
-
-
-export function sendIPCSendQQMsg(postData: PostDataSendMsg, handleSendResult: (data: SendMsgResult) => void) {
-    const onceSessionId = "llonebot_send_msg_" + uuid4();
-    postData.ipc_uuid = onceSessionId;
-    ipcMain.once(onceSessionId, (event: any, sendResult: SendMsgResult) => {
-        // log("llonebot send msg ipcMain.once:" + JSON.stringify(sendResult));
-        try {
-            handleSendResult(sendResult)
-        } catch (e) {
-            log("llonebot send msg ipcMain.once error:" + JSON.stringify(e))
-        }
-    })
-    sendIPCMsg(CHANNEL_SEND_MSG, postData);
-}
-
-export function sendIPCRecallQQMsg(message_id: string) {
-    sendIPCMsg(CHANNEL_RECALL_MSG, {message_id: message_id});
-}

src/main/config.ts

@@ -1,28 +0,0 @@
-import {Config} from "../common/types";
-
-const fs = require("fs")
-
-export class ConfigUtil{
-    configPath: string;
-
-    constructor(configPath: string) {
-        this.configPath = configPath;
-    }
-
-    getConfig(): Config{
-        if (!fs.existsSync(this.configPath)) {
-            return {port:3000, hosts: ["http://192.168.1.2:5000/"]}
-        } else {
-            const data = fs.readFileSync(this.configPath, "utf-8");
-            let jsonData =JSON.parse(data);
-            if (!jsonData.hosts){
-                jsonData.hosts = []
-            }
-            return jsonData;
-        }
-    }
-
-    setConfig(config: Config){
-        fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2), "utf-8")
-    }
-}

src/main/data.ts

@@ -1,9 +0,0 @@
-import {Group, SelfInfo, User} from "../common/types";
-
-export let groups: Group[] = []
-export let friends: User[] = []
-
-export let selfInfo: SelfInfo = {
-    user_id: "",
-    nickname: ""
-}

src/main/log.ts

@@ -0,0 +1,38 @@
+import path from 'node:path'
+import { Context, Logger } from 'cordis'
+import { appendFile } from 'node:fs'
+import { LOG_DIR, selfInfo } from '@/common/globalVars'
+import { noop } from 'cosmokit'
+
+interface Config {
+  enable: boolean
+  filename: string
+}
+
+export default class Log {
+  static name = 'logger'
+
+  constructor(ctx: Context, cfg: Config) {
+    Logger.targets.splice(0, Logger.targets.length)
+    if (!cfg.enable) {
+      return
+    }
+    const file = path.join(LOG_DIR, cfg.filename)
+    /*const refreshNick = ctx.debounce(() => {
+      const ntUserApi = ctx.get('ntUserApi')
+      if (ntUserApi && !selfInfo.nick) {
+        ntUserApi.getSelfNick(true)
+      }
+    }, 1000)*/
+    const target: Logger.Target = {
+      colors: 0,
+      record: (record: Logger.Record) => {
+        const dateTime = new Date(record.timestamp).toLocaleString()
+        const userInfo = selfInfo.uin ? `${selfInfo.nick}(${selfInfo.uin})` : ''
+        const content = `${dateTime} [${record.type}] ${userInfo} | ${record.name} ${record.content}\n\n`
+        appendFile(file, content, noop)
+      },
+    }
+    Logger.targets.push(target)
+  }
+}

src/main/main.ts

@@ -1,223 +1,224 @@
-// 运行在 Electron 主进程 下的插件入口
+import path from 'node:path'
-
+import fs from 'node:fs'
-import * as path from "path";
+import Log from './log'
-import {ipcMain} from 'electron';
+import Core from '../ntqqapi/core'
-import * as util from 'util';
+import OneBot11Adapter from '../onebot11/adapter'
-
+import { BrowserWindow, dialog, ipcMain } from 'electron'
-import {Config, Group, SelfInfo, User} from "../common/types";
+import { Config as LLOBConfig } from '../common/types'
 import {
-    CHANNEL_DOWNLOAD_FILE,
+  CHANNEL_CHECK_VERSION,
+  CHANNEL_ERROR,
   CHANNEL_GET_CONFIG,
-    CHANNEL_SET_SELF_INFO,
   CHANNEL_LOG,
-    CHANNEL_POST_ONEBOT_DATA,
+  CHANNEL_SELECT_FILE,
   CHANNEL_SET_CONFIG,
-    CHANNEL_START_HTTP_SERVER,
+  CHANNEL_UPDATE,
-    CHANNEL_UPDATE_FRIENDS,
+  CHANNEL_SET_CONFIG_CONFIRMED
-    CHANNEL_UPDATE_GROUPS, CHANNEL_DELETE_FILE, CHANNEL_GET_RUNNING_STATUS, CHANNEL_FILE2BASE64
+} from '../common/channels'
-} from "../common/IPCChannel";
+import { getBuildVersion } from '../common/utils'
-import {ConfigUtil} from "./config";
+import { hookNTQQApiCall, hookNTQQApiReceive } from '../ntqqapi/hook'
-import {startExpress} from "./HttpServer";
+import { checkNewVersion, upgradeLLOneBot } from '../common/utils/upgrade'
-import {checkFileReceived, CONFIG_DIR, getConfigUtil, isGIF, log} from "./utils";
+import { getConfigUtil } from '../common/config'
-import {friends, groups, selfInfo} from "./data";
+import { checkFfmpeg } from '../common/utils/video'
-import {} from "../global";
+import { getSession } from '../ntqqapi/wrapper'
+import { Context } from 'cordis'
+import { llonebotError, selfInfo, LOG_DIR, DATA_DIR, TEMP_DIR } from '../common/globalVars'
+import { log, logFileName } from '../common/utils/legacyLog'
+import {
+  NTQQFileApi,
+  NTQQFileCacheApi,
+  NTQQFriendApi,
+  NTQQGroupApi,
+  NTQQMsgApi,
+  NTQQUserApi,
+  NTQQWebApi,
+  NTQQWindowApi
+} from '../ntqqapi/api'
 
-const fs = require('fs');
+declare module 'cordis' {
-
+  interface Events {
-let running = false;
+    'llonebot/config-updated': (input: LLOBConfig) => void
+  }
+}
 
+let mainWindow: BrowserWindow | null = null
 
 // 加载插件时触发
 function onLoad() {
-    log("main onLoaded");
+  if (!fs.existsSync(DATA_DIR)) {
+    fs.mkdirSync(DATA_DIR, { recursive: true })
+  }
 
-    // const config_dir = browserWindow.LiteLoader.plugins["LLOneBot"].path.data;
+  if (!fs.existsSync(LOG_DIR)) {
+    fs.mkdirSync(LOG_DIR)
+  }
 
-
+  ipcMain.handle(CHANNEL_CHECK_VERSION, async (event, arg) => {
-    if (!fs.existsSync(CONFIG_DIR)) {
+    return checkNewVersion()
-        fs.mkdirSync(CONFIG_DIR, {recursive: true});
-    }
-    ipcMain.handle(CHANNEL_GET_CONFIG, (event: any, arg: any) => {
-        return getConfigUtil().getConfig()
-    })
-    ipcMain.handle(CHANNEL_DOWNLOAD_FILE, async (event: any, arg: { uri: string, fileName: string }): Promise<{
-        success: boolean,
-        errMsg: string,
-        path: string
-    }> => {
-        let filePath = path.join(CONFIG_DIR, arg.fileName)
-        let url = new URL(arg.uri);
-        if (url.protocol == "base64:") {
-            // base64转成文件
-            let base64Data = arg.uri.split("base64://")[1]
-            try {
-                const buffer = Buffer.from(base64Data, 'base64');
-                fs.writeFileSync(filePath, buffer);
-            } catch (e: any) {
-                return {
-                    success: false,
-                    errMsg: `base64文件下载失败,` + e.toString(),
-                    path: ""
-                }
-            }
-        } else if (url.protocol == "http:" || url.protocol == "https:") {
-            // 下载文件
-            let res = await fetch(url)
-            if (!res.ok) {
-                return {
-                    success: false,
-                    errMsg: `${url}下载失败,` + res.statusText,
-                    path: ""
-                }
-            }
-            let blob = await res.blob();
-            let buffer = await blob.arrayBuffer();
-            try {
-                fs.writeFileSync(filePath, Buffer.from(buffer));
-            } catch (e: any) {
-                return {
-                    success: false,
-                    errMsg: `${url}下载失败,` + e.toString(),
-                    path: ""
-                }
-            }
-        }
-        else{
-            return {
-                success: false,
-                errMsg: `不支持的file协议,` + url.protocol,
-                path: ""
-            }
-        }
-        if (isGIF(filePath)) {
-            fs.renameSync(filePath, filePath + ".gif");
-            filePath += ".gif";
-        }
-        return {
-            success: true,
-            errMsg: "",
-            path: filePath
-        };
-    })
-    ipcMain.on(CHANNEL_SET_CONFIG, (event: any, arg: Config) => {
-        getConfigUtil().setConfig(arg)
   })
 
-    ipcMain.on(CHANNEL_START_HTTP_SERVER, (event: any, arg: any) => {
+  ipcMain.handle(CHANNEL_UPDATE, async (event, arg) => {
-        startExpress(getConfigUtil().getConfig().port)
+    return upgradeLLOneBot()
   })
 
-    ipcMain.on(CHANNEL_UPDATE_GROUPS, (event: any, arg: Group[]) => {
+  ipcMain.handle(CHANNEL_SELECT_FILE, async (event, arg) => {
-        for (const group of arg) {
+    const selectPath = new Promise<string>((resolve, reject) => {
-            let existGroup = groups.find(g => g.uid == group.uid)
+      dialog
-            if (existGroup) {
+        .showOpenDialog({
-                if (!existGroup.members) {
+          title: '请选择ffmpeg',
-                    existGroup.members = []
+          properties: ['openFile'],
-                }
+          buttonLabel: '确定',
-                existGroup.name = group.name
+        })
-                for (const member of group.members || []) {
+        .then((result) => {
-                    let existMember = existGroup.members?.find(m => m.uin == member.uin)
+          log('选择文件', result)
-                    if (existMember) {
+          if (!result.canceled) {
-                        existMember.nick = member.nick
+            const _selectPath = path.join(result.filePaths[0])
-                        existMember.cardName = member.cardName
+            resolve(_selectPath)
           } else {
-                        existGroup.members?.push(member)
+            resolve('')
           }
-                }
-            } else {
-                groups.push(group)
-            }
-        }
-        groups.length = 0
-        groups.push(...arg)
         })
-
+        .catch((err) => {
-    ipcMain.on(CHANNEL_UPDATE_FRIENDS, (event: any, arg: User[]) => {
+          reject(err)
-        friends.length = 0
+        })
-        friends.push(...arg)
     })
-
-    ipcMain.on(CHANNEL_POST_ONEBOT_DATA, (event: any, arg: any) => {
-        for (const host of getConfigUtil().getConfig().hosts) {
     try {
-                fetch(host, {
+      return await selectPath
-                    method: "POST",
+    } catch (e) {
-                    headers: {
+      log('选择文件出错', e)
-                        "Content-Type": "application/json",
+      return ''
-                        "x-self-id": selfInfo.user_id
-                    },
-                    body: JSON.stringify(arg)
-                }).then((res: any) => {
-                    log(`新消息事件上传成功: ${host} ` + JSON.stringify(arg));
-                }, (err: any) => {
-                    log(`新消息事件上传失败: ${host} ` + err + JSON.stringify(arg));
-                });
-            } catch (e: any) {
-                log(e.toString())
-            }
     }
   })
 
-    ipcMain.on(CHANNEL_LOG, (event: any, arg: any) => {
+  ipcMain.handle(CHANNEL_ERROR, async (event, arg) => {
+    const ffmpegOk = await checkFfmpeg(getConfigUtil().getConfig().ffmpeg)
+    llonebotError.ffmpegError = ffmpegOk ? '' : '没有找到 FFmpeg, 音频只能发送 WAV 和 SILK, 视频尺寸可能异常'
+    let { httpServerError, wsServerError, otherError, ffmpegError } = llonebotError
+    let error = `${otherError}\n${httpServerError}\n${wsServerError}\n${ffmpegError}`
+    error = error.replace('\n\n', '\n')
+    error = error.trim()
+    log('查询 LLOneBot 错误信息', error)
+    return error
+  })
+
+  ipcMain.handle(CHANNEL_GET_CONFIG, async (event, arg) => {
+    const config = getConfigUtil().getConfig()
+    return config
+  })
+
+  ipcMain.handle(CHANNEL_SET_CONFIG, (event, ask: boolean, config: LLOBConfig) => {
+    return new Promise<boolean>(resolve => {
+      if (!ask) {
+        getConfigUtil().setConfig(config)
+        log('配置已更新', config)
+        checkFfmpeg(config.ffmpeg).then()
+        resolve(true)
+        return
+      }
+      dialog
+        .showMessageBox(mainWindow!, {
+          type: 'question',
+          buttons: ['确认', '取消'],
+          defaultId: 0, // 默认选中的按钮，0 代表第一个按钮，即 "确认"
+          title: '确认保存',
+          message: '是否保存？',
+          detail: 'LLOneBot配置已更改，是否保存？',
+        })
+        .then((result) => {
+          if (result.response === 0) {
+            getConfigUtil().setConfig(config)
+            log('配置已更新', config)
+            checkFfmpeg(config.ffmpeg).then()
+            resolve(true)
+          }
+        })
+        .catch((err) => {
+          log('保存设置询问弹窗错误', err)
+          resolve(false)
+        })
+    })
+  })
+
+  ipcMain.on(CHANNEL_LOG, (event, arg) => {
     log(arg)
   })
 
-    ipcMain.handle(CHANNEL_SET_SELF_INFO, (event: any, arg: SelfInfo) => {
+  async function start() {
-        selfInfo.user_id = arg.user_id;
+    log('process pid', process.pid)
-        selfInfo.nickname = arg.nickname;
+    const config = getConfigUtil().getConfig()
-        running = true;
+    if (!config.enableLLOB) {
+      llonebotError.otherError = 'LLOneBot 未启动'
+      log('LLOneBot 开关设置为关闭，不启动LLOneBot')
+      return
+    }
+    if (!fs.existsSync(TEMP_DIR)) {
+      fs.mkdirSync(TEMP_DIR)
+    }
+    const ctx = new Context()
+    ctx.plugin(Log, {
+      enable: config.log!,
+      filename: logFileName
     })
-
+    ctx.plugin(NTQQFileApi)
-    ipcMain.on(CHANNEL_DELETE_FILE, (event: any, arg: string[]) => {
+    ctx.plugin(NTQQFileCacheApi)
-        for (const path of arg) {
+    ctx.plugin(NTQQFriendApi)
-            fs.unlinkSync(path);
+    ctx.plugin(NTQQGroupApi)
-        }
+    ctx.plugin(NTQQMsgApi)
+    ctx.plugin(NTQQUserApi)
+    ctx.plugin(NTQQWebApi)
+    ctx.plugin(NTQQWindowApi)
+    ctx.plugin(Core, config)
+    ctx.plugin(OneBot11Adapter, {
+      ...config.ob11,
+      heartInterval: config.heartInterval,
+      token: config.token!,
+      debug: config.debug!,
+      reportSelfMessage: config.reportSelfMessage!,
+      msgCacheExpire: config.msgCacheExpire!,
     })
-
+    ctx.start()
-    ipcMain.handle(CHANNEL_GET_RUNNING_STATUS, (event: any, arg: any) => {
+    ipcMain.on(CHANNEL_SET_CONFIG_CONFIRMED, (event, config: LLOBConfig) => {
-        return running;
+      ctx.parallel('llonebot/config-updated', config)
-    })
-
-    ipcMain.handle(CHANNEL_FILE2BASE64, async (event: any, path: string): Promise<{err: string, data: string}> => {
-        const readFile = util.promisify(fs.readFile);
-        let result = {
-            err: "",
-            data: ""
-        }
-        try {
-            // 读取文件内容
-            // if (!fs.existsSync(path)){
-            //     path = path.replace("\\Ori\\", "\\Thumb\\");
-            // }
-            try {
-                await checkFileReceived(path, 5000);
-            } catch (e: any) {
-                result.err = e.toString();
-                return result;
-            }
-            const data = await readFile(path);
-            // 转换为Base64编码
-            result.data = data.toString('base64');
-        } catch (err) {
-            result.err = err.toString();
-        }
-        return result;
     })
   }
 
+  const buildVersion = getBuildVersion()
+
+  const intervalId = setInterval(() => {
+    const self = Object.assign(selfInfo, {
+      uin: globalThis.authData?.uin,
+      uid: globalThis.authData?.uid,
+      online: true
+    })
+    if (self.uin && (buildVersion >= 27187 || getSession())) {
+      clearInterval(intervalId)
+      start()
+    }
+  }, 600)
+}
 
 // 创建窗口时触发
-function onBrowserWindowCreated(window: any) {
+function onBrowserWindowCreated(window: BrowserWindow) {
-
+  if (![2, 4].includes(window.id)) {
+    return
+  }
+  if (window.id === 2) {
+    mainWindow = window
+  }
+  //log('window create', window.webContents.getURL().toString())
+  try {
+    hookNTQQApiCall(window, window.id !== 2)
+    hookNTQQApiReceive(window, window.id !== 2)
+  } catch (e: any) {
+    log('LLOneBot hook error: ', e.toString())
+  }
 }
 
 try {
-    onLoad();
+  onLoad()
 } catch (e: any) {
   console.log(e.toString())
 }
 
 // 这两个函数都是可选的
-export {
+export { onBrowserWindowCreated }
-    onBrowserWindowCreated
-}

src/main/utils.ts

@@ -1,57 +0,0 @@
-import * as path from "path";
-import {json} from "express";
-import {selfInfo} from "./data";
-import {ConfigUtil} from "./config";
-
-const fs = require('fs');
-
-export const CONFIG_DIR = global.LiteLoader.plugins["LLOneBot"].path.data;
-
-export function getConfigUtil() {
-    const configFilePath = path.join(CONFIG_DIR, `config_${selfInfo.user_id}.json`)
-    return new ConfigUtil(configFilePath)
-}
-
-export function log(msg: any) {
-    if (!getConfigUtil().getConfig().log){
-        return
-    }
-    let currentDateTime = new Date().toLocaleString();
-    const date = new Date();
-    const year = date.getFullYear();
-    const month = date.getMonth() + 1;
-    const day = date.getDate();
-    const currentDate = `${year}-${month}-${day}`;
-    const userInfo = selfInfo.user_id ? `${selfInfo.nickname}(${selfInfo.user_id})` : ""
-    fs.appendFile(path.join(CONFIG_DIR , `llonebot-${currentDate}.log`), currentDateTime + ` ${userInfo}:` + JSON.stringify(msg) + "\n", (err: any) => {
-
-    })
-}
-
-export function isGIF(path: string) {
-    const buffer = Buffer.alloc(4);
-    const fd = fs.openSync(path, 'r');
-    fs.readSync(fd, buffer, 0, 4, 0);
-    fs.closeSync(fd);
-    return buffer.toString() === 'GIF8'
-}
-
-
-// 定义一个异步函数来检查文件是否存在
-export function checkFileReceived(path: string, timeout: number=3000): Promise<void> {
-    return new Promise((resolve, reject) => {
-        const startTime = Date.now();
-
-        function check() {
-            if (fs.existsSync(path)) {
-                resolve();
-            } else if (Date.now() - startTime > timeout) {
-                reject(new Error(`文件不存在: ${path}`));
-            } else {
-                setTimeout(check, 100);
-            }
-        }
-
-        check();
-    });
-}

src/ntqqapi/api/file.ts

@@ -0,0 +1,316 @@
+import { invoke, NTClass, NTMethod } from '../ntcall'
+import { GeneralCallResult } from '../services'
+import {
+  CacheFileList,
+  CacheFileListItem,
+  CacheFileType,
+  CacheScanResult,
+  ChatCacheListItemBasic,
+  ChatType,
+  ElementType,
+  IMAGE_HTTP_HOST,
+  IMAGE_HTTP_HOST_NT,
+  PicElement,
+} from '../types'
+import path from 'node:path'
+import fs from 'node:fs'
+import { ReceiveCmdS } from '../hook'
+import { RkeyManager } from '@/ntqqapi/helper/rkey'
+import { getSession } from '@/ntqqapi/wrapper'
+import { Peer } from '@/ntqqapi/types/msg'
+import { calculateFileMD5 } from '@/common/utils/file'
+import { fileTypeFromFile } from 'file-type'
+import fsPromise from 'node:fs/promises'
+import { NTEventDispatch } from '@/common/utils/eventTask'
+import { OnRichMediaDownloadCompleteParams } from '@/ntqqapi/listeners'
+import { Time } from 'cosmokit'
+import { Service, Context } from 'cordis'
+import { TEMP_DIR } from '@/common/globalVars'
+
+declare module 'cordis' {
+  interface Context {
+    ntFileApi: NTQQFileApi
+    ntFileCacheApi: NTQQFileCacheApi
+  }
+}
+
+export class NTQQFileApi extends Service {
+  private rkeyManager: RkeyManager
+
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntFileApi', true)
+    this.rkeyManager = new RkeyManager(ctx, 'http://napcat-sign.wumiao.wang:2082/rkey')
+  }
+
+  async getVideoUrl(peer: Peer, msgId: string, elementId: string) {
+    const session = getSession()
+    if (session) {
+      return (await session.getRichMediaService().getVideoPlayUrlV2(
+        peer,
+        msgId,
+        elementId,
+        0,
+        { downSourceType: 1, triggerType: 1 }
+      )).urlResult.domainUrl[0]?.url
+    } else {
+      const data = await invoke('nodeIKernelRichMediaService/getVideoPlayUrlV2', [{
+        peer,
+        msgId,
+        elemId: elementId,
+        videoCodecFormat: 0,
+        exParams: {
+          downSourceType: 1,
+          triggerType: 1
+        },
+      }, null])
+      if (data.result !== 0) {
+        this.ctx.logger.warn('getVideoUrl', data)
+      }
+      return data.urlResult.domainUrl[0]?.url
+    }
+  }
+
+  async getFileType(filePath: string) {
+    return fileTypeFromFile(filePath)
+  }
+
+  // 上传文件到QQ的文件夹
+  async uploadFile(filePath: string, elementType: ElementType = ElementType.PIC, elementSubType = 0) {
+    const fileMd5 = await calculateFileMD5(filePath)
+    let ext = (await this.getFileType(filePath))?.ext || ''
+    if (ext) {
+      ext = '.' + ext
+    }
+    let fileName = `${path.basename(filePath)}`
+    if (fileName.indexOf('.') === -1) {
+      fileName += ext
+    }
+    const session = getSession()
+    let mediaPath: string
+    if (session) {
+      mediaPath = session?.getMsgService().getRichMediaFilePathForGuild({
+        md5HexStr: fileMd5,
+        fileName: fileName,
+        elementType: elementType,
+        elementSubType,
+        thumbSize: 0,
+        needCreate: true,
+        downloadType: 1,
+        file_uuid: ''
+      })
+    } else {
+      mediaPath = await invoke(NTMethod.MEDIA_FILE_PATH, [{
+        path_info: {
+          md5HexStr: fileMd5,
+          fileName: fileName,
+          elementType: elementType,
+          elementSubType,
+          thumbSize: 0,
+          needCreate: true,
+          downloadType: 1,
+          file_uuid: '',
+        },
+      }])
+    }
+    await fsPromise.copyFile(filePath, mediaPath)
+    const fileSize = (await fsPromise.stat(filePath)).size
+    return {
+      md5: fileMd5,
+      fileName,
+      path: mediaPath,
+      fileSize,
+      ext
+    }
+  }
+
+  async downloadMedia(
+    msgId: string,
+    chatType: ChatType,
+    peerUid: string,
+    elementId: string,
+    thumbPath: string,
+    sourcePath: string,
+    timeout = 1000 * 60 * 2,
+    force = false
+  ) {
+    // 用于下载收到的消息中的图片等
+    if (sourcePath && fs.existsSync(sourcePath)) {
+      if (force) {
+        try {
+          await fsPromise.unlink(sourcePath)
+        } catch { }
+      } else {
+        return sourcePath
+      }
+    }
+    let filePath: string
+    if (NTEventDispatch.initialised) {
+      const data = await NTEventDispatch.CallNormalEvent<
+        (
+          params: {
+            fileModelId: string,
+            downloadSourceType: number,
+            triggerType: number,
+            msgId: string,
+            chatType: ChatType,
+            peerUid: string,
+            elementId: string,
+            thumbSize: number,
+            downloadType: number,
+            filePath: string
+          }) => Promise<unknown>,
+        (fileTransNotifyInfo: OnRichMediaDownloadCompleteParams) => void
+      >(
+        'NodeIKernelMsgService/downloadRichMedia',
+        'NodeIKernelMsgListener/onRichMediaDownloadComplete',
+        1,
+        timeout,
+        (arg: OnRichMediaDownloadCompleteParams) => {
+          if (arg.msgId === msgId) {
+            return true
+          }
+          return false
+        },
+        {
+          fileModelId: '0',
+          downloadSourceType: 0,
+          triggerType: 1,
+          msgId: msgId,
+          chatType: chatType,
+          peerUid: peerUid,
+          elementId: elementId,
+          thumbSize: 0,
+          downloadType: 1,
+          filePath: thumbPath
+        }
+      )
+      filePath = data[1].filePath
+    } else {
+      const data = await invoke<{ notifyInfo: OnRichMediaDownloadCompleteParams }>(
+        'nodeIKernelMsgService/downloadRichMedia',
+        [
+          {
+            getReq: {
+              fileModelId: '0',
+              downloadSourceType: 0,
+              triggerType: 1,
+              msgId: msgId,
+              chatType: chatType,
+              peerUid: peerUid,
+              elementId: elementId,
+              thumbSize: 0,
+              downloadType: 1,
+              filePath: thumbPath,
+            },
+          },
+          null,
+        ],
+        {
+          cbCmd: ReceiveCmdS.MEDIA_DOWNLOAD_COMPLETE,
+          cmdCB: payload => payload.notifyInfo.msgId === msgId,
+          timeout
+        }
+      )
+      filePath = data.notifyInfo.filePath
+    }
+    if (filePath.startsWith('\\')) {
+      const downloadPath = TEMP_DIR
+      filePath = path.join(downloadPath, filePath)
+      // 下载路径是下载文件夹的相对路径
+    }
+    return filePath
+  }
+
+  async getImageSize(filePath: string) {
+    return await invoke<{ width: number; height: number }>(
+      NTMethod.IMAGE_SIZE,
+      [filePath],
+      {
+        className: NTClass.FS_API,
+      }
+    )
+  }
+
+  async getImageUrl(element: PicElement) {
+    if (!element) {
+      return ''
+    }
+    const url: string = element.originImageUrl!  // 没有域名
+    const md5HexStr = element.md5HexStr
+    const fileMd5 = element.md5HexStr
+
+    if (url) {
+      const UrlParse = new URL(IMAGE_HTTP_HOST + url) //临时解析拼接
+      const imageAppid = UrlParse.searchParams.get('appid')
+      const isNewPic = imageAppid && ['1406', '1407'].includes(imageAppid)
+      if (isNewPic) {
+        let UrlRkey = UrlParse.searchParams.get('rkey')
+        if (UrlRkey) {
+          return IMAGE_HTTP_HOST_NT + url
+        }
+        const rkeyData = await this.rkeyManager.getRkey()
+        UrlRkey = imageAppid === '1406' ? rkeyData.private_rkey : rkeyData.group_rkey
+        return IMAGE_HTTP_HOST_NT + url + `${UrlRkey}`
+      } else {
+        // 老的图片url，不需要rkey
+        return IMAGE_HTTP_HOST + url
+      }
+    } else if (fileMd5 || md5HexStr) {
+      // 没有url，需要自己拼接
+      return `${IMAGE_HTTP_HOST}/gchatpic_new/0/0-0-${(fileMd5 || md5HexStr)!.toUpperCase()}/0`
+    }
+    this.ctx.logger.error('图片url获取失败', element)
+    return ''
+  }
+}
+
+export class NTQQFileCacheApi extends Service {
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntFileCacheApi', true)
+  }
+
+  async setCacheSilentScan(isSilent: boolean = true) {
+    return await invoke<GeneralCallResult>(NTMethod.CACHE_SET_SILENCE, [{ isSilent }, null])
+  }
+
+  getCacheSessionPathList() {
+    return invoke<
+      {
+        key: string
+        value: string
+      }[]
+    >(NTMethod.CACHE_PATH_SESSION, [], { className: NTClass.OS_API })
+  }
+
+  scanCache() {
+    invoke<GeneralCallResult>(ReceiveCmdS.CACHE_SCAN_FINISH, [], { classNameIsRegister: true })
+    return invoke<CacheScanResult>(NTMethod.CACHE_SCAN, [null, null], { timeout: 300 * Time.second })
+  }
+
+  getHotUpdateCachePath() {
+    return invoke<string>(NTMethod.CACHE_PATH_HOT_UPDATE, [], { className: NTClass.HOTUPDATE_API })
+  }
+
+  getDesktopTmpPath() {
+    return invoke<string>(NTMethod.CACHE_PATH_DESKTOP_TEMP, [], { className: NTClass.BUSINESS_API })
+  }
+
+  getFileCacheInfo(fileType: CacheFileType, pageSize: number = 1000, lastRecord?: CacheFileListItem) {
+    const _lastRecord = lastRecord ? lastRecord : { fileType: fileType }
+
+    return invoke<CacheFileList>(NTMethod.CACHE_FILE_GET, [{
+      fileType: fileType,
+      restart: true,
+      pageSize: pageSize,
+      order: 1,
+      lastRecord: _lastRecord,
+    }, null])
+  }
+
+  async clearChatCache(chats: ChatCacheListItemBasic[] = [], fileKeys: string[] = []) {
+    return await invoke<GeneralCallResult>(NTMethod.CACHE_CHAT_CLEAR, [{
+      chats,
+      fileKeys,
+    }, null])
+  }
+}

src/ntqqapi/api/friend.ts

@@ -0,0 +1,202 @@
+import { Friend, FriendV2, SimpleInfo, CategoryFriend } from '../types'
+import { ReceiveCmdS } from '../hook'
+import { invoke, NTMethod, NTClass } from '../ntcall'
+import { getSession } from '@/ntqqapi/wrapper'
+import { BuddyListReqType, NodeIKernelProfileService } from '../services'
+import { NTEventDispatch } from '@/common/utils/eventTask'
+import { pick } from 'cosmokit'
+import { Service, Context } from 'cordis'
+
+declare module 'cordis' {
+  interface Context {
+    ntFriendApi: NTQQFriendApi
+  }
+}
+
+export class NTQQFriendApi extends Service {
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntFriendApi', true)
+  }
+
+  /** 大于或等于 26702 应使用 getBuddyV2 */
+  async getFriends(forced = false) {
+    const data = await invoke<{
+      data: {
+        categoryId: number
+        categroyName: string
+        categroyMbCount: number
+        buddyList: Friend[]
+      }[]
+    }>(
+      'getBuddyList',
+      [],
+      {
+        className: NTClass.NODE_STORE_API,
+        cbCmd: ReceiveCmdS.FRIENDS,
+        afterFirstCmd: false,
+      }
+    )
+    const _friends: Friend[] = []
+    for (const item of data.data) {
+      _friends.push(...item.buddyList)
+    }
+    return _friends
+  }
+
+  async handleFriendRequest(flag: string, accept: boolean) {
+    const data = flag.split('|')
+    if (data.length < 2) {
+      return
+    }
+    const friendUid = data[0]
+    const reqTime = data[1]
+    const session = getSession()
+    if (session) {
+      return session.getBuddyService().approvalFriendRequest({
+        friendUid,
+        reqTime,
+        accept
+      })
+    } else {
+      return await invoke(NTMethod.HANDLE_FRIEND_REQUEST, [{
+        approvalInfo: {
+          friendUid,
+          reqTime,
+          accept,
+        },
+      }])
+    }
+  }
+
+  async getBuddyV2(refresh = false): Promise<FriendV2[]> {
+    const session = getSession()
+    if (session) {
+      const uids: string[] = []
+      const buddyService = session.getBuddyService()
+      const buddyListV2 = await buddyService.getBuddyListV2('0', BuddyListReqType.KNOMAL)
+      uids.push(...buddyListV2.data.flatMap(item => item.buddyUids))
+      const data = await NTEventDispatch.CallNoListenerEvent<NodeIKernelProfileService['getCoreAndBaseInfo']>(
+        'NodeIKernelProfileService/getCoreAndBaseInfo', 5000, 'nodeStore', uids
+      )
+      return Array.from(data.values())
+    } else {
+      const data = await invoke<{
+        buddyCategory: CategoryFriend[]
+        userSimpleInfos: Record<string, SimpleInfo>
+      }>(
+        'getBuddyList',
+        [refresh],
+        {
+          className: NTClass.NODE_STORE_API,
+          cbCmd: ReceiveCmdS.FRIENDS,
+          afterFirstCmd: false,
+        }
+      )
+      const categoryUids: Map<number, string[]> = new Map()
+      for (const item of data.buddyCategory) {
+        categoryUids.set(item.categoryId, item.buddyUids)
+      }
+      return Object.values(data.userSimpleInfos).filter(v => v.baseInfo && categoryUids.get(v.baseInfo.categoryId)?.includes(v.uid!))
+    }
+  }
+
+  /** uid => uin */
+  async getBuddyIdMap(refresh = false): Promise<Map<string, string>> {
+    const retMap: Map<string, string> = new Map()
+    const session = getSession()
+    if (session) {
+      const uids: string[] = []
+      const buddyService = session?.getBuddyService()
+      const buddyListV2 = await buddyService.getBuddyListV2('0', BuddyListReqType.KNOMAL)
+      uids.push(...buddyListV2.data.flatMap(item => item.buddyUids))
+      const data = await NTEventDispatch.CallNoListenerEvent<NodeIKernelProfileService['getCoreAndBaseInfo']>(
+        'NodeIKernelProfileService/getCoreAndBaseInfo', 5000, 'nodeStore', uids
+      )
+      for (const [, item] of data) {
+        if (retMap.size > 5000) {
+          break
+        }
+        retMap.set(item.uid!, item.uin!)
+      }
+    } else {
+      const data = await invoke<{
+        buddyCategory: CategoryFriend[]
+        userSimpleInfos: Record<string, SimpleInfo>
+      }>(
+        'getBuddyList',
+        [refresh],
+        {
+          className: NTClass.NODE_STORE_API,
+          cbCmd: ReceiveCmdS.FRIENDS,
+          afterFirstCmd: false,
+        }
+      )
+      for (const item of Object.values(data.userSimpleInfos)) {
+        if (retMap.size > 5000) {
+          break
+        }
+        retMap.set(item.uid!, item.uin!)
+      }
+    }
+    return retMap
+  }
+
+  async getBuddyV2ExWithCate(refresh = false) {
+    const session = getSession()
+    if (session) {
+      const uids: string[] = []
+      const categoryMap: Map<string, any> = new Map()
+      const buddyService = session.getBuddyService()
+      const buddyListV2 = (await buddyService?.getBuddyListV2('0', BuddyListReqType.KNOMAL))?.data
+      uids.push(
+        ...buddyListV2?.flatMap(item => {
+          item.buddyUids.forEach(uid => {
+            categoryMap.set(uid, { categoryId: item.categoryId, categroyName: item.categroyName })
+          })
+          return item.buddyUids
+        })!)
+      const data = await NTEventDispatch.CallNoListenerEvent<NodeIKernelProfileService['getCoreAndBaseInfo']>(
+        'NodeIKernelProfileService/getCoreAndBaseInfo', 5000, 'nodeStore', uids
+      )
+      return Array.from(data).map(([key, value]) => {
+        const category = categoryMap.get(key)
+        return category ? { ...value, categoryId: category.categoryId, categroyName: category.categroyName } : value
+      })
+    } else {
+      const data = await invoke<{
+        buddyCategory: CategoryFriend[]
+        userSimpleInfos: Record<string, SimpleInfo>
+      }>(
+        'getBuddyList',
+        [refresh],
+        {
+          className: NTClass.NODE_STORE_API,
+          cbCmd: ReceiveCmdS.FRIENDS,
+          afterFirstCmd: false,
+        }
+      )
+      const category: Map<number, Pick<CategoryFriend, 'buddyUids' | 'categroyName'>> = new Map()
+      for (const item of data.buddyCategory) {
+        category.set(item.categoryId, pick(item, ['buddyUids', 'categroyName']))
+      }
+      return Object.values(data.userSimpleInfos)
+        .filter(v => v.baseInfo && category.get(v.baseInfo.categoryId)?.buddyUids.includes(v.uid!))
+        .map(value => {
+          return {
+            ...value,
+            categoryId: value.baseInfo.categoryId,
+            categroyName: category.get(value.baseInfo.categoryId)?.categroyName
+          }
+        })
+    }
+  }
+
+  async isBuddy(uid: string): Promise<boolean> {
+    const session = getSession()
+    if (session) {
+      return session.getBuddyService().isBuddy(uid)
+    } else {
+      return await invoke('nodeIKernelBuddyService/isBuddy', [{ uid }, null])
+    }
+  }
+}

src/ntqqapi/api/group.ts

@@ -0,0 +1,324 @@
+import { ReceiveCmdS } from '../hook'
+import { Group, GroupMember, GroupMemberRole, GroupNotifies, GroupRequestOperateTypes, GroupNotify, GetFileListParam } from '../types'
+import { invoke, NTClass, NTMethod } from '../ntcall'
+import { GeneralCallResult } from '../services'
+import { NTQQWindows } from './window'
+import { getSession } from '../wrapper'
+import { NTEventDispatch } from '@/common/utils/eventTask'
+import { NodeIKernelGroupListener, OnGroupFileInfoUpdateParams } from '../listeners'
+import { NodeIKernelGroupService } from '../services'
+import { Service, Context } from 'cordis'
+import { isNumeric } from '@/common/utils/misc'
+
+declare module 'cordis' {
+  interface Context {
+    ntGroupApi: NTQQGroupApi
+  }
+}
+
+export class NTQQGroupApi extends Service {
+  static inject = ['ntWindowApi']
+
+  public groupMembers: Map<string, Map<string, GroupMember>> = new Map<string, Map<string, GroupMember>>()
+
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntGroupApi', true)
+  }
+
+  async getGroups(forced = false): Promise<Group[]> {
+    if (NTEventDispatch.initialised) {
+      type ListenerType = NodeIKernelGroupListener['onGroupListUpdate']
+      const [, , groupList] = await NTEventDispatch.CallNormalEvent
+        <(force: boolean) => Promise<any>, ListenerType>
+        (
+          'NodeIKernelGroupService/getGroupList',
+          'NodeIKernelGroupListener/onGroupListUpdate',
+          1,
+          5000,
+          () => true,
+          forced
+        )
+      return groupList
+    } else {
+      const result = await invoke<{
+        updateType: number
+        groupList: Group[]
+      }>(
+        'getGroupList',
+        [],
+        {
+          className: NTClass.NODE_STORE_API,
+          cbCmd: ReceiveCmdS.GROUPS_STORE,
+          afterFirstCmd: false,
+        }
+      )
+      return result.groupList
+    }
+  }
+
+  async getGroupMembers(groupCode: string, num = 3000): Promise<Map<string, GroupMember>> {
+    const session = getSession()
+    let result: Awaited<ReturnType<NodeIKernelGroupService['getNextMemberList']>>
+    if (session) {
+      const groupService = session.getGroupService()
+      const sceneId = groupService.createMemberListScene(groupCode, 'groupMemberList_MainWindow')
+      result = await groupService.getNextMemberList(sceneId, undefined, num)
+    } else {
+      const sceneId = await invoke(NTMethod.GROUP_MEMBER_SCENE, [{ groupCode, scene: 'groupMemberList_MainWindow' }])
+      result = await invoke(NTMethod.GROUP_MEMBERS, [{ sceneId, num }, null])
+    }
+    if (result.errCode !== 0) {
+      throw ('获取群成员列表出错,' + result.errMsg)
+    }
+    return result.result.infos
+  }
+
+  async getGroupMember(groupCode: string | number, memberUinOrUid: string | number) {
+    const groupCodeStr = groupCode.toString()
+    const memberUinOrUidStr = memberUinOrUid.toString()
+    let members = this.groupMembers.get(groupCodeStr)
+    if (!members) {
+      try {
+        members = await this.getGroupMembers(groupCodeStr)
+        // 更新群成员列表
+        this.groupMembers.set(groupCodeStr, members)
+      }
+      catch (e) {
+        return null
+      }
+    }
+    const getMember = () => {
+      let member: GroupMember | undefined = undefined
+      if (isNumeric(memberUinOrUidStr)) {
+        member = Array.from(members!.values()).find(member => member.uin === memberUinOrUidStr)
+      } else {
+        member = members!.get(memberUinOrUidStr)
+      }
+      return member
+    }
+    let member = getMember()
+    if (!member) {
+      members = await this.getGroupMembers(groupCodeStr)
+      this.groupMembers.set(groupCodeStr, members)
+      member = getMember()
+    }
+    return member
+  }
+
+  async getGroupIgnoreNotifies() {
+    await this.getSingleScreenNotifies(14)
+    return await this.ctx.ntWindowApi.openWindow<GeneralCallResult & GroupNotifies>(
+      NTQQWindows.GroupNotifyFilterWindow,
+      [],
+      ReceiveCmdS.GROUP_NOTIFY,
+    )
+  }
+
+  async getSingleScreenNotifies(num: number) {
+    if (NTEventDispatch.initialised) {
+      const [_retData, _doubt, _seq, notifies] = await NTEventDispatch.CallNormalEvent
+        <(arg1: boolean, arg2: string, arg3: number) => Promise<any>, (doubt: boolean, seq: string, notifies: GroupNotify[]) => void>
+        (
+          'NodeIKernelGroupService/getSingleScreenNotifies',
+          'NodeIKernelGroupListener/onGroupSingleScreenNotifies',
+          1,
+          5000,
+          () => true,
+          false,
+          '',
+          num,
+        )
+      return notifies
+    } else {
+      invoke(ReceiveCmdS.GROUP_NOTIFY, [], { classNameIsRegister: true })
+      return (await invoke<GroupNotifies>(
+        'nodeIKernelGroupService/getSingleScreenNotifies',
+        [{ doubt: false, startSeq: '', number: num }, null],
+        {
+
+          cbCmd: ReceiveCmdS.GROUP_NOTIFY,
+          afterFirstCmd: false,
+        }
+      )).notifies
+    }
+  }
+
+  async handleGroupRequest(flag: string, operateType: GroupRequestOperateTypes, reason?: string) {
+    const flagitem = flag.split('|')
+    const groupCode = flagitem[0]
+    const seq = flagitem[1]
+    const type = parseInt(flagitem[2])
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().operateSysNotify(
+        false,
+        {
+          'operateType': operateType, // 2 拒绝
+          'targetMsg': {
+            'seq': seq,  // 通知序列号
+            'type': type,
+            'groupCode': groupCode,
+            'postscript': reason || ' ' // 仅传空值可能导致处理失败，故默认给个空格
+          }
+        })
+    } else {
+      return await invoke(NTMethod.HANDLE_GROUP_REQUEST, [{
+        doubt: false,
+        operateMsg: {
+          operateType,
+          targetMsg: {
+            seq,
+            type,
+            groupCode,
+            postscript: reason || ' ' // 仅传空值可能导致处理失败，故默认给个空格
+          },
+        },
+      }, null])
+    }
+  }
+
+  async quitGroup(groupCode: string) {
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().quitGroup(groupCode)
+    } else {
+      return await invoke(NTMethod.QUIT_GROUP, [{ groupCode }, null])
+    }
+  }
+
+  async kickMember(
+    groupCode: string,
+    kickUids: string[],
+    refuseForever = false,
+    kickReason = '',
+  ) {
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().kickMember(groupCode, kickUids, refuseForever, kickReason)
+    } else {
+      return await invoke(NTMethod.KICK_MEMBER, [{ groupCode, kickUids, refuseForever, kickReason }])
+    }
+  }
+
+  async banMember(groupCode: string, memList: Array<{ uid: string, timeStamp: number }>) {
+    // timeStamp为秒数, 0为解除禁言
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().setMemberShutUp(groupCode, memList)
+    } else {
+      return await invoke(NTMethod.MUTE_MEMBER, [{ groupCode, memList }])
+    }
+  }
+
+  async banGroup(groupCode: string, shutUp: boolean) {
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().setGroupShutUp(groupCode, shutUp)
+    } else {
+      return await invoke(NTMethod.MUTE_GROUP, [{ groupCode, shutUp }, null])
+    }
+  }
+
+  async setMemberCard(groupCode: string, memberUid: string, cardName: string) {
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().modifyMemberCardName(groupCode, memberUid, cardName)
+    } else {
+      return await invoke(NTMethod.SET_MEMBER_CARD, [{ groupCode, uid: memberUid, cardName }, null])
+    }
+  }
+
+  async setMemberRole(groupCode: string, memberUid: string, role: GroupMemberRole) {
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().modifyMemberRole(groupCode, memberUid, role)
+    } else {
+      return await invoke(NTMethod.SET_MEMBER_ROLE, [{ groupCode, uid: memberUid, role }, null])
+    }
+  }
+
+  async setGroupName(groupCode: string, groupName: string) {
+    const session = getSession()
+    if (session) {
+      return session.getGroupService().modifyGroupName(groupCode, groupName, false)
+    } else {
+      return await invoke(NTMethod.SET_GROUP_NAME, [{ groupCode, groupName }, null])
+    }
+  }
+
+  async getGroupRemainAtTimes(groupCode: string) {
+    return await invoke<
+      GeneralCallResult & {
+        atInfo: {
+          canAtAll: boolean
+          RemainAtAllCountForUin: number
+          RemainAtAllCountForGroup: number
+          atTimesMsg: string
+          canNotAtAllMsg: ''
+        }
+      }
+    >(NTMethod.GROUP_AT_ALL_REMAIN_COUNT, [{ groupCode }, null])
+  }
+
+  /** 27187 TODO */
+  async removeGroupEssence(GroupCode: string, msgId: string) {
+    const session = getSession()
+    // 代码没测过
+    // 需要 ob11msgid->msgId + (peer) -> msgSeq + msgRandom
+    let MsgData = await session?.getMsgService().getMsgsIncludeSelf({ chatType: 2, guildId: '', peerUid: GroupCode }, msgId, 1, false)
+    let param = {
+      groupCode: GroupCode,
+      msgRandom: parseInt(MsgData?.msgList[0].msgRandom!),
+      msgSeq: parseInt(MsgData?.msgList[0].msgSeq!)
+    }
+    // GetMsgByShoretID(ShoretID) -> MsgService.getMsgs(Peer,MsgId,1,false) -> 组出参数
+    return session?.getGroupService().removeGroupEssence(param)
+  }
+
+  /** 27187 TODO */
+  async addGroupEssence(GroupCode: string, msgId: string) {
+    const session = getSession()
+    // 代码没测过
+    // 需要 ob11msgid->msgId + (peer) -> msgSeq + msgRandom
+    let MsgData = await session?.getMsgService().getMsgsIncludeSelf({ chatType: 2, guildId: '', peerUid: GroupCode }, msgId, 1, false)
+    let param = {
+      groupCode: GroupCode,
+      msgRandom: parseInt(MsgData?.msgList[0].msgRandom!),
+      msgSeq: parseInt(MsgData?.msgList[0].msgSeq!)
+    }
+    // GetMsgByShoretID(ShoretID) -> MsgService.getMsgs(Peer,MsgId,1,false) -> 组出参数
+    return session?.getGroupService().addGroupEssence(param)
+  }
+
+  async createGroupFileFolder(groupId: string, folderName: string) {
+    return await invoke('nodeIKernelRichMediaService/createGroupFolder', [{ groupId, folderName }, null])
+  }
+
+  async deleteGroupFileFolder(groupId: string, folderId: string) {
+    return await invoke('nodeIKernelRichMediaService/deleteGroupFolder', [{ groupId, folderId }, null])
+  }
+
+  async deleteGroupFile(groupId: string, fileIdList: string[]) {
+    return await invoke('nodeIKernelRichMediaService/deleteGroupFile', [{ groupId, busIdList: [102], fileIdList }, null])
+  }
+
+  async getGroupFileList(groupId: string, fileListForm: GetFileListParam) {
+    invoke('nodeIKernelMsgListener/onGroupFileInfoUpdate', [], { classNameIsRegister: true })
+    const data = await invoke<{ fileInfo: OnGroupFileInfoUpdateParams }>(
+      'nodeIKernelRichMediaService/getGroupFileList',
+      [
+        {
+          groupId,
+          fileListForm
+        },
+        null,
+      ],
+      {
+        cbCmd: 'nodeIKernelMsgListener/onGroupFileInfoUpdate',
+        afterFirstCmd: false,
+        cmdCB: (payload, result) => payload.fileInfo.reqId === result
+      }
+    )
+    return data.fileInfo.item
+  }
+}

src/ntqqapi/api/index.ts

@@ -0,0 +1,7 @@
+export * from './file'
+export * from './friend'
+export * from './group'
+export * from './msg'
+export * from './user'
+export * from './webapi'
+export * from './window'

src/ntqqapi/api/msg.ts

@@ -0,0 +1,311 @@
+import { invoke, NTMethod } from '../ntcall'
+import { GeneralCallResult } from '../services'
+import { RawMessage, SendMessageElement, Peer, ChatType2 } from '../types'
+import { getSession } from '@/ntqqapi/wrapper'
+import { NTEventDispatch } from '@/common/utils/eventTask'
+import { Service, Context } from 'cordis'
+import { selfInfo } from '@/common/globalVars'
+
+declare module 'cordis' {
+  interface Context {
+    ntMsgApi: NTQQMsgApi
+  }
+}
+
+function generateMsgId() {
+  const timestamp = Math.floor(Date.now() / 1000)
+  const random = Math.floor(Math.random() * Math.pow(2, 32))
+  const buffer = Buffer.alloc(8)
+  buffer.writeUInt32BE(timestamp, 0)
+  buffer.writeUInt32BE(random, 4)
+  const msgId = BigInt('0x' + buffer.toString('hex')).toString()
+  return msgId
+}
+
+export class NTQQMsgApi extends Service {
+  static inject = ['ntUserApi']
+
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntMsgApi', true)
+  }
+
+  async getTempChatInfo(chatType: ChatType2, peerUid: string) {
+    const session = getSession()
+    if (session) {
+      return session.getMsgService().getTempChatInfo(chatType, peerUid)
+    } else {
+      return await invoke('nodeIKernelMsgService/getTempChatInfo', [{ chatType, peerUid }, null])
+    }
+  }
+
+  async setEmojiLike(peer: Peer, msgSeq: string, emojiId: string, setEmoji: boolean = true) {
+    // nt_qq//global//nt_data//Emoji//emoji-resource//sysface_res/apng/ 下可以看到所有QQ表情预览
+    // nt_qq\global\nt_data\Emoji\emoji-resource\face_config.json 里面有所有表情的id, 自带表情id是QSid, 标准emoji表情id是QCid
+    // 其实以官方文档为准是最好的，https://bot.q.qq.com/wiki/develop/api-v2/openapi/emoji/model.html#EmojiType
+    const session = getSession()
+    const emojiType = emojiId.length > 3 ? '2' : '1'
+    if (session) {
+      return session.getMsgService().setMsgEmojiLikes(peer, msgSeq, emojiId, emojiType, setEmoji)
+    } else {
+      return await invoke(NTMethod.EMOJI_LIKE, [{ peer, msgSeq, emojiId, emojiType, setEmoji }, null])
+    }
+  }
+
+  async getMultiMsg(peer: Peer, rootMsgId: string, parentMsgId: string) {
+    const session = getSession()
+    if (session) {
+      return session.getMsgService().getMultiMsg(peer, rootMsgId, parentMsgId)
+    } else {
+      return await invoke(NTMethod.GET_MULTI_MSG, [{ peer, rootMsgId, parentMsgId }, null])
+    }
+  }
+
+  async activateChat(peer: Peer) {
+    return await invoke<GeneralCallResult>(NTMethod.ACTIVE_CHAT_PREVIEW, [{ peer, cnt: 20 }, null])
+  }
+
+  async activateChatAndGetHistory(peer: Peer) {
+    return await invoke<GeneralCallResult>(NTMethod.ACTIVE_CHAT_HISTORY, [{ peer, cnt: 20 }, null])
+  }
+
+  async getAioFirstViewLatestMsgs(peer: Peer, cnt: number) {
+    return await invoke('nodeIKernelMsgService/getAioFirstViewLatestMsgs', [{ peer, cnt }, null])
+  }
+
+  async getMsgsByMsgId(peer: Peer | undefined, msgIds: string[] | undefined) {
+    if (!peer) throw new Error('peer is not allowed')
+    if (!msgIds) throw new Error('msgIds is not allowed')
+    const session = getSession()
+    if (session) {
+      return session.getMsgService().getMsgsByMsgId(peer, msgIds)
+    } else {
+      return await invoke('nodeIKernelMsgService/getMsgsByMsgId', [{ peer, msgIds }, null])
+    }
+  }
+
+  async getMsgHistory(peer: Peer, msgId: string, cnt: number, isReverseOrder: boolean = false) {
+    const session = getSession()
+    // 消息时间从旧到新
+    if (session) {
+      return session.getMsgService().getMsgsIncludeSelf(peer, msgId, cnt, isReverseOrder)
+    } else {
+      return await invoke(NTMethod.HISTORY_MSG, [{ peer, msgId, cnt, queryOrder: isReverseOrder }, null])
+    }
+  }
+
+  async recallMsg(peer: Peer, msgIds: string[]) {
+    const session = getSession()
+    if (session) {
+      return session.getMsgService().recallMsg(peer, msgIds)
+    } else {
+      return await invoke(NTMethod.RECALL_MSG, [{ peer, msgIds }, null])
+    }
+  }
+
+  async sendMsg(peer: Peer, msgElements: SendMessageElement[], waitComplete = true, timeout = 10000) {
+    const msgId = generateMsgId()
+    peer.guildId = msgId
+    let msgList: RawMessage[]
+    if (NTEventDispatch.initialised) {
+      const data = await NTEventDispatch.CallNormalEvent<
+        (msgId: string, peer: Peer, msgElements: SendMessageElement[], map: Map<any, any>) => Promise<unknown>,
+        (msgList: RawMessage[]) => void
+      >(
+        'NodeIKernelMsgService/sendMsg',
+        'NodeIKernelMsgListener/onMsgInfoListUpdate',
+        1,
+        timeout,
+        (msgRecords: RawMessage[]) => {
+          for (const msgRecord of msgRecords) {
+            if (msgRecord.guildId === msgId && msgRecord.sendStatus === 2) {
+              return true
+            }
+          }
+          return false
+        },
+        '0',
+        peer,
+        msgElements,
+        new Map()
+      )
+      msgList = data[1]
+    } else {
+      const data = await invoke<{ msgList: RawMessage[] }>(
+        'nodeIKernelMsgService/sendMsg',
+        [
+          {
+            msgId: '0',
+            peer,
+            msgElements,
+            msgAttributeInfos: new Map()
+          },
+          null
+        ],
+        {
+          cbCmd: 'nodeIKernelMsgListener/onMsgInfoListUpdate',
+          afterFirstCmd: false,
+          cmdCB: payload => {
+            for (const msgRecord of payload.msgList) {
+              if (msgRecord.guildId === msgId && msgRecord.sendStatus === 2) {
+                return true
+              }
+            }
+            return false
+          },
+          timeout
+        }
+      )
+      msgList = data.msgList
+    }
+    return msgList.find(msgRecord => msgRecord.guildId === msgId)
+  }
+
+  async forwardMsg(srcPeer: Peer, destPeer: Peer, msgIds: string[]) {
+    const session = getSession()
+    if (session) {
+      return session.getMsgService().forwardMsg(msgIds, srcPeer, [destPeer], [])
+    } else {
+      return await invoke<GeneralCallResult>(NTMethod.FORWARD_MSG, [{
+        msgIds,
+        srcContact: srcPeer,
+        dstContacts: [destPeer],
+        commentElements: [],
+        msgAttributeInfos: new Map(),
+      }, null])
+    }
+  }
+
+  async multiForwardMsg(srcPeer: Peer, destPeer: Peer, msgIds: string[]): Promise<RawMessage> {
+    const senderShowName = await this.ctx.ntUserApi.getSelfNick(true)
+    const msgInfos = msgIds.map(id => {
+      return { msgId: id, senderShowName }
+    })
+    const selfUid = selfInfo.uid
+    let msgList: RawMessage[]
+    if (NTEventDispatch.initialised) {
+      const data = await NTEventDispatch.CallNormalEvent<
+        (msgInfo: typeof msgInfos, srcPeer: Peer, destPeer: Peer, comment: Array<any>, attr: Map<any, any>,) => Promise<unknown>,
+        (msgList: RawMessage[]) => void
+      >(
+        'NodeIKernelMsgService/multiForwardMsgWithComment',
+        'NodeIKernelMsgListener/onMsgInfoListUpdate',
+        1,
+        5000,
+        (msgRecords: RawMessage[]) => {
+          for (let msgRecord of msgRecords) {
+            if (msgRecord.peerUid == destPeer.peerUid && msgRecord.senderUid == selfUid) {
+              return true
+            }
+          }
+          return false
+        },
+        msgInfos,
+        srcPeer,
+        destPeer,
+        [],
+        new Map()
+      )
+      msgList = data[1]
+    } else {
+      const data = await invoke<{ msgList: RawMessage[] }>(
+        'nodeIKernelMsgService/multiForwardMsgWithComment',
+        [
+          {
+            msgInfos,
+            srcContact: srcPeer,
+            dstContact: destPeer,
+            commentElements: [],
+            msgAttributeInfos: new Map(),
+          },
+          null,
+        ],
+        {
+          cbCmd: 'nodeIKernelMsgListener/onMsgInfoListUpdate',
+          afterFirstCmd: false,
+          cmdCB: payload => {
+            for (const msgRecord of payload.msgList) {
+              if (msgRecord.peerUid == destPeer.peerUid && msgRecord.senderUid == selfUid) {
+                return true
+              }
+            }
+            return false
+          },
+        }
+      )
+      msgList = data.msgList
+    }
+    for (const msg of msgList) {
+      const arkElement = msg.elements.find(ele => ele.arkElement)
+      if (!arkElement) {
+        continue
+      }
+      const forwardData: any = JSON.parse(arkElement.arkElement.bytesData)
+      if (forwardData.app != 'com.tencent.multimsg') {
+        continue
+      }
+      if (msg.peerUid == destPeer.peerUid && msg.senderUid == selfUid) {
+        return msg
+      }
+    }
+    throw new Error('转发消息超时')
+  }
+
+  async getMsgsBySeqAndCount(peer: Peer, msgSeq: string, count: number, desc: boolean, z: boolean) {
+    const session = getSession()
+    if (session) {
+      return await session.getMsgService().getMsgsBySeqAndCount(peer, msgSeq, count, desc, z)
+    } else {
+      return await invoke('nodeIKernelMsgService/getMsgsBySeqAndCount', [{
+        peer,
+        cnt: count,
+        msgSeq,
+        queryOrder: desc
+      }, null])
+    }
+  }
+
+  async getSingleMsg(peer: Peer, msgSeq: string) {
+    const session = getSession()
+    if (session) {
+      return await session.getMsgService().getSingleMsg(peer, msgSeq)
+    } else {
+      return await invoke('nodeIKernelMsgService/getSingleMsg', [{ peer, msgSeq }, null])
+    }
+  }
+
+  async queryFirstMsgBySeq(peer: Peer, msgSeq: string) {
+    return await invoke('nodeIKernelMsgService/queryMsgsWithFilterEx', [{
+      msgId: '0',
+      msgTime: '0',
+      msgSeq,
+      params: {
+        chatInfo: peer,
+        filterMsgType: [],
+        filterSendersUid: [],
+        filterMsgToTime: '0',
+        filterMsgFromTime: '0',
+        isReverseOrder: true,
+        isIncludeCurrent: true,
+        pageLimit: 1,
+      }
+    }, null])
+  }
+
+  async queryMsgsWithFilterExBySeq(peer: Peer, msgSeq: string, filterMsgTime: string, filterSendersUid: string[]) {
+    return await invoke('nodeIKernelMsgService/queryMsgsWithFilterEx', [{
+      msgId: '0',
+      msgTime: '0',
+      msgSeq,
+      params: {
+        chatInfo: peer,
+        filterMsgType: [],
+        filterSendersUid,
+        filterMsgToTime: filterMsgTime,
+        filterMsgFromTime: filterMsgTime,
+        isReverseOrder: true,
+        isIncludeCurrent: true,
+        pageLimit: 1,
+      }
+    }, null])
+  }
+}

src/ntqqapi/api/user.ts

@@ -0,0 +1,347 @@
+import { invoke, NTMethod } from '../ntcall'
+import { User, UserDetailInfoByUin, UserDetailInfoByUinV2, UserDetailInfoListenerArg } from '../types'
+import { getBuildVersion } from '@/common/utils'
+import { getSession } from '@/ntqqapi/wrapper'
+import { RequestUtil } from '@/common/utils/request'
+import { NodeIKernelProfileService, UserDetailSource, ProfileBizType } from '../services'
+import { NodeIKernelProfileListener } from '../listeners'
+import { NTEventDispatch } from '@/common/utils/eventTask'
+import { Time } from 'cosmokit'
+import { Service, Context } from 'cordis'
+import { selfInfo } from '@/common/globalVars'
+
+declare module 'cordis' {
+  interface Context {
+    ntUserApi: NTQQUserApi
+  }
+}
+
+export class NTQQUserApi extends Service {
+  static inject = ['ntFriendApi', 'ntGroupApi']
+
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntUserApi', true)
+  }
+
+  async setQQAvatar(path: string) {
+    return await invoke(
+      'nodeIKernelProfileService/setHeader',
+      [
+        { path },
+        null,
+      ],
+      {
+        timeout: 10 * Time.second, // 10秒不一定够
+      }
+    )
+  }
+
+  async fetchUserDetailInfo(uid: string) {
+    let info: UserDetailInfoListenerArg
+    if (NTEventDispatch.initialised) {
+      type EventService = NodeIKernelProfileService['fetchUserDetailInfo']
+      type EventListener = NodeIKernelProfileListener['onUserDetailInfoChanged']
+      const [_retData, profile] = await NTEventDispatch.CallNormalEvent
+        <EventService, EventListener>
+        (
+          'NodeIKernelProfileService/fetchUserDetailInfo',
+          'NodeIKernelProfileListener/onUserDetailInfoChanged',
+          1,
+          5000,
+          (profile) => profile.uid === uid,
+          'BuddyProfileStore',
+          [uid],
+          UserDetailSource.KSERVER,
+          [ProfileBizType.KALL]
+        )
+      info = profile
+    } else {
+      const result = await invoke<{ info: UserDetailInfoListenerArg }>(
+        'nodeIKernelProfileService/fetchUserDetailInfo',
+        [
+          {
+            callFrom: 'BuddyProfileStore',
+            uid: [uid],
+            source: UserDetailSource.KSERVER,
+            bizList: [ProfileBizType.KALL]
+          },
+          null
+        ],
+        {
+          cbCmd: 'nodeIKernelProfileListener/onUserDetailInfoChanged',
+          afterFirstCmd: false,
+          cmdCB: payload => payload.info.uid === uid,
+        }
+      )
+      info = result.info
+    }
+    const ret: User = {
+      ...info.simpleInfo.coreInfo,
+      ...info.simpleInfo.status,
+      ...info.simpleInfo.vasInfo,
+      ...info.commonExt,
+      ...info.simpleInfo.baseInfo,
+      qqLevel: info.commonExt?.qqLevel,
+      pendantId: ''
+    }
+    return ret
+  }
+
+  async getUserDetailInfo(uid: string, getLevel = false, withBizInfo = true) {
+    if (getBuildVersion() >= 26702) {
+      return this.fetchUserDetailInfo(uid)
+    }
+    if (NTEventDispatch.initialised) {
+      type EventService = NodeIKernelProfileService['getUserDetailInfoWithBizInfo']
+      type EventListener = NodeIKernelProfileListener['onProfileDetailInfoChanged']
+      const [_retData, profile] = await NTEventDispatch.CallNormalEvent
+        <EventService, EventListener>
+        (
+          'NodeIKernelProfileService/getUserDetailInfoWithBizInfo',
+          'NodeIKernelProfileListener/onProfileDetailInfoChanged',
+          2,
+          5000,
+          (profile) => profile.uid === uid,
+          uid,
+          [0]
+        )
+      return profile
+    } else {
+      const result = await invoke<{ info: User }>(
+        'nodeIKernelProfileService/getUserDetailInfoWithBizInfo',
+        [
+          {
+            uid,
+            bizList: [0]
+          },
+          null,
+        ],
+        {
+          cbCmd: 'nodeIKernelProfileListener/onProfileDetailInfoChanged',
+          afterFirstCmd: false,
+          cmdCB: (payload) => payload.info.uid === uid,
+        }
+      )
+      return result.info
+    }
+  }
+
+  async getSkey(): Promise<string> {
+    const clientKeyData = await this.forceFetchClientKey()
+    if (clientKeyData?.result !== 0) {
+      throw new Error('获取clientKey失败')
+    }
+    const url = 'https://ssl.ptlogin2.qq.com/jump?ptlang=1033&clientuin=' + selfInfo.uin
+      + '&clientkey=' + clientKeyData.clientKey
+      + '&u1=https%3A%2F%2Fh5.qzone.qq.com%2Fqqnt%2Fqzoneinpcqq%2Ffriend%3Frefresh%3D0%26clientuin%3D0%26darkMode%3D0&keyindex=' + clientKeyData.keyIndex
+    return (await RequestUtil.HttpsGetCookies(url))?.skey
+  }
+
+  async getCookies(domain: string) {
+    const clientKeyData = await this.forceFetchClientKey()
+    if (clientKeyData?.result !== 0) {
+      throw new Error('获取clientKey失败')
+    }
+    const uin = selfInfo.uin
+    const requestUrl = 'https://ssl.ptlogin2.qq.com/jump?ptlang=1033&clientuin=' + uin + '&clientkey=' + clientKeyData.clientKey + '&u1=https%3A%2F%2F' + domain + '%2F' + uin + '%2Finfocenter&keyindex=19%27'
+    const cookies: { [key: string]: string } = await RequestUtil.HttpsGetCookies(requestUrl)
+    return cookies
+  }
+
+  genBkn(sKey: string) {
+    sKey = sKey || ''
+    let hash = 5381
+
+    for (let i = 0; i < sKey.length; i++) {
+      const code = sKey.charCodeAt(i)
+      hash = hash + (hash << 5) + code
+    }
+
+    return (hash & 0x7fffffff).toString()
+  }
+
+  async like(uid: string, count = 1) {
+    const session = getSession()
+    if (session) {
+      return session.getProfileLikeService().setBuddyProfileLike({
+        friendUid: uid,
+        sourceId: 71,
+        doLikeCount: count,
+        doLikeTollCount: 0
+      })
+    } else {
+      return await invoke(
+        'nodeIKernelProfileLikeService/setBuddyProfileLike',
+        [
+          {
+            doLikeUserInfo: {
+              friendUid: uid,
+              sourceId: 71,
+              doLikeCount: count,
+              doLikeTollCount: 0
+            }
+          },
+          null,
+        ],
+      )
+    }
+  }
+
+  async getUidByUinV1(uin: string) {
+    const session = getSession()
+    // 通用转换开始尝试
+    let uid = (await session?.getUixConvertService().getUid([uin]))?.uidInfo.get(uin)
+    if (!uid) {
+      for (const membersList of this.ctx.ntGroupApi.groupMembers.values()) { //从群友列表转
+        for (const member of membersList.values()) {
+          if (member.uin === uin) {
+            uid = member.uid
+            break
+          }
+        }
+        if (uid) break
+      }
+    }
+    if (!uid) {
+      const unveifyUid = (await this.getUserDetailInfoByUin(uin)).info.uid //特殊转换
+      if (unveifyUid.indexOf('*') === -1) {
+        uid = unveifyUid
+      }
+    }
+    if (!uid) {
+      const friends = await this.ctx.ntFriendApi.getFriends() //从好友列表转
+      uid = friends.find(item => item.uin === uin)?.uid
+    }
+    return uid
+  }
+
+  async getUidByUinV2(uin: string) {
+    const session = getSession()
+    if (session) {
+      let uid = (await session.getGroupService().getUidByUins([uin])).uids.get(uin)
+      if (uid) return uid
+      uid = (await session.getProfileService().getUidByUin('FriendsServiceImpl', [uin])).get(uin)
+      if (uid) return uid
+      uid = (await session.getUixConvertService().getUid([uin])).uidInfo.get(uin)
+      if (uid) return uid
+    } else {
+      let uid = (await invoke('nodeIKernelGroupService/getUidByUins', [{ uin: [uin] }])).uids.get(uin)
+      if (uid) return uid
+      uid = (await invoke('nodeIKernelProfileService/getUidByUin', [{ callFrom: 'FriendsServiceImpl', uin: [uin] }])).get(uin)
+      if (uid) return uid
+      uid = (await invoke('nodeIKernelUixConvertService/getUid', [{ uins: [uin] }])).uidInfo.get(uin)
+      if (uid) return uid
+    }
+    const unveifyUid = (await this.getUserDetailInfoByUinV2(uin)).detail.uid //从QQ Native 特殊转换
+    if (unveifyUid.indexOf('*') == -1) return unveifyUid
+  }
+
+  async getUidByUin(uin: string) {
+    if (getBuildVersion() >= 26702) {
+      return this.getUidByUinV2(uin)
+    }
+    return this.getUidByUinV1(uin)
+  }
+
+  async getUserDetailInfoByUinV2(uin: string) {
+    if (NTEventDispatch.initialised) {
+      return await NTEventDispatch.CallNoListenerEvent
+        <(Uin: string) => Promise<UserDetailInfoByUinV2>>(
+          'NodeIKernelProfileService/getUserDetailInfoByUin',
+          5000,
+          uin
+        )
+    } else {
+      return await invoke<UserDetailInfoByUinV2>(
+        'nodeIKernelProfileService/getUserDetailInfoByUin',
+        [
+          { uin },
+          null,
+        ],
+      )
+    }
+  }
+
+  async getUserDetailInfoByUin(uin: string) {
+    return NTEventDispatch.CallNoListenerEvent
+      <(Uin: string) => Promise<UserDetailInfoByUin>>(
+        'NodeIKernelProfileService/getUserDetailInfoByUin',
+        5000,
+        uin
+      )
+  }
+
+  async getUinByUidV1(uid: string) {
+    const ret = await NTEventDispatch.CallNoListenerEvent
+      <(Uin: string[]) => Promise<{ uinInfo: Map<string, string> }>>(
+        'NodeIKernelUixConvertService/getUin',
+        5000,
+        [uid]
+      )
+    let uin = ret.uinInfo.get(uid)
+    if (!uin) {
+      uin = (await this.getUserDetailInfo(uid)).uin //从QQ Native 转换
+    }
+    return uin
+  }
+
+  async getUinByUidV2(uid: string) {
+    const session = getSession()
+    if (session) {
+      let uin = (await session.getGroupService().getUinByUids([uid])).uins.get(uid)
+      if (uin) return uin
+      uin = (await session.getProfileService().getUinByUid('FriendsServiceImpl', [uid])).get(uid)
+      if (uin) return uin
+      uin = (await session.getUixConvertService().getUin([uid])).uinInfo.get(uid)
+      if (uin) return uin
+    } else {
+      let uin = (await invoke('nodeIKernelGroupService/getUinByUids', [{ uid: [uid] }])).uins.get(uid)
+      if (uin) return uin
+      uin = (await invoke('nodeIKernelProfileService/getUinByUid', [{ callFrom: 'FriendsServiceImpl', uid: [uid] }])).get(uid)
+      if (uin) return uin
+      uin = (await invoke('nodeIKernelUixConvertService/getUin', [{ uids: [uid] }])).uinInfo.get(uid)
+      if (uin) return uin
+    }
+    let uin = (await this.ctx.ntFriendApi.getBuddyIdMap(true)).get(uid)
+    if (uin) return uin
+    uin = (await this.getUserDetailInfo(uid)).uin //从QQ Native 转换
+    return uin
+  }
+
+  async getUinByUid(uid: string) {
+    if (getBuildVersion() >= 26702) {
+      return this.getUinByUidV2(uid)
+    }
+    return this.getUinByUidV1(uid)
+  }
+
+  async forceFetchClientKey() {
+    const session = getSession()
+    if (session) {
+      return await session.getTicketService().forceFetchClientKey('')
+    } else {
+      return await invoke('nodeIKernelTicketService/forceFetchClientKey', [{ domain: '' }, null])
+    }
+  }
+
+  async getSelfNick(refresh = false) {
+    if ((refresh || !selfInfo.nick) && selfInfo.uid) {
+      const userInfo = await this.getUserDetailInfo(selfInfo.uid)
+      if (userInfo) {
+        Object.assign(selfInfo, { nick: userInfo.nick })
+        return userInfo.nick
+      }
+    }
+    return selfInfo.nick
+  }
+
+  async setSelfStatus(status: number, extStatus: number, batteryStatus: number) {
+    return await invoke('nodeIKernelMsgService/setStatus', [{
+      statusReq: {
+        status,
+        extStatus,
+        batteryStatus,
+      }
+    }, null])
+  }
+}

src/ntqqapi/api/webapi.ts

@@ -0,0 +1,309 @@
+import { RequestUtil } from '@/common/utils/request'
+import { Service, Context } from 'cordis'
+import { Dict } from 'cosmokit'
+
+declare module 'cordis' {
+  interface Context {
+    ntWebApi: NTQQWebApi
+  }
+}
+
+export enum WebHonorType {
+  ALL = 'all',
+  TALKACTIVE = 'talkative',
+  PERFROMER = 'performer',
+  LEGEND = 'legend',
+  STORONGE_NEWBI = 'strong_newbie',
+  EMOTION = 'emotion'
+}
+
+export interface WebApiGroupMember {
+  uin: number
+  role: number
+  g: number
+  join_time: number
+  last_speak_time: number
+  lv: {
+    point: number
+    level: number
+  }
+  card: string
+  tags: string
+  flag: number
+  nick: string
+  qage: number
+  rm: number
+}
+
+interface WebApiGroupMemberRet {
+  ec: number
+  errcode: number
+  em: string
+  cache: number
+  adm_num: number
+  levelname: any
+  mems: WebApiGroupMember[]
+  count: number
+  svr_time: number
+  max_count: number
+  search_count: number
+  extmode: number
+}
+
+interface GroupEssenceMsg {
+  group_code: string
+  msg_seq: number
+  msg_random: number
+  sender_uin: string
+  sender_nick: string
+  sender_time: number
+  add_digest_uin: string
+  add_digest_nick: string
+  add_digest_time: number
+  msg_content: any[]
+  can_be_removed: true
+}
+
+export interface GroupEssenceMsgRet {
+  retcode: number
+  retmsg: string
+  data: {
+    msg_list: GroupEssenceMsg[]
+    is_end: boolean
+    group_role: number
+    config_page_url: string
+  }
+}
+
+interface SetGroupNoticeParams {
+  groupCode: string
+  content: string
+  pinned: number
+  type: number
+  isShowEditCard: number
+  tipWindowType: number
+  confirmRequired: number
+  picId: string
+  imgWidth?: number
+  imgHeight?: number
+}
+
+interface SetGroupNoticeRet {
+  ec: number
+  em: string
+  id: number
+  ltsm: number
+  new_fid: string
+  read_only: number
+  role: number
+  srv_code: number
+}
+
+export class NTQQWebApi extends Service {
+  static inject = ['ntUserApi']
+
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntWebApi', true)
+  }
+
+  async getGroupMembers(GroupCode: string, cached: boolean = true): Promise<WebApiGroupMember[]> {
+    const memberData: Array<WebApiGroupMember> = new Array<WebApiGroupMember>()
+    const cookieObject = await this.ctx.ntUserApi.getCookies('qun.qq.com')
+    const cookieStr = this.cookieToString(cookieObject)
+    const retList: Promise<WebApiGroupMemberRet>[] = []
+    const params = new URLSearchParams({
+      st: '0',
+      end: '40',
+      sort: '1',
+      gc: GroupCode,
+      bkn: this.genBkn(cookieObject.skey)
+    })
+    const fastRet = await RequestUtil.HttpGetJson<WebApiGroupMemberRet>(`https://qun.qq.com/cgi-bin/qun_mgr/search_group_members?${params}`, 'POST', '', { 'Cookie': cookieStr })
+    if (!fastRet?.count || fastRet?.errcode !== 0 || !fastRet?.mems) {
+      return []
+    } else {
+      for (const member of fastRet.mems) {
+        memberData.push(member)
+      }
+    }
+    const pageNum = Math.ceil(fastRet.count / 40)
+    //遍历批量请求
+    for (let i = 2; i <= pageNum; i++) {
+      params.set('st', String((i - 1) * 40))
+      params.set('end', String(i * 40))
+      const ret = RequestUtil.HttpGetJson<WebApiGroupMemberRet>(`https://qun.qq.com/cgi-bin/qun_mgr/search_group_members?${params}`, 'POST', '', { 'Cookie': cookieStr })
+      retList.push(ret)
+    }
+    //批量等待
+    for (let i = 1; i <= pageNum; i++) {
+      const ret = await (retList[i])
+      if (!ret?.count || ret?.errcode !== 0 || !ret?.mems) {
+        continue
+      }
+      for (const member of ret.mems) {
+        memberData.push(member)
+      }
+    }
+    return memberData
+  }
+
+  genBkn(sKey: string) {
+    sKey = sKey || ''
+    let hash = 5381
+    for (let i = 0; i < sKey.length; i++) {
+      const code = sKey.charCodeAt(i)
+      hash = hash + (hash << 5) + code
+    }
+    return (hash & 0x7FFFFFFF).toString()
+  }
+
+  //实现未缓存 考虑2h缓存
+  async getGroupHonorInfo(groupCode: string, getType: WebHonorType) {
+    const getDataInternal = async (Internal_groupCode: string, Internal_type: number) => {
+      let url = 'https://qun.qq.com/interactive/honorlist?gc=' + Internal_groupCode + '&type=' + Internal_type.toString()
+      let res = ''
+      let resJson
+      try {
+        res = await RequestUtil.HttpGetText(url, 'GET', '', { 'Cookie': cookieStr })
+        const match = res.match(/window\.__INITIAL_STATE__=(.*?);/)
+        if (match) {
+          resJson = JSON.parse(match[1].trim())
+        }
+        if (Internal_type === 1) {
+          return resJson?.talkativeList
+        } else {
+          return resJson?.actorList
+        }
+      } catch (e) {
+        this.ctx.logger.error('获取当前群荣耀失败', url, e)
+      }
+      return undefined
+    }
+
+    let HonorInfo: any = { group_id: groupCode }
+    const cookieObject = await this.ctx.ntUserApi.getCookies('qun.qq.com')
+    const cookieStr = this.cookieToString(cookieObject)
+
+    if (getType === WebHonorType.TALKACTIVE || getType === WebHonorType.ALL) {
+      try {
+        let RetInternal = await getDataInternal(groupCode, 1)
+        if (!RetInternal) {
+          throw new Error('获取龙王信息失败')
+        }
+        HonorInfo.current_talkative = {
+          user_id: RetInternal[0]?.uin,
+          avatar: RetInternal[0]?.avatar,
+          nickname: RetInternal[0]?.name,
+          day_count: 0,
+          description: RetInternal[0]?.desc
+        }
+        HonorInfo.talkative_list = [];
+        for (const talkative_ele of RetInternal) {
+          HonorInfo.talkative_list.push({
+            user_id: talkative_ele?.uin,
+            avatar: talkative_ele?.avatar,
+            description: talkative_ele?.desc,
+            day_count: 0,
+            nickname: talkative_ele?.name
+          })
+        }
+      } catch (e) {
+        this.ctx.logger.error(e)
+      }
+    }
+    if (getType === WebHonorType.PERFROMER || getType === WebHonorType.ALL) {
+      try {
+        let RetInternal = await getDataInternal(groupCode, 2)
+        if (!RetInternal) {
+          throw new Error('获取群聊之火失败')
+        }
+        HonorInfo.performer_list = [];
+        for (const performer_ele of RetInternal) {
+          HonorInfo.performer_list.push({
+            user_id: performer_ele?.uin,
+            nickname: performer_ele?.name,
+            avatar: performer_ele?.avatar,
+            description: performer_ele?.desc
+          })
+        }
+      } catch (e) {
+        this.ctx.logger.error(e)
+      }
+    }
+    if (getType === WebHonorType.PERFROMER || getType === WebHonorType.ALL) {
+      try {
+        let RetInternal = await getDataInternal(groupCode, 3)
+        if (!RetInternal) {
+          throw new Error('获取群聊炽焰失败')
+        }
+        HonorInfo.legend_list = []
+        for (const legend_ele of RetInternal) {
+          HonorInfo.legend_list.push({
+            user_id: legend_ele?.uin,
+            nickname: legend_ele?.name,
+            avatar: legend_ele?.avatar,
+            desc: legend_ele?.description
+          })
+        }
+      } catch (e) {
+        this.ctx.logger.error('获取群聊炽焰失败', e)
+      }
+    }
+    if (getType === WebHonorType.EMOTION || getType === WebHonorType.ALL) {
+      try {
+        let RetInternal = await getDataInternal(groupCode, 6)
+        if (!RetInternal) {
+          throw new Error('获取快乐源泉失败')
+        }
+        HonorInfo.emotion_list = []
+        for (const emotion_ele of RetInternal) {
+          HonorInfo.emotion_list.push({
+            user_id: emotion_ele?.uin,
+            nickname: emotion_ele?.name,
+            avatar: emotion_ele?.avatar,
+            desc: emotion_ele?.description
+          })
+        }
+      } catch (e) {
+        this.ctx.logger.error('获取快乐源泉失败', e)
+      }
+    }
+    //冒尖小春笋好像已经被tx扬了
+    if (getType === WebHonorType.EMOTION || getType === WebHonorType.ALL) {
+      HonorInfo.strong_newbie_list = []
+    }
+    return HonorInfo
+  }
+
+  async setGroupNotice(params: SetGroupNoticeParams): Promise<SetGroupNoticeRet> {
+    const cookieObject = await this.ctx.ntUserApi.getCookies('qun.qq.com')
+    const settings = JSON.stringify({
+      is_show_edit_card: params.isShowEditCard,
+      tip_window_type: params.tipWindowType,
+      confirm_required: params.confirmRequired
+    })
+
+    return await RequestUtil.HttpGetJson<SetGroupNoticeRet>(
+      `https://web.qun.qq.com/cgi-bin/announce/add_qun_notice?${new URLSearchParams({
+        bkn: this.genBkn(cookieObject.skey),
+        qid: params.groupCode,
+        text: params.content,
+        pinned: params.pinned.toString(),
+        type: params.type.toString(),
+        settings: settings,
+        ...(params.picId !== '' && {
+          pic: params.picId,
+          imgWidth: params.imgWidth?.toString(),
+          imgHeight: params.imgHeight?.toString(),
+        })
+      })}`,
+      'POST',
+      '',
+      { 'Cookie': this.cookieToString(cookieObject) }
+    )
+  }
+
+  private cookieToString(cookieObject: Dict) {
+    return Object.entries(cookieObject).map(([key, value]) => `${key}=${value}`).join('; ')
+  }
+}

src/ntqqapi/api/window.ts

@@ -0,0 +1,64 @@
+import { invoke, NTClass, NTMethod } from '../ntcall'
+import { GeneralCallResult } from '../services'
+import { ReceiveCmd } from '../hook'
+import { BrowserWindow } from 'electron'
+import { Service, Context } from 'cordis'
+
+declare module 'cordis' {
+  interface Context {
+    ntWindowApi: NTQQWindowApi
+  }
+}
+
+export interface NTQQWindow {
+  windowName: string
+  windowUrlHash: string
+}
+
+export namespace NTQQWindows {
+  export const GroupHomeWorkWindow: NTQQWindow = {
+    windowName: 'GroupHomeWorkWindow',
+    windowUrlHash: '#/group-home-work',
+  }
+  export const GroupNotifyFilterWindow: NTQQWindow = {
+    windowName: 'GroupNotifyFilterWindow',
+    windowUrlHash: '#/group-notify-filter',
+  }
+  export const GroupEssenceWindow: NTQQWindow = {
+    windowName: 'GroupEssenceWindow',
+    windowUrlHash: '#/group-essence',
+  }
+}
+
+export class NTQQWindowApi extends Service {
+  constructor(protected ctx: Context) {
+    super(ctx, 'ntWindowApi', true)
+  }
+
+  // 打开窗口并获取对应的下发事件
+  async openWindow<R = GeneralCallResult>(
+    ntQQWindow: NTQQWindow,
+    args: any[],
+    cbCmd: ReceiveCmd | undefined,
+    autoCloseSeconds: number = 2,
+  ) {
+    const result = await invoke<R>(
+      NTMethod.OPEN_EXTRA_WINDOW,
+      [ntQQWindow.windowName, ...args],
+      {
+        className: NTClass.WINDOW_API,
+        cbCmd,
+        afterFirstCmd: false,
+      }
+    )
+    setTimeout(() => {
+      for (const w of BrowserWindow.getAllWindows()) {
+        // log("close window", w.webContents.getURL())
+        if (w.webContents.getURL().indexOf(ntQQWindow.windowUrlHash) != -1) {
+          w.close()
+        }
+      }
+    }, autoCloseSeconds * 1000)
+    return result
+  }
+}

src/ntqqapi/core.ts

@@ -0,0 +1,239 @@
+import fs from 'node:fs'
+import { Service, Context } from 'cordis'
+import { registerCallHook, registerReceiveHook, ReceiveCmdS } from './hook'
+import { MessageUnique } from '../common/utils/messageUnique'
+import { NTEventDispatch } from '../common/utils/eventTask'
+import { wrapperConstructor, getSession } from './wrapper'
+import { Config as LLOBConfig } from '../common/types'
+import { llonebotError } from '../common/globalVars'
+import { isNumeric } from '../common/utils/misc'
+import { NTMethod } from './ntcall'
+import {
+  RawMessage,
+  GroupNotify,
+  FriendRequestNotify,
+  FriendRequest,
+  GroupMember,
+  CategoryFriend,
+  SimpleInfo,
+  User,
+  ChatType
+} from './types'
+import { selfInfo } from '../common/globalVars'
+import { version } from '../version'
+
+declare module 'cordis' {
+  interface Context {
+    app: Core
+  }
+  interface Events {
+    'nt/message-created': (input: RawMessage[]) => void
+    'nt/message-deleted': (input: RawMessage[]) => void
+    'nt/message-sent': (input: RawMessage[]) => void
+    'nt/group-notify': (input: GroupNotify[]) => void
+    'nt/friend-request': (input: FriendRequest[]) => void
+    'nt/group-member-info-updated': (input: { groupCode: string; members: GroupMember[] }) => void
+  }
+}
+
+class Core extends Service {
+  static inject = ['ntMsgApi', 'ntFriendApi', 'ntGroupApi']
+
+  constructor(protected ctx: Context, public config: Core.Config) {
+    super(ctx, 'app', true)
+  }
+
+  public start() {
+    llonebotError.otherError = ''
+    const WrapperSession = getSession()
+    if (WrapperSession) {
+      NTEventDispatch.init({ ListenerMap: wrapperConstructor, WrapperSession })
+    }
+    MessageUnique.init(selfInfo.uin)
+    this.registerListener()
+    this.ctx.logger.info(`LLOneBot/${version}`)
+  }
+
+  private registerListener() {
+    registerReceiveHook<{
+      data: CategoryFriend[]
+    }>(ReceiveCmdS.FRIENDS, (payload) => {
+      type V2data = { userSimpleInfos: Map<string, SimpleInfo> }
+      let friendList: User[] = [];
+      if ((payload as any).userSimpleInfos) {
+        friendList = Object.values((payload as unknown as V2data).userSimpleInfos).map((v: SimpleInfo) => {
+          return {
+            ...v.coreInfo,
+          }
+        })
+      } else {
+        for (const fData of payload.data) {
+          friendList.push(...fData.buddyList)
+        }
+      }
+      this.ctx.logger.info('好友列表变动', friendList.length)
+      for (const friend of friendList) {
+        this.ctx.ntMsgApi.activateChat({ peerUid: friend.uid, chatType: ChatType.friend })
+      }
+    })
+
+    // 自动清理新消息文件
+    registerReceiveHook<{ msgList: Array<RawMessage> }>([ReceiveCmdS.NEW_MSG, ReceiveCmdS.NEW_ACTIVE_MSG], (payload) => {
+      if (!this.config.autoDeleteFile) {
+        return
+      }
+      for (const message of payload.msgList) {
+        for (const msgElement of message.elements) {
+          setTimeout(() => {
+            const picPath = msgElement.picElement?.sourcePath
+            const picThumbPath = [...msgElement.picElement?.thumbPath.values()]
+            const pttPath = msgElement.pttElement?.filePath
+            const filePath = msgElement.fileElement?.filePath
+            const videoPath = msgElement.videoElement?.filePath
+            const videoThumbPath: string[] = [...msgElement.videoElement.thumbPath?.values()!]
+            const pathList = [picPath, ...picThumbPath, pttPath, filePath, videoPath, ...videoThumbPath]
+            if (msgElement.picElement) {
+              pathList.push(...Object.values(msgElement.picElement.thumbPath))
+            }
+            for (const path of pathList) {
+              if (path) {
+                fs.unlink(picPath, () => {
+                  this.ctx.logger.info('删除文件成功', path)
+                })
+              }
+            }
+          }, this.config.autoDeleteFileSecond! * 1000)
+        }
+      }
+    })
+
+    registerReceiveHook<{ info: { status: number } }>(ReceiveCmdS.SELF_STATUS, (info) => {
+      Object.assign(selfInfo, { online: info.info.status !== 20 })
+    })
+
+    const activatedPeerUids: string[] = []
+    registerReceiveHook<{
+      changedRecentContactLists: {
+        listType: number
+        sortedContactList: string[]
+        changedList: {
+          id: string // peerUid
+          chatType: ChatType
+        }[]
+      }[]
+    }>(ReceiveCmdS.RECENT_CONTACT, async (payload) => {
+      for (const recentContact of payload.changedRecentContactLists) {
+        for (const changedContact of recentContact.changedList) {
+          if (activatedPeerUids.includes(changedContact.id)) continue
+          activatedPeerUids.push(changedContact.id)
+          const peer = { peerUid: changedContact.id, chatType: changedContact.chatType }
+          if (changedContact.chatType === ChatType.temp) {
+            this.ctx.ntMsgApi.activateChatAndGetHistory(peer).then(() => {
+              this.ctx.ntMsgApi.getMsgHistory(peer, '', 20).then(({ msgList }) => {
+                const lastTempMsg = msgList.at(-1)
+                if (Date.now() / 1000 - parseInt(lastTempMsg?.msgTime!) < 5) {
+                  this.ctx.parallel('nt/message-created', [lastTempMsg!])
+                }
+              })
+            })
+          }
+          else {
+            this.ctx.ntMsgApi.activateChat(peer)
+          }
+        }
+      }
+    })
+
+    registerCallHook(NTMethod.DELETE_ACTIVE_CHAT, async (payload) => {
+      const peerUid = payload[0] as string
+      this.ctx.logger.info('激活的聊天窗口被删除，准备重新激活', peerUid)
+      let chatType = ChatType.friend
+      if (isNumeric(peerUid)) {
+        chatType = ChatType.group
+      }
+      else if (!(await this.ctx.ntFriendApi.isBuddy(peerUid))) {
+        chatType = ChatType.temp
+      }
+      const peer = { peerUid, chatType }
+      await this.ctx.sleep(1000)
+      this.ctx.ntMsgApi.activateChat(peer).then((r) => {
+        this.ctx.logger.info('重新激活聊天窗口', peer, { result: r.result, errMsg: r.errMsg })
+      })
+    })
+
+    registerReceiveHook<{
+      groupCode: string
+      dataSource: number
+      members: Set<GroupMember>
+    }>(ReceiveCmdS.GROUP_MEMBER_INFO_UPDATE, async (payload) => {
+      const groupCode = payload.groupCode
+      const members = Array.from(payload.members.values())
+      this.ctx.parallel('nt/group-member-info-updated', { groupCode, members })
+    })
+
+    registerReceiveHook<{ msgList: RawMessage[] }>([ReceiveCmdS.NEW_MSG, ReceiveCmdS.NEW_ACTIVE_MSG], payload => {
+      this.ctx.parallel('nt/message-created', payload.msgList)
+    })
+
+    const recallMsgIds: string[] = [] // 避免重复上报
+    registerReceiveHook<{ msgList: RawMessage[] }>([ReceiveCmdS.UPDATE_MSG], payload => {
+      const list = payload.msgList.filter(v => {
+        if (recallMsgIds.includes(v.msgId)) {
+          return false
+        }
+        recallMsgIds.push(v.msgId)
+        return true
+      })
+      this.ctx.parallel('nt/message-deleted', list)
+    })
+
+    registerReceiveHook<{ msgRecord: RawMessage }>(ReceiveCmdS.SELF_SEND_MSG, payload => {
+      const { msgId, chatType, peerUid } = payload.msgRecord
+      const peer = {
+        chatType,
+        peerUid
+      }
+      MessageUnique.createMsg(peer, msgId)
+      if (!this.config.reportSelfMessage) {
+        return
+      }
+      this.ctx.parallel('nt/message-sent', [payload.msgRecord])
+    })
+
+    const groupNotifyFlags: string[] = []
+    registerReceiveHook<{
+      doubt: boolean
+      oldestUnreadSeq: string
+      unreadCount: number
+    }>(ReceiveCmdS.UNREAD_GROUP_NOTIFY, async (payload) => {
+      if (payload.unreadCount) {
+        let notifies: GroupNotify[]
+        try {
+          notifies = (await this.ctx.ntGroupApi.getSingleScreenNotifies(14)).slice(0, payload.unreadCount)
+        } catch (e) {
+          return
+        }
+        const list = notifies.filter(v => {
+          const flag = v.group.groupCode + '|' + v.seq + '|' + v.type
+          if (groupNotifyFlags.includes(flag)) {
+            return false
+          }
+          groupNotifyFlags.push(flag)
+          return true
+        })
+        this.ctx.parallel('nt/group-notify', list)
+      }
+    })
+
+    registerReceiveHook<FriendRequestNotify>(ReceiveCmdS.FRIEND_REQUEST, payload => {
+      this.ctx.parallel('nt/friend-request', payload.data.buddyReqs)
+    })
+  }
+}
+
+namespace Core {
+  export interface Config extends LLOBConfig {
+  }
+}
+
+export default Core

src/ntqqapi/entities.ts

@@ -0,0 +1,367 @@
+import ffmpeg from 'fluent-ffmpeg'
+import faceConfig from './helper/face_config.json'
+import {
+  AtType,
+  ElementType,
+  FaceIndex,
+  PicType,
+  SendArkElement,
+  SendFaceElement,
+  SendFileElement,
+  SendMarketFaceElement,
+  SendPicElement,
+  SendPttElement,
+  SendReplyElement,
+  SendTextElement,
+  SendVideoElement,
+} from './types'
+import { stat, writeFile, copyFile, unlink } from 'node:fs/promises'
+import { calculateFileMD5, isGIF } from '../common/utils/file'
+import { defaultVideoThumb, getVideoInfo } from '../common/utils/video'
+import { encodeSilk } from '../common/utils/audio'
+import { Context } from 'cordis'
+import { isNullable } from 'cosmokit'
+
+//export const mFaceCache = new Map<string, string>() // emojiId -> faceName
+
+export namespace SendElementEntities {
+  export function text(content: string): SendTextElement {
+    return {
+      elementType: ElementType.TEXT,
+      elementId: '',
+      textElement: {
+        content,
+        atType: AtType.notAt,
+        atUid: '',
+        atTinyId: '',
+        atNtUid: '',
+      },
+    }
+  }
+
+  export function at(atUid: string, atNtUid: string, atType: AtType, display: string): SendTextElement {
+    return {
+      elementType: ElementType.TEXT,
+      elementId: '',
+      textElement: {
+        content: display,
+        atType,
+        atUid,
+        atTinyId: '',
+        atNtUid,
+      },
+    }
+  }
+
+  export function reply(msgSeq: string, msgId: string, senderUin: string, senderUinStr: string): SendReplyElement {
+    return {
+      elementType: ElementType.REPLY,
+      elementId: '',
+      replyElement: {
+        replayMsgSeq: msgSeq, // raw.msgSeq
+        replayMsgId: msgId, // raw.msgId
+        senderUin: senderUin,
+        senderUinStr: senderUinStr,
+      },
+    }
+  }
+
+  export async function pic(ctx: Context, picPath: string, summary: string = '', subType: 0 | 1 = 0): Promise<SendPicElement> {
+    const { md5, fileName, path, fileSize } = await ctx.ntFileApi.uploadFile(picPath, ElementType.PIC, subType)
+    if (fileSize === 0) {
+      throw '文件异常，大小为0'
+    }
+    const maxMB = 30;
+    if (fileSize > 1024 * 1024 * 30) {
+      throw `图片过大，最大支持${maxMB}MB，当前文件大小${fileSize}B`
+    }
+    const imageSize = await ctx.ntFileApi.getImageSize(picPath)
+    const picElement = {
+      md5HexStr: md5,
+      fileSize: fileSize.toString(),
+      picWidth: imageSize.width,
+      picHeight: imageSize.height,
+      fileName: fileName,
+      sourcePath: path,
+      original: true,
+      picType: isGIF(picPath) ? PicType.gif : PicType.jpg,
+      picSubType: subType,
+      fileUuid: '',
+      fileSubId: '',
+      thumbFileSize: 0,
+      summary,
+    }
+    ctx.logger.info('图片信息', picElement)
+    return {
+      elementType: ElementType.PIC,
+      elementId: '',
+      picElement,
+    }
+  }
+
+  export async function file(ctx: Context, filePath: string, fileName: string = '', folderId: string = ''): Promise<SendFileElement> {
+    const { fileName: _fileName, path, fileSize } = await ctx.ntFileApi.uploadFile(filePath, ElementType.FILE)
+    if (fileSize === 0) {
+      throw '文件异常，大小为 0'
+    }
+    const element: SendFileElement = {
+      elementType: ElementType.FILE,
+      elementId: '',
+      fileElement: {
+        fileName: fileName || _fileName,
+        folderId: folderId,
+        filePath: path!,
+        fileSize: fileSize.toString(),
+      },
+    }
+    return element
+  }
+
+  export async function video(ctx: Context, filePath: string, fileName: string = '', diyThumbPath: string = ''): Promise<SendVideoElement> {
+    try {
+      await stat(filePath)
+    } catch (e) {
+      throw `文件${filePath}异常，不存在`
+    }
+    ctx.logger.info('复制视频到QQ目录', filePath)
+    let { fileName: _fileName, path, fileSize, md5 } = await ctx.ntFileApi.uploadFile(filePath, ElementType.VIDEO)
+
+    ctx.logger.info('复制视频到QQ目录完成', path)
+    if (fileSize === 0) {
+      throw '文件异常，大小为0'
+    }
+    const maxMB = 100;
+    if (fileSize > 1024 * 1024 * maxMB) {
+      throw `视频过大，最大支持${maxMB}MB，当前文件大小${fileSize}B`
+    }
+    const pathLib = require('path')
+    let thumbDir = path.replace(`${pathLib.sep}Ori${pathLib.sep}`, `${pathLib.sep}Thumb${pathLib.sep}`)
+    thumbDir = pathLib.dirname(thumbDir)
+    // log("thumb 目录", thumb)
+    let videoInfo = {
+      width: 1920,
+      height: 1080,
+      time: 15,
+      format: 'mp4',
+      size: fileSize,
+      filePath,
+    }
+    try {
+      videoInfo = await getVideoInfo(path)
+      ctx.logger.info('视频信息', videoInfo)
+    } catch (e) {
+      ctx.logger.info('获取视频信息失败', e)
+    }
+    const createThumb = new Promise<string>((resolve, reject) => {
+      const thumbFileName = `${md5}_0.png`
+      const thumbPath = pathLib.join(thumbDir, thumbFileName)
+      ctx.logger.info('开始生成视频缩略图', filePath)
+      let completed = false
+
+      function useDefaultThumb() {
+        if (completed) return
+        ctx.logger.info('获取视频封面失败，使用默认封面')
+        writeFile(thumbPath, defaultVideoThumb)
+          .then(() => {
+            resolve(thumbPath)
+          })
+          .catch(reject)
+      }
+
+      setTimeout(useDefaultThumb, 5000)
+      ffmpeg(filePath)
+        .on('error', (err) => {
+          if (diyThumbPath) {
+            copyFile(diyThumbPath, thumbPath)
+              .then(() => {
+                completed = true
+                resolve(thumbPath)
+              })
+              .catch(reject)
+          } else {
+            useDefaultThumb()
+          }
+        })
+        .screenshots({
+          timestamps: [0],
+          filename: thumbFileName,
+          folder: thumbDir,
+          size: videoInfo.width + 'x' + videoInfo.height,
+        })
+        .on('end', () => {
+          ctx.logger.info('生成视频缩略图', thumbPath)
+          completed = true
+          resolve(thumbPath)
+        })
+    })
+    let thumbPath = new Map()
+    const _thumbPath = await createThumb
+    ctx.logger.info('生成视频缩略图', _thumbPath)
+    const thumbSize = (await stat(_thumbPath)).size
+    // log("生成缩略图", _thumbPath)
+    thumbPath.set(0, _thumbPath)
+    const thumbMd5 = await calculateFileMD5(_thumbPath)
+    let element: SendVideoElement = {
+      elementType: ElementType.VIDEO,
+      elementId: '',
+      videoElement: {
+        fileName: fileName || _fileName,
+        filePath: path,
+        videoMd5: md5,
+        thumbMd5,
+        fileTime: videoInfo.time,
+        thumbPath: thumbPath,
+        thumbSize,
+        thumbWidth: videoInfo.width,
+        thumbHeight: videoInfo.height,
+        fileSize: '' + fileSize,
+        // fileUuid: "",
+        // transferStatus: 0,
+        // progress: 0,
+        // invalidState: 0,
+        // fileSubId: "",
+        // fileBizId: null,
+        // originVideoMd5: "",
+        // fileFormat: 2,
+        // import_rich_media_context: null,
+        // sourceVideoCodecFormat: 2
+      },
+    }
+    ctx.logger.info('videoElement', element)
+    return element
+  }
+
+  export async function ptt(ctx: Context, pttPath: string): Promise<SendPttElement> {
+    const { converted, path: silkPath, duration } = await encodeSilk(ctx, pttPath)
+    if (!silkPath) {
+      throw '语音转换失败, 请检查语音文件是否正常'
+    }
+    // log("生成语音", silkPath, duration);
+    const { md5, fileName, path, fileSize } = await ctx.ntFileApi.uploadFile(silkPath, ElementType.PTT)
+    if (fileSize === 0) {
+      throw '文件异常，大小为0'
+    }
+    if (converted) {
+      unlink(silkPath)
+    }
+    return {
+      elementType: ElementType.PTT,
+      elementId: '',
+      pttElement: {
+        fileName: fileName,
+        filePath: path,
+        md5HexStr: md5,
+        fileSize: fileSize,
+        // duration: Math.max(1, Math.round(fileSize / 1024 / 3)), // 一秒钟大概是3kb大小, 小于1秒的按1秒算
+        duration: duration,
+        formatType: 1,
+        voiceType: 1,
+        voiceChangeType: 0,
+        canConvert2Text: true,
+        waveAmplitudes: [0, 18, 9, 23, 16, 17, 16, 15, 44, 17, 24, 20, 14, 15, 17],
+        fileSubId: '',
+        playState: 1,
+        autoConvertText: 0,
+      },
+    }
+  }
+
+  export function face(faceId: number): SendFaceElement {
+    // 从face_config.json中获取表情名称
+    const sysFaces = faceConfig.sysface
+    const emojiFaces = faceConfig.emoji
+    const face = sysFaces.find((face) => face.QSid === faceId.toString())
+    faceId = parseInt(faceId.toString())
+    // let faceType = parseInt(faceId.toString().substring(0, 1));
+    let faceType = 1
+    if (faceId >= 222) {
+      faceType = 2
+    }
+    if (face?.AniStickerType) {
+      faceType = 3;
+    }
+    return {
+      elementType: ElementType.FACE,
+      elementId: '',
+      faceElement: {
+        faceIndex: faceId,
+        faceType,
+        faceText: face?.QDes,
+        stickerId: face?.AniStickerId,
+        stickerType: face?.AniStickerType,
+        packId: face?.AniStickerPackId,
+        sourceType: 1,
+      },
+    }
+  }
+
+  export function mface(emojiPackageId: number, emojiId: string, key: string, summary?: string): SendMarketFaceElement {
+    return {
+      elementType: ElementType.MFACE,
+      marketFaceElement: {
+        imageWidth: 300,
+        imageHeight: 300,
+        emojiPackageId,
+        emojiId,
+        key,
+        faceName: summary || '[商城表情]',
+      },
+    }
+  }
+
+  export function dice(resultId?: string | number): SendFaceElement {
+    // 实际测试并不能控制结果
+    // 随机1到6
+    if (isNullable(resultId)) resultId = Math.floor(Math.random() * 6) + 1
+    return {
+      elementType: ElementType.FACE,
+      elementId: '',
+      faceElement: {
+        faceIndex: FaceIndex.dice,
+        faceType: 3,
+        faceText: '[骰子]',
+        packId: '1',
+        stickerId: '33',
+        sourceType: 1,
+        stickerType: 2,
+        resultId: resultId.toString(),
+        surpriseId: '',
+        // "randomType": 1,
+      },
+    }
+  }
+
+  // 猜拳(石头剪刀布)表情
+  export function rps(resultId?: string | number): SendFaceElement {
+    // 实际测试并不能控制结果
+    if (isNullable(resultId)) resultId = Math.floor(Math.random() * 3) + 1
+    return {
+      elementType: ElementType.FACE,
+      elementId: '',
+      faceElement: {
+        faceIndex: FaceIndex.RPS,
+        faceText: '[包剪锤]',
+        faceType: 3,
+        packId: '1',
+        stickerId: '34',
+        sourceType: 1,
+        stickerType: 2,
+        resultId: resultId.toString(),
+        surpriseId: '',
+        // "randomType": 1,
+      },
+    }
+  }
+
+  export function ark(data: string): SendArkElement {
+    return {
+      elementType: ElementType.ARK,
+      elementId: '',
+      arkElement: {
+        bytesData: data,
+        linkInfo: null,
+        subElementType: null,
+      },
+    }
+  }
+}

src/ntqqapi/helper/rkey.ts

@@ -0,0 +1,60 @@
+import { Context } from "cordis"
+
+interface ServerRkeyData {
+  group_rkey: string
+  private_rkey: string
+  expired_time: number
+}
+
+export class RkeyManager {
+  private serverUrl: string = ''
+  private rkeyData: ServerRkeyData = {
+    group_rkey: '',
+    private_rkey: '',
+    expired_time: 0
+  }
+
+  constructor(protected ctx: Context, serverUrl: string) {
+    this.serverUrl = serverUrl
+  }
+
+  async getRkey() {
+    if (this.isExpired()) {
+      try {
+        await this.refreshRkey()
+      } catch (e) {
+        this.ctx.logger.error('获取rkey失败', e)
+      }
+    }
+    return this.rkeyData
+  }
+
+  isExpired(): boolean {
+    const now = new Date().getTime() / 1000
+    // console.log(`now: ${now}, expired_time: ${this.rkeyData.expired_time}`)
+    return now > this.rkeyData.expired_time
+  }
+
+  async refreshRkey(): Promise<any> {
+    //刷新rkey
+    this.rkeyData = await this.fetchServerRkey()
+  }
+
+  async fetchServerRkey() {
+    return new Promise<ServerRkeyData>((resolve, reject) => {
+      fetch(this.serverUrl)
+        .then(response => {
+          if (!response.ok) {
+            return reject(response.statusText) // 请求失败，返回错误信息
+          }
+          return response.json() // 解析 JSON 格式的响应体
+        })
+        .then(data => {
+          resolve(data)
+        })
+        .catch(error => {
+          reject(error)
+        })
+    })
+  }
+}

src/ntqqapi/hook.ts

@@ -0,0 +1,206 @@
+import type { BrowserWindow } from 'electron'
+import { NTClass, NTMethod } from './ntcall'
+import { log } from '@/common/utils'
+import { randomUUID } from 'node:crypto'
+
+export const hookApiCallbacks: Record<string, (apiReturn: any) => void> = {}
+
+export const ReceiveCmdS = {
+  RECENT_CONTACT: 'nodeIKernelRecentContactListener/onRecentContactListChangedVer2',
+  UPDATE_MSG: 'nodeIKernelMsgListener/onMsgInfoListUpdate',
+  UPDATE_ACTIVE_MSG: 'nodeIKernelMsgListener/onActiveMsgInfoUpdate',
+  NEW_MSG: `nodeIKernelMsgListener/onRecvMsg`,
+  NEW_ACTIVE_MSG: `nodeIKernelMsgListener/onRecvActiveMsg`,
+  SELF_SEND_MSG: 'nodeIKernelMsgListener/onAddSendMsg',
+  USER_INFO: 'nodeIKernelProfileListener/onProfileSimpleChanged',
+  USER_DETAIL_INFO: 'nodeIKernelProfileListener/onProfileDetailInfoChanged',
+  GROUPS: 'nodeIKernelGroupListener/onGroupListUpdate',
+  GROUPS_STORE: 'onGroupListUpdate',
+  GROUP_MEMBER_INFO_UPDATE: 'nodeIKernelGroupListener/onMemberInfoChange',
+  FRIENDS: 'onBuddyListChange',
+  MEDIA_DOWNLOAD_COMPLETE: 'nodeIKernelMsgListener/onRichMediaDownloadComplete',
+  UNREAD_GROUP_NOTIFY: 'nodeIKernelGroupListener/onGroupNotifiesUnreadCountUpdated',
+  GROUP_NOTIFY: 'nodeIKernelGroupListener/onGroupSingleScreenNotifies',
+  FRIEND_REQUEST: 'nodeIKernelBuddyListener/onBuddyReqChange',
+  SELF_STATUS: 'nodeIKernelProfileListener/onSelfStatusChanged',
+  CACHE_SCAN_FINISH: 'nodeIKernelStorageCleanListener/onFinishScan',
+  MEDIA_UPLOAD_COMPLETE: 'nodeIKernelMsgListener/onRichMediaUploadComplete',
+  SKEY_UPDATE: 'onSkeyUpdate',
+} as const
+
+export type ReceiveCmd = string
+
+interface NTQQApiReturnData<Payload = unknown> extends Array<any> {
+  0: {
+    type: 'request'
+    eventName: NTClass
+    callbackId?: string
+  }
+  1: {
+    cmdName: ReceiveCmd
+    cmdType: 'event'
+    payload: Payload
+  }[]
+}
+
+const logHook = false
+
+const receiveHooks: Array<{
+  method: ReceiveCmd[]
+  hookFunc: (payload: any) => void | Promise<void>
+  id: string
+}> = []
+
+const callHooks: Array<{
+  method: NTMethod[]
+  hookFunc: (callParams: unknown[]) => void | Promise<void>
+}> = []
+
+export function hookNTQQApiReceive(window: BrowserWindow, onlyLog: boolean) {
+  const originalSend = window.webContents.send
+  const patchSend = (channel: string, ...args: NTQQApiReturnData) => {
+    try {
+      const isLogger = args[0]?.eventName?.startsWith('ns-LoggerApi')
+      if (logHook && !isLogger) {
+        log(`received ntqq api message: ${channel}`, args)
+      }
+    } catch { }
+    if (!onlyLog) {
+      if (args?.[1] instanceof Array) {
+        for (const receiveData of args?.[1]) {
+          const ntQQApiMethodName = receiveData.cmdName
+          // log(`received ntqq api message: ${channel} ${ntQQApiMethodName}`, JSON.stringify(receiveData))
+          for (const hook of receiveHooks) {
+            if (hook.method.includes(ntQQApiMethodName)) {
+              new Promise((resolve, reject) => {
+                try {
+                  hook.hookFunc(receiveData.payload)
+                } catch (e: any) {
+                  log('hook error', ntQQApiMethodName, e.stack.toString())
+                }
+                resolve(undefined)
+              }).then()
+            }
+          }
+        }
+      }
+      if (args[0]?.callbackId) {
+        // log("hookApiCallback", hookApiCallbacks, args)
+        const callbackId = args[0].callbackId
+        if (hookApiCallbacks[callbackId]) {
+          // log("callback found")
+          new Promise((resolve, reject) => {
+            hookApiCallbacks[callbackId](args[1])
+            resolve(undefined)
+          }).then()
+          delete hookApiCallbacks[callbackId]
+        }
+      }
+    }
+    originalSend.call(window.webContents, channel, ...args)
+  }
+  window.webContents.send = patchSend
+}
+
+export function hookNTQQApiCall(window: BrowserWindow, onlyLog: boolean) {
+  // 监听调用NTQQApi
+  let webContents = window.webContents as any
+  const ipc_message_proxy = webContents._events['-ipc-message']?.[0] || webContents._events['-ipc-message']
+
+  const proxyIpcMsg = new Proxy(ipc_message_proxy, {
+    apply(target, thisArg, args) {
+      // console.log(thisArg, args);
+      let isLogger = false
+      try {
+        isLogger = args[3][0].eventName.startsWith('ns-LoggerApi')
+      } catch (e) { }
+      if (!isLogger) {
+        try {
+          logHook && log('call NTQQ api', thisArg, args)
+        } catch (e) { }
+        if (!onlyLog) {
+          try {
+            const _args: unknown[] = args[3][1]
+            const cmdName: NTMethod = _args[0] as NTMethod
+            const callParams = _args.slice(1)
+            callHooks.forEach((hook) => {
+              if (hook.method.includes(cmdName)) {
+                new Promise((resolve, reject) => {
+                  try {
+                    hook.hookFunc(callParams)
+                  } catch (e: any) {
+                    log('hook call error', e, _args)
+                  }
+                  resolve(undefined)
+                }).then()
+              }
+            })
+          } catch (e) { }
+        }
+      }
+      return target.apply(thisArg, args)
+    },
+  })
+  if (webContents._events['-ipc-message']?.[0]) {
+    webContents._events['-ipc-message'][0] = proxyIpcMsg
+  } else {
+    webContents._events['-ipc-message'] = proxyIpcMsg
+  }
+
+  const ipc_invoke_proxy = webContents._events['-ipc-invoke']?.[0] || webContents._events['-ipc-invoke']
+  const proxyIpcInvoke = new Proxy(ipc_invoke_proxy, {
+    apply(target, thisArg, args) {
+      // console.log(args);
+      //HOOK_LOG && log('call NTQQ invoke api', thisArg, args)
+      args[0]['_replyChannel']['sendReply'] = new Proxy(args[0]['_replyChannel']['sendReply'], {
+        apply(sendtarget, sendthisArg, sendargs) {
+          sendtarget.apply(sendthisArg, sendargs)
+        },
+      })
+      let ret = target.apply(thisArg, args)
+      /*try {
+        HOOK_LOG && log('call NTQQ invoke api return', ret)
+      } catch (e) { }*/
+      return ret
+    },
+  })
+  if (webContents._events['-ipc-invoke']?.[0]) {
+    webContents._events['-ipc-invoke'][0] = proxyIpcInvoke
+  } else {
+    webContents._events['-ipc-invoke'] = proxyIpcInvoke
+  }
+}
+
+export function registerReceiveHook<PayloadType>(
+  method: ReceiveCmd | ReceiveCmd[],
+  hookFunc: (payload: PayloadType) => void,
+): string {
+  const id = randomUUID()
+  if (!Array.isArray(method)) {
+    method = [method]
+  }
+  receiveHooks.push({
+    method,
+    hookFunc,
+    id,
+  })
+  return id
+}
+
+export function registerCallHook(
+  method: NTMethod | NTMethod[],
+  hookFunc: (callParams: unknown[]) => void | Promise<void>,
+): void {
+  if (!Array.isArray(method)) {
+    method = [method]
+  }
+  callHooks.push({
+    method,
+    hookFunc,
+  })
+}
+
+export function removeReceiveHook(id: string) {
+  const index = receiveHooks.findIndex((h) => h.id === id)
+  receiveHooks.splice(index, 1)
+}

src/ntqqapi/listeners/NodeIKernelGroupListener.ts

@@ -0,0 +1,240 @@
+import { Group, GroupListUpdateType, GroupMember, GroupNotify } from '@/ntqqapi/types'
+
+interface IGroupListener {
+  onGroupListUpdate(updateType: GroupListUpdateType, groupList: Group[]): void
+
+  onGroupExtListUpdate(...args: unknown[]): void
+
+  onGroupSingleScreenNotifies(doubt: boolean, seq: string, notifies: GroupNotify[]): void
+
+  onGroupNotifiesUpdated(dboubt: boolean, notifies: GroupNotify[]): void
+
+  onGroupNotifiesUnreadCountUpdated(...args: unknown[]): void
+
+  onGroupDetailInfoChange(...args: unknown[]): void
+
+  onGroupAllInfoChange(...args: unknown[]): void
+
+  onGroupsMsgMaskResult(...args: unknown[]): void
+
+  onGroupConfMemberChange(...args: unknown[]): void
+
+  onGroupBulletinChange(...args: unknown[]): void
+
+  onGetGroupBulletinListResult(...args: unknown[]): void
+
+  onMemberListChange(arg: {
+    sceneId: string,
+    ids: string[],
+    infos: Map<string, GroupMember>,
+    finish: boolean,
+    hasRobot: boolean
+  }): void
+
+  onMemberInfoChange(groupCode: string, changeType: number, members: Map<string, GroupMember>): void
+
+  onSearchMemberChange(...args: unknown[]): void
+
+  onGroupBulletinRichMediaDownloadComplete(...args: unknown[]): void
+
+  onGroupBulletinRichMediaProgressUpdate(...args: unknown[]): void
+
+  onGroupStatisticInfoChange(...args: unknown[]): void
+
+  onJoinGroupNotify(...args: unknown[]): void
+
+  onShutUpMemberListChanged(...args: unknown[]): void
+
+  onGroupBulletinRemindNotify(...args: unknown[]): void
+
+  onGroupFirstBulletinNotify(...args: unknown[]): void
+
+  onJoinGroupNoVerifyFlag(...args: unknown[]): void
+
+  onGroupArkInviteStateResult(...args: unknown[]): void
+  // 发现于Win 9.9.9 23159
+  onGroupMemberLevelInfoChange(...args: unknown[]): void
+}
+
+export interface NodeIKernelGroupListener extends IGroupListener {
+  // eslint-disable-next-line @typescript-eslint/no-misused-new
+  new(listener: IGroupListener): NodeIKernelGroupListener
+}
+
+export class GroupListener implements IGroupListener {
+  // 发现于Win 9.9.9 23159
+  onGroupMemberLevelInfoChange(...args: unknown[]): void {
+
+  }
+  onGetGroupBulletinListResult(...args: unknown[]) {
+  }
+
+  onGroupAllInfoChange(...args: unknown[]) {
+  }
+
+  onGroupBulletinChange(...args: unknown[]) {
+  }
+
+  onGroupBulletinRemindNotify(...args: unknown[]) {
+  }
+
+  onGroupArkInviteStateResult(...args: unknown[]) {
+  }
+
+  onGroupBulletinRichMediaDownloadComplete(...args: unknown[]) {
+  }
+
+  onGroupConfMemberChange(...args: unknown[]) {
+  }
+
+  onGroupDetailInfoChange(...args: unknown[]) {
+  }
+
+  onGroupExtListUpdate(...args: unknown[]) {
+  }
+
+  onGroupFirstBulletinNotify(...args: unknown[]) {
+  }
+
+  onGroupListUpdate(updateType: GroupListUpdateType, groupList: Group[]) {
+  }
+
+  onGroupNotifiesUpdated(dboubt: boolean, notifies: GroupNotify[]) {
+  }
+
+  onGroupBulletinRichMediaProgressUpdate(...args: unknown[]) {
+  }
+
+  onGroupNotifiesUnreadCountUpdated(...args: unknown[]) {
+  }
+
+  onGroupSingleScreenNotifies(doubt: boolean, seq: string, notifies: GroupNotify[]) {
+  }
+
+  onGroupsMsgMaskResult(...args: unknown[]) {
+  }
+
+  onGroupStatisticInfoChange(...args: unknown[]) {
+  }
+
+  onJoinGroupNotify(...args: unknown[]) {
+  }
+
+  onJoinGroupNoVerifyFlag(...args: unknown[]) {
+  }
+
+  onMemberInfoChange(groupCode: string, changeType: number, members: Map<string, GroupMember>) {
+  }
+
+  onMemberListChange(arg: {
+    sceneId: string,
+    ids: string[],
+    infos: Map<string, GroupMember>, // uid -> GroupMember
+    finish: boolean,
+    hasRobot: boolean
+  }) {
+  }
+
+  onSearchMemberChange(...args: unknown[]) {
+  }
+
+  onShutUpMemberListChanged(...args: unknown[]) {
+  }
+}
+
+export class DebugGroupListener implements IGroupListener {
+  onGroupMemberLevelInfoChange(...args: unknown[]): void {
+    console.log('onGroupMemberLevelInfoChange:', ...args)
+  }
+  onGetGroupBulletinListResult(...args: unknown[]) {
+    console.log('onGetGroupBulletinListResult:', ...args)
+  }
+
+  onGroupAllInfoChange(...args: unknown[]) {
+    console.log('onGroupAllInfoChange:', ...args)
+  }
+
+  onGroupBulletinChange(...args: unknown[]) {
+    console.log('onGroupBulletinChange:', ...args)
+  }
+
+  onGroupBulletinRemindNotify(...args: unknown[]) {
+    console.log('onGroupBulletinRemindNotify:', ...args)
+  }
+
+  onGroupArkInviteStateResult(...args: unknown[]) {
+    console.log('onGroupArkInviteStateResult:', ...args)
+  }
+
+  onGroupBulletinRichMediaDownloadComplete(...args: unknown[]) {
+    console.log('onGroupBulletinRichMediaDownloadComplete:', ...args)
+  }
+
+  onGroupConfMemberChange(...args: unknown[]) {
+    console.log('onGroupConfMemberChange:', ...args)
+  }
+
+  onGroupDetailInfoChange(...args: unknown[]) {
+    console.log('onGroupDetailInfoChange:', ...args)
+  }
+
+  onGroupExtListUpdate(...args: unknown[]) {
+    console.log('onGroupExtListUpdate:', ...args)
+  }
+
+  onGroupFirstBulletinNotify(...args: unknown[]) {
+    console.log('onGroupFirstBulletinNotify:', ...args)
+  }
+
+  onGroupListUpdate(...args: unknown[]) {
+    console.log('onGroupListUpdate:', ...args)
+  }
+
+  onGroupNotifiesUpdated(...args: unknown[]) {
+    console.log('onGroupNotifiesUpdated:', ...args)
+  }
+
+  onGroupBulletinRichMediaProgressUpdate(...args: unknown[]) {
+    console.log('onGroupBulletinRichMediaProgressUpdate:', ...args)
+  }
+
+  onGroupNotifiesUnreadCountUpdated(...args: unknown[]) {
+    console.log('onGroupNotifiesUnreadCountUpdated:', ...args)
+  }
+
+  onGroupSingleScreenNotifies(doubt: boolean, seq: string, notifies: GroupNotify[]) {
+    console.log('onGroupSingleScreenNotifies:')
+  }
+
+  onGroupsMsgMaskResult(...args: unknown[]) {
+    console.log('onGroupsMsgMaskResult:', ...args)
+  }
+
+  onGroupStatisticInfoChange(...args: unknown[]) {
+    console.log('onGroupStatisticInfoChange:', ...args)
+  }
+
+  onJoinGroupNotify(...args: unknown[]) {
+    console.log('onJoinGroupNotify:', ...args)
+  }
+
+  onJoinGroupNoVerifyFlag(...args: unknown[]) {
+    console.log('onJoinGroupNoVerifyFlag:', ...args)
+  }
+
+  onMemberInfoChange(groupCode: string, changeType: number, members: Map<string, GroupMember>) {
+    console.log('onMemberInfoChange:', groupCode, changeType, members)
+  }
+
+  onMemberListChange(...args: unknown[]) {
+    console.log('onMemberListChange:', ...args)
+  }
+
+  onSearchMemberChange(...args: unknown[]) {
+    console.log('onSearchMemberChange:', ...args)
+  }
+
+  onShutUpMemberListChanged(...args: unknown[]) {
+    console.log('onShutUpMemberListChanged:', ...args)
+  }
+}

src/ntqqapi/listeners/NodeIKernelMsgListener.ts

@@ -0,0 +1,554 @@
+import { ChatType, RawMessage } from '@/ntqqapi/types'
+
+export interface OnRichMediaDownloadCompleteParams {
+  fileModelId: string,
+  msgElementId: string,
+  msgId: string,
+  fileId: string,
+  fileProgress: string, // '0'
+  fileSpeed: string, // '0'
+  fileErrCode: string,  // '0'
+  fileErrMsg: string,
+  fileDownType: number,  // 暂时未知
+  thumbSize: number,
+  filePath: string,
+  totalSize: string,
+  trasferStatus: number,
+  step: number,
+  commonFileInfo: unknown | null,
+  fileSrvErrCode: string,
+  clientMsg: string,
+  businessId: number,
+  userTotalSpacePerDay: unknown | null,
+  userUsedSpacePerDay: unknown | null
+}
+
+export interface OnGroupFileInfoUpdateParams {
+  retCode: number
+  retMsg: string
+  clientWording: string
+  isEnd: boolean
+  item: {
+    peerId: string
+    type: number
+    folderInfo?: {
+      folderId: string
+      parentFolderId: string
+      folderName: string
+      createTime: number
+      modifyTime: number
+      createUin: string
+      creatorName: string
+      totalFileCount: number
+      modifyUin: string
+      modifyName: string
+      usedSpace: string
+    }
+    fileInfo?: {
+      fileModelId: string
+      fileId: string
+      fileName: string
+      fileSize: string
+      busId: number
+      uploadedSize: string
+      uploadTime: number
+      deadTime: number
+      modifyTime: number
+      downloadTimes: number
+      sha: string
+      sha3: string
+      md5: string
+      uploaderLocalPath: string
+      uploaderName: string
+      uploaderUin: string
+      parentFolderId: string
+      localPath: string
+      transStatus: number
+      transType: number
+      elementId: string
+      isFolder: boolean
+    }
+  }[]
+  allFileCount: number
+  nextIndex: number
+  reqId: number
+}
+
+// {
+//   sessionType: 1,
+//   chatType: 100,
+//   peerUid: 'u_PVQ3tl6K78xxxx',
+//   groupCode: '809079648',
+//   fromNick: '拾xxxx,
+//   sig: '0x'
+// }
+export interface TempOnRecvParams {
+  sessionType: number,//1
+  chatType: ChatType,//100
+  peerUid: string,//uid
+  groupCode: string,//gc
+  fromNick: string,//gc name
+  sig: string,
+}
+
+export interface IKernelMsgListener {
+  onAddSendMsg(msgRecord: RawMessage): void
+
+  onBroadcastHelperDownloadComplete(broadcastHelperTransNotifyInfo: unknown): void
+
+  onBroadcastHelperProgressUpdate(broadcastHelperTransNotifyInfo: unknown): void
+
+  onChannelFreqLimitInfoUpdate(contact: unknown, z: unknown, freqLimitInfo: unknown): void
+
+  onContactUnreadCntUpdate(hashMap: unknown): void
+
+  onCustomWithdrawConfigUpdate(customWithdrawConfig: unknown): void
+
+  onDraftUpdate(contact: unknown, arrayList: unknown, j2: unknown): void
+
+  onEmojiDownloadComplete(emojiNotifyInfo: unknown): void
+
+  onEmojiResourceUpdate(emojiResourceInfo: unknown): void
+
+  onFeedEventUpdate(firstViewDirectMsgNotifyInfo: unknown): void
+
+  onFileMsgCome(arrayList: unknown): void
+
+  onFirstViewDirectMsgUpdate(firstViewDirectMsgNotifyInfo: unknown): void
+
+  onFirstViewGroupGuildMapping(arrayList: unknown): void
+
+  onGrabPasswordRedBag(i2: unknown, str: unknown, i3: unknown, recvdOrder: unknown, msgRecord: unknown): void
+
+  onGroupFileInfoAdd(groupItem: unknown): void
+
+  onGroupFileInfoUpdate(groupFileListResult: OnGroupFileInfoUpdateParams): void
+
+  onGroupGuildUpdate(groupGuildNotifyInfo: unknown): void
+
+  onGroupTransferInfoAdd(groupItem: unknown): void
+
+  onGroupTransferInfoUpdate(groupFileListResult: unknown): void
+
+  onGuildInteractiveUpdate(guildInteractiveNotificationItem: unknown): void
+
+  onGuildMsgAbFlagChanged(guildMsgAbFlag: unknown): void
+
+  onGuildNotificationAbstractUpdate(guildNotificationAbstractInfo: unknown): void
+
+  onHitCsRelatedEmojiResult(downloadRelateEmojiResultInfo: unknown): void
+
+  onHitEmojiKeywordResult(hitRelatedEmojiWordsResult: unknown): void
+
+  onHitRelatedEmojiResult(relatedWordEmojiInfo: unknown): void
+
+  onImportOldDbProgressUpdate(importOldDbMsgNotifyInfo: unknown): void
+
+  onInputStatusPush(inputStatusInfo: unknown): void
+
+  onKickedOffLine(kickedInfo: unknown): void
+
+  onLineDev(arrayList: unknown): void
+
+  onLogLevelChanged(j2: unknown): void
+
+  onMsgAbstractUpdate(arrayList: unknown): void
+
+  onMsgBoxChanged(arrayList: unknown): void
+
+  onMsgDelete(contact: unknown, arrayList: unknown): void
+
+  onMsgEventListUpdate(hashMap: unknown): void
+
+  onMsgInfoListAdd(arrayList: unknown): void
+
+  onMsgInfoListUpdate(msgList: RawMessage[]): void
+
+  onMsgQRCodeStatusChanged(i2: unknown): void
+
+  onMsgRecall(i2: unknown, str: unknown, j2: unknown): void
+
+  onMsgSecurityNotify(msgRecord: unknown): void
+
+  onMsgSettingUpdate(msgSetting: unknown): void
+
+  onNtFirstViewMsgSyncEnd(): void
+
+  onNtMsgSyncEnd(): void
+
+  onNtMsgSyncStart(): void
+
+  onReadFeedEventUpdate(firstViewDirectMsgNotifyInfo: unknown): void
+
+  onRecvGroupGuildFlag(i2: unknown): void
+
+  onRecvMsg(...arrayList: unknown[]): void
+
+  onRecvMsgSvrRspTransInfo(j2: unknown, contact: unknown, i2: unknown, i3: unknown, str: unknown, bArr: unknown): void
+
+  onRecvOnlineFileMsg(arrayList: unknown): void
+
+  onRecvS2CMsg(arrayList: unknown): void
+
+  onRecvSysMsg(arrayList: unknown): void
+
+  onRecvUDCFlag(i2: unknown): void
+
+  onRichMediaDownloadComplete(fileTransNotifyInfo: OnRichMediaDownloadCompleteParams): void
+
+  onRichMediaProgerssUpdate(fileTransNotifyInfo: unknown): void
+
+  onRichMediaUploadComplete(fileTransNotifyInfo: unknown): void
+
+  onSearchGroupFileInfoUpdate(searchGroupFileResult:
+    {
+      result: {
+        retCode: number,
+        retMsg: string,
+        clientWording: string
+      },
+      syncCookie: string,
+      totalMatchCount: number,
+      ownerMatchCount: number,
+      isEnd: boolean,
+      reqId: number,
+      item: Array<{
+        groupCode: string,
+        groupName: string,
+        uploaderUin: string,
+        uploaderName: string,
+        matchUin: string,
+        matchWords: Array<unknown>,
+        fileNameHits: Array<{
+          start: number,
+          end: number
+        }>,
+        fileModelId: string,
+        fileId: string,
+        fileName: string,
+        fileSize: string,
+        busId: number,
+        uploadTime: number,
+        modifyTime: number,
+        deadTime: number,
+        downloadTimes: number,
+        localPath: string
+      }>
+    }): void
+
+  onSendMsgError(j2: unknown, contact: unknown, i2: unknown, str: unknown): void
+
+  onSysMsgNotification(i2: unknown, j2: unknown, j3: unknown, arrayList: unknown): void
+
+  onTempChatInfoUpdate(tempChatInfo: TempOnRecvParams): void
+
+  onUnreadCntAfterFirstView(hashMap: unknown): void
+
+  onUnreadCntUpdate(hashMap: unknown): void
+
+  onUserChannelTabStatusChanged(z: unknown): void
+
+  onUserOnlineStatusChanged(z: unknown): void
+
+  onUserTabStatusChanged(arrayList: unknown): void
+
+  onlineStatusBigIconDownloadPush(i2: unknown, j2: unknown, str: unknown): void
+
+  onlineStatusSmallIconDownloadPush(i2: unknown, j2: unknown, str: unknown): void
+
+  // 第一次发现于Linux
+  onUserSecQualityChanged(...args: unknown[]): void
+
+  onMsgWithRichLinkInfoUpdate(...args: unknown[]): void
+
+  onRedTouchChanged(...args: unknown[]): void
+
+  // 第一次发现于Win 9.9.9 23159
+  onBroadcastHelperProgerssUpdate(...args: unknown[]): void
+
+}
+
+export interface NodeIKernelMsgListener extends IKernelMsgListener {
+  // eslint-disable-next-line @typescript-eslint/no-misused-new
+  new(listener: IKernelMsgListener): NodeIKernelMsgListener
+}
+
+
+export class MsgListener implements IKernelMsgListener {
+  onAddSendMsg(msgRecord: RawMessage) {
+
+  }
+
+  onBroadcastHelperDownloadComplete(broadcastHelperTransNotifyInfo: unknown) {
+
+  }
+
+  onBroadcastHelperProgressUpdate(broadcastHelperTransNotifyInfo: unknown) {
+
+  }
+
+  onChannelFreqLimitInfoUpdate(contact: unknown, z: unknown, freqLimitInfo: unknown) {
+
+  }
+
+  onContactUnreadCntUpdate(hashMap: unknown) {
+
+  }
+
+  onCustomWithdrawConfigUpdate(customWithdrawConfig: unknown) {
+
+  }
+
+  onDraftUpdate(contact: unknown, arrayList: unknown, j2: unknown) {
+
+  }
+
+  onEmojiDownloadComplete(emojiNotifyInfo: unknown) {
+
+  }
+
+  onEmojiResourceUpdate(emojiResourceInfo: unknown) {
+
+  }
+
+  onFeedEventUpdate(firstViewDirectMsgNotifyInfo: unknown) {
+
+  }
+
+  onFileMsgCome(arrayList: unknown) {
+
+  }
+
+  onFirstViewDirectMsgUpdate(firstViewDirectMsgNotifyInfo: unknown) {
+
+  }
+
+  onFirstViewGroupGuildMapping(arrayList: unknown) {
+
+  }
+
+  onGrabPasswordRedBag(i2: unknown, str: unknown, i3: unknown, recvdOrder: unknown, msgRecord: unknown) {
+
+  }
+
+  onGroupFileInfoAdd(groupItem: unknown) {
+
+  }
+
+  onGroupFileInfoUpdate(groupFileListResult: OnGroupFileInfoUpdateParams) {
+
+  }
+
+  onGroupGuildUpdate(groupGuildNotifyInfo: unknown) {
+
+  }
+
+
+  onGroupTransferInfoAdd(groupItem: unknown) {
+
+  }
+
+  onGroupTransferInfoUpdate(groupFileListResult: unknown) {
+
+  }
+
+  onGuildInteractiveUpdate(guildInteractiveNotificationItem: unknown) {
+
+  }
+
+  onGuildMsgAbFlagChanged(guildMsgAbFlag: unknown) {
+
+  }
+
+  onGuildNotificationAbstractUpdate(guildNotificationAbstractInfo: unknown) {
+
+  }
+
+  onHitCsRelatedEmojiResult(downloadRelateEmojiResultInfo: unknown) {
+
+  }
+
+  onHitEmojiKeywordResult(hitRelatedEmojiWordsResult: unknown) {
+
+  }
+
+  onHitRelatedEmojiResult(relatedWordEmojiInfo: unknown) {
+
+  }
+
+  onImportOldDbProgressUpdate(importOldDbMsgNotifyInfo: unknown) {
+
+  }
+
+  onInputStatusPush(inputStatusInfo: unknown) {
+
+  }
+
+  onKickedOffLine(kickedInfo: unknown) {
+
+  }
+
+  onLineDev(arrayList: unknown) {
+
+  }
+
+  onLogLevelChanged(j2: unknown) {
+
+  }
+
+  onMsgAbstractUpdate(arrayList: unknown) {
+
+  }
+
+  onMsgBoxChanged(arrayList: unknown) {
+
+  }
+
+  onMsgDelete(contact: unknown, arrayList: unknown) {
+
+  }
+
+  onMsgEventListUpdate(hashMap: unknown) {
+
+  }
+
+  onMsgInfoListAdd(arrayList: unknown) {
+
+  }
+
+  onMsgInfoListUpdate(msgList: RawMessage[]) {
+
+  }
+
+  onMsgQRCodeStatusChanged(i2: unknown) {
+
+  }
+
+  onMsgRecall(i2: unknown, str: unknown, j2: unknown) {
+
+  }
+
+  onMsgSecurityNotify(msgRecord: unknown) {
+
+  }
+
+  onMsgSettingUpdate(msgSetting: unknown) {
+
+  }
+
+  onNtFirstViewMsgSyncEnd() {
+
+  }
+
+  onNtMsgSyncEnd() {
+
+  }
+
+  onNtMsgSyncStart() {
+
+  }
+
+  onReadFeedEventUpdate(firstViewDirectMsgNotifyInfo: unknown) {
+
+  }
+
+  onRecvGroupGuildFlag(i2: unknown) {
+
+  }
+
+  onRecvMsg(arrayList: RawMessage[]) {
+
+  }
+
+  onRecvMsgSvrRspTransInfo(j2: unknown, contact: unknown, i2: unknown, i3: unknown, str: unknown, bArr: unknown) {
+
+  }
+
+  onRecvOnlineFileMsg(arrayList: unknown) {
+
+  }
+
+  onRecvS2CMsg(arrayList: unknown) {
+
+  }
+
+  onRecvSysMsg(arrayList: unknown) {
+
+  }
+
+  onRecvUDCFlag(i2: unknown) {
+
+  }
+
+  onRichMediaDownloadComplete(fileTransNotifyInfo: OnRichMediaDownloadCompleteParams) {
+  }
+
+  onRichMediaProgerssUpdate(fileTransNotifyInfo: unknown) {
+
+  }
+
+  onRichMediaUploadComplete(fileTransNotifyInfo: unknown) {
+
+  }
+
+  onSearchGroupFileInfoUpdate(searchGroupFileResult: unknown) {
+
+  }
+
+  onSendMsgError(j2: unknown, contact: unknown, i2: unknown, str: unknown) {
+
+  }
+
+  onSysMsgNotification(i2: unknown, j2: unknown, j3: unknown, arrayList: unknown) {
+
+  }
+
+  onTempChatInfoUpdate(tempChatInfo: TempOnRecvParams) {
+
+  }
+
+  onUnreadCntAfterFirstView(hashMap: unknown) {
+
+  }
+
+  onUnreadCntUpdate(hashMap: unknown) {
+
+  }
+
+  onUserChannelTabStatusChanged(z: unknown) {
+
+  }
+
+  onUserOnlineStatusChanged(z: unknown) {
+
+  }
+
+  onUserTabStatusChanged(arrayList: unknown) {
+
+  }
+
+  onlineStatusBigIconDownloadPush(i2: unknown, j2: unknown, str: unknown) {
+
+  }
+
+  onlineStatusSmallIconDownloadPush(i2: unknown, j2: unknown, str: unknown) {
+
+  }
+
+  // 第一次发现于Linux
+  onUserSecQualityChanged(...args: unknown[]) {
+
+  }
+
+  onMsgWithRichLinkInfoUpdate(...args: unknown[]) {
+
+  }
+
+  onRedTouchChanged(...args: unknown[]) {
+
+  }
+  // 第一次发现于Win 9.9.9-23159
+  onBroadcastHelperProgerssUpdate(...args: unknown[]) {
+
+  }
+}

src/ntqqapi/listeners/NodeIKernelProfileListener.ts

@@ -0,0 +1,44 @@
+import { User, UserDetailInfoListenerArg } from '@/ntqqapi/types'
+
+interface IProfileListener {
+  onProfileSimpleChanged(...args: unknown[]): void
+
+  onUserDetailInfoChanged(arg: UserDetailInfoListenerArg): void
+
+  onProfileDetailInfoChanged(profile: User): void
+
+  onStatusUpdate(...args: unknown[]): void
+
+  onSelfStatusChanged(...args: unknown[]): void
+
+  onStrangerRemarkChanged(...args: unknown[]): void
+}
+
+export interface NodeIKernelProfileListener extends IProfileListener {
+  new(listener: IProfileListener): NodeIKernelProfileListener
+}
+
+export class ProfileListener implements IProfileListener {
+  onUserDetailInfoChanged(arg: UserDetailInfoListenerArg): void {
+
+  }
+  onProfileSimpleChanged(...args: unknown[]) {
+
+  }
+
+  onProfileDetailInfoChanged(profile: User) {
+
+  }
+
+  onStatusUpdate(...args: unknown[]) {
+
+  }
+
+  onSelfStatusChanged(...args: unknown[]) {
+
+  }
+
+  onStrangerRemarkChanged(...args: unknown[]) {
+
+  }
+}

src/ntqqapi/listeners/index.ts

@@ -0,0 +1,3 @@
+export * from './NodeIKernelProfileListener'
+export * from './NodeIKernelGroupListener'
+export * from './NodeIKernelMsgListener'

src/ntqqapi/ntcall.ts

@@ -0,0 +1,185 @@
+import { ipcMain } from 'electron'
+import { hookApiCallbacks, registerReceiveHook, removeReceiveHook } from './hook'
+import { log } from '../common/utils/legacyLog'
+import { randomUUID } from 'node:crypto'
+import {
+  GeneralCallResult,
+  NodeIKernelBuddyService,
+  NodeIKernelProfileService,
+  NodeIKernelGroupService,
+  NodeIKernelProfileLikeService,
+  NodeIKernelMsgService,
+  NodeIKernelMSFService,
+  NodeIKernelUixConvertService,
+  NodeIKernelRichMediaService,
+  NodeIKernelTicketService,
+  NodeIKernelTipOffService,
+  NodeIKernelSearchService,
+} from './services'
+
+export enum NTClass {
+  NT_API = 'ns-ntApi',
+  FS_API = 'ns-FsApi',
+  OS_API = 'ns-OsApi',
+  WINDOW_API = 'ns-WindowApi',
+  HOTUPDATE_API = 'ns-HotUpdateApi',
+  BUSINESS_API = 'ns-BusinessApi',
+  GLOBAL_DATA = 'ns-GlobalDataApi',
+  SKEY_API = 'ns-SkeyApi',
+  GROUP_HOME_WORK = 'ns-GroupHomeWork',
+  GROUP_ESSENCE = 'ns-GroupEssence',
+  NODE_STORE_API = 'ns-NodeStoreApi'
+}
+
+export enum NTMethod {
+  ACTIVE_CHAT_PREVIEW = 'nodeIKernelMsgService/getAioFirstViewLatestMsgsAndAddActiveChat', // 激活聊天窗口，有时候必须这样才能收到消息, 并返回最新预览消息
+  ACTIVE_CHAT_HISTORY = 'nodeIKernelMsgService/getMsgsIncludeSelfAndAddActiveChat', // 激活聊天窗口，有时候必须这样才能收到消息, 并返回历史消息
+  HISTORY_MSG = 'nodeIKernelMsgService/getMsgsIncludeSelf',
+  GET_MULTI_MSG = 'nodeIKernelMsgService/getMultiMsg',
+  DELETE_ACTIVE_CHAT = 'nodeIKernelMsgService/deleteActiveChatByUid',
+  MEDIA_FILE_PATH = 'nodeIKernelMsgService/getRichMediaFilePathForGuild',
+  RECALL_MSG = 'nodeIKernelMsgService/recallMsg',
+  EMOJI_LIKE = 'nodeIKernelMsgService/setMsgEmojiLikes',
+  FORWARD_MSG = 'nodeIKernelMsgService/forwardMsgWithComment',
+
+  SELF_INFO = 'fetchAuthData',
+  FILE_TYPE = 'getFileType',
+  FILE_MD5 = 'getFileMd5',
+  FILE_COPY = 'copyFile',
+  IMAGE_SIZE = 'getImageSizeFromPath',
+  FILE_SIZE = 'getFileSize',
+  CACHE_PATH_HOT_UPDATE = 'getHotUpdateCachePath',
+  CACHE_PATH_DESKTOP_TEMP = 'getDesktopTmpPath',
+  CACHE_PATH_SESSION = 'getCleanableAppSessionPathList',
+  OPEN_EXTRA_WINDOW = 'openExternalWindow',
+
+  GROUP_MEMBER_SCENE = 'nodeIKernelGroupService/createMemberListScene',
+  GROUP_MEMBERS = 'nodeIKernelGroupService/getNextMemberList',
+  HANDLE_GROUP_REQUEST = 'nodeIKernelGroupService/operateSysNotify',
+  QUIT_GROUP = 'nodeIKernelGroupService/quitGroup',
+  GROUP_AT_ALL_REMAIN_COUNT = 'nodeIKernelGroupService/getGroupRemainAtTimes',
+  KICK_MEMBER = 'nodeIKernelGroupService/kickMember',
+  MUTE_MEMBER = 'nodeIKernelGroupService/setMemberShutUp',
+  MUTE_GROUP = 'nodeIKernelGroupService/setGroupShutUp',
+  SET_MEMBER_CARD = 'nodeIKernelGroupService/modifyMemberCardName',
+  SET_MEMBER_ROLE = 'nodeIKernelGroupService/modifyMemberRole',
+  SET_GROUP_NAME = 'nodeIKernelGroupService/modifyGroupName',
+
+  HANDLE_FRIEND_REQUEST = 'nodeIKernelBuddyService/approvalFriendRequest',
+
+  CACHE_SET_SILENCE = 'nodeIKernelStorageCleanService/setSilentScan',
+  CACHE_ADD_SCANNED_PATH = 'nodeIKernelStorageCleanService/addCacheScanedPaths',
+  CACHE_SCAN = 'nodeIKernelStorageCleanService/scanCache',
+  CACHE_CLEAR = 'nodeIKernelStorageCleanService/clearCacheDataByKeys',
+  CACHE_CHAT_GET = 'nodeIKernelStorageCleanService/getChatCacheInfo',
+  CACHE_FILE_GET = 'nodeIKernelStorageCleanService/getFileCacheInfo',
+  CACHE_CHAT_CLEAR = 'nodeIKernelStorageCleanService/clearChatCacheInfo',
+}
+
+export enum NTChannel {
+  IPC_UP_1 = 'IPC_UP_1',
+  IPC_UP_2 = 'IPC_UP_2',
+  IPC_UP_3 = 'IPC_UP_3',
+  IPC_UP_4 = 'IPC_UP_4'
+}
+
+interface NTService {
+  nodeIKernelBuddyService: NodeIKernelBuddyService
+  nodeIKernelProfileService: NodeIKernelProfileService
+  nodeIKernelGroupService: NodeIKernelGroupService
+  nodeIKernelProfileLikeService: NodeIKernelProfileLikeService
+  nodeIKernelMsgService: NodeIKernelMsgService
+  nodeIKernelMSFService: NodeIKernelMSFService
+  nodeIKernelUixConvertService: NodeIKernelUixConvertService
+  nodeIKernelRichMediaService: NodeIKernelRichMediaService
+  nodeIKernelTicketService: NodeIKernelTicketService
+  nodeIKernelTipOffService: NodeIKernelTipOffService
+  nodeIKernelSearchService: NodeIKernelSearchService
+}
+
+interface InvokeOptions<ReturnType> {
+  className?: NTClass
+  channel?: NTChannel
+  classNameIsRegister?: boolean
+  cbCmd?: string | string[]
+  cmdCB?: (payload: ReturnType, result: unknown) => boolean
+  afterFirstCmd?: boolean // 是否在methodName调用完之后再去hook cbCmd
+  timeout?: number
+}
+
+export function invoke<
+  R extends Awaited<ReturnType<Extract<NTService[S][M], (...args: any) => any>>>,
+  S extends keyof NTService = any,
+  M extends keyof NTService[S] & string = any
+>(method: Extract<unknown, `${S}/${M}`> | string, args: unknown[], options: InvokeOptions<R> = {}) {
+  const className = options.className ?? NTClass.NT_API
+  const channel = options.channel ?? NTChannel.IPC_UP_2
+  const timeout = options.timeout ?? 5000
+  const afterFirstCmd = options.afterFirstCmd ?? true
+  let eventName = className + '-' + channel[channel.length - 1]
+  if (options.classNameIsRegister) {
+    eventName += '-register'
+  }
+  return new Promise<R>((resolve, reject) => {
+    const apiArgs = [method, ...args]
+    const callbackId = randomUUID()
+    let success = false
+    if (!options.cbCmd) {
+      // QQ后端会返回结果，并且可以根据uuid识别
+      hookApiCallbacks[callbackId] = res => {
+        success = true
+        resolve(res)
+      }
+    }
+    else {
+      let result: unknown
+      // 这里的callback比较特殊，QQ后端先返回是否调用成功，再返回一条结果数据
+      const secondCallback = () => {
+        const hookId = registerReceiveHook<R>(options.cbCmd!, (payload) => {
+          // log(methodName, "second callback", cbCmd, payload, cmdCB);
+          if (!!options.cmdCB) {
+            if (options.cmdCB(payload, result)) {
+              removeReceiveHook(hookId)
+              success = true
+              resolve(payload)
+            }
+          }
+          else {
+            removeReceiveHook(hookId)
+            success = true
+            resolve(payload)
+          }
+        })
+      }
+      !afterFirstCmd && secondCallback()
+      hookApiCallbacks[callbackId] = (res: GeneralCallResult) => {
+        result = res
+        if (res?.result === 0 || ['undefined', 'number'].includes(typeof res)) {
+          afterFirstCmd && secondCallback()
+        }
+        else {
+          log('ntqq api call failed,', method, res)
+          reject(`ntqq api call failed, ${method}, ${res.errMsg}`)
+        }
+      }
+    }
+    setTimeout(() => {
+      if (!success) {
+        log(`ntqq api timeout ${channel}, ${eventName}, ${method}`, apiArgs)
+        reject(`ntqq api timeout ${channel}, ${eventName}, ${method}, ${apiArgs}`)
+      }
+    }, timeout)
+
+    ipcMain.emit(
+      channel,
+      {
+        sender: {
+          send: (..._args: unknown[]) => {
+          },
+        },
+      },
+      { type: 'request', callbackId, eventName },
+      apiArgs,
+    )
+  })
+}

src/ntqqapi/services/NodeIKernelBuddyService.ts

@@ -0,0 +1,125 @@
+import { GeneralCallResult } from './common'
+
+export enum BuddyListReqType {
+  KNOMAL,
+  KLETTER
+}
+
+export interface NodeIKernelBuddyService {
+  // 26702 以上
+  getBuddyListV2(callFrom: string, reqType: BuddyListReqType): Promise<GeneralCallResult & {
+    data: Array<{
+      categoryId: number,
+      categorySortId: number,
+      categroyName: string,
+      categroyMbCount: number,
+      onlineCount: number,
+      buddyUids: Array<string>
+    }>
+  }>
+
+  //26702 以上
+  getBuddyListFromCache(callFrom: string): Promise<Array<
+    {
+      categoryId: number,//9999应该跳过 那是兜底数据吧
+      categorySortId: number,//排序方式
+      categroyName: string,//分类名
+      categroyMbCount: number,//不懂
+      onlineCount: number,//在线数目
+      buddyUids: Array<string>//Uids
+    }>>
+
+  addKernelBuddyListener(listener: any): number
+
+  getAllBuddyCount(): number
+
+  removeKernelBuddyListener(listener: unknown): void
+
+  getBuddyList(nocache: boolean): Promise<GeneralCallResult>
+
+  getBuddyNick(uid: number): string
+
+  getBuddyRemark(uid: number): string
+
+  setBuddyRemark(uid: number, remark: string): void
+
+  getAvatarUrl(uid: number): string
+
+  isBuddy(uid: string): boolean
+
+  getCategoryNameWithUid(uid: number): string
+
+  getTargetBuddySetting(uid: number): unknown
+
+  getTargetBuddySettingByType(uid: number, type: number): unknown
+
+  getBuddyReqUnreadCnt(): number
+
+  getBuddyReq(): unknown
+
+  delBuddyReq(uid: number): void
+
+  clearBuddyReqUnreadCnt(): void
+
+  reqToAddFriends(uid: number, msg: string): void
+
+  setSpacePermission(uid: number, permission: number): void
+
+  approvalFriendRequest(arg: {
+    friendUid: string
+    reqTime: string
+    accept: boolean
+  }): Promise<void>
+
+  delBuddy(uid: number): void
+
+  delBatchBuddy(uids: number[]): void
+
+  getSmartInfos(uid: number): unknown
+
+  setBuddyCategory(uid: number, category: number): void
+
+  setBatchBuddyCategory(uids: number[], category: number): void
+
+  addCategory(category: string): void
+
+  delCategory(category: string): void
+
+  renameCategory(oldCategory: string, newCategory: string): void
+
+  resortCategory(categorys: string[]): void
+
+  pullCategory(uid: number, category: string): void
+
+  setTop(uid: number, isTop: boolean): void
+
+  SetSpecialCare(uid: number, isSpecialCare: boolean): void
+
+  setMsgNotify(uid: number, isNotify: boolean): void
+
+  hasBuddyList(): boolean
+
+  setBlock(uid: number, isBlock: boolean): void
+
+  isBlocked(uid: number): boolean
+
+  modifyAddMeSetting(setting: unknown): void
+
+  getAddMeSetting(): unknown
+
+  getDoubtBuddyReq(): unknown
+
+  getDoubtBuddyUnreadNum(): number
+
+  approvalDoubtBuddyReq(uid: number, isAgree: boolean): void
+
+  delDoubtBuddyReq(uid: number): void
+
+  delAllDoubtBuddyReq(): void
+
+  reportDoubtBuddyReqUnread(): void
+
+  getBuddyRecommendContactArkJson(uid: string, phoneNumber: string): Promise<unknown>
+
+  isNull(): boolean
+}

src/ntqqapi/services/NodeIKernelGroupService.ts

@@ -0,0 +1,249 @@
+import { NodeIKernelGroupListener } from '@/ntqqapi/listeners'
+import {
+  GroupExtParam,
+  GroupMember,
+  GroupMemberRole,
+  GroupNotifyType,
+  GroupRequestOperateTypes,
+} from '@/ntqqapi/types'
+import { GeneralCallResult } from './common'
+
+//高版本的接口不应该随意使用 使用应该严格进行pr审核 同时部分ipc中未出现的接口不要过于依赖 应该做好数据兜底
+
+export interface NodeIKernelGroupService {
+  getMemberCommonInfo(Req: {
+    groupCode: string,
+    startUin: string,
+    identifyFlag: string,
+    uinList: string[],
+    memberCommonFilter: {
+      memberUin: number,
+      uinFlag: number,
+      uinFlagExt: number,
+      uinMobileFlag: number,
+      shutUpTime: number,
+      privilege: number,
+    },
+    memberNum: number,
+    filterMethod: string,
+    onlineFlag: string,
+    realSpecialTitleFlag: number
+  }): Promise<unknown>
+  //26702
+  getGroupMemberLevelInfo(groupCode: string): Promise<unknown>
+  //26702
+  getGroupHonorList(groupCodes: Array<string>): unknown
+
+  getUinByUids(uins: string[]): Promise<{
+    errCode: number,
+    errMsg: string,
+    uins: Map<string, string>
+  }>
+
+  getUidByUins(uins: string[]): Promise<{
+    errCode: number,
+    errMsg: string,
+    uids: Map<string, string>
+  }>
+  //26702(其实更早 但是我不知道)
+  checkGroupMemberCache(arrayList: Array<string>): Promise<unknown>
+
+  //26702(其实更早 但是我不知道)
+  getGroupLatestEssenceList(groupCode: string): Promise<unknown>
+
+  //26702(其实更早 但是我不知道) 
+  shareDigest(Req: {
+    appId: string,
+    appType: number,
+    msgStyle: number,
+    recvUin: string,
+    sendType: number,
+    clientInfo: {
+      platform: number
+    },
+    richMsg: {
+      usingArk: boolean,
+      title: string,
+      summary: string,
+      url: string,
+      pictureUrl: string,
+      brief: string
+    }
+  }): Promise<unknown>
+  //26702(其实更早 但是我不知道)
+  isEssenceMsg(Req: { groupCode: string, msgRandom: number, msgSeq: number }): Promise<unknown>
+  //26702(其实更早 但是我不知道)
+  queryCachedEssenceMsg(Req: { groupCode: string, msgRandom: number, msgSeq: number }): Promise<unknown>
+  //26702(其实更早 但是我不知道)
+  fetchGroupEssenceList(Req: { groupCode: string, pageStart: number, pageLimit: number }, Arg: unknown): Promise<unknown>
+  //26702
+  getAllMemberList(groupCode: string, forceFetch: boolean): Promise<{
+    errCode: number,
+    errMsg: string,
+    result: {
+      ids: Array<{
+        uid: string,
+        index: number//0
+      }>,
+      infos: {},
+      finish: true,
+      hasRobot: false
+    }
+  }>
+
+  setHeader(uid: string, path: string): unknown
+
+  addKernelGroupListener(listener: NodeIKernelGroupListener): number
+
+  removeKernelGroupListener(listenerId: unknown): void
+
+  createMemberListScene(groupCode: string, scene: string): string
+
+  destroyMemberListScene(SceneId: string): void
+  //About Arg (a) name: lastId 根据手Q来看为object {index:?(number),uid:string}
+  getNextMemberList(sceneId: string, a: undefined, num: number): Promise<{
+    errCode: number, errMsg: string,
+    result: { ids: string[], infos: Map<string, GroupMember>, finish: boolean, hasRobot: boolean }
+  }>
+
+  getPrevMemberList(): unknown
+
+  monitorMemberList(): unknown
+
+  searchMember(sceneId: string, keywords: string[]): unknown
+
+  getMemberInfo(group_id: string, uids: string[], forceFetch: boolean): Promise<GeneralCallResult>
+  //getMemberInfo  [ '56729xxxx', [ 'u_4Nj08cwW5Hxxxxx' ], true ]
+
+  kickMember(groupCode: string, memberUids: string[], refuseForever: boolean, kickReason: string): Promise<void>
+
+  modifyMemberRole(groupCode: string, uid: string, role: GroupMemberRole): void
+
+  modifyMemberCardName(groupCode: string, uid: string, cardName: string): void
+
+  getTransferableMemberInfo(groupCode: string): unknown//获取整个群的
+
+  transferGroup(uid: string): void
+
+  getGroupList(force: boolean): Promise<GeneralCallResult>
+
+  getGroupExtList(force: boolean): Promise<GeneralCallResult>
+
+  getGroupDetailInfo(groupCode: string): unknown
+
+  getMemberExtInfo(param: GroupExtParam): Promise<unknown>//req
+
+  getGroupAllInfo(): unknown
+
+  getDiscussExistInfo(): unknown
+
+  getGroupConfMember(): unknown
+
+  getGroupMsgMask(): unknown
+
+  getGroupPortrait(): void
+
+  modifyGroupName(groupCode: string, groupName: string, arg: false): void
+
+  modifyGroupRemark(groupCode: string, remark: string): void
+
+  modifyGroupDetailInfo(groupCode: string, arg: unknown): void
+
+  setGroupMsgMask(groupCode: string, arg: unknown): void
+
+  changeGroupShieldSettingTemp(groupCode: string, arg: unknown): void
+
+  inviteToGroup(arg: unknown): void
+
+  inviteMembersToGroup(args: unknown[]): void
+
+  inviteMembersToGroupWithMsg(args: unknown): void
+
+  createGroup(arg: unknown): void
+
+  createGroupWithMembers(arg: unknown): void
+
+  quitGroup(groupCode: string): void
+
+  destroyGroup(groupCode: string): void
+  //获取单屏群通知列表
+  getSingleScreenNotifies(force: boolean, start_seq: string, num: number): Promise<GeneralCallResult>
+
+  clearGroupNotifies(groupCode: string): void
+
+  getGroupNotifiesUnreadCount(unknown: Boolean): Promise<GeneralCallResult>
+
+  clearGroupNotifiesUnreadCount(groupCode: string): void
+
+  operateSysNotify(
+    doubt: boolean,
+    operateMsg: {
+      operateType: GroupRequestOperateTypes, // 2 拒绝
+      targetMsg: {
+        seq: string,  // 通知序列号
+        type: GroupNotifyType,
+        groupCode: string,
+        postscript: string
+      }
+    }): Promise<void>
+
+  setTop(groupCode: string, isTop: boolean): void
+
+  getGroupBulletin(groupCode: string): unknown
+
+  deleteGroupBulletin(groupCode: string, seq: string): void
+
+  publishGroupBulletin(groupCode: string, pskey: string, data: any): Promise<GeneralCallResult>
+
+  publishInstructionForNewcomers(groupCode: string, arg: unknown): void
+
+  uploadGroupBulletinPic(groupCode: string, pskey: string, imagePath: string): Promise<GeneralCallResult & {
+    errCode: number
+    picInfo?: {
+      id: string,
+      width: number,
+      height: number
+    }
+  }>
+
+  downloadGroupBulletinRichMedia(groupCode: string): unknown
+
+  getGroupBulletinList(groupCode: string): unknown
+
+  getGroupStatisticInfo(groupCode: string): unknown
+
+  getGroupRemainAtTimes(groupCode: string): number
+
+  getJoinGroupNoVerifyFlag(groupCode: string): unknown
+
+  getGroupArkInviteState(groupCode: string): unknown
+
+  reqToJoinGroup(groupCode: string, arg: unknown): void
+
+  setGroupShutUp(groupCode: string, shutUp: boolean): void
+
+  getGroupShutUpMemberList(groupCode: string): unknown[]
+
+  setMemberShutUp(groupCode: string, memberTimes: { uid: string, timeStamp: number }[]): Promise<void>
+
+  getGroupRecommendContactArkJson(groupCode: string): unknown
+
+  getJoinGroupLink(groupCode: string): unknown
+
+  modifyGroupExtInfo(groupCode: string, arg: unknown): void
+
+  //需要提前判断是否存在 高版本新增
+  addGroupEssence(param: {
+    groupCode: string
+    msgRandom: number,
+    msgSeq: number
+  }): Promise<unknown>
+  //需要提前判断是否存在 高版本新增
+  removeGroupEssence(param: {
+    groupCode: string
+    msgRandom: number,
+    msgSeq: number
+  }): Promise<unknown>
+
+  isNull(): boolean
+}

src/ntqqapi/services/NodeIKernelMSFService.ts

@@ -0,0 +1,3 @@
+export interface NodeIKernelMSFService {
+  getServerTime(): string
+}

src/ntqqapi/services/NodeIKernelMsgService.ts

@@ -0,0 +1,743 @@
+import { ElementType, MessageElement, Peer, RawMessage, SendMessageElement } from '@/ntqqapi/types'
+import { NodeIKernelMsgListener } from '@/ntqqapi/listeners/NodeIKernelMsgListener'
+import { GeneralCallResult } from './common'
+
+export interface QueryMsgsParams {
+  chatInfo: Peer,
+  filterMsgType: [],
+  filterSendersUid: string[],
+  filterMsgFromTime: string,
+  filterMsgToTime: string,
+  pageLimit: number,
+  isReverseOrder: boolean,
+  isIncludeCurrent: boolean
+}
+
+export interface TmpChatInfoApi {
+  errMsg: string
+  result: number
+  tmpChatInfo?: TmpChatInfo
+}
+
+export interface TmpChatInfo {
+  chatType: number
+  fromNick: string
+  groupCode: string
+  peerUid: string
+  sessionType: number
+  sig: string
+}
+
+export interface NodeIKernelMsgService {
+
+  generateMsgUniqueId(chatType: number, time: string): string
+
+  addKernelMsgListener(nodeIKernelMsgListener: NodeIKernelMsgListener): number
+
+  sendMsg(msgId: string, peer: Peer, msgElements: SendMessageElement[], map: Map<any, any>): Promise<GeneralCallResult>
+
+  recallMsg(peer: Peer, msgIds: string[]): Promise<GeneralCallResult>
+
+  addKernelMsgImportToolListener(arg: Object): unknown
+
+  removeKernelMsgListener(args: unknown): unknown
+
+  addKernelTempChatSigListener(...args: unknown[]): unknown
+
+  removeKernelTempChatSigListener(...args: unknown[]): unknown
+
+  setAutoReplyTextList(AutoReplyText: Array<unknown>, i2: number): unknown
+
+  getAutoReplyTextList(...args: unknown[]): unknown
+
+  getOnLineDev(): void
+
+  kickOffLine(DevInfo: Object): unknown
+
+  setStatus(args: { status: number, extStatus: number, batteryStatus: number }): Promise<GeneralCallResult>
+
+  fetchStatusMgrInfo(): unknown
+
+  fetchStatusUnitedConfigInfo(): unknown
+
+  getOnlineStatusSmallIconBasePath(): unknown
+
+  getOnlineStatusSmallIconFileNameByUrl(Url: string): unknown
+
+  downloadOnlineStatusSmallIconByUrl(arg0: number, arg1: string): unknown
+
+  getOnlineStatusBigIconBasePath(): unknown
+
+  downloadOnlineStatusBigIconByUrl(arg0: number, arg1: string): unknown
+
+  getOnlineStatusCommonPath(arg: string): unknown
+
+  getOnlineStatusCommonFileNameByUrl(Url: string): unknown
+
+  downloadOnlineStatusCommonByUrl(arg0: string, arg1: string): unknown
+
+  // this.tokenType = i2
+  // this.apnsToken = bArr
+  // this.voipToken = bArr2
+  // this.profileId = str
+
+  setToken(arg: Object): unknown
+
+  switchForeGround(): unknown
+
+  switchBackGround(arg: Object): unknown
+
+  //hex
+  setTokenForMqq(token: string): unknown
+
+  switchForeGroundForMqq(...args: unknown[]): unknown
+
+  switchBackGroundForMqq(...args: unknown[]): unknown
+
+  getMsgSetting(...args: unknown[]): unknown
+
+  setMsgSetting(...args: unknown[]): unknown
+
+  addSendMsg(...args: unknown[]): unknown
+
+  cancelSendMsg(...args: unknown[]): unknown
+
+  switchToOfflineSendMsg(peer: Peer, MsgId: string): unknown
+
+  reqToOfflineSendMsg(...args: unknown[]): unknown
+
+  refuseReceiveOnlineFileMsg(peer: Peer, MsgId: string): unknown
+
+  resendMsg(...args: unknown[]): unknown
+
+  reeditRecallMsg(...args: unknown[]): unknown
+  //调用请检查除开commentElements其余参数不能为null
+  forwardMsg(msgIds: string[], srcContact: Peer, dstContacts: Peer[], commentElements: MessageElement[]): Promise<GeneralCallResult>
+
+  forwardMsgWithComment(...args: unknown[]): unknown
+
+  forwardSubMsgWithComment(...args: unknown[]): unknown
+
+  forwardRichMsgInVist(...args: unknown[]): unknown
+
+  forwardFile(...args: unknown[]): unknown
+  //Array<Msg>, Peer from, Peer to
+  multiForwardMsg(...args: unknown[]): unknown
+
+  multiForwardMsgWithComment(...args: unknown[]): unknown
+
+  deleteRecallMsg(...args: unknown[]): unknown
+
+  deleteRecallMsgForLocal(...args: unknown[]): unknown
+
+  addLocalGrayTipMsg(...args: unknown[]): unknown
+
+  addLocalJsonGrayTipMsg(...args: unknown[]): unknown
+
+  addLocalJsonGrayTipMsgExt(...args: unknown[]): unknown
+
+  IsLocalJsonTipValid(...args: unknown[]): unknown
+
+  addLocalAVRecordMsg(...args: unknown[]): unknown
+
+  addLocalTofuRecordMsg(...args: unknown[]): unknown
+
+  addLocalRecordMsg(Peer: Peer, msgId: string, ele: MessageElement, attr: Array<any> | number, front: boolean): Promise<unknown>
+
+  deleteMsg(Peer: Peer, msgIds: Array<string>): Promise<any>
+
+  updateElementExtBufForUI(...args: unknown[]): unknown
+
+  updateMsgRecordExtPbBufForUI(...args: unknown[]): unknown
+
+  startMsgSync(...args: unknown[]): unknown
+
+  startGuildMsgSync(...args: unknown[]): unknown
+
+  isGuildChannelSync(...args: unknown[]): unknown
+
+  getMsgUniqueId(UniqueId: string): string
+
+  isMsgMatched(...args: unknown[]): unknown
+
+  getOnlineFileMsgs(...args: unknown[]): unknown
+
+  getAllOnlineFileMsgs(...args: unknown[]): unknown
+
+  getLatestDbMsgs(peer: Peer, cnt: number): Promise<unknown>
+
+  getLastMessageList(peer: Peer[]): Promise<unknown>
+
+  getAioFirstViewLatestMsgs(peer: Peer, num: number): Promise<GeneralCallResult & {
+    msgList: RawMessage[]
+  }>
+
+  getMsgs(peer: Peer, msgId: string, count: unknown, queryOrder: boolean): Promise<unknown>
+
+  getMsgsIncludeSelf(peer: Peer, msgId: string, count: number, queryOrder: boolean): Promise<GeneralCallResult & {
+    msgList: RawMessage[]
+  }>
+
+  // this.$peer = contact
+  // this.$msgTime = j2
+  // this.$clientSeq = j3
+  // this.$cnt = i2
+
+  getMsgsWithMsgTimeAndClientSeqForC2C(...args: unknown[]): Promise<GeneralCallResult & { msgList: RawMessage[] }>
+
+  getMsgsWithStatus(params: {
+    peer: Peer
+    msgId: string
+    msgTime: unknown
+    cnt: unknown
+    queryOrder: boolean
+    isIncludeSelf: boolean
+    appid: unknown
+  }): Promise<GeneralCallResult & { msgList: RawMessage[] }>
+
+  getMsgsBySeqRange(peer: Peer, startSeq: string, endSeq: string): Promise<GeneralCallResult & { msgList: RawMessage[] }>
+
+  getMsgsBySeqAndCount(peer: Peer, seq: string, count: number, desc: boolean, unknownArg: boolean): Promise<GeneralCallResult & { msgList: RawMessage[] }>
+
+  getMsgsByMsgId(peer: Peer, ids: string[]): Promise<GeneralCallResult & { msgList: RawMessage[] }>
+
+  getRecallMsgsByMsgId(peer: Peer, MsgId: string[]): Promise<unknown>
+
+  getMsgsBySeqList(peer: Peer, seqList: string[]): Promise<GeneralCallResult & { msgList: RawMessage[] }>
+
+  getSingleMsg(Peer: Peer, msgSeq: string): Promise<GeneralCallResult & { msgList: RawMessage[] }>
+
+  getSourceOfReplyMsg(peer: Peer, MsgId: string, SourceSeq: string): unknown
+
+  getSourceOfReplyMsgV2(peer: Peer, RootMsgId: string, ReplyMsgId: string): unknown
+
+  getMsgByClientSeqAndTime(peer: Peer, clientSeq: string, time: string): unknown
+
+  getSourceOfReplyMsgByClientSeqAndTime(peer: Peer, clientSeq: string, time: string): unknown
+  //cnt clientSeq?并不是吧
+  getMsgsByTypeFilter(peer: Peer, msgId: string, cnt: unknown, queryOrder: boolean, typeFilter: { type: number, subtype: Array<number> }): unknown
+
+  getMsgsByTypeFilters(peer: Peer, msgId: string, cnt: unknown, queryOrder: boolean, typeFilters: Array<{ type: number, subtype: Array<number> }>): unknown
+
+  getMsgWithAbstractByFilterParam(...args: unknown[]): unknown
+
+  queryMsgsWithFilter(...args: unknown[]): unknown
+
+  /**
+   * @deprecated 该函数已被标记为废弃，请使用新的替代方法。
+   * 使用过滤条件查询消息列表的版本2接口。
+   * 
+   * 该函数通过一系列过滤条件来查询特定聊天中的消息列表。这些条件包括消息类型、发送者、时间范围等。
+   * 函数返回一个Promise，解析为查询结果的未知类型对象。
+   * 
+   * @param MsgId 消息ID，用于特定消息的查询。
+   * @param MsgTime 消息时间，用于指定消息的时间范围。
+   * @param param 查询参数对象，包含详细的过滤条件和分页信息。
+   * @param param.chatInfo 聊天信息，包括聊天类型和对方用户ID。
+   * @param param.filterMsgType 需要过滤的消息类型数组，留空表示不过滤。
+   * @param param.filterSendersUid 需要过滤的发送者用户ID数组。
+   * @param param.filterMsgFromTime 查询消息的起始时间。
+   * @param param.filterMsgToTime 查询消息的结束时间。
+   * @param param.pageLimit 每页的消息数量限制。
+   * @param param.isReverseOrder 是否按时间顺序倒序返回消息。
+   * @param param.isIncludeCurrent 是否包含当前页码。
+   * @returns 返回一个Promise，解析为查询结果的未知类型对象。
+   */
+  queryMsgsWithFilterVer2(MsgId: string, MsgTime: string, param: QueryMsgsParams): Promise<unknown>
+
+  // this.chatType = i2
+  // this.peerUid = str
+
+  // this.chatInfo = new ChatInfo()
+  // this.filterMsgType = new ArrayList<>()
+  // this.filterSendersUid = new ArrayList<>()
+  // this.chatInfo = chatInfo
+  // this.filterMsgType = arrayList
+  // this.filterSendersUid = arrayList2
+  // this.filterMsgFromTime = j2
+  // this.filterMsgToTime = j3
+  // this.pageLimit = i2
+  // this.isReverseOrder = z
+  // this.isIncludeCurrent = z2
+  //queryMsgsWithFilterEx(0L, 0L, 0L, new QueryMsgsParams(new ChatInfo(2, str), new ArrayList(), new ArrayList(), 0L, 0L, 250, false, true))
+  queryMsgsWithFilterEx(msgId: string, msgTime: string, megSeq: string, param: QueryMsgsParams): Promise<GeneralCallResult & {
+    msgList: RawMessage[]
+  }>
+  //queryMsgsWithFilterEx(this.$msgId, this.$msgTime, this.$msgSeq, this.$param)
+  queryFileMsgsDesktop(...args: unknown[]): unknown
+
+  setMsgRichInfoFlag(...args: unknown[]): unknown
+
+  queryPicOrVideoMsgs(msgId: string, msgTime: string, megSeq: string, param: QueryMsgsParams): Promise<unknown>
+
+  queryPicOrVideoMsgsDesktop(...args: unknown[]): unknown
+
+  queryEmoticonMsgs(msgId: string, msgTime: string, msgSeq: string, Params: QueryMsgsParams): Promise<unknown>
+
+  queryTroopEmoticonMsgs(msgId: string, msgTime: string, msgSeq: string, Params: QueryMsgsParams): Promise<unknown>
+
+  queryMsgsAndAbstractsWithFilter(msgId: string, msgTime: string, megSeq: string, param: QueryMsgsParams): unknown
+
+  setFocusOnGuild(...args: unknown[]): unknown
+
+  setFocusSession(...args: unknown[]): unknown
+
+  enableFilterUnreadInfoNotify(...args: unknown[]): unknown
+
+  enableFilterMsgAbstractNotify(...args: unknown[]): unknown
+
+  onScenesChangeForSilenceMode(...args: unknown[]): unknown
+
+  getContactUnreadCnt(...args: unknown[]): unknown
+
+  getUnreadCntInfo(...args: unknown[]): unknown
+
+  getGuildUnreadCntInfo(...args: unknown[]): unknown
+
+  getGuildUnreadCntTabInfo(...args: unknown[]): unknown
+
+  getAllGuildUnreadCntInfo(...args: unknown[]): unknown
+
+  getAllJoinGuildCnt(...args: unknown[]): unknown
+
+  getAllDirectSessionUnreadCntInfo(...args: unknown[]): unknown
+
+  getCategoryUnreadCntInfo(...args: unknown[]): unknown
+
+  getGuildFeedsUnreadCntInfo(...args: unknown[]): unknown
+
+  setUnVisibleChannelCntInfo(...args: unknown[]): unknown
+
+  setUnVisibleChannelTypeCntInfo(...args: unknown[]): unknown
+
+  setVisibleGuildCntInfo(...args: unknown[]): unknown
+
+  setMsgRead(peer: Peer): Promise<GeneralCallResult>
+
+  setAllC2CAndGroupMsgRead(): Promise<unknown>
+
+  setGuildMsgRead(...args: unknown[]): unknown
+
+  setAllGuildMsgRead(...args: unknown[]): unknown
+
+  setMsgReadAndReport(...args: unknown[]): unknown
+
+  setSpecificMsgReadAndReport(...args: unknown[]): unknown
+
+  setLocalMsgRead(...args: unknown[]): unknown
+
+  setGroupGuildMsgRead(...args: unknown[]): unknown
+
+  getGuildGroupTransData(...args: unknown[]): unknown
+
+  setGroupGuildBubbleRead(...args: unknown[]): unknown
+
+  getGuildGroupBubble(...args: unknown[]): unknown
+
+  fetchGroupGuildUnread(...args: unknown[]): unknown
+
+  setGroupGuildFlag(...args: unknown[]): unknown
+
+  setGuildUDCFlag(...args: unknown[]): unknown
+
+  setGuildTabUserFlag(...args: unknown[]): unknown
+
+  setBuildMode(flag: number/*0 1 3*/): unknown
+
+  setConfigurationServiceData(...args: unknown[]): unknown
+
+  setMarkUnreadFlag(...args: unknown[]): unknown
+
+  getChannelEventFlow(...args: unknown[]): unknown
+
+  getMsgEventFlow(...args: unknown[]): unknown
+
+  getRichMediaFilePathForMobileQQSend(...args: unknown[]): unknown
+
+  getRichMediaFilePathForGuild(arg: {
+    md5HexStr: string,
+    fileName: string,
+    elementType: ElementType,
+    elementSubType: number,
+    thumbSize: 0,
+    needCreate: true,
+    downloadType: 1,
+    file_uuid: ''
+  }): string
+
+  assembleMobileQQRichMediaFilePath(...args: unknown[]): unknown
+
+  getFileThumbSavePathForSend(...args: unknown[]): unknown
+
+  getFileThumbSavePath(...args: unknown[]): unknown
+  //猜测居多
+  translatePtt2Text(MsgId: string, Peer: {}, MsgElement: {}): unknown
+
+  setPttPlayedState(...args: unknown[]): unknown
+  // NodeIQQNTWrapperSession fetchFavEmojiList [
+  //   "",
+  //   48,
+  //   true,
+  //   true
+  // ]
+  fetchFavEmojiList(str: string, num: number, uk1: boolean, uk2: boolean): Promise<GeneralCallResult & {
+    emojiInfoList: Array<{
+      uin: string,
+      emoId: number,
+      emoPath: string,
+      isExist: boolean,
+      resId: string,
+      url: string,
+      md5: string,
+      emoOriginalPath: string,
+      thumbPath: string,
+      RomaingType: string,
+      isAPNG: false,
+      isMarkFace: false,
+      eId: string,
+      epId: string,
+      ocrWord: string,
+      modifyWord: string,
+      exposeNum: number,
+      clickNum: number,
+      desc: string
+    }>
+  }>
+
+  addFavEmoji(...args: unknown[]): unknown
+
+  fetchMarketEmoticonList(...args: unknown[]): unknown
+
+  fetchMarketEmoticonShowImage(...args: unknown[]): unknown
+
+  fetchMarketEmoticonAioImage(...args: unknown[]): unknown
+
+  fetchMarketEmotionJsonFile(...args: unknown[]): unknown
+
+  getMarketEmoticonPath(...args: unknown[]): unknown
+
+  getMarketEmoticonPathBySync(...args: unknown[]): unknown
+
+  fetchMarketEmoticonFaceImages(...args: unknown[]): unknown
+
+  fetchMarketEmoticonAuthDetail(...args: unknown[]): unknown
+
+  getFavMarketEmoticonInfo(...args: unknown[]): unknown
+
+  addRecentUsedFace(...args: unknown[]): unknown
+
+  getRecentUsedFaceList(...args: unknown[]): unknown
+
+  getMarketEmoticonEncryptKeys(...args: unknown[]): unknown
+
+  downloadEmojiPic(...args: unknown[]): unknown
+
+  deleteFavEmoji(...args: unknown[]): unknown
+
+  modifyFavEmojiDesc(...args: unknown[]): unknown
+
+  queryFavEmojiByDesc(...args: unknown[]): unknown
+
+  getHotPicInfoListSearchString(...args: unknown[]): unknown
+
+  getHotPicSearchResult(...args: unknown[]): unknown
+
+  getHotPicHotWords(...args: unknown[]): unknown
+
+  getHotPicJumpInfo(...args: unknown[]): unknown
+
+  getEmojiResourcePath(...args: unknown[]): unknown
+
+  JoinDragonGroupEmoji(JoinDragonGroupEmojiReq: any/*joinDragonGroupEmojiReq*/): unknown
+
+  getMsgAbstracts(...args: unknown[]): unknown
+
+  getMsgAbstract(...args: unknown[]): unknown
+
+  getMsgAbstractList(...args: unknown[]): unknown
+
+  getMsgAbstractListBySeqRange(...args: unknown[]): unknown
+
+  refreshMsgAbstracts(...args: unknown[]): unknown
+
+  refreshMsgAbstractsByGuildIds(...args: unknown[]): unknown
+
+  getRichMediaElement(...args: unknown[]): unknown
+
+  cancelGetRichMediaElement(...args: unknown[]): unknown
+
+  refuseGetRichMediaElement(...args: unknown[]): unknown
+
+  switchToOfflineGetRichMediaElement(...args: unknown[]): unknown
+
+  downloadRichMedia(...args: unknown[]): unknown
+
+  getFirstUnreadMsgSeq(args: {
+    peerUid: string
+    guildId: string
+  }): unknown
+
+  getFirstUnreadCommonMsg(...args: unknown[]): unknown
+
+  getFirstUnreadAtmeMsg(...args: unknown[]): unknown
+
+  getFirstUnreadAtallMsg(...args: unknown[]): unknown
+
+  getNavigateInfo(...args: unknown[]): unknown
+
+  getChannelFreqLimitInfo(...args: unknown[]): unknown
+
+  getRecentUseEmojiList(...args: unknown[]): unknown
+
+  getRecentEmojiList(...args: unknown[]): unknown
+
+  setMsgEmojiLikes(...args: unknown[]): unknown
+
+  getMsgEmojiLikesList(peer: Peer, msgSeq: string, emojiId: string, emojiType: string, cookie: string, bForward: boolean, number: number): Promise<{
+    result: number,
+    errMsg: string,
+    emojiLikesList:
+    Array<{
+      tinyId: string,
+      nickName: string,
+      headUrl: string
+    }>,
+    cookie: string,
+    isLastPage: boolean,
+    isFirstPage: boolean
+  }>
+
+  setMsgEmojiLikesForRole(...args: unknown[]): unknown
+
+  clickInlineKeyboardButton(...args: unknown[]): unknown
+
+  setCurOnScreenMsg(...args: unknown[]): unknown
+
+  setCurOnScreenMsgForMsgEvent(...args: unknown[]): unknown
+
+  getMiscData(key: string): unknown
+
+  setMiscData(key: string, value: string): unknown
+
+  getBookmarkData(...args: unknown[]): unknown
+
+  setBookmarkData(...args: unknown[]): unknown
+
+  sendShowInputStatusReq(ChatType: number, EventType: number, toUid: string): Promise<unknown>
+
+  queryCalendar(...args: unknown[]): unknown
+
+  queryFirstMsgSeq(peer: Peer, ...args: unknown[]): unknown
+
+  queryRoamCalendar(...args: unknown[]): unknown
+
+  queryFirstRoamMsg(...args: unknown[]): unknown
+
+  fetchLongMsg(peer: Peer, msgId: string): unknown
+
+  fetchLongMsgWithCb(...args: unknown[]): unknown
+
+  setIsStopKernelFetchLongMsg(...args: unknown[]): unknown
+
+  insertGameResultAsMsgToDb(...args: unknown[]): unknown
+
+  getMultiMsg(...args: unknown[]): Promise<GeneralCallResult & {
+    msgList: RawMessage[]
+  }>
+
+  setDraft(...args: unknown[]): unknown
+
+  getDraft(...args: unknown[]): unknown
+
+  deleteDraft(...args: unknown[]): unknown
+
+  getRecentHiddenSesionList(...args: unknown[]): unknown
+
+  setRecentHiddenSession(...args: unknown[]): unknown
+
+  delRecentHiddenSession(...args: unknown[]): unknown
+
+  getCurHiddenSession(...args: unknown[]): unknown
+
+  setCurHiddenSession(...args: unknown[]): unknown
+
+  setReplyDraft(...args: unknown[]): unknown
+
+  getReplyDraft(...args: unknown[]): unknown
+
+  deleteReplyDraft(...args: unknown[]): unknown
+
+  getFirstUnreadAtMsg(peer: Peer): unknown
+
+  clearMsgRecords(...args: unknown[]): unknown//设置已读后调用我觉得比较好 清理记录 现在别了
+
+  IsExistOldDb(...args: unknown[]): unknown
+
+  canImportOldDbMsg(...args: unknown[]): unknown
+
+  setPowerStatus(z: boolean): unknown
+
+  canProcessDataMigration(...args: unknown[]): unknown
+
+  importOldDbMsg(...args: unknown[]): unknown
+
+  stopImportOldDbMsgAndroid(...args: unknown[]): unknown
+
+  isMqqDataImportFinished(...args: unknown[]): unknown
+
+  getMqqDataImportTableNames(...args: unknown[]): unknown
+
+  getCurChatImportStatusByUin(...args: unknown[]): unknown
+
+  getDataImportUserLevel(): unknown
+
+  getMsgQRCode(...args: unknown[]): unknown
+
+  getGuestMsgAbstracts(...args: unknown[]): unknown
+
+  getGuestMsgByRange(...args: unknown[]): unknown
+
+  getGuestMsgAbstractByRange(...args: unknown[]): unknown
+
+  registerSysMsgNotification(...args: unknown[]): unknown
+
+  unregisterSysMsgNotification(...args: unknown[]): unknown
+
+  enterOrExitAio(...args: unknown[]): unknown
+
+  // this.peerUid = ""
+  // this.peerNickname = ""
+  // this.fromGroupCode = ""
+  // this.sig = new byte[0]
+  // this.selfUid = ""
+  // this.selfPhone = ""
+  // this.chatType = i2
+  // this.peerUid = str
+  // this.peerNickname = str2
+  // this.fromGroupCode = str3
+  // this.sig = bArr
+  // this.selfUid = str4
+  // this.selfPhone = str5
+  // this.gameSession = tempChatGameSession
+  prepareTempChat(args: unknown): unknown//主动临时消息 不做
+
+  sendSsoCmdReqByContend(cmd: string, param: string): Promise<unknown>
+
+  //chattype,uid->Promise<any>
+  getTempChatInfo(ChatType: number, Uid: string): Promise<TmpChatInfoApi>
+
+  setContactLocalTop(...args: unknown[]): unknown
+
+  switchAnonymousChat(...args: unknown[]): unknown
+
+  renameAnonyChatNick(...args: unknown[]): unknown
+
+  getAnonymousInfo(...args: unknown[]): unknown
+
+  updateAnonymousInfo(...args: unknown[]): unknown
+
+  sendSummonMsg(peer: Peer, MsgElement: unknown, MsgAttributeInfo: unknown): Promise<unknown>//频道的东西
+
+  outputGuildUnreadInfo(...args: unknown[]): unknown
+
+  checkMsgWithUrl(...args: unknown[]): unknown
+
+  checkTabListStatus(...args: unknown[]): unknown
+
+  getABatchOfContactMsgBoxInfo(...args: unknown[]): unknown
+
+  insertMsgToMsgBox(peer: Peer, msgId: string, arg: 2006): unknown
+
+  isHitEmojiKeyword(...args: unknown[]): unknown
+
+  getKeyWordRelatedEmoji(...args: unknown[]): unknown
+
+  recordEmoji(...args: unknown[]): unknown
+
+  fetchGetHitEmotionsByWord(args: Object): Promise<unknown>//表情推荐？
+
+  deleteAllRoamMsgs(...args: unknown[]): unknown//漫游消息？
+
+  packRedBag(...args: unknown[]): unknown
+
+  grabRedBag(...args: unknown[]): unknown
+
+  pullDetail(...args: unknown[]): unknown
+
+  selectPasswordRedBag(...args: unknown[]): unknown
+
+  pullRedBagPasswordList(...args: unknown[]): unknown
+
+  requestTianshuAdv(...args: unknown[]): unknown
+
+  tianshuReport(...args: unknown[]): unknown
+
+  tianshuMultiReport(...args: unknown[]): unknown
+
+  GetMsgSubType(a0: number, a1: number): unknown
+
+  setIKernelPublicAccountAdapter(...args: unknown[]): unknown
+  //tempChatGameSession有关
+  createUidFromTinyId(fromTinyId: string, toTinyId: string): unknown
+
+  dataMigrationGetDataAvaiableContactList(...args: unknown[]): unknown
+
+  dataMigrationGetMsgList(...args: unknown[]): unknown
+
+  dataMigrationStopOperation(...args: unknown[]): unknown
+
+  //新的希望
+  dataMigrationImportMsgPbRecord(DataMigrationMsgInfo: Array<{
+    extensionData: string//"Hex" 
+    extraData: string //""
+    chatType: number
+    chatUin: string
+    msgType: number
+    msgTime: string
+    msgSeq: string
+    msgRandom: string
+  }>, DataMigrationResourceInfo: {
+    extraData: string
+    filePath: string
+    fileSize: string
+    msgRandom: string
+    msgSeq: string
+    msgSubType: number
+    msgType: number
+  }): unknown
+
+  dataMigrationGetResourceLocalDestinyPath(...args: unknown[]): unknown
+
+  dataMigrationSetIOSPathPrefix(...args: unknown[]): unknown
+
+  getServiceAssistantSwitch(...args: unknown[]): unknown
+
+  setServiceAssistantSwitch(...args: unknown[]): unknown
+
+  setSubscribeFolderUsingSmallRedPoint(...args: unknown[]): unknown
+
+  clearGuildNoticeRedPoint(...args: unknown[]): unknown
+
+  clearFeedNoticeRedPoint(...args: unknown[]): unknown
+
+  clearFeedSquareRead(...args: unknown[]): unknown
+
+  IsC2CStyleChatType(...args: unknown[]): unknown
+
+  IsTempChatType(uin: number): unknown//猜的
+
+  getGuildInteractiveNotification(...args: unknown[]): unknown
+
+  getGuildNotificationAbstract(...args: unknown[]): unknown
+
+  setFocusOnBase(...args: unknown[]): unknown
+
+  queryArkInfo(...args: unknown[]): unknown
+
+  queryUserSecQuality(...args: unknown[]): unknown
+
+  getGuildMsgAbFlag(...args: unknown[]): unknown
+
+  getGroupMsgStorageTime(): unknown//这是嘛啊
+
+}

src/ntqqapi/services/NodeIKernelProfileLikeService.ts

@@ -0,0 +1,22 @@
+import { BuddyProfileLikeReq } from '../types'
+import { GeneralCallResult } from './common'
+
+export interface NodeIKernelProfileLikeService {
+  addKernelProfileLikeListener(listener: NodeIKernelProfileLikeService): void
+
+  removeKernelProfileLikeListener(listener: unknown): void
+
+  setBuddyProfileLike(...args: unknown[]): { result: number, errMsg: string, succCounts: number }
+
+  getBuddyProfileLike(req: BuddyProfileLikeReq): Promise<GeneralCallResult & {
+    'info': {
+      'userLikeInfos': Array<any>,
+      'friendMaxVotes': number,
+      'start': number
+    }
+  }>
+
+  getProfileLikeScidResourceInfo(...args: unknown[]): void
+
+  isNull(): boolean
+}

src/ntqqapi/services/NodeIKernelProfileService.ts

@@ -0,0 +1,106 @@
+import { AnyCnameRecord } from 'node:dns'
+import { SimpleInfo } from '../types'
+import { GeneralCallResult } from './common'
+
+export enum UserDetailSource {
+  KDB,
+  KSERVER
+}
+
+export enum ProfileBizType {
+  KALL,
+  KBASEEXTEND,
+  KVAS,
+  KQZONE,
+  KOTHER
+}
+
+export interface NodeIKernelProfileService {
+  getUidByUin(callfrom: string, uin: Array<string>): Promise<Map<string, string>>//uin->uid
+
+  getUinByUid(callfrom: string, uid: Array<string>): Promise<Map<string, string>>
+
+  // {
+  //   coreInfo: CoreInfo,
+  //   baseInfo: BaseInfo,
+  //   status: null,
+  //   vasInfo: null,
+  //   relationFlags: null,
+  //   otherFlags: null,
+  //   intimate: null
+  // }
+  getCoreAndBaseInfo(callfrom: string, uids: string[]): Promise<Map<string, SimpleInfo>>
+
+  fetchUserDetailInfo(trace: string, uids: string[], arg2: number, arg3: number[]): Promise<unknown>
+
+  addKernelProfileListener(listener: any): number
+
+  removeKernelProfileListener(listenerId: number): void
+
+  prepareRegionConfig(...args: unknown[]): unknown
+
+  getLocalStrangerRemark(): Promise<AnyCnameRecord>
+
+  enumCountryOptions(): Array<string>
+
+  enumProvinceOptions(Country: string): Array<string>
+
+  enumCityOptions(Country: string, Province: string): unknown
+
+  enumAreaOptions(...args: unknown[]): unknown
+
+  //SimpleInfo
+  // this.uid = ""
+  // this.uid = str
+  // this.uin = j2
+  // this.isBuddy = z
+  // this.coreInfo = coreInfo
+  // this.baseInfo = baseInfo
+  // this.status = statusInfo
+  // this.vasInfo = vasInfo
+  // this.relationFlags = relationFlag
+  // this.otherFlags = otherFlag
+  // this.intimate = intimate
+
+  modifySelfProfile(...args: unknown[]): Promise<unknown>
+
+  modifyDesktopMiniProfile(param: any): Promise<GeneralCallResult>
+
+  setNickName(NickName: string): Promise<unknown>
+
+  setLongNick(longNick: string): Promise<unknown>
+
+  setBirthday(...args: unknown[]): Promise<unknown>
+
+  setGander(...args: unknown[]): Promise<unknown>
+
+  setHeader(arg: string): Promise<GeneralCallResult>
+
+  setRecommendImgFlag(...args: unknown[]): Promise<unknown>
+
+  getUserSimpleInfo(force: boolean, uids: string[],): Promise<unknown>
+
+  getUserDetailInfo(uid: string): Promise<unknown>
+
+  getUserDetailInfoWithBizInfo(uid: string, Biz: any[]): Promise<GeneralCallResult>
+
+  getUserDetailInfoByUin(uin: string): Promise<any>
+
+  getZplanAvatarInfos(args: string[]): Promise<unknown>
+
+  getStatus(uid: string): Promise<unknown>
+
+  startStatusPolling(isForceReset: boolean): Promise<unknown>
+
+  getSelfStatus(): Promise<unknown>
+
+  setdisableEmojiShortCuts(...args: unknown[]): unknown
+
+  getProfileQzonePicInfo(uid: string, type: number, force: boolean): Promise<unknown>
+
+  //profileService.getCoreInfo("UserRemarkServiceImpl::getStrangerRemarkByUid", arrayList)
+  getCoreInfo(name: string, arg: any[]): unknown
+
+  //m429253e12.getOtherFlag("FriendListInfoCache_getKernelDataAndPutCache", new ArrayList<>())
+  isNull(): boolean
+}

src/ntqqapi/services/NodeIKernelRichMediaService.ts

@@ -0,0 +1,266 @@
+import { GetFileListParam, MessageElement, Peer } from '../types'
+import { GeneralCallResult } from './common'
+
+export enum UrlFileDownloadType {
+  KUNKNOWN,
+  KURLFILEDOWNLOADPRIVILEGEICON,
+  KURLFILEDOWNLOADPHOTOWALL,
+  KURLFILEDOWNLOADQZONE,
+  KURLFILEDOWNLOADCOMMON,
+  KURLFILEDOWNLOADINSTALLAPP
+}
+
+export enum RMBizTypeEnum {
+  KUNKNOWN,
+  KC2CFILE,
+  KGROUPFILE,
+  KC2CPIC,
+  KGROUPPIC,
+  KDISCPIC,
+  KC2CVIDEO,
+  KGROUPVIDEO,
+  KC2CPTT,
+  KGROUPPTT,
+  KFEEDCOMMENTPIC,
+  KGUILDFILE,
+  KGUILDPIC,
+  KGUILDPTT,
+  KGUILDVIDEO
+}
+
+export interface CommonFileInfo {
+  bizType: number
+  chatType: number
+  elemId: string
+  favId: string
+  fileModelId: string
+  fileName: string
+  fileSize: string
+  md5: string
+  md510m: string
+  msgId: string
+  msgTime: string
+  parent: string
+  peerUid: string
+  picThumbPath: Array<string>
+  sha: string
+  sha3: string
+  subId: string
+  uuid: string
+}
+
+export interface NodeIKernelRichMediaService {
+  //getVideoPlayUrl(peer, msgId, elemId, videoCodecFormat, VideoRequestWay.KHAND, cb)
+  // public enum VideoCodecFormatType {
+  //     KCODECFORMATH264,
+  //     KCODECFORMATH265,
+  //     KCODECFORMATH266,
+  //     KCODECFORMATAV1
+  // }
+  // public enum VideoRequestWay {
+  //     KUNKNOW,
+  //     KHAND,
+  //     KAUTO
+  // }
+  getVideoPlayUrl(peer: Peer, msgId: string, elemId: string, videoCodecFormat: number, VideoRequestWay: number): Promise<unknown>
+
+  //exParams (RMReqExParams)
+  // this.downSourceType = i2
+  // this.triggerType = i3
+  //peer, msgId, elemId, videoCodecFormat, exParams
+  // 1 0 频道在用
+  // 1 1
+  // 0 2
+
+  // public static final int KCOMMONREDENVELOPEMSGTYPEINMSGBOX = 1007
+  // public static final int KDOWNSOURCETYPEAIOINNER = 1
+  // public static final int KDOWNSOURCETYPEBIGSCREEN = 2
+  // public static final int KDOWNSOURCETYPEHISTORY = 3
+  // public static final int KDOWNSOURCETYPEUNKNOWN = 0
+
+  // public static final int KTRIGGERTYPEAUTO = 1
+  // public static final int KTRIGGERTYPEMANUAL = 0
+
+  getVideoPlayUrlV2(peer: Peer, msgId: string, elemId: string, videoCodecFormat: number, exParams: { downSourceType: number, triggerType: number }): Promise<GeneralCallResult & {
+    urlResult: {
+      v4IpUrl: [],
+      v6IpUrl: [],
+      domainUrl: Array<{
+        url: string,
+        isHttps: boolean,
+        httpsDomain: string
+      }>,
+      videoCodecFormat: number
+    }
+  }>
+
+  getRichMediaFileDir(elementType: number, downType: number, isTemp: boolean): unknown
+
+  // this.senderUid = ""
+  // this.peerUid = ""
+  // this.guildId = ""
+  // this.elem = new MsgElement()
+  // this.downloadType = i2
+  // this.thumbSize = i3
+  // this.msgId = j2
+  // this.msgRandom = j3
+  // this.msgSeq = j4
+  // this.msgTime = j5
+  // this.chatType = i4
+  // this.senderUid = str
+  // this.peerUid = str2
+  // this.guildId = str3
+  // this.elem = msgElement
+  // this.useHttps = num
+
+  getVideoPlayUrlInVisit(arg: {
+    downloadType: number,
+    thumbSize: number,
+    msgId: string,
+    msgRandom: string,
+    msgSeq: string,
+    msgTime: string,
+    chatType: number,
+    senderUid: string,
+    peerUid: string,
+    guildId: string,
+    ele: MessageElement,
+    useHttps: boolean
+  }): Promise<unknown>
+
+  //arg双端number
+  isFileExpired(arg: number): unknown
+
+  deleteGroupFolder(GroupCode: string, FolderId: string): Promise<GeneralCallResult & { groupFileCommonResult: { retCode: number, retMsg: string, clientWording: string } }>
+
+  //参数与getVideoPlayUrlInVisit一样
+  downloadRichMediaInVisit(arg: {
+    downloadType: number,
+    thumbSize: number,
+    msgId: string,
+    msgRandom: string,
+    msgSeq: string,
+    msgTime: string,
+    chatType: number,
+    senderUid: string,
+    peerUid: string,
+    guildId: string,
+    ele: MessageElement,
+    useHttps: boolean
+  }): unknown
+  //arg3为“”
+  downloadFileForModelId(peer: Peer, ModelId: string[], arg3: string): unknown
+  //第三个参数 Array<Type>
+  // this.fileId = ""
+  // this.fileName = ""
+  // this.fileId = str
+  // this.fileName = str2
+  // this.fileSize = j2
+  // this.fileModelId = j3
+
+  downloadFileForFileUuid(peer: Peer, uuid: string, arg3: {
+    fileId: string,
+    fileName: string,
+    fileSize: string,
+    fileModelId: string
+  }[]): Promise<unknown>
+
+  downloadFileByUrlList(fileDownloadTyp: UrlFileDownloadType, urlList: Array<string>): unknown
+
+  downloadFileForFileInfo(fileInfo: CommonFileInfo[], savePath: string): unknown
+
+  createGroupFolder(GroupCode: string, FolderName: string): Promise<GeneralCallResult & { resultWithGroupItem: { result: any, groupItem: Array<any> } }>
+
+  downloadFile(commonFile: CommonFileInfo, arg2: unknown, arg3: unknown, savePath: string): unknown
+
+  downloadGroupFolder(arg1: unknown, arg2: unknown, arg3: unknown): unknown
+
+  renameGroupFolder(arg1: unknown, arg2: unknown, arg3: unknown): unknown
+
+  deleteTransferInfo(arg1: unknown, arg2: unknown): unknown
+
+  cancelTransferTask(arg1: unknown, arg2: unknown, arg3: unknown): unknown
+
+  cancelUrlDownload(arg: unknown): unknown
+
+  updateOnlineVideoElemStatus(arg: unknown): unknown
+
+  getGroupSpace(arg: unknown): unknown
+
+  getGroupFileList(groupCode: string, params: GetFileListParam): Promise<GeneralCallResult & {
+    groupSpaceResult: {
+      retCode: number
+      retMsg: string
+      clientWording: string
+      totalSpace: number
+      usedSpace: number
+      allUpload: boolean
+    }
+  }>
+
+  getGroupFileInfo(arg1: unknown, arg2: unknown): unknown
+
+  getGroupTransferList(arg1: unknown, arg2: unknown): unknown
+
+  renameGroupFile(arg1: unknown, arg2: unknown, arg3: unknown, arg4: unknown, arg5: unknown): unknown
+
+  moveGroupFile(arg1: unknown, arg2: unknown, arg3: unknown, arg4: unknown, arg5: unknown): unknown
+
+  transGroupFile(arg1: unknown, arg2: unknown): unknown
+
+  searchGroupFile(
+    keywords: Array<string>,
+    param: {
+      groupIds: Array<string>,
+      fileType: number,
+      context: string,
+      count: number,
+      sortType: number,
+      groupNames: Array<string>
+    }): Promise<unknown>
+  searchGroupFileByWord(arg1: unknown, arg2: unknown, arg3: unknown, arg4: unknown, arg5: unknown): unknown
+
+  deleteGroupFile(GroupCode: string, params: Array<number>, Files: Array<string>): Promise<GeneralCallResult & {
+    transGroupFileResult: {
+      result: any
+      successFileIdList: Array<any>
+      failFileIdList: Array<any>
+    }
+  }>
+
+  translateEnWordToZn(words: string[]): Promise<GeneralCallResult & { words: string[] }>
+
+  getScreenOCR(path: string): Promise<unknown>
+
+  batchGetGroupFileCount(Gids: Array<string>): Promise<GeneralCallResult & { groupCodes: Array<string>, groupFileCounts: Array<number> }>
+
+  queryPicDownloadSize(arg: unknown): unknown
+
+  searchGroupFile(arg1: unknown, arg2: unknown): unknown
+
+  searchMoreGroupFile(arg: unknown): unknown
+
+  cancelSearcheGroupFile(arg1: unknown, arg2: unknown, arg3: unknown): unknown
+
+  onlyDownloadFile(peer: Peer, arg2: unknown, arg3: Array<{
+    fileId: string,
+    fileName: string,
+    fileSize: string,
+    fileModelId: string
+  }
+  >): unknown
+
+  onlyUploadFile(arg1: unknown, arg2: unknown): unknown
+
+  isExtraLargePic(arg1: unknown, arg2: unknown, arg3: unknown): unknown
+
+  uploadRMFileWithoutMsg(arg: {
+    bizType: RMBizTypeEnum,
+    filePath: string,
+    peerUid: string,
+    transferId: string
+    useNTV2: string
+  }): Promise<unknown>
+
+  isNull(): boolean
+}

src/ntqqapi/services/NodeIKernelSearchService.ts

@@ -0,0 +1,128 @@
+import { ChatType } from '../types'
+
+export interface NodeIKernelSearchService {
+  addKernelSearchListener(...args: any[]): unknown// needs 1 arguments
+
+  removeKernelSearchListener(...args: any[]): unknown// needs 1 arguments
+
+  searchStranger(...args: any[]): unknown// needs 3 arguments
+
+  searchGroup(...args: any[]): unknown// needs 1 arguments
+
+  searchLocalInfo(keywords: string, unknown: number/*4*/): unknown
+
+  cancelSearchLocalInfo(...args: any[]): unknown// needs 3 arguments
+
+  searchBuddyChatInfo(...args: any[]): unknown// needs 2 arguments
+
+  searchMoreBuddyChatInfo(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchBuddyChatInfo(...args: any[]): unknown// needs 3 arguments
+
+  searchContact(...args: any[]): unknown// needs 2 arguments
+
+  searchMoreContact(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchContact(...args: any[]): unknown// needs 3 arguments
+
+  searchGroupChatInfo(...args: any[]): unknown// needs 3 arguments
+
+  resetSearchGroupChatInfoSortType(...args: any[]): unknown// needs 3 arguments
+
+  resetSearchGroupChatInfoFilterMembers(...args: any[]): unknown// needs 3 arguments
+
+  searchMoreGroupChatInfo(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchGroupChatInfo(...args: any[]): unknown// needs 3 arguments
+
+  searchChatsWithKeywords(...args: any[]): unknown// needs 3 arguments
+
+  searchMoreChatsWithKeywords(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchChatsWithKeywords(...args: any[]): unknown// needs 3 arguments
+
+  searchChatMsgs(...args: any[]): unknown// needs 2 arguments
+
+  searchMoreChatMsgs(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchChatMsgs(...args: any[]): unknown// needs 3 arguments
+
+  searchMsgWithKeywords(...args: any[]): unknown// needs 2 arguments
+
+  searchMoreMsgWithKeywords(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchMsgWithKeywords(...args: any[]): unknown// needs 3 arguments
+
+  searchFileWithKeywords(keywords: string[], source: number): Promise<string>// needs 2 arguments
+
+  searchMoreFileWithKeywords(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchFileWithKeywords(...args: any[]): unknown// needs 3 arguments
+
+  searchAtMeChats(...args: any[]): unknown// needs 3 arguments
+
+  searchMoreAtMeChats(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchAtMeChats(...args: any[]): unknown// needs 3 arguments
+
+  searchChatAtMeMsgs(...args: any[]): unknown// needs 1 arguments
+
+  searchMoreChatAtMeMsgs(...args: any[]): unknown// needs 1 arguments
+
+  cancelSearchChatAtMeMsgs(...args: any[]): unknown// needs 3 arguments
+
+  addSearchHistory(param: {
+    type: number,//4
+    contactList: [],
+    id: number,//-1
+    groupInfos: [],
+    msgs: [],
+    fileInfos: [
+      {
+        chatType: ChatType,
+        buddyChatInfo: Array<{ category_name: string, peerUid: string, peerUin: string, remark: string }>,
+        discussChatInfo: [],
+        groupChatInfo: Array<
+          {
+            groupCode: string,
+            isConf: boolean,
+            hasModifyConfGroupFace: boolean,
+            hasModifyConfGroupName: boolean,
+            groupName: string,
+            remark: string
+          }>,
+        dataLineChatInfo: [],
+        tmpChatInfo: [],
+        msgId: string,
+        msgSeq: string,
+        msgTime: string,
+        senderUid: string,
+        senderNick: string,
+        senderRemark: string,
+        senderCard: string,
+        elemId: string,
+        elemType: string,//3
+        fileSize: string,
+        filePath: string,
+        fileName: string,
+        hits: Array<
+          {
+            start: 12,
+            end: 14
+          }
+        >
+      }
+    ]
+
+  }): Promise<{
+    result: number,
+    errMsg: string,
+    id?: number
+  }>
+
+  removeSearchHistory(...args: any[]): unknown// needs 1 arguments
+
+  searchCache(...args: any[]): unknown// needs 3 arguments
+
+  clearSearchCache(...args: any[]): unknown// needs 1 arguments
+}

src/ntqqapi/services/NodeIKernelTicketService.ts

@@ -0,0 +1,11 @@
+import { forceFetchClientKeyRetType } from './common'
+
+export interface NodeIKernelTicketService {
+  addKernelTicketListener(listener: unknown): void
+
+  removeKernelTicketListener(listenerId: unknown): void
+
+  forceFetchClientKey(arg: string): Promise<forceFetchClientKeyRetType>
+
+  isNull(): boolean
+}

src/ntqqapi/services/NodeIKernelTipOffService.ts

@@ -0,0 +1,19 @@
+import { GeneralCallResult } from './common'
+
+export interface NodeIKernelTipOffService {
+  addKernelTipOffListener(listener: unknown): void
+
+  removeKernelTipOffListener(listenerId: unknown): void
+
+  tipOffSendJsData(args: unknown[]): Promise<unknown> //2
+
+  getPskey(domainList: string[], nocache: boolean): Promise<GeneralCallResult & { domainPskeyMap: Map<string, string> }> //2
+
+  tipOffSendJsData(args: unknown[]): Promise<unknown> //2
+
+  tipOffMsgs(args: unknown[]): Promise<unknown> //1
+
+  encodeUinAesInfo(args: unknown[]): Promise<unknown> //2
+
+  isNull(): boolean
+}

src/ntqqapi/services/NodeIKernelUixConvertService.ts

@@ -0,0 +1,5 @@
+export interface NodeIKernelUixConvertService {
+  getUin(uid: string[]): Promise<{ uinInfo: Map<string, string> }>
+
+  getUid(uin: string[]): Promise<{ uidInfo: Map<string, string> }>
+}

src/ntqqapi/services/common.ts

@@ -0,0 +1,16 @@
+export enum GeneralCallResultStatus {
+  OK = 0
+  // ERROR = 1
+}
+
+export interface GeneralCallResult {
+  result: GeneralCallResultStatus
+  errMsg: string
+}
+
+export interface forceFetchClientKeyRetType extends GeneralCallResult {
+  url: string
+  keyIndex: string
+  clientKey: string
+  expireTime: string
+}

src/ntqqapi/services/index.ts

@@ -0,0 +1,12 @@
+export * from './common'
+export * from './NodeIKernelBuddyService'
+export * from './NodeIKernelProfileService'
+export * from './NodeIKernelGroupService'
+export * from './NodeIKernelProfileLikeService'
+export * from './NodeIKernelMsgService'
+export * from './NodeIKernelMSFService'
+export * from './NodeIKernelUixConvertService'
+export * from './NodeIKernelRichMediaService'
+export * from './NodeIKernelTicketService'
+export * from './NodeIKernelTipOffService'
+export * from './NodeIKernelSearchService'

src/ntqqapi/types/cache.ts

@@ -0,0 +1,66 @@
+import { ChatType } from './msg'
+
+export interface CacheScanResult {
+  result: number
+  size: [
+    // 单位为字节
+    string, // 系统总存储空间
+    string, // 系统可用存储空间
+    string, // 系统已用存储空间
+    string, // QQ总大小
+    string, // 「聊天与文件」大小
+    string, // 未知
+    string, // 「缓存数据」大小
+    string, // 「其他数据」大小
+    string, // 未知
+  ]
+}
+
+export interface ChatCacheList {
+  pageCount: number
+  infos: ChatCacheListItem[]
+}
+
+export interface ChatCacheListItem {
+  chatType: ChatType
+  basicChatCacheInfo: ChatCacheListItemBasic
+  guildChatCacheInfo: unknown[] // TODO: 没用过频道所以不知道这里边的详细内容
+}
+
+export interface ChatCacheListItemBasic {
+  chatSize: string
+  chatTime: string
+  uid: string
+  uin: string
+  remarkName: string
+  nickName: string
+  chatType?: ChatType
+  isChecked?: boolean
+}
+
+export enum CacheFileType {
+  IMAGE = 0,
+  VIDEO = 1,
+  AUDIO = 2,
+  DOCUMENT = 3,
+  OTHER = 4,
+}
+
+export interface CacheFileList {
+  infos: CacheFileListItem[]
+}
+
+export interface CacheFileListItem {
+  fileSize: string
+  fileTime: string
+  fileKey: string
+  elementId: string
+  elementIdStr: string
+  fileType: CacheFileType
+  path: string
+  fileName: string
+  senderId: string
+  previewPath: string
+  senderName: string
+  isChecked?: boolean
+}

src/ntqqapi/types/group.ts

@@ -0,0 +1,67 @@
+import { QQLevel, Sex } from './user'
+
+export enum GroupListUpdateType {
+  REFRESHALL,
+  GETALL,
+  MODIFIED,
+  REMOVE
+}
+
+export interface Group {
+  groupCode: string
+  maxMember: number
+  memberCount: number
+  groupName: string
+  groupStatus: 0
+  memberRole: 2
+  isTop: boolean
+  toppedTimestamp: '0'
+  privilegeFlag: number //65760
+  isConf: boolean
+  hasModifyConfGroupFace: boolean
+  hasModifyConfGroupName: boolean
+  remarkName: string
+  hasMemo: boolean
+  groupShutupExpireTime: string //"0",
+  personShutupExpireTime: string //"0",
+  discussToGroupUin: string //"0",
+  discussToGroupMaxMsgSeq: number
+  discussToGroupTime: number
+  groupFlagExt: number //1073938496,
+  authGroupType: number //0,
+  groupCreditLevel: number //0,
+  groupFlagExt3: number //0,
+  groupOwnerId: {
+    memberUin: string //"0",
+    memberUid: string //"u_fbf8N7aeuZEnUiJAbQ9R8Q"
+  }
+  members: GroupMember[] // 原始数据是没有这个的，为了方便自己加了这个字段
+  createTime: string
+}
+
+export enum GroupMemberRole {
+  normal = 2,
+  admin = 3,
+  owner = 4,
+}
+
+export interface GroupMember {
+  memberSpecialTitle?: string
+  avatarPath: string
+  cardName: string
+  cardType: number
+  isDelete: boolean
+  nick: string
+  qid: string
+  remark: string
+  role: GroupMemberRole // 群主:4, 管理员:3，群员:2
+  shutUpTime: number // 禁言时间，单位是什么暂时不清楚
+  uid: string // 加密的字符串
+  uin: string // QQ号
+  isRobot: boolean
+  sex?: Sex
+  qqLevel?: QQLevel
+  isChangeRole: boolean
+  joinTime: string
+  lastSpeakTime: string
+}

src/ntqqapi/types/index.ts

@@ -0,0 +1,5 @@
+export * from './user'
+export * from './group'
+export * from './msg'
+export * from './notify'
+export * from './cache'

src/ntqqapi/types/msg.ts

@@ -0,0 +1,544 @@
+import { GroupMemberRole } from './group'
+
+export interface GetFileListParam {
+  sortType: number
+  fileCount: number
+  startIndex: number
+  sortOrder: number
+  showOnlinedocFolder: number
+}
+
+export enum ElementType {
+  UNKNOWN = 0,
+  TEXT = 1,
+  PIC = 2,
+  FILE = 3,
+  PTT = 4,
+  VIDEO = 5,
+  FACE = 6,
+  REPLY = 7,
+  WALLET = 9,
+  GreyTip = 8, //Poke别叫戳一搓了 官方名字拍一拍 戳一戳是另一个名字
+  ARK = 10,
+  MFACE = 11,
+  LIVEGIFT = 12,
+  STRUCTLONGMSG = 13,
+  MARKDOWN = 14,
+  GIPHY = 15,
+  MULTIFORWARD = 16,
+  INLINEKEYBOARD = 17,
+  INTEXTGIFT = 18,
+  CALENDAR = 19,
+  YOLOGAMERESULT = 20,
+  AVRECORD = 21,
+  FEED = 22,
+  TOFURECORD = 23,
+  ACEBUBBLE = 24,
+  ACTIVITY = 25,
+  TOFU = 26,
+  FACEBUBBLE = 27,
+  SHARELOCATION = 28,
+  TASKTOPMSG = 29,
+  RECOMMENDEDMSG = 43,
+  ACTIONBAR = 44
+}
+
+export interface SendTextElement {
+  elementType: ElementType.TEXT
+  elementId: ''
+  textElement: TextElement
+}
+
+export interface SendPttElement {
+  elementType: ElementType.PTT
+  elementId: ''
+  pttElement: {
+    fileName: string
+    filePath: string
+    md5HexStr: string
+    fileSize: number
+    duration: number // 单位是秒
+    formatType: number
+    voiceType: number
+    voiceChangeType: number
+    canConvert2Text: boolean
+    waveAmplitudes: number[]
+    fileSubId: ''
+    playState: number
+    autoConvertText: number
+  }
+}
+
+export enum PicType {
+  gif = 2000,
+  jpg = 1000,
+}
+
+export enum PicSubType {
+  normal = 0, // 普通图片，大图
+  face = 1, // 表情包小图
+}
+
+export interface SendPicElement {
+  elementType: ElementType.PIC
+  elementId: ''
+  picElement: {
+    md5HexStr: string
+    fileSize: number | string
+    picWidth: number
+    picHeight: number
+    fileName: string
+    sourcePath: string
+    original: boolean
+    picType: PicType
+    picSubType: PicSubType
+    fileUuid: string
+    fileSubId: string
+    thumbFileSize: number
+    summary: string
+  }
+}
+
+export interface SendReplyElement {
+  elementType: ElementType.REPLY
+  elementId: ''
+  replyElement: ReplyElement
+}
+
+export interface SendFaceElement {
+  elementType: ElementType.FACE
+  elementId: ''
+  faceElement: FaceElement
+}
+
+export interface SendMarketFaceElement {
+  elementType: ElementType.MFACE
+  marketFaceElement: MarketFaceElement
+}
+
+export interface TextElement {
+  content: string
+  atType: number
+  atUid: string
+  atTinyId: string
+  atNtUid: string
+}
+
+export interface ReplyElement {
+  replayMsgSeq: string
+  replayMsgId: string
+  senderUin: string
+  senderUinStr: string
+}
+
+export interface FileElement {
+  fileMd5?: string
+  fileName: string
+  filePath: string
+  fileSize: string
+  picHeight?: number
+  picWidth?: number
+  folderId?: string
+  picThumbPath?: Map<number, string>
+  file10MMd5?: string
+  fileSha?: string
+  fileSha3?: string
+  fileUuid?: string
+  fileSubId?: string
+  thumbFileSize?: number
+  fileBizId?: number
+}
+
+export interface SendFileElement {
+  elementType: ElementType.FILE
+  elementId: ''
+  fileElement: FileElement
+}
+
+export interface SendVideoElement {
+  elementType: ElementType.VIDEO
+  elementId: ''
+  videoElement: VideoElement
+}
+
+export interface SendArkElement {
+  elementType: ElementType.ARK
+  elementId: ''
+  arkElement: ArkElement
+}
+
+export type SendMessageElement =
+  | SendTextElement
+  | SendPttElement
+  | SendPicElement
+  | SendReplyElement
+  | SendFaceElement
+  | SendMarketFaceElement
+  | SendFileElement
+  | SendVideoElement
+  | SendArkElement
+
+export enum AtType {
+  notAt = 0,
+  atAll = 1,
+  atUser = 2,
+}
+
+export enum ChatType {
+  friend = 1,
+  group = 2,
+  temp = 100,
+}
+
+// 来自Android分析
+export enum ChatType2 {
+  KCHATTYPEADELIE = 42,
+  KCHATTYPEBUDDYNOTIFY = 5,
+  KCHATTYPEC2C = 1,
+  KCHATTYPECIRCLE = 113,
+  KCHATTYPEDATALINE = 8,
+  KCHATTYPEDATALINEMQQ = 134,
+  KCHATTYPEDISC = 3,
+  KCHATTYPEFAV = 41,
+  KCHATTYPEGAMEMESSAGE = 105,
+  KCHATTYPEGAMEMESSAGEFOLDER = 116,
+  KCHATTYPEGROUP = 2,
+  KCHATTYPEGROUPBLESS = 133,
+  KCHATTYPEGROUPGUILD = 9,
+  KCHATTYPEGROUPHELPER = 7,
+  KCHATTYPEGROUPNOTIFY = 6,
+  KCHATTYPEGUILD = 4,
+  KCHATTYPEGUILDMETA = 16,
+  KCHATTYPEMATCHFRIEND = 104,
+  KCHATTYPEMATCHFRIENDFOLDER = 109,
+  KCHATTYPENEARBY = 106,
+  KCHATTYPENEARBYASSISTANT = 107,
+  KCHATTYPENEARBYFOLDER = 110,
+  KCHATTYPENEARBYHELLOFOLDER = 112,
+  KCHATTYPENEARBYINTERACT = 108,
+  KCHATTYPEQQNOTIFY = 132,
+  KCHATTYPERELATEACCOUNT = 131,
+  KCHATTYPESERVICEASSISTANT = 118,
+  KCHATTYPESERVICEASSISTANTSUB = 201,
+  KCHATTYPESQUAREPUBLIC = 115,
+  KCHATTYPESUBSCRIBEFOLDER = 30,
+  KCHATTYPETEMPADDRESSBOOK = 111,
+  KCHATTYPETEMPBUSSINESSCRM = 102,
+  KCHATTYPETEMPC2CFROMGROUP = 100,
+  KCHATTYPETEMPC2CFROMUNKNOWN = 99,
+  KCHATTYPETEMPFRIENDVERIFY = 101,
+  KCHATTYPETEMPNEARBYPRO = 119,
+  KCHATTYPETEMPPUBLICACCOUNT = 103,
+  KCHATTYPETEMPWPA = 117,
+  KCHATTYPEUNKNOWN = 0,
+  KCHATTYPEWEIYUN = 40,
+}
+
+export interface PttElement {
+  canConvert2Text: boolean
+  duration: number // 秒数
+  fileBizId: null
+  fileId: number // 0
+  fileName: string // "e4d09c784d5a2abcb2f9980bdc7acfe6.amr"
+  filePath: string // "/Users//Library/Containers/com.tencent.qq/Data/Library/Application Support/QQ/nt_qq_a6b15c9820595d25a56c1633ce19ad40/nt_data/Ptt/2023-11/Ori/e4d09c784d5a2abcb2f9980bdc7acfe6.amr"
+  fileSize: string // "4261"
+  fileSubId: string // "0"
+  fileUuid: string // "90j3z7rmRphDPrdVgP9udFBaYar#oK0TWZIV"
+  formatType: string // 1
+  invalidState: number // 0
+  md5HexStr: string // "e4d09c784d5a2abcb2f9980bdc7acfe6"
+  playState: number // 0
+  progress: number // 0
+  text: string // ""
+  transferStatus: number // 0
+  translateStatus: number // 0
+  voiceChangeType: number // 0
+  voiceType: number // 0
+  waveAmplitudes: number[]
+}
+
+export interface ArkElement {
+  bytesData: string
+  linkInfo: null
+  subElementType: null
+}
+
+export const IMAGE_HTTP_HOST = 'https://gchat.qpic.cn'
+export const IMAGE_HTTP_HOST_NT = 'https://multimedia.nt.qq.com.cn'
+
+export interface PicElement {
+  picSubType: PicSubType
+  picType: PicType  // 有这玩意儿吗
+  originImageUrl: string // http url, 没有host，host是https://gchat.qpic.cn/, 带download参数的是https://multimedia.nt.qq.com.cn
+  originImageMd5?: string
+  sourcePath: string // 图片本地路径
+  thumbPath: Map<number, string>
+  picWidth: number
+  picHeight: number
+  fileSize: string
+  fileName: string
+  fileUuid: string
+  md5HexStr?: string
+}
+
+export enum GrayTipElementSubType {
+  RECALL = 1,
+  INVITE_NEW_MEMBER = 12,
+  MEMBER_NEW_TITLE = 17,
+}
+
+export interface GrayTipElement {
+  subElementType: GrayTipElementSubType
+  revokeElement: {
+    operatorRole: string
+    operatorUid: string
+    operatorNick: string
+    operatorRemark: string
+    operatorMemRemark?: string
+    origMsgSenderUid?: string
+    isSelfOperate?: boolean
+    wording: string // 自定义的撤回提示语
+  }
+  aioOpGrayTipElement: TipAioOpGrayTipElement
+  groupElement: TipGroupElement
+  xmlElement: {
+    templId: string
+    content: string
+  }
+  jsonGrayTipElement: {
+    busiId: number
+    jsonStr: string
+  }
+}
+
+
+export enum FaceIndex {
+  dice = 358,
+  RPS = 359, // 石头剪刀布
+}
+
+export interface FaceElement {
+  faceIndex: number
+  faceType: number
+  faceText?: string
+  packId?: string
+  stickerId?: string
+  sourceType?: number
+  stickerType?: number
+  resultId?: string
+  surpriseId?: string
+  randomType?: number
+}
+
+export interface MarketFaceElement {
+  emojiPackageId: number
+  faceName?: string
+  emojiId: string
+  key: string
+  imageWidth?: number
+  imageHeight?: number
+}
+
+export interface VideoElement {
+  filePath: string
+  fileName: string
+  videoMd5?: string
+  thumbMd5?: string
+  fileTime?: number // second
+  thumbSize?: number // byte
+  fileFormat?: number // 2表示mp4？
+  fileSize?: string // byte
+  thumbWidth?: number
+  thumbHeight?: number
+  busiType?: 0 // 未知
+  subBusiType?: 0 // 未知
+  thumbPath?: Map<number, any>
+  transferStatus?: 0 // 未知
+  progress?: 0 // 下载进度？
+  invalidState?: 0 // 未知
+  fileUuid?: string // 可以用于下载链接？
+  fileSubId?: ''
+  fileBizId?: null
+  originVideoMd5?: ''
+  import_rich_media_context?: null
+  sourceVideoCodecFormat?: number
+}
+
+export interface MarkdownElement {
+  content: string
+}
+
+export interface InlineKeyboardElementRowButton {
+  id: ''
+  label: string
+  visitedLabel: string
+  style: 1 // 未知
+  type: 2 // 未知
+  clickLimit: 0 // 未知
+  unsupportTips: '请升级新版手机QQ'
+  data: string
+  atBotShowChannelList: false
+  permissionType: 2
+  specifyRoleIds: []
+  specifyTinyids: []
+  isReply: false
+  anchor: 0
+  enter: false
+  subscribeDataTemplateIds: []
+}
+export interface InlineKeyboardElement {
+  rows: [
+    {
+      buttons: InlineKeyboardElementRowButton[]
+    },
+  ]
+}
+
+export interface TipAioOpGrayTipElement {
+  // 这是什么提示来着？
+  operateType: number
+  peerUid: string
+  fromGrpCodeOfTmpChat: string
+}
+
+export enum TipGroupElementType {
+  memberIncrease = 1,
+  kicked = 3, // 被移出群
+  ban = 8,
+}
+
+export interface TipGroupElement {
+  type: TipGroupElementType // 1是表示有人加入群, 自己加入群也会收到这个
+  role: 0 // 暂时不知
+  groupName: string // 暂时获取不到
+  memberUid: string
+  memberNick: string
+  memberRemark: string
+  adminUid: string
+  adminNick: string
+  adminRemark: string
+  createGroup: null
+  memberAdd?: {
+    showType: 1
+    otherAdd: null
+    otherAddByOtherQRCode: null
+    otherAddByYourQRCode: null
+    youAddByOtherQRCode: null
+    otherInviteOther: null
+    otherInviteYou: null
+    youInviteOther: null
+  }
+  shutUp?: {
+    curTime: string
+    duration: string // 禁言时间，秒
+    admin: {
+      uid: string
+      card: string
+      name: string
+      role: GroupMemberRole
+    }
+    member: {
+      uid: string
+      card: string
+      name: string
+      role: GroupMemberRole
+    }
+  }
+}
+
+export interface MultiForwardMsgElement {
+  xmlContent: string // xml格式的消息内容
+  resId: string
+  fileName: string
+}
+
+export interface RawMessage {
+  msgId: string
+  msgType: number
+  subMsgType: number
+  msgShortId?: number // 自己维护的消息id
+  msgTime: string // 时间戳，秒
+  msgSeq: string
+  msgRandom: string
+  senderUid: string
+  senderUin?: string // 发送者QQ号
+  peerUid: string // 群号 或者 QQ uid
+  peerUin: string // 群号 或者 发送者QQ号
+  guildId: string
+  sendNickName: string
+  sendMemberName?: string // 发送者群名片
+  chatType: ChatType
+  sendStatus?: number // 消息状态，别人发的2是已撤回，自己发的2是已发送
+  recallTime: string // 撤回时间, "0"是没有撤回
+  records: RawMessage[]
+  elements: {
+    elementId: string
+    elementType: ElementType
+    replyElement: {
+      sourceMsgIdInRecords: string
+      senderUid: string // 原消息发送者QQ号
+      sourceMsgIsIncPic: boolean // 原消息是否有图片
+      sourceMsgText: string
+      replayMsgSeq: string // 源消息的msgSeq，可以通过这个找到源消息的msgId
+      senderUidStr: string
+      replyMsgTime: string
+    }
+    textElement: {
+      atType: AtType
+      atUid: string // QQ号
+      content: string
+      atNtUid: string // uid号
+    }
+    picElement: PicElement
+    pttElement: PttElement
+    arkElement: ArkElement
+    grayTipElement: GrayTipElement
+    faceElement: FaceElement
+    videoElement: VideoElement
+    fileElement: FileElement
+    marketFaceElement: MarketFaceElement
+    inlineKeyboardElement: InlineKeyboardElement
+    markdownElement: MarkdownElement
+    multiForwardMsgElement: MultiForwardMsgElement
+  }[]
+}
+
+export interface Peer {
+  chatType: ChatType
+  peerUid: string  // 如果是群聊uid为群号，私聊uid就是加密的字符串
+  guildId?: string
+}
+
+export interface MessageElement {
+  elementType: ElementType
+  elementId: string
+  extBufForUI: string //"0x"
+  textElement?: TextElement
+  faceElement?: FaceElement
+  marketFaceElement?: MarkdownElement
+  replyElement?: ReplyElement
+  picElement?: PicElement
+  pttElement?: PttElement
+  videoElement?: VideoElement
+  grayTipElement?: GrayTipElement
+  arkElement?: ArkElement
+  fileElement?: FileElement
+  liveGiftElement?: null
+  markdownElement?: MarkdownElement
+  structLongMsgElement?: any
+  multiForwardMsgElement?: MultiForwardMsgElement
+  giphyElement?: any
+  walletElement?: null
+  inlineKeyboardElement?: InlineKeyboardElement
+  textGiftElement?: null //????
+  calendarElement?: any
+  yoloGameResultElement?: any
+  avRecordElement?: any
+  structMsgElement?: null
+  faceBubbleElement?: any
+  shareLocationElement?: any
+  tofuRecordElement?: any
+  taskTopMsgElement?: any
+  recommendedMsgElement?: any
+  actionBarElement?: any
+}

src/ntqqapi/types/notify.ts

@@ -0,0 +1,131 @@
+export enum GroupNotifyType {
+  INVITED_BY_MEMBER = 1,
+  REFUSE_INVITED,
+  REFUSED_BY_ADMINI_STRATOR,
+  AGREED_TOJOIN_DIRECT, // 有人接受了邀请入群
+  INVITED_NEED_ADMINI_STRATOR_PASS, // 有人邀请了别人入群
+  AGREED_TO_JOIN_BY_ADMINI_STRATOR,
+  REQUEST_JOIN_NEED_ADMINI_STRATOR_PASS,
+  SET_ADMIN,
+  KICK_MEMBER_NOTIFY_ADMIN,
+  KICK_MEMBER_NOTIFY_KICKED,
+  MEMBER_LEAVE_NOTIFY_ADMIN, // 主动退出
+  CANCEL_ADMIN_NOTIFY_CANCELED, // 我被取消管理员
+  CANCEL_ADMIN_NOTIFY_ADMIN, // 其他人取消管理员
+  TRANSFER_GROUP_NOTIFY_OLDOWNER,
+  TRANSFER_GROUP_NOTIFY_ADMIN
+}
+
+export interface GroupNotifies {
+  doubt: boolean
+  nextStartSeq: string
+  notifies: GroupNotify[]
+}
+
+export enum GroupNotifyStatus {
+  KINIT, // 初始化
+  KUNHANDLE, // 未处理
+  KAGREED, // 同意
+  KREFUSED, // 拒绝
+  KIGNORED // 忽略
+}
+
+export interface GroupNotify {
+  time: number // 自己添加的字段，时间戳，毫秒, 用于判断收到短时间内收到重复的notify
+  seq: string // 唯一标识符，转成数字再除以1000应该就是时间戳？
+  type: GroupNotifyType
+  status: GroupNotifyStatus
+  group: { groupCode: string; groupName: string }
+  user1: { uid: string; nickName: string } // 被设置管理员的人
+  user2: { uid: string; nickName: string } // 操作者
+  actionUser: { uid: string; nickName: string } //未知
+  actionTime: string
+  invitationExt: {
+    srcType: number // 0?未知
+    groupCode: string
+    waitStatus: number
+  }
+  postscript: string // 加群用户填写的验证信息
+  repeatSeqs: []
+  warningTips: string
+}
+
+export enum GroupRequestOperateTypes {
+  approve = 1,
+  reject = 2,
+}
+
+export enum BuddyReqType {
+  KMEINITIATOR,
+  KPEERINITIATOR,
+  KMEAGREED,
+  KMEAGREEDANDADDED,
+  KPEERAGREED,
+  KPEERAGREEDANDADDED,
+  KPEERREFUSED,
+  KMEREFUSED,
+  KMEIGNORED,
+  KMEAGREEANYONE,
+  KMESETQUESTION,
+  KMEAGREEANDADDFAILED,
+  KMSGINFO,
+  KMEINITIATORWAITPEERCONFIRM
+}
+
+export interface FriendRequest {
+  isInitiator?: boolean
+  isDecide: boolean
+  friendUid: string
+  reqType: BuddyReqType
+  reqTime: string // 时间戳,秒
+  extWords: string // 申请人填写的验证消息
+  isUnread: boolean
+  friendNick: string
+  sourceId: number
+  groupCode: string
+}
+
+export interface FriendRequestNotify {
+  data: {
+    unreadNums: number
+    buddyReqs: FriendRequest[]
+  }
+}
+
+export enum MemberExtSourceType {
+  DEFAULTTYPE = 0,
+  TITLETYPE = 1,
+  NEWGROUPTYPE = 2,
+}
+
+export interface GroupExtParam {
+  groupCode: string
+  seq: string
+  beginUin: string
+  dataTime: string
+  uinList: Array<string>
+  uinNum: string
+  groupType: string
+  richCardNameVer: string
+  sourceType: MemberExtSourceType
+  memberExtFilter: {
+    memberLevelInfoUin: number
+    memberLevelInfoPoint: number
+    memberLevelInfoActiveDay: number
+    memberLevelInfoLevel: number
+    memberLevelInfoName: number
+    levelName: number
+    dataTime: number
+    userShowFlag: number
+    sysShowFlag: number
+    timeToUpdate: number
+    nickName: number
+    specialTitle: number
+    levelNameNew: number
+    userShowFlagNew: number
+    msgNeedField: number
+    cmdUinFlagExt3Grocery: number
+    memberIcon: number
+    memberInfoSeq: number
+  }
+}

src/ntqqapi/types/user.ts

@@ -0,0 +1,346 @@
+export enum Sex {
+  male = 0,
+  female = 2,
+  unknown = 255,
+}
+
+export interface QQLevel {
+  crownNum: number
+  sunNum: number
+  moonNum: number
+  starNum: number
+}
+
+export interface User {
+  uid: string // 加密的字符串
+  uin: string // QQ号
+  nick: string
+  avatarUrl?: string
+  longNick?: string // 签名
+  remark?: string
+  sex?: Sex
+  qqLevel?: QQLevel
+  qid?: string
+  birthday_year?: number
+  birthday_month?: number
+  birthday_day?: number
+  topTime?: string
+  constellation?: number
+  shengXiao?: number
+  kBloodType?: number
+  homeTown?: string //"0-0-0",
+  makeFriendCareer?: number
+  pos?: string
+  eMail?: string
+  phoneNum?: string
+  college?: string
+  country?: string
+  province?: string
+  city?: string
+  postCode?: string
+  address?: string
+  isBlock?: boolean
+  isSpecialCareOpen?: boolean
+  isSpecialCareZone?: boolean
+  ringId?: string
+  regTime?: number
+  interest?: string
+  labels?: string[]
+  isHideQQLevel?: number
+  privilegeIcon?: {
+    jumpUrl: string
+    openIconList: unknown[]
+    closeIconList: unknown[]
+  }
+  photoWall?: {
+    picList: unknown[]
+  }
+  vipFlag?: boolean
+  yearVipFlag?: boolean
+  svipFlag?: boolean
+  vipLevel?: number
+  status?: number
+  qidianMasterFlag?: number
+  qidianCrewFlag?: number
+  qidianCrewFlag2?: number
+  extStatus?: number
+  recommendImgFlag?: number
+  disableEmojiShortCuts?: number
+  pendantId?: string
+}
+
+export interface SelfInfo extends User {
+  online?: boolean
+}
+
+export interface Friend extends User {
+}
+
+export interface CategoryFriend {
+  categoryId: number
+  categorySortId: number
+  categroyName: string
+  categroyMbCount: number
+  onlineCount: number
+  buddyList: User[] // V1
+  buddyUids: string[]
+}
+
+export interface CoreInfo {
+  uid: string
+  uin: string
+  nick: string
+  remark: string
+}
+
+export interface BaseInfo {
+  qid: string
+  longNick: string
+  birthday_year: number
+  birthday_month: number
+  birthday_day: number
+  age: number
+  sex: number
+  eMail: string
+  phoneNum: string
+  categoryId: number
+  richTime: number
+  richBuffer: string
+}
+
+interface MusicInfo {
+  buf: string
+}
+
+interface VideoBizInfo {
+  cid: string
+  tvUrl: string
+  synchType: string
+}
+
+interface VideoInfo {
+  name: string
+}
+
+interface ExtOnlineBusinessInfo {
+  buf: string
+  customStatus: any
+  videoBizInfo: VideoBizInfo
+  videoInfo: VideoInfo
+}
+
+interface ExtBuffer {
+  buf: string
+}
+
+interface UserStatus {
+  uid: string
+  uin: string
+  status: number
+  extStatus: number
+  batteryStatus: number
+  termType: number
+  netType: number
+  iconType: number
+  customStatus: any
+  setTime: string
+  specialFlag: number
+  abiFlag: number
+  eNetworkType: number
+  showName: string
+  termDesc: string
+  musicInfo: MusicInfo
+  extOnlineBusinessInfo: ExtOnlineBusinessInfo
+  extBuffer: ExtBuffer
+}
+
+interface PrivilegeIcon {
+  jumpUrl: string
+  openIconList: any[]
+  closeIconList: any[]
+}
+
+interface VasInfo {
+  vipFlag: boolean
+  yearVipFlag: boolean
+  svipFlag: boolean
+  vipLevel: number
+  bigClub: boolean
+  bigClubLevel: number
+  nameplateVipType: number
+  grayNameplateFlag: number
+  superVipTemplateId: number
+  diyFontId: number
+  pendantId: number
+  pendantDiyId: number
+  faceId: number
+  vipFont: number
+  vipFontType: number
+  magicFont: number
+  fontEffect: number
+  newLoverDiamondFlag: number
+  extendNameplateId: number
+  diyNameplateIDs: any[]
+  vipStartFlag: number
+  vipDataFlag: number
+  gameNameplateId: string
+  gameLastLoginTime: string
+  gameRank: number
+  gameIconShowFlag: boolean
+  gameCardId: string
+  vipNameColorId: string
+  privilegeIcon: PrivilegeIcon
+}
+
+export interface SimpleInfo {
+  uid?: string
+  uin?: string
+  coreInfo: CoreInfo
+  baseInfo: BaseInfo
+  status: UserStatus | null
+  vasInfo: VasInfo | null
+  relationFlags: RelationFlags | null
+  otherFlags: any | null
+  intimate: any | null
+}
+
+interface RelationFlags {
+  topTime: string
+  isBlock: boolean
+  isMsgDisturb: boolean
+  isSpecialCareOpen: boolean
+  isSpecialCareZone: boolean
+  ringId: string
+  isBlocked: boolean
+  recommendImgFlag: number
+  disableEmojiShortCuts: number
+  qidianMasterFlag: number
+  qidianCrewFlag: number
+  qidianCrewFlag2: number
+  isHideQQLevel: number
+  isHidePrivilegeIcon: number
+}
+
+export interface FriendV2 extends SimpleInfo {
+  categoryId?: number
+  categroyName?: string
+}
+
+interface CommonExt {
+  constellation: number
+  shengXiao: number
+  kBloodType: number
+  homeTown: string
+  makeFriendCareer: number
+  pos: string
+  college: string
+  country: string
+  province: string
+  city: string
+  postCode: string
+  address: string
+  regTime: number
+  interest: string
+  labels: any[]
+  qqLevel: QQLevel
+}
+
+interface Pic {
+  picId: string
+  picTime: number
+  picUrlMap: Record<string, string>
+}
+
+interface PhotoWall {
+  picList: Pic[]
+}
+
+export interface UserDetailInfoListenerArg {
+  uid: string
+  uin: string
+  simpleInfo: SimpleInfo
+  commonExt: CommonExt
+  photoWall: PhotoWall
+}
+
+export interface BuddyProfileLikeReq {
+  friendUids: string[]
+  basic: number
+  vote: number
+  favorite: number
+  userProfile: number
+  type: number
+  start: number
+  limit: number
+}
+
+export interface UserDetailInfoByUinV2 {
+  result: number
+  errMsg: string
+  detail: {
+    uid: string
+    uin: string
+    simpleInfo: SimpleInfo
+    commonExt: CommonExt
+    photoWall: null
+  }
+}
+
+export interface UserDetailInfoByUin {
+  result: number
+  errMsg: string
+  info: {
+    uid: string //这个没办法用
+    qid: string
+    uin: string
+    nick: string
+    remark: string
+    longNick: string
+    avatarUrl: string
+    birthday_year: number
+    birthday_month: number
+    birthday_day: number
+    sex: number //0
+    topTime: string
+    constellation: number
+    shengXiao: number
+    kBloodType: number
+    homeTown: string
+    makeFriendCareer: number
+    pos: string
+    eMail: string
+    phoneNum: string
+    college: string
+    country: string
+    province: string
+    city: string
+    postCode: string
+    address: string
+    isBlock: boolean
+    isSpecialCareOpen: boolean
+    isSpecialCareZone: boolean
+    ringId: string
+    regTime: number
+    interest: string
+    termType: number
+    labels: any[]
+    qqLevel: { crownNum: number, sunNum: number, moonNum: number, starNum: number }
+    isHideQQLevel: number
+    privilegeIcon: { jumpUrl: string, openIconList: any[], closeIconList: any[] }
+    isHidePrivilegeIcon: number
+    photoWall: { picList: any[] }
+    vipFlag: boolean
+    yearVipFlag: boolean
+    svipFlag: boolean
+    vipLevel: number
+    status: number
+    qidianMasterFlag: number
+    qidianCrewFlag: number
+    qidianCrewFlag2: number
+    extStatus: number
+    recommendImgFlag: number
+    disableEmojiShortCuts: number
+    pendantId: string
+    vipNameColorId: string
+  }
+}

src/ntqqapi/wrapper.ts

@@ -0,0 +1,95 @@
+import {
+  NodeIKernelBuddyService,
+  NodeIKernelGroupService,
+  NodeIKernelProfileService,
+  NodeIKernelProfileLikeService,
+  NodeIKernelMSFService,
+  NodeIKernelMsgService,
+  NodeIKernelUixConvertService,
+  NodeIKernelRichMediaService,
+  NodeIKernelTicketService,
+  NodeIKernelTipOffService,
+  NodeIKernelSearchService
+} from './services'
+import { constants } from 'node:os'
+import { Dict } from 'cosmokit'
+const Process = require('node:process')
+
+export interface NodeIQQNTWrapperSession {
+  [key: string]: any
+  getBuddyService(): NodeIKernelBuddyService
+  getGroupService(): NodeIKernelGroupService
+  getProfileService(): NodeIKernelProfileService
+  getProfileLikeService(): NodeIKernelProfileLikeService
+  getMsgService(): NodeIKernelMsgService
+  getMSFService(): NodeIKernelMSFService
+  getUixConvertService(): NodeIKernelUixConvertService
+  getRichMediaService(): NodeIKernelRichMediaService
+  getTicketService(): NodeIKernelTicketService
+  getTipOffService(): NodeIKernelTipOffService
+  getSearchService(): NodeIKernelSearchService
+}
+
+export interface WrapperApi {
+  NodeIQQNTWrapperSession?: NodeIQQNTWrapperSession
+}
+
+export interface WrapperConstructor {
+  [key: string]: any
+  NodeIKernelBuddyListener?: any
+  NodeIKernelGroupListener?: any
+  NodeQQNTWrapperUtil?: any
+  NodeIKernelMsgListener?: any
+  NodeIQQNTWrapperEngine?: any
+  NodeIGlobalAdapter?: any
+  NodeIDependsAdapter?: any
+  NodeIDispatcherAdapter?: any
+  NodeIKernelSessionListener?: any
+  NodeIKernelLoginService?: any
+  NodeIKernelLoginListener?: any
+  NodeIKernelProfileService?: any
+  NodeIKernelProfileListener?: any
+}
+
+const wrapperApi: WrapperApi = {}
+
+export const wrapperConstructor: WrapperConstructor = {}
+
+const constructor = [
+  'NodeIKernelBuddyListener',
+  'NodeIKernelGroupListener',
+  'NodeQQNTWrapperUtil',
+  'NodeIKernelMsgListener',
+  'NodeIQQNTWrapperEngine',
+  'NodeIGlobalAdapter',
+  'NodeIDependsAdapter',
+  'NodeIDispatcherAdapter',
+  'NodeIKernelSessionListener',
+  'NodeIKernelLoginService',
+  'NodeIKernelLoginListener',
+  'NodeIKernelProfileService',
+  'NodeIKernelProfileListener',
+]
+
+Process.dlopenOrig = Process.dlopen
+
+Process.dlopen = function (module: Dict, filename: string, flags = constants.dlopen.RTLD_LAZY) {
+  const dlopenRet = this.dlopenOrig(module, filename, flags)
+  for (let export_name in module.exports) {
+    module.exports[export_name] = new Proxy(module.exports[export_name], {
+      construct: (target, args, _newTarget) => {
+        const ret = new target(...args)
+        if (export_name === 'NodeIQQNTWrapperSession') wrapperApi.NodeIQQNTWrapperSession = ret
+        return ret
+      }
+    })
+    if (constructor.includes(export_name)) {
+      wrapperConstructor[export_name] = module.exports[export_name]
+    }
+  }
+  return dlopenRet
+}
+
+export function getSession() {
+  return wrapperApi['NodeIQQNTWrapperSession']
+}

src/onebot11/action/BaseAction.ts

@@ -0,0 +1,54 @@
+import { ActionName, BaseCheckResult } from './types'
+import { OB11Response } from './OB11Response'
+import { OB11Return } from '../types'
+import { Context } from 'cordis'
+import type Adapter from '../adapter'
+
+abstract class BaseAction<PayloadType, ReturnDataType> {
+  abstract actionName: ActionName
+  protected ctx: Context
+
+  constructor(protected adapter: Adapter) {
+    this.ctx = adapter.ctx
+  }
+
+  protected async check(payload: PayloadType): Promise<BaseCheckResult> {
+    return {
+      valid: true,
+    }
+  }
+
+  public async handle(payload: PayloadType): Promise<OB11Return<ReturnDataType | null>> {
+    const result = await this.check(payload)
+    if (!result.valid) {
+      return OB11Response.error(result.message, 400)
+    }
+    try {
+      const resData = await this._handle(payload)
+      return OB11Response.ok(resData)
+    } catch (e: any) {
+      this.ctx.logger.error('发生错误', e)
+      return OB11Response.error(e?.toString() || e?.stack?.toString() || '未知错误，可能操作超时', 200)
+    }
+  }
+
+  public async websocketHandle(payload: PayloadType, echo: any): Promise<OB11Return<ReturnDataType | null>> {
+    const result = await this.check(payload)
+    if (!result.valid) {
+      return OB11Response.error(result.message, 1400)
+    }
+    try {
+      const resData = await this._handle(payload)
+      return OB11Response.ok(resData, echo)
+    } catch (e: any) {
+      this.ctx.logger.error('发生错误', e)
+      return OB11Response.error(e.stack?.toString() || e.toString(), 1200, echo)
+    }
+  }
+
+  protected async _handle(payload: PayloadType): Promise<ReturnDataType> {
+    throw `pleas override ${this.actionName} _handle`
+  }
+}
+
+export default BaseAction

src/onebot11/action/OB11Response.ts

@@ -0,0 +1,31 @@
+import { OB11Return } from '../types'
+import { isNullable } from 'cosmokit'
+
+export class OB11Response {
+  static res<T>(data: T, status: string, retcode: number, message: string = ''): OB11Return<T> {
+    return {
+      status: status,
+      retcode: retcode,
+      data: data,
+      message: message,
+      wording: message,
+      echo: undefined,
+    }
+  }
+
+  static ok<T>(data: T, echo: any = null) {
+    let res = OB11Response.res<T>(data, 'ok', 0)
+    if (!isNullable(echo)) {
+      res.echo = echo
+    }
+    return res
+  }
+
+  static error(err: string, retcode: number, echo: any = null) {
+    let res = OB11Response.res(null, 'failed', retcode, err)
+    if (!isNullable(echo)) {
+      res.echo = echo
+    }
+    return res
+  }
+}

src/onebot11/action/file/GetFile.ts

@@ -0,0 +1,88 @@
+import BaseAction from '../BaseAction'
+import fsPromise from 'node:fs/promises'
+import { getConfigUtil } from '@/common/config'
+import { ActionName } from '../types'
+import { Peer, ElementType } from '@/ntqqapi/types'
+import { MessageUnique } from '@/common/utils/messageUnique'
+
+export interface GetFilePayload {
+  file: string // 文件名或者fileUuid
+}
+
+export interface GetFileResponse {
+  file?: string // path
+  url?: string
+  file_size?: string
+  file_name?: string
+  base64?: string
+}
+
+export abstract class GetFileBase extends BaseAction<GetFilePayload, GetFileResponse> {
+  // forked from https://github.com/NapNeko/NapCatQQ/blob/6f6b258f22d7563f15d84e7172c4d4cbb547f47e/src/onebot11/action/file/GetFile.ts#L44
+  protected async _handle(payload: GetFilePayload): Promise<GetFileResponse> {
+    const { enableLocalFile2Url } = getConfigUtil().getConfig()
+
+    let fileCache = await MessageUnique.getFileCacheById(String(payload.file))
+    if (!fileCache?.length) {
+      fileCache = await MessageUnique.getFileCacheByName(String(payload.file))
+    }
+
+    if (fileCache?.length) {
+      const downloadPath = await this.ctx.ntFileApi.downloadMedia(
+        fileCache[0].msgId,
+        fileCache[0].chatType,
+        fileCache[0].peerUid,
+        fileCache[0].elementId,
+        '',
+        ''
+      )
+      const res: GetFileResponse = {
+        file: downloadPath,
+        url: downloadPath,
+        file_size: fileCache[0].fileSize,
+        file_name: fileCache[0].fileName,
+      }
+      const peer: Peer = {
+        chatType: fileCache[0].chatType,
+        peerUid: fileCache[0].peerUid,
+        guildId: ''
+      }
+      if (fileCache[0].elementType === ElementType.PIC) {
+        const msgList = await this.ctx.ntMsgApi.getMsgsByMsgId(peer, [fileCache[0].msgId])
+        if (msgList.msgList.length === 0) {
+          throw new Error('msg not found')
+        }
+        const msg = msgList.msgList[0]
+        const findEle = msg.elements.find(e => e.elementId === fileCache[0].elementId)
+        if (!findEle) {
+          throw new Error('element not found')
+        }
+        res.url = await this.ctx.ntFileApi.getImageUrl(findEle.picElement)
+      } else if (fileCache[0].elementType === ElementType.VIDEO) {
+        res.url = await this.ctx.ntFileApi.getVideoUrl(peer, fileCache[0].msgId, fileCache[0].elementId)
+      }
+      if (enableLocalFile2Url && downloadPath && (res.file === res.url || res.url === undefined)) {
+        try {
+          res.base64 = await fsPromise.readFile(downloadPath, 'base64')
+        } catch (e) {
+          throw new Error('文件下载失败. ' + e)
+        }
+      }
+      //不手动删除？文件持久化了
+      return res
+    }
+    throw new Error('file not found')
+  }
+}
+
+export default class GetFile extends GetFileBase {
+  actionName = ActionName.GetFile
+
+  protected async _handle(payload: { file_id: string; file: string }): Promise<GetFileResponse> {
+    if (!payload.file_id) {
+      throw new Error('file_id 不能为空')
+    }
+    payload.file = payload.file_id
+    return super._handle(payload)
+  }
+}

src/onebot11/action/file/GetImage.ts

@@ -0,0 +1,13 @@
+import { GetFileBase } from './GetFile'
+import { ActionName } from '../types'
+
+export default class GetImage extends GetFileBase {
+  actionName = ActionName.GetImage
+
+  protected async _handle(payload: { file: string }) {
+    if (!payload.file) {
+      throw new Error('参数 file 不能为空')
+    }
+    return super._handle(payload)
+  }
+}

src/onebot11/action/file/GetRecord.ts

@@ -0,0 +1,25 @@
+import { GetFileBase, GetFilePayload, GetFileResponse } from './GetFile'
+import { ActionName } from '../types'
+import { decodeSilk } from '@/common/utils/audio'
+import { getConfigUtil } from '@/common/config'
+import path from 'node:path'
+import fs from 'node:fs'
+
+interface Payload extends GetFilePayload {
+  out_format: 'mp3' | 'amr' | 'wma' | 'm4a' | 'spx' | 'ogg' | 'wav' | 'flac'
+}
+
+export default class GetRecord extends GetFileBase {
+  actionName = ActionName.GetRecord
+
+  protected async _handle(payload: Payload): Promise<GetFileResponse> {
+    let res = await super._handle(payload)
+    res.file = await decodeSilk(this.ctx, res.file!, payload.out_format)
+    res.file_name = path.basename(res.file)
+    res.file_size = fs.statSync(res.file).size.toString()
+    if (getConfigUtil().getConfig().enableLocalFile2Url) {
+      res.base64 = fs.readFileSync(res.file, 'base64')
+    }
+    return res
+  }
+}

src/onebot11/action/go-cqhttp/CreateGroupFileFolder.ts

@@ -0,0 +1,17 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+
+interface Payload {
+  group_id: number | string
+  name: string
+  parent_id?: '/'
+}
+
+export class CreateGroupFileFolder extends BaseAction<Payload, null> {
+  actionName = ActionName.GoCQHTTP_CreateGroupFileFolder
+
+  async _handle(payload: Payload) {
+    await this.ctx.ntGroupApi.createGroupFileFolder(payload.group_id.toString(), payload.name)
+    return null
+  }
+}

src/onebot11/action/go-cqhttp/DelEssenceMsg.ts

@@ -0,0 +1,25 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+import { MessageUnique } from '@/common/utils/messageUnique'
+
+interface Payload {
+  message_id: number | string
+}
+
+export class DelEssenceMsg extends BaseAction<Payload, any> {
+  actionName = ActionName.GoCQHTTP_DelEssenceMsg;
+
+  protected async _handle(payload: Payload): Promise<any> {
+    if (!payload.message_id) {
+      throw Error('message_id不能为空')
+    }
+    const msg = await MessageUnique.getMsgIdAndPeerByShortId(+payload.message_id)
+    if (!msg) {
+      throw new Error('msg not found')
+    }
+    return await this.ctx.ntGroupApi.removeGroupEssence(
+      msg.Peer.peerUid,
+      msg.MsgId,
+    )
+  }
+}

src/onebot11/action/go-cqhttp/DelGroupFile.ts

@@ -0,0 +1,17 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+
+interface Payload {
+  group_id: string | number
+  file_id: string
+  busid?: 102
+}
+
+export class DelGroupFile extends BaseAction<Payload, null> {
+  actionName = ActionName.GoCQHTTP_DelGroupFile
+
+  async _handle(payload: Payload) {
+    await this.ctx.ntGroupApi.deleteGroupFile(payload.group_id.toString(), [payload.file_id])
+    return null
+  }
+}

src/onebot11/action/go-cqhttp/DelGroupFolder.ts

@@ -0,0 +1,16 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+
+interface Payload {
+  group_id: number | string
+  folder_id: string
+}
+
+export class DelGroupFolder extends BaseAction<Payload, null> {
+  actionName = ActionName.GoCQHTTP_DelGroupFolder
+
+  async _handle(payload: Payload) {
+    await this.ctx.ntGroupApi.deleteGroupFileFolder(payload.group_id.toString(), payload.folder_id)
+    return null
+  }
+}

src/onebot11/action/go-cqhttp/DownloadFile.ts

@@ -0,0 +1,75 @@
+import BaseAction from '../BaseAction'
+import fs from 'fs'
+import fsPromise from 'fs/promises'
+import path from 'node:path'
+import { ActionName } from '../types'
+import { calculateFileMD5, fetchFile } from '@/common/utils'
+import { TEMP_DIR } from '@/common/globalVars'
+import { randomUUID } from 'node:crypto'
+import { Dict } from 'cosmokit'
+
+interface Payload {
+  thread_count?: number
+  url?: string
+  base64?: string
+  name?: string
+  headers?: string | string[]
+}
+
+interface FileResponse {
+  file: string
+}
+
+export class DownloadFile extends BaseAction<Payload, FileResponse> {
+  actionName = ActionName.GoCQHTTP_DownloadFile
+
+  protected async _handle(payload: Payload): Promise<FileResponse> {
+    const isRandomName = !payload.name
+    const name = payload.name ? path.basename(payload.name) : randomUUID()
+    const filePath = path.join(TEMP_DIR, name)
+
+    if (payload.base64) {
+      await fsPromise.writeFile(filePath, payload.base64, 'base64')
+    } else if (payload.url) {
+      const headers = this.getHeaders(payload.headers)
+      const res = await fetchFile(payload.url, headers)
+      await fsPromise.writeFile(filePath, res.data)
+    } else {
+      throw new Error('不存在任何文件, 无法下载')
+    }
+    if (fs.existsSync(filePath)) {
+      if (isRandomName) {
+        // 默认实现要名称未填写时文件名为文件 md5
+        const md5 = await calculateFileMD5(filePath)
+        const newPath = path.join(TEMP_DIR, md5)
+        await fsPromise.rename(filePath, newPath)
+        return { file: newPath }
+      }
+      return { file: filePath }
+    } else {
+      throw new Error('文件写入失败, 检查权限')
+    }
+  }
+
+  getHeaders(headersIn?: string | string[]): Record<string, string> {
+    const headers: Dict = {}
+    if (typeof headersIn == 'string') {
+      headersIn = headersIn.split('[\\r\\n]')
+    }
+    if (Array.isArray(headersIn)) {
+      for (const headerItem of headersIn) {
+        const spilt = headerItem.indexOf('=')
+        if (spilt < 0) {
+          headers[headerItem] = ''
+        } else {
+          const key = headerItem.substring(0, spilt)
+          headers[key] = headerItem.substring(0, spilt + 1)
+        }
+      }
+    }
+    if (!headers['Content-Type']) {
+      headers['Content-Type'] = 'application/octet-stream'
+    }
+    return headers
+  }
+}

src/onebot11/action/go-cqhttp/GetForwardMsg.ts

@@ -0,0 +1,50 @@
+import BaseAction from '../BaseAction'
+import { OB11ForwardMessage, OB11Message, OB11MessageData } from '../../types'
+import { OB11Entities } from '../../entities'
+import { ActionName } from '../types'
+import { MessageUnique } from '@/common/utils/messageUnique'
+
+interface Payload {
+  message_id: string // long msg id，gocq
+  id?: string // long msg id, onebot11
+}
+
+interface Response {
+  messages: (OB11Message & { content: OB11MessageData })[]
+}
+
+export class GetForwardMsg extends BaseAction<Payload, Response> {
+  actionName = ActionName.GoCQHTTP_GetForwardMsg
+  protected async _handle(payload: Payload): Promise<any> {
+    const msgId = payload.id || payload.message_id
+    if (!msgId) {
+      throw Error('message_id不能为空')
+    }
+    const rootMsgId = MessageUnique.getShortIdByMsgId(msgId)
+    const rootMsg = await MessageUnique.getMsgIdAndPeerByShortId(rootMsgId || +msgId)
+    if (!rootMsg) {
+      throw Error('msg not found')
+    }
+    const data = await this.ctx.ntMsgApi.getMultiMsg(rootMsg.Peer, rootMsg.MsgId, rootMsg.MsgId)
+    if (data?.result !== 0) {
+      throw Error('找不到相关的聊天记录' + data?.errMsg)
+    }
+    const msgList = data.msgList
+    const messages = await Promise.all(
+      msgList.map(async (msg) => {
+        const resMsg = await OB11Entities.message(this.ctx, msg)
+        resMsg.message_id = MessageUnique.createMsg({
+          chatType: msg.chatType,
+          peerUid: msg.peerUid,
+        }, msg.msgId)!
+        return resMsg
+      }),
+    )
+    messages.map(v => {
+      const msg = v as Partial<OB11ForwardMessage>
+      msg.content = msg.message
+      delete msg.message
+    })
+    return { messages }
+  }
+}

src/onebot11/action/go-cqhttp/GetGroupAtAllRemain.ts

@@ -0,0 +1,25 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+
+interface Payload {
+  group_id: number | string
+}
+
+interface Response {
+  can_at_all: boolean
+  remain_at_all_count_for_group: number
+  remain_at_all_count_for_uin: number
+}
+
+export class GetGroupAtAllRemain extends BaseAction<Payload, Response> {
+  actionName = ActionName.GoCQHTTP_GetGroupAtAllRemain
+
+  async _handle(payload: Payload) {
+    const data = await this.ctx.ntGroupApi.getGroupRemainAtTimes(payload.group_id.toString())
+    return {
+      can_at_all: data.atInfo.canAtAll,
+      remain_at_all_count_for_group: data.atInfo.RemainAtAllCountForGroup,
+      remain_at_all_count_for_uin: data.atInfo.RemainAtAllCountForUin
+    }
+  }
+}

src/onebot11/action/go-cqhttp/GetGroupMsgHistory.ts

@@ -0,0 +1,46 @@
+import BaseAction from '../BaseAction'
+import { OB11Message } from '../../types'
+import { ActionName } from '../types'
+import { ChatType } from '@/ntqqapi/types'
+import { OB11Entities } from '../../entities'
+import { RawMessage } from '@/ntqqapi/types'
+import { MessageUnique } from '@/common/utils/messageUnique'
+
+interface Payload {
+  group_id: number | string
+  message_seq?: number | string
+  count?: number | string
+  reverseOrder?: boolean
+}
+
+interface Response {
+  messages: OB11Message[]
+}
+
+export class GetGroupMsgHistory extends BaseAction<Payload, Response> {
+  actionName = ActionName.GoCQHTTP_GetGroupMsgHistory
+
+  protected async _handle(payload: Payload): Promise<Response> {
+    const count = payload.count || 20
+    const isReverseOrder = payload.reverseOrder || true
+    const peer = { chatType: ChatType.group, peerUid: payload.group_id.toString() }
+    let msgList: RawMessage[] | undefined
+    // 包含 message_seq 0
+    if (!payload.message_seq) {
+      msgList = (await this.ctx.ntMsgApi.getAioFirstViewLatestMsgs(peer, +count)).msgList
+    } else {
+      const startMsgId = (await MessageUnique.getMsgIdAndPeerByShortId(+payload.message_seq))?.MsgId
+      if (!startMsgId) throw new Error(`消息${payload.message_seq}不存在`)
+      msgList = (await this.ctx.ntMsgApi.getMsgHistory(peer, startMsgId, +count)).msgList
+    }
+    if (!msgList?.length) throw new Error('未找到消息')
+    if (isReverseOrder) msgList.reverse()
+    await Promise.all(
+      msgList.map(async msg => {
+        msg.msgShortId = MessageUnique.createMsg({ chatType: msg.chatType, peerUid: msg.peerUid }, msg.msgId)
+      })
+    )
+    const ob11MsgList = await Promise.all(msgList.map((msg) => OB11Entities.message(this.ctx, msg)))
+    return { messages: ob11MsgList }
+  }
+}

src/onebot11/action/go-cqhttp/GetGroupRootFiles.ts

@@ -0,0 +1,62 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+import { OB11GroupFile, OB11GroupFileFolder } from '../../types'
+
+interface Payload {
+  group_id: string | number
+  file_count: string | number
+}
+
+interface Response {
+  files: OB11GroupFile[]
+  folders: OB11GroupFileFolder[]
+}
+
+export class GetGroupRootFiles extends BaseAction<Payload, Response> {
+  actionName = ActionName.GoCQHTTP_GetGroupRootFiles
+
+  async _handle(payload: Payload) {
+    const data = await this.ctx.ntGroupApi.getGroupFileList(payload.group_id.toString(), {
+      sortType: 1,
+      fileCount: +(payload.file_count ?? 50),
+      startIndex: 0,
+      sortOrder: 2,
+      showOnlinedocFolder: 0,
+    })
+
+    this.ctx.logger.info(data)
+
+    return {
+      files: data.filter(item => item.fileInfo)
+        .map(item => {
+          const file = item.fileInfo!
+          return {
+            group_id: +item.peerId,
+            file_id: file.fileId,
+            file_name: file.fileName,
+            busid: file.busId,
+            file_size: +file.fileSize,
+            upload_time: file.uploadTime,
+            dead_time: file.deadTime,
+            modify_time: file.modifyTime,
+            download_times: file.downloadTimes,
+            uploader: +file.uploaderUin,
+            uploader_name: file.uploaderName
+          }
+        }),
+      folders: data.filter(item => item.folderInfo)
+        .map(item => {
+          const folder = item.folderInfo!
+          return {
+            group_id: +item.peerId,
+            folder_id: folder.folderId,
+            folder_name: folder.folderName,
+            create_time: folder.createTime,
+            creator: +folder.createUin,
+            creator_name: folder.creatorName,
+            total_file_count: folder.totalFileCount
+          }
+        })
+    }
+  }
+}

src/onebot11/action/go-cqhttp/GetGroupSystemMsg.ts

@@ -0,0 +1,59 @@
+import BaseAction from '../BaseAction'
+import { GroupNotifyStatus } from '@/ntqqapi/types'
+import { ActionName } from '../types'
+
+interface Response {
+  invited_requests: {
+    request_id: number
+    invitor_uin: number
+    invitor_nick: string
+    group_id: number
+    group_name: string
+    checked: boolean
+    actor: number
+  }[]
+  join_requests: {
+    request_id: number
+    requester_uin: number
+    requester_nick: string
+    message: string
+    group_id: number
+    group_name: string
+    checked: boolean
+    actor: number
+  }[]
+}
+
+export class GetGroupSystemMsg extends BaseAction<void, Response> {
+  actionName = ActionName.GoCQHTTP_GetGroupSystemMsg
+
+  async _handle(payload: void) {
+    const singleScreenNotifies = await this.ctx.ntGroupApi.getSingleScreenNotifies(10)
+    const data: Response = { invited_requests: [], join_requests: [] }
+    for (const notify of singleScreenNotifies) {
+      if (notify.type == 1) {
+        data.invited_requests.push({
+          request_id: +notify.seq,
+          invitor_uin: Number(await this.ctx.ntUserApi.getUinByUid(notify.user1.uid)),
+          invitor_nick: notify.user1.nickName,
+          group_id: +notify.group.groupCode,
+          group_name: notify.group.groupName,
+          checked: notify.status !== GroupNotifyStatus.KUNHANDLE,
+          actor: notify.user2?.uid ? Number(await this.ctx.ntUserApi.getUinByUid(notify.user2.uid)) : 0
+        })
+      } else if (notify.type == 7) {
+        data.join_requests.push({
+          request_id: +notify.seq,
+          requester_uin: Number(await this.ctx.ntUserApi.getUinByUid(notify.user1.uid)),
+          requester_nick: notify.user1.nickName,
+          message: notify.postscript,
+          group_id: +notify.group.groupCode,
+          group_name: notify.group.groupName,
+          checked: notify.status !== GroupNotifyStatus.KUNHANDLE,
+          actor: notify.user2?.uid ? Number(await this.ctx.ntUserApi.getUinByUid(notify.user2.uid)) : 0
+        })
+      }
+    }
+    return data
+  }
+}

src/onebot11/action/go-cqhttp/GetStrangerInfo.ts

@@ -0,0 +1,58 @@
+import BaseAction from '../BaseAction'
+import { OB11User } from '../../types'
+import { OB11Entities } from '../../entities'
+import { ActionName } from '../types'
+import { getBuildVersion } from '@/common/utils'
+import { OB11UserSex } from '../../types'
+import { calcQQLevel } from '@/common/utils/misc'
+
+interface Payload {
+  user_id: number | string
+}
+
+export class GetStrangerInfo extends BaseAction<Payload, OB11User> {
+  actionName = ActionName.GoCQHTTP_GetStrangerInfo
+
+  protected async _handle(payload: Payload): Promise<OB11User> {
+    if (!(getBuildVersion() >= 26702)) {
+      const user_id = payload.user_id.toString()
+      const extendData = await this.ctx.ntUserApi.getUserDetailInfoByUin(user_id)
+      const uid = (await this.ctx.ntUserApi.getUidByUin(user_id))!
+      if (!uid || uid.indexOf('*') != -1) {
+        const ret = {
+          ...extendData,
+          user_id: parseInt(extendData.info.uin) || 0,
+          nickname: extendData.info.nick,
+          sex: OB11UserSex.unknown,
+          age: (extendData.info.birthday_year == 0) ? 0 : new Date().getFullYear() - extendData.info.birthday_year,
+          qid: extendData.info.qid,
+          level: extendData.info.qqLevel && calcQQLevel(extendData.info.qqLevel) || 0,
+          login_days: 0,
+          uid: ''
+        }
+        return ret
+      }
+      const data = { ...extendData, ...(await this.ctx.ntUserApi.getUserDetailInfo(uid)) }
+      return OB11Entities.stranger(data)
+    } else {
+      const user_id = payload.user_id.toString()
+      const extendData = await this.ctx.ntUserApi.getUserDetailInfoByUinV2(user_id)
+      const uid = (await this.ctx.ntUserApi.getUidByUin(user_id))!
+      if (!uid || uid.indexOf('*') != -1) {
+        const ret = {
+          ...extendData,
+          user_id: parseInt(extendData.detail.uin) || 0,
+          nickname: extendData.detail.simpleInfo.coreInfo.nick,
+          sex: OB11UserSex.unknown,
+          age: 0,
+          level: extendData.detail.commonExt.qqLevel && calcQQLevel(extendData.detail.commonExt.qqLevel) || 0,
+          login_days: 0,
+          uid: ''
+        }
+        return ret
+      }
+      const data = { ...extendData, ...(await this.ctx.ntUserApi.getUserDetailInfo(uid)) }
+      return OB11Entities.stranger(data)
+    }
+  }
+}

src/onebot11/action/go-cqhttp/MarkMsgAsRead.ts

@@ -0,0 +1,14 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+
+interface Payload {
+  message_id: number
+}
+
+export class MarkMsgAsRead extends BaseAction<Payload, null> {
+  actionName = ActionName.GoCQHTTP_MarkMsgAsRead
+
+  protected async _handle(payload: Payload): Promise<null> {
+    return null
+  }
+}

src/onebot11/action/go-cqhttp/QuickOperation.ts

@@ -0,0 +1,16 @@
+import BaseAction from '../BaseAction'
+import { handleQuickOperation, QuickOperation, QuickOperationEvent } from '../../helper/quickOperation'
+import { ActionName } from '../types'
+
+interface Payload {
+  context: QuickOperationEvent,
+  operation: QuickOperation
+}
+
+export class HandleQuickOperation extends BaseAction<Payload, null> {
+  actionName = ActionName.GoCQHTTP_HandleQuickOperation
+  protected async _handle(payload: Payload): Promise<null> {
+    handleQuickOperation(this.ctx, payload.context, payload.operation).catch(e => this.ctx.logger.error(e))
+    return null
+  }
+}

src/onebot11/action/go-cqhttp/SendForwardMsg.ts

@@ -0,0 +1,21 @@
+import SendMsg from '../msg/SendMsg'
+import { OB11PostSendMsg } from '../../types'
+import { ActionName } from '../types'
+import { convertMessage2List } from '../../helper/createMessage'
+
+export class SendForwardMsg extends SendMsg {
+  actionName = ActionName.GoCQHTTP_SendForwardMsg
+
+  protected async check(payload: OB11PostSendMsg) {
+    if (payload.messages) payload.message = convertMessage2List(payload.messages)
+    return super.check(payload)
+  }
+}
+
+export class SendPrivateForwardMsg extends SendForwardMsg {
+  actionName = ActionName.GoCQHTTP_SendPrivateForwardMsg
+}
+
+export class SendGroupForwardMsg extends SendForwardMsg {
+  actionName = ActionName.GoCQHTTP_SendGroupForwardMsg
+}

src/onebot11/action/go-cqhttp/SendGroupNotice.ts

@@ -0,0 +1,37 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+
+interface Payload {
+  group_id: number | string
+  content: string
+  image?: string
+  pinned?: number | string //扩展
+  confirm_required?: number | string //扩展
+}
+
+export class SendGroupNotice extends BaseAction<Payload, null> {
+  actionName = ActionName.GoCQHTTP_SendGroupNotice
+
+  async _handle(payload: Payload) {
+    const type = 1
+    const isShowEditCard = 0
+    const tipWindowType = 0
+    const pinned = Number(payload.pinned ?? 0)
+    const confirmRequired = Number(payload.confirm_required ?? 1)
+
+    const result = await this.ctx.ntWebApi.setGroupNotice({
+      groupCode: payload.group_id.toString(),
+      content: payload.content,
+      pinned,
+      type,
+      isShowEditCard,
+      tipWindowType,
+      confirmRequired,
+      picId: ''
+    })
+    if (result.ec !== 0) {
+      throw new Error(`设置群公告失败, 错误信息: ${result.em}`)
+    }
+    return null
+  }
+}

src/onebot11/action/go-cqhttp/SetEssenceMsg.ts

@@ -0,0 +1,25 @@
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+import { MessageUnique } from '@/common/utils/messageUnique'
+
+interface Payload {
+  message_id: number | string
+}
+
+export class SetEssenceMsg extends BaseAction<Payload, any> {
+  actionName = ActionName.GoCQHTTP_SetEssenceMsg;
+
+  protected async _handle(payload: Payload): Promise<any> {
+    if (!payload.message_id) {
+      throw Error('message_id不能为空')
+    }
+    const msg = await MessageUnique.getMsgIdAndPeerByShortId(+payload.message_id)
+    if (!msg) {
+      throw new Error('msg not found')
+    }
+    return await this.ctx.ntGroupApi.addGroupEssence(
+      msg.Peer.peerUid,
+      msg.MsgId
+    )
+  }
+}

src/onebot11/action/go-cqhttp/UploadFile.ts

@@ -0,0 +1,59 @@
+import fs from 'node:fs'
+import BaseAction from '../BaseAction'
+import { ActionName } from '../types'
+import { SendElementEntities } from '@/ntqqapi/entities'
+import { SendFileElement } from '@/ntqqapi/types'
+import { uri2local } from '@/common/utils'
+import { sendMsg, createPeer, CreatePeerMode } from '../../helper/createMessage'
+
+interface UploadGroupFilePayload {
+  group_id: number | string
+  file: string
+  name: string
+  folder?: string
+  folder_id?: string
+}
+
+export class UploadGroupFile extends BaseAction<UploadGroupFilePayload, null> {
+  actionName = ActionName.GoCQHTTP_UploadGroupFile
+
+  protected async _handle(payload: UploadGroupFilePayload): Promise<null> {
+    let file = payload.file
+    if (fs.existsSync(file)) {
+      file = `file://${file}`
+    }
+    const downloadResult = await uri2local(file)
+    if (!downloadResult.success) {
+      throw new Error(downloadResult.errMsg)
+    }
+    const sendFileEle = await SendElementEntities.file(this.ctx, downloadResult.path, payload.name, payload.folder_id)
+    const peer = await createPeer(this.ctx, payload, CreatePeerMode.Group)
+    await sendMsg(this.ctx, peer, [sendFileEle], [], true)
+    return null
+  }
+}
+
+interface UploadPrivateFilePayload {
+  user_id: number | string
+  file: string
+  name: string
+}
+
+export class UploadPrivateFile extends BaseAction<UploadPrivateFilePayload, null> {
+  actionName = ActionName.GoCQHTTP_UploadPrivateFile
+
+  protected async _handle(payload: UploadPrivateFilePayload): Promise<null> {
+    const peer = await createPeer(this.ctx, payload, CreatePeerMode.Private)
+    let file = payload.file
+    if (fs.existsSync(file)) {
+      file = `file://${file}`
+    }
+    const downloadResult = await uri2local(file)
+    if (!downloadResult.success) {
+      throw new Error(downloadResult.errMsg)
+    }
+    const sendFileEle: SendFileElement = await SendElementEntities.file(this.ctx, downloadResult.path, payload.name)
+    await sendMsg(this.ctx, peer, [sendFileEle], [], true)
+    return null
+  }
+}