release: 3.0.1

feat: More user-friendly packetServer error message

.editorconfig

@@ -0,0 +1,24 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+# Matches multiple files with brace expansion notation
+# Set default charset
+charset = utf-8
+
+# 2 space indentation
+[*.{cjs,mjs,js,jsx,ts,tsx,css,scss,sass,html,json}]
+indent_style = space
+indent_size = 4
+
+[*.bat]
+charset = latin1
+
+# Unfortunately, EditorConfig doesn't support space configuration inside import braces directly.
+# You'll need to rely on your linter/formatter like ESLint or Prettier for that.

.env.framework

@@ -0,0 +1,2 @@
+VITE_BUILD_TYPE = Production
+VITE_BUILD_PLATFORM = Framework

.env.shell

@@ -0,0 +1,2 @@
+VITE_BUILD_TYPE = Production
+VITE_BUILD_PLATFORM = Shell

.eslintrc.cjs

@@ -0,0 +1,64 @@
+module.exports = {
+    'env': {
+        'browser': true,
+        'es2021': true,
+        'node': true
+    },
+    'ignorePatterns': ['src/core/proto/'],
+    'extends': [
+        'eslint:recommended',
+        'plugin:@typescript-eslint/recommended'
+    ],
+    'overrides': [
+        {
+            'env': {
+                'node': true
+            },
+            'files': [
+                '.eslintrc.{js,cjs}'
+            ],
+            'parserOptions': {
+                'sourceType': 'script'
+            }
+        }
+    ],
+    'parser': '@typescript-eslint/parser',
+    'parserOptions': {
+        'ecmaVersion': 'latest',
+        'sourceType': 'module'
+    },
+    'plugins': [
+        '@typescript-eslint',
+        'import'
+    ],
+    'settings': {
+        'import/parsers': {
+            '@typescript-eslint/parser': ['.ts']
+        },
+        'import/resolver': {
+            'typescript': {
+                'alwaysTryTypes': true
+            }
+        }
+    },
+    'rules': {
+        'indent': [
+            'error',
+            4
+        ],
+        'linebreak-style': [
+            'error',
+            'unix'
+        ],
+        'semi': [
+            'error',
+            'always'
+        ],
+        'no-unused-vars': 'off',
+        'no-async-promise-executor': 'off',
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-unused-vars': 'off',
+        '@typescript-eslint/no-var-requires': 'off',
+        'object-curly-spacing': ['error', 'always'],
+    }
+};

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,82 @@
+name: Bug 反馈
+description: 报告可能的 NapCat 异常行为
+title: '[BUG] '
+labels: bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        欢迎来到 NapCat 的 Issue Tracker！请填写以下表格来提交 Bug。
+        在提交新的 Bug 反馈前，请确保您：
+        * 已经搜索了现有的 issues，并且没有找到可以解决您问题的方法
+        * 不与现有的某一 issue 重复
+        * 不涉及[已经停止维护的特性](https://github.com/NapNeko/NapCatQQ?tab=readme-ov-file#挥别昨日)，例如 CQ 码
+  - 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 的「关于」的设置页中找到
+      placeholder: 9.9.7-21804
+    validations:
+      required: true
+  - type: input
+    id: napcat-version
+    attributes:
+      label: NapCat 版本
+      description: 可在 LiteLoaderQQNT 的设置页或是 QQNT 的设置页侧栏中找到
+      placeholder: 1.0.0
+    validations:
+      required: true
+  - type: input
+    id: onebot-client-version
+    attributes:
+      label: OneBot 客户端
+      description: 连接至 NapCat 的客户端版本信息
+      placeholder: Overflow 2.16.0-2cf7991-SNAPSHOT
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: 发生了什么?
+      description: 填写你认为的 NapCat 的不正常行为
+    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: 填写你认为 NapCat 应当执行的正常行为
+    validations:
+      required: true
+  - type: textarea
+    id: napcat-log
+    attributes:
+      label: NapCat 运行日志
+      description: 粘贴相关日志内容到此处
+      render: shell
+  - type: textarea
+    id: onebot-client-log
+    attributes:
+      label: OneBot 客户端运行日志
+      description: 粘贴 OneBot 客户端的相关日志内容到此处
+      render: shell

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "npm" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "daily"

.github/workflows/build.yml

@@ -0,0 +1,61 @@
+name: "Build Action"
+on:
+  workflow_dispatch:
+
+permissions: write-all
+
+jobs:
+  Build-LiteLoader:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Clone Main Repository
+      uses: actions/checkout@v4
+      with:
+          repository: 'NapNeko/NapCatQQ'
+          submodules: true
+          ref: main
+          token: ${{ secrets.NAPCAT_BUILD }}
+    - name: Use Node.js 20.X
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20.x
+    - name: Build NuCat Framework
+      run: |
+          npm i
+          npm run build:framework
+          cd dist
+          npm i --omit=dev 
+          rm package-lock.json
+          cd ..
+    - name: Upload Artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: NapCat.Framework
+        path: dist
+  Build-Shell:
+    runs-on: ubuntu-latest
+    steps:
+        - name: Clone Main Repository
+          uses: actions/checkout@v4
+          with:
+                repository: 'NapNeko/NapCatQQ'
+                submodules: true
+                ref: main
+                token: ${{ secrets.NAPCAT_BUILD }}
+        - name: Use Node.js 20.X
+          uses: actions/setup-node@v4
+          with:
+              node-version: 20.x
+        - name: Build NuCat LiteLoader
+          run: |
+                npm i
+                npm run build:shell
+                cd dist
+                npm i --omit=dev
+                rm package-lock.json
+                cd ..
+        - name: Upload Artifact
+          uses: actions/upload-artifact@v4
+          with:
+              name: NapCat.Shell
+              path: dist

.github/workflows/release.yml

@@ -0,0 +1,146 @@
+name: "Build Release"
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions: write-all
+
+jobs:
+  check-version:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone Repository
+        uses: actions/checkout@v4
+        with:
+          ref: main
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract version from tag
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
+
+      - name: Use Node.js 20.X
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+
+      - name: Check Version
+        run: | 
+              ls
+              node ./script/checkVersion.cjs
+              sh ./checkVersion.sh
+  Build-LiteLoader:
+    needs: [check-version]
+    runs-on: ubuntu-latest
+    steps:
+    - name: Clone Main Repository
+      uses: actions/checkout@v4
+      with:
+          repository: 'NapNeko/NapCatQQ'
+          submodules: true
+          ref: main
+          token: ${{ secrets.NAPCAT_BUILD }}
+    - name: Use Node.js 20.X
+      uses: actions/setup-node@v4
+      with:
+          node-version: 20.x
+
+    - name: Build NuCat Framework
+      run: |
+          npm i
+          npm run build:framework
+          cd dist
+          npm i --omit=dev
+          cd ..
+    - name: Upload Artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: NapCat.Framework
+        path: dist
+  Build-Shell:
+    runs-on: ubuntu-latest
+    needs: [check-version]
+    steps:
+        - name: Clone Main Repository
+          uses: actions/checkout@v4
+          with:
+                repository: 'NapNeko/NapCatQQ'
+                submodules: true
+                ref: main
+                token: ${{ secrets.NAPCAT_BUILD }}
+
+        - name: Use Node.js 20.X
+          uses: actions/setup-node@v4
+          with:
+              node-version: 20.x
+          
+        - name: Build NuCat Shell
+          run: |
+                npm i 
+                npm run build:shell
+                cd dist
+                npm i --omit=dev
+                cd ..
+
+        - name: Upload Artifact
+          uses: actions/upload-artifact@v4
+          with:
+              name: NapCat.Shell
+              path: dist
+
+  release-napcat:
+    needs: [Build-LiteLoader,Build-Shell]
+    runs-on: ubuntu-latest
+    steps:
+
+    - name: Clone Main Repository
+      uses: actions/checkout@v4
+      with:
+            repository: 'NapNeko/NapCatQQ'
+            submodules: true
+            ref: main
+            token: ${{ secrets.NAPCAT_BUILD }}
+
+    - name: Download All Artifact
+      uses: actions/download-artifact@v4
+      
+    - name: Compress subdirectories
+      run: |
+        cd ./NapCat.Shell/
+        zip -q -r NapCat.Shell.zip *
+        cd ..
+        cd ./NapCat.Framework/
+        zip -q -r NapCat.Framework.zip *
+        cd ..
+        rm ./NapCat.Shell.zip -rf
+        rm ./NapCat.Framework.zip -rf
+        mv ./NapCat.Shell/NapCat.Shell.zip ./
+        mv ./NapCat.Framework/NapCat.Framework.zip ./
+
+        mkdir ./NapCat.Framework.Windows.Once
+        unzip -q ./external/LiteLoaderWrapper.zip -d ./NapCat.Framework.Windows.Once
+        cd ./NapCat.Framework.Windows.Once
+        ls 
+        mkdir -p ./LL/plugins/NapCatQQ
+        unzip -q ../NapCat.Framework.zip -d ./LL/plugins/NapCatQQ
+        zip -q -r NapCat.Framework.Windows.Once.zip *
+        cd ..
+        mv ./NapCat.Framework.Windows.Once/NapCat.Framework.Windows.Once.zip ./
+    - name: Extract version from tag
+      run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
+      
+    - name: Clone Changes Log
+      run: curl -o CHANGELOG.md https://fastly.jsdelivr.net/gh/NapNeko/NapCatQQ@main/docs/changelogs/CHANGELOG.v${{ env.VERSION }}.md
+        
+    - name: Create Release Draft and Upload Artifacts
+      uses: softprops/action-gh-release@v1
+      with:
+        name: NapCat V${{ env.VERSION }}
+        token: ${{ secrets.GITHUB_TOKEN }}
+        body_path: CHANGELOG.md
+        files: |
+          NapCat.Framework.zip
+          NapCat.Shell.zip
+          NapCat.Framework.Windows.Once.zip
+        draft: true

.gitignore

@@ -0,0 +1,18 @@
+# Develop
+node_modules/
+package-lock.json
+pnpm-lock.yaml
+out/
+dist/
+/src/core.lib/common/
+/localdebug/
+
+# Editor
+.vscode/*
+!.vscode/extensions.json
+.idea/*
+
+# Build
+*.db
+checkVersion.sh
+bun.lockb

.prettierrc.json

@@ -0,0 +1,10 @@
+{
+    "trailingComma": "es5",
+    "tabWidth": 4,
+    "semi": true,
+    "singleQuote": true,
+    "bracketSpacing": true,
+    "arrowParens": "always",
+    "printWidth": 120,
+    "endOfLine": "auto"
+}

LICENSE

@@ -0,0 +1,343 @@
+   GNU GENERAL PUBLIC Without Social media promotion LICENSE 
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+    d）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.
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+                            NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License along
+    with this program; if not, write to the Free Software Foundation, Inc.,
+    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.

README.md

@@ -1,14 +1,52 @@
-# NapCatQQ
+<div align="center">
+  <img src="https://socialify.git.ci/NapNeko/NapCatQQ/image?font=Jost&logo=https%3A%2F%2Fnapneko.github.io%2Fassets%2Flogo.png&name=1&owner=1&pattern=Diagonal%20Stripes&stargazers=1&theme=Auto" alt="NapCatQQ" width="640" height="320" />
+</div>
 
-## 介绍
-无
+---
+## 欢迎回来
+NapCatQQ (aka 猫猫框架) 是现代化的基于 NTQQ 的 Bot 协议端实现
 
-## 下载与安装
-前往release获取
+## 猫猫技能
+- [x] **超高性能**：轻松数千群聊 独创消息队列
+- [x] **启动方式**：支持以无头、LiteLoader 插件、仅 QQ GUI 三种方式启动
+- [x] **覆盖平台**: 覆盖 Windows / Linux (可选 Docker) / Android Termux / MacOS
+- [x] **安装简单**: 支持一键脚本/程序自动部署/镜像部署等多种覆盖范围
+- [x] **超低占用**：无头模式占用资源极低，适合在服务器上运行
+- [x] **超多接口**：实现大部分 OneBot 和 go-cqhttp 接口，超多扩展 API
+- [x] **远程管理**：自带 WebUI 支持，远程管理更加便捷
+- [x] **扩展支持**：基于 MoeHoo 的Native 可实现发包与收包
 
-## 使用与配置
-参考文档
+## 使用猫猫
 
-## 开源与安全
-为了防止过于扩散与违规使用，未来 NapCat 发版都会不公布源码，在未来形势有所转变下可能会发布源码。
-代码将进行混淆与插桩，请不要违法使用与宣传本项目。
+可前往 [Release](https://github.com/NapNeko/NapCatQQ/releases/) 页面下载最新版本
+
+**首次使用**请务必查看如下文档看使用教程
+
+### 文档地址
+[Github.IO](https://napneko.github.io/)
+
+[Cloudflare.Worker](https://doc.napneko.icu/)
+
+[Cloudflare.HKServer](https://napcat.napneko.icu/)
+
+[Cloudflare.Pages](https://napneko.pages.dev/)
+
+## 回家旅途
+[QQ Group](https://qm.qq.com/q/VfjAq5HIMS)
+
+[Telegram Link](https://t.me/+nLZEnpne-pQ1OWFl)
+
+## 猫猫朋友
+感谢 [LLOneBot](https://github.com/LLOneBot/LLOneBot)
+
+感谢 [Lagrange](https://github.com/LagrangeDev/Lagrange.Core) 对本项目的大力支持
+
+不过最最重要的 还是需要感谢屏幕前的你哦~
+
+---
+
+## 约法三章
+> [!CAUTION]\
+> **请不要在 QQ 官方群聊和任何影响力较大的简中互联网平台（包括但不限于: 哔哩哔哩，微博，知乎，抖音等）发布和讨论*任何*与本项目存在相关性的信息**
+
+任何使用本仓库代码的地方，都应当严格遵守[本仓库开源许可](./LICENSE)。**此外，禁止任何项目未经授权二次分发或基于 NapCat 代码开发。**

launcher/launcher-win10.bat

@@ -0,0 +1,40 @@
+@echo off
+chcp 65001
+net session >nul 2>&1
+if %errorLevel% == 0 (
+    echo Administrator mode detected.
+) else (
+    echo Please run this script in administrator mode.
+    powershell -Command "Start-Process 'cmd.exe' -ArgumentList '/c cd /d \"%cd%\" && \"%~f0\" %1' -Verb runAs" 
+    exit
+)
+
+set NAPCAT_PATCH_PACKAGE=%cd%\qqnt.json
+set NAPCAT_LOAD_PATH=%cd%\loadNapCat.js
+set NAPCAT_INJECT_PATH=%cd%\NapCatWinBootHook.dll
+set NAPCAT_LAUNCHER_PATH=%cd%\NapCatWinBootMain.exe
+set NAPCAT_MAIN_PATH=%cd%\napcat.mjs
+:loop_read
+for /f "tokens=2*" %%a in ('reg query "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\QQ" /v "UninstallString"') do (
+    set RetString=%%b
+    goto :napcat_boot
+)
+
+:napcat_boot
+for %%a in ("%RetString%") do (
+    set "pathWithoutUninstall=%%~dpa"
+)
+
+SET QQPath=%pathWithoutUninstall%QQ.exe
+
+if not exist "%QQpath%" (
+    echo provided QQ path is invalid: %QQpath%
+    pause
+    exit /b
+)
+set NAPCAT_MAIN_PATH=%NAPCAT_MAIN_PATH:\=/%
+echo (async () =^> {await import("file:///%NAPCAT_MAIN_PATH%")})() > "%NAPCAT_LOAD_PATH%"
+
+"%NAPCAT_LAUNCHER_PATH%" "%QQPath%" "%NAPCAT_INJECT_PATH%" %1
+
+REM "%NAPCAT_LAUNCHER_PATH%" "%QQPath%" "%NAPCAT_INJECT_PATH%" 123456

launcher/launcher.bat

@@ -0,0 +1,39 @@
+@echo off
+chcp 65001
+net session >nul 2>&1
+if %errorLevel% == 0 (
+    echo Administrator mode detected.
+) else (
+    echo Please run this script in administrator mode.
+    powershell -Command "Start-Process 'wt.exe' -ArgumentList 'cmd /c cd /d \"%cd%\" && \"%~f0\" %1' -Verb runAs"
+    exit
+)
+
+set NAPCAT_PATCH_PACKAGE=%cd%\qqnt.json
+set NAPCAT_LOAD_PATH=%cd%\loadNapCat.js
+set NAPCAT_INJECT_PATH=%cd%\NapCatWinBootHook.dll
+set NAPCAT_LAUNCHER_PATH=%cd%\NapCatWinBootMain.exe
+set NAPCAT_MAIN_PATH=%cd%\napcat.mjs
+:loop_read
+for /f "tokens=2*" %%a in ('reg query "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\QQ" /v "UninstallString"') do (
+    set RetString=%%b
+    goto :napcat_boot
+)
+
+:napcat_boot
+for %%a in ("%RetString%") do (
+    set "pathWithoutUninstall=%%~dpa"
+)
+
+SET QQPath=%pathWithoutUninstall%QQ.exe
+
+if not exist "%QQpath%" (
+    echo provided QQ path is invalid: %QQpath%
+    pause
+    exit /b
+)
+
+set NAPCAT_MAIN_PATH=%NAPCAT_MAIN_PATH:\=/%
+echo (async () =^> {await import("file:///%NAPCAT_MAIN_PATH%")})() > "%NAPCAT_LOAD_PATH%"
+
+"%NAPCAT_LAUNCHER_PATH%" "%QQPath%" "%NAPCAT_INJECT_PATH%" %1

launcher/loadNapCat.js

@@ -0,0 +1,5 @@
+const path = require('path');
+const CurrentPath = path.dirname(__filename);
+(async () => {
+    await import("file://" + path.join(CurrentPath, './napcat/napcat.mjs'));
+})();

launcher/qqnt.json

@@ -0,0 +1,26 @@
+{
+  "name": "qq-chat",
+  "version": "9.9.16-28788",
+  "verHash": "73b0c8f6",
+  "linuxVersion": "3.2.13-28788",
+  "linuxVerHash": "55fb6434",
+  "type": "module",
+  "private": true,
+  "description": "QQ",
+  "productName": "QQ",
+  "author": {
+    "name": "Tencent",
+    "email": "QQ-Team@tencent.com"
+  },
+  "homepage": "https://im.qq.com",
+  "sideEffects": true,
+  "bin": {
+    "qd": "externals/devtools/cli/index.js"
+  },
+  "main": "./loadNapCat.js",
+  "buildVersion": "28788",
+  "isPureShell": true,
+  "isByteCodeShell": true,
+  "platform": "win32",
+  "eleArch": "x64"
+}

launcher/quickLoginExample.bat

@@ -0,0 +1,4 @@
+@echo off
+REM ./launcher.bat 123456
+REM ./launcher-win10.bat 123456
+REM 带有REM的为注释 删掉你需要的系统的那行REM这三个单词 修改QQ本脚本启动即可

manifest.json

@@ -0,0 +1,33 @@
+{
+  "manifest_version": 4,
+  "type": "extension",
+  "name": "NapCatQQ",
+  "slug": "NapCat.Framework",
+  "description": "高性能的 OneBot 11 协议实现",
+  "version": "3.0.1",
+  "icon": "./logo.png",
+  "authors": [
+    {
+      "name": "MliKiowa",
+      "link": "https://github.com/MliKiowa"
+    },
+    {
+      "name": "Young",
+      "link": "https://github.com/Wesley-Young"
+    }
+  ],
+  "repository": {
+    "repo": "NapNeko/NapCatQQ",
+    "branch": "main"
+  },
+  "platform": [
+    "win32",
+    "linux",
+    "darwin"
+  ],
+  "injects": {
+    "renderer": "./renderer.js",
+    "main": "./liteloader.cjs",
+    "preload": "./preload.cjs"
+  }
+}

package.json

@@ -0,0 +1,52 @@
+{
+  "name": "napcat",
+  "private": true,
+  "type": "module",
+  "version": "3.0.1",
+  "scripts": {
+    "build:framework": "vite build --mode framework",
+    "build:shell": "vite build --mode shell",
+    "build:webui": "cd ./src/webui && vite build",
+    "lint": "eslint --fix src/**/*.{js,ts}",
+    "depend": "cd dist && npm install --omit=dev"
+  },
+  "devDependencies": {
+    "@babel/preset-typescript": "^7.24.7",
+    "@log4js-node/log4js-api": "^1.0.2",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/fluent-ffmpeg": "^2.1.24",
+    "@types/node": "^22.0.1",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.5.12",
+    "@typescript-eslint/eslint-plugin": "^8.3.0",
+    "@typescript-eslint/parser": "^8.3.0",
+    "eslint": "^8.57.0",
+    "eslint-import-resolver-typescript": "^3.6.1",
+    "eslint-plugin-import": "^2.29.1",
+    "typescript": "^5.3.3",
+    "vite": "^5.2.6",
+    "vite-plugin-cp": "^4.0.8",
+    "vite-tsconfig-paths": "^4.3.2",
+    "@protobuf-ts/runtime": "^2.9.4",
+    "ajv": "^8.13.0",
+    "fast-xml-parser": "^4.3.6",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "async-mutex": "^0.5.0",
+    "file-type": "^19.0.0",
+    "json-schema-to-ts": "^3.1.0",
+    "image-size": "^1.1.1",
+    "cors": "^2.8.5"
+  },
+  "dependencies": {
+    "qrcode-terminal": "^0.12.0",
+    "fluent-ffmpeg": "^2.1.2",
+    "express": "^5.0.0-beta.2",
+    "log4js": "^6.9.1",
+    "silk-wasm": "^3.6.1",
+    "ws": "^8.18.0"
+  }
+}

script/KillQQ.bat

@@ -0,0 +1,2 @@
+@echo off
+taskkill /f /im QQ.exe

script/checkVersion.cjs

@@ -0,0 +1,42 @@
+const fs = require("fs");
+const process = require("process");
+
+console.log("[NapCat] [CheckVersion] 开始检测当前仓库版本...");
+try {
+  const packageJson = require("../package.json");
+  const currentVersion = packageJson.version;
+  const targetVersion = process.env.VERSION;
+
+  console.log("[NapCat] [CheckVersion] currentVersion:", currentVersion, "targetVersion:", targetVersion);
+
+  // 验证 targetVersion 格式
+  if (!targetVersion || typeof targetVersion !== 'string') {
+    console.log("[NapCat] [CheckVersion] 目标版本格式不正确或未设置！");
+    return;
+  }
+
+  // 写入脚本文件的统一函数
+  const writeScriptToFile = (content) => {
+    fs.writeFileSync("./checkVersion.sh", content, { flag: 'w' });
+    console.log("[NapCat] [CheckVersion] checkVersion.sh 文件已更新。");
+  };
+
+  if (currentVersion === targetVersion) {
+    // 不需要更新版本，写入一个简单的脚本
+    const simpleScript = "#!/bin/bash\necho \"CheckVersion Is Done\"";
+    writeScriptToFile(simpleScript);
+  } else {
+    // 更新版本，构建安全的sed命令
+    const safeScriptContent = `
+    #!/bin/bash
+    git config --global user.email "bot@test.wumiao.wang"
+    git config --global user.name "Version"
+    sed -i "s/\\\"version\\\": \\\"${currentVersion}\\\"/\\\"version\\\": \\\"${targetVersion}\\\"/g" package.json
+    git add .
+    git commit -m "chore:version change"
+    git push -u origin main`;
+    writeScriptToFile(safeScriptContent);
+  }
+} catch (error) {
+  console.log("[NapCat] [CheckVersion] 检测过程中发生错误：", error);
+}

src/common/audio.ts

@@ -0,0 +1,89 @@
+import fsPromise from 'fs/promises';
+import path from 'node:path';
+import { randomUUID } from 'crypto';
+import { spawn } from 'node:child_process';
+import { encode, getDuration, getWavFileInfo, isSilk, isWav } from 'silk-wasm';
+import { LogWrapper } from './log';
+
+const ALLOW_SAMPLE_RATE = [8000, 12000, 16000, 24000, 32000, 44100, 48000];
+const EXIT_CODES = [0, 255];
+const FFMPEG_PATH = process.env.FFMPEG_PATH || 'ffmpeg';
+
+async function guessDuration(pttPath: string, logger: LogWrapper) {
+    const pttFileInfo = await fsPromise.stat(pttPath);
+    const duration = Math.max(1, Math.floor(pttFileInfo.size / 1024 / 3));  // 3kb/s
+    logger.log('通过文件大小估算语音的时长:', duration);
+    return duration;
+}
+
+async function convert(filePath: string, pcmPath: string, logger: LogWrapper): Promise<Buffer> {
+    return new Promise<Buffer>((resolve, reject) => {
+        const cp = spawn(FFMPEG_PATH, ['-y', '-i', filePath, '-ar', '24000', '-ac', '1', '-f', 's16le', pcmPath]);
+        cp.on('error', (err: Error) => {
+            logger.log('FFmpeg处理转换出错: ', err.message);
+            reject(err);
+        });
+        cp.on('exit', async (code, signal) => {
+            if (code == null || EXIT_CODES.includes(code)) {
+                try {
+                    const data = await fsPromise.readFile(pcmPath);
+                    await fsPromise.unlink(pcmPath);
+                    resolve(data);
+                } catch (err) {
+                    reject(err);
+                }
+            } else {
+                logger.log(`FFmpeg exit: code=${code ?? 'unknown'} sig=${signal ?? 'unknown'}`);
+                reject(new Error('FFmpeg处理转换失败'));
+            }
+        });
+    });
+}
+
+async function handleWavFile(
+    file: Buffer, filePath: string, pcmPath: string, logger: LogWrapper
+): Promise<{input: Buffer, sampleRate: number}> {
+    const { fmt } = getWavFileInfo(file);
+    if (!ALLOW_SAMPLE_RATE.includes(fmt.sampleRate)) {
+        return { input: await convert(filePath, pcmPath, logger), sampleRate: 24000 };
+    }
+    return { input: file, sampleRate: fmt.sampleRate };
+}
+
+export async function encodeSilk(filePath: string, TEMP_DIR: string, logger: LogWrapper) {
+    try {
+        const file = await fsPromise.readFile(filePath);
+        const pttPath = path.join(TEMP_DIR, randomUUID());
+        if (!isSilk(file)) {
+            logger.log(`语音文件${filePath}需要转换成silk`);
+            const pcmPath = `${pttPath}.pcm`;
+            const { input, sampleRate } = isWav(file)
+                ? (await handleWavFile(file, filePath, pcmPath, logger))
+                : { input: await convert(filePath, pcmPath, logger), sampleRate: 24000 };
+            const silk = await encode(input, sampleRate);
+            await fsPromise.writeFile(pttPath, silk.data);
+            logger.log(`语音文件${filePath}转换成功!`, pttPath, '时长:', silk.duration);
+            return {
+                converted: true,
+                path: pttPath,
+                duration: silk.duration / 1000,
+            };
+        } else {
+            let duration = 0;
+            try {
+                duration = getDuration(file) / 1000;
+            } catch (e: any) {
+                logger.log('获取语音文件时长失败, 使用文件大小推测时长', filePath, e.stack);
+                duration = await guessDuration(filePath, logger);
+            }
+            return {
+                converted: false,
+                path: filePath,
+                duration,
+            };
+        }
+    } catch (error: any) {
+        logger.logError.bind(logger)('convert silk failed', error.stack);
+        return {};
+    }
+}

src/common/config-base.ts

@@ -0,0 +1,72 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import type { NapCatCore } from '@/core';
+
+export abstract class ConfigBase<T> {
+    name: string;
+    core: NapCatCore;
+    configPath: string;
+    configData: T = {} as T;
+
+    protected constructor(name: string, core: NapCatCore, configPath: string) {
+        this.name = name;
+        this.core = core;
+        this.configPath = configPath;
+        fs.mkdirSync(this.configPath, { recursive: true });
+        this.read();
+    }
+
+    protected getKeys(): string[] | null {
+        // 决定 key 在json配置文件中的顺序
+        return null;
+    }
+
+    getConfigPath(pathName: string | undefined): string {
+        if (!pathName) {
+            const filename = `${this.name}.json`;
+            const mainPath = this.core.context.pathWrapper.binaryPath;
+            return path.join(mainPath, 'config', filename);
+        } else {
+            const filename = `${this.name}_${pathName}.json`;
+            return path.join(this.configPath, filename);
+        }
+    }
+
+    read(): T {
+        const logger = this.core.context.logger;
+        const configPath = this.getConfigPath(this.core.selfInfo.uin);
+        if (!fs.existsSync(configPath)) {
+            try {
+                fs.writeFileSync(configPath, fs.readFileSync(this.getConfigPath(undefined), 'utf-8'));
+                logger.log(`[Core] [Config] 配置文件创建成功!\n`);
+            } catch (e: any) {
+                logger.logError.bind(logger)(`[Core] [Config] 创建配置文件时发生错误:`, e.message);
+            }
+        }
+        try {
+            this.configData = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            logger.logDebug(`[Core] [Config] 配置文件${configPath}加载`, this.configData);
+            return this.configData;
+        } catch (e: any) {
+            if (e instanceof SyntaxError) {
+                logger.logError.bind(logger)(`[Core] [Config] 配置文件格式错误，请检查配置文件:`, e.message);
+            } else {
+                logger.logError.bind(logger)(`[Core] [Config] 读取配置文件时发生错误:`, e.message);
+            }
+            return {} as T;
+        }
+    }
+
+
+    save(newConfigData: T = this.configData) {
+        const logger = this.core.context.logger;
+        const selfInfo = this.core.selfInfo;
+        this.configData = newConfigData;
+        const configPath = this.getConfigPath(selfInfo.uin);
+        try {
+            fs.writeFileSync(configPath, JSON.stringify(newConfigData, this.getKeys(), 2));
+        } catch (e: any) {
+            logger.logError.bind(logger)(`保存配置文件 ${configPath} 时发生错误:`, e.message);
+        }
+    }
+}

src/common/event.ts

@@ -0,0 +1,257 @@
+import { NodeIQQNTWrapperSession } from '@/core/wrapper';
+import { randomUUID } from 'crypto';
+import { ListenerNamingMapping, ServiceNamingMapping } from '@/core';
+
+interface InternalMapKey {
+    timeout: number;
+    createtime: number;
+    func: (...arg: any[]) => any;
+    checker: ((...args: any[]) => boolean) | undefined;
+}
+
+export type ListenerClassBase = Record<string, string>;
+
+export class NTEventWrapper {
+    private WrapperSession: NodeIQQNTWrapperSession | undefined; //WrapperSession
+    private listenerManager: Map<string, ListenerClassBase> = new Map<string, ListenerClassBase>(); //ListenerName-Unique -> Listener实例
+    private EventTask = new Map<string, Map<string, Map<string, InternalMapKey>>>(); //tasks ListenerMainName -> ListenerSubName-> uuid -> {timeout,createtime,func}
+
+    constructor(
+        wrapperSession: NodeIQQNTWrapperSession,
+    ) {
+        this.WrapperSession = wrapperSession;
+    }
+
+    createProxyDispatch(ListenerMainName: string) {
+        const dispatcherListenerFunc = this.dispatcherListener.bind(this);
+        return new Proxy(
+            {},
+            {
+                get(target: any, prop: any, receiver: any) {
+                    if (typeof target[prop] === 'undefined') {
+                        // 如果方法不存在，返回一个函数，这个函数调用existentMethod
+                        return (...args: any[]) => {
+                            dispatcherListenerFunc(ListenerMainName, prop, ...args).then();
+                        };
+                    }
+                    // 如果方法存在，正常返回
+                    return Reflect.get(target, prop, receiver);
+                },
+            },
+        );
+    }
+
+    createEventFunction<
+        Service extends keyof ServiceNamingMapping,
+        ServiceMethod extends Exclude<keyof ServiceNamingMapping[Service], symbol>,
+        // eslint-disable-next-line
+        // @ts-ignore
+        T extends (...args: any) => any = ServiceNamingMapping[Service][ServiceMethod],
+    >(eventName: `${Service}/${ServiceMethod}`): 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];
+            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 existListener = this.listenerManager.get(listenerMainName + uniqueCode);
+        if (!existListener) {
+            const Listener = this.createProxyDispatch(listenerMainName);
+            const ServiceSubName = /^NodeIKernel(.*?)Listener$/.exec(listenerMainName)![1];
+            const Service = `NodeIKernel${ServiceSubName}Service/addKernel${ServiceSubName}Listener`;
+            // eslint-disable-next-line
+            // @ts-ignore
+            this.createEventFunction(Service)(Listener as T);
+            this.listenerManager.set(listenerMainName + uniqueCode, Listener);
+            return Listener as T;
+        }
+        return existListener as T;
+    }
+
+    //统一回调清理事件
+    async dispatcherListener(ListenerMainName: string, ListenerSubName: string, ...args: any[]) {
+        this.EventTask.get(ListenerMainName)
+            ?.get(ListenerSubName)
+            ?.forEach((task, uuid) => {
+                if (task.createtime + task.timeout < Date.now()) {
+                    this.EventTask.get(ListenerMainName)?.get(ListenerSubName)?.delete(uuid);
+                    return;
+                }
+                if (task?.checker?.(...args)) {
+                    task.func(...args);
+                }
+            });
+    }
+
+    async callNoListenerEvent<
+        Service extends keyof ServiceNamingMapping,
+        ServiceMethod extends Exclude<keyof ServiceNamingMapping[Service], symbol>,
+        // eslint-disable-next-line
+        // @ts-ignore
+        EventType extends (...args: any) => any = ServiceNamingMapping[Service][ServiceMethod],
+    >(
+        serviceAndMethod: `${Service}/${ServiceMethod}`,
+        ...args: Parameters<EventType>
+    ): Promise<Awaited<ReturnType<EventType>>> {
+        return (this.createEventFunction(serviceAndMethod))!(...args);
+    }
+
+    async registerListen<
+        Listener extends keyof ListenerNamingMapping,
+        ListenerMethod extends Exclude<keyof ListenerNamingMapping[Listener], symbol>,
+        // eslint-disable-next-line
+        // @ts-ignore
+        ListenerType extends (...args: any) => any = ListenerNamingMapping[Listener][ListenerMethod],
+    >(
+        listenerAndMethod: `${Listener}/${ListenerMethod}`,
+        waitTimes = 1,
+        timeout = 5000,
+        checker: (...args: Parameters<ListenerType>) => boolean,
+    ) {
+        return new Promise<Parameters<ListenerType>>((resolve, reject) => {
+            const ListenerNameList = listenerAndMethod.split('/');
+            const ListenerMainName = ListenerNameList[0];
+            const ListenerSubName = ListenerNameList[1];
+            const id = randomUUID();
+            let complete = 0;
+            let retData: Parameters<ListenerType> | undefined = undefined;
+
+            function sendDataCallback() {
+                if (complete == 0) {
+                    reject(new Error(' ListenerName:' + listenerAndMethod + ' timeout'));
+                } else {
+                    resolve(retData!);
+                }
+            }
+
+            const timeoutRef = setTimeout(sendDataCallback, timeout);
+            const eventCallback = {
+                timeout: timeout,
+                createtime: Date.now(),
+                checker: checker,
+                func: (...args: Parameters<ListenerType>) => {
+                    complete++;
+                    retData = args;
+                    if (complete >= waitTimes) {
+                        clearTimeout(timeoutRef);
+                        sendDataCallback();
+                    }
+                },
+            };
+            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, eventCallback);
+            this.createListenerFunction(ListenerMainName);
+        });
+    }
+
+    async callNormalEventV2<
+        Service extends keyof ServiceNamingMapping,
+        ServiceMethod extends Exclude<keyof ServiceNamingMapping[Service], symbol>,
+        Listener extends keyof ListenerNamingMapping,
+        ListenerMethod extends Exclude<keyof ListenerNamingMapping[Listener], symbol>,
+        // eslint-disable-next-line
+        // @ts-ignore
+        EventType extends (...args: any) => any = ServiceNamingMapping[Service][ServiceMethod],
+        // eslint-disable-next-line
+        // @ts-ignore
+        ListenerType extends (...args: any) => any = ListenerNamingMapping[Listener][ListenerMethod]
+    >(
+        serviceAndMethod: `${Service}/${ServiceMethod}`,
+        listenerAndMethod: `${Listener}/${ListenerMethod}`,
+        args: Parameters<EventType>,
+        checkerEvent: (ret: Awaited<ReturnType<EventType>>) => boolean = () => true,
+        checkerListener: (...args: Parameters<ListenerType>) => boolean = () => true,
+        callbackTimesToWait = 1,
+        timeout = 5000,
+    ) {
+        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 = {};
+
+                function sendDataCallback() {
+                    if (complete == 0) {
+                        reject(
+                            new Error(
+                                'Timeout: NTEvent serviceAndMethod:' +
+                                serviceAndMethod +
+                                ' ListenerName:' +
+                                listenerAndMethod +
+                                ' EventRet:\n' +
+                                JSON.stringify(retEvent, null, 4) +
+                                '\n',
+                            ),
+                        );
+                    } else {
+                        resolve([retEvent as Awaited<ReturnType<EventType>>, ...retData!]);
+                    }
+                }
+
+                const ListenerNameList = listenerAndMethod.split('/');
+                const ListenerMainName = ListenerNameList[0];
+                const ListenerSubName = ListenerNameList[1];
+
+                const timeoutRef = setTimeout(sendDataCallback, timeout);
+
+                const eventCallback = {
+                    timeout: timeout,
+                    createtime: Date.now(),
+                    checker: checkerListener,
+                    func: (...args: any[]) => {
+                        complete++;
+                        retData = args as Parameters<ListenerType>;
+                        if (complete >= callbackTimesToWait) {
+                            clearTimeout(timeoutRef);
+                            sendDataCallback();
+                        }
+                    },
+                };
+                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, eventCallback);
+                this.createListenerFunction(ListenerMainName);
+                const eventFunction = this.createEventFunction(serviceAndMethod);
+                retEvent = await eventFunction!(...(args));
+                if (!checkerEvent(retEvent) && timeoutRef.hasRef()) {
+                    clearTimeout(timeoutRef);
+                    reject(
+                        new Error(
+                            'EventChecker Failed: NTEvent serviceAndMethod:' +
+                            serviceAndMethod +
+                            ' ListenerName:' +
+                            listenerAndMethod +
+                            ' EventRet:\n' +
+                            JSON.stringify(retEvent, null, 4) +
+                            '\n',
+                        ),
+                    );
+                }
+
+            },
+        );
+    }
+}

src/common/file.ts

@@ -0,0 +1,293 @@
+import fs from 'fs';
+import { stat } from 'fs/promises';
+import crypto, { randomUUID } from 'crypto';
+import util from 'util';
+import path from 'node:path';
+import * as fileType from 'file-type';
+import { solveProblem } from './helper';
+
+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();
+    });
+}
+
+// 定义一个异步函数来检查文件是否存在
+export async function checkFileReceived2(path: string, timeout: number = 3000): Promise<void> {
+    // 使用 Promise.race 来同时进行文件状态检查和超时计时
+    // Promise.race 会返回第一个解决（resolve）或拒绝（reject）的 Promise
+    await Promise.race([
+        checkFile(path),
+        timeoutPromise(timeout, `文件不存在: ${path}`),
+    ]);
+}
+
+// 转换超时时间至 Promise
+function timeoutPromise(timeout: number, errorMsg: string): Promise<void> {
+    return new Promise((_, reject) => {
+        setTimeout(() => {
+            reject(new Error(errorMsg));
+        }, timeout);
+    });
+}
+
+// 异步检查文件是否存在
+async function checkFile(path: string): Promise<void> {
+    try {
+        await stat(path);
+    } catch (error: any) {
+        if (error.code === 'ENOENT') {
+            // 如果文件不存在，则抛出一个错误
+            throw new Error(`文件不存在: ${path}`);
+        } else {
+            // 对于 stat 调用的其他错误，重新抛出
+            throw error;
+        }
+    }
+    // 如果文件存在，则无需做任何事情，Promise 解决（resolve）自身
+}
+
+export async function file2base64(path: string) {
+    const readFile = util.promisify(fs.readFile);
+    const 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: any) {
+        result.err = err.toString();
+    }
+    return result;
+}
+
+export function calculateFileMD5(filePath: string): Promise<string> {
+    return new Promise((resolve, reject) => {
+        // 创建一个流式读取器
+        const stream = fs.createReadStream(filePath);
+        const hash = crypto.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 interface HttpDownloadOptions {
+    url: string;
+    headers?: Record<string, string> | string;
+}
+
+async function tryDownload(options: string | HttpDownloadOptions, useReferer: boolean = false): Promise<Response> {
+    // const chunks: Buffer[] = [];
+    let url: string;
+    let 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',
+    };
+    if (typeof options === 'string') {
+        url = options;
+        headers['Host'] = new URL(url).hostname;
+    } else {
+        url = options.url;
+        if (options.headers) {
+            if (typeof options.headers === 'string') {
+                headers = JSON.parse(options.headers);
+            } else {
+                headers = options.headers;
+            }
+        }
+    }
+    if (useReferer && !headers['Referer']) {
+        headers['Referer'] = url;
+    }
+    const fetchRes = await fetch(url, { headers }).catch((err) => {
+        if (err.cause) {
+            throw err.cause;
+        }
+        throw err;
+    });
+    return fetchRes;
+}
+
+export async function httpDownload(options: string | HttpDownloadOptions): Promise<Buffer> {
+    const useReferer = typeof options === 'string';
+    let resp = await tryDownload(options);
+    if (resp.status === 403 && useReferer) {
+        resp = await tryDownload(options, true);
+    }
+    if (!resp.ok) throw new Error(`下载文件失败: ${resp.statusText}`);
+    const blob = await resp.blob();
+    const buffer = await blob.arrayBuffer();
+    return Buffer.from(buffer);
+}
+
+type Uri2LocalRes = {
+    success: boolean,
+    errMsg: string,
+    fileName: string,
+    ext: string,
+    path: string
+}
+
+export async function checkFileV2(filePath: string) {
+    try {
+        const ext: string | undefined = (await fileType.fileTypeFromFile(filePath))?.ext;
+        if (ext) {
+            fs.renameSync(filePath, filePath + `.${ext}`);
+            filePath += `.${ext}`;
+            return { success: true, ext: ext, path: filePath };
+        }
+    } catch (e) {
+        // log("获取文件类型失败", filePath,e.stack)
+    }
+    return { success: false, ext: '', path: filePath };
+}
+
+export enum FileUriType {
+    Unknown = 0,
+    Local = 1,
+    Remote = 2,
+    Base64 = 3
+}
+
+export async function checkUriType(Uri: string) {
+
+    const LocalFileRet = await solveProblem((uri: string) => {
+        if (fs.existsSync(uri)) {
+            return { Uri: uri, Type: FileUriType.Local };
+        }
+        return undefined;
+    }, Uri);
+    if (LocalFileRet) return LocalFileRet;
+    const OtherFileRet = await solveProblem((uri: string) => {
+        //再判断是否是Http
+        if (uri.startsWith('http://') || uri.startsWith('https://')) {
+            return { Uri: uri, Type: FileUriType.Remote };
+        }
+        //再判断是否是Base64
+        if (uri.startsWith('base64://')) {
+            return { Uri: uri, Type: FileUriType.Base64 };
+        }
+        if (uri.startsWith('file://')) {
+            let filePath: string;
+            const pathname = decodeURIComponent(new URL(uri).pathname);
+            if (process.platform === 'win32') {
+                filePath = pathname.slice(1);
+            } else {
+                filePath = pathname;
+            }
+
+            return { Uri: filePath, Type: FileUriType.Local };
+        }
+        if (uri.startsWith('data:')) {
+            const data = uri.split(',')[1];
+            if (data) return { Uri: data, Type: FileUriType.Base64 };
+        }
+    }, Uri);
+    if (OtherFileRet) return OtherFileRet;
+
+    return { Uri: Uri, Type: FileUriType.Unknown };
+}
+
+export async function uri2local(dir: string, uri: string, filename: string | undefined = undefined): Promise<Uri2LocalRes> {
+    const { Uri: HandledUri, Type: UriType } = await checkUriType(uri);
+    //解析失败
+    const tempName = randomUUID();
+    if (!filename) filename = randomUUID();
+    //解析Http和Https协议
+
+    if (UriType == FileUriType.Unknown) {
+        return { success: false, errMsg: '未知文件类型', fileName: '', ext: '', path: '' };
+    }
+    //解析File协议和本地文件
+    if (UriType == FileUriType.Local) {
+        const fileExt = path.extname(HandledUri);
+        let filename = path.basename(HandledUri, fileExt);
+        filename += fileExt;
+        //复制文件到临时文件并保持后缀
+        const filenameTemp = tempName + fileExt;
+        const filePath = path.join(dir, filenameTemp);
+        fs.copyFileSync(HandledUri, filePath);
+        return { success: true, errMsg: '', fileName: filename, ext: fileExt, path: filePath };
+    }
+    //接下来都要有文件名
+
+    if (UriType == FileUriType.Remote) {
+        const pathInfo = path.parse(decodeURIComponent(new URL(HandledUri).pathname));
+        if (pathInfo.name) {
+            const pathlen = 200 - dir.length - pathInfo.name.length;
+            filename = pathlen > 0 ? pathInfo.name.substring(0, pathlen) : pathInfo.name.substring(pathInfo.name.length, pathInfo.name.length - 10);//过长截断
+            if (pathInfo.ext) {
+                filename += pathInfo.ext;
+            }
+        }
+        filename = filename.replace(/[/\\:*?"<>|]/g, '_');
+        const fileExt = path.extname(HandledUri).replace(/[/\\:*?"<>|]/g, '_').substring(0, 10);
+        const filePath = path.join(dir, tempName + fileExt);
+        const buffer = await httpDownload(HandledUri);
+        //没有文件就创建
+        fs.writeFileSync(filePath, buffer, { flag: 'wx' });
+        return { success: true, errMsg: '', fileName: filename, ext: fileExt, path: filePath };
+    }
+    //解析Base64
+    if (UriType == FileUriType.Base64) {
+        const base64 = HandledUri.replace(/^base64:\/\//, '');
+        const buffer = Buffer.from(base64, 'base64');
+        let filePath = path.join(dir, filename);
+        let fileExt = '';
+        fs.writeFileSync(filePath, buffer);
+        const { success, ext, path: fileTypePath } = await checkFileV2(filePath);
+        if (success) {
+            filePath = fileTypePath;
+            fileExt = ext;
+            filename = filename + '.' + ext;
+        }
+        return { success: true, errMsg: '', fileName: filename, ext: fileExt, path: filePath };
+    }
+    return { success: false, errMsg: '未知文件类型', fileName: '', ext: '', path: '' };
+}

src/common/helper.ts

@@ -0,0 +1,241 @@
+import path from 'node:path';
+import fs from 'fs';
+import os from 'node:os';
+import { Peer, QQLevel } from '@/core';
+
+export async function solveProblem<T extends (...arg: any[]) => any>(func: T, ...args: Parameters<T>): Promise<ReturnType<T> | undefined> {
+    return new Promise<ReturnType<T> | undefined>((resolve) => {
+        try {
+            const result = func(...args);
+            resolve(result);
+        } catch (e) {
+            resolve(undefined);
+        }
+    });
+}
+
+export async function solveAsyncProblem<T extends (...args: any[]) => Promise<any>>(func: T, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>> | undefined> {
+    return new Promise<Awaited<ReturnType<T>> | undefined>((resolve) => {
+        func(...args).then((result) => {
+            resolve(result);
+        }).catch(() => {
+            resolve(undefined);
+        });
+    });
+}
+
+export class FileNapCatOneBotUUID {
+    static encodeModelId(peer: Peer, modelId: string, fileId: string, fileUUID: string = "", endString: string = ""): string {
+        const data = `NapCatOneBot|ModelIdFile|${peer.chatType}|${peer.peerUid}|${modelId}|${fileId}|${fileUUID}`;
+        //前四个字节塞data长度
+        const length = Buffer.alloc(4 + data.length);
+        length.writeUInt32BE(data.length * 2, 0);//储存data的hex长度
+        length.write(data, 4);
+        return length.toString('hex') + endString;
+    }
+
+    static decodeModelId(uuid: string): undefined | {
+        peer: Peer,
+        modelId: string,
+        fileId: string,
+        fileUUID?: string
+    } {
+        //前四个字节是data长度
+        const length = Buffer.from(uuid.slice(0, 8), 'hex').readUInt32BE(0);
+        //根据length计算需要读取的长度
+        const dataId = uuid.slice(8, 8 + length);
+        //hex还原为string
+        const realData = Buffer.from(dataId, 'hex').toString();
+        if (!realData.startsWith('NapCatOneBot|ModelIdFile|')) return undefined;
+        const data = realData.split('|');
+        if (data.length < 6) return undefined;  // compatibility requirement
+        const [, , chatType, peerUid, modelId, fileId, fileUUID = undefined] = data;
+        return {
+            peer: {
+                chatType: chatType as any,
+                peerUid: peerUid,
+            },
+            modelId,
+            fileId,
+            fileUUID
+        };
+    }
+
+    static encode(peer: Peer, msgId: string, elementId: string, fileUUID: string = "", endString: string = ""): string {
+        const data = `NapCatOneBot|MsgFile|${peer.chatType}|${peer.peerUid}|${msgId}|${elementId}|${fileUUID}`;
+        //前四个字节塞data长度
+        //一个字节8位 一个ascii字符1字节 一个hex字符4位 表示一个ascii字符需要两个hex字符
+        const length = Buffer.alloc(4 + data.length);
+        length.writeUInt32BE(data.length * 2, 0);
+        length.write(data, 4);
+        return length.toString('hex') + endString;
+    }
+
+    static decode(uuid: string): undefined | {
+        peer: Peer,
+        msgId: string,
+        elementId: string,
+        fileUUID?: string
+    } {
+        //前四个字节是data长度
+        const length = Buffer.from(uuid.slice(0, 8), 'hex').readUInt32BE(0);
+        //根据length计算需要读取的长度
+        const dataId = uuid.slice(8, 8 + length);
+        //hex还原为string
+        const realData = Buffer.from(dataId, 'hex').toString();
+        if (!realData.startsWith('NapCatOneBot|MsgFile|')) return undefined;
+        const data = realData.split('|');
+        if (data.length < 6) return undefined;  // compatibility requirement
+        const [, , chatType, peerUid, msgId, elementId, fileUUID = undefined] = data;
+        return {
+            peer: {
+                chatType: chatType as any,
+                peerUid: peerUid,
+            },
+            msgId,
+            elementId,
+            fileUUID
+        };
+    }
+}
+
+export function sleep(ms: number): Promise<void> {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export function PromiseTimer<T>(promise: Promise<T>, ms: number): Promise<T> {
+    const timeoutPromise = new Promise<T>((_, reject) =>
+        setTimeout(() => reject(new Error('PromiseTimer: Operation timed out')), ms),
+    );
+    return Promise.race([promise, timeoutPromise]);
+}
+
+export async function runAllWithTimeout<T>(tasks: Promise<T>[], timeout: number): Promise<T[]> {
+    const wrappedTasks = tasks.map((task) =>
+        PromiseTimer(task, timeout).then(
+            (result) => ({ status: 'fulfilled', value: result }),
+            (error) => ({ status: 'rejected', reason: error }),
+        ),
+    );
+    const results = await Promise.all(wrappedTasks);
+    return results
+        .filter((result) => result.status === 'fulfilled')
+        .map((result) => (result as { status: 'fulfilled'; value: T }).value);
+}
+
+export function isNull(value: any) {
+    return value === undefined || value === null;
+}
+
+export function isNumeric(str: string) {
+    return /^\d+$/.test(str);
+}
+
+export 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 function isEqual(obj1: any, obj2: any) {
+    if (obj1 === obj2) return true;
+    if (obj1 == null || obj2 == null) return false;
+    if (typeof obj1 !== 'object' || typeof obj2 !== 'object') return obj1 === obj2;
+
+    const keys1 = Object.keys(obj1);
+    const keys2 = Object.keys(obj2);
+
+    if (keys1.length !== keys2.length) return false;
+
+    for (const key of keys1) {
+        if (!isEqual(obj1[key], obj2[key])) return false;
+    }
+    return true;
+}
+
+export function getDefaultQQVersionConfigInfo(): QQVersionConfigType {
+    if (os.platform() === 'linux') {
+        return {
+            baseVersion: '3.2.12.28060',
+            curVersion: '3.2.12.28060',
+            prevVersion: '',
+            onErrorVersions: [],
+            buildId: '27254',
+        };
+    }
+    if (os.platform() === 'darwin') {
+        return {
+            baseVersion: '6.9.53.28060',
+            curVersion: '6.9.53.28060',
+            prevVersion: '',
+            onErrorVersions: [],
+            buildId: '28060',
+        };
+    }
+    return {
+        baseVersion: '9.9.15-28131',
+        curVersion: '9.9.15-28131',
+        prevVersion: '',
+        onErrorVersions: [],
+        buildId: '28131',
+    };
+}
+
+export function getQQPackageInfoPath(exePath: string = '', version?: string): string {
+    let packagePath;
+    if (os.platform() === 'darwin') {
+        packagePath = path.join(path.dirname(exePath), '..', 'Resources', 'app', 'package.json');
+    } else if (os.platform() === 'linux') {
+        packagePath = path.join(path.dirname(exePath), './resources/app/package.json');
+    } else {
+        packagePath = path.join(path.dirname(exePath), './versions/' + version + '/resources/app/package.json');
+    }
+    //下面是老版本兼容 未来去掉
+    if (!fs.existsSync(packagePath)) {
+        packagePath = path.join(path.dirname(exePath), './resources/app/versions/' + version + '/package.json');
+    }
+    return packagePath;
+}
+
+export function getQQVersionConfigPath(exePath: string = ''): string | undefined {
+    let configVersionInfoPath;
+    if (os.platform() === 'win32') {
+        configVersionInfoPath = path.join(path.dirname(exePath), 'versions', 'config.json');
+    } else if (os.platform() === 'darwin') {
+        const userPath = os.homedir();
+        const appDataPath = path.resolve(userPath, './Library/Application Support/QQ');
+        configVersionInfoPath = path.resolve(appDataPath, './versions/config.json');
+    } else {
+        const userPath = os.homedir();
+        const appDataPath = path.resolve(userPath, './.config/QQ');
+        configVersionInfoPath = path.resolve(appDataPath, './versions/config.json');
+    }
+    if (typeof configVersionInfoPath !== 'string') {
+        return undefined;
+    }
+    //老版本兼容 未来去掉
+    if (!fs.existsSync(configVersionInfoPath)) {
+        configVersionInfoPath = path.join(path.dirname(exePath), './resources/app/versions/config.json');
+    }
+    if (!fs.existsSync(configVersionInfoPath)) {
+        return undefined;
+    }
+    return configVersionInfoPath;
+}
+
+export function calcQQLevel(level?: QQLevel) {
+    if (!level) return 0;
+    const { crownNum, sunNum, moonNum, starNum } = level;
+    return crownNum * 64 + sunNum * 16 + moonNum * 4 + starNum;
+}

src/common/log.ts

@@ -0,0 +1,248 @@
+import log4js, { Configuration } from 'log4js';
+import { truncateString } from '@/common/helper';
+import path from 'node:path';
+import chalk from 'chalk';
+import { AtType, ChatType, ElementType, MessageElement, RawMessage, SelfInfo } from '@/core';
+
+export enum LogLevel {
+    DEBUG = 'debug',
+    INFO = 'info',
+    WARN = 'warn',
+    ERROR = 'error',
+    FATAL = 'fatal',
+}
+
+function getFormattedTimestamp() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = (now.getMonth() + 1).toString().padStart(2, '0');
+    const day = now.getDate().toString().padStart(2, '0');
+    const hours = now.getHours().toString().padStart(2, '0');
+    const minutes = now.getMinutes().toString().padStart(2, '0');
+    const seconds = now.getSeconds().toString().padStart(2, '0');
+    const milliseconds = now.getMilliseconds().toString().padStart(3, '0');
+    return `${year}-${month}-${day}_${hours}-${minutes}-${seconds}.${milliseconds}`;
+}
+
+export class LogWrapper {
+    fileLogEnabled = true;
+    consoleLogEnabled = true;
+    logConfig: Configuration;
+    loggerConsole: log4js.Logger;
+    loggerFile: log4js.Logger;
+    loggerDefault: log4js.Logger;
+    // eslint-disable-next-line no-control-regex
+    colorEscape = /\x1B[@-_][0-?]*[ -/]*[@-~]/g;
+
+    constructor(logDir: string) {
+        const filename = `${getFormattedTimestamp()}.log`;
+        const logPath = path.join(logDir, filename);
+        this.logConfig = {
+            appenders: {
+                FileAppender: { // 输出到文件的appender
+                    type: 'file',
+                    filename: logPath, // 指定日志文件的位置和文件名
+                    maxLogSize: 10485760, // 日志文件的最大大小（单位：字节），这里设置为10MB
+                    layout: {
+                        type: 'pattern',
+                        pattern: '%d{yyyy-MM-dd hh:mm:ss} [%p] %X{userInfo} | %m',
+                    },
+                },
+                ConsoleAppender: { // 输出到控制台的appender
+                    type: 'console',
+                    layout: {
+                        type: 'pattern',
+                        pattern: `%d{yyyy-MM-dd hh:mm:ss} [%[%p%]] ${chalk.magenta('%X{userInfo}')} | %m`,
+                    },
+                },
+            },
+            categories: {
+                default: { appenders: ['FileAppender', 'ConsoleAppender'], level: 'debug' }, // 默认情况下同时输出到文件和控制台
+                file: { appenders: ['FileAppender'], level: 'debug' },
+                console: { appenders: ['ConsoleAppender'], level: 'debug' },
+            },
+        };
+        log4js.configure(this.logConfig);
+        this.loggerConsole = log4js.getLogger('console');
+        this.loggerFile = log4js.getLogger('file');
+        this.loggerDefault = log4js.getLogger('default');
+        this.setLogSelfInfo({ nick: '', uin: '', uid: '' });
+    }
+
+    setFileAndConsoleLogLevel(fileLogLevel: LogLevel, consoleLogLevel: LogLevel) {
+        this.logConfig.categories.file.level = fileLogLevel;
+        this.logConfig.categories.console.level = consoleLogLevel;
+        log4js.configure(this.logConfig);
+    }
+
+    setLogSelfInfo(selfInfo: { nick: string, uin: string, uid: string }) {
+        const userInfo = `${selfInfo.nick}(${selfInfo.uin})`;
+        this.loggerConsole.addContext('userInfo', userInfo);
+        this.loggerFile.addContext('userInfo', userInfo);
+        this.loggerDefault.addContext('userInfo', userInfo);
+    }
+
+    setFileLogEnabled(isEnabled: boolean) {
+        this.fileLogEnabled = isEnabled;
+    }
+
+    setConsoleLogEnabled(isEnabled: boolean) {
+        this.consoleLogEnabled = isEnabled;
+    }
+
+    formatMsg(msg: any[]) {
+        let logMsg = '';
+        for (const msgItem of msg) {
+            if (msgItem instanceof Error) { // 判断是否是错误
+                logMsg += msgItem.stack + ' ';
+                continue;
+            } else if (typeof msgItem === 'object') { // 判断是否是对象
+                const obj = JSON.parse(JSON.stringify(msgItem, null, 2));
+                logMsg += JSON.stringify(truncateString(obj)) + ' ';
+                continue;
+            }
+            logMsg += msgItem + ' ';
+        }
+        return logMsg;
+    }
+
+
+    _log(level: LogLevel, ...args: any[]) {
+        if (this.consoleLogEnabled) {
+            this.loggerConsole[level](this.formatMsg(args));
+        }
+        if (this.fileLogEnabled) {
+            this.loggerFile[level](this.formatMsg(args).replace(this.colorEscape, ''));
+        }
+    }
+
+    log(...args: any[]) {
+        // info 等级
+        this._log(LogLevel.INFO, ...args);
+    }
+
+    logDebug(...args: any[]) {
+        this._log(LogLevel.DEBUG, ...args);
+    }
+
+    logError(...args: any[]) {
+        this._log(LogLevel.ERROR, ...args);
+    }
+
+    logWarn(...args: any[]) {
+        this._log(LogLevel.WARN, ...args);
+    }
+
+    logFatal(...args: any[]) {
+        this._log(LogLevel.FATAL, ...args);
+    }
+
+    logMessage(msg: RawMessage, selfInfo: SelfInfo) {
+        const isSelfSent = msg.senderUin === selfInfo.uin;
+
+        // Intercept grey tip
+        if (msg.elements[0]?.elementType === ElementType.GreyTip) {
+            return;
+        }
+
+        this.log(`${isSelfSent ? '发送 ->' : '接收 <-' } ${rawMessageToText(msg)}`);
+    }
+}
+
+export function rawMessageToText(msg: RawMessage, recursiveLevel = 0): string {
+    if (recursiveLevel > 2) {
+        return '...';
+    }
+
+    const tokens: string[] = [];
+
+    if (msg.chatType == ChatType.KCHATTYPEC2C) {
+        tokens.push(`私聊 (${msg.peerUin})`);
+    } else if (msg.chatType == ChatType.KCHATTYPEGROUP) {
+        if (recursiveLevel < 1) {
+            tokens.push(`群聊 [${msg.peerName}(${msg.peerUin})]`);
+        }
+        if (msg.senderUin !== '0') {
+            tokens.push(`[${msg.sendMemberName || msg.sendRemarkName || msg.sendNickName}(${msg.senderUin})]`);
+        }
+    } else if (msg.chatType == ChatType.KCHATTYPEDATALINE) {
+        tokens.push('移动设备');
+    } else /* temp */ {
+        tokens.push(`临时消息 (${msg.peerUin})`);
+    }
+
+    // message content
+
+    function msgElementToText(element: MessageElement) {
+        if (element.textElement) {
+            if (element.textElement.atType === AtType.notAt) {
+                const originalContentLines = element.textElement.content.split('\n');
+                return `${originalContentLines[0]}${originalContentLines.length > 1 ? ' ...' : ''}`;
+            } else if (element.textElement.atType === AtType.atAll) {
+                return `@全体成员`;
+            } else if (element.textElement.atType === AtType.atUser) {
+                return `${element.textElement.content} (${element.textElement.atUid})`;
+            }
+        }
+
+        if (element.replyElement) {
+            const recordMsgOrNull = msg.records.find(
+                record => element.replyElement!.sourceMsgIdInRecords === record.msgId,
+            );
+            return `[回复消息 ${recordMsgOrNull &&
+                    recordMsgOrNull.peerUin != '284840486' && recordMsgOrNull.peerUin != '1094950020'// 非转发消息; 否则定位不到
+                ?
+                rawMessageToText(recordMsgOrNull, recursiveLevel + 1) :
+                `未找到消息记录 (MsgId = ${element.replyElement.sourceMsgIdInRecords})`
+            }]`;
+        }
+
+        if (element.picElement) {
+            return '[图片]';
+        }
+
+        if (element.fileElement) {
+            return `[文件 ${element.fileElement.fileName}]`;
+        }
+
+        if (element.videoElement) {
+            return '[视频]';
+        }
+
+        if (element.pttElement) {
+            return `[语音 ${element.pttElement.duration}s]`;
+        }
+
+        if (element.arkElement) {
+            return '[卡片消息]';
+        }
+
+        if (element.faceElement) {
+            return `[表情 ${element.faceElement.faceText ?? ''}]`;
+        }
+
+        if (element.marketFaceElement) {
+            return element.marketFaceElement.faceName;
+        }
+
+        if (element.markdownElement) {
+            return '[Markdown 消息]';
+        }
+
+        if (element.multiForwardMsgElement) {
+            return '[转发消息]';
+        }
+
+        if (element.elementType === ElementType.GreyTip) {
+            return '[灰条消息]';
+        }
+
+        return `[未实现 (ElementType = ${element.elementType})]`;
+    }
+
+    for (const element of msg.elements) {
+        tokens.push(msgElementToText(element));
+    }
+
+    return tokens.join(' ');
+}

src/common/lru-cache.ts

@@ -0,0 +1,33 @@
+export class LRUCache<K, V> {
+    private capacity: number;
+    private cache: Map<K, V>;
+
+    constructor(capacity: number) {
+        this.capacity = capacity;
+        this.cache = new Map<K, V>();
+    }
+
+    public get(key: K): V | undefined {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Move the accessed key to the end to mark it as most recently used
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+
+    public put(key: K, value: V): void {
+        if (this.cache.has(key)) {
+            // If the key already exists, move it to the end to mark it as most recently used
+            this.cache.delete(key);
+        } else if (this.cache.size >= this.capacity) {
+            // If the cache is full, remove the least recently used key (the first one in the map)
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+}

src/common/message-unique.ts

@@ -0,0 +1,138 @@
+import { Peer } from '@/core';
+import crypto from 'crypto';
+
+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) {
+            this.keyToValue.clear();
+            this.valueToKey.clear();
+        }
+        while (this.keyToValue.size > this.maxSize || this.valueToKey.size > this.maxSize) {
+            const oldestKey = this.keyToValue.keys().next().value;
+            // @ts-ignore
+            this.valueToKey.delete(this.keyToValue.get(oldestKey)!);
+            // @ts-ignore
+            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;
+    }
+}
+
+class MessageUniqueWrapper {
+    private msgDataMap: LimitedHashTable<string, number>;
+    private msgIdMap: LimitedHashTable<string, number>;
+
+    constructor(maxMap: number = 1000) {
+        this.msgIdMap = new LimitedHashTable<string, number>(maxMap);
+        this.msgDataMap = new LimitedHashTable<string, number>(maxMap);
+    }
+
+    getRecentMsgIds(Peer: Peer, size: number): string[] {
+        const heads = this.msgIdMap.getHeads(size);
+        if (!heads) {
+            return [];
+        }
+        const data = heads.map((t) => 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);
+    }
+
+    createUniqueMsgId(peer: Peer, msgId: string) {
+        const key = `${msgId}|${peer.chatType}|${peer.peerUid}`;
+        const hash = crypto.createHash('md5').update(key).digest();
+        //设置第一个bit为0 保证shortId为正数
+        hash[0] &= 0x7f;
+        const shortId = hash.readInt32BE(0);
+        //减少性能损耗
+        this.msgIdMap.set(msgId, shortId);
+        this.msgDataMap.set(key, shortId);
+        return shortId;
+    }
+
+    getMsgIdAndPeerByShortId(shortId: number): { MsgId: string; Peer: Peer } | 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 };
+        }
+        return undefined;
+    }
+
+    getShortIdByMsgId(msgId: string): number | undefined {
+        return this.msgIdMap.getValue(msgId);
+    }
+
+    getPeerByMsgId(msgId: string) {
+        const shortId = this.msgIdMap.getValue(msgId);
+        if (!shortId) return undefined;
+        return this.getMsgIdAndPeerByShortId(shortId);
+    }
+
+    resize(maxSize: number): void {
+        this.msgIdMap.resize(maxSize);
+        this.msgDataMap.resize(maxSize);
+    }
+}
+
+export const MessageUnique: MessageUniqueWrapper = new MessageUniqueWrapper();

src/common/path.ts

@@ -0,0 +1,35 @@
+import path, { dirname } from 'path';
+import { fileURLToPath } from 'url';
+import fs from 'fs';
+import os from 'os';
+
+export class NapCatPathWrapper {
+    binaryPath: string;
+    logsPath: string;
+    configPath: string;
+    cachePath: string;
+    staticPath: string;
+
+    constructor(mainPath: string = dirname(fileURLToPath(import.meta.url))) {
+        this.binaryPath = mainPath;
+        let writePath: string;
+        if (os.platform() === 'darwin') {
+            writePath = path.join(os.homedir(), 'Library', 'Application Support', 'QQ', 'NapCat');
+        } else {
+            writePath = this.binaryPath;
+        }
+        this.logsPath = path.join(writePath, 'logs');
+        this.configPath = path.join(writePath, 'config');
+        this.cachePath = path.join(writePath, 'cache');
+        this.staticPath = path.join(this.binaryPath, 'static');
+        if (!fs.existsSync(this.logsPath)) {
+            fs.mkdirSync(this.logsPath, { recursive: true });
+        }
+        if (!fs.existsSync(this.configPath)) {
+            fs.mkdirSync(this.configPath, { recursive: true });
+        }
+        if (!fs.existsSync(this.cachePath)) {
+            fs.mkdirSync(this.cachePath, { recursive: true });
+        }
+    }
+}

src/common/proxy-handler.ts

@@ -0,0 +1,20 @@
+import { LogWrapper } from './log';
+
+export function proxyHandlerOf(logger: LogWrapper) {
+    return {
+        get(target: any, prop: any, receiver: any) {
+            if (typeof target[prop] === 'undefined') {
+                // 如果方法不存在，返回一个函数，这个函数调用existentMethod
+                return (..._args: unknown[]) => {
+                    logger.logDebug(`${target.constructor.name} has no method ${prop}`);
+                };
+            }
+            // 如果方法存在，正常返回
+            return Reflect.get(target, prop, receiver);
+        },
+    };
+}
+
+export function proxiedListenerOf<T extends object>(listener: T, logger: LogWrapper) {
+    return new Proxy<T>(listener, proxyHandlerOf(logger));
+}

src/common/qq-basic-info.ts

@@ -0,0 +1,89 @@
+import fs from 'node:fs';
+import { systemPlatform } from '@/common/system';
+import { getDefaultQQVersionConfigInfo, getQQPackageInfoPath, getQQVersionConfigPath } from './helper';
+import AppidTable from '@/core/external/appid.json';
+import { LogWrapper } from './log';
+
+export class QQBasicInfoWrapper {
+    QQMainPath: string | undefined;
+    QQPackageInfoPath: string | undefined;
+    QQVersionConfigPath: string | undefined;
+    isQuickUpdate: boolean | undefined;
+    QQVersionConfig: QQVersionConfigType | undefined;
+    QQPackageInfo: QQPackageInfoType | undefined;
+    QQVersionAppid: string | undefined;
+    QQVersionQua: string | undefined;
+    context: { logger: LogWrapper };
+
+    constructor(context: { logger: LogWrapper }) {
+        //基础目录获取
+        this.context = context;
+        this.QQMainPath = process.execPath;
+        this.QQVersionConfigPath = getQQVersionConfigPath(this.QQMainPath);
+
+
+        //基础信息获取 无快更则启用默认模板填充
+        this.isQuickUpdate = !!this.QQVersionConfigPath;
+        this.QQVersionConfig = this.isQuickUpdate
+            ? JSON.parse(fs.readFileSync(this.QQVersionConfigPath!).toString())
+            : getDefaultQQVersionConfigInfo();
+
+        this.QQPackageInfoPath = getQQPackageInfoPath(this.QQMainPath, this.QQVersionConfig?.curVersion);
+        this.QQPackageInfo = JSON.parse(fs.readFileSync(this.QQPackageInfoPath).toString());
+        const { appid: IQQVersionAppid, qua: IQQVersionQua } = this.getAppidV2();
+        this.QQVersionAppid = IQQVersionAppid;
+        this.QQVersionQua = IQQVersionQua;
+    }
+
+    //基础函数
+    getQQBuildStr() {
+        return this.isQuickUpdate ? this.QQVersionConfig?.buildId : this.QQPackageInfo?.buildVersion;
+    }
+
+    getFullQQVesion() {
+        const version = this.isQuickUpdate ? this.QQVersionConfig?.curVersion : this.QQPackageInfo?.version;
+        if (!version) throw new Error('QQ版本获取失败');
+        return version;
+    }
+
+    requireMinNTQQBuild(buildStr: string) {
+        const currentBuild = +(this.getQQBuildStr() ?? '0');
+        if (currentBuild == 0) throw new Error('QQBuildStr获取失败');
+        return currentBuild >= parseInt(buildStr);
+    }
+
+    //此方法不要直接使用
+    getQUAFallback() {
+        const platformMapping: Partial<Record<NodeJS.Platform, string>> = {
+            win32: `V1_WIN_${this.getFullQQVesion()}_${this.getQQBuildStr()}_GW_B`,
+            darwin: `V1_MAC_${this.getFullQQVesion()}_${this.getQQBuildStr()}_GW_B`,
+            linux: `V1_LNX_${this.getFullQQVesion()}_${this.getQQBuildStr()}_GW_B`,
+        };
+        return platformMapping[systemPlatform] ?? (platformMapping.win32)!;
+    }
+
+    getAppIdFallback() {
+        const platformMapping: Partial<Record<NodeJS.Platform, string>> = {
+            win32: '537246092',
+            darwin: '537246140',
+            linux: '537246140',
+        };
+        return platformMapping[systemPlatform] ?? '537246092';
+    }
+
+    getAppidV2(): { appid: string; qua: string } {
+        const appidTbale = AppidTable as unknown as QQAppidTableType;
+        const fullVersion = this.getFullQQVesion();
+        if (fullVersion) {
+            const data = appidTbale[fullVersion];
+            if (data) {
+                return data;
+            }
+        }
+
+        // else
+        this.context.logger.log(`[QQ版本兼容性检测] 获取Appid异常 请检测NapCat/QQNT是否正常`);
+        this.context.logger.log(`[QQ版本兼容性检测] ${fullVersion} 版本兼容性不佳，可能会导致一些功能无法正常使用`,);
+        return { appid: this.getAppIdFallback(), qua: this.getQUAFallback() };
+    }
+}

src/common/request.ts

@@ -0,0 +1,194 @@
+import https from 'node:https';
+import http from 'node:http';
+import { readFileSync } from 'node:fs';
+
+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) => {
+            const req = 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
+                                cookies = { ...cookies, ...redirectCookies };
+                                resolve(cookies);
+                            }).catch((err) => {
+                                reject(err);
+                            });
+                        } 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']);
+                    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;
+                        }
+                    });
+                }
+            });
+            req.on('error', (error: any) => {
+                reject(error);
+            });
+        });
+    }
+
+
+    // 请求和回复都是JSON data传原始内容 自动编码json
+    static async HttpGetJson<T>(url: string, method: string = 'GET', data?: any, headers: {
+        [key: string]: string
+    } = {}, isJsonRet: boolean = true, isArgJson: boolean = true): Promise<T> {
+        const option = new URL(url);
+        const protocol = url.startsWith('https://') ? https : http;
+        const options = {
+            hostname: option.hostname,
+            port: option.port,
+            path: option.pathname + option.search,
+            method: method,
+            headers: headers,
+        };
+        // headers: {
+        //       'Content-Type': 'application/json',
+        //       'Content-Length': Buffer.byteLength(postData),
+        //     },
+        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: { [key: string]: string } = {}) {
+        return this.HttpGetJson<string>(url, method, data, headers, false, false);
+    }
+
+    static async createFormData(boundary: string, filePath: string): Promise<Buffer> {
+        let type = 'image/png';
+        if (filePath.endsWith('.jpg')) {
+            type = 'image/jpeg';
+        }
+        const formDataParts = [
+            `------${boundary}\r\n`,
+            `Content-Disposition: form-data; name="share_image"; filename="${filePath}"\r\n`,
+            'Content-Type: ' + type + '\r\n\r\n',
+        ];
+
+        const fileContent = readFileSync(filePath);
+        const footer = `\r\n------${boundary}--`;
+        return Buffer.concat([
+            Buffer.from(formDataParts.join(''), 'utf8'),
+            fileContent,
+            Buffer.from(footer, 'utf8'),
+        ]);
+    }
+
+    static async uploadImageForOpenPlatform(filePath: string, cookies: string): Promise<string> {
+        return new Promise(async (resolve, reject) => {
+            type retType = { retcode: number, result?: { url: string } };
+            try {
+                const options = {
+                    hostname: 'cgi.connect.qq.com',
+                    port: 443,
+                    path: '/qqconnectopen/upload_share_image',
+                    method: 'POST',
+                    headers: {
+                        'Referer': 'https://cgi.connect.qq.com',
+                        'Cookie': cookies,
+                        'Accept': '*/*',
+                        'Connection': 'keep-alive',
+                        'Content-Type': 'multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW',
+                    },
+                };
+                const req = https.request(options, async (res) => {
+                    let responseBody = '';
+
+                    res.on('data', (chunk: string | Buffer) => {
+                        responseBody += chunk.toString();
+                    });
+
+                    res.on('end', () => {
+                        try {
+                            if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                                const responseJson = JSON.parse(responseBody) as retType;
+                                resolve(responseJson.result!.url!);
+                            } else {
+                                reject(new Error(`Unexpected status code: ${res.statusCode}`));
+                            }
+                        } catch (parseError) {
+                            reject(parseError);
+                        }
+
+                    });
+
+                });
+
+                req.on('error', (error) => {
+                    reject(error);
+                    console.log('Error during upload:', error);
+                });
+
+                const body = await RequestUtil.createFormData('WebKitFormBoundary7MA4YWxkTrZu0gW', filePath);
+                // req.setHeader('Content-Length', Buffer.byteLength(body));
+                // console.log(`Prepared data size: ${Buffer.byteLength(body)} bytes`);
+                req.write(body);
+                req.end();
+                return;
+            } catch (error) {
+                reject(error);
+            }
+            return undefined;
+        });
+    }
+}

src/common/system.ts

@@ -0,0 +1,21 @@
+import os from 'node:os';
+import path from 'node:path';
+
+// 缓解Win7设备兼容性问题
+let osName: string;
+
+try {
+    osName = os.hostname();
+} catch (e) {
+    osName = 'NapCat'; // + crypto.randomUUID().substring(0, 4);
+}
+
+
+const homeDir = os.homedir();
+
+export const systemPlatform = os.platform();
+export const cpuArch = os.arch();
+export const systemVersion = os.release();
+export const hostname = osName;
+export const downloadsPath = path.join(homeDir, 'Downloads');
+export const systemName = os.type();

src/common/types.ts

@@ -0,0 +1,17 @@
+//QQVersionType
+type QQPackageInfoType = {
+    version: string;
+    buildVersion: string;
+    platform: string;
+    eleArch: string;
+}
+type QQVersionConfigType = {
+    baseVersion: string;
+    curVersion: string;
+    prevVersion: string;
+    onErrorVersions: Array<any>;
+    buildId: string;
+}
+type QQAppidTableType = {
+    [key: string]: { appid: string, qua: string };
+}

src/common/version.ts

@@ -0,0 +1 @@
+export const napCatVersion = '3.0.1';

src/core/adapters/NodeIDependsAdapter.ts

@@ -0,0 +1,13 @@
+import { MsfChangeReasonType, MsfStatusType } from "../entities/adapter";
+
+export class NodeIDependsAdapter {
+    onMSFStatusChange(statusType: MsfStatusType, changeReasonType: MsfChangeReasonType) {
+
+    }
+
+    onMSFSsoError(args: unknown) {
+    }
+
+    getGroupCode(args: unknown) {
+    }
+}

src/core/adapters/NodeIDispatcherAdapter.ts

@@ -0,0 +1,10 @@
+export class NodeIDispatcherAdapter {
+    dispatchRequest(arg: unknown) {
+    }
+
+    dispatchCall(arg: unknown) {
+    }
+
+    dispatchCallWithJson(arg: unknown) {
+    }
+}

src/core/adapters/NodeIGlobalAdapter.ts

@@ -0,0 +1,25 @@
+export class NodeIGlobalAdapter {
+    onLog(...args: unknown[]) {
+    }
+
+    onGetSrvCalTime(...args: unknown[]) {
+    }
+
+    onShowErrUITips(...args: unknown[]) {
+    }
+
+    fixPicImgType(...args: unknown[]) {
+    }
+
+    getAppSetting(...args: unknown[]) {
+    }
+
+    onInstallFinished(...args: unknown[]) {
+    }
+
+    onUpdateGeneralFlag(...args: unknown[]) {
+    }
+
+    onGetOfflineMsg(...args: unknown[]) {
+    }
+}

src/core/adapters/index.ts

@@ -0,0 +1,3 @@
+export * from './NodeIDependsAdapter';
+export * from './NodeIDispatcherAdapter';
+export * from './NodeIGlobalAdapter';

src/core/apis/collection.ts

@@ -0,0 +1,60 @@
+import { InstanceContext, NapCatCore } from '..';
+
+export class NTQQCollectionApi {
+    context: InstanceContext;
+    core: NapCatCore;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+    }
+
+    async createCollection(authorUin: string, authorUid: string, authorName: string, brief: string, rawData: string) {
+        return this.context.session.getCollectionService().createNewCollectionItem({
+            commInfo: {
+                bid: 1,
+                category: 2,
+                author: {
+                    type: 1,
+                    numId: authorUin,
+                    strId: authorName,
+                    groupId: '0',
+                    groupName: '',
+                    uid: authorUid,
+                },
+                customGroupId: '0',
+                createTime: Date.now().toString(),
+                sequence: Date.now().toString(),
+            },
+            richMediaSummary: {
+                originalUri: '',
+                publisher: '',
+                richMediaVersion: 0,
+                subTitle: '',
+                title: '',
+                brief: brief,
+                picList: [],
+                contentType: 1,
+            },
+            richMediaContent: {
+                rawData: rawData,
+                bizDataList: [],
+                picList: [],
+                fileList: [],
+            },
+            need_share_url: false,
+        });
+    }
+
+    async getAllCollection(category: number = 0, count: number = 50) {
+        return this.context.session.getCollectionService().getCollectionItemList({
+            category: category,
+            groupId: -1,
+            forceSync: true,
+            forceFromDb: false,
+            timeStamp: '0',
+            count: count,
+            searchDown: true,
+        });
+    }
+}

src/core/apis/file.ts

@@ -0,0 +1,424 @@
+import {
+    ChatType,
+    ElementType,
+    IMAGE_HTTP_HOST,
+    IMAGE_HTTP_HOST_NT,
+    Peer,
+    PicElement,
+    PicType,
+    SendFileElement,
+    SendPicElement,
+    SendPttElement,
+    SendVideoElement,
+} from '@/core/entities';
+import path from 'path';
+import fs from 'fs';
+import fsPromises from 'fs/promises';
+import { InstanceContext, NapCatCore, SearchResultItem } from '@/core';
+import * as fileType from 'file-type';
+import imageSize from 'image-size';
+import { ISizeCalculationResult } from 'image-size/dist/types/interface';
+import { RkeyManager } from '../helper/rkey';
+import { calculateFileMD5, isGIF } from '@/common/file';
+import pathLib from 'node:path';
+import { defaultVideoThumbB64, getVideoInfo } from '@/common/video';
+import ffmpeg from 'fluent-ffmpeg';
+import { encodeSilk } from '@/common/audio';
+import { MessageContext } from '@/onebot/api';
+
+export class NTQQFileApi {
+    context: InstanceContext;
+    core: NapCatCore;
+    rkeyManager: RkeyManager;
+    packetRkey: Array<{ rkey: string; time: number; type: number; }> | undefined;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+        this.rkeyManager = new RkeyManager(['https://llob.linyuchen.net/rkey', 'http://napcat-sign.wumiao.wang:2082/rkey'], this.context.logger);
+    }
+
+    async copyFile(filePath: string, destPath: string) {
+        await this.core.util.copyFile(filePath, destPath);
+    }
+
+    async getFileSize(filePath: string): Promise<number> {
+        return await this.core.util.getFileSize(filePath);
+    }
+
+    async getVideoUrl(peer: Peer, msgId: string, elementId: string) {
+        return (await this.context.session.getRichMediaService().getVideoPlayUrlV2(peer, msgId, elementId, 0, {
+            downSourceType: 1,
+            triggerType: 1,
+        })).urlResult.domainUrl;
+    }
+
+    async uploadFile(filePath: string, elementType: ElementType = ElementType.PIC, elementSubType: number = 0) {
+        const fileMd5 = await calculateFileMD5(filePath);
+        const extOrEmpty = (await fileType.fileTypeFromFile(filePath))?.ext;
+        const ext = extOrEmpty ? `.${extOrEmpty}` : '';
+        let fileName = `${path.basename(filePath)}`;
+        if (fileName.indexOf('.') === -1) {
+            fileName += ext;
+        }
+
+        const mediaPath = this.context.session.getMsgService().getRichMediaFilePathForGuild({
+            md5HexStr: fileMd5,
+            fileName: fileName,
+            elementType: elementType,
+            elementSubType,
+            thumbSize: 0,
+            needCreate: true,
+            downloadType: 1,
+            file_uuid: '',
+        });
+
+        await this.copyFile(filePath, mediaPath);
+        const fileSize = await this.getFileSize(filePath);
+        return {
+            md5: fileMd5,
+            fileName,
+            path: mediaPath,
+            fileSize,
+            ext,
+        };
+    }
+
+    async createValidSendFileElement(context: MessageContext, filePath: string, fileName: string = '', folderId: string = '',): Promise<SendFileElement> {
+        const {
+            fileName: _fileName,
+            path,
+            fileSize,
+        } = await this.core.apis.FileApi.uploadFile(filePath, ElementType.FILE);
+        if (fileSize === 0) {
+            throw new Error('文件异常，大小为0');
+        }
+        context.deleteAfterSentFiles.push(path);
+        return {
+            elementType: ElementType.FILE,
+            elementId: '',
+            fileElement: {
+                fileName: fileName || _fileName,
+                folderId: folderId,
+                filePath: path,
+                fileSize: (fileSize).toString(),
+            },
+        };
+    }
+
+    async createValidSendPicElement(context: MessageContext, picPath: string, summary: string = '', subType: 0 | 1 = 0,): Promise<SendPicElement> {
+        const { md5, fileName, path, fileSize } = await this.core.apis.FileApi.uploadFile(picPath, ElementType.PIC, subType);
+        if (fileSize === 0) {
+            throw new Error('文件异常，大小为0');
+        }
+        const imageSize = await this.core.apis.FileApi.getImageSize(picPath);
+        context.deleteAfterSentFiles.push(path);
+        return {
+            elementType: ElementType.PIC,
+            elementId: '',
+            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,
+            } as PicElement,
+        };
+    }
+
+    async createValidSendVideoElement(context: MessageContext, filePath: string, fileName: string = '', diyThumbPath: string = ''): Promise<SendVideoElement> {
+        const logger = this.core.context.logger;
+        let videoInfo = {
+            width: 1920, height: 1080,
+            time: 15,
+            format: 'mp4',
+            size: 0,
+            filePath,
+        };
+        try {
+            videoInfo = await getVideoInfo(filePath, logger);
+        } catch (e) {
+            logger.logError.bind(logger)('获取视频信息失败，将使用默认值', e);
+        }
+
+        let fileExt = 'mp4';
+        try {
+            const tempExt = (await fileType.fileTypeFromFile(filePath))?.ext;
+            if (tempExt) fileExt = tempExt;
+        } catch (e) {
+            this.context.logger.logError.bind(logger)('获取文件类型失败', e);
+        }
+        const newFilePath = filePath + '.' + fileExt;
+        fs.copyFileSync(filePath, newFilePath);
+        context.deleteAfterSentFiles.push(newFilePath);
+        filePath = newFilePath;
+        const { fileName: _fileName, path, fileSize, md5 } = await this.core.apis.FileApi.uploadFile(filePath, ElementType.VIDEO);
+        if (fileSize === 0) {
+            throw new Error('文件异常，大小为0');
+        }
+        videoInfo.size = fileSize;
+        let thumb = path.replace(`${pathLib.sep}Ori${pathLib.sep}`, `${pathLib.sep}Thumb${pathLib.sep}`);
+        thumb = pathLib.dirname(thumb);
+
+        const thumbPath = new Map();
+        const _thumbPath = await new Promise<string | undefined>((resolve, reject) => {
+            const thumbFileName = `${md5}_0.png`;
+            const thumbPath = pathLib.join(thumb, thumbFileName);
+            ffmpeg(filePath)
+                .on('error', (err) => {
+                    logger.logDebug('获取视频封面失败，使用默认封面', err);
+                    if (diyThumbPath) {
+                        fsPromises.copyFile(diyThumbPath, thumbPath).then(() => {
+                            resolve(thumbPath);
+                        }).catch(reject);
+                    } else {
+                        fs.writeFileSync(thumbPath, Buffer.from(defaultVideoThumbB64, 'base64'));
+                        resolve(thumbPath);
+                    }
+                })
+                .screenshots({
+                    timestamps: [0],
+                    filename: thumbFileName,
+                    folder: thumb,
+                    size: videoInfo.width + 'x' + videoInfo.height,
+                })
+                .on('end', () => {
+                    resolve(thumbPath);
+                });
+        });
+        const thumbSize = _thumbPath ? (await fsPromises.stat(_thumbPath)).size : 0;
+        thumbPath.set(0, _thumbPath);
+        const thumbMd5 = _thumbPath ? await calculateFileMD5(_thumbPath) : '';
+        context.deleteAfterSentFiles.push(path);
+        const uploadName = (fileName || _fileName).toLocaleLowerCase().endsWith('.' + fileExt.toLocaleLowerCase()) ? (fileName || _fileName) : (fileName || _fileName) + '.' + fileExt;
+        return {
+            elementType: ElementType.VIDEO,
+            elementId: '',
+            videoElement: {
+                fileName: uploadName,
+                filePath: path,
+                videoMd5: md5,
+                thumbMd5,
+                fileTime: videoInfo.time,
+                thumbPath: thumbPath,
+                thumbSize,
+                thumbWidth: videoInfo.width,
+                thumbHeight: videoInfo.height,
+                fileSize: '' + fileSize,
+            },
+        };
+    }
+
+    async createValidSendPttElement(pttPath: string): Promise<SendPttElement> {
+        const { converted, path: silkPath, duration } = await encodeSilk(pttPath, this.core.NapCatTempPath, this.core.context.logger);
+        if (!silkPath) {
+            throw new Error('语音转换失败, 请检查语音文件是否正常');
+        }
+        const { md5, fileName, path, fileSize } = await this.core.apis.FileApi.uploadFile(silkPath, ElementType.PTT);
+        if (fileSize === 0) {
+            throw new Error('文件异常，大小为0');
+        }
+        if (converted) {
+            fsPromises.unlink(silkPath).then().catch(
+                (e) => this.context.logger.logError.bind(this.context.logger)('删除临时文件失败', e)
+            );
+        }
+        return {
+            elementType: ElementType.PTT,
+            elementId: '',
+            pttElement: {
+                fileName: fileName,
+                filePath: path,
+                md5HexStr: md5,
+                fileSize: fileSize,
+                duration: duration ?? 1,
+                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,
+            },
+        };
+    }
+
+    async downloadFileForModelId(peer: Peer, modelId: string, unknown: string, timeout = 1000 * 60 * 2) {
+        const [, fileTransNotifyInfo] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelRichMediaService/downloadFileForModelId',
+            'NodeIKernelMsgListener/onRichMediaDownloadComplete',
+            [peer, [modelId], unknown],
+            () => true,
+            (arg) => arg?.commonFileInfo?.fileModelId === modelId,
+            1,
+            timeout,
+        );
+        return fileTransNotifyInfo.filePath;
+    }
+
+    async downloadMedia(msgId: string, chatType: ChatType, peerUid: string, elementId: string, thumbPath: string, sourcePath: string, timeout = 1000 * 60 * 2, force: boolean = false) {
+        // 用于下载收到的消息中的图片等
+        if (sourcePath && fs.existsSync(sourcePath)) {
+            if (force) {
+                try {
+                    await fsPromises.unlink(sourcePath);
+                } catch (e) {
+                    //
+                }
+            } else {
+                return sourcePath;
+            }
+        }
+        const [, completeRetData] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelMsgService/downloadRichMedia',
+            'NodeIKernelMsgListener/onRichMediaDownloadComplete',
+            [{
+                fileModelId: '0',
+                downloadSourceType: 0,
+                triggerType: 1,
+                msgId: msgId,
+                chatType: chatType,
+                peerUid: peerUid,
+                elementId: elementId,
+                thumbSize: 0,
+                downloadType: 1,
+                filePath: thumbPath,
+            }],
+            () => true,
+            (arg) => arg.msgId === msgId,
+            1,
+            timeout,
+        );
+        return completeRetData.filePath;
+    }
+
+    async getImageSize(filePath: string): Promise<ISizeCalculationResult> {
+        return new Promise((resolve, reject) => {
+            imageSize(filePath, (err, dimensions) => {
+                if (err) {
+                    reject(err);
+                } else {
+                    if (!dimensions) {
+                        reject(new Error('获取图片尺寸失败'));
+                    } else {
+                        resolve(dimensions);
+                    }
+                }
+            });
+        });
+    }
+
+    async searchForFile(keys: string[]): Promise<SearchResultItem | undefined> {
+        const randomResultId = 100000 + Math.floor(Math.random() * 10000);
+        let searchId = 0;
+        const [, searchResult] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelFileAssistantService/searchFile',
+            'NodeIKernelFileAssistantListener/onFileSearch',
+            [
+                keys,
+                { resultType: 2, pageLimit: 1 },
+                randomResultId,
+            ],
+            (ret) => {
+                searchId = ret;
+                return true;
+            },
+            result => result.searchId === searchId && result.resultId === randomResultId,
+        );
+        return searchResult.resultItems[0];
+    }
+
+    async downloadFileById(
+        fileId: string,
+        fileSize: number = 1024576,
+        estimatedTime: number = (fileSize * 1000 / 1024576) + 5000,
+    ) {
+        const [, fileData] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelFileAssistantService/downloadFile',
+            'NodeIKernelFileAssistantListener/onFileStatusChanged',
+            [[fileId]],
+            ret => ret.result === 0,
+            status => status.fileStatus === 2 && status.fileProgress === '0',
+            1,
+            estimatedTime, // estimate 1MB/s
+        );
+        return fileData.filePath!;
+    }
+
+    async getImageUrl(element: PicElement) {
+        if (!element) {
+            return '';
+        }
+        const url: string = element.originImageUrl ?? '';
+        const md5HexStr = element.md5HexStr;
+        const fileMd5 = element.md5HexStr;
+
+        if (url) {
+            const parsedUrl = new URL(IMAGE_HTTP_HOST + url);
+            const urlRkey = parsedUrl.searchParams.get('rkey');
+            const imageAppid = parsedUrl.searchParams.get('appid');
+            const isNTV2 = imageAppid && ['1406', '1407'].includes(imageAppid);
+            const imageFileId = parsedUrl.searchParams.get('fileid');
+
+            const rkeyData = {
+                private_rkey: 'CAQSKAB6JWENi5LM_xp9vumLbuThJSaYf-yzMrbZsuq7Uz2qEc3Rbib9LP4',
+                group_rkey: 'CAQSKAB6JWENi5LM_xp9vumLbuThJSaYf-yzMrbZsuq7Uz2qffcqm614gds',
+                online_rkey: false
+            };
+            try {
+                if (this.core.apis.PacketApi.available) {
+                    if ((!this.packetRkey || this.packetRkey[0].time > Date.now() / 1000)) {
+                        this.packetRkey = await this.core.apis.PacketApi.sendRkeyPacket();
+                    }
+                    if (this.packetRkey.length > 0) {
+                        rkeyData.group_rkey = this.packetRkey[1].rkey.slice(6);
+                        rkeyData.private_rkey = this.packetRkey[0].rkey.slice(6);
+                        rkeyData.online_rkey = true;
+                    }
+                }
+            } catch (error: any) {
+                this.context.logger.logError.bind(this.context.logger)('获取rkey失败', error.message);
+            }
+
+            if (!rkeyData.online_rkey) {
+                try {
+                    const tempRkeyData = await this.rkeyManager.getRkey();
+                    rkeyData.group_rkey = tempRkeyData.group_rkey;
+                    rkeyData.private_rkey = tempRkeyData.private_rkey;
+                    rkeyData.online_rkey = tempRkeyData.expired_time > Date.now() / 1000;
+                } catch (e) {
+                    this.context.logger.logError.bind(this.context.logger)('获取rkey失败 Fallback Old Mode', e);
+                }
+            }
+            if (isNTV2 && urlRkey) {
+                return IMAGE_HTTP_HOST_NT + urlRkey;
+            } else if (isNTV2 && rkeyData.online_rkey) {
+                const rkey = imageAppid === '1406' ? rkeyData.private_rkey : rkeyData.group_rkey;
+                return IMAGE_HTTP_HOST_NT + url + `&rkey=${rkey}`;
+            } else if (isNTV2 && imageFileId) {
+                const rkey = imageAppid === '1406' ? rkeyData.private_rkey : rkeyData.group_rkey;
+                return IMAGE_HTTP_HOST + `/download?appid=${imageAppid}&fileid=${imageFileId}&rkey=${rkey}`;
+            }
+
+        }
+        //到这里说明可能是旧客户端
+        if (fileMd5 || md5HexStr) {
+            return `${IMAGE_HTTP_HOST}/gchatpic_new/0/0-0-${(fileMd5 ?? md5HexStr)!.toUpperCase()}/0`;
+        }
+
+        this.context.logger.logDebug('图片url获取失败', element);
+        return '';
+    }
+}
+

src/core/apis/friend.ts

@@ -0,0 +1,93 @@
+import { FriendV2 } from '@/core/entities';
+import { BuddyListReqType, InstanceContext, NapCatCore } from '@/core';
+import { LimitedHashTable } from '@/common/message-unique';
+
+export class NTQQFriendApi {
+    context: InstanceContext;
+    core: NapCatCore;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+    }
+    async setBuddyRemark(uid: string, remark: string) {
+        return this.context.session.getBuddyService().setBuddyRemark(uid, remark);
+    }
+    async getBuddyV2SimpleInfoMap(refresh = false) {
+        const buddyService = this.context.session.getBuddyService();
+        const buddyListV2 = refresh ? await buddyService.getBuddyListV2('0', BuddyListReqType.KNOMAL) : await buddyService.getBuddyListV2('0', BuddyListReqType.KNOMAL);
+        const uids = buddyListV2.data.flatMap(item => item.buddyUids);
+        return await this.core.eventWrapper.callNoListenerEvent(
+            'NodeIKernelProfileService/getCoreAndBaseInfo',
+            'nodeStore',
+            uids,
+        );
+    }
+
+    async getBuddyV2(refresh = false): Promise<FriendV2[]> {
+        return Array.from((await this.getBuddyV2SimpleInfoMap(refresh)).values());
+    }
+
+    async getBuddyIdMap(refresh = false): Promise<LimitedHashTable<string, string>> {
+        const retMap: LimitedHashTable<string, string> = new LimitedHashTable<string, string>(5000);
+        const data = await this.getBuddyV2SimpleInfoMap(refresh);
+        data.forEach((value) => retMap.set(value.uin!, value.uid!));
+        return retMap;
+    }
+
+    async getBuddyV2ExWithCate(refresh = false) {
+        const categoryMap: Map<string, any> = new Map();
+        const buddyService = this.context.session.getBuddyService();
+        const buddyListV2 = refresh ? (await buddyService.getBuddyListV2('0', BuddyListReqType.KNOMAL)).data : (await buddyService.getBuddyListV2('0', BuddyListReqType.KNOMAL)).data;
+        const uids = buddyListV2.flatMap(item => {
+            item.buddyUids.forEach(uid => {
+                categoryMap.set(uid, { categoryId: item.categoryId, categoryName: item.categroyName });
+            });
+            return item.buddyUids;
+        });
+        const data = await this.core.eventWrapper.callNoListenerEvent(
+            'NodeIKernelProfileService/getCoreAndBaseInfo',
+            'nodeStore',
+            uids,
+        );
+        return buddyListV2.map(category => ({
+            categoryId: category.categoryId,
+            categorySortId: category.categorySortId,
+            categoryName: category.categroyName,
+            categoryMbCount: category.categroyMbCount,
+            onlineCount: category.onlineCount,
+            buddyList: category.buddyUids.map(uid => data.get(uid)!).filter(value => value),
+        }));
+    }
+
+    async isBuddy(uid: string) {
+        return this.context.session.getBuddyService().isBuddy(uid);
+    }
+
+    async clearBuddyReqUnreadCnt() {
+        return this.context.session.getBuddyService().clearBuddyReqUnreadCnt();
+    }
+
+    async getBuddyReq() {
+        const [, ret] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelBuddyService/getBuddyReq',
+            'NodeIKernelBuddyListener/onBuddyReqChange',
+            [],
+        );
+        return ret;
+    }
+
+    async handleFriendRequest(flag: string, accept: boolean) {
+        const data = flag.split('|');
+        if (data.length < 2) {
+            return;
+        }
+        const friendUid = data[0];
+        const reqTime = data[1];
+        this.context.session.getBuddyService()?.approvalFriendRequest({
+            friendUid: friendUid,
+            reqTime: reqTime,
+            accept,
+        });
+    }
+}

src/core/apis/group.ts

@@ -0,0 +1,466 @@
+import {
+    GeneralCallResult,
+    Group,
+    GroupMember,
+    GroupMemberRole,
+    GroupRequestOperateTypes,
+    InstanceContext,
+    KickMemberV2Req,
+    MemberExtSourceType,
+    NapCatCore,
+} from '@/core';
+import { isNumeric, solveAsyncProblem } from '@/common/helper';
+import { LimitedHashTable } from '@/common/message-unique';
+import { NTEventWrapper } from '@/common/event';
+
+export class NTQQGroupApi {
+    context: InstanceContext;
+    core: NapCatCore;
+    groupCache: Map<string, Group> = new Map<string, Group>();
+    groupMemberCache: Map<string, Map<string, GroupMember>> = new Map<string, Map<string, GroupMember>>();
+    groups: Group[] = [];
+    essenceLRU = new LimitedHashTable<number, string>(1000);
+    session: any;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+        this.initCache().then().catch(context.logger.logError.bind(context.logger));
+    }
+
+    async initCache() {
+        this.groups = await this.getGroups();
+        for (const group of this.groups) {
+            this.groupCache.set(group.groupCode, group);
+        }
+        this.context.logger.logDebug(`加载${this.groups.length}个群组缓存完成`);
+        // process.pid 调试点
+    }
+
+    async getCoreAndBaseInfo(uids: string[]) {
+        return await this.core.eventWrapper.callNoListenerEvent(
+            'NodeIKernelProfileService/getCoreAndBaseInfo',
+            'nodeStore',
+            uids,
+        );
+    }
+
+    async fetchGroupEssenceList(groupCode: string) {
+        const pskey = (await this.core.apis.UserApi.getPSkey(['qun.qq.com'])).domainPskeyMap.get('qun.qq.com')!;
+        return this.context.session.getGroupService().fetchGroupEssenceList({
+            groupCode: groupCode,
+            pageStart: 0,
+            pageLimit: 300,
+        }, pskey);
+    }
+    async getGroupShutUpMemberList(groupCode: string) {
+        return this.context.session.getGroupService().getGroupShutUpMemberList(groupCode);
+    }
+    async clearGroupNotifiesUnreadCount(uk: boolean) {
+        return this.context.session.getGroupService().clearGroupNotifiesUnreadCount(uk);
+    }
+
+    async setGroupAvatar(gc: string, filePath: string) {
+        return this.context.session.getGroupService().setHeader(gc, filePath);
+    }
+
+    async getGroups(forced = false) {
+        const [, , groupList] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelGroupService/getGroupList',
+            'NodeIKernelGroupListener/onGroupListUpdate',
+            [forced],
+        );
+        return groupList;
+    }
+
+    async getGroupExtFE0Info(groupCode: string[], forced = true) {
+        return this.context.session.getGroupService().getGroupExt0xEF0Info(
+            groupCode,
+            [],
+            {
+                bindGuildId: 1,
+                blacklistExpireTime: 1,
+                companyId: 1,
+                essentialMsgPrivilege: 1,
+                essentialMsgSwitch: 1,
+                fullGroupExpansionSeq: 1,
+                fullGroupExpansionSwitch: 1,
+                gangUpId: 1,
+                groupAioBindGuildId: 1,
+                groupBindGuildIds: 1,
+                groupBindGuildSwitch: 1,
+                groupExcludeGuildIds: 1,
+                groupExtFlameData: 1,
+                groupFlagPro1: 1,
+                groupInfoExtSeq: 1,
+                groupOwnerId: 1,
+                groupSquareSwitch: 1,
+                hasGroupCustomPortrait: 1,
+                inviteRobotMemberExamine: 1,
+                inviteRobotMemberSwitch: 1,
+                inviteRobotSwitch: 1,
+                isLimitGroupRtc: 1,
+                lightCharNum: 1,
+                luckyWord: 1,
+                luckyWordId: 1,
+                msgEventSeq: 1,
+                qqMusicMedalSwitch: 1,
+                reserve: 1,
+                showPlayTogetherSwitch: 1,
+                starId: 1,
+                todoSeq: 1,
+                viewedMsgDisappearTime: 1,
+            },
+            forced,
+        );
+    }
+
+    async getGroup(groupCode: string, forced = false) {
+        let group = this.groupCache.get(groupCode.toString());
+        if (!group) {
+            try {
+                const groupList = await this.getGroups(forced);
+                if (groupList.length) {
+                    groupList.forEach(g => {
+                        this.groupCache.set(g.groupCode, g);
+                    });
+                }
+            } catch (e) {
+                return undefined;
+            }
+        }
+        group = this.groupCache.get(groupCode.toString());
+        return group;
+    }
+
+    async getGroupMemberAll(groupCode: string, forced = false) {
+        return this.context.session.getGroupService().getAllMemberList(groupCode, forced);
+    }
+
+    async getGroupMember(groupCode: string | number, memberUinOrUid: string | number) {
+        const groupCodeStr = groupCode.toString();
+        const memberUinOrUidStr = memberUinOrUid.toString();
+        let members = this.groupMemberCache.get(groupCodeStr);
+        if (!members) {
+            try {
+                members = await this.getGroupMembers(groupCodeStr);
+                // 更新群成员列表
+                this.groupMemberCache.set(groupCodeStr, members);
+            } catch (e) {
+                return null;
+            }
+        }
+
+        // log('getGroupMember', members);
+        function getMember() {
+            let member: GroupMember | 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);
+            member = getMember();
+        }
+        return member;
+    }
+
+    async getGroupRecommendContactArkJson(groupCode: string) {
+        return this.context.session.getGroupService().getGroupRecommendContactArkJson(groupCode);
+    }
+
+    async CreatGroupFileFolder(groupCode: string, folderName: string) {
+        return this.context.session.getRichMediaService().createGroupFolder(groupCode, folderName);
+    }
+
+    async DelGroupFile(groupCode: string, files: string[]) {
+        return this.context.session.getRichMediaService().deleteGroupFile(groupCode, [102], files);
+    }
+
+    async DelGroupFileFolder(groupCode: string, folderId: string) {
+        return this.context.session.getRichMediaService().deleteGroupFolder(groupCode, folderId);
+    }
+
+    async addGroupEssence(GroupCode: string, msgId: string) {
+        const MsgData = await this.context.session.getMsgService().getMsgsIncludeSelf({
+            chatType: 2,
+            guildId: '',
+            peerUid: GroupCode,
+        }, msgId, 1, false);
+        const param = {
+            groupCode: GroupCode,
+            msgRandom: parseInt(MsgData.msgList[0].msgRandom),
+            msgSeq: parseInt(MsgData.msgList[0].msgSeq),
+        };
+        return this.context.session.getGroupService().addGroupEssence(param);
+    }
+
+    async kickMemberV2Inner(param: KickMemberV2Req) {
+        return this.context.session.getGroupService().kickMemberV2(param);
+    }
+
+    async deleteGroupBulletin(GroupCode: string, noticeId: string) {
+        const psKey = (await this.core.apis.UserApi.getPSkey(['qun.qq.com'])).domainPskeyMap.get('qun.qq.com')!;
+        return this.context.session.getGroupService().deleteGroupBulletin(GroupCode, psKey, noticeId);
+    }
+
+    async quitGroupV2(GroupCode: string, needDeleteLocalMsg: boolean) {
+        const param = {
+            groupCode: GroupCode,
+            needDeleteLocalMsg: needDeleteLocalMsg,
+        };
+        return this.context.session.getGroupService().quitGroupV2(param);
+    }
+
+    async removeGroupEssenceBySeq(GroupCode: string, msgRandom: string, msgSeq: string) {
+        const param = {
+            groupCode: GroupCode,
+            msgRandom: parseInt(msgRandom),
+            msgSeq: parseInt(msgSeq),
+        };
+        return this.context.session.getGroupService().removeGroupEssence(param);
+    }
+
+    async removeGroupEssence(GroupCode: string, msgId: string) {
+        const MsgData = await this.context.session.getMsgService().getMsgsIncludeSelf({
+            chatType: 2,
+            guildId: '',
+            peerUid: GroupCode,
+        }, msgId, 1, false);
+        const param = {
+            groupCode: GroupCode,
+            msgRandom: parseInt(MsgData.msgList[0].msgRandom),
+            msgSeq: parseInt(MsgData.msgList[0].msgSeq),
+        };
+        return this.context.session.getGroupService().removeGroupEssence(param);
+    }
+
+    async getSingleScreenNotifies(doubt: boolean, num: number) {
+        const [, , , notifies] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelGroupService/getSingleScreenNotifies',
+            'NodeIKernelGroupListener/onGroupSingleScreenNotifies',
+            [
+                doubt,
+                '',
+                num,
+            ],
+        );
+        return notifies;
+    }
+
+    async getGroupMemberV2(GroupCode: string, uid: string, forced = false) {
+        const Listener = this.core.eventWrapper.registerListen(
+            'NodeIKernelGroupListener/onMemberInfoChange',
+            1,
+            forced ? 5000 : 250,
+            (params, _, members) => params === GroupCode && members.size > 0,
+        );
+        const retData = await (
+            this.core.eventWrapper
+                .createEventFunction('NodeIKernelGroupService/getMemberInfo')
+        )!(GroupCode, [uid], forced);
+        if (retData.result !== 0) {
+            throw new Error(`${retData.errMsg}`);
+        }
+        const result = await Listener as unknown;
+        let member: GroupMember | undefined;
+        if (Array.isArray(result) && result?.[2] instanceof Map) {
+            const members = result[2] as Map<string, GroupMember>;
+            member = members.get(uid);
+        }
+        return member;
+    }
+
+    async searchGroup(groupCode: string) {
+        const [, ret] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelSearchService/searchGroup',
+            'NodeIKernelSearchListener/onSearchGroupResult',
+            [{
+                keyWords: groupCode,
+                groupNum: 25,
+                exactSearch: false,
+                penetrate: ''
+            }],
+            (ret) => ret.result === 0,
+            (params) => !!params.groupInfos.find(g => g.groupCode === groupCode),
+            1,
+            5000
+        );
+        return ret.groupInfos.find(g => g.groupCode === groupCode);
+    }
+
+    async getGroupMemberEx(GroupCode: string, uid: string, forced = false, retry = 2) {
+        const data = await solveAsyncProblem((eventWrapper: NTEventWrapper, GroupCode: string, uid: string, forced = false) => {
+            return eventWrapper.callNormalEventV2(
+                'NodeIKernelGroupService/getMemberInfo',
+                'NodeIKernelGroupListener/onMemberInfoChange',
+                [GroupCode, [uid], forced],
+                (ret) => ret.result === 0,
+                (params, _, members) => params === GroupCode && members.size > 0 && members.has(uid),
+                1,
+                forced ? 2500 : 250
+            );
+        }, this.core.eventWrapper, GroupCode, uid, forced);
+        if (data && data[3] instanceof Map && data[3].has(uid)) {
+            return data[3].get(uid);
+        }
+        if (retry > 0) {
+            const trydata = await this.getGroupMemberEx(GroupCode, uid, true, retry - 1) as GroupMember | undefined;
+            if (trydata) return trydata;
+        }
+        return undefined;
+    }
+
+    async getGroupMembersV2(groupQQ: string, num = 3000): Promise<Map<string, GroupMember>> {
+        const sceneId = this.context.session.getGroupService().createMemberListScene(groupQQ, 'groupMemberList_MainWindow');
+        let once = this.core.eventWrapper.registerListen('NodeIKernelGroupListener/onMemberListChange', 1, 2000, (params) => params.sceneId === sceneId)
+            .catch();
+        const result = await this.context.session.getGroupService().getNextMemberList(sceneId!, undefined, num);
+        if (result.errCode !== 0) {
+            throw new Error('获取群成员列表出错,' + result.errMsg);
+        }
+        if (result.result.infos.size === 0) {
+            return (await once)[0].infos;
+        }
+        return result.result.infos;
+    }
+
+    async getGroupMembers(groupQQ: string, num = 3000): Promise<Map<string, GroupMember>> {
+        const groupService = this.context.session.getGroupService();
+        const sceneId = groupService.createMemberListScene(groupQQ, 'groupMemberList_MainWindow');
+        const result = await groupService.getNextMemberList(sceneId!, undefined, num);
+        if (result.errCode !== 0) {
+            throw new Error('获取群成员列表出错,' + result.errMsg);
+        }
+        this.context.logger.logDebug(`获取群(${groupQQ})成员列表结果:`, `members: ${result.result.infos.size}`);
+        return result.result.infos;
+    }
+
+    async getGroupFileCount(Gids: Array<string>) {
+        return this.context.session.getRichMediaService().batchGetGroupFileCount(Gids);
+    }
+
+    async getArkJsonGroupShare(GroupCode: string) {
+        const ret = await this.core.eventWrapper.callNoListenerEvent(
+            'NodeIKernelGroupService/getGroupRecommendContactArkJson',
+            GroupCode,
+        ) as GeneralCallResult & { arkJson: string };
+        return ret.arkJson;
+    }
+
+    //需要异常处理
+    async uploadGroupBulletinPic(GroupCode: string, imageurl: string) {
+        const _Pskey = (await this.core.apis.UserApi.getPSkey(['qun.qq.com'])).domainPskeyMap.get('qun.qq.com')!;
+        return this.context.session.getGroupService().uploadGroupBulletinPic(GroupCode, _Pskey, imageurl);
+    }
+
+    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]);
+
+        return this.context.session.getGroupService().operateSysNotify(
+            false,
+            {
+                operateType: operateType, // 2 拒绝
+                targetMsg: {
+                    seq: seq,  // 通知序列号
+                    type: type,
+                    groupCode: groupCode,
+                    postscript: reason ?? ' ', // 仅传空值可能导致处理失败，故默认给个空格
+                },
+            });
+    }
+
+    async quitGroup(groupQQ: string) {
+        return this.context.session.getGroupService().quitGroup(groupQQ);
+    }
+
+    async kickMember(groupQQ: string, kickUids: string[], refuseForever: boolean = false, kickReason: string = '') {
+        return this.context.session.getGroupService().kickMember(groupQQ, kickUids, refuseForever, kickReason);
+    }
+
+    async banMember(groupQQ: string, memList: Array<{ uid: string, timeStamp: number }>) {
+        // timeStamp为秒数, 0为解除禁言
+        return this.context.session.getGroupService().setMemberShutUp(groupQQ, memList);
+    }
+
+    async banGroup(groupQQ: string, shutUp: boolean) {
+        return this.context.session.getGroupService().setGroupShutUp(groupQQ, shutUp);
+    }
+
+    async setMemberCard(groupQQ: string, memberUid: string, cardName: string) {
+        return this.context.session.getGroupService().modifyMemberCardName(groupQQ, memberUid, cardName);
+    }
+
+    async setMemberRole(groupQQ: string, memberUid: string, role: GroupMemberRole) {
+        return this.context.session.getGroupService().modifyMemberRole(groupQQ, memberUid, role);
+    }
+
+    async setGroupName(groupQQ: string, groupName: string) {
+        return this.context.session.getGroupService().modifyGroupName(groupQQ, groupName, false);
+    }
+
+    async publishGroupBulletin(groupQQ: string, content: string, picInfo: {
+        id: string,
+        width: number,
+        height: number
+    } | undefined = undefined, pinned: number = 0, confirmRequired: number = 0) {
+        const psKey = (await this.core.apis.UserApi.getPSkey(['qun.qq.com'])).domainPskeyMap.get('qun.qq.com');
+        //text是content内容url编码
+        const data = {
+            text: encodeURI(content),
+            picInfo: picInfo,
+            oldFeedsId: '',
+            pinned: pinned,
+            confirmRequired: confirmRequired,
+        };
+        return this.context.session.getGroupService().publishGroupBulletin(groupQQ, psKey!, data);
+    }
+
+    async getGroupRemainAtTimes(GroupCode: string) {
+        this.context.session.getGroupService().getGroupRemainAtTimes(GroupCode);
+    }
+
+    async getMemberExtInfo(groupCode: string, uin: string) {
+        return this.context.session.getGroupService().getMemberExtInfo(
+            {
+                groupCode: groupCode,
+                sourceType: MemberExtSourceType.TITLETYPE,
+                beginUin: '0',
+                dataTime: '0',
+                uinList: [uin],
+                uinNum: '',
+                seq: '',
+                groupType: '',
+                richCardNameVer: '',
+                memberExtFilter: {
+                    memberLevelInfoUin: 1,
+                    memberLevelInfoPoint: 1,
+                    memberLevelInfoActiveDay: 1,
+                    memberLevelInfoLevel: 1,
+                    memberLevelInfoName: 1,
+                    levelName: 1,
+                    dataTime: 1,
+                    userShowFlag: 1,
+                    sysShowFlag: 1,
+                    timeToUpdate: 1,
+                    nickName: 1,
+                    specialTitle: 1,
+                    levelNameNew: 1,
+                    userShowFlagNew: 1,
+                    msgNeedField: 1,
+                    cmdUinFlagExt3Grocery: 1,
+                    memberIcon: 1,
+                    memberInfoSeq: 1,
+                },
+            },
+        );
+    }
+}

src/core/apis/index.ts

@@ -0,0 +1,8 @@
+export * from './file';
+export * from './friend';
+export * from './group';
+export * from './msg';
+export * from './user';
+export * from './webapi';
+export * from './sign';
+export * from './system';

src/core/apis/msg.ts

@@ -0,0 +1,258 @@
+import { ChatType, GetFileListParam, Peer, RawMessage, SendMessageElement, SendStatusType } from '@/core/entities';
+import { InstanceContext, NapCatCore } from '@/core';
+import { GeneralCallResult } from '@/core/services/common';
+
+export class NTQQMsgApi {
+    // 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
+
+    context: InstanceContext;
+    core: NapCatCore;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+    }
+
+    async getAioFirstViewLatestMsgs(peer: Peer, MsgCount: number) {
+        return this.context.session.getMsgService().getAioFirstViewLatestMsgs(peer, MsgCount);
+    }
+
+    async sendShowInputStatusReq(peer: Peer, eventType: number) {
+        return this.context.session.getMsgService().sendShowInputStatusReq(peer.chatType, eventType, peer.peerUid);
+    }
+
+    async getMsgEmojiLikesList(peer: Peer, msgSeq: string, emojiId: string, emojiType: string, count: number = 20) {
+        //注意此处emojiType 可选值一般为1-2 2好像是unicode表情dec值 大部分情况 Taged Mlikiowa
+        return this.context.session.getMsgService().getMsgEmojiLikesList(peer, msgSeq, emojiId, emojiType, '', false, count);
+    }
+
+    async setEmojiLike(peer: Peer, msgSeq: string, emojiId: string, set: boolean = true) {
+        emojiId = emojiId.toString();
+        return this.context.session.getMsgService().setMsgEmojiLikes(peer, msgSeq, emojiId, emojiId.length > 3 ? '2' : '1', set);
+    }
+
+    async getMultiMsg(peer: Peer, rootMsgId: string, parentMsgId: string): Promise<GeneralCallResult & {
+        msgList: RawMessage[]
+    } | undefined> {
+        return this.context.session.getMsgService().getMultiMsg(peer, rootMsgId, parentMsgId);
+    }
+
+    async ForwardMsg(peer: Peer, msgIds: string[]) {
+        return this.context.session.getMsgService().forwardMsg(msgIds, peer, [peer], new Map());
+    }
+
+    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');
+        //MliKiowa: 参数不合规会导致NC异常崩溃 原因是TX未对进入参数判断 对应Android标记@NotNull AndroidJADX分析可得
+        return await this.context.session.getMsgService().getMsgsByMsgId(peer, msgIds);
+    }
+
+    async getSingleMsg(peer: Peer, seq: string) {
+        return await this.context.session.getMsgService().getSingleMsg(peer, seq);
+    }
+
+    async fetchFavEmojiList(num: number) {
+        return this.context.session.getMsgService().fetchFavEmojiList('', num, true, true);
+    }
+
+    async queryMsgsWithFilterExWithSeq(peer: Peer, msgSeq: string) {
+        return await this.context.session.getMsgService().queryMsgsWithFilterEx('0', '0', msgSeq, {
+            chatInfo: peer,
+            filterMsgType: [],
+            filterSendersUid: [],
+            filterMsgToTime: '0',
+            filterMsgFromTime: '0',
+            isReverseOrder: false,
+            isIncludeCurrent: true,
+            pageLimit: 1,
+        });
+    }
+    async queryMsgsWithFilterExWithSeqV2(peer: Peer, msgSeq: string, MsgTime: string, SendersUid: string[]) {
+        return await this.context.session.getMsgService().queryMsgsWithFilterEx('0', '0', msgSeq, {
+            chatInfo: peer,
+            filterMsgType: [],
+            filterSendersUid: SendersUid,
+            filterMsgToTime: MsgTime,
+            filterMsgFromTime: MsgTime,
+            isReverseOrder: false,
+            isIncludeCurrent: true,
+            pageLimit: 1,
+        });
+    }
+    async queryFirstMsgBySeq(peer: Peer, msgSeq: string) {
+        return await this.context.session.getMsgService().queryMsgsWithFilterEx('0', '0', msgSeq, {
+            chatInfo: peer,
+            filterMsgType: [],
+            filterSendersUid: [],
+            filterMsgToTime: '0',
+            filterMsgFromTime: '0',
+            isReverseOrder: true,
+            isIncludeCurrent: true,
+            pageLimit: 1,
+        });
+    }
+    //@deprecated
+    async getMsgsBySeqAndCount(peer: Peer, seq: string, count: number, desc: boolean, z: boolean) {
+        return await this.context.session.getMsgService().getMsgsBySeqAndCount(peer, seq, count, desc, z);
+    }
+    async getMsgExBySeq(peer: Peer, msgSeq: string) {
+        const DateNow = Math.floor(Date.now() / 1000);
+        const filterMsgFromTime = (DateNow - 300).toString();
+        const filterMsgToTime = DateNow.toString();
+        return await this.context.session.getMsgService().queryMsgsWithFilterEx('0', '0', msgSeq, {
+            chatInfo: peer,//此处为Peer 为关键查询参数 没有啥也没有 by mlik iowa
+            filterMsgType: [],
+            filterSendersUid: [],
+            filterMsgToTime: filterMsgToTime,
+            filterMsgFromTime: filterMsgFromTime,
+            isReverseOrder: false,
+            isIncludeCurrent: true,
+            pageLimit: 100,
+        });
+    }
+
+    async setMsgRead(peer: Peer) {
+        return this.context.session.getMsgService().setMsgRead(peer);
+    }
+
+    async getGroupFileList(GroupCode: string, params: GetFileListParam) {
+        const [, groupFileListResult] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelRichMediaService/getGroupFileList',
+            'NodeIKernelMsgListener/onGroupFileInfoUpdate',
+            [
+                GroupCode,
+                params,
+            ],
+            () => true,
+            () => true, // Todo: 应当通过 groupFileListResult 判断
+            1,
+            5000,
+        );
+        return groupFileListResult.item;
+    }
+
+    async getMsgHistory(peer: Peer, msgId: string, count: number, isReverseOrder: boolean = false) {
+        // 消息时间从旧到新
+        return this.context.session.getMsgService().getMsgsIncludeSelf(peer, msgId, count, isReverseOrder);
+    }
+
+    async recallMsg(peer: Peer, msgId: string) {
+        await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelMsgService/recallMsg',
+            'NodeIKernelMsgListener/onMsgInfoListUpdate',
+            [peer, [msgId]],
+            () => true,
+            (updatedList) => updatedList.find(m => m.msgId === msgId && m.recallTime !== '0') !== undefined,
+            1,
+            1000,
+        );
+    }
+
+    async PrepareTempChat(toUserUid: string, GroupCode: string, nickname: string) {
+        return this.context.session.getMsgService().prepareTempChat({
+            chatType: ChatType.KCHATTYPETEMPC2CFROMGROUP,
+            peerUid: toUserUid,
+            peerNickname: nickname,
+            fromGroupCode: GroupCode,
+            sig: '',
+            selfPhone: '',
+            selfUid: this.core.selfInfo.uid,
+            gameSession: {
+                nickname: '',
+                gameAppId: '',
+                selfTinyId: '',
+                peerRoleId: '',
+                peerOpenId: '',
+            },
+        });
+    }
+
+    async getTempChatInfo(chatType: ChatType, peerUid: string) {
+        return this.context.session.getMsgService().getTempChatInfo(chatType, peerUid);
+    }
+
+    async sendMsg(peer: Peer, msgElements: SendMessageElement[], waitComplete = true, timeout = 10000) {
+        //唉？！我有个想法
+        if (peer.chatType === ChatType.KCHATTYPETEMPC2CFROMGROUP && peer.guildId && peer.guildId !== '') {
+            const member = await this.core.apis.GroupApi.getGroupMember(peer.guildId, peer.peerUid!);
+            if (member) {
+                await this.PrepareTempChat(peer.peerUid, peer.guildId, member.nick);
+            }
+        }
+        const msgId = await this.generateMsgUniqueId(peer.chatType);
+        peer.guildId = msgId;
+        const [, msgList] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelMsgService/sendMsg',
+            'NodeIKernelMsgListener/onMsgInfoListUpdate',
+            [
+                '0',
+                peer,
+                msgElements,
+                new Map(),
+            ],
+            (ret) => ret.result === 0,
+            msgRecords => {
+                for (const msgRecord of msgRecords) {
+                    if (msgRecord.guildId === msgId && msgRecord.sendStatus === SendStatusType.KSEND_STATUS_SUCCESS) {
+                        return true;
+                    }
+                }
+                return false;
+            },
+            1,
+            timeout,
+        );
+        return msgList.find(msgRecord => msgRecord.guildId === msgId);
+    }
+
+    async generateMsgUniqueId(chatType: number) {
+        return this.context.session.getMsgService().generateMsgUniqueId(chatType, this.context.session.getMSFService().getServerTime());
+    }
+
+    async forwardMsg(srcPeer: Peer, destPeer: Peer, msgIds: string[]) {
+        return this.context.session.getMsgService().forwardMsg(msgIds, srcPeer, [destPeer], new Map());
+    }
+
+    async multiForwardMsg(srcPeer: Peer, destPeer: Peer, msgIds: string[]): Promise<RawMessage> {
+        const msgInfos = msgIds.map(id => {
+            return { msgId: id, senderShowName: this.core.selfInfo.nick };
+        });
+        const [, msgList] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelMsgService/multiForwardMsgWithComment',
+            'NodeIKernelMsgListener/onMsgInfoListUpdate',
+            [
+                msgInfos,
+                srcPeer,
+                destPeer,
+                [],
+                new Map(),
+            ],
+            () => true,
+            (msgRecords) => msgRecords.some(
+                msgRecord => msgRecord.peerUid === destPeer.peerUid
+                    && msgRecord.senderUid === this.core.selfInfo.uid
+            ),
+        );
+        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 == this.core.selfInfo.uid) {
+                return msg;
+            }
+        }
+        throw new Error('转发消息超时');
+    }
+
+    async markAllMsgAsRead() {
+        return this.context.session.getMsgService().setAllC2CAndGroupMsgRead();
+    }
+}

src/core/apis/packet.ts

@@ -0,0 +1,143 @@
+import * as os from 'os';
+import {ChatType, InstanceContext, NapCatCore} from '..';
+import offset from '@/core/external/offset.json';
+import {PacketClient, RecvPacketData} from '@/core/packet/client';
+import {PacketSession} from "@/core/packet/session";
+import {PacketHexStr} from "@/core/packet/packer";
+import {NapProtoMsg} from '@/core/packet/proto/NapProto';
+import {OidbSvcTrpcTcp0X9067_202_Rsp_Body} from '@/core/packet/proto/oidb/Oidb.0x9067_202';
+import {OidbSvcTrpcTcpBase, OidbSvcTrpcTcpBaseRsp} from '@/core/packet/proto/oidb/OidbBase';
+import {OidbSvcTrpcTcp0XFE1_2RSP} from '@/core/packet/proto/oidb/Oidb.0XFE1_2';
+import {LogWrapper} from "@/common/log";
+import {SendLongMsgResp} from "@/core/packet/proto/message/action";
+import {PacketMsg} from "@/core/packet/msg/message";
+import {OidbSvcTrpcTcp0x6D6Response} from "@/core/packet/proto/oidb/Oidb.0x6D6";
+import {PacketMsgPicElement} from "@/core/packet/msg/element";
+
+interface OffsetType {
+    [key: string]: {
+        recv: string;
+        send: string;
+    };
+}
+
+const typedOffset: OffsetType = offset;
+
+export class NTQQPacketApi {
+    context: InstanceContext;
+    core: NapCatCore;
+    logger: LogWrapper
+    serverUrl: string | undefined;
+    qqVersion: string | undefined;
+    packetSession: PacketSession | undefined;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+        this.logger = core.context.logger;
+        this.packetSession = undefined;
+        const config = this.core.configLoader.configData;
+        if (config && config.packetServer && config.packetServer.length > 0) {
+            const serverUrl = this.core.configLoader.configData.packetServer ?? '127.0.0.1:8086';
+            this.InitSendPacket(serverUrl, this.context.basicInfoWrapper.getFullQQVesion())
+                .then()
+                .catch(this.core.context.logger.logError.bind(this.core.context.logger));
+        } else {
+            this.core.context.logger.logWarn('PacketServer is not set, will not init NapCat.Packet!');
+        }
+    }
+
+    get available(): boolean {
+        return this.packetSession?.client.available ?? false;
+    }
+
+    async InitSendPacket(serverUrl: string, qqversion: string) {
+        this.serverUrl = serverUrl;
+        this.qqVersion = qqversion;
+        const offsetTable: OffsetType = offset;
+        const table = offsetTable[qqversion + '-' + os.arch()];
+        if (!table) return false;
+        const url = 'ws://' + this.serverUrl + '/ws';
+        this.packetSession = new PacketSession(this.core.context.logger, new PacketClient(url, this.core));
+        await this.packetSession.client.connect();
+        await this.packetSession.client.init(process.pid, table.recv, table.send);
+        return true;
+    }
+
+    async sendPacket(cmd: string, data: PacketHexStr, rsp = false): Promise<RecvPacketData> {
+        return this.packetSession!.client.sendPacket(cmd, data, rsp);
+    }
+
+    async sendPokePacket(group: number, peer: number) {
+        const data = this.packetSession?.packer.packPokePacket(group, peer);
+        await this.sendPacket('OidbSvcTrpcTcp.0xed3_1', data!, false);
+    }
+
+    async sendRkeyPacket() {
+        const packet = this.packetSession?.packer.packRkeyPacket();
+        const ret = await this.sendPacket('OidbSvcTrpcTcp.0x9067_202', packet!, true);
+        if (!ret?.hex_data) return [];
+        const body = new NapProtoMsg(OidbSvcTrpcTcpBaseRsp).decode(Buffer.from(ret.hex_data, 'hex')).body;
+        const retData = new NapProtoMsg(OidbSvcTrpcTcp0X9067_202_Rsp_Body).decode(body);
+        return retData.data.rkeyList;
+    }
+
+    async sendStatusPacket(uin: number): Promise<{ status: number; ext_status: number; } | undefined> {
+        let status = 0;
+        try {
+            const packet = this.packetSession?.packer.packStatusPacket(uin);
+            const ret = await this.sendPacket('OidbSvcTrpcTcp.0xfe1_2', packet!, true);
+            const data = Buffer.from(ret.hex_data, 'hex');
+            const ext = new NapProtoMsg(OidbSvcTrpcTcp0XFE1_2RSP).decode(new NapProtoMsg(OidbSvcTrpcTcpBase).decode(data).body).data.status.value;
+            // ext & 0xff00 + ext >> 16 & 0xff
+            const extBigInt = BigInt(ext); // 转换为 BigInt
+            if (extBigInt <= 10n) {
+                return { status: Number(extBigInt) * 10, ext_status: 0 };
+            }
+            status = Number((extBigInt & 0xff00n) + ((extBigInt >> 16n) & 0xffn)); // 使用 BigInt 操作符
+            return { status: 10, ext_status: status };
+        } catch (error) {
+            return undefined;
+        }
+    }
+
+    async sendSetSpecialTittlePacket(groupCode: string, uid: string, tittle: string) {
+        const data = this.packetSession?.packer.packSetSpecialTittlePacket(groupCode, uid, tittle);
+        await this.sendPacket('OidbSvcTrpcTcp.0x8fc_2', data!, true);
+    }
+
+    private async uploadResources(msg: PacketMsg[], groupUin: number = 0){
+        const reqList = []
+        for (const m of msg){
+            for (const e of m.msg){
+                if (e instanceof PacketMsgPicElement){
+                    reqList.push(this.packetSession?.highwaySession.uploadImage({
+                        chatType: groupUin ? ChatType.KCHATTYPEGROUP : ChatType.KCHATTYPEC2C,
+                        peerUid: String(groupUin) ? String(groupUin) : this.core.selfInfo.uid
+                    }, e));
+                }
+            }
+        }
+        return Promise.all(reqList);
+    }
+
+    async sendUploadForwardMsg(msg: PacketMsg[], groupUin: number = 0) {
+        await this.uploadResources(msg, groupUin);
+        const data = await this.packetSession?.packer.packUploadForwardMsg(this.core.selfInfo.uid, msg, groupUin);
+        const ret = await this.sendPacket('trpc.group.long_msg_interface.MsgService.SsoSendLongMsg', data!, true);
+        this.logger.logDebug('sendUploadForwardMsg', ret);
+        const resp = new NapProtoMsg(SendLongMsgResp).decode(Buffer.from(ret.hex_data, 'hex'));
+        return resp.result.resId;
+    }
+
+    async sendGroupFileDownloadReq(groupUin: number, fileUUID: string) {
+        const data = this.packetSession?.packer.packGroupFileDownloadReq(groupUin, fileUUID);
+        const ret = await this.sendPacket('OidbSvcTrpcTcp.0x6d6_2', data!, true);
+        const body = new NapProtoMsg(OidbSvcTrpcTcpBaseRsp).decode(Buffer.from(ret.hex_data, 'hex')).body;
+        const resp = new NapProtoMsg(OidbSvcTrpcTcp0x6D6Response).decode(body);
+        if (resp.download.retCode !== 0){
+            throw new Error(`sendGroupFileDownloadReq error: ${resp.download.clientWording}`);
+        }
+        return `https://${resp.download.downloadDns}/ftn_handler/${Buffer.from(resp.download.downloadUrl).toString('hex')}/?fname=`
+    }
+}

src/core/apis/sign.ts

@@ -0,0 +1,236 @@
+import { RequestUtil } from '@/common/request';
+import { MiniAppLuaJsonType } from '@/core';
+import { InstanceContext, NapCatCore } from '..';
+
+export class NTQQMusicSignApi {
+    context: InstanceContext;
+    core: NapCatCore;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+    }
+
+    async signMiniApp(CardData: MiniAppLuaJsonType) {
+        // {
+        //   "app": "com.tencent.miniapp.lua",
+        //   "bizsrc": "tianxuan.imgJumpArk",
+        //   "view": "miniapp",
+        //   "prompt": "hi! 这里有我的日常故事，只想讲给你听",
+        //   "config": {
+        //     "type": "normal",
+        //     "forward": 1,
+        //     "autosize": 0
+        //   },
+        //   "meta": {
+        //     "miniapp": {
+        //       "title": "hi! 这里有我的日常故事，只想讲给你听",
+        //       "preview": "https:\/\/tianquan.gtimg.cn\/qqAIAgent\/item\/7\/square.png",
+        //       "jumpUrl": "https:\/\/club.vip.qq.com\/transfer?open_kuikly_info=%7B%22version%22%3A%20%221%22%2C%22src_type%22%3A%20%22web%22%2C%22kr_turbo_display%22%3A%20%221%22%2C%22page_name%22%3A%20%22vas_ai_persona_moments%22%2C%22bundle_name%22%3A%20%22vas_ai_persona_moments%22%7D&page_name=vas_ai_persona_moments&enteranceId=share&robot_uin=3889008584",
+        //       "tag": "QQ智能体",
+        //       "tagIcon": "https:\/\/tianquan.gtimg.cn\/shoal\/qqAIAgent\/3e9d70c9-d98c-45b8-80b4-79d82971b514.png",
+        //       "source": "QQ智能体",
+        //       "sourcelogo": "https:\/\/tianquan.gtimg.cn\/shoal\/qqAIAgent\/3e9d70c9-d98c-45b8-80b4-79d82971b514.png"
+        //     }
+        //   }
+        // }
+
+        // token : function(url,skey){
+        //   var str = skey || cookie('skey') || cookie('rv2') || '',
+        //     hash = 5381;
+        //   if(url){
+        //     var hostname = uri(url).hostname;
+        //     if(hostname.indexOf('qun.qq.com') > -1 || (hostname.indexOf('qzone.qq.com') > -1 && hostname.indexOf('qun.qzone.qq.com') === -1)){
+        //       str = cookie('p_skey') || str;
+        //     }
+        //   }
+        //   for(var i = 0, len = str.length; i < len; ++i){
+        //     hash += (hash << 5) + str.charAt(i).charCodeAt();
+        //   }
+        //   return hash & 0x7fffffff;
+        // },
+        // 
+
+        // function signToken(skey: string) {
+        //   let hash = 5381;
+        //   for (let i = 0, len = skey.length; i < len; ++i) {
+        //     hash += (hash << 5) + skey.charCodeAt(i);
+        //   }
+        //   return hash & 0x7fffffff;
+        // }
+        const signCard = {
+            'app': 'com.tencent.miniapp.lua',
+            'bizsrc': 'tianxuan.imgJumpArk',
+            'view': 'miniapp',
+            'prompt': CardData.prompt,
+            'config': {
+                'type': 'normal',
+                'forward': 1,
+                'autosize': 0,
+            },
+            'meta': {
+                'miniapp': {
+                    'title': CardData.title,
+                    'preview': (CardData.preview as string).replace(/\\/g, '\\/\\/'),
+                    'jumpUrl': (CardData.jumpUrl as string).replace(/\\/g, '\\/\\/'),
+                    'tag': CardData.tag,
+                    'tagIcon': (CardData.tagIcon as string).replace(/\\/g, '\\/\\/'),
+                    'source': CardData.source,
+                    'sourcelogo': (CardData.sourcelogo as string).replace(/\\/g, '\\/\\/'),
+                },
+            },
+        };
+        // let signCard = {
+        //   "app": "com.tencent.eventshare.lua",
+        //   "prompt": "Bot Test",
+        //   "bizsrc": "tianxuan.business",
+        //   "meta": {
+        //     "eventshare": {
+        //       "button1URL": "https://www.bilibili.com",
+        //       "button1disable": false,
+        //       "button1title": "点我前往",
+        //       "button2URL": "",
+        //       "button2disable": false,
+        //       "button2title": "",
+        //       "buttonNum": 1,
+        //       "jumpURL": "https://www.bilibili.com",
+        //       "preview": "https://tianquan.gtimg.cn/shoal/card/9930bc4e-4a92-4da3-814f-8094a2421d9c.png",
+        //       "tag": "QQ集卡",
+        //       "tagIcon": "https://tianquan.gtimg.cn/shoal/card/c034854b-102d-40be-a545-5ca90a7c49c9.png",
+        //       "title": "Bot Test"
+        //     }
+        //   },
+        //   "config": {
+        //     "autosize": 0,
+        //     "collect": 0,
+        //     "ctime": 1716568575,
+        //     "forward": 1,
+        //     "height": 336,
+        //     "reply": 0,
+        //     "round": 1,
+        //     "type": "normal",
+        //     "width": 263
+        //   },
+        //   "view": "eventshare",
+        //   "ver": "0.0.0.1"
+        // };
+        const data = (await this.core.apis.UserApi.getQzoneCookies());
+        const Bkn = this.core.apis.WebApi.getBknFromCookie(data.p_skey);
+
+        const CookieValue = 'p_skey=' + data.p_skey + '; skey=' + data.skey + '; p_uin=o' + this.core.selfInfo.uin + '; uin=o' + this.core.selfInfo.uin;
+
+        const signurl = 'https://h5.qzone.qq.com/v2/vip/tx/trpc/ark-share/GenNewSignedArk?g_tk=' + Bkn + '&ark=' + encodeURIComponent(JSON.stringify(signCard));
+        let signed_ark = '';
+        try {
+            const retData = await RequestUtil.HttpGetJson<{
+                code: number,
+                data: { signed_ark: string }
+            }>(signurl, 'GET', undefined, { Cookie: CookieValue });
+            //logDebug('MiniApp JSON 消息生成成功', retData);
+            signed_ark = retData.data.signed_ark;
+        } catch (error) {
+            this.context.logger.logDebug('MiniApp JSON 消息生成失败', error);
+        }
+        return signed_ark;
+    }
+
+    async signInternal(songname: string, singer: string, cover: string, songmid: string, songmusic: string) {
+        //curl -X POST 'https://mqq.reader.qq.com/api/mqq/share/card?accessToken&_csrfToken&source=c0003' -H 'Content-Type: application/json' -H 'Cookie: uin=o10086' -d '{"app":"com.tencent.qqreader.share","config":{"ctime":1718634110,"forward":1,"token":"9a63343c32d5a16bcde653eb97faa25d","type":"normal"},"extra":{"app_type":1,"appid":100497308,"msg_seq":14386738075403815000.0,"uin":1733139081},"meta":{"music":{"action":"","android_pkg_name":"","app_type":1,"appid":100497308,"ctime":1718634110,"desc":"周杰伦","jumpUrl":"https://i.y.qq.com/v8/playsong.html?songmid=0039MnYb0qxYhV&type=0","musicUrl":"http://ws.stream.qqmusic.qq.com/http://isure6.stream.qqmusic.qq.com/M800002202B43Cq4V4.mp3?fromtag=810033622&guid=br_xzg&trace=23fe7bcbe2336bbf&uin=553&vkey=CF0F5CE8B0FA16F3001F8A88D877A217EB5E4F00BDCEF1021EB6C48969CA33C6303987AEECE9CC840122DD2F917A59D6130D8A8CA4577C87","preview":"https://y.qq.com/music/photo_new/T002R800x800M000000MkMni19ClKG.jpg","cover":"https://y.qq.com/music/photo_new/T002R800x800M000000MkMni19ClKG.jpg","sourceMsgId":"0","source_icon":"https://p.qpic.cn/qqconnect/0/app_100497308_1626060999/100?max-age=2592000&t=0","source_url":"","tag":"QQ音乐","title":"晴天","uin":10086}},"prompt":"[分享]晴天","ver":"0.0.0.1","view":"music"}'
+        const signurl = 'https://mqq.reader.qq.com/api/mqq/share/card?accessToken&_csrfToken&source=c0003';
+        //let  = "https://y.qq.com/music/photo_new/T002R800x800M000000MkMni19ClKG.jpg";
+        const signCard = {
+            app: 'com.tencent.qqreader.share',
+            config: {
+                ctime: 1718634110,
+                forward: 1,
+                token: '9a63343c32d5a16bcde653eb97faa25d',
+                type: 'normal',
+            },
+            extra: {
+                app_type: 1,
+                appid: 100497308,
+                msg_seq: 14386738075403815000,
+                uin: 1733139081,
+            },
+            meta: {
+                music: {
+                    action: '',
+                    android_pkg_name: '',
+                    app_type: 1,
+                    appid: 100497308,
+                    ctime: 1718634110,
+                    desc: singer,
+                    jumpUrl: 'https://i.y.qq.com/v8/playsong.html?songmid=' + songmid + '&type=0',
+                    musicUrl: songmusic,
+                    preview: cover,
+                    cover: cover,
+                    sourceMsgId: '0',
+                    source_icon: 'https://p.qpic.cn/qqconnect/0/app_100497308_1626060999/100?max-age=2592000&t=0',
+                    source_url: '',
+                    tag: 'QQ音乐',
+                    title: songname,
+                    uin: 10086,
+                },
+            },
+            prompt: '[分享]' + songname,
+            ver: '0.0.0.1',
+            view: 'music',
+        };
+        //console.log(JSON.stringify(signCard, null, 2));
+        const data = await RequestUtil.HttpGetJson<{ code: number, data: { arkResult: string } }>
+        (signurl, 'POST', signCard, { 'Cookie': 'uin=o10086', 'Content-Type': 'application/json' });
+        return data;
+    }
+
+    //注意处理错误
+    async signWay03(id: string = '', mid: string = '') {
+        let signedMid;
+        if (mid == '') {
+            const MusicInfo = await RequestUtil.HttpGetJson<{
+                songinfo?: {
+                    data?: {
+                        track_info: {
+                            mid: string
+                        }
+                    }
+                }
+            }>(
+                'https://u.y.qq.com/cgi-bin/musicu.fcg?format=json&inCharset=utf8&outCharset=utf-8&notice=0&platform=yqq.json&needNewCode=0&data={"comm":{"ct":24,"cv":0},"songinfo":{"method":"get_song_detail_yqq","param":{"song_type":0,"song_mid":"","song_id":' + id + '},"module":"music.pf_song_detail_svr"}}',
+                'GET',
+                undefined,
+            );
+            signedMid = MusicInfo.songinfo?.data?.track_info.mid;
+        }
+        //第三方接口 存在速率限制 现在勉强用
+        const MusicReal = await RequestUtil.HttpGetJson<{
+            code: number,
+            data?: {
+                name: string,
+                singer: string,
+                url: string,
+                cover: string
+            }
+        }>('https://api.leafone.cn/api/qqmusic?id=' + signedMid + '&type=8', 'GET');
+        //console.log(MusicReal);
+        return { ...MusicReal.data, mid: signedMid };
+    }
+    //转换外域名为 https://qq.ugcimg.cn/v1/cpqcbu4b8870i61bde6k7cbmjgejq8mr3in82qir4qi7ielffv5slv8ck8g42novtmev26i233ujtuab6tvu2l2sjgtupfr389191v00s1j5oh5325j5eqi40774jv1i/khovifoh7jrqd6eahoiv7koh8o
+    //https://cgi.connect.qq.com/qqconnectopen/openapi/change_image_url?url=https://th.bing.com/th?id=OSK.b8ed36f1fb1889de6dc84fd81c187773&w=46&h=46&c=11&rs=1&qlt=80&o=6&dpr=2&pid=SANGAM
+
+    //外域名不行得走qgroup中转
+    //https://proxy.gtimg.cn/tx_tls_gate=y.qq.com/music/photo_new/T002R800x800M000000y5gq7449K9I.jpg
+
+    //可外域名
+    //https://pic.ugcimg.cn/500955bdd6657ecc8e82e02d2df06800/jpg1
+
+    //QQ音乐gtimg接口
+    //https://y.gtimg.cn/music/photo_new/T002R800x800M000000y5gq7449K9I.jpg?max_age=2592000
+
+    //还有一处公告上传可以上传高质量图片 持久为qq域名
+    async SignMusicWrapper(id: string = '') {
+        const MusicInfo = await this.signWay03(id)!;
+        return await this.signInternal(MusicInfo.name!, MusicInfo.singer!, MusicInfo.cover!, MusicInfo.mid!, 'https://ws.stream.qqmusic.qq.com/' + MusicInfo.url!);
+    }
+
+}
+

src/core/apis/system.ts

@@ -0,0 +1,36 @@
+import { InstanceContext, NapCatCore } from '@/core';
+
+export class NTQQSystemApi {
+    context: InstanceContext;
+    core: NapCatCore;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+    }
+
+    async hasOtherRunningQQProcess() {
+        return this.core.util.hasOtherRunningQQProcess();
+    }
+
+    async ocrImage(filePath: string) {
+        return this.context.session.getNodeMiscService().wantWinScreenOCR(filePath);
+    }
+
+    async translateEnWordToZn(words: string[]) {
+        return this.context.session.getRichMediaService().translateEnWordToZn(words);
+    }
+
+    async getOnlineDev() {
+        this.context.session.getMsgService().getOnLineDev();
+    }
+
+    async getArkJsonCollection(cid: string) {
+        return await this.core.eventWrapper.callNoListenerEvent('NodeIKernelCollectionService/collectionArkShare', '1717662698058');
+    }
+
+    async bootMiniApp(appFile: string, params: string) {
+        await this.context.session.getNodeMiscService().setMiniAppVersion('2.16.4');
+        return this.context.session.getNodeMiscService().startNewMiniApp(appFile, params);
+    }
+}

src/core/apis/user.ts

@@ -0,0 +1,232 @@
+import { ModifyProfileParams, User, UserDetailSource } from '@/core/entities';
+import { RequestUtil } from '@/common/request';
+import { InstanceContext, NapCatCore, ProfileBizType } from '..';
+import { solveAsyncProblem } from '@/common/helper';
+
+export class NTQQUserApi {
+    context: InstanceContext;
+    core: NapCatCore;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+    }
+    //self_tind格式
+    async createUidFromTinyId(tinyId: string) {
+        return this.context.session.getMsgService().createUidFromTinyId(this.core.selfInfo.uin, tinyId);
+    }
+    async getStatusByUid(uid: string) {
+        return this.context.session.getProfileService().getStatus(uid);
+    }
+    async getProfileLike(uid: string) {
+        return this.context.session.getProfileLikeService().getBuddyProfileLike({
+            friendUids: [uid],
+            basic: 1,
+            vote: 1,
+            favorite: 0,
+            userProfile: 1,
+            type: 2,
+            start: 0,
+            limit: 20,
+        });
+    }
+    async fetchOtherProfileLike(uid: string) {
+        return this.context.session.getProfileLikeService().getBuddyProfileLike({
+            friendUids: [uid],
+            basic: 1,
+            vote: 1,
+            favorite: 0,
+            userProfile: 0,
+            type: 1,
+            start: 0,
+            limit: 20,
+        });
+    }
+    async setLongNick(longNick: string) {
+        return this.context.session.getProfileService().setLongNick(longNick);
+    }
+
+    async setSelfOnlineStatus(status: number, extStatus: number, batteryStatus: number) {
+        return this.context.session.getMsgService().setStatus({
+            status: status,
+            extStatus: extStatus,
+            batteryStatus: batteryStatus,
+        });
+    }
+
+    async getBuddyRecommendContactArkJson(uin: string, sencenID = '') {
+        return this.context.session.getBuddyService().getBuddyRecommendContactArkJson(uin, sencenID);
+    }
+
+    async like(uid: string, count = 1): Promise<{ result: number, errMsg: string, succCounts: number }> {
+        return this.context.session.getProfileLikeService().setBuddyProfileLike({
+            friendUid: uid,
+            sourceId: 71,
+            doLikeCount: count,
+            doLikeTollCount: 0,
+        });
+    }
+
+    async setQQAvatar(filePath: string) {
+        const ret = await this.context.session.getProfileService().setHeader(filePath);
+        return { result: ret?.result, errMsg: ret?.errMsg };
+    }
+
+    async setGroupAvatar(gc: string, filePath: string) {
+        return this.context.session.getGroupService().setHeader(gc, filePath);
+    }
+
+    async fetchUserDetailInfo(uid: string, mode: UserDetailSource = UserDetailSource.KDB) {
+        const [_retData, profile] = await this.core.eventWrapper.callNormalEventV2(
+            'NodeIKernelProfileService/fetchUserDetailInfo',
+            'NodeIKernelProfileListener/onUserDetailInfoChanged',
+            [
+                'BuddyProfileStore',
+                [uid],
+                mode,
+                [ProfileBizType.KALL],
+            ],
+            () => true,
+            (profile) => profile.uid === uid,
+        );
+        const RetUser: User = {
+            ...profile.simpleInfo.status,
+            ...profile.simpleInfo.vasInfo,
+            ...profile.commonExt,
+            ...profile.simpleInfo.baseInfo,
+            qqLevel: profile.commonExt?.qqLevel,
+            age: profile.simpleInfo.baseInfo.age,
+            pendantId: '',
+            ...profile.simpleInfo.coreInfo
+        };
+        return RetUser;
+    }
+
+    async getUserDetailInfo(uid: string): Promise<User> {
+        let retUser = await solveAsyncProblem(async (uid) => this.fetchUserDetailInfo(uid, UserDetailSource.KDB), uid);
+        if (retUser && retUser.uin !== '0') {
+            return retUser;
+        }
+        this.context.logger.logDebug('[NapCat] [Mark] getUserDetailInfo Mode1 Failed.');
+        retUser = await this.fetchUserDetailInfo(uid, UserDetailSource.KSERVER);
+        if (retUser && retUser.uin === '0') {
+            retUser.uin = await this.core.apis.UserApi.getUidByUinV2(uid) ?? '0';
+        }
+        return retUser;
+    }
+
+    async modifySelfProfile(param: ModifyProfileParams) {
+        return this.context.session.getProfileService().modifyDesktopMiniProfile(param);
+    }
+
+    async getCookies(domain: string) {
+        const ClientKeyData = await this.forceFetchClientKey();
+        const requestUrl = 'https://ssl.ptlogin2.qq.com/jump?ptlang=1033&clientuin=' + this.core.selfInfo.uin +
+            '&clientkey=' + ClientKeyData.clientKey + '&u1=https%3A%2F%2F' + domain + '%2F' + this.core.selfInfo.uin + '%2Finfocenter&keyindex=19%27';
+        const data = await RequestUtil.HttpsGetCookies(requestUrl);
+        if (!data.p_skey || data.p_skey.length == 0) {
+            try {
+                const pskey = (await this.getPSkey([domain])).domainPskeyMap.get(domain);
+                if (pskey) data.p_skey = pskey;
+            } catch {
+                return data;
+            }
+        }
+        return data;
+    }
+
+    async getPSkey(domainList: string[]) {
+        return await this.context.session.getTipOffService().getPskey(domainList, true);
+    }
+
+    async getRobotUinRange(): Promise<Array<any>> {
+        const robotUinRanges = await this.context.session.getRobotService().getRobotUinRange({
+            justFetchMsgConfig: '1',
+            type: 1,
+            version: 0,
+            aioKeywordVersion: 0,
+        });
+        return robotUinRanges?.response?.robotUinRanges;
+    }
+
+    //需要异常处理
+
+    async getQzoneCookies() {
+        const ClientKeyData = await this.forceFetchClientKey();
+        const requestUrl = 'https://ssl.ptlogin2.qq.com/jump?ptlang=1033&clientuin=' + this.core.selfInfo.uin + '&clientkey=' + ClientKeyData.clientKey + '&u1=https%3A%2F%2Fuser.qzone.qq.com%2F' + this.core.selfInfo.uin + '%2Finfocenter&keyindex=19%27';
+        return await RequestUtil.HttpsGetCookies(requestUrl);
+    }
+
+    //需要异常处理
+
+    async getSKey(): Promise<string | undefined> {
+        const ClientKeyData = await this.forceFetchClientKey();
+        if (ClientKeyData.result !== 0) {
+            throw new Error('getClientKey Error');
+        }
+        const clientKey = ClientKeyData.clientKey;
+        // const keyIndex = ClientKeyData.keyIndex;
+        const requestUrl = 'https://ssl.ptlogin2.qq.com/jump?ptlang=1033&clientuin=' + this.core.selfInfo.uin + '&clientkey=' + clientKey + '&u1=https%3A%2F%2Fh5.qzone.qq.com%2Fqqnt%2Fqzoneinpcqq%2Ffriend%3Frefresh%3D0%26clientuin%3D0%26darkMode%3D0&keyindex=19%27';
+        const cookies: { [key: string]: string; } = await RequestUtil.HttpsGetCookies(requestUrl);
+        const skey = cookies['skey'];
+        if (!skey) {
+            throw new Error('SKey is Empty');
+        }
+        return skey;
+    }
+
+    //后期改成流水线处理
+    async getUidByUinV2(Uin: string) {
+        let uid = (await this.context.session.getGroupService().getUidByUins([Uin])).uids.get(Uin);
+        if (uid) return uid;
+        uid = (await this.context.session.getProfileService().getUidByUin('FriendsServiceImpl', [Uin])).get(Uin);
+        if (uid) return uid;
+        uid = (await this.context.session.getUixConvertService().getUid([Uin])).uidInfo.get(Uin);
+        if (uid) return uid;
+        const unverifiedUid = (await this.getUserDetailInfoByUin(Uin)).detail.uid;//从QQ Native 特殊转换
+        if (unverifiedUid.indexOf('*') == -1) uid = unverifiedUid;
+        //if (uid) return uid;
+        return uid;
+    }
+
+    //后期改成流水线处理
+    async getUinByUidV2(Uid: string) {
+        let uin = (await this.context.session.getGroupService().getUinByUids([Uid])).uins.get(Uid);
+        if (uin) return uin;
+        uin = (await this.context.session.getProfileService().getUinByUid('FriendsServiceImpl', [Uid])).get(Uid);
+        if (uin) return uin;
+        uin = (await this.context.session.getUixConvertService().getUin([Uid])).uinInfo.get(Uid);
+        if (uin) return uin;
+        uin = (await this.core.apis.FriendApi.getBuddyIdMap(true)).getKey(Uid);
+        if (uin) return uin;
+        uin = (await this.getUserDetailInfo(Uid)).uin; //从QQ Native 转换
+        return uin;
+    }
+
+    async getRecentContactListSnapShot(count: number) {
+        return await this.context.session.getRecentContactService().getRecentContactListSnapShot(count);
+    }
+
+    async getRecentContactListSyncLimit(count: number) {
+        return await this.context.session.getRecentContactService().getRecentContactListSyncLimit(count);
+    }
+
+    async getRecentContactListSync() {
+        return await this.context.session.getRecentContactService().getRecentContactListSync();
+    }
+
+    async getRecentContactList() {
+        return await this.context.session.getRecentContactService().getRecentContactList();
+    }
+
+    async getUserDetailInfoByUin(Uin: string) {
+        return await this.core.eventWrapper.callNoListenerEvent(
+            'NodeIKernelProfileService/getUserDetailInfoByUin',
+            Uin
+        );
+    }
+
+    async forceFetchClientKey() {
+        return await this.context.session.getTicketService().forceFetchClientKey('');
+    }
+}

src/core/apis/webapi.ts

@@ -0,0 +1,341 @@
+import { RequestUtil } from '@/common/request';
+import {
+    GroupEssenceMsgRet,
+    InstanceContext,
+    WebApiGroupMember,
+    WebApiGroupMemberRet,
+    WebApiGroupNoticeRet,
+    WebHonorType,
+} from '@/core';
+import { NapCatCore } from '..';
+
+export class NTQQWebApi {
+    context: InstanceContext;
+    core: NapCatCore;
+
+    constructor(context: InstanceContext, core: NapCatCore) {
+        this.context = context;
+        this.core = core;
+    }
+
+    async shareDigest(groupCode: string, msgSeq: string, msgRandom: string, targetGroupCode: string) {
+        const cookieObject = await this.core.apis.UserApi.getCookies('qun.qq.com');
+        const url = `https://qun.qq.com/cgi-bin/group_digest/share_digest?${new URLSearchParams({
+            bkn: this.getBknFromCookie(cookieObject),
+            group_code: groupCode,
+            msg_seq: msgSeq,
+            msg_random: msgRandom,
+            target_group_code: targetGroupCode,
+        }).toString()}`;
+        try {
+            return RequestUtil.HttpGetText(url, 'GET', '', { 'Cookie': this.cookieToString(cookieObject) });
+        } catch (e) {
+            return undefined;
+        }
+    }
+    async getGroupEssenceMsgAll(GroupCode: string) {
+        const ret: GroupEssenceMsgRet[] = [];
+        for (let i = 0; i < 20; i++) {
+            const data = await this.getGroupEssenceMsg(GroupCode, i, 50);
+            if (!data) break;
+            ret.push(data);
+            if (data.data.is_end) break;
+        }
+        return ret;
+    }
+    async getGroupEssenceMsg(GroupCode: string, page_start: number = 0, page_limit: number = 50) {
+        const cookieObject = await this.core.apis.UserApi.getCookies('qun.qq.com');
+        const url = `https://qun.qq.com/cgi-bin/group_digest/digest_list?${new URLSearchParams({
+            bkn: this.getBknFromCookie(cookieObject),
+            page_start: page_start.toString(),
+            page_limit: page_limit.toString(),
+            group_code: GroupCode,
+        }).toString()}`;
+        try {
+            const ret = await RequestUtil.HttpGetJson<GroupEssenceMsgRet>(
+                url,
+                'GET',
+                '',
+                { 'Cookie': this.cookieToString(cookieObject) }
+            );
+            return ret.retcode === 0 ? ret : undefined;
+        } catch {
+            return undefined;
+        }
+    }
+
+    async getGroupMembers(GroupCode: string, cached: boolean = true): Promise<WebApiGroupMember[]> {
+        //logDebug('webapi 获取群成员', GroupCode);
+        const memberData: Array<WebApiGroupMember> = new Array<WebApiGroupMember>();
+        const cookieObject = await this.core.apis.UserApi.getCookies('qun.qq.com');
+        const retList: Promise<WebApiGroupMemberRet>[] = [];
+        const fastRet = await RequestUtil.HttpGetJson<WebApiGroupMemberRet>(
+            `https://qun.qq.com/cgi-bin/qun_mgr/search_group_members?${new URLSearchParams({
+                st: '0',
+                end: '40',
+                sort: '1',
+                gc: GroupCode,
+                bkn: this.getBknFromCookie(cookieObject),
+            }).toString()}`,
+            'POST',
+            '',
+            { 'Cookie': this.cookieToString(cookieObject) }
+        );
+        if (!fastRet?.count || fastRet?.errcode !== 0 || !fastRet?.mems) {
+            return [];
+        } else {
+            for (const key in fastRet.mems) {
+                memberData.push(fastRet.mems[key]);
+            }
+        }
+        //初始化获取PageNum
+        const PageNum = Math.ceil(fastRet.count / 40);
+        //遍历批量请求
+        for (let i = 2; i <= PageNum; i++) {
+            const ret = RequestUtil.HttpGetJson<WebApiGroupMemberRet>(
+                `https://qun.qq.com/cgi-bin/qun_mgr/search_group_members?${new URLSearchParams({
+                    st: ((i - 1) * 40).toString(),
+                    end: (i * 40).toString(),
+                    sort: '1',
+                    gc: GroupCode,
+                    bkn: this.getBknFromCookie(cookieObject),
+                }).toString()}`,
+                'POST',
+                '',
+                { 'Cookie': this.cookieToString(cookieObject) }
+            );
+            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 key in ret.mems) {
+                memberData.push(ret.mems[key]);
+            }
+        }
+        return memberData;
+    }
+
+    // public  async addGroupDigest(groupCode: string, msgSeq: string) {
+    //   const url = `https://qun.qq.com/cgi-bin/group_digest/cancel_digest?random=665&X-CROSS-ORIGIN=fetch&group_code=${groupCode}&msg_seq=${msgSeq}&msg_random=444021292`;
+    //   const res = await this.request(url);
+    //   return await res.json();
+    // }
+
+    // public async getGroupDigest(groupCode: string) {
+    //   const url = `https://qun.qq.com/cgi-bin/group_digest/digest_list?random=665&X-CROSS-ORIGIN=fetch&group_code=${groupCode}&page_start=0&page_limit=20`;
+    //   const res = await this.request(url);
+    //   return await res.json();
+    // }
+
+    async setGroupNotice(
+        GroupCode: string,
+        Content: string,
+        pinned: number = 0,
+        type: number = 1,
+        is_show_edit_card: number = 1,
+        tip_window_type: number = 1,
+        confirm_required: number = 1,
+        picId: string = '',
+        imgWidth: number = 540,
+        imgHeight: number = 300,
+    ) {
+        interface SetNoticeRetSuccess {
+            ec: number;
+            em: string;
+            id: number;
+            ltsm: number;
+            new_fid: string;
+            read_only: number;
+            role: number;
+            srv_code: number;
+        }
+
+        const cookieObject = await this.core.apis.UserApi.getCookies('qun.qq.com');
+
+        try {
+            const settings = JSON.stringify({
+                is_show_edit_card: is_show_edit_card,
+                tip_window_type: tip_window_type,
+                confirm_required: confirm_required
+            });
+            const externalParam = {
+                pic: picId,
+                imgWidth: imgWidth.toString(),
+                imgHeight: imgHeight.toString(),
+            };
+            const ret: SetNoticeRetSuccess = await RequestUtil.HttpGetJson<SetNoticeRetSuccess>(
+                `https://web.qun.qq.com/cgi-bin/announce/add_qun_notice?${new URLSearchParams({
+                    bkn: this.getBknFromCookie(cookieObject),
+                    qid: GroupCode,
+                    text: Content,
+                    pinned: pinned.toString(),
+                    type: type.toString(),
+                    settings: settings,
+                    ...(picId === '' ? {} : externalParam)
+                }).toString()}`,
+                'POST',
+                '',
+                { 'Cookie': this.cookieToString(cookieObject) }
+            );
+            return ret;
+        } catch (e) {
+            return undefined;
+        }
+    }
+
+    async getGroupNotice(GroupCode: string): Promise<undefined | WebApiGroupNoticeRet> {
+        const cookieObject = await this.core.apis.UserApi.getCookies('qun.qq.com');
+        try {
+            const ret = await RequestUtil.HttpGetJson<WebApiGroupNoticeRet>(
+                `https://web.qun.qq.com/cgi-bin/announce/get_t_list?${new URLSearchParams({
+                    bkn: this.getBknFromCookie(cookieObject),
+                    qid: GroupCode,
+                    ft: '23',
+                    ni: '1',
+                    n: '1',
+                    i: '1',
+                    log_read: '1',
+                    platform: '1',
+                    s: '-1',
+                }).toString()}&n=20`,
+                'GET',
+                '',
+                { 'Cookie': this.cookieToString(cookieObject) }
+            );
+            return ret?.ec === 0 ? ret : undefined;
+        } catch (e) {
+            return undefined;
+        }
+    }
+
+    async getGroupHonorInfo(groupCode: string, getType: WebHonorType) {
+        const cookieObject = await this.core.apis.UserApi.getCookies('qun.qq.com');
+        const getDataInternal = async (Internal_groupCode: string, Internal_type: number) => {
+            let resJson;
+            try {
+                const res = await RequestUtil.HttpGetText(
+                    `https://qun.qq.com/interactive/honorlist?${new URLSearchParams({
+                        gc: Internal_groupCode,
+                        type: Internal_type.toString(),
+                    }).toString()}`,
+                    'GET',
+                    '',
+                    { 'Cookie': this.cookieToString(cookieObject) }
+                );
+                const match = /window\.__INITIAL_STATE__=(.*?);/.exec(res);
+                if (match) {
+                    resJson = JSON.parse(match[1].trim());
+                }
+                if (Internal_type === 1) {
+                    return resJson?.talkativeList;
+                } else {
+                    return resJson?.actorList;
+                }
+            } catch (e) {
+                this.context.logger.logDebug('获取当前群荣耀失败', e);
+            }
+            return undefined;
+        };
+
+        const HonorInfo: any = { group_id: groupCode };
+
+        if (getType === WebHonorType.TALKATIVE || getType === WebHonorType.ALL) {
+            const RetInternal = await getDataInternal(groupCode, 1);
+            if (RetInternal) {
+                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,
+                    });
+                }
+            } else {
+                this.context.logger.logError.bind(this.context.logger)('获取龙王信息失败');
+            }
+        }
+        if (getType === WebHonorType.PERFORMER || getType === WebHonorType.ALL) {
+            const RetInternal = await getDataInternal(groupCode, 2);
+            if (RetInternal) {
+                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,
+                    });
+                }
+            } else {
+                this.context.logger.logError.bind(this.context.logger)('获取群聊之火失败');
+            }
+        }
+        if (getType === WebHonorType.PERFORMER || getType === WebHonorType.ALL) {
+            const RetInternal = await getDataInternal(groupCode, 3);
+            if (RetInternal) {
+                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,
+                    });
+                }
+            } else {
+                this.context.logger.logError.bind(this.context.logger)('获取群聊炽焰失败');
+            }
+        }
+        if (getType === WebHonorType.EMOTION || getType === WebHonorType.ALL) {
+            const RetInternal = await getDataInternal(groupCode, 6);
+            if (RetInternal) {
+                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,
+                    });
+                }
+            } else {
+                this.context.logger.logError.bind(this.context.logger)('获取快乐源泉失败');
+            }
+        }
+
+        // 冒尖小春笋好像已经被tx扬了 R.I.P.
+        if (getType === WebHonorType.EMOTION || getType === WebHonorType.ALL) {
+            HonorInfo.strong_newbie_list = [];
+        }
+
+        return HonorInfo;
+    }
+
+    private cookieToString(cookieObject: any) {
+        return Object.entries(cookieObject).map(([key, value]) => `${key}=${value}`).join('; ');
+    }
+
+    public getBknFromCookie(cookieObject: any) {
+        const sKey = cookieObject.skey as string;
+
+        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();
+    }
+}

src/core/entities/adapter.ts

@@ -0,0 +1,11 @@
+export enum MsfStatusType {
+    KUNKNOWN,
+    KDISCONNECTED,
+    KCONNECTED
+}
+export enum MsfChangeReasonType {
+    KUNKNOWN,
+    KUSERLOGININ,
+    KUSERLOGINOUT,
+    KAUTO
+}

src/core/entities/cache.ts

@@ -0,0 +1,65 @@
+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/core/entities/contact.ts

@@ -0,0 +1,12 @@
+
+export interface FSABRecentContactParams {
+    anchorPointContact: {
+        contactId: string;
+        sortField: string;
+        pos: number;
+    };
+    relativeMoveCount: number;
+    listType: number;
+    count: number;
+    fetchOld: boolean;
+}

src/core/entities/group.ts

@@ -0,0 +1,140 @@
+import { QQLevel, Sex } from './user';
+
+export interface KickMemberInfo {
+    optFlag: number,
+    optOperate: number,
+    optMemberUid: string,
+    optBytesMsg: string,
+}
+//getGroupDetailInfo GroupCode,GroupInfoSource
+export enum GroupInfoSource {
+    KUNSPECIFIED,
+    KBIGDATACARD,
+    KDATACARD,
+    KNOTICE,
+    KAIO,
+    KRECENTCONTACT,
+    KMOREPANEL
+}
+export interface GroupExt0xEF0InfoFilter {
+    bindGuildId: number;
+    blacklistExpireTime: number;
+    companyId: number;
+    essentialMsgPrivilege: number;
+    essentialMsgSwitch: number;
+    fullGroupExpansionSeq: number;
+    fullGroupExpansionSwitch: number;
+    gangUpId: number;
+    groupAioBindGuildId: number;
+    groupBindGuildIds: number;
+    groupBindGuildSwitch: number;
+    groupExcludeGuildIds: number;
+    groupExtFlameData: number;
+    groupFlagPro1: number;
+    groupInfoExtSeq: number;
+    groupOwnerId: number;
+    groupSquareSwitch: number;
+    hasGroupCustomPortrait: number;
+    inviteRobotMemberExamine: number;
+    inviteRobotMemberSwitch: number;
+    inviteRobotSwitch: number;
+    isLimitGroupRtc: number;
+    lightCharNum: number;
+    luckyWord: number;
+    luckyWordId: number;
+    msgEventSeq: number;
+    qqMusicMedalSwitch: number;
+    reserve: number;
+    showPlayTogetherSwitch: number;
+    starId: number;
+    todoSeq: number;
+    viewedMsgDisappearTime: number;
+}
+
+export interface KickMemberV2Req {
+    groupCode: string,
+    kickFlag: number,
+    kickList: Array<KickMemberInfo>,
+    kickListUids: Array<string>,
+    kickMsg: string
+}
+
+export enum DataSource {
+    LOCAL,
+    REMOTE
+}
+
+export enum GroupListUpdateType {
+    REFRESHALL,
+    GETALL,
+    MODIFIED,
+    REMOVE
+}
+
+export interface GroupMemberCache {
+    group: {
+        data: GroupMember[];
+        isExpired: boolean;
+    };
+    isExpired: boolean;
+}
+
+export interface Group {
+    groupCode: string,
+    createTime?: string,//高版本才有
+    maxMember: number,
+    memberCount: number,
+    groupName: string,
+    groupStatus: number,
+    memberRole: number,
+    isTop: boolean,
+    toppedTimestamp: string,
+    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"
+    }
+}
+
+export enum GroupMemberRole {
+    normal = 2,
+    admin = 3,
+    owner = 4
+}
+
+export interface GroupMember {
+    memberRealLevel: string | undefined;
+    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;
+    age?: number;
+    qqLevel?: QQLevel;
+    isChangeRole: boolean;
+    joinTime: string;
+    lastSpeakTime: string;
+}

src/core/entities/index.ts

@@ -0,0 +1,8 @@
+export * from './user';
+export * from './group';
+export * from './msg';
+export * from './notify';
+export * from './cache';
+export * from './system';
+export * from './webapi';
+export * from './sign';

src/core/entities/msg.ts

@@ -0,0 +1,993 @@
+import { GroupMemberRole } from '@/core';
+
+export interface Peer {
+    chatType: ChatType;
+    peerUid: string;  // 如果是群聊uid为群号，私聊uid就是加密的字符串
+    guildId?: string;
+}
+
+export interface KickedOffLineInfo {
+    appId: number;
+    instanceId: number;
+    sameDevice: boolean;
+    tipsDesc: string;
+    tipsTitle: string;
+    kickedType: number;
+    securityKickedType: number;
+}
+
+export interface GetFileListParam {
+    sortType: number;
+    fileCount: number;
+    startIndex: number;
+    sortOrder: number;
+    showOnlinedocFolder: number;
+    folderId?: string;
+}
+
+export enum ElementType {
+    UNKNOWN = 0,
+
+    TEXT = 1,
+
+    PIC = 2,
+
+    FILE = 3,
+
+    PTT = 4,
+
+    VIDEO = 5,
+
+    FACE = 6,
+
+    REPLY = 7,
+
+    WALLET = 9,
+
+    /**
+     * “小灰条”，包括拍一拍 (Poke)、撤回提示等
+     */
+    GreyTip = 8,
+
+    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 ActionBarElement {
+    rows: InlineKeyboardRow[];
+    botAppid: string;
+}
+
+export interface SendActionBarElement {
+    elementType: ElementType.ACTIONBAR;
+    elementId: string;
+    actionBarElement: ActionBarElement;
+}
+
+export interface RecommendedMsgElement {
+    rows: InlineKeyboardRow[];
+    botAppid: string;
+}
+
+export interface SendRecommendedMsgElement {
+    elementType: ElementType.RECOMMENDEDMSG;
+    elementId: string;
+    recommendedMsgElement: RecommendedMsgElement;
+}
+
+export interface InlineKeyboardButton {
+    id: string;
+    label: string;
+    visitedLabel: string;
+    unsupportTips: string;
+    data: string;
+    specifyRoleIds: string[];
+    specifyTinyids: string[];
+    style: number;
+    type: number;
+    clickLimit: number;
+    atBotShowChannelList: boolean;
+    permissionType: number;
+}
+
+export interface InlineKeyboardRow {
+    buttons: InlineKeyboardButton[];
+}
+
+export interface TofuElementContent {
+    color: string;
+    tittle: string;
+}
+
+export interface TaskTopMsgElement {
+    msgTitle: string;
+    msgSummary: string;
+    iconUrl: string;
+    topMsgType: number;
+}
+
+export enum NTMsgType {
+    KMSGTYPEARKSTRUCT = 11,
+    KMSGTYPEFACEBUBBLE = 24,
+    KMSGTYPEFILE = 3,
+    KMSGTYPEGIFT = 14,
+    KMSGTYPEGIPHY = 13,
+    KMSGTYPEGRAYTIPS = 5,
+    KMSGTYPEMIX = 2,
+    KMSGTYPEMULTIMSGFORWARD = 8,
+    KMSGTYPENULL = 1,
+    KMSGTYPEONLINEFILE = 21,
+    KMSGTYPEONLINEFOLDER = 27,
+    KMSGTYPEPROLOGUE = 29,
+    KMSGTYPEPTT = 6,
+    KMSGTYPEREPLY = 9,
+    KMSGTYPESHARELOCATION = 25,
+    KMSGTYPESTRUCT = 4,
+    KMSGTYPESTRUCTLONGMSG = 12,
+    KMSGTYPETEXTGIFT = 15,
+    KMSGTYPEUNKNOWN = 0,
+    KMSGTYPEVIDEO = 7,
+    KMSGTYPEWALLET = 10
+}
+
+export interface SendTaskTopMsgElement {
+    elementType: ElementType.TASKTOPMSG;
+    elementId: string;
+    taskTopMsgElement: TaskTopMsgElement;
+}
+
+export interface TofuRecordElement {
+    type: number;
+    busiid: string;
+    busiuuid: string;
+    descriptionContent: string;
+    contentlist: TofuElementContent[],
+    background: string;
+    icon: string;
+    uinlist: string[],
+    uidlist: string[],
+    busiExtra: string;
+    updateTime: string;
+    dependedmsgid: string;
+    msgtime: string;
+    onscreennotify: boolean;
+}
+
+export interface SendTofuRecordElement {
+    elementType: ElementType.TOFURECORD;
+    elementId: string;
+    tofuRecordElement: TofuRecordElement;
+}
+
+export interface FaceBubbleElement {
+    faceCount: number;
+    faceSummary: string;
+    faceFlag: number;
+    content: string;
+    oldVersionStr: string;
+    faceType: number;
+    others: string;
+    yellowFaceInfo: {
+        index: number;
+        buf: string;
+        compatibleText: string;
+        text: string;
+    };
+}
+
+export interface SendFaceBubbleElement {
+    elementType: ElementType.FACEBUBBLE;
+    elementId: string;
+    faceBubbleElement: FaceBubbleElement;
+
+}
+
+export interface AvRecordElement {
+    type: number;
+    time: string;
+    text: string;
+    mainType: number;
+    hasRead: boolean;
+    extraType: number;
+}
+
+export interface SendavRecordElement {
+    elementType: ElementType.AVRECORD;
+    elementId: string;
+    avRecordElement: AvRecordElement;
+}
+
+export interface YoloUserInfo {
+    uid: string;
+    result: number;
+    rank: number;
+    bizId: string;
+}
+
+export interface SendInlineKeyboardElement {
+    elementType: ElementType.INLINEKEYBOARD;
+    elementId: string;
+    inlineKeyboardElement: {
+        rows: number;
+        botAppid: string;
+    };
+
+}
+
+export interface YoloGameResultElement {
+    UserInfo: YoloUserInfo[];
+}
+
+export interface SendYoloGameResultElement {
+    elementType: ElementType.YOLOGAMERESULT;
+    yoloGameResultElement: YoloGameResultElement;
+}
+
+export interface GiphyElement {
+    id: string;
+    isClip: boolean;
+    width: number;
+    height: number;
+}
+
+export interface SendGiphyElement {
+    elementType: ElementType.GIPHY;
+    elementId: string;
+    giphyElement: GiphyElement;
+}
+
+export interface SendWalletElement {
+    elementType: ElementType.UNKNOWN;//不做 设置位置
+    elementId: string;
+    walletElement: Record<string, never>;
+}
+
+export interface CalendarElement {
+    summary: string;
+    msg: string;
+    expireTimeMs: string;
+    schemaType: number;
+    schema: string;
+}
+
+export interface SendCalendarElement {
+    elementType: ElementType.CALENDAR;
+    elementId: string;
+    calendarElement: CalendarElement;
+}
+
+export interface SendliveGiftElement {
+    elementType: ElementType.LIVEGIFT;
+    elementId: string;
+    liveGiftElement: Record<string, never>;
+}
+
+export interface SendTextElement {
+    elementType: ElementType.TEXT;
+    elementId: string;
+    textElement: {
+        content: string;
+        atType: number;
+        atUid: string;
+        atTinyId: string;
+        atNtUid: string;
+    };
+}
+
+export interface SendPttElement {
+    elementType: ElementType.PTT;
+    elementId: string;
+    pttElement: {
+        fileName: string;
+        filePath: string;
+        md5HexStr: string;
+        fileSize: number;
+        duration: number;  // 单位是秒
+        formatType: number;
+        voiceType: number;
+        voiceChangeType: number;
+        canConvert2Text: boolean;
+        waveAmplitudes: number[];
+        fileSubId: string;
+        playState: number;
+        autoConvertText: number;
+    };
+}
+
+export enum PicType {
+    gif = 2000,
+    jpg = 1000
+}
+
+export enum PicSubType {
+    normal = 0, // 普通图片，大图
+    face = 1  // 表情包小图
+}
+
+export enum NTMsgAtType {
+    ATTYPEALL = 1,
+    ATTYPECATEGORY = 512,
+    ATTYPECHANNEL = 16,
+    ATTYPEME = 4,
+    ATTYPEONE = 2,
+    ATTYPEONLINE = 64,
+    ATTYPEROLE = 8,
+    ATTYPESUMMON = 32,
+    ATTYPESUMMONONLINE = 128,
+    ATTYPESUMMONROLE = 256,
+    ATTYPEUNKNOWN = 0
+}
+
+export interface SendPicElement {
+    elementType: ElementType.PIC;
+    elementId: string;
+    picElement: PicElement;
+}
+
+export interface ReplyElement {
+    sourceMsgIdInRecords?: string;
+    replayMsgSeq: string;
+    replayMsgId: string;
+    senderUin: string;
+    senderUidStr?: string;
+    replyMsgTime?: string;
+    replyMsgClientSeq?: string;
+}
+
+export interface SendReplyElement {
+    elementType: ElementType.REPLY;
+    elementId: string;
+    replyElement: ReplyElement;
+}
+
+export interface SendFaceElement {
+    elementType: ElementType.FACE;
+    elementId: string;
+    faceElement: FaceElement;
+}
+
+export interface SendMarketFaceElement {
+    elementType: ElementType.MFACE;
+    marketFaceElement: MarketFaceElement;
+}
+
+export interface SendStructLongMsgElement {
+    elementType: ElementType.STRUCTLONGMSG;
+    elementId: string;
+    structLongMsgElement: StructLongMsgElement;
+}
+
+export interface StructLongMsgElement {
+    xmlContent: string;
+    resId: string;
+}
+
+export interface SendactionBarElement {
+    elementType: ElementType.ACTIONBAR;
+    elementId: string;
+    actionBarElement: {
+        rows: number;
+        botAppid: string;
+    };
+}
+
+export interface ShareLocationElement {
+    text: string;
+    ext: string;
+}
+
+export interface SendShareLocationElement {
+    elementType: ElementType.SHARELOCATION;
+    elementId: string;
+    shareLocationElement?: ShareLocationElement;
+}
+
+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: string;
+    fileElement: FileElement;
+}
+
+export interface SendVideoElement {
+    elementType: ElementType.VIDEO;
+    elementId: string;
+    videoElement: VideoElement;
+}
+
+export interface SendArkElement {
+    elementType: ElementType.ARK;
+    elementId: string;
+    arkElement: ArkElement;
+}
+
+export interface SendMarkdownElement {
+    elementType: ElementType.MARKDOWN;
+    elementId: string;
+    markdownElement: MarkdownElement;
+}
+
+export type SendMessageElement = SendTextElement | SendPttElement |
+    SendPicElement | SendReplyElement | SendFaceElement | SendMarketFaceElement | SendFileElement |
+    SendVideoElement | SendArkElement | SendMarkdownElement | SendShareLocationElement;
+
+export interface TextElement {
+    content: string;
+    atType: number;
+    atUid: string;
+    atTinyId: string;
+    atNtUid: string;
+}
+
+export interface MessageElement {
+    elementType: ElementType,
+    elementId: string,
+    extBufForUI: string,//"0x",
+    textElement?: TextElement;
+    faceElement?: FaceElement,
+    marketFaceElement?: MarketFaceElement,
+    replyElement?: ReplyElement,
+    picElement?: PicElement,
+    pttElement?: PttElement,
+    videoElement?: VideoElement,
+    grayTipElement?: GrayTipElement,
+    arkElement?: ArkElement,
+    fileElement?: FileElement,
+    liveGiftElement?: null,
+    markdownElement?: MarkdownElement,
+    structLongMsgElement?: StructLongMsgElement,
+    multiForwardMsgElement?: MultiForwardMsgElement,
+    giphyElement?: GiphyElement,
+    walletElement?: null,
+    inlineKeyboardElement?: InlineKeyboardElement,
+    textGiftElement?: null,//????
+    calendarElement?: CalendarElement,
+    yoloGameResultElement?: YoloGameResultElement,
+    avRecordElement?: AvRecordElement,
+    structMsgElement?: null,
+    faceBubbleElement?: FaceBubbleElement,
+    shareLocationElement?: ShareLocationElement,
+    tofuRecordElement?: TofuRecordElement,
+    taskTopMsgElement?: TaskTopMsgElement,
+    recommendedMsgElement?: RecommendedMsgElement,
+    actionBarElement?: ActionBarElement
+
+}
+
+export enum AtType {
+    notAt = 0,
+    atAll = 1,
+    atUser = 2
+}
+
+// 来自Android分析
+export enum ChatType {
+    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 {
+    md5HexStr?: string;
+    filePath?: string;
+    fileSize: number | string;//number
+    picWidth: number;
+    picHeight: number;
+    fileName: string;
+    sourcePath: string;
+    original: boolean;
+    picType: PicType;
+    picSubType?: PicSubType;
+    fileUuid: string;
+    fileSubId: string;
+    thumbFileSize: number;
+    summary: string;
+    thumbPath: Map<number, string>;
+    originImageMd5?: string;
+    originImageUrl?: string;  // http url, 没有host，host是https://gchat.qpic.cn/, 带download参数的是https://multimedia.nt.qq.com.cn
+}
+
+export enum NTGrayTipElementSubTypeV2 {
+    GRAYTIP_ELEMENT_SUBTYPE_AIOOP = 15,
+    GRAYTIP_ELEMENT_SUBTYPE_BLOCK = 14,
+    GRAYTIP_ELEMENT_SUBTYPE_BUDDY = 5,
+    GRAYTIP_ELEMENT_SUBTYPE_BUDDYNOTIFY = 9,
+    GRAYTIP_ELEMENT_SUBTYPE_EMOJIREPLY = 3,
+    GRAYTIP_ELEMENT_SUBTYPE_ESSENCE = 7,
+    GRAYTIP_ELEMENT_SUBTYPE_FEED = 6,
+    GRAYTIP_ELEMENT_SUBTYPE_FEEDCHANNELMSG = 11,
+    GRAYTIP_ELEMENT_SUBTYPE_FILE = 10,
+    GRAYTIP_ELEMENT_SUBTYPE_GROUP = 4,
+    GRAYTIP_ELEMENT_SUBTYPE_GROUPNOTIFY = 8,
+    GRAYTIP_ELEMENT_SUBTYPE_JSON = 17,
+    GRAYTIP_ELEMENT_SUBTYPE_LOCALMSG = 13,
+    GRAYTIP_ELEMENT_SUBTYPE_PROCLAMATION = 2,
+    GRAYTIP_ELEMENT_SUBTYPE_REVOKE = 1,
+    GRAYTIP_ELEMENT_SUBTYPE_UNKNOWN = 0,
+    GRAYTIP_ELEMENT_SUBTYPE_WALLET = 16,
+    GRAYTIP_ELEMENT_SUBTYPE_XMLMSG = 12,
+}
+
+export interface GrayTipElement {
+    subElementType: NTGrayTipElementSubTypeV2;
+    revokeElement: {
+        operatorRole: string;
+        operatorUid: string;
+        operatorNick: string;
+        operatorRemark: string;
+        operatorMemRemark?: string;
+        wording: string;  // 自定义的撤回提示语
+    };
+    aioOpGrayTipElement: TipAioOpGrayTipElement;
+    groupElement: TipGroupElement;
+    xmlElement: {
+        content: string;
+        templId: string;
+    };
+    jsonGrayTipElement: {
+        busiId?: number;
+        jsonStr: string;
+    };
+}
+
+export enum FaceType {
+    normal = 1, // 小黄脸
+    normal2 = 2, // 新小黄脸, 从faceIndex 222开始？
+    dice = 3,  // 骰子
+    poke = 5  // 拍一拍
+}
+
+export enum FaceIndex {
+    dice = 358,
+    RPS = 359  // 石头剪刀布
+}
+
+export interface FaceElement {
+    faceIndex: number;
+    faceType: FaceType;
+    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;
+}
+
+export interface VideoElement {
+    filePath: string;
+    fileName: string;
+    videoMd5?: string;
+    thumbMd5?: string;
+    fileTime?: number; // second
+    thumbSize?: number; // byte
+    fileFormat?: viedo_type;  // 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?: string;
+    fileBizId?: null;
+    originVideoMd5?: string;
+    import_rich_media_context?: null;
+    sourceVideoCodecFormat?: number;
+}
+
+// export enum busiType{
+//   public static final int CREATOR_SHARE_ADV_XWORLD = 21;
+//   public static final int MINI_APP_MINI_GAME = 11;
+//   public static final int OFFICIAL_ACCOUNT_ADV = 4;
+//   public static final int OFFICIAL_ACCOUNT_ADV_GAME = 8;
+//   public static final int OFFICIAL_ACCOUNT_ADV_SHOP = 9;
+//   public static final int OFFICIAL_ACCOUNT_ADV_VIP = 7;
+//   public static final int OFFICIAL_ACCOUNT_LAYER_MASK_ADV = 14;
+//   public static final int OFFICIAL_ACCOUNT_SPORT = 13;
+//   public static final int OFFICIAL_ACCOUNT_TIAN_QI = 10;
+//   public static final int PC_QQTAB_ADV = 18;
+//   public static final int QIQIAOBAN_SDK = 15;
+//   public static final int QQ_CPS = 16;
+//   public static final int QQ_WALLET_CPS = 17;
+//   public static final int QZONE_FEEDS = 0;
+//   public static final int QZONE_PHOTO_TAIL = 2;
+//   public static final int QZONE_VIDEO_LAYER = 1;
+//   public static final int REWARD_GIFT_ADV = 6;
+//   public static final int REWARD_GROUPGIFT_ADV = 12;
+//   public static final int REWARD_PERSONAL_ADV = 5;
+//   public static final int WEISEE_OFFICIAL_ACCOUNT = 3;
+//   public static final int X_WORLD_CREATOR_ADV = 20;
+//   public static final int X_WORLD_QZONE_LAYER = 22;
+//   public static final int X_WORLD_VIDEO_ADV = 19;
+
+// }
+// export enum CategoryBusiType {
+//   _KCateBusiTypeDefault = 0,
+//   _kCateBusiTypeFaceCluster = 1,
+//   _kCateBusiTypeLabelCluster = 4,
+//   _kCateBusiTypeMonthCluster = 16,
+//   _kCateBusiTypePoiCluster = 2,
+//   _kCateBusiTypeYearCluster = 8,
+// }
+export enum viedo_type {
+    VIDEO_FORMAT_AFS = 7,
+    VIDEO_FORMAT_AVI = 1,
+    VIDEO_FORMAT_MKV = 4,
+    VIDEO_FORMAT_MOD = 9,
+    VIDEO_FORMAT_MOV = 8,
+    VIDEO_FORMAT_MP4 = 2,
+    VIDEO_FORMAT_MTS = 11,
+    VIDEO_FORMAT_RM = 6,
+    VIDEO_FORMAT_RMVB = 5,
+    VIDEO_FORMAT_TS = 10,
+    VIDEO_FORMAT_WMV = 3,
+}
+
+export interface MarkdownElement {
+    content: string;
+}
+
+export interface InlineKeyboardElementRowButton {
+    id: string;
+    label: string;
+    visitedLabel: string;
+    style: 1; // 未知
+    type: 2; // 未知
+    clickLimit: 0;  // 未知
+    unsupportTips: string;
+    data: string;
+    atBotShowChannelList: boolean;
+    permissionType: number;
+    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
+}
+
+// public final class MemberAddShowType {
+//   public static final int KOTHERADD = 0;
+//   public static final int KOTHERADDBYOTHERQRCODE = 2;
+//   public static final int KOTHERADDBYYOURQRCODE = 3;
+//   public static final int KOTHERINVITEOTHER = 5;
+//   public static final int KOTHERINVITEYOU = 6;
+//   public static final int KYOUADD = 1;
+//   public static final int KYOUADDBYOTHERQRCODE = 4;
+//   public static final int KYOUALREADYMEMBER = 8;
+//   public static final int KYOUINVITEOTHER = 7;
+// }
+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 enum SendStatusType {
+    KSEND_STATUS_FAILED = 0,
+    KSEND_STATUS_SENDING = 1,
+    KSEND_STATUS_SUCCESS = 2,
+    KSEND_STATUS_SUCCESS_NOSEQ = 3
+}
+
+export interface RawMessage {
+    parentMsgPeer: Peer;
+
+    parentMsgIdList: string[];
+
+    /**
+     * 扩展字段，与 Ob11 msg ID 有关
+     */
+    id?: number;
+
+    guildId: string;
+
+    msgRandom: string;
+
+    msgId: string;
+
+    /**
+     * 消息时间戳（秒）
+     */
+    msgTime: string;
+
+    msgSeq: string;
+
+    msgType: NTMsgType;
+
+    subMsgType: number;
+
+    senderUid: string;
+
+    /**
+     * 发送者 QQ 号
+     */
+    senderUin: string;
+
+    /**
+     * 群号 / 用户 UID
+     */
+    peerUid: string;
+
+    /**
+     * 群号 / 用户 QQ 号
+     */
+    peerUin: string;
+
+    /**
+     * 好友备注（如果是好友消息）
+     */
+    remark?: string;
+
+    /**
+     * 群名（如果是群消息）
+     */
+    peerName: string;
+
+    /**
+     * 发送者昵称（如果是好友消息）
+     */
+    sendNickName: string;
+
+    /**
+     * 发送者好友备注（如果是群消息并且有发送者好友）
+     */
+    sendRemarkName: string;
+
+    /**
+     * 发送者群名片（如果是群消息）
+     */
+    sendMemberName?: string;
+
+    chatType: ChatType;
+
+    /**
+     * 消息状态，别人发的 2 是已撤回，自己发的 2 是已发送
+     */
+    sendStatus?: SendStatusType;
+
+    /**
+     * 撤回时间，"0" 是没有撤回
+     */
+    recallTime: string;
+
+    records: RawMessage[];
+
+    elements: MessageElement[];
+}
+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 MsgReqType {
+    peer: Peer,
+    byType: number,
+    msgId: string,
+    msgSeq: string,
+    msgTime: string,
+    clientSeq: string,
+    cnt: number,
+    queryOrder: boolean,
+    includeSelf: boolean,
+    includeDeleteMsg: boolean,
+    extraCnt: number
+}
+//getMsgsIncludeSelf Peer必须 byType 1
+//getMsgsWithMsgTimeAndClientSeqForC2C Peer必须 byType 3

src/core/entities/notify.ts

@@ -0,0 +1,143 @@
+export enum GroupNotifyMsgType {
+    UN_SPECIFIED,
+    INVITED_BY_MEMBER,
+    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 GroupNotifyMsgStatus {
+    KINIT,//初始化
+    KUNHANDLE,//未处理
+    KAGREED,//同意
+    KREFUSED,//拒绝
+    KIGNORED//忽略
+}
+
+export enum GroupInviteStatus {
+    INIT,
+    WAIT_TO_APPROVE,
+    JOINED,
+    REFUSED_BY_ADMINI_STRATOR
+}
+
+export enum GroupInviteType {
+    BYBUDDY,
+    BYGROUPMEMBER,
+    BYDISCUSSMEMBER
+}
+
+export interface GroupNotify {
+    seq: string; // 通知序列号
+    type: GroupNotifyMsgType;
+    status: GroupNotifyMsgStatus;
+    group: { groupCode: string; groupName: string };
+    user1: { uid: string; nickName: string }; // 被设置管理员的人
+    user2: { uid: string; nickName: string };  // 操作者
+    actionUser: { uid: string; nickName: string }; //未知
+    actionTime: string;
+    invitationExt: {
+        srcType: GroupInviteType;  // 邀请来源
+        groupCode: string;
+        waitStatus: GroupInviteStatus
+    };
+    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 {
+    isBuddy?: boolean;
+    isInitiator?: boolean;
+    isDecide: boolean;
+    friendUid: string;
+    reqType: BuddyReqType,
+    reqTime: string;  // 时间戳;秒
+    extWords: string;  // 申请人填写的验证消息
+    isUnread: boolean;
+    friendNick: string;
+    sourceId: number;
+    groupCode: string
+}
+
+export interface FriendRequestNotify {
+    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/core/entities/sign.ts

@@ -0,0 +1,25 @@
+export interface IdMusicSignPostData {
+    type: 'qq' | '163' | 'kugou' | 'migu' | 'kuwo',
+    id: string | number,
+}
+
+export interface CustomMusicSignPostData {
+    type: 'qq' | '163' | 'kugou' | 'migu' | 'kuwo' | 'custom',
+    id: undefined,
+    url: string,
+    audio?: string,
+    title?: string,
+    image: string,
+    singer?: string
+}
+
+export interface MiniAppLuaJsonType {
+    prompt: string,
+    title: string,
+    preview: string,
+    jumpUrl: string,
+    tag: string,
+    tagIcon: string,
+    source: string,
+    sourcelogo: string,
+}

src/core/entities/system.ts

@@ -0,0 +1,18 @@
+import { SelfInfo } from './user';
+
+export interface LineDevice {
+    instanceId: number;
+    clientType: number;
+    devUid: string;
+}
+
+export interface OBLineDevice {
+    app_id: string;
+    device_name: string;
+    device_kind: string;
+}
+
+export interface CoreCache {
+    selfInfo: SelfInfo,
+    DeviceList: OBLineDevice[]
+}

src/core/entities/user.ts

@@ -0,0 +1,322 @@
+export enum Sex {
+    male = 1,
+    female = 2,
+    unknown = 255,
+}
+
+export interface BuddyCategoryType {
+    categoryId: number;
+    categroyName: string;
+    categroyMbCount: number;
+    buddyList: User[];
+}
+
+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;
+}
+
+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;
+}
+
+
+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;
+}
+export enum BuddyListReqType {
+    KNOMAL,
+    KLETTER
+}
+interface Pic {
+    picId: string;
+    picTime: number;
+    picUrlMap: Record<string, string>;
+}
+
+interface PhotoWall {
+    picList: Pic[];
+}
+
+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;
+}
+
+export type FriendV2 = SimpleInfo;
+
+export interface SelfStatusInfo {
+    uid: string;
+    status: number;
+    extStatus: number;
+    termType: number;
+    netType: number;
+    iconType: number;
+    customStatus: any;
+    setTime: string;
+}
+
+export interface UserDetailInfoListenerArg {
+    uid: string;
+    uin: string;
+    simpleInfo: SimpleInfo;
+    commonExt: CommonExt;
+    photoWall: PhotoWall;
+}
+
+export interface ModifyProfileParams {
+    nick: string,
+    longNick: string,
+    sex: Sex,
+    birthday: { birthday_year: string, birthday_month: string, birthday_day: string },
+    location: any//undefined
+}
+
+export interface BuddyProfileLikeReq {
+    friendUids: string[];
+    basic: number;
+    vote: number;
+    favorite: number;
+    userProfile: number;
+    type: number;
+    start: number;
+    limit?: number;
+}
+
+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;
+    age?: number;
+    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 type Friend = User;
+
+// 本来是 Friend extends User  现在用不到
+
+export enum BizKey {
+    KPRIVILEGEICON,
+    KPHOTOWALL
+}
+
+export interface UserDetailInfoByUin {
+    result: number,
+    errMsg: string,
+    detail: {
+        uid: string,
+        uin: string,
+        simpleInfo: SimpleInfo,
+        commonExt: CommonExt,
+        photoWall: null
+    }
+}
+export enum UserDetailSource {
+    KDB,
+    KSERVER
+}
+
+export enum ProfileBizType {
+    KALL,
+    KBASEEXTEND,
+    KVAS,
+    KQZONE,
+    KOTHER
+}

src/core/entities/webapi.ts

@@ -0,0 +1,131 @@
+export enum WebHonorType {
+    ALL = 'all',
+    /**
+     * 群聊之火
+     */
+    TALKATIVE = 'talkative',
+    /**
+     * 群聊炽焰
+     */
+    PERFORMER = 'performer',
+    /**
+     * 龙王
+     */
+    LEGEND = 'legend',
+    /**
+     * 冒尖小春笋（R.I.P）
+     */
+    STRONG_NEWBIE = '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;
+}
+
+export 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;
+}
+
+export interface WebApiGroupNoticeFeed {
+    u: number;//发送者
+    fid: string;//fid,notice_id
+    pubt: number;//时间
+    msg: {
+        text: string
+        text_face: string
+        title: string,
+        pics?: {
+            id: string,
+            w: string,
+            h: string
+        }[]
+    };
+    type: number;
+    fn: number;
+    cn: number;
+    vn: number;
+    settings: {
+        is_show_edit_card: number
+        remind_ts: number
+        tip_window_type: number
+        confirm_required: number
+    };
+    read_num: number;
+    is_read: number;
+    is_all_confirm: number;
+}
+
+export interface WebApiGroupNoticeRet {
+    ec: number
+    em: string
+    ltsm: number
+    srv_code: number
+    read_only: number
+    role: number
+    feeds: WebApiGroupNoticeFeed[]
+    group: {
+        group_id: number
+        class_ext: number
+    }
+    sta: number,
+    gln: number
+    tst: number,
+    ui: any
+    server_time: number
+    svrt: number
+    ad: number
+}
+
+export 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
+    };
+}

src/core/external/appid.json

@@ -0,0 +1,54 @@
+{
+    "9.9.15-28060": {
+        "appid": 537246092,
+        "qua": "V1_WIN_NQ_9.9.15_28060_GW_B"
+    },
+    "9.9.15-28131": {
+        "appid": 537246092,
+        "qua": "V1_WIN_NQ_9.9.15_28131_GW_B"
+    },
+    "3.2.12-28060": {
+        "appid": 537246140,
+        "qua": "V1_LNX_NQ_3.2.12_28060_GW_B"
+    },
+    "3.2.12-28131": {
+        "appid": 537246140,
+        "qua": "V1_LNX_NQ_3.2.12_28131_GW_B"
+    },
+    "6.9.55-28131": {
+        "appid": 537246115,
+        "qua": "V1_MAC_NQ_6.9.55_28131_GW_B"
+    },
+    "9.9.15-28327": {
+        "appid": 537249321,
+        "qua": "V1_WIN_NQ_9.9.15_28327_GW_B"
+    },
+    "3.2.12-28327": {
+        "appid": 537249393,
+        "qua": "V1_LNX_NQ_3.2.12_28327_GW_B"
+    },
+    "9.9.15-28418": {
+        "appid": 537249321,
+        "qua": "V1_WIN_NQ_9.9.15_28418_GW_B"
+    },
+    "3.2.12-28418": {
+        "appid": 537249393,
+        "qua": "V1_LNX_NQ_3.2.12_28418_GW_B"
+    },
+    "6.9.56-28418": {
+        "appid": 537249367,
+        "qua": "V1_MAC_NQ_6.9.56_28418_GW_B"
+    },
+    "9.9.15-28498": {
+        "appid": 537249321,
+        "qua": "V1_WIN_NQ_9.9.15_28498_GW_B"
+    },
+    "3.2.13-28788": {
+        "appid": 537249787,
+        "qua": "V1_LNX_NQ_3.2.13_28788_GW_B"
+    },
+    "9.9.16-28788": {
+        "appid": 537249739,
+        "qua": "V1_WIN_NQ_9.9.16_28788_GW_B"
+    }
+}

src/core/external/napcat.json

@@ -0,0 +1,7 @@
+{
+    "fileLog": true,
+    "consoleLog": true,
+    "fileLogLevel": "debug",
+    "consoleLogLevel": "info",
+    "packetServer": ""
+}

src/core/external/offset.json

@@ -0,0 +1,22 @@
+{
+    "3.2.12-28418-x64": {
+        "recv": "A0723E0",
+        "send": "A06EAE0"
+    },
+    "9.9.15-28418-x64": {
+        "recv": "37A9004",
+        "send": "37A4BD0"
+    },
+    "9.9.15-28498-x64": {
+        "recv": "37A9004",
+        "send": "37A4BD0"
+    },
+    "9.9.16-28788-x64": {
+        "send": "38076D0",
+        "recv": "380BB04"
+    },
+    "3.2.13-28788-x64": {
+        "send": "A0CEC20",
+        "recv": "A0D2520"
+    }
+}

src/core/external/proto/EmojiLikeToOthers.proto

@@ -0,0 +1,31 @@
+syntax = 'proto3';
+package SysMessage;
+
+message EmojiLikeToOthersWrapper1 {
+  EmojiLikeToOthersWrapper2 wrapper = 1;
+}
+
+message EmojiLikeToOthersWrapper2 {
+  EmojiLikeToOthersWrapper3 body = 1;
+}
+
+message EmojiLikeToOthersWrapper3 {
+  EmojiLikeToOthersMsgSpec msgSpec = 2;
+  EmojiLikeToOthersAttributes attributes = 3;
+}
+
+message EmojiLikeToOthersMsgSpec {
+  uint32 msgSeq = 1;
+}
+
+message EmojiLikeToOthersAttributes {
+  enum Operation {
+    FALLBACK = 0;
+    LIKE = 1;
+    UNLIKE = 2;
+  }
+
+  string emojiId = 1;
+  string senderUid = 4;
+  Operation operation = 5;
+}

src/core/external/proto/GreyTipWrapper.proto

@@ -0,0 +1,9 @@
+syntax = 'proto3';
+package SysMessage;
+
+message GreyTipWrapper {
+  uint32 subTypeId = 1;
+  uint32 groupCode = 4;
+  uint32 subTypeIdMinusOne = 13;
+  bytes rest = 44;
+}

src/core/external/proto/ProfileLikeTip.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+package SysMessage;
+
+message likeDetail {
+    string txt = 1;
+    int64 uin = 3;
+    string nickname = 5;
+}
+
+message likeMsg {
+    int32 times = 1;
+    int32 time = 2;
+    likeDetail detail = 3;
+}
+
+message profileLikeTip {
+    likeMsg msg = 14;
+}

src/core/external/proto/SysMessage.proto

@@ -0,0 +1,36 @@
+syntax = 'proto3';
+package SysMessage;
+
+message SysMessage {
+  repeated SysMessageHeader header = 1;
+  repeated SysMessageMsgSpec msgSpec = 2;
+  SysMessageBodyWrapper bodyWrapper = 3;
+}
+
+message SysMessageHeader {
+  uint32 PeerNumber = 1;
+  string PeerString = 2;
+  uint32 Uin = 5;
+  optional string Uid = 6;
+}
+
+message SysMessageMsgSpec {
+  uint32 msgType = 1;
+  uint32 subType = 2;
+  uint32 subSubType = 3;
+  uint32 msgSeq = 5;
+  uint32 time = 6;
+  uint64 msgId = 12;
+  uint32 other = 13;
+}
+
+message SysMessageBodyWrapper {
+  bytes wrappedBody = 2;
+  // Find the first [08], or ignore the first 7 bytes?
+  // And it becomes another ProtoBuf message.
+}
+
+message KeyValuePair {
+  string key = 1;
+  string value = 2;
+}

src/core/helper/config.ts

@@ -0,0 +1,11 @@
+import { ConfigBase } from '@/common/config-base';
+import napCatDefaultConfig from '@/core/external/napcat.json';
+import { NapCatCore } from '@/core';
+
+export type NapCatConfig = typeof napCatDefaultConfig;
+
+export class NapCatConfigLoader extends ConfigBase<NapCatConfig> {
+    constructor(core: NapCatCore, configPath: string) {
+        super('napcat', core, configPath);
+    }
+}

src/core/helper/rkey.ts

@@ -0,0 +1,62 @@
+import { LogWrapper } from '@/common/log';
+import { RequestUtil } from '@/common/request';
+
+interface ServerRkeyData {
+    group_rkey: string;
+    private_rkey: string;
+    expired_time: number;
+}
+
+export class RkeyManager {
+    serverUrl: string[] = [];
+    logger: LogWrapper;
+    private rkeyData: ServerRkeyData = {
+        group_rkey: '',
+        private_rkey: '',
+        expired_time: 0,
+    };
+
+    constructor(serverUrl: string[], logger: LogWrapper) {
+        this.logger = logger;
+        this.serverUrl = serverUrl;
+    }
+
+    async getRkey() {
+        if (this.isExpired()) {
+            try {
+                await this.refreshRkey();
+            } catch (e) {
+                throw new Error(`获取rkey失败: ${e}`);//外抛
+                //this.logger.logError.bind(this.logger)('获取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
+        for (const url of this.serverUrl) {
+            try {
+                const temp = await RequestUtil.HttpGetJson<ServerRkeyData>(url, 'GET');
+                this.rkeyData = {
+                    group_rkey: temp.group_rkey.slice(6),
+                    private_rkey: temp.private_rkey.slice(6),
+                    expired_time: temp.expired_time
+                };
+            } catch (e) {
+                this.logger.logError.bind(this.logger)(`[Rkey] Get Rkey ${url} Error `, e);
+                //是否为最后一个url
+                if (url === this.serverUrl[this.serverUrl.length - 1]) {
+                    throw new Error(`获取rkey失败: ${e}`);//外抛
+                }
+            }
+        }
+
+    }
+}

src/core/index.ts

@@ -0,0 +1,334 @@
+import {
+    NTQQFileApi,
+    NTQQFriendApi,
+    NTQQGroupApi,
+    NTQQMsgApi,
+    NTQQSystemApi,
+    NTQQUserApi,
+    NTQQWebApi,
+} from '@/core/apis';
+import { NTQQCollectionApi } from '@/core/apis/collection';
+import {
+    NodeIQQNTWrapperSession,
+    NodeQQNTWrapperUtil,
+    PlatformType,
+    VendorType,
+    WrapperNodeApi,
+    WrapperSessionInitConfig,
+} from '@/core/wrapper';
+import { LogLevel, LogWrapper } from '@/common/log';
+import { NodeIKernelLoginService } from '@/core/services';
+import { QQBasicInfoWrapper } from '@/common/qq-basic-info';
+import { NapCatPathWrapper } from '@/common/path';
+import path from 'node:path';
+import fs from 'node:fs';
+import { hostname, systemName, systemVersion } from '@/common/system';
+import { NTEventWrapper } from '@/common/event';
+import { DataSource, GroupMember, KickedOffLineInfo, SelfInfo, SelfStatusInfo } from '@/core/entities';
+import { NapCatConfigLoader } from '@/core/helper/config';
+import os from 'node:os';
+import { NodeIKernelGroupListener, NodeIKernelMsgListener, NodeIKernelProfileListener } from '@/core/listeners';
+import { proxiedListenerOf } from '@/common/proxy-handler';
+import { NTQQPacketApi } from './apis/packet';
+export * from './wrapper';
+export * from './entities';
+export * from './services';
+export * from './listeners';
+
+export enum NapCatCoreWorkingEnv {
+    Unknown = 0,
+    Shell = 1,
+    Framework = 2,
+}
+
+export function loadQQWrapper(QQVersion: string): WrapperNodeApi {
+    let appPath;
+    if (os.platform() === 'darwin') {
+        appPath = path.resolve(path.dirname(process.execPath), '../Resources/app');
+    } else if (os.platform() === 'linux') {
+        appPath = path.resolve(path.dirname(process.execPath), './resources/app');
+    } else {
+        appPath = path.resolve(path.dirname(process.execPath), `./versions/${QQVersion}/`);
+    }
+    let wrapperNodePath = path.resolve(appPath, 'wrapper.node');
+    if (!fs.existsSync(wrapperNodePath)) {
+        wrapperNodePath = path.join(appPath, `./resources/app/wrapper.node`);
+    }
+    //老版本兼容 未来去掉
+    if (!fs.existsSync(wrapperNodePath)) {
+        wrapperNodePath = path.join(path.dirname(process.execPath), `./resources/app/versions/${QQVersion}/wrapper.node`);
+    }
+    const nativemodule: any = { exports: {} };
+    process.dlopen(nativemodule, wrapperNodePath);
+    return nativemodule.exports;
+}
+
+export class NapCatCore {
+    readonly context: InstanceContext;
+    readonly apis: StableNTApiWrapper;
+    readonly eventWrapper: NTEventWrapper;
+    // readonly eventChannel: NTEventChannel;
+    NapCatDataPath: string;
+    NapCatTempPath: string;
+    // runtime info, not readonly
+    selfInfo: SelfInfo;
+    util: NodeQQNTWrapperUtil;
+    configLoader: NapCatConfigLoader;
+
+    // 通过构造器递过去的 runtime info 应该尽量少
+    constructor(context: InstanceContext, selfInfo: SelfInfo) {
+        this.selfInfo = selfInfo;
+        this.context = context;
+        this.util = this.context.wrapper.NodeQQNTWrapperUtil;
+        this.eventWrapper = new NTEventWrapper(context.session);
+        this.configLoader = new NapCatConfigLoader(this, this.context.pathWrapper.configPath);
+        this.apis = {
+            FileApi: new NTQQFileApi(this.context, this),
+            SystemApi: new NTQQSystemApi(this.context, this),
+            CollectionApi: new NTQQCollectionApi(this.context, this),
+            PacketApi: new NTQQPacketApi(this.context, this),
+            WebApi: new NTQQWebApi(this.context, this),
+            FriendApi: new NTQQFriendApi(this.context, this),
+            MsgApi: new NTQQMsgApi(this.context, this),
+            UserApi: new NTQQUserApi(this.context, this),
+            GroupApi: new NTQQGroupApi(this.context, this),
+        };
+        this.NapCatDataPath = path.join(this.dataPath, 'NapCat');
+        fs.mkdirSync(this.NapCatDataPath, { recursive: true });
+        this.NapCatTempPath = path.join(this.NapCatDataPath, 'temp');
+        // 创建临时目录
+        if (!fs.existsSync(this.NapCatTempPath)) {
+            fs.mkdirSync(this.NapCatTempPath, { recursive: true });
+        }
+       
+        this.initNapCatCoreListeners().then().catch(this.context.logger.logError.bind(this.context.logger));
+
+        this.context.logger.setFileLogEnabled(
+            this.configLoader.configData.fileLog,
+        );
+        this.context.logger.setConsoleLogEnabled(
+            this.configLoader.configData.consoleLog,
+        );
+        this.context.logger.setFileAndConsoleLogLevel(
+            this.configLoader.configData.fileLogLevel as LogLevel,
+            this.configLoader.configData.consoleLogLevel as LogLevel,
+        );
+    }
+
+    get dataPath(): string {
+        let result = this.context.wrapper.NodeQQNTWrapperUtil.getNTUserDataInfoConfig();
+        if (!result) {
+            result = path.resolve(os.homedir(), './.config/QQ');
+            fs.mkdirSync(result, { recursive: true });
+        }
+        return result;
+    }
+
+    // Renamed from 'InitDataListener'
+    async initNapCatCoreListeners() {
+        const msgListener = new NodeIKernelMsgListener();
+        msgListener.onKickedOffLine = (Info: KickedOffLineInfo) => {
+            // 下线通知
+            this.context.logger.logError.bind(this.context.logger)('[KickedOffLine] [' + Info.tipsTitle + '] ' + Info.tipsDesc);
+            this.selfInfo.online = false;
+        };
+        msgListener.onRecvMsg = (msgs) => {
+            msgs.forEach(msg => this.context.logger.logMessage(msg, this.selfInfo));
+        };
+        msgListener.onAddSendMsg = (msg) => {
+            this.context.logger.logMessage(msg, this.selfInfo);
+        };
+        //await sleep(2500);
+        this.context.session.getMsgService().addKernelMsgListener(
+            proxiedListenerOf(msgListener, this.context.logger) as any,
+        );
+
+        const profileListener = new NodeIKernelProfileListener();
+        profileListener.onProfileDetailInfoChanged = (profile) => {
+            if (profile.uid === this.selfInfo.uid) {
+                Object.assign(this.selfInfo, profile);
+            }
+        };
+        profileListener.onSelfStatusChanged = (Info: SelfStatusInfo) => {
+            if (Info.status == 20) {
+                this.selfInfo.online = false;
+                this.context.logger.log("账号状态变更为离线");
+            } else {
+                this.selfInfo.online = true;
+            }
+        };
+        this.context.session.getProfileService().addKernelProfileListener(
+            proxiedListenerOf(profileListener, this.context.logger),
+        );
+
+        // 群相关
+        const groupListener = new NodeIKernelGroupListener();
+        groupListener.onGroupListUpdate = (updateType, groupList) => {
+            // console.log("onGroupListUpdate", updateType, groupList)
+            groupList.map(g => {
+                const existGroup = this.apis.GroupApi.groupCache.get(g.groupCode);
+                //群成员数量变化 应该刷新缓存
+                if (existGroup && g.memberCount === existGroup.memberCount) {
+                    Object.assign(existGroup, g);
+                } else {
+                    this.apis.GroupApi.groupCache.set(g.groupCode, g);
+                    // 获取群成员
+                }
+                const sceneId = this.context.session.getGroupService().createMemberListScene(g.groupCode, 'groupMemberList_MainWindow');
+                this.context.session.getGroupService().getNextMemberList(sceneId, undefined, 3000).then( /* r => {
+                    // console.log(`get group ${g.groupCode} members`, r);
+                    // r.result.infos.forEach(member => {
+                    // });
+                    // groupMembers.set(g.groupCode, r.result.infos);
+                } */);
+                this.context.session.getGroupService().destroyMemberListScene(sceneId);
+            });
+        };
+        groupListener.onMemberListChange = (arg) => {
+            // todo: 应该加一个内部自己维护的成员变动callback，用于判断成员变化通知
+            const groupCode = arg.sceneId.split('_')[0];
+            if (this.apis.GroupApi.groupMemberCache.has(groupCode)) {
+                const existMembers = this.apis.GroupApi.groupMemberCache.get(groupCode)!;
+                arg.infos.forEach((member, uid) => {
+                    //console.log('onMemberListChange', member);
+                    const existMember = existMembers.get(uid);
+                    if (existMember) {
+                        Object.assign(existMember, member);
+                    } else {
+                        existMembers!.set(uid, member);
+                    }
+                    //移除成员
+                    if (member.isDelete) {
+                        existMembers.delete(uid);
+                    }
+                });
+            } else {
+                this.apis.GroupApi.groupMemberCache.set(groupCode, arg.infos);
+            }
+        };
+        groupListener.onMemberInfoChange = (groupCode, dataSource, members) => {
+            if (dataSource === DataSource.LOCAL && members.get(this.selfInfo.uid)?.isDelete) {
+                // 自身退群或者被踢退群 5s用于Api操作 之后不再出现
+                setTimeout(() => {
+                    this.apis.GroupApi.groupCache.delete(groupCode);
+                }, 5000);
+
+            }
+            const existMembers = this.apis.GroupApi.groupMemberCache.get(groupCode);
+            if (existMembers) {
+                members.forEach((member, uid) => {
+                    const existMember = existMembers.get(uid);
+                    if (existMember) {
+                        // 检查管理变动
+                        member.isChangeRole = this.checkAdminEvent(groupCode, member, existMember);
+                        // 更新成员信息
+                        Object.assign(existMember, member);
+                    } else {
+                        existMembers.set(uid, member);
+                    }
+                    //移除成员
+                    if (member.isDelete) {
+                        existMembers.delete(uid);
+                    }
+                });
+            } else {
+                this.apis.GroupApi.groupMemberCache.set(groupCode, members);
+            }
+        };
+        this.context.session.getGroupService().addKernelGroupListener(
+            proxiedListenerOf(groupListener, this.context.logger) as any,
+        );
+    }
+
+    checkAdminEvent(groupCode: string, memberNew: GroupMember, memberOld: GroupMember | undefined): boolean {
+        if (memberNew.role !== memberOld?.role) {
+            this.context.logger.logDebug(`群 ${groupCode} ${memberNew.nick} 角色变更为 ${memberNew.role === 3 ? '管理员' : '群员'}`);
+            return true;
+        }
+        return false;
+    }
+}
+
+export async function genSessionConfig(
+    guid: string,
+    QQVersionAppid: string,
+    QQVersion: string,
+    selfUin: string,
+    selfUid: string,
+    account_path: string
+): Promise<WrapperSessionInitConfig> {
+    const downloadPath = path.join(account_path, 'NapCat', 'temp');
+    fs.mkdirSync(downloadPath, { recursive: true });
+    const platformMapping: Partial<Record<NodeJS.Platform, PlatformType>> = {
+        win32: PlatformType.KWINDOWS,
+        darwin: PlatformType.KMAC,
+        linux: PlatformType.KLINUX,
+    };
+    const systemPlatform = platformMapping[os.platform()] ?? PlatformType.KWINDOWS;
+    return {
+        selfUin,
+        selfUid,
+        desktopPathConfig: {
+            account_path, // 可以通过NodeQQNTWrapperUtil().getNTUserDataInfoConfig()获取
+        },
+        clientVer: QQVersion,
+        a2: '',
+        d2: '',
+        d2Key: '',
+        machineId: '',
+        platform: systemPlatform,  // 3是Windows? 
+        platVer: systemVersion,  // 系统版本号, 应该可以固定
+        appid: QQVersionAppid,
+        rdeliveryConfig: {
+            appKey: '',
+            systemId: 0,
+            appId: '',
+            logicEnvironment: '',
+            platform: systemPlatform,
+            language: '',
+            sdkVersion: '',
+            userId: '',
+            appVersion: '',
+            osVersion: '',
+            bundleId: '',
+            serverUrl: '',
+            fixedAfterHitKeys: [''],
+        },
+        defaultFileDownloadPath: downloadPath,
+        deviceInfo: {
+            guid,
+            buildVer: QQVersion,
+            localId: 2052,
+            devName: hostname,
+            devType: systemName,
+            vendorName: '',
+            osVer: systemVersion,
+            vendorOsName: systemName,
+            setMute: false,
+            vendorType: VendorType.KNOSETONIOS,
+        },
+        deviceConfig: '{"appearance":{"isSplitViewMode":true},"msg":{}}',
+    };
+}
+
+export interface InstanceContext {
+    readonly workingEnv: NapCatCoreWorkingEnv;
+    readonly wrapper: WrapperNodeApi;
+    readonly session: NodeIQQNTWrapperSession;
+    readonly logger: LogWrapper;
+    readonly loginService: NodeIKernelLoginService;
+    readonly basicInfoWrapper: QQBasicInfoWrapper;
+    readonly pathWrapper: NapCatPathWrapper;
+}
+
+export interface StableNTApiWrapper {
+    FileApi: NTQQFileApi,
+    SystemApi: NTQQSystemApi,
+    PacketApi: NTQQPacketApi,
+    CollectionApi: NTQQCollectionApi,
+    WebApi: NTQQWebApi,
+    FriendApi: NTQQFriendApi,
+    MsgApi: NTQQMsgApi,
+    UserApi: NTQQUserApi,
+    GroupApi: NTQQGroupApi
+}

src/core/listeners/NodeIKernelBuddyListener.ts

@@ -0,0 +1,59 @@
+import { BuddyCategoryType, FriendRequestNotify } from '@/core/entities';
+
+export type OnBuddyChangeParams = BuddyCategoryType[];
+
+export class NodeIKernelBuddyListener {
+    onBuddyListChangedV2(arg: unknown): void {
+    }
+
+    onAddBuddyNeedVerify(arg: unknown) {
+    }
+
+    onAddMeSettingChanged(arg: unknown) {
+    }
+
+    onAvatarUrlUpdated(arg: unknown) {
+    }
+
+    onBlockChanged(arg: unknown) {
+    }
+
+    onBuddyDetailInfoChange(arg: unknown) {
+    }
+
+    onBuddyInfoChange(arg: unknown) {
+    }
+
+    onBuddyListChange(arg: OnBuddyChangeParams): void {
+    }
+
+    onBuddyRemarkUpdated(arg: unknown): void {
+    }
+
+    onBuddyReqChange(arg: FriendRequestNotify): void {
+    }
+
+    onBuddyReqUnreadCntChange(arg: unknown): void {
+    }
+
+    onCheckBuddySettingResult(arg: unknown): void {
+    }
+
+    onDelBatchBuddyInfos(arg: unknown): void {
+    }
+
+    onDoubtBuddyReqChange(arg: unknown): void {
+    }
+
+    onDoubtBuddyReqUnreadNumChange(arg: unknown): void {
+    }
+
+    onNickUpdated(arg: unknown): void {
+    }
+
+    onSmartInfos(arg: unknown): void {
+    }
+
+    onSpacePermissionInfos(arg: unknown): void {
+    }
+}

src/core/listeners/NodeIKernelFileAssistantListener.ts

@@ -0,0 +1,60 @@
+export class NodeIKernelFileAssistantListener {
+    onFileStatusChanged(fileStatus: {
+        id: string,
+        fileStatus: number,
+        fileProgress: `${number}`,
+        fileSize: `${number}`,
+        fileSpeed: number,
+        thumbPath: string | null,
+        filePath: string | null,
+    }) {
+    }
+
+    onSessionListChanged(...args: unknown[]) {
+    }
+
+    onSessionChanged(...args: unknown[]) {
+    }
+
+    onFileListChanged(...args: unknown[]) {
+    }
+
+    onFileSearch(searchResult: SearchResultWrapper) {
+    }
+}
+
+export type SearchResultWrapper = {
+    searchId: number,
+    resultId: number,
+    hasMore: boolean,
+    resultItems: SearchResultItem[],
+};
+
+export type SearchResultItem = {
+    id: string,
+    fileName: string,
+    fileNameHits: string[],
+    fileStatus: number,
+    fileSize: string,
+    isSend: boolean,
+    source: number,
+    fileTime: string,
+    expTime: string,
+    session: {
+        context: null,
+        uid: string,
+        nick: string,
+        remark: string,
+        memberCard: string,
+        groupCode: string,
+        groupName: string,
+        groupRemark: string,
+        count: number,
+    },
+    thumbPath: string,
+    filePath: string,
+    msgId: string,
+    chatType: number,
+    peerUid: string,
+    fileType: number,
+};

src/core/listeners/NodeIKernelGroupListener.ts

@@ -0,0 +1,84 @@
+import { DataSource, Group, GroupListUpdateType, GroupMember, GroupNotify } from '@/core/entities';
+
+export class NodeIKernelGroupListener {
+    onGroupListInited(listEmpty: boolean): void { }
+    // 发现于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, dateSource: DataSource, 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[]) {
+    }
+}

src/core/listeners/NodeIKernelLoginListener.ts

@@ -0,0 +1,67 @@
+export class NodeIKernelLoginListener {
+    onLoginConnected(...args: any[]): void {
+    }
+
+    onLoginDisConnected(...args: any[]): void {
+    }
+
+    onLoginConnecting(...args: any[]): void {
+    }
+
+    onQRCodeGetPicture(arg: { pngBase64QrcodeData: string, qrcodeUrl: string }): void {
+        // let base64Data: string = arg.pngBase64QrcodeData
+        // base64Data = base64Data.split("data:image/png;base64,")[1]
+        // let buffer = Buffer.from(base64Data, 'base64')
+        // console.log("onQRCodeGetPicture", arg);
+    }
+
+    onQRCodeLoginPollingStarted(...args: any[]): void {
+    }
+
+    onQRCodeSessionUserScaned(...args: any[]): void {
+    }
+
+    onQRCodeLoginSucceed(arg: QRCodeLoginSucceedResult): void {
+    }
+
+    onQRCodeSessionFailed(...args: any[]): void {
+    }
+
+    onLoginFailed(...args: any[]): void {
+    }
+
+    onLogoutSucceed(...args: any[]): void {
+    }
+
+    onLogoutFailed(...args: any[]): void {
+    }
+
+    onUserLoggedIn(...args: any[]): void {
+    }
+
+    onQRCodeSessionQuickLoginFailed(...args: any[]): void {
+    }
+
+    onPasswordLoginFailed(...args: any[]): void {
+    }
+
+    OnConfirmUnusualDeviceFailed(...args: any[]): void {
+    }
+
+    onQQLoginNumLimited(...args: any[]): void {
+    }
+
+    onLoginState(...args: any[]): void {
+    }
+}
+
+export interface QRCodeLoginSucceedResult {
+    account: string;
+    mainAccount: string;
+    uin: string; //拿UIN
+    uid: string; //拿UID
+    nickName: string; //一般是空的 拿不到
+    gender: number;
+    age: number;
+    faceUrl: string;//一般是空的 拿不到
+}

src/core/listeners/NodeIKernelMsgListener.ts

@@ -0,0 +1,383 @@
+import { ChatType, RawMessage } from '@/core/entities';
+import { CommonFileInfo } from '@/core';
+
+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?: CommonFileInfo,
+    fileSrvErrCode: string,
+    clientMsg: string,
+    businessId: number,
+    userTotalSpacePerDay: unknown | null,
+    userUsedSpacePerDay: unknown | null
+}
+
+export interface GroupFileInfoUpdateParamType {
+    retCode: number;
+    retMsg: string;
+    clientWording: string;
+    isEnd: boolean;
+    item: Array<{
+        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: string;
+    nextIndex: string;
+    reqId: string;
+}
+
+// {
+//   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 class NodeIKernelMsgListener {
+    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: GroupFileInfoUpdateParamType) {
+
+    }
+
+    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: {
+        chatType: number;
+        eventType: number;
+        fromUin: string;
+        interval: string;
+        showTime: string;
+        statusText: string;
+        timestamp: string;
+        toUin: string;
+    }) {
+
+    }
+
+    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: Array<number>) {
+
+    }
+
+    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/core/listeners/NodeIKernelProfileListener.ts

@@ -0,0 +1,71 @@
+import { User, UserDetailInfoListenerArg } from '@/core/entities';
+
+export class NodeIKernelProfileListener {
+    onUserDetailInfoChanged(arg: UserDetailInfoListenerArg): void {
+
+    }
+
+    onProfileSimpleChanged(...args: unknown[]) {
+
+    }
+
+    onProfileDetailInfoChanged(profile: User) {
+
+    }
+
+    onStatusUpdate(...args: unknown[]) {
+
+    }
+
+    onSelfStatusChanged(...args: unknown[]) {
+
+    }
+
+    onStrangerRemarkChanged(...args: unknown[]) {
+
+    }
+
+    onMemberListChange(...args: unknown[]) {
+
+    }
+
+    onMemberInfoChange(...args: unknown[]) {
+
+    }
+
+    onGroupListUpdate(...args: unknown[]) {
+
+    }
+
+    onGroupAllInfoChange(...args: unknown[]) {
+
+    }
+
+    onGroupDetailInfoChange(...args: unknown[]) {
+
+    }
+
+    onGroupConfMemberChange(...args: unknown[]) {
+
+    }
+
+    onGroupExtListUpdate(...args: unknown[]) {
+
+    }
+
+    onGroupNotifiesUpdated(...args: unknown[]) {
+
+    }
+
+    onGroupNotifiesUnreadCountUpdated(...args: unknown[]) {
+
+    }
+
+    onGroupMemberLevelInfoChange(...args: unknown[]) {
+
+    }
+
+    onGroupBulletinChange(...args: unknown[]) {
+
+    }
+}

src/core/listeners/NodeIKernelRecentContactListener.ts

@@ -0,0 +1,25 @@
+export class NodeIKernelRecentContactListener {
+    onDeletedContactsNotify(...args: unknown[]) {
+
+    }
+
+    onRecentContactNotification(msgList: any, arg0: { msgListUnreadCnt: string }, arg1: number) {
+
+    }
+
+    onMsgUnreadCountUpdate(...args: unknown[]) {
+
+    }
+
+    onGuildDisplayRecentContactListChanged(...args: unknown[]) {
+
+    }
+
+    onRecentContactListChanged(...args: unknown[]) {
+
+    }
+
+    onRecentContactListChangedVer2(...args: unknown[]) {
+
+    }
+}

src/core/listeners/NodeIKernelRobotListener.ts

@@ -0,0 +1,13 @@
+export class NodeIKernelRobotListener {
+    onRobotFriendListChanged(...args: unknown[]) {
+
+    }
+
+    onRobotListChanged(...args: unknown[]) {
+
+    }
+
+    onRobotProfileChanged(...args: unknown[]) {
+
+    }
+}

src/core/listeners/NodeIKernelSearchListener.ts

@@ -0,0 +1,97 @@
+import { ChatType } from '@/core';
+export interface SearchGroupInfo {
+    groupCode: string;
+    ownerUid: string;
+    groupFlag: number;
+    groupFlagExt: number;
+    maxMemberNum: number;
+    memberNum: number;
+    groupOption: number;
+    classExt: number;
+    groupName: string;
+    fingerMemo: string;
+    groupQuestion: string;
+    certType: number;
+    shutUpAllTimestamp: number;
+    shutUpMeTimestamp: number;
+    groupTypeFlag: number;
+    privilegeFlag: number;
+    groupSecLevel: number;
+    groupFlagExt3: number;
+    isConfGroup: number;
+    isModifyConfGroupFace: number;
+    isModifyConfGroupName: number;
+    noFigerOpenFlag: number;
+    noCodeFingerOpenFlag: number;
+    groupFlagExt4: number;
+    groupMemo: string;
+    cmdUinMsgSeq: number;
+    cmdUinJoinTime: number;
+    cmdUinUinFlag: number;
+    cmdUinMsgMask: number;
+    groupSecLevelInfo: number;
+    cmdUinPrivilege: number;
+    cmdUinFlagEx2: number;
+    appealDeadline: number;
+    remarkName: string;
+    isTop: boolean;
+    richFingerMemo: string;
+    groupAnswer: string;
+    joinGroupAuth: string;
+    isAllowModifyConfGroupName: number;
+}
+
+export interface GroupInfo {
+    groupCode: string;
+    searchGroupInfo: SearchGroupInfo;
+    privilege: number;
+}
+
+export interface GroupSearchResult {
+    keyWord: string;
+    errorCode: number;
+    groupInfos: GroupInfo[];
+    penetrate: string;
+    isEnd: boolean;
+    nextPos: number;
+}
+export interface NodeIKernelSearchListener {
+    
+    onSearchGroupResult(params: GroupSearchResult): void;
+
+    onSearchFileKeywordsResult(params: {
+        searchId: string,
+        hasMore: boolean,
+        resultItems: {
+            chatType: ChatType,
+            buddyChatInfo: any[],
+            discussChatInfo: any[],
+            groupChatInfo: {
+                groupCode: string,
+                isConf: boolean,
+                hasModifyConfGroupFace: boolean,
+                hasModifyConfGroupName: boolean,
+                groupName: string,
+                remark: string
+            }[],
+            dataLineChatInfo: any[],
+            tmpChatInfo: any[],
+            msgId: string,
+            msgSeq: string,
+            msgTime: string,
+            senderUid: string,
+            senderNick: string,
+            senderRemark: string,
+            senderCard: string,
+            elemId: string,
+            elemType: number,
+            fileSize: string,
+            filePath: string,
+            fileName: string,
+            hits: {
+                start: number,
+                end: number
+            }[]
+        }[]
+    }): void;
+}

src/core/listeners/NodeIKernelSessionListener.ts

@@ -0,0 +1,25 @@
+export class NodeIKernelSessionListener {
+    onNTSessionCreate(args: unknown) {
+
+    }
+
+    onGProSessionCreate(args: unknown) {
+
+    }
+
+    onSessionInitComplete(args: unknown) {
+
+    }
+
+    onOpentelemetryInit(args: unknown) {
+
+    }
+
+    onUserOnlineResult(args: unknown) {
+
+    }
+
+    onGetSelfTinyId(args: unknown) {
+
+    }
+}

src/core/listeners/NodeIKernelStorageCleanListener.ts

@@ -0,0 +1,21 @@
+export class NodeIKernelStorageCleanListener {
+    onCleanCacheProgressChanged(args: unknown) {
+
+    }
+
+    onScanCacheProgressChanged(args: unknown) {
+
+    }
+
+    onCleanCacheStorageChanged(args: unknown) {
+
+    }
+
+    onFinishScan(args: unknown) {
+
+    }
+
+    onChatCleanDone(args: unknown) {
+
+    }
+}

src/core/listeners/NodeIKernelTicketListener.ts

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

src/core/listeners/NodeIO3MiscListener.ts

@@ -0,0 +1,5 @@
+export class NodeIO3MiscListener {
+    getOnAmgomDataPiece(...arg: unknown[]) {
+
+    }
+}

src/core/listeners/index.ts

@@ -0,0 +1,40 @@
+export * from './NodeIKernelSessionListener';
+export * from './NodeIKernelLoginListener';
+export * from './NodeIKernelMsgListener';
+export * from './NodeIKernelGroupListener';
+export * from './NodeIKernelBuddyListener';
+export * from './NodeIKernelProfileListener';
+export * from './NodeIKernelRobotListener';
+export * from './NodeIKernelProfileListener';
+export * from './NodeIKernelTicketListener';
+export * from './NodeIKernelStorageCleanListener';
+export * from './NodeIKernelFileAssistantListener';
+export * from './NodeIKernelSearchListener';
+
+import type {
+    NodeIKernelBuddyListener,
+    NodeIKernelFileAssistantListener,
+    NodeIKernelGroupListener,
+    NodeIKernelLoginListener,
+    NodeIKernelMsgListener,
+    NodeIKernelProfileListener,
+    NodeIKernelRobotListener,
+    NodeIKernelSessionListener,
+    NodeIKernelStorageCleanListener,
+    NodeIKernelTicketListener,
+} from '.';
+import { NodeIKernelSearchListener } from './NodeIKernelSearchListener';
+
+export type ListenerNamingMapping = {
+    NodeIKernelSessionListener: NodeIKernelSessionListener;
+    NodeIKernelLoginListener: NodeIKernelLoginListener;
+    NodeIKernelMsgListener: NodeIKernelMsgListener;
+    NodeIKernelGroupListener: NodeIKernelGroupListener;
+    NodeIKernelBuddyListener: NodeIKernelBuddyListener;
+    NodeIKernelProfileListener: NodeIKernelProfileListener;
+    NodeIKernelRobotListener: NodeIKernelRobotListener;
+    NodeIKernelTicketListener: NodeIKernelTicketListener;
+    NodeIKernelStorageCleanListener: NodeIKernelStorageCleanListener;
+    NodeIKernelFileAssistantListener: NodeIKernelFileAssistantListener;
+    NodeIKernelSearchListener: NodeIKernelSearchListener;
+};

src/core/packet/client.ts

@@ -0,0 +1,179 @@
+import { LogWrapper } from "@/common/log";
+import { LRUCache } from "@/common/lru-cache";
+import WebSocket, { Data } from "ws";
+import crypto, { createHash } from "crypto";
+import { NapCatCore } from "@/core";
+import { PacketHexStr } from "@/core/packet/packer";
+import { sleep } from "@/common/helper";
+
+export interface RecvPacket {
+    type: string, // 仅recv
+    trace_id_md5?: string,
+    data: RecvPacketData
+}
+
+export interface RecvPacketData {
+    seq: number
+    cmd: string
+    hex_data: string
+}
+
+export class PacketClient {
+    private websocket: WebSocket | undefined;
+    private isConnected: boolean = false;
+    private reconnectAttempts: number = 0;
+    private readonly maxReconnectAttempts: number = 5;//现在暂时不可配置
+    private readonly cb = new LRUCache<string, (json: RecvPacketData) => Promise<void>>(500); // trace_id-type callback
+    private readonly clientUrl: string = '';
+    readonly napCatCore: NapCatCore;
+    private readonly logger: LogWrapper;
+
+    constructor(url: string, core: NapCatCore) {
+        this.clientUrl = url;
+        this.napCatCore = core;
+        this.logger = core.context.logger;
+    }
+
+    get available(): boolean {
+        return this.isConnected && this.websocket !== undefined;
+    }
+
+    private randText(len: number) {
+        let text = '';
+        const possible = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        for (let i = 0; i < len; i++) {
+            text += possible.charAt(Math.floor(Math.random() * possible.length));
+        }
+        return text;
+    }
+
+    connect(): Promise<void> {
+        return new Promise((resolve, reject) => {
+            //this.logger.log.bind(this.logger)(`[Core] [Packet Server] Attempting to connect to ${this.clientUrl}`);
+            this.websocket = new WebSocket(this.clientUrl);
+            this.websocket.on('error', (err) => {}/*this.logger.logError.bind(this.logger)('[Core] [Packet Server] Error:', err.message)*/);
+
+            this.websocket.onopen = () => {
+                this.isConnected = true;
+                this.reconnectAttempts = 0;
+                this.logger.log.bind(this.logger)(`[Core] [Packet Server] Connected to ${this.clientUrl}`);
+                resolve();
+            };
+
+            this.websocket.onerror = (error) => {
+                //this.logger.logError.bind(this.logger)(`WebSocket error: ${error}`);
+                reject(new Error(`${error.message}`));
+            };
+
+            this.websocket.onmessage = (event) => {
+                // const message = JSON.parse(event.data.toString());
+                // console.log("Received message:", message);
+                this.handleMessage(event.data).then().catch();
+            };
+
+            this.websocket.onclose = () => {
+                this.isConnected = false;
+                //this.logger.logWarn.bind(this.logger)(`[Core] [Packet Server] Disconnected from ${this.clientUrl}`);
+                this.attemptReconnect();
+            };
+        });
+    }
+
+    private attemptReconnect(): void {
+        try {
+            if (this.reconnectAttempts < this.maxReconnectAttempts) {
+                this.reconnectAttempts++;
+                setTimeout(() => {
+                    this.connect().catch((error) => {
+                        this.logger.logError.bind(this.logger)(`[Core] [Packet Server] Reconnecting attempt failed,${error.message}`);
+                    });
+                }, 5000 * this.reconnectAttempts);
+            } else {
+                this.logger.logError.bind(this.logger)(`[Core] [Packet Server] Max reconnect attempts reached. ${this.clientUrl}`);
+            }
+        } catch (error: any) {
+            this.logger.logError.bind(this.logger)(`Error attempting to reconnect: ${error.message}`);
+        }
+    }
+
+    private async registerCallback(trace_id: string, type: string, callback: (json: RecvPacketData) => Promise<void>): Promise<void> {
+        this.cb.put(createHash('md5').update(trace_id).digest('hex') + type, callback);
+    }
+
+    async init(pid: number, recv: string, send: string): Promise<void> {
+        if (!this.isConnected || !this.websocket) {
+            throw new Error("WebSocket is not connected");
+        }
+        const initMessage = {
+            action: 'init',
+            pid: pid,
+            recv: recv,
+            send: send
+        };
+        this.websocket.send(JSON.stringify(initMessage));
+    }
+
+    private async sendCommand(cmd: string, data: string, trace_id: string, rsp: boolean = false, timeout: number = 20000, sendcb: (json: RecvPacketData) => void = () => {
+    }): Promise<RecvPacketData> {
+        return new Promise<RecvPacketData>((resolve, reject) => {
+            if (!this.isConnected || !this.websocket) {
+                throw new Error("WebSocket is not connected");
+            }
+            const commandMessage = {
+                action: 'send',
+                cmd: cmd,
+                data: data,
+                trace_id: trace_id
+            };
+            this.websocket.send(JSON.stringify(commandMessage));
+            if (rsp) {
+                this.registerCallback(trace_id, 'recv', async (json: RecvPacketData) => {
+                    clearTimeout(timeoutHandle);
+                    resolve(json);
+                });
+            }
+            this.registerCallback(trace_id, 'send', async (json: RecvPacketData) => {
+                sendcb(json);
+                if (!rsp) {
+                    clearTimeout(timeoutHandle);
+                    resolve(json);
+                }
+            });
+            const timeoutHandle = setTimeout(() => {
+                reject(new Error(`sendCommand timed out after ${timeout} ms for ${cmd} with trace_id ${trace_id}`));
+            }, timeout);
+        });
+    }
+
+    private async handleMessage(message: Data): Promise<void> {
+        try {
+            const json: RecvPacket = JSON.parse(message.toString());
+            const trace_id_md5 = json.trace_id_md5;
+            const action = json?.type ?? 'init';
+            const event = this.cb.get(trace_id_md5 + action);
+            if (event) {
+                await event(json.data);
+            }
+            //console.log("Received message:", json);
+        } catch (error) {
+            this.logger.logError.bind(this.logger)(`Error parsing message: ${error}`);
+        }
+    }
+
+    async sendPacket(cmd: string, data: PacketHexStr, rsp = false): Promise<RecvPacketData> {
+        // wtfk tx
+        // 校验失败和异常 可能返回undefined
+        return new Promise((resolve, reject) => {
+            if (!this.available) {
+                this.logger.logError('NapCat.Packet is not init');
+                return undefined;
+            }
+            const md5 = crypto.createHash('md5').update(data).digest('hex');
+            const trace_id = (this.randText(4) + md5 + data).slice(0, data.length / 2);
+            this.sendCommand(cmd, data, trace_id, rsp, 20000, async () => {
+                // await sleep(10);
+                await this.napCatCore.context.session.getMsgService().sendSsoCmdReqByContend(cmd, trace_id);
+            }).then((res) => resolve(res)).catch((e: Error) => reject(e));
+        });
+    }
+}

src/core/packet/highway/client.ts

@@ -0,0 +1,72 @@
+import * as stream from 'node:stream';
+import {ReadStream} from "node:fs";
+import {PacketHighwaySig} from "@/core/packet/highway/session";
+import {HighwayHttpUploader, HighwayTcpUploader} from "@/core/packet/highway/uploader";
+import {LogWrapper} from "@/common/log";
+
+export interface PacketHighwayTrans {
+    uin: string;
+    cmd: number;
+    command: string;
+    data: stream.Readable;
+    sum: Uint8Array;
+    size: number;
+    ticket: Uint8Array;
+    loginSig?: Uint8Array;
+    ext: Uint8Array;
+    encrypt: boolean;
+    timeout?: number;
+    server: string;
+    port: number;
+}
+
+export class PacketHighwayClient {
+    sig: PacketHighwaySig;
+    server: string = 'htdata3.qq.com';
+    port: number = 80;
+    logger: LogWrapper;
+
+    constructor(sig: PacketHighwaySig, logger: LogWrapper, server: string = 'htdata3.qq.com', port: number = 80) {
+        this.sig = sig;
+        this.logger = logger;
+    }
+
+    changeServer(server: string, port: number) {
+        this.server = server;
+        this.port = port;
+    }
+
+    private buildDataUpTrans(cmd: number, data: ReadStream, fileSize: number, md5: Uint8Array, extendInfo: Uint8Array, timeout: number = 3600): PacketHighwayTrans {
+        return {
+            uin: this.sig.uin,
+            cmd: cmd,
+            command: 'PicUp.DataUp',
+            data: data,
+            sum: md5,
+            size: fileSize,
+            ticket: this.sig.sigSession!,
+            ext: extendInfo,
+            encrypt: false,
+            timeout: timeout,
+            server: this.server,
+            port: this.port,
+        } as PacketHighwayTrans;
+    }
+
+    async upload(cmd: number, data: ReadStream, fileSize: number, md5: Uint8Array, extendInfo: Uint8Array): Promise<void> {
+        const trans = this.buildDataUpTrans(cmd, data, fileSize, md5, extendInfo);
+        try {
+            const tcpUploader = new HighwayTcpUploader(trans, this.logger);
+            await tcpUploader.upload();
+        } catch (e) {
+            this.logger.logError(`[Highway] upload failed: ${e}, fallback to http upload`);
+            try {
+                const httpUploader = new HighwayHttpUploader(trans, this.logger);
+                await httpUploader.upload();
+            } catch (e) {
+                this.logger.logError(`[Highway] http upload failed: ${e}`);
+                throw e;
+            }
+        }
+    }
+}

src/core/packet/highway/frame.ts

@@ -0,0 +1,23 @@
+import assert from "node:assert";
+
+export class Frame{
+    static pack(head: Buffer, body: Buffer): Buffer {
+        const totalLength = 9 + head.length + body.length + 1;
+        const buffer = Buffer.allocUnsafe(totalLength);
+        buffer[0] = 0x28;
+        buffer.writeUInt32BE(head.length, 1);
+        buffer.writeUInt32BE(body.length, 5);
+        head.copy(buffer, 9);
+        body.copy(buffer, 9 + head.length);
+        buffer[totalLength - 1] = 0x29;
+        return buffer;
+    }
+
+    static unpack(frame: Buffer): [Buffer, Buffer] {
+        assert(frame[0] === 0x28 && frame[frame.length - 1] === 0x29, 'Invalid frame!');
+        const headLen = frame.readUInt32BE(1);
+        const bodyLen = frame.readUInt32BE(5);
+        // assert(frame.length === 9 + headLen + bodyLen + 1, `Frame ${frame.toString('hex')} length does not match head and body lengths!`);
+        return [frame.subarray(9, 9 + headLen), frame.subarray(9 + headLen, 9 + headLen + bodyLen)];
+    }
+}

src/core/packet/highway/session.ts

@@ -0,0 +1,171 @@
+import * as fs from "node:fs";
+import {ChatType, Peer} from "@/core";
+import {LogWrapper} from "@/common/log";
+import {PacketClient} from "@/core/packet/client";
+import {PacketPacker} from "@/core/packet/packer";
+import {NapProtoMsg} from "@/core/packet/proto/NapProto";
+import {HttpConn0x6ff_501Response} from "@/core/packet/proto/action/action";
+import {PacketHighwayClient} from "@/core/packet/highway/client";
+import {NTV2RichMediaResp} from "@/core/packet/proto/oidb/common/Ntv2.RichMediaResp";
+import {OidbSvcTrpcTcpBaseRsp} from "@/core/packet/proto/oidb/OidbBase";
+import {PacketMsgPicElement} from "@/core/packet/msg/element";
+import {NTV2RichMediaHighwayExt} from "@/core/packet/proto/highway/highway";
+import {int32ip2str, oidbIpv4s2HighwayIpv4s} from "@/core/packet/highway/utils";
+
+export const BlockSize = 1024 * 1024;
+
+interface HighwayServerAddr {
+    ip: string
+    port: number
+}
+
+export interface PacketHighwaySig {
+    uin: string;
+    sigSession: Uint8Array | null
+    sessionKey: Uint8Array | null
+    serverAddr: HighwayServerAddr[]
+}
+
+export class PacketHighwaySession {
+    protected packetClient: PacketClient;
+    protected packetHighwayClient: PacketHighwayClient;
+    protected sig: PacketHighwaySig;
+    protected logger: LogWrapper;
+    protected packer: PacketPacker;
+    private cachedPrepareReq: Promise<void> | null = null;
+
+    constructor(logger: LogWrapper, client: PacketClient, packer: PacketPacker) {
+        this.packetClient = client;
+        this.logger = logger;
+        this.sig = {
+            uin: this.packetClient.napCatCore.selfInfo.uin,
+            sigSession: null,
+            sessionKey: null,
+            serverAddr: [],
+        }
+        this.packer = packer;
+        this.packetHighwayClient = new PacketHighwayClient(this.sig, this.logger);
+    }
+
+    private async checkAvailable() {
+        if (!this.packetClient.available) {
+            this.logger.logError('[Highway] packetServer not available!');
+            throw new Error('packetServer不可用，请参照文档 https://napneko.github.io/config/advanced 检查packetServer状态或进行配置');
+        }
+        if (this.sig.sigSession === null || this.sig.sessionKey === null) {
+            this.logger.logWarn('[Highway] sigSession or sessionKey not available!');
+            if (this.cachedPrepareReq === null) {
+                this.cachedPrepareReq = this.prepareUpload().finally(() => {
+                    this.cachedPrepareReq = null;
+                });
+            }
+            await this.cachedPrepareReq;
+        }
+    }
+
+    private async prepareUpload(): Promise<void> {
+        const packet = this.packer.packHttp0x6ff_501();
+        const req = await this.packetClient.sendPacket('HttpConn.0x6ff_501', packet, true);
+        const rsp = new NapProtoMsg(HttpConn0x6ff_501Response).decode(
+            Buffer.from(req.hex_data, 'hex')
+        );
+        this.sig.sigSession = rsp.httpConn.sigSession
+        this.sig.sessionKey = rsp.httpConn.sessionKey
+        for (const info of rsp.httpConn.serverInfos) {
+            if (info.serviceType !== 1) continue;
+            for (const addr of info.serverAddrs) {
+                this.logger.logDebug(`[Highway PrepareUpload] server addr add: ${int32ip2str(addr.ip)}:${addr.port}`);
+                this.sig.serverAddr.push({
+                    ip: int32ip2str(addr.ip),
+                    port: addr.port
+                })
+            }
+        }
+    }
+
+    async uploadImage(peer: Peer, img: PacketMsgPicElement): Promise<void> {
+        await this.checkAvailable();
+        if (peer.chatType === ChatType.KCHATTYPEGROUP) {
+            await this.uploadGroupImageReq(Number(peer.peerUid), img);
+        } else if (peer.chatType === ChatType.KCHATTYPEC2C) {
+            await this.uploadC2CImageReq(peer.peerUid, img);
+        } else {
+            throw new Error(`[Highway] unsupported chatType: ${peer.chatType}`);
+        }
+    }
+
+    private async uploadGroupImageReq(groupUin: number, img: PacketMsgPicElement): Promise<void> {
+        const preReq = await this.packer.packUploadGroupImgReq(groupUin, img);
+        const preRespRaw = await this.packetClient.sendPacket('OidbSvcTrpcTcp.0x11c4_100', preReq, true);
+        const preResp = new NapProtoMsg(OidbSvcTrpcTcpBaseRsp).decode(
+            Buffer.from(preRespRaw.hex_data, 'hex')
+        );
+        const preRespData = new NapProtoMsg(NTV2RichMediaResp).decode(preResp.body);
+        const ukey = preRespData.upload.uKey;
+        if (ukey && ukey != "") {
+            this.logger.logDebug(`[Highway] get upload ukey: ${ukey}, need upload!`);
+            const index = preRespData.upload.msgInfo.msgInfoBody[0].index;
+            const sha1 = Buffer.from(index.info.fileSha1, 'hex');
+            const md5 = Buffer.from(index.info.fileHash, 'hex');
+            const extend = new NapProtoMsg(NTV2RichMediaHighwayExt).encode({
+                fileUuid: index.fileUuid,
+                uKey: ukey,
+                network: {
+                    ipv4S: oidbIpv4s2HighwayIpv4s(preRespData.upload.ipv4S)
+                },
+                msgInfoBody: preRespData.upload.msgInfo.msgInfoBody,
+                blockSize: BlockSize,
+                hash: {
+                    fileSha1: [sha1]
+                }
+            })
+            await this.packetHighwayClient.upload(
+                1004,
+                fs.createReadStream(img.path, {highWaterMark: BlockSize}),
+                img.size,
+                md5,
+                extend
+            );
+        } else {
+            this.logger.logDebug(`[Highway] get upload invalid ukey ${ukey}, don't need upload!`);
+        }
+        img.msgInfo = preRespData.upload.msgInfo;
+        // img.groupPicExt = new NapProtoMsg(CustomFace).decode(preRespData.tcpUpload.compatQMsg)
+    }
+
+    private async uploadC2CImageReq(peerUid: string, img: PacketMsgPicElement): Promise<void> {
+        const preReq = await this.packer.packUploadC2CImgReq(peerUid, img);
+        const preRespRaw = await this.packetClient.sendPacket('OidbSvcTrpcTcp.0x11c5_100', preReq, true);
+        const preResp = new NapProtoMsg(OidbSvcTrpcTcpBaseRsp).decode(
+            Buffer.from(preRespRaw.hex_data, 'hex')
+        );
+        const preRespData = new NapProtoMsg(NTV2RichMediaResp).decode(preResp.body);
+        const ukey = preRespData.upload.uKey;
+        if (ukey && ukey != "") {
+            this.logger.logDebug(`[Highway] get upload ukey: ${ukey}, need upload!`);
+            const index = preRespData.upload.msgInfo.msgInfoBody[0].index;
+            const sha1 = Buffer.from(index.info.fileSha1, 'hex');
+            const md5 = Buffer.from(index.info.fileHash, 'hex');
+            const extend = new NapProtoMsg(NTV2RichMediaHighwayExt).encode({
+                fileUuid: index.fileUuid,
+                uKey: ukey,
+                network: {
+                    ipv4S: oidbIpv4s2HighwayIpv4s(preRespData.upload.ipv4S)
+                },
+                msgInfoBody: preRespData.upload.msgInfo.msgInfoBody,
+                blockSize: BlockSize,
+                hash: {
+                    fileSha1: [sha1]
+                }
+            })
+            await this.packetHighwayClient.upload(
+                1003,
+                fs.createReadStream(img.path, {highWaterMark: BlockSize}),
+                img.size,
+                md5,
+                extend
+            );
+        }
+        img.msgInfo = preRespData.upload.msgInfo;
+    }
+}

src/core/packet/highway/uploader.ts

@@ -0,0 +1,196 @@
+import * as net from "node:net";
+import * as crypto from "node:crypto";
+import * as http from "node:http";
+import * as stream from "node:stream";
+import {LogWrapper} from "@/common/log";
+import * as tea from "@/core/packet/utils/crypto/tea";
+import {NapProtoMsg} from "@/core/packet/proto/NapProto";
+import {ReqDataHighwayHead, RespDataHighwayHead} from "@/core/packet/proto/highway/highway";
+import {BlockSize} from "@/core/packet/highway/session";
+import {PacketHighwayTrans} from "@/core/packet/highway/client";
+import {Frame} from "@/core/packet/highway/frame";
+
+abstract class HighwayUploader {
+    readonly trans: PacketHighwayTrans;
+    readonly logger: LogWrapper;
+
+    constructor(trans: PacketHighwayTrans, logger: LogWrapper) {
+        this.trans = trans;
+        this.logger = logger;
+    }
+
+    encryptTransExt(key: Uint8Array) {
+        if (!this.trans.encrypt) return;
+        this.trans.ext = tea.encrypt(Buffer.from(this.trans.ext), Buffer.from(key));
+    }
+
+    buildPicUpHead(offset: number, bodyLength: number, bodyMd5: Uint8Array): Uint8Array {
+        return new NapProtoMsg(ReqDataHighwayHead).encode({
+            msgBaseHead: {
+                version: 1,
+                uin: this.trans.uin,
+                command: "PicUp.DataUp",
+                seq: 0,
+                retryTimes: 0,
+                appId: 1600001604,
+                dataFlag: 16,
+                commandId: this.trans.cmd,
+            },
+            msgSegHead: {
+                serviceId: 0,
+                filesize: BigInt(this.trans.size),
+                dataOffset: BigInt(offset),
+                dataLength: bodyLength,
+                serviceTicket: this.trans.ticket,
+                md5: bodyMd5,
+                fileMd5: this.trans.sum,
+                cacheAddr: 0,
+                cachePort: 0,
+            },
+            bytesReqExtendInfo: this.trans.ext,
+            timestamp: BigInt(0),
+            msgLoginSigHead: {
+                uint32LoginSigType: 8,
+                appId: 1600001604,
+            }
+        })
+    }
+
+    abstract upload(): Promise<void>;
+}
+
+class HighwayTcpUploaderTransform extends stream.Transform {
+    uploader: HighwayTcpUploader;
+    offset: number;
+
+    constructor(uploader: HighwayTcpUploader) {
+        super();
+        this.uploader = uploader;
+        this.offset = 0;
+    }
+
+    _transform(data: Buffer, _: BufferEncoding, callback: stream.TransformCallback) {
+        let chunkOffset = 0;
+        while (chunkOffset < data.length) {
+            const chunkSize = Math.min(BlockSize, data.length - chunkOffset);
+            const chunk = data.subarray(chunkOffset, chunkOffset + chunkSize);
+            const chunkMd5 = crypto.createHash('md5').update(chunk).digest();
+            const head = this.uploader.buildPicUpHead(this.offset, chunk.length, chunkMd5);
+            chunkOffset += chunk.length;
+            this.offset += chunk.length;
+            this.push(Frame.pack(Buffer.from(head), chunk));
+        }
+        callback(null);
+    }
+}
+
+export class HighwayTcpUploader extends HighwayUploader {
+    async upload(): Promise<void> {
+        const highwayTransForm = new HighwayTcpUploaderTransform(this);
+        const upload = new Promise<void>((resolve, _) => {
+            const socket = net.connect(this.trans.port, this.trans.server, () => {
+                this.trans.data.pipe(highwayTransForm).pipe(socket, {end: false});
+            })
+            const handleRspHeader = (header: Buffer) => {
+                const rsp = new NapProtoMsg(RespDataHighwayHead).decode(header);
+                if (rsp.errorCode !== 0) {
+                    this.logger.logWarn(`[Highway] tcpUpload failed (code: ${rsp.errorCode})`);
+                }
+                const percent = ((Number(rsp.msgSegHead?.dataOffset) + Number(rsp.msgSegHead?.dataLength)) / Number(rsp.msgSegHead?.filesize)).toFixed(2);
+                this.logger.logDebug(`[Highway] tcpUpload ${rsp.errorCode} | ${percent} | ${Buffer.from(header).toString('hex')}`);
+                if (Number(rsp.msgSegHead?.dataOffset) + Number(rsp.msgSegHead?.dataLength) >= Number(rsp.msgSegHead?.filesize)) {
+                    this.logger.logDebug('[Highway] tcpUpload finished.');
+                    socket.end();
+                    resolve();
+                }
+            };
+            socket.on('data', (chunk: Buffer) => {
+                try {
+                    const [head, _] = Frame.unpack(chunk);
+                    handleRspHeader(head);
+                } catch (e) {
+                    this.logger.logError(`[Highway] tcpUpload parse response error: ${e}`);
+                }
+            })
+            socket.on('close', () => {
+                this.logger.logDebug('[Highway] tcpUpload socket closed.');
+                resolve();
+            })
+            socket.on('error', (err) => {
+                this.logger.logError('[Highway] tcpUpload socket.on error:', err);
+            })
+            this.trans.data.on('error', (err) => {
+                this.logger.logError('[Highway] tcpUpload readable error:', err);
+                socket.end();
+            })
+        })
+        const timeout = new Promise<void>((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`[Highway] tcpUpload timeout after ${this.trans.timeout}s`))
+            }, (this.trans.timeout ?? Infinity) * 1000
+            )
+        })
+        await Promise.race([upload, timeout]);
+    }
+}
+
+// TODO: timeout impl
+export class HighwayHttpUploader extends HighwayUploader {
+    async upload(): Promise<void> {
+        let offset = 0;
+        for await (const chunk of this.trans.data) {
+            let block = chunk as Buffer;
+            try {
+                await this.uploadBlock(block, offset);
+            } catch (err) {
+                this.logger.logError(`[Highway] httpUpload Error uploading block at offset ${offset}: ${err}`);
+                throw err;
+            }
+            offset += block.length;
+        }
+    }
+
+    private async uploadBlock(block: Buffer, offset: number): Promise<void> {
+        const chunkMD5 = crypto.createHash('md5').update(block).digest();
+        const payload = this.buildPicUpHead(offset, block.length, chunkMD5);
+        const frame = Frame.pack(Buffer.from(payload), block)
+        const resp = await this.httpPostHighwayContent(frame, `http://${this.trans.server}:${this.trans.port}/cgi-bin/httpconn?htcmd=0x6FF0087&uin=${this.trans.uin}`);
+        const [head, body] = Frame.unpack(resp);
+        const headData = new NapProtoMsg(RespDataHighwayHead).decode(head);
+        this.logger.logDebug(`[Highway] httpUploadBlock: ${headData.errorCode} | ${headData.msgSegHead?.retCode} | ${headData.bytesRspExtendInfo} | ${head.toString('hex')} | ${body.toString('hex')}`);
+        if (headData.errorCode !== 0) {
+            this.logger.logError(`[Highway] httpUploadBlock failed (code=${headData.errorCode})`);
+        }
+    }
+
+    private async httpPostHighwayContent(frame: Buffer, serverURL: string): Promise<Buffer> {
+        return new Promise((resolve, reject) => {
+            try {
+                const options: http.RequestOptions = {
+                    method: 'POST',
+                    headers: {
+                        'Connection': 'keep-alive',
+                        'Accept-Encoding': 'identity',
+                        'User-Agent': 'Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2)',
+                        'Content-Length': frame.length.toString(),
+                    },
+                };
+                const req = http.request(serverURL, options, (res) => {
+                    let data = Buffer.alloc(0);
+                    res.on('data', (chunk) => {
+                        data = Buffer.concat([data, chunk]);
+                    });
+                    res.on('end', () => {
+                        resolve(data);
+                    });
+                });
+                req.write(frame);
+                req.on('error', (error) => {
+                    reject(error);
+                });
+            } catch (error) {
+                reject(error);
+            }
+        });
+    }
+}

src/core/packet/highway/utils.ts

@@ -0,0 +1,20 @@
+import {NapProtoEncodeStructType} from "@/core/packet/proto/NapProto";
+import {IPv4} from "@/core/packet/proto/oidb/common/Ntv2.RichMediaResp";
+import {NTHighwayIPv4} from "@/core/packet/proto/highway/highway";
+
+export const int32ip2str = (ip: number) => {
+    ip = ip & 0xffffffff;
+    return [ip & 0xff, (ip & 0xff00) >> 8, (ip & 0xff0000) >> 16, ((ip & 0xff000000) >> 24) & 0xff].join('.');
+}
+
+export const oidbIpv4s2HighwayIpv4s = (ipv4s: NapProtoEncodeStructType<typeof IPv4>[]): NapProtoEncodeStructType<typeof NTHighwayIPv4>[] =>{
+    return ipv4s.map((ip) => {
+        return {
+            domain: {
+                isEnable: true,
+                ip: int32ip2str(ip.outIP!),
+            },
+            port: ip.outPort!
+        } as NapProtoEncodeStructType<typeof NTHighwayIPv4>
+    })
+}

src/core/packet/msg/builder.ts

@@ -0,0 +1,58 @@
+import * as crypto from "crypto";
+import {PushMsgBody} from "@/core/packet/proto/message/message";
+import {NapProtoEncodeStructType} from "@/core/packet/proto/NapProto";
+import {LogWrapper} from "@/common/log";
+import {PacketMsg} from "@/core/packet/msg/message";
+
+export class PacketMsgBuilder {
+    private logger: LogWrapper;
+
+    constructor(logger: LogWrapper) {
+        this.logger = logger;
+    }
+
+    buildFakeMsg(selfUid: string, element: PacketMsg[]): NapProtoEncodeStructType<typeof PushMsgBody>[] {
+        return element.map((node): NapProtoEncodeStructType<typeof PushMsgBody> => {
+            const avatar = `https://q.qlogo.cn/headimg_dl?dst_uin=${node.senderUin}&spec=640&img_type=jpg`;
+            const msgElement = node.msg.flatMap(msg => msg.buildElement() ?? []);
+            return {
+                responseHead: {
+                    fromUid: "",
+                    fromUin: node.senderUin,
+                    toUid: node.groupId ? undefined : selfUid,
+                    forward: node.groupId ? undefined : {
+                        friendName: node.senderName,
+                    },
+                    grp: node.groupId ? {
+                        groupUin: node.groupId,
+                        memberName: node.senderName,
+                        unknown5: 2
+                    } : undefined,
+                },
+                contentHead: {
+                    type: node.groupId ? 82 : 9,
+                    subType: node.groupId ? undefined : 4,
+                    divSeq: node.groupId ? undefined : 4,
+                    msgId: crypto.randomBytes(4).readUInt32LE(0),
+                    sequence: crypto.randomBytes(4).readUInt32LE(0),
+                    timeStamp: Math.floor(Date.now() / 1000),
+                    field7: BigInt(1),
+                    field8: 0,
+                    field9: 0,
+                    forward: {
+                        field1: 0,
+                        field2: 0,
+                        field3: node.groupId ? 0 : 2,
+                        unknownBase64: avatar,
+                        avatar: avatar
+                    }
+                },
+                body: {
+                    richText: {
+                        elems: msgElement
+                    }
+                }
+            };
+        });
+    }
+}

src/core/packet/msg/converter.ts

@@ -0,0 +1,131 @@
+import {
+    MessageElement,
+    RawMessage,
+    SendArkElement,
+    SendFaceElement,
+    SendFileElement,
+    SendMarkdownElement,
+    SendMarketFaceElement,
+    SendPicElement,
+    SendPttElement,
+    SendReplyElement,
+    SendStructLongMsgElement,
+    SendTextElement,
+    SendVideoElement
+} from "@/core";
+import {
+    IPacketMsgElement,
+    PacketMsgAtElement,
+    PacketMsgFaceElement,
+    PacketMsgFileElement,
+    PacketMsgLightAppElement,
+    PacketMsgMarkDownElement,
+    PacketMsgMarkFaceElement,
+    PacketMsgPicElement,
+    PacketMsgPttElement,
+    PacketMsgReplyElement,
+    PacketMsgTextElement,
+    PacketMsgVideoElement,
+    PacketMultiMsgElement
+} from "@/core/packet/msg/element";
+import {PacketMsg, PacketSendMsgElement} from "@/core/packet/msg/message";
+import {LogWrapper} from "@/common/log";
+
+type SendMessageElementMap = {
+    textElement: SendTextElement,
+    picElement: SendPicElement,
+    replyElement: SendReplyElement,
+    faceElement: SendFaceElement,
+    marketFaceElement: SendMarketFaceElement,
+    videoElement: SendVideoElement,
+    fileElement: SendFileElement,
+    pttElement: SendPttElement,
+    arkElement: SendArkElement,
+    markdownElement: SendMarkdownElement,
+    structLongMsgElement: SendStructLongMsgElement
+};
+
+type RawToPacketMsgConverters = {
+    [K in keyof SendMessageElementMap]: (
+        element: SendMessageElementMap[K],
+        msg?: RawMessage,
+        elementWrapper?: MessageElement,
+    ) => IPacketMsgElement<SendMessageElementMap[K]> | null;
+};
+
+export type rawMsgWithSendMsg = {
+    senderUin: number;
+    senderUid?: string;
+    senderName: string;
+    groupId?: number;
+    time: number;
+    msg: PacketSendMsgElement[]
+}
+
+export class PacketMsgConverter {
+    private logger: LogWrapper;
+
+    constructor(logger: LogWrapper) {
+        this.logger = logger;
+    }
+
+    rawMsgWithSendMsgToPacketMsg(msg: rawMsgWithSendMsg): PacketMsg {
+        return {
+            senderUid: msg.senderUid ?? '',
+            senderUin: msg.senderUin,
+            senderName: msg.senderName,
+            groupId: msg.groupId,
+            time: msg.time,
+            msg: msg.msg.map((element) => {
+                const key = (Object.keys(this.rawToPacketMsgConverters) as Array<keyof SendMessageElementMap>).find(
+                    (k) => (element as any)[k] !== undefined  // TODO:
+                );
+                if (key) {
+                    const elementData = (element as any)[key];  // TODO:
+                    if (elementData) return this.rawToPacketMsgConverters[key](element as any)
+                }
+                return null;
+            }).filter((e) => e !== null)
+        }
+    }
+
+    private rawToPacketMsgConverters: RawToPacketMsgConverters = {
+        textElement: (element: SendTextElement) => {
+            if (element.textElement.atType) {
+                return new PacketMsgAtElement(element)
+            }
+            return new PacketMsgTextElement(element)
+        },
+        picElement: (element: SendPicElement) => {
+            return new PacketMsgPicElement(element)
+        },
+        replyElement: (element: SendReplyElement) => {
+            return new PacketMsgReplyElement(element)
+        },
+        faceElement: (element: SendFaceElement) => {
+            return new PacketMsgFaceElement(element)
+        },
+        marketFaceElement: (element: SendMarketFaceElement) => {
+            return new PacketMsgMarkFaceElement(element)
+        },
+        videoElement: (element: SendVideoElement) => {
+            return new PacketMsgVideoElement(element)
+        },
+        fileElement: (element: SendFileElement) => {
+            return new PacketMsgFileElement(element)
+        },
+        pttElement: (element: SendPttElement) => {
+            return new PacketMsgPttElement(element)
+        },
+        arkElement: (element: SendArkElement) => {
+            return new PacketMsgLightAppElement(element)
+        },
+        markdownElement: (element: SendMarkdownElement) => {
+            return new PacketMsgMarkDownElement(element)
+        },
+        // TODO: check this logic, move it in arkElement?
+        structLongMsgElement: (element: SendStructLongMsgElement) => {
+            return new PacketMultiMsgElement(element)
+        }
+    }
+}