@gloablehive/celphone-wechat-plugin 1.0.0

package/dist/src/cache/writer.js

@@ -0,0 +1,461 @@
+/**
+ * Cache Writer - File writing with monthly partition
+ *
+ * Aligned with Claude Code memory system:
+ * - YAML frontmatter for metadata
+ * - Markdown content
+ * - Monthly file partitioning
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { getMonthlyFilePath, } from './types.js';
+// ========== Constants ==========
+const ENCODING = 'utf-8';
+// ========== Frontmatter Helpers ==========
+function generateConversationFrontmatter(wechatId, accountId, accountWechatId, subtype, messageCount) {
+    const now = new Date().toISOString();
+    return {
+        name: `与 ${wechatId} 的对话`,
+        description: `与 ${wechatId} 的对话记录`,
+        type: 'conversation',
+        subtype,
+        wechatId,
+        accountId,
+        accountWechatId,
+        lastContact: now,
+        messageCount,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+function generateUserProfileFrontmatter(wechatId, accountId, tags) {
+    const now = new Date().toISOString();
+    return {
+        name: `${wechatId} 用户画像`,
+        description: `用户画像信息`,
+        type: 'user',
+        wechatId,
+        accountId,
+        tags,
+        addedAt: now,
+        lastContact: now,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+function frontmatterToString(frontmatter) {
+    const lines = ['---'];
+    for (const [key, value] of Object.entries(frontmatter)) {
+        if (Array.isArray(value)) {
+            lines.push(`${key}: [${value.map(v => `"${v}"`).join(', ')}]`);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            lines.push(`${key}: ${JSON.stringify(value)}`);
+        }
+        else {
+            lines.push(`${key}: ${value}`);
+        }
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+// ========== Conversation File Operations ==========
+/**
+ * Get or create conversation directory
+ */
+export async function ensureConversationDir(basePath, accountId, subtype, conversationId) {
+    const dir = subtype === 'friend'
+        ? `${basePath}/accounts/${accountId}/friends/${conversationId}/memory`
+        : `${basePath}/accounts/${accountId}/chatrooms/${conversationId}/memory`;
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Get monthly conversation file path
+ */
+export function getConversationFilePath(basePath, accountId, subtype, conversationId, date) {
+    const monthlyFile = getMonthlyFilePath(conversationId, date);
+    const dir = subtype === 'friend'
+        ? `${basePath}/accounts/${accountId}/friends/${conversationId}/memory`
+        : `${basePath}/accounts/${accountId}/chatrooms/${conversationId}/memory`;
+    return path.join(dir, monthlyFile);
+}
+/**
+ * Check if conversation file exists
+ */
+export async function conversationFileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read conversation file
+ */
+export async function readConversationFile(filePath) {
+    try {
+        return await fs.readFile(filePath, ENCODING);
+    }
+    catch (error) {
+        throw new Error(`Failed to read conversation file: ${error}`);
+    }
+}
+/**
+ * Create new conversation file with frontmatter
+ */
+export async function createConversationFile(filePath, wechatId, accountId, accountWechatId, subtype) {
+    const frontmatter = generateConversationFrontmatter(wechatId, accountId, accountWechatId, subtype, 0);
+    const content = frontmatterToString(frontmatter) + '\n\n# Conversation\n\n';
+    await fs.writeFile(filePath, content, ENCODING);
+}
+/**
+ * Append message to conversation file
+ */
+export async function appendMessageToConversation(filePath, message, remark) {
+    let content;
+    try {
+        content = await fs.readFile(filePath, ENCODING);
+    }
+    catch {
+        // File doesn't exist, create it
+        content = '';
+    }
+    // Parse existing frontmatter
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    let frontmatter;
+    let existingContent = content;
+    if (frontmatterMatch) {
+        // Parse existing frontmatter
+        const fmLines = frontmatterMatch[1].split('\n');
+        const fm = {};
+        for (const line of fmLines) {
+            const [key, ...valueParts] = line.split(':');
+            if (key && valueParts.length) {
+                const value = valueParts.join(':').trim();
+                if (value.startsWith('[')) {
+                    // Array
+                    fm[key.trim()] = value.slice(1, -1).split(',').map(v => v.trim().replace(/"/g, ''));
+                }
+                else if (value === 'true' || value === 'false') {
+                    fm[key.trim()] = value === 'true';
+                }
+                else {
+                    fm[key.trim()] = value.replace(/"/g, '');
+                }
+            }
+        }
+        frontmatter = fm;
+        frontmatter.messageCount = (frontmatter.messageCount || 0) + 1;
+        frontmatter.lastContact = new Date(message.timestamp).toISOString();
+        frontmatter.updatedAt = new Date().toISOString();
+        if (remark) {
+            frontmatter.name = `与 ${remark} (${frontmatter.wechatId}) 的对话`;
+        }
+    }
+    else {
+        // Create new frontmatter
+        frontmatter = generateConversationFrontmatter(message.conversationId, message.accountId, '', message.conversationType, 1);
+    }
+    // Build message block
+    const time = new Date(message.timestamp);
+    const timeStr = `[${time.toISOString().split('T')[0]}]`;
+    const sender = message.isSelf ? '我' : (remark || message.senderId);
+    const direction = message.isSelf ? '' : ''; // 可以添加方向标记
+    const messageBlock = `\n${timeStr}\n\n**[${sender}]**: ${message.content}\n`;
+    // Rebuild file
+    const newContent = frontmatterToString(frontmatter) + '\n\n' + messageBlock + '\n' + existingContent.replace(/^---[\s\S]*?---\n\n/, '');
+    await fs.writeFile(filePath, newContent, ENCODING);
+}
+// ========== Profile File Operations ==========
+/**
+ * Get profile file path
+ */
+export function getProfileFilePath(basePath, accountId, wechatId) {
+    return `${basePath}/accounts/${accountId}/profiles/${wechatId}.md`;
+}
+/**
+ * Create or update profile file
+ */
+export async function writeProfile(filePath, profile) {
+    const frontmatter = {
+        name: `${profile.remark || profile.wechatId} 用户画像`,
+        description: `用户画像信息 - ${profile.tags.join(', ')}`,
+        type: 'user',
+        wechatId: profile.wechatId,
+        accountId: profile.accountId,
+        tags: profile.tags,
+        addedAt: profile.addedAt,
+        lastContact: profile.lastContact,
+        createdAt: profile.addedAt,
+        updatedAt: new Date().toISOString(),
+    };
+    let content = frontmatterToString(frontmatter) + '\n\n';
+    // Add profile sections
+    content += '## 基础信息\n';
+    if (profile.remark)
+        content += `- 备注: ${profile.remark}\n`;
+    if (profile.nickName)
+        content += `- 昵称: ${profile.nickName}\n`;
+    if (profile.avatarUrl)
+        content += `- 头像: ${profile.avatarUrl}\n`;
+    content += '\n## 画像标签\n';
+    for (const tag of profile.tags) {
+        content += `- ${tag}\n`;
+    }
+    if (profile.customFields && Object.keys(profile.customFields).length > 0) {
+        content += '\n## 自定义字段\n';
+        for (const [key, value] of Object.entries(profile.customFields)) {
+            content += `- ${key}: ${value}\n`;
+        }
+    }
+    if (profile.conversationSummary) {
+        content += '\n## 对话摘要\n' + profile.conversationSummary + '\n';
+    }
+    if (profile.preferenceHints) {
+        content += '\n## 偏好提示\n' + profile.preferenceHints + '\n';
+    }
+    if (profile.riskFlags && profile.riskFlags.length > 0) {
+        content += '\n## 风险标记\n';
+        for (const flag of profile.riskFlags) {
+            content += `- ${flag}\n`;
+        }
+    }
+    await fs.writeFile(filePath, content, ENCODING);
+}
+/**
+ * Read profile file
+ */
+export async function readProfile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, ENCODING);
+        // Parse frontmatter
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!fmMatch)
+            return null;
+        const fmLines = fmMatch[1].split('\n');
+        const profile = {
+            tags: [],
+            riskFlags: [],
+            customFields: {},
+        };
+        for (const line of fmLines) {
+            const colonIdx = line.indexOf(':');
+            if (colonIdx === -1)
+                continue;
+            const key = line.slice(0, colonIdx).trim();
+            const value = line.slice(colonIdx + 1).trim();
+            switch (key) {
+                case 'wechatId':
+                    profile.wechatId = value.replace(/"/g, '');
+                    break;
+                case 'accountId':
+                    profile.accountId = value.replace(/"/g, '');
+                    break;
+                case 'remark':
+                    profile.remark = value.replace(/"/g, '');
+                    break;
+                case 'nickName':
+                    profile.nickName = value.replace(/"/g, '');
+                    break;
+                case 'tags':
+                    profile.tags = value.slice(1, -1).split(',').map(v => v.trim().replace(/"/g, ''));
+                    break;
+                case 'addedAt':
+                    profile.addedAt = value.replace(/"/g, '');
+                    break;
+                case 'lastContact':
+                    profile.lastContact = value.replace(/"/g, '');
+                    break;
+            }
+        }
+        return profile;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Update profile fields
+ */
+export async function updateProfileFields(filePath, updates) {
+    const existing = await readProfile(filePath);
+    if (!existing) {
+        // Create new profile
+        const newProfile = {
+            wechatId: updates.wechatId || '',
+            accountId: updates.accountId || '',
+            remark: updates.remark || '',
+            nickName: updates.nickName || '',
+            tags: updates.tags || [],
+            customFields: updates.customFields || {},
+            riskFlags: updates.riskFlags || [],
+            addedAt: new Date().toISOString(),
+            lastContact: new Date().toISOString(),
+        };
+        await writeProfile(filePath, newProfile);
+        return;
+    }
+    // Merge updates
+    const updated = {
+        ...existing,
+        ...updates,
+        lastContact: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    };
+    await writeProfile(filePath, updated);
+}
+// ========== Session Memory Operations ==========
+/**
+ * Get session memory file path
+ */
+export function getSessionMemoryPath(basePath, accountId, conversationId) {
+    return `${basePath}/accounts/${accountId}/friends/${conversationId}/session.md`;
+}
+/**
+ * Write session memory (aligned with Claude Code 10-section template)
+ */
+export async function writeSessionMemory(filePath, session) {
+    const content = `# Session Memory - ${session.sessionTitle}
+
+## Session Title
+_${session.sessionTitle}_
+
+## Current State
+_${session.currentState}_
+
+## Task specification
+_${session.taskSpecification}_
+
+## Files and Functions
+_${session.filesAndFunctions}_
+
+## Workflow
+_${session.workflow}_
+
+## Errors & Corrections
+_${session.errorsAndCorrections}_
+
+## Codebase and System Documentation
+_${session.codebaseDocumentation}_
+
+## Learnings
+_${session.learnings}_
+
+## Key results
+_${session.keyResults}_
+
+## Worklog
+_${session.worklog}_
+`;
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, ENCODING);
+}
+/**
+ * Read session memory
+ */
+export async function readSessionMemory(filePath) {
+    try {
+        const content = await fs.readFile(filePath, ENCODING);
+        // Parse sections
+        const session = {
+            sessionTitle: extractSection(content, 'Session Title') || '',
+            currentState: extractSection(content, 'Current State') || '',
+            taskSpecification: extractSection(content, 'Task specification') || '',
+            filesAndFunctions: extractSection(content, 'Files and Functions') || '',
+            workflow: extractSection(content, 'Workflow') || '',
+            errorsAndCorrections: extractSection(content, 'Errors & Corrections') || '',
+            codebaseDocumentation: extractSection(content, 'Codebase and System Documentation') || '',
+            learnings: extractSection(content, 'Learnings') || '',
+            keyResults: extractSection(content, 'Key results') || '',
+            worklog: extractSection(content, 'Worklog') || '',
+        };
+        return session;
+    }
+    catch {
+        return null;
+    }
+}
+function extractSection(content, sectionName) {
+    const regex = new RegExp(`## ${sectionName}\\s*\\n([\\s\\S]*?)(?=\\n## |$)`);
+    const match = content.match(regex);
+    return match ? match[1].trim().replace(/^_|_$/g, '') : '';
+}
+// ========== Summary Operations ==========
+/**
+ * Get summary file path
+ */
+export function getSummaryPath(basePath, accountId, subtype, conversationId, yearMonth) {
+    return `${basePath}/accounts/${accountId}/${subtype === 'friend' ? 'friends' : 'chatrooms'}/${conversationId}/memory/summaries/${yearMonth}-summary.md`;
+}
+/**
+ * Write AI summary
+ */
+export async function writeSummary(filePath, summary, keyPoints, learnings, actionItems) {
+    const now = new Date().toISOString();
+    const content = `---
+name: 对话摘要
+description: AI 生成的对话摘要
+type: conversation
+summary: true
+generatedAt: ${now}
+---
+
+# 对话摘要
+
+${summary}
+
+## 关键点
+
+${keyPoints.map(p => `- ${p}`).join('\n')}
+
+## 学习到的信息
+
+${learnings}
+
+${actionItems && actionItems.length > 0 ? `## 待跟进事项
+
+${actionItems.map(p => `- ${p}`).join('\n')}` : ''}
+`;
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, ENCODING);
+}
+// ========== Utility Functions ==========
+/**
+ * Ensure directory exists
+ */
+export async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+/**
+ * Delete file if exists
+ */
+export async function deleteFile(filePath) {
+    try {
+        await fs.unlink(filePath);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+}
+/**
+ * List files in directory
+ */
+export async function listFiles(dirPath, pattern = '*') {
+    try {
+        const files = await fs.readdir(dirPath);
+        if (pattern === '*') {
+            return files;
+        }
+        // Simple glob matching
+        const regex = new RegExp(pattern.replace(/\*/g, '.*'));
+        return files.filter(f => regex.test(f));
+    }
+    catch {
+        return [];
+    }
+}

package/dist/src/channel.d.ts

@@ -0,0 +1,65 @@
+/**
+ * WorkPhone WeChat Channel Plugin for OpenClaw
+ *
+ * This channel plugin connects OpenClaw to WorkPhone's WeChat API,
+ * enabling sending and receiving WeChat messages through the WorkPhone platform.
+ *
+ * IMPORTANT - Human Account Model:
+ * Unlike Telegram/WhatsApp bots, this connects to a real human WeChat account.
+ * The agent communicates with ALL friends and groups under that WeChat account,
+ * not just one DM context. This is "human mode" vs "bot mode".
+ *
+ * Includes Local Cache:
+ * - Per-account, per-user/conversation MD files
+ * - YAML frontmatter (aligned with Claude Code)
+ * - MEMORY.md indexing
+ * - 4-layer compression
+ * - AI summary extraction
+ * - SAAS connectivity + offline fallback
+ * - Cloud sync
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import { type WebhookPayload } from "./client.js";
+export interface CelPhoneWeChatResolvedAccount {
+    accountId: string | null;
+    apiKey: string;
+    baseUrl: string;
+    wechatAccountId: string;
+    wechatId: string;
+    nickName: string;
+    allowFrom: string[];
+    dmPolicy: string | undefined;
+}
+/**
+ * Create the channel plugin
+ */
+export declare const celPhoneWeChatPlugin: import("openclaw/plugin-sdk/core").ChannelPlugin<CelPhoneWeChatResolvedAccount, unknown, unknown>;
+/**
+ * Helper function to handle inbound webhook messages
+ * This should be called from your HTTP route handler
+ *
+ * Integrates with Cache Manager for:
+ * - Local MD file caching
+ * - User profile storage
+ * - Session memory
+ * - Cloud sync
+ * - Offline fallback
+ */
+export declare function handleInboundMessage(api: any, payload: WebhookPayload, cfg?: OpenClawConfig): Promise<void>;
+/**
+ * Get user profile from cache (for agent use)
+ */
+export declare function getUserProfile(accountId: string, wechatId: string): Promise<any>;
+/**
+ * Update user profile in cache
+ */
+export declare function updateUserProfile(accountId: string, wechatId: string, updates: any): Promise<void>;
+/**
+ * Get SAAS connection status
+ */
+export declare function getConnectionStatus(): import("./cache/types.js").ConnectionStatus;
+/**
+ * Check if system is online (SAAS connected)
+ */
+export declare function isOnline(): boolean;
+export default celPhoneWeChatPlugin;