weflow-cli 1.5.0

package/dist/src/services/wereadService.js

@@ -0,0 +1,145 @@
+/**
+ * 微信读书 Agent API Gateway 封装
+ *
+ * 接口文档: ~/.claude/skills/weread-skills/
+ * Gateway:  https://i.weread.qq.com/api/agent/gateway
+ */
+import https from 'node:https';
+const GATEWAY = 'https://i.weread.qq.com/api/agent/gateway';
+const SKILL_VERSION = '1.0.3';
+// weread.qq.com 服务端不支持 TLS 1.3，需要强制使用 TLS 1.2
+const httpsAgent = new https.Agent({ maxVersion: 'TLSv1.2' });
+export class WereadService {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey || process.env.WEREAD_API_KEY || '';
+    }
+    async call(apiName, params = {}) {
+        if (!this.apiKey) {
+            return { ok: false, error: '未设置 WEREAD_API_KEY，请设置环境变量或在 CLI 中配置' };
+        }
+        try {
+            const body = JSON.stringify({ api_name: apiName, skill_version: SKILL_VERSION, ...params });
+            const json = await new Promise((resolve, reject) => {
+                const url = new URL(GATEWAY);
+                const req = https.request({
+                    hostname: url.hostname,
+                    path: url.pathname,
+                    method: 'POST',
+                    agent: httpsAgent,
+                    headers: {
+                        'Authorization': `Bearer ${this.apiKey}`,
+                        'Content-Type': 'application/json',
+                        'Content-Length': Buffer.byteLength(body),
+                    },
+                }, (res) => {
+                    let data = '';
+                    res.on('data', (chunk) => data += chunk.toString());
+                    res.on('end', () => {
+                        try {
+                            resolve(JSON.parse(data));
+                        }
+                        catch {
+                            reject(new Error(`Invalid JSON response: ${data.slice(0, 200)}`));
+                        }
+                    });
+                });
+                req.on('error', reject);
+                req.write(body);
+                req.end();
+            });
+            if (json.errcode && json.errcode !== 0) {
+                return { ok: false, error: `API 错误: ${json.errmsg || json.errcode}` };
+            }
+            return { ok: true, data: json };
+        }
+        catch (e) {
+            return { ok: false, error: `请求失败: ${e.message}` };
+        }
+    }
+    /** 书架同步 */
+    async shelf() {
+        return this.call('/shelf/sync');
+    }
+    /** 阅读统计: mode = weekly | monthly | annually | overall */
+    async readData(mode = 'monthly', baseTime) {
+        const params = { mode };
+        if (baseTime !== undefined)
+            params.baseTime = baseTime;
+        return this.call('/readdata/detail', params);
+    }
+    /** 笔记列表: 获取用户的笔记本列表 */
+    async notebooks(count = 100, lastSort) {
+        const params = { count };
+        if (lastSort !== undefined)
+            params.lastSort = lastSort;
+        return this.call('/user/notebooks', params);
+    }
+    /** 某本书的划线 */
+    async bookmarks(bookId, count = 50) {
+        return this.call('/book/bookmarklist', { bookId, count });
+    }
+    /** 某本书的热门划线 */
+    async bestBookmarks(bookId, count = 20) {
+        return this.call('/book/bestbookmarks', { bookId, count });
+    }
+    /** 搜索书籍 */
+    async search(keyword, count = 10, scope = 'all') {
+        return this.call('/store/search', { keyword, count, scope });
+    }
+    /** 书籍详情 */
+    async bookInfo(bookId) {
+        return this.call('/book/info', { bookId });
+    }
+    /** 章节目录 */
+    async chapterInfo(bookId) {
+        return this.call('/book/chapterinfo', { bookId });
+    }
+    /** 阅读进度 */
+    async getProgress(bookId) {
+        return this.call('/book/getprogress', { bookId });
+    }
+    /** 书评 */
+    async reviews(bookId, count = 20, sort = 'hot') {
+        return this.call('/book/readreviews', { bookId, count, sort });
+    }
+    /** 个性化推荐 */
+    async recommend(count = 10) {
+        return this.call('/book/recommend', { count });
+    }
+    /** 相似推荐 */
+    async similar(bookId, count = 5) {
+        return this.call('/book/recommend', { bookId, count, type: 'similar' });
+    }
+    /** 个人中心（聚合多个接口） */
+    async profile() {
+        const [shelfRes, readRes] = await Promise.all([
+            this.shelf(),
+            this.readData('overall'),
+        ]);
+        if (!shelfRes.ok)
+            return { ok: false, error: shelfRes.error };
+        if (!readRes.ok)
+            return { ok: false, error: readRes.error };
+        const shelf = shelfRes.data;
+        const read = readRes.data;
+        return {
+            ok: true,
+            data: {
+                vid: '',
+                name: '',
+                avatar: '',
+                gender: 0,
+                totalReadTime: read.totalReadTime || 0,
+                totalReadDays: read.readDays || 0,
+                totalBooks: shelf.books?.length || 0,
+                totalFinished: shelf.books?.filter(b => b.finishReading === 1).length || 0,
+                totalNotes: 0,
+                totalHighlights: 0,
+                totalReviews: 0,
+            },
+        };
+    }
+}
+export const wereadService = new WereadService();
+//# sourceMappingURL=wereadService.js.map

package/dist/src/services/wereadService.js.map

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

package/dist/src/services/whitelistService.d.ts

@@ -0,0 +1,20 @@
+export interface WhitelistEntry {
+    wxid: string;
+    displayName: string;
+}
+export declare class WhitelistService {
+    getList(): string[];
+    isAllowed(wxid: string): boolean;
+    /** 直接添加 wxid（不解析昵称），用于 CLI 确认后的最终写入 */
+    addDirect(wxid: string): void;
+    add(target: string): Promise<{
+        success: boolean;
+        error?: string;
+        wxid?: string;
+    }>;
+    remove(wxid: string): boolean;
+    clear(): void;
+    reload(): void;
+}
+export declare const whitelistService: WhitelistService;
+//# sourceMappingURL=whitelistService.d.ts.map

package/dist/src/services/whitelistService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whitelistService.d.ts","sourceRoot":"","sources":["../../../src/services/whitelistService.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,IAAI,MAAM,EAAE;IAInB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQvB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBvF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS7B,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;CAGf;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}

package/dist/src/services/whitelistService.js

@@ -0,0 +1,60 @@
+/**
+ * 白名单服务 — 控制消息收发权限，仅白名单内 wxid 可收发消息。
+ */
+import { configService } from './configService.js';
+import { resolveTalker } from '../utils/talkerUtils.js';
+export class WhitelistService {
+    getList() {
+        return configService.getWhitelist();
+    }
+    isAllowed(wxid) {
+        return configService.getWhitelist().includes(wxid);
+    }
+    /** 直接添加 wxid（不解析昵称），用于 CLI 确认后的最终写入 */
+    addDirect(wxid) {
+        const list = configService.getWhitelist();
+        if (!list.includes(wxid)) {
+            list.push(wxid);
+            configService.setWhitelist(list);
+        }
+    }
+    async add(target) {
+        let wxid;
+        // 已知格式直接使用，否则通过 resolveTalker 解析
+        if (target.startsWith('wxid_') || target.includes('@chatroom') || target.includes('@openim')) {
+            wxid = target;
+        }
+        else {
+            try {
+                wxid = await resolveTalker(target);
+            }
+            catch (e) {
+                return { success: false, error: `无法解析 "${target}": ${e.message}` };
+            }
+        }
+        const list = configService.getWhitelist();
+        if (list.includes(wxid)) {
+            return { success: false, error: `"${wxid}" 已在白名单中` };
+        }
+        list.push(wxid);
+        configService.setWhitelist(list);
+        return { success: true, wxid };
+    }
+    remove(wxid) {
+        const list = configService.getWhitelist();
+        const idx = list.indexOf(wxid);
+        if (idx < 0)
+            return false;
+        list.splice(idx, 1);
+        configService.setWhitelist(list);
+        return true;
+    }
+    clear() {
+        configService.setWhitelist([]);
+    }
+    reload() {
+        // configService 每次 getWhitelist 都从内存读取，无需主动 reload
+    }
+}
+export const whitelistService = new WhitelistService();
+//# sourceMappingURL=whitelistService.js.map

package/dist/src/services/whitelistService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whitelistService.js","sourceRoot":"","sources":["../../../src/services/whitelistService.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAOvD,MAAM,OAAO,gBAAgB;IAC3B,OAAO;QACL,OAAO,aAAa,CAAC,YAAY,EAAE,CAAA;IACrC,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,aAAa,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACpD,CAAC;IAED,uCAAuC;IACvC,SAAS,CAAC,IAAY;QACpB,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,EAAE,CAAA;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACf,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,IAAI,IAAY,CAAA;QAEhB,iCAAiC;QACjC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7F,IAAI,GAAG,MAAM,CAAA;QACf,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;YACpC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,MAAM,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAA;YACpE,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,EAAE,CAAA;QACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,CAAA;QACtD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACf,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,EAAE,CAAA;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACnB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK;QACH,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,MAAM;QACJ,mDAAmD;IACrD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAA"}

package/dist/src/types.d.ts

@@ -0,0 +1,140 @@
+export interface WxidInfo {
+    wxid: string;
+    modifiedTime: number;
+    nickname?: string;
+    avatarUrl?: string;
+}
+export interface ChatSession {
+    username: string;
+    type: number;
+    unreadCount: number;
+    summary: string;
+    sortTimestamp: number;
+    lastTimestamp: number;
+    displayName?: string;
+    avatarUrl?: string;
+    lastMsgType?: number;
+}
+export interface Message {
+    localId: number;
+    serverId: string;
+    localType: number;
+    createTime: number;
+    isSend: number | null;
+    senderUsername: string | null;
+    content: string;
+    rawContent: string;
+    parsedContent: string;
+    mediaType?: string;
+    mediaFileName?: string;
+    /** Type=3 图片: 缩略图 base64 数据 */
+    imageBase64?: string;
+    /** Type=3 图片: 图片文件名 (UUID.png) */
+    imageFileName?: string;
+    /** Type=49 AppMsg: 标题 */
+    appTitle?: string;
+    /** Type=49 AppMsg: 描述 */
+    appDescription?: string;
+    /** Type=49 AppMsg: URL */
+    appUrl?: string;
+}
+export interface Contact {
+    username: string;
+    displayName: string;
+    remark?: string;
+    nickname?: string;
+    alias?: string;
+    avatarUrl?: string;
+    type?: string;
+}
+export interface WechatOCConfig {
+    baseUrl?: string;
+    cdnBaseUrl?: string;
+    botType?: string;
+    token?: string;
+    accountId?: string;
+    syncBuf?: string;
+    contextTokens?: Record<string, string>;
+    longPollTimeoutMs?: number;
+    apiTimeoutMs?: number;
+    typingKeepaliveIntervalS?: number;
+    typingTicketTtlS?: number;
+}
+export interface WechatLoginSession {
+    sessionKey: string;
+    qrcode: string;
+    qrcodeImgContent: string;
+    startedAt: number;
+    status: 'wait' | 'confirmed' | 'expired' | 'scanned';
+    botToken?: string;
+    accountId?: string;
+    baseUrl?: string;
+    userId?: string;
+    error?: string;
+}
+export interface WechatInboundMessage {
+    messageId: string;
+    fromUserId: string;
+    senderNickname: string;
+    timestamp: number;
+    timestampMs: number;
+    components: WechatMessageComponent[];
+    messageStr: string;
+    messageKind: 'text' | 'image' | 'voice' | 'file' | 'video' | 'unknown';
+    rawMessage: Record<string, any>;
+    isReply: boolean;
+    quotedText?: string;
+}
+export type WechatMessageComponent = {
+    type: 'plain';
+    text: string;
+} | {
+    type: 'image';
+    filePath: string;
+} | {
+    type: 'record';
+    filePath: string;
+} | {
+    type: 'file';
+    name: string;
+    filePath: string;
+} | {
+    type: 'video';
+    filePath: string;
+};
+export interface ExportOptions {
+    talker: string;
+    format: 'json' | 'html' | 'txt' | 'excel';
+    output: string;
+    limit?: number;
+    start?: string;
+    end?: string;
+}
+export interface DbKeyResult {
+    success: boolean;
+    key?: string;
+    error?: string;
+    logs?: string[];
+}
+export type DataVersion = '3.x' | '4.x';
+export interface ConfigData {
+    dbPath?: string;
+    wxid?: string;
+    decryptKey?: string;
+    decryptKey3x?: string;
+    dataVersion?: DataVersion;
+    dbPath3x?: string;
+    /** NT 格式: 主消息数据库路径 (message_0.db) */
+    ntDbPath?: string;
+    /** NT 格式: 64位十六进制密钥 */
+    ntKey?: string;
+    /** NT 格式: 32位十六进制盐值 */
+    ntSalt?: string;
+    /** NT 格式: 联系人数据库路径 (contact.db) */
+    contactDbPath?: string;
+    /** NT 格式: contact.db 64位十六进制密钥 */
+    contactKey?: string;
+    /** NT 格式: contact.db 32位十六进制盐值 */
+    contactSalt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/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/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * WeflowError - weflow-cli 统一错误类
+ *
+ * 提供结构化的错误信息，包含：
+ * - message: 人类可读的错误描述
+ * - code: 错误代码（用于程序化判断）
+ * - exitCode: 进程退出码
+ */
+export declare class WeflowError extends Error {
+    code: string;
+    exitCode: number;
+    constructor(message: string, code?: string, exitCode?: number);
+}
+/**
+ * 统一错误处理函数。
+ *
+ * 根据错误类型输出对应的错误信息并以合适的退出码退出进程：
+ * - WeflowError: 使用其自带的 exitCode
+ * - 普通 Error: 视为未预期错误，退出码 1
+ * - 其他: 视为未知错误，退出码 1
+ *
+ * @param e 捕获到的错误对象
+ */
+export declare function handleError(e: unknown): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,WAAY,SAAQ,KAAK;IAG3B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;gBAFvB,OAAO,EAAE,MAAM,EACR,IAAI,GAAE,MAAkB,EACxB,QAAQ,GAAE,MAAU;CAK9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAW5C"}

package/dist/src/utils/errors.js

@@ -0,0 +1,43 @@
+/**
+ * WeflowError - weflow-cli 统一错误类
+ *
+ * 提供结构化的错误信息，包含：
+ * - message: 人类可读的错误描述
+ * - code: 错误代码（用于程序化判断）
+ * - exitCode: 进程退出码
+ */
+export class WeflowError extends Error {
+    code;
+    exitCode;
+    constructor(message, code = 'UNKNOWN', exitCode = 1) {
+        super(message);
+        this.code = code;
+        this.exitCode = exitCode;
+        this.name = 'WeflowError';
+    }
+}
+/**
+ * 统一错误处理函数。
+ *
+ * 根据错误类型输出对应的错误信息并以合适的退出码退出进程：
+ * - WeflowError: 使用其自带的 exitCode
+ * - 普通 Error: 视为未预期错误，退出码 1
+ * - 其他: 视为未知错误，退出码 1
+ *
+ * @param e 捕获到的错误对象
+ */
+export function handleError(e) {
+    if (e instanceof WeflowError) {
+        console.error(`[weflow-cli] ${e.message}`);
+        process.exit(e.exitCode);
+    }
+    else if (e instanceof Error) {
+        console.error(`[weflow-cli] 未预期的错误: ${e.message}`);
+        process.exit(1);
+    }
+    else {
+        console.error('[weflow-cli] 未知错误');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAG3B;IACA;IAHT,YACE,OAAe,EACR,OAAe,SAAS,EACxB,WAAmB,CAAC;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHP,SAAI,GAAJ,IAAI,CAAoB;QACxB,aAAQ,GAAR,QAAQ,CAAY;QAG3B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC1B,CAAC;SAAM,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC"}

package/dist/src/utils/pathUtils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Expand "~" prefix to current user's home directory.
+ */
+export declare function expandHomePath(inputPath: string): string;
+//# sourceMappingURL=pathUtils.d.ts.map

package/dist/src/utils/pathUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/pathUtils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUxD"}

package/dist/src/utils/pathUtils.js

@@ -0,0 +1,16 @@
+import { homedir } from 'os';
+/**
+ * Expand "~" prefix to current user's home directory.
+ */
+export function expandHomePath(inputPath) {
+    const raw = String(inputPath || '').trim();
+    if (!raw)
+        return raw;
+    if (raw === '~')
+        return homedir();
+    if (/^~[\\/]/.test(raw)) {
+        return `${homedir()}${raw.slice(1)}`;
+    }
+    return raw;
+}
+//# sourceMappingURL=pathUtils.js.map

package/dist/src/utils/pathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.js","sourceRoot":"","sources":["../../../src/utils/pathUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AAE5B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAA;IAEpB,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAA;IACjC,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACtC,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/src/utils/pythonRunner.d.ts

@@ -0,0 +1,27 @@
+export interface PythonScriptResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface PythonScriptError extends Error {
+    script: string;
+    stderr: string;
+    exitCode: number;
+}
+/** 获取项目根目录 */
+export declare function getProjectRoot(): string;
+/**
+ * 运行 Python 脚本，统一封装路径解析、参数序列化、错误处理。
+ *
+ * @param scriptName 脚本文件名（如 'biz_daily.py'），相对于 scripts/ 目录
+ * @param args 命令行参数数组
+ * @param options 可选配置
+ * @returns 脚本执行结果
+ * @throws PythonScriptError 当脚本执行失败时
+ */
+export declare function runPythonScript(scriptName: string, args?: string[], options?: {
+    cwd?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+}): Promise<PythonScriptResult>;
+//# sourceMappingURL=pythonRunner.d.ts.map

package/dist/src/utils/pythonRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pythonRunner.d.ts","sourceRoot":"","sources":["../../../src/utils/pythonRunner.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,cAAc;AACd,wBAAgB,cAAc,IAAI,MAAM,CAcvC;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC7E,OAAO,CAAC,kBAAkB,CAAC,CAwB7B"}

package/dist/src/utils/pythonRunner.js

@@ -0,0 +1,62 @@
+/**
+ * pythonRunner - 统一的 Python 脚本调用工具
+ *
+ * 消除 bin/weflow-cli.ts 中重复出现的 execFile 调用模式，
+ * 统一封装路径解析、参数序列化、错误处理。
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+const execFileAsync = promisify(execFile);
+/** 获取项目根目录 */
+export function getProjectRoot() {
+    // 兼容 ESM 和 CJS
+    const possibleDirname = typeof __dirname !== 'undefined'
+        ? __dirname
+        : dirname(fileURLToPath(import.meta.url));
+    // 从 src/utils/ 或 bin/ 向上找到 package.json 所在目录
+    let dir = possibleDirname;
+    for (let i = 0; i < 5; i++) {
+        try {
+            if (existsSync(join(dir, 'package.json')))
+                return dir;
+        }
+        catch { }
+        dir = dirname(dir);
+    }
+    return possibleDirname;
+}
+/**
+ * 运行 Python 脚本，统一封装路径解析、参数序列化、错误处理。
+ *
+ * @param scriptName 脚本文件名（如 'biz_daily.py'），相对于 scripts/ 目录
+ * @param args 命令行参数数组
+ * @param options 可选配置
+ * @returns 脚本执行结果
+ * @throws PythonScriptError 当脚本执行失败时
+ */
+export async function runPythonScript(scriptName, args = [], options = {}) {
+    const projectRoot = getProjectRoot();
+    const scriptPath = join(projectRoot, 'scripts', scriptName);
+    const cwd = options.cwd || projectRoot;
+    try {
+        const { stdout, stderr } = await execFileAsync('python', [scriptPath, ...args], {
+            cwd,
+            timeout: options.timeout || 300000, // 默认 5 分钟
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+            env: { ...process.env, ...options.env },
+        });
+        return { stdout, stderr, exitCode: 0 };
+    }
+    catch (e) {
+        const error = Object.assign(new Error(`Python 脚本 ${scriptName} 执行失败: ${e.message}`), {
+            script: scriptName,
+            stderr: e.stderr || '',
+            exitCode: e.code || 1,
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=pythonRunner.js.map

package/dist/src/utils/pythonRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pythonRunner.js","sourceRoot":"","sources":["../../../src/utils/pythonRunner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAE/B,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAczC,cAAc;AACd,MAAM,UAAU,cAAc;IAC5B,eAAe;IACf,MAAM,eAAe,GAAG,OAAO,SAAS,KAAK,WAAW;QACtD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3C,6CAA6C;IAC7C,IAAI,GAAG,GAAG,eAAe,CAAA;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;gBAAE,OAAO,GAAG,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,eAAe,CAAA;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAAiB,EAAE,EACnB,UAA4E,EAAE;IAE9E,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;IAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,WAAW,CAAA;IAEtC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE;YAC9E,GAAG;YACH,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM,EAAE,UAAU;YAC9C,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO;YACpC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxC,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IACxC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,KAAK,GAAsB,MAAM,CAAC,MAAM,CAC5C,IAAI,KAAK,CAAC,aAAa,UAAU,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,EACvD;YACE,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;YACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;SACtB,CACF,CAAA;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/src/utils/talkerUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 将用户输入解析为 talker (wxid)。
+ *
+ * 支持: wxid_xxx / 群聊ID / 昵称 / 备注名 / 序号 [N] / 纯数字
+ *
+ * @throws {Error} 当输入无法解析到任何会话时
+ */
+export declare function resolveTalker(input: string): Promise<string>;
+/**
+ * 批量为 wxid 列表查找 displayName。
+ * 调用 chatService.listSessions 获取带昵称的会话列表。
+ */
+export declare function lookupDisplayNames(wxids: string[]): Promise<Map<string, string>>;
+//# sourceMappingURL=talkerUtils.d.ts.map

package/dist/src/utils/talkerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"talkerUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/talkerUtils.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDlE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAYtF"}