SnowCat 雪猫底层全源码：NapCat 4.18.28 底座 + SnowLuma 能力移植 + V8 通道适配 9.9.37

26 包 monorepo（TS 全源码）：
- snowcat-core: NT 内核 API 封装 + listener（含 9.9.37 六回调适配）+ Packet 发包
- snowcat-onebot: OneBot v11 全动作 + MCP Streamable HTTP 适配器 + 稳定线
- snowcat-webui-frontend/backend: 雪猫控制台（React+HeroUI）
- snowcat-shell: 单文件 bundle 出口（vite inlineDynamicImports）
- snowcat-native: napi2native / MoeHoo / ffmpeg / pty 运行时
- 56 项 SnowLuma 独门动作移植（qzone 全家桶/群相册/装扮/闪照/收藏）
- 工具件: 解包器/启动器/便携制作器/doctor

GitHub 关联已全量指向 DandanLLab/SnowCatQQ

packages/snowcat-test/groupOperations.test.ts

@@ -0,0 +1,124 @@
+import { describe, expect, test } from 'vitest';
+import {
+  applyGroupManagementSettings,
+  createGroupDetailInfoV2Param,
+  createGroupManagementRequests,
+} from '../snowcat-core/data/group';
+import { assertGroupManagementResults } from '../snowcat-onebot/action/group/GroupOperationHelpers';
+
+describe('NTQQ group operations', () => {
+  test('reports the exact native setting that failed', () => {
+    expect(() => assertGroupManagementResults('设置群成员功能权限', [{
+      setting: 'allow_member_create_group',
+      result: { result: 1006, errMsg: '未知错误' },
+    }])).toThrow(/allow_member_create_group.*1006.*未知错误/);
+    expect(() => assertGroupManagementResults('设置群成员功能权限', []))
+      .not.toThrow();
+  });
+
+  test('builds the NTQQ permission masks without changing unrelated flags', async () => {
+    const request = createGroupDetailInfoV2Param('123456');
+    expect(applyGroupManagementSettings(request, {
+      memberInvite: 'no_approval',
+      allowMemberUploadAlbum: false,
+      allowMemberTemporarySession: true,
+      allowMemberCreateGroup: false,
+      newMembersSeeRecentHistory: true,
+    })).toBe(true);
+    expect(request.groupCode).toBe('123456');
+    expect(request.filter).toMatchObject({
+      allowMemberInvite: 1,
+      appPrivilegeFlag: 1,
+      appPrivilegeMask: 1,
+      groupFlagExt4: 1,
+      groupFlagExt4Mask: 1,
+    });
+    expect(request.modifyInfo).toMatchObject({
+      allowMemberInvite: 1,
+      appPrivilegeFlag: 0x00108001,
+      appPrivilegeMask: 0x06118001,
+      groupFlagExt3: 0,
+      groupFlagExt3Mask: 0,
+      groupFlagExt4: 0x4,
+      groupFlagExt4Mask: 0x4,
+    });
+  });
+
+  test('maps every member invite policy to the native app privilege value', async () => {
+    const expected = {
+      disabled: 0x04000000,
+      require_approval: 0,
+      no_approval: 0x00100000,
+      no_approval_under_100: 0x02000000,
+    } as const;
+
+    for (const [memberInvite, privilegeFlag] of Object.entries(expected)) {
+      const request = createGroupDetailInfoV2Param('123456');
+      applyGroupManagementSettings(request, { memberInvite: memberInvite as keyof typeof expected });
+      expect(request.modifyInfo.allowMemberInvite).toBe(memberInvite === 'disabled' ? 0 : 1);
+      expect(request.modifyInfo.appPrivilegeFlag).toBe(privilegeFlag);
+      expect(request.modifyInfo.appPrivilegeMask).toBe(0x06100000);
+    }
+  });
+
+  test('uses NTQQ privilege operation type 8 for album, temporary-session, and create-group flags', () => {
+    const requests = createGroupManagementRequests('123456', {
+      memberInvite: 'require_approval',
+      allowMemberUploadAlbum: true,
+      allowMemberTemporarySession: true,
+      allowMemberCreateGroup: true,
+    }, 0x18001);
+
+    expect(requests.map(request => request.operationType)).toEqual([0, 8, 8, 8]);
+    expect(requests.map(request => request.setting)).toEqual([
+      'member_invite',
+      'allow_member_upload_album',
+      'allow_member_temporary_session',
+      'allow_member_create_group',
+    ]);
+    expect(requests.slice(1).map(request => request.param.modifyInfo.appPrivilegeMask))
+      .toEqual([0x1, 0x10000, 0x8000]);
+    expect(requests[1]?.param.modifyInfo).toMatchObject({
+      appPrivilegeFlag: 0x18000,
+      appPrivilegeMask: 0x1,
+      groupFlagExt3: 0,
+      groupFlagExt3Mask: 0,
+    });
+    expect(requests[2]?.param.modifyInfo).toMatchObject({
+      appPrivilegeFlag: 0x8000,
+      appPrivilegeMask: 0x10000,
+      groupFlagExt3: 0,
+      groupFlagExt3Mask: 0,
+    });
+    expect(requests[3]?.param.modifyInfo).toMatchObject({
+      appPrivilegeFlag: 0,
+      appPrivilegeMask: 0x8000,
+      groupFlagExt3: 0,
+      groupFlagExt3Mask: 0,
+    });
+  });
+
+  test('preserves the complete privilege value when clearing Linux NTQQ permission bits', () => {
+    const requests = createGroupManagementRequests('123456', {
+      allowMemberUploadAlbum: false,
+      allowMemberTemporarySession: false,
+      allowMemberCreateGroup: false,
+    }, 0);
+
+    expect(requests.map(request => request.param.modifyInfo.appPrivilegeFlag))
+      .toEqual([0x1, 0x10001, 0x18001]);
+    expect(requests.map(request => request.param.modifyInfo.appPrivilegeMask))
+      .toEqual([0x1, 0x10000, 0x8000]);
+  });
+
+  test('skips privilege requests whose effective value is already current', () => {
+    const requests = createGroupManagementRequests('123456', {
+      allowMemberUploadAlbum: true,
+      allowMemberTemporarySession: true,
+      allowMemberCreateGroup: true,
+      newMembersSeeRecentHistory: true,
+    }, 0x00100000, 0x4);
+
+    expect(requests).toEqual([]);
+  });
+});