koishi-plugin-group-analysis-mx 1.0.1

package/lib/skins/scrapbook.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScrapbookSkinRenderer = void 0;
+const types_1 = require("./types");
+/**
+ * Scrapbook Skin Renderer
+ * Ported from AstrBot's scrapbook template.
+ * Features a hand-drawn, colorful, and playful aesthetic.
+ */
+class ScrapbookSkinRenderer {
+    id = 'scrapbook';
+    name = 'Scrapbook';
+    containerSelector = '.container';
+    formatUserStats(userStats) {
+        // The scrapbook design doesn't have a dedicated user stats section like rankings in the main view
+        // It relies on "User Titles" (Portraits) for user display.
+        // If we need to display a simple list, we can implement it, but standard AstrBot scrapbook doesn't seem to have a plain ranking list.
+        // We will return empty or a simple hidden block to satisfy the interface.
+        return '';
+    }
+    formatGoldenQuotes(quotes) {
+        if (!quotes || quotes.length === 0) {
+            return '';
+        }
+        const itemsHtml = quotes
+            .map((quote) => `
+        <div class="quote-wrapper">
+            <div class="q-flex-container">
+                <div class="q-user-col">
+                </div>
+
+                <div class="q-content-col">
+                    <div class="q-sender-name">${quote.sender}</div>
+                    <div class="q-bubble">
+                        <div class="q-quote-mark">"</div>
+                        <div class="q-content">${quote.content}</div>
+                    </div>
+                    <div class="q-analysis-note">
+                        <span class="note-label">🤣👉 AI 锐评：</span>
+                        ${quote.reason}
+                    </div>
+                </div>
+            </div>
+        </div>
+        `)
+            .join('');
+        return `
+        <div class="quotes-section">
+            <div class="section-title" style="justify-content: center;">
+                <svg class="doodle" viewBox="0 0 24 24">
+                    <path d="M6 17h3l2-4V7H5v6h3zm8 0h3l2-4V7h-6v6h3z" />
+                </svg>
+                群贤毕至 Bible Quotes
+            </div>
+            ${itemsHtml}
+        </div>
+        `;
+    }
+    formatUserTitles(userTitles) {
+        if (!userTitles || userTitles.length === 0) {
+            return '';
+        }
+        const itemsHtml = userTitles
+            .map((title) => `
+        <div class="user-card">
+            <div class="card-tape"></div>
+            <div class="user-header">
+                <div class="u-avatar">
+                    <img src="${(0, types_1.getAvatarUrl)(title.id)}" alt="头像" style="width: 100%; height: 100%; object-fit: cover;">
+                </div>
+                <div class="u-info">
+                    <div class="u-name">${title.name}</div>
+                    <div class="badges">
+                        <span class="badge title">${title.title}</span>
+                        ${title.mbti && title.mbti !== 'N/A' ? `<span class="badge mbti">${title.mbti}</span>` : ''}
+                    </div>
+                </div>
+            </div>
+            <div class="u-reason">
+                ${title.reason}
+            </div>
+        </div>
+        `)
+            .join('');
+        return `
+        <div class="user-section">
+            <div class="section-title" style="justify-content: center;">
+                <svg class="doodle" viewBox="0 0 24 24">
+                    <path d="M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z" />
+                </svg>
+                群友画像 Portraits
+            </div>
+            <div class="masonry-grid">
+                ${itemsHtml}
+            </div>
+        </div>
+        `;
+    }
+    formatTopics(topics) {
+        if (!topics || topics.length === 0) {
+            return '';
+        }
+        const itemsHtml = topics
+            .map((topic, index) => {
+            const indexStr = String(index + 1).padStart(2, '0');
+            return `
+        <div class="topic-item">
+            <div class="check-box">
+                <div class="check-tick"></div>
+            </div>
+            <div class="topic-content">
+                <div style="display: flex; align-items: baseline; gap: 10px; margin-bottom: 8px;">
+                    <span class="topic-title">${topic.topic}</span>
+                    <span style="font-size: 0.85em; color: #999; font-family: var(--font-body);">#${indexStr}</span>
+                </div>
+                <div style="font-family: var(--font-hand); font-size: 1.05em; color: var(--ink-secondary); margin-bottom: 8px;">
+                    🙋‍♀️ 参与者： ${topic.contributors.join(', ')}
+                </div>
+                <div class="topic-detail">${topic.detail}</div>
+            </div>
+        </div>
+        `;
+        })
+            .join('');
+        return `
+        <div class="topic-section">
+            <div class="paper-holes">
+                <div class="hole"></div>
+                <div class="hole"></div>
+                <div class="hole"></div>
+            </div>
+            <div class="section-title">
+                <svg class="doodle" viewBox="0 0 24 24">
+                    <path d="M14 17H4v2h10v-2zm6-8H4v2h16V9zM4 15h16v-2H4v2zM4 5v2h16V5H4z" />
+                </svg>
+                今日话题 Topics
+            </div>
+            ${itemsHtml}
+        </div>
+        `;
+    }
+    formatTags(tags) {
+        if (!tags || tags.length === 0)
+            return '';
+        const colors = ['c1', 'c2', 'c3', 'c4'];
+        return tags.map((tag, i) => {
+            const colorClass = colors[i % colors.length];
+            return `<div class="washi-tape-tag ${colorClass}">${tag}</div>`;
+        }).join('');
+    }
+    formatEvidence(evidence) {
+        if (!evidence || evidence.length === 0)
+            return '<div class="empty-state">暂无证据</div>';
+        return evidence.map((item, index) => {
+            // Random rotation between -3 and 3 degrees
+            const rot = (Math.random() * 6 - 3).toFixed(1) + 'deg';
+            return `
+            <div class="evidence-card-pin" style="--rot: ${rot};">
+                ${item}
+            </div>
+            `;
+        }).join('');
+    }
+    generateActiveHoursChart(activeHours) {
+        const items = [];
+        let maxCount = 0;
+        for (const count of Object.values(activeHours)) {
+            if (count > maxCount)
+                maxCount = count;
+        }
+        for (let i = 0; i < 24; i++) {
+            const count = activeHours[i] || 0;
+            const percentage = maxCount > 0 ? (count / maxCount) * 100 : 0;
+            let colorVar = 'var(--color-purple)';
+            // Min height 4px to show the bar even if small
+            let height = `max(4px, ${percentage}%)`;
+            if (count === 0) {
+                height = '0px';
+            }
+            else if (percentage >= 70) {
+                colorVar = 'var(--accent-orange)';
+            }
+            else if (percentage >= 30) {
+                colorVar = 'var(--color-green)';
+            }
+            else {
+                colorVar = 'var(--color-blue)';
+            }
+            // Add a class to conditionally show values if count > 0
+            const columnClass = count > 0 ? 'chart-column show-value' : 'chart-column';
+            items.push(`
+            <div class="${columnClass}" title="${String(i).padStart(2, '0')}:00 - ${count}条">
+                <div class="bar-value-top">${count > 0 ? count : ''}</div>
+                <div class="bar-vertical" style="height: ${height}; background: ${colorVar};"></div>
+                <div class="bar-label-x">${String(i).padStart(2, '0')}</div>
+            </div>
+            `);
+        }
+        return `
+        <div class="chart-container-horizontal">
+            ${items.join('')}
+        </div>
+        `;
+    }
+}
+exports.ScrapbookSkinRenderer = ScrapbookSkinRenderer;
+//# sourceMappingURL=scrapbook.js.map

package/lib/skins/scrapbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrapbook.js","sourceRoot":"","sources":["../../src/skins/scrapbook.ts"],"names":[],"mappings":";;;AAAA,mCAAoD;AAGpD;;;;GAIG;AACH,MAAa,qBAAqB;IACrB,EAAE,GAAG,WAAW,CAAA;IAChB,IAAI,GAAG,WAAW,CAAA;IAClB,iBAAiB,GAAG,YAAY,CAAA;IAEzC,eAAe,CAAC,SAAsB;QAClC,kGAAkG;QAClG,2DAA2D;QAC3D,sIAAsI;QACtI,0EAA0E;QAC1E,OAAO,EAAE,CAAA;IACb,CAAC;IAED,kBAAkB,CAAC,MAA2C;QAC1D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,CAAA;QACb,CAAC;QAED,MAAM,SAAS,GAAG,MAAM;aACnB,GAAG,CACA,CAAC,KAAK,EAAE,EAAE,CAAC;;;;;;;iDAOsB,KAAK,CAAC,MAAM;;;iDAGZ,KAAK,CAAC,OAAO;;;;0BAIpC,KAAK,CAAC,MAAM;;;;;SAK7B,CACI;aACA,IAAI,CAAC,EAAE,CAAC,CAAA;QAEb,OAAO;;;;;;;;cAQD,SAAS;;SAEd,CAAA;IACL,CAAC;IAED,gBAAgB,CAAC,UAA6C;QAC1D,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,CAAA;QACb,CAAC;QAED,MAAM,SAAS,GAAG,UAAU;aACvB,GAAG,CACA,CAAC,KAAK,EAAE,EAAE,CAAC;;;;;gCAKK,IAAA,oBAAY,EAAC,KAAK,CAAC,EAAE,CAAC;;;0CAGZ,KAAK,CAAC,IAAI;;oDAEA,KAAK,CAAC,KAAK;0BACrC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,4BAA4B,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE;;;;;kBAKjG,KAAK,CAAC,MAAM;;;SAGrB,CACI;aACA,IAAI,CAAC,EAAE,CAAC,CAAA;QAEb,OAAO;;;;;;;;;kBASG,SAAS;;;SAGlB,CAAA;IACL,CAAC;IAED,YAAY,CAAC,MAAqC;QAC9C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,CAAA;QACb,CAAC;QAED,MAAM,SAAS,GAAG,MAAM;aACnB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YACnD,OAAO;;;;;;;gDAOyB,KAAK,CAAC,KAAK;oGACyC,QAAQ;;;iCAG3E,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;;4CAElB,KAAK,CAAC,MAAM;;;SAG/C,CAAA;QACG,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC,CAAA;QAEb,OAAO;;;;;;;;;;;;;cAaD,SAAS;;SAEd,CAAA;IACL,CAAC;IAED,UAAU,CAAC,IAAc;QACrB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;QACzC,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;YAC5C,OAAO,8BAA8B,UAAU,KAAK,GAAG,QAAQ,CAAA;QACnE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACf,CAAC;IAED,cAAc,CAAC,QAAkB;QAC7B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,qCAAqC,CAAA;QACpF,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAChC,2CAA2C;YAC3C,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;YACtD,OAAO;2DACwC,GAAG;kBAC5C,IAAI;;aAET,CAAA;QACL,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACf,CAAC;IAED,wBAAwB,CAAC,WAAmC;QACxD,MAAM,KAAK,GAAG,EAAE,CAAA;QAChB,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,IAAI,KAAK,GAAG,QAAQ;gBAAE,QAAQ,GAAG,KAAK,CAAA;QAC1C,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YACjC,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YAE9D,IAAI,QAAQ,GAAG,qBAAqB,CAAA;YACpC,+CAA+C;YAC/C,IAAI,MAAM,GAAG,YAAY,UAAU,IAAI,CAAA;YAEvC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBACd,MAAM,GAAG,KAAK,CAAA;YAClB,CAAC;iBAAM,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;gBAC1B,QAAQ,GAAG,sBAAsB,CAAA;YACrC,CAAC;iBAAM,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;gBAC1B,QAAQ,GAAG,oBAAoB,CAAA;YACnC,CAAC;iBAAM,CAAC;gBACJ,QAAQ,GAAG,mBAAmB,CAAA;YAClC,CAAC;YAED,wDAAwD;YACxD,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,cAAc,CAAA;YAE1E,KAAK,CAAC,IAAI,CAAC;0BACG,WAAW,YAAY,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,SAAS,KAAK;6CAC5C,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;2DACR,MAAM,iBAAiB,QAAQ;2CAC/C,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;;aAExD,CAAC,CAAA;QACN,CAAC;QAED,OAAO;;cAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;;SAEnB,CAAA;IACL,CAAC;CACJ;AApND,sDAoNC"}

package/lib/skins/types.d.ts

@@ -0,0 +1,69 @@
+import { GroupAnalysisResult, UserPersonaProfile, UserStats } from '../types';
+/**
+ * Skin renderer interface
+ * Each skin must implement these methods to render different components
+ */
+export interface SkinRenderer {
+    /**
+     * Skin identifier (e.g., 'md3', 'anime')
+     */
+    readonly id: string;
+    /**
+     * Human-readable skin name
+     */
+    readonly name: string;
+    /**
+     * CSS selector for the main container element to screenshot
+     * This is used by Puppeteer to find the element to capture
+     */
+    readonly containerSelector: string;
+    /**
+     * Format user statistics list
+     * @param userStats Array of user statistics
+     * @returns HTML string
+     */
+    formatUserStats(userStats: UserStats[]): string;
+    /**
+     * Format golden quotes section
+     * @param quotes Array of golden quotes
+     * @returns HTML string
+     */
+    formatGoldenQuotes(quotes: GroupAnalysisResult['goldenQuotes']): string;
+    /**
+     * Format user titles section
+     * @param userTitles Array of user titles
+     * @returns HTML string
+     */
+    formatUserTitles(userTitles: GroupAnalysisResult['userTitles']): string;
+    /**
+     * Format topics section
+     * @param topics Array of discussion topics
+     * @returns HTML string
+     */
+    formatTopics(topics: GroupAnalysisResult['topics']): string;
+    /**
+     * Generate active hours chart
+     * @param activeHours Record mapping hour (0-23) to message count
+     * @returns HTML string
+     */
+    generateActiveHoursChart(activeHours: Record<number, number>): string;
+    /**
+     * Format tags for user persona (optional)
+     * @param tags Array of tags
+     * @returns HTML string
+     */
+    formatTags?(tags: string[] | undefined): string;
+    /**
+     * Format evidence for user persona (optional)
+     * @param evidence Array of evidence strings
+     * @returns HTML string
+     */
+    formatEvidence?(evidence: UserPersonaProfile['evidence']): string;
+}
+/**
+ * Get avatar URL for a user
+ * @param userId User ID (QQ number)
+ * @returns Avatar URL
+ */
+export declare function getAvatarUrl(userId: number | string): string;
+//# sourceMappingURL=types.d.ts.map

package/lib/skins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skins/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAgB,MAAM,UAAU,CAAA;AAE3F;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAElC;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAA;IAE/C;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,MAAM,CAAA;IAEvE;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,GAAG,MAAM,CAAA;IAEvE;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAA;IAE3D;;;;OAIG;IACH,wBAAwB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IAErE;;;;OAIG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAAA;IAE/C;;;;OAIG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,MAAM,CAAA;CACpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE5D"}

package/lib/skins/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAvatarUrl = getAvatarUrl;
+/**
+ * Get avatar URL for a user
+ * @param userId User ID (QQ number)
+ * @returns Avatar URL
+ */
+function getAvatarUrl(userId) {
+    return `http://q1.qlogo.cn/g?b=qq&nk=${userId}&s=640`;
+}
+//# sourceMappingURL=types.js.map

package/lib/skins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skins/types.ts"],"names":[],"mappings":";;AA8EA,oCAEC;AAPD;;;;GAIG;AACH,SAAgB,YAAY,CAAC,MAAuB;IAChD,OAAO,gCAAgC,MAAM,QAAQ,CAAA;AACzD,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,170 @@
+import { h } from "koishi";
+export interface OneBotMessage {
+    message_id: number;
+    message_seq: number;
+    time: number;
+    message: string | OneBotMessageType[];
+    raw_message: string;
+    sender: {
+        user_id: number;
+        nickname: string;
+        card?: string;
+    };
+}
+export interface OneBotMessageType {
+    type: string;
+    data: Record<string, string>;
+}
+export interface UserStats {
+    userId: string;
+    nickname: string;
+    messageCount: number;
+    charCount: number;
+    lastActive: Date;
+    avatar?: string;
+    replyCount: number;
+    emojiRatio: number;
+    atCount: number;
+    emojiStats: Record<string, number>;
+    nightRatio: number;
+    avgChars: number;
+    replyRatio: number;
+    nightMessages: number;
+    activeHours: Record<number, number>;
+}
+export interface SummaryTopic {
+    topic: string;
+    contributors: string[];
+    detail: string;
+}
+export interface UserTitle {
+    name: string;
+    id: number;
+    title: string;
+    mbti: string;
+    reason: string;
+    avatar?: string;
+}
+export interface GoldenQuote {
+    content: string;
+    sender: string;
+    reason: string;
+}
+export interface UserPersonaProfile {
+    userId: string;
+    username: string;
+    summary: string;
+    keyTraits: string[];
+    interests: string[];
+    communicationStyle: string;
+    analysisDate?: string;
+    evidence: string[];
+    lastMergedFromHistory?: boolean;
+}
+export interface GroupAnalysisResult {
+    totalMessages: number;
+    totalChars: number;
+    totalParticipants: number;
+    emojiCount: number;
+    mostActiveUser: UserStats | null;
+    mostActivePeriod: string;
+    userStats: UserStats[];
+    topics: SummaryTopic[];
+    userTitles: UserTitle[];
+    goldenQuotes: GoldenQuote[];
+    activeHoursChart: string;
+    activeHoursData: Record<number, number>;
+    analysisDate: string;
+    groupName: string;
+}
+export type QueryAction = '只分析' | '分析加对话' | '只对话';
+export interface QueryTargetTime {
+    description?: string;
+    startTime?: string;
+    endTime?: string;
+}
+export interface QueryIntent {
+    action?: QueryAction;
+    keywords?: string[];
+    topics?: string[];
+    nicknames?: string[];
+    targetTime?: QueryTargetTime;
+    query?: string;
+}
+export interface AnalysisPromptContext {
+    keywords?: string[];
+    topics?: string[];
+    nicknames?: string[];
+    query?: string;
+    timeRange?: {
+        start?: Date;
+        end?: Date;
+        description?: string;
+    };
+}
+export interface BasicStatsResult {
+    userStats: Record<string, UserStats>;
+    totalChars: number;
+    totalEmojiCount: number;
+    allMessagesText: string[];
+}
+export interface GroupMessageFetchFilter {
+    guildId?: string;
+    channelId?: string;
+    userId?: string[];
+    selfId?: string;
+    startTime?: string;
+    endTime?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface MessageFilter {
+    guildId?: string;
+    channelId?: string;
+    userId?: string[];
+    selfId?: string;
+    startTime?: Date;
+    endTime?: Date;
+    limit?: number;
+    offset?: number;
+    purpose?: 'group-analysis' | 'user-persona' | 'general';
+}
+export interface StoredMessage {
+    id: string;
+    platform: string;
+    selfId: string;
+    channelId: string;
+    avatarUrl: string;
+    guildId?: string;
+    userId: string;
+    username: string;
+    content: string;
+    timestamp: Date;
+    messageId?: string;
+    elements?: h[];
+}
+export interface ActivityStats {
+    windowStart: number;
+    count: number;
+}
+export interface PersistenceBuffer {
+    messages: StoredMessage[];
+    lastMessageAt: number;
+}
+export interface PersonaRecord {
+    id: string;
+    platform: string;
+    selfId: string;
+    userId: string;
+    username: string;
+    roles: string[];
+    persona?: string;
+    lastAnalysisAt?: Date;
+    updatedAt?: Date;
+}
+export interface PersonaCache {
+    record: PersonaRecord;
+    pendingMessages: number;
+    parsedPersona?: UserPersonaProfile | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/utils.d.ts

@@ -0,0 +1,55 @@
+import { Context } from 'koishi';
+import { BasicStatsResult, GroupAnalysisResult, StoredMessage, UserPersonaProfile, UserStats } from './types';
+import { Config } from './config';
+import type { OneBotBot } from 'koishi-plugin-adapter-onebot';
+export declare function calculateBasicStats(messages: StoredMessage[]): BasicStatsResult;
+export declare function buildPersonaRecordId(platform: string, selfId: string, userId: string | number): string;
+export declare function generateTextReport(result: GroupAnalysisResult): string;
+export declare function getAvatarUrl(userId: number | string): string;
+export declare function formatUserStats(userStats: UserStats[], skin?: string): string;
+export declare function formatGoldenQuotes(quotes: GroupAnalysisResult['goldenQuotes'], skin?: string): string;
+export declare function formatUserTitles(userTitles: GroupAnalysisResult['userTitles'], skin?: string): string;
+export declare function formatTopics(topics: GroupAnalysisResult['topics'], skin?: string): string;
+export declare function generateActiveHoursChart(activeHours: Record<number, number>, skin?: string): string;
+export declare function renderTemplate(template: string, data: Record<string, string>): string;
+export declare function shouldListenToMessage(session: {
+    guildId?: string;
+    channelId?: string;
+    platform: string;
+    selfId: string;
+}, listenerGroups: {
+    enabled: boolean;
+    platform: string;
+    selfId: string;
+    channelId: string;
+    guildId?: string;
+}[], enableAllGroupsByDefault?: boolean): boolean;
+export declare function inferPlatformInfo(filter: {
+    guildId?: string;
+    channelId?: string;
+}, listenerGroups: Config['listenerGroups']): {
+    platform?: string;
+    guildId?: string;
+    channelId?: string;
+    selfId?: string;
+};
+export declare function getStartTimeByDays(days: number): Date;
+export declare function normalizeArray(value: string[] | string | '无' | undefined): string[];
+export declare function preferArray(primary?: string[] | null, fallback?: string[] | null): string[];
+export declare function finalizePersonaList(list: string[]): string[] | '无';
+export declare function normalizePersonaText(text: string | undefined): string;
+export declare function formatMessagesForPersona(messages: StoredMessage[]): string;
+export declare function formatPersonaForPrompt(persona?: UserPersonaProfile | null): string;
+export declare function mergePersona(previous: UserPersonaProfile | null | undefined, current: UserPersonaProfile): UserPersonaProfile;
+export declare function isCacheExpiredByDays(lastAnalysisAt: Date | undefined, ttlDays: number): boolean;
+export declare function isCacheExpiredByMinutes(lastAnalysisAt: Date | undefined, ttlMinutes: number): boolean;
+export declare function buildGroupAnalysisCacheKey(selfId: string, target: {
+    guildId?: string;
+    channelId?: string;
+}, days: number): string;
+export declare function buildMessagePersistenceKey(message: StoredMessage): string;
+export declare function isNapCatBot(bot: OneBotBot<Context>): Promise<{
+    isRunningNapCat: boolean;
+    botAppName: string;
+}>;
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}