koishi-plugin-onebot-info-image 0.0.1-alpha.2 → 0.2.0-alpha.5

package/lib/renderAdminList.d.ts

@@ -0,0 +1,3 @@
+import { Context } from 'koishi';
+import { type ImageStyle, ImageType, UnifiedAdminInfo, UnifiedContextInfo } from './type';
+export declare function renderAdminList(ctx: Context, admins: UnifiedAdminInfo[], contextInfo: UnifiedContextInfo, imageStyle: ImageStyle, enableDarkMode: boolean, imageType: ImageType, screenshotQuality: number): Promise<string>;

package/lib/renderUserInfo.d.ts

@@ -0,0 +1,14 @@
+import { Context } from 'koishi';
+import { type ImageStyle, ImageType, UnifiedUserInfo, UnifiedContextInfo } from './type';
+/**
+ * 渲染用户信息为图片并返回 base64 编码。
+ * @param ctx Koishi Context 实例
+ * @param userInfo 统一的用户信息对象
+ * @param contextInfo 统一的上下文信息对象
+ * @param imageStyle 图片样式
+ * @param enableDarkMode 是否启用暗黑模式
+ * @param imageType 图片类型
+ * @param screenshotQuality 截图质量
+ * @returns Promise<string> 图片的 base64 编码
+ */
+export declare function renderUserInfo(ctx: Context, userInfo: UnifiedUserInfo, contextInfo: UnifiedContextInfo, imageStyle: ImageStyle, enableDarkMode: boolean, imageType: ImageType, screenshotQuality: number): Promise<string>;

package/lib/type.d.ts

@@ -0,0 +1,157 @@
+export declare const IMAGE_STYLES: {
+    readonly SOURCE_HAN_SERIF_SC: "思源宋体SourceHanSerifSC";
+    readonly LXGW_WENKAI: "落霞孤鹜文楷LXGWWenKai";
+};
+export type ImageStyle = typeof IMAGE_STYLES[keyof typeof IMAGE_STYLES];
+export declare const FONT_FILES: {
+    readonly 思源宋体SourceHanSerifSC: "SourceHanSerifSC-Medium.otf";
+    readonly 落霞孤鹜文楷LXGWWenKai: "LXGWWenKaiMono-Regular.ttf";
+};
+export declare const IMAGE_TYPES: {
+    readonly PNG: "png";
+    readonly JPEG: "jpeg";
+    readonly WEBP: "webp";
+};
+export type ImageType = typeof IMAGE_TYPES[keyof typeof IMAGE_TYPES];
+export declare const ONEBOT_IMPL_NAME: {
+    LAGRNAGE: string;
+    NAPCAT: string;
+};
+export type OneBotImplName = typeof ONEBOT_IMPL_NAME[keyof typeof ONEBOT_IMPL_NAME];
+export interface UnifiedUserInfo {
+    user_id: string;
+    nickname: string;
+    sex: 'male' | 'female' | 'unknown' | '';
+    age: number;
+    group_id?: number;
+    card?: string;
+    level?: string;
+    qq_level?: number;
+    join_time?: number;
+    last_sent_time?: number;
+    role?: 'owner' | 'admin' | 'member';
+    title?: string;
+    title_expire_time?: number;
+    unfriendly?: boolean;
+    card_changeable?: boolean;
+    is_robot?: boolean;
+    shut_up_timestamp?: number;
+    uid?: string;
+    uin?: string;
+    nick?: string;
+    remark?: string;
+    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;
+    reg_time?: number;
+    interest?: string;
+    labels?: any[];
+    qqLevel?: number;
+    qid?: string;
+    q_id?: string;
+    longNick?: string;
+    long_nick?: string;
+    birthday_year?: number;
+    birthday_month?: number;
+    birthday_day?: number;
+    eMail?: string;
+    phoneNum?: string;
+    categoryId?: number;
+    richTime?: number;
+    richBuffer?: any;
+    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;
+    status?: number | {
+        status_id?: number;
+        face_id?: number;
+        message?: string;
+    };
+    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?: any;
+    extOnlineBusinessInfo?: any;
+    extBuffer?: any;
+    is_vip?: boolean;
+    is_years_vip?: boolean;
+    vip_level?: number;
+    login_days?: number;
+    avatar?: string;
+    sign?: string;
+    area?: string;
+    group_level?: string;
+    RegisterTime?: number;
+    Business?: any[];
+}
+export interface UnifiedAdminInfo {
+    user_id: number;
+    nickname: string;
+    card?: string;
+    sex?: 'male' | 'female' | 'unknown' | '';
+    age?: number;
+    area?: string;
+    level?: string;
+    qq_level?: number;
+    join_time?: number;
+    last_sent_time?: number;
+    title_expire_time?: number;
+    unfriendly?: boolean;
+    card_changeable?: boolean;
+    is_robot?: boolean;
+    shut_up_timestamp?: number;
+    role: 'owner' | 'admin';
+    title?: string;
+    avatar?: string;
+}
+export interface UnifiedContextInfo {
+    isGroup: boolean;
+    groupId?: number;
+    groupName?: string;
+    memberCount?: number;
+    maxMemberCount?: number;
+    groupAvatarUrl?: string;
+}
+export declare function convertToUnifiedUserInfo(userInfo: any, onebotImplName: OneBotImplName): UnifiedUserInfo;
+export declare function convertToUnifiedAdminInfo(adminInfo: any, onebotImplName: OneBotImplName): UnifiedAdminInfo;
+export declare function convertToUnifiedContextInfo(contextInfo: any, onebotImplName: OneBotImplName): UnifiedContextInfo;
+export declare const NAPCAT_QQ_STATUS_MAP: {
+    [key: string]: string;
+};
+/**
+ * 根据QQ状态码和扩展状态码获取对应的文本描述
+ * @param status 主状态码
+ * @param ext_status 扩展状态码
+ * @returns 对应的状态文本，如果未找到则返回 '未知状态'
+ */
+export declare function getNapcatQQStatusText(status: number, ext_status: number): string;

package/lib/utils.d.ts

@@ -0,0 +1,27 @@
+import { Context } from 'koishi';
+import { type ImageStyle } from './type';
+/**
+ * 生成当前时间戳字符串
+ * @returns 格式为 YYYY/MM/DD HH:MM:SS 的时间戳字符串
+ */
+export declare function generateTimestamp(): string;
+/**
+ * 获取群头像的 Base64 编码
+ * @param ctx Koishi Context 实例
+ * @param groupId 群号
+ * @returns Promise<string> 群头像的 base64 编码
+ */
+export declare function getGroupAvatarBase64(ctx: Context, groupId: string): Promise<string>;
+/**
+ * 获取字体文件的 Base64 编码
+ * @param ctx Koishi Context 实例
+ * @param imageStyle 图片样式
+ * @returns Promise<string> 字体文件的 base64 编码
+ */
+export declare function getFontBase64(ctx: Context, imageStyle: ImageStyle): Promise<string>;
+/**
+ * 验证并下载字体文件
+ * @param ctx Koishi Context 实例
+ * @returns Promise<void>
+ */
+export declare function validateFonts(ctx: Context): Promise<void>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-onebot-info-image",
-  "description": "用onebot api获取用户详细信息/群管理员列表信息，可以发纯文本/合并转发/渲染图片",
-  "version": "0.0.1-alpha.2+20250730",
+  "description": "用onebot api获取用户详细信息/群管理员列表信息，可以发纯文本/合并转发/渲染图片。 现在只做了lagrange和napcat的适配",
+  "version": "0.2.0-alpha.5+20250929",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -9,10 +9,10 @@
     "dist"
   ],
   "license": "MIT",
-  "homepage": "https://gitee.com/vincent-zyu/koishi-plugin-onebot-image",
+  "homepage": "https://github.com/VincentZyu233/koishi-plugin-onebot-image",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/VincentZyu233/koishi-plugin-onebot-image"
+    "url": "git+https://gitee.com/vincent-zyu/koishi-plugin-onebot-image"
   },
   "keywords": [
     "chatbot",
@@ -24,12 +24,15 @@
     "koishi": "^4.18.7"
   },
   "koishi": {
-    "description": {                      
+    "description": {
       "en": "Fetch detailed user info / group admin list using OneBot API, and send plain text / merged forward messages / rendered images.",
-      "zh": "用onebot api获取用户详细信息/群管理员列表信息，可以发纯文本/合并转发/渲染图片"
+      "zh": "用onebot api获取用户详细信息/群管理员列表信息，可以发纯文本/合并转发/渲染图片。现在只做了lagrange和napcat的适配"
     },
     "service": {
-      "required": ["database"]                   
+      "required": [
+        "puppeteer",
+        "http"
+      ]
     }
   }
 }

package/readme.md

@@ -1,5 +1,35 @@
-# koishi-plugin-admin--image
+# koishi-plugin-onebot-info-image
 
-[![npm](https://img.shields.io/npm/v/koishi-plugin-admin--image?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-admin--image)
+[![npm](https://img.shields.io/npm/v/koishi-plugin-onebot-info-image?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-onebot-info-image)
 
 获取成员信息/管理员列表，发送文字/图片/合并转发消息，仅支持onebot
+
+现在只做了lagrange和napcat的适配
+
+## dev 
+查看git大文件
+```shell
+git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | Where-Object { $_ -match '^blob' } | ForEach-Object { $parts = $_ -split ' ', 4; [PSCustomObject]@{ Size = [int]$parts[2]; Name = $parts[3] } } | Sort-Object Size -Descending | Select-Object -First 20 
+```
+
+发布到npm workflow
+```shell
+cd G:\GGames\Minecraft\shuyeyun\qq-bot\koishi-dev\koishi-dev-3\external\onebot-info-image
+git add .
+git commit -m "message"
+git push origin main
+
+# ensure plugin dir name is onebot-info-image, then:
+cd G:\GGames\Minecraft\shuyeyun\qq-bot\koishi-dev\koishi-dev-3
+yarn
+yarn build onebot-info-image
+
+$Env:HTTP_PROXY = "http://127.0.0.1:7890"
+$Env:HTTPS_PROXY = "http://127.0.0.1:7890"
+Invoke-WebRequest -Uri "https://www.google.com" -Method Head -UseBasicParsing
+npm login --registry https://registry.npmjs.org
+# login npm in browser
+npm run pub onebot-info-image -- --registry https://registry.npmjs.org
+
+npm-stat.com
+```