xhs-operator 1.0.0-beta.1

package/README.md

@@ -0,0 +1,100 @@
+# xhs-operator
+
+小红书（REDnote）账号自动运营 OpenClaw 插件。支持内容发布、互动增长、数据监控，内置行为人性化与风控防护。
+
+## 安装
+
+```bash
+npm install xhs-operator
+```
+
+> **系统要求**: Node.js ≥ 20，首次运行会自动安装 Playwright 浏览器驱动。
+
+## 快速开始
+
+### 命令行使用
+
+```bash
+# 全局安装
+npm install -g xhs-operator
+
+# 1. 导入账号
+xhs-operator import ./accounts.json
+
+# 2. 启动自动运营（每日调度）
+ANTHROPIC_API_KEY=sk-... xhs-operator start
+
+# 3. 手动触发发布
+xhs-operator publish <accountId>
+
+# 4. 查看运营报告
+xhs-operator report <accountId>
+```
+
+### 账号配置文件（accounts.json）
+
+```json
+[
+  {
+    "nickname": "美食博主小明",
+    "niche": "美食",
+    "sessionFile": "./sessions/account1.json",
+    "proxy": {
+      "host": "127.0.0.1",
+      "port": 7890,
+      "protocol": "http"
+    }
+  }
+]
+```
+
+### 作为库使用（集成进 OpenClaw 框架）
+
+```typescript
+import { XHSOperatorPlugin } from 'xhs-operator';
+import { createStandaloneRuntime } from 'xhs-operator';
+
+const runtime = createStandaloneRuntime({
+  anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+});
+
+const plugin = new XHSOperatorPlugin();
+await plugin.initialize(runtime);
+
+// 手动触发发布
+const result = await plugin.triggerPublish('account-id');
+
+// 批量导入账号
+await plugin.importAccounts([{ nickname: '...', niche: '美食', sessionFile: '...', proxy: { ... } }]);
+
+// 启动自动调度
+plugin.startScheduler({ ... });
+```
+
+## 环境变量
+
+| 变量 | 必填 | 说明 |
+|------|------|------|
+| `ANTHROPIC_API_KEY` | 是 | Anthropic API Key，用于 AI 内容生成 |
+| `XHS_HEADLESS` | 否 | 设为 `false` 可显示浏览器窗口（默认 `true`） |
+| `XHS_NICHE` | 否 | 默认内容垂类（默认 `生活分享`） |
+| `XHS_LOG_LEVEL` | 否 | 日志级别 `debug/info/warn/error`（默认 `info`） |
+
+## 核心功能
+
+- **AI 内容生成** — 基于 Claude Sonnet 自动生成标题、正文、话题标签、封面文字
+- **图片合成** — 封面图自动排版与文字叠加（基于 Sharp）
+- **行为人性化** — 贝塞尔曲线鼠标轨迹、打字节奏模拟、随机浏览行为
+- **频率限制** — 每日配额管理 + 熔断器，防封号
+- **指纹管理** — 每账号绑定稳定浏览器指纹，避免关联
+- **养号策略** — 新账号 14 天渐进式操作计划
+- **多账号调度** — 最多 5 路并发，按健康分优先排序
+- **数据采集** — 自动抓取创作者中心指标并生成报告
+
+## 安全声明
+
+本插件遵守小红书用户协议，不支持刷量、私信骚扰、绕过实名认证等违规操作。使用者需自行承担账号风险。
+
+## License
+
+MIT

package/dist/actions/account.d.ts

@@ -0,0 +1,59 @@
+import type { Account, AccountImport, ImportResult } from '../types/index.js';
+import type { AppDatabase } from '../storage/database.js';
+import { FingerprintGuard } from '../risk/fingerprint-guard.js';
+export declare class AccountAction {
+    private db;
+    private fingerprintGuard;
+    constructor(db: AppDatabase, fingerprintGuard: FingerprintGuard);
+    /**
+     * Import multiple accounts into the system.
+     */
+    importAccounts(accounts: AccountImport[]): ImportResult;
+    /**
+     * Compute health score for an account (0-100).
+     */
+    computeHealthScore(account: Account): number;
+    /**
+     * Get accounts sorted by health score (highest first).
+     */
+    getAccountsByHealth(): Array<Account & {
+        healthScore: number;
+    }>;
+    /**
+     * Check if an account is in warm-up period (new account).
+     */
+    isInWarmup(account: Account): boolean;
+    /**
+     * Get warm-up day number (1-14) for quota adjustment.
+     */
+    getWarmupDay(account: Account): number;
+    /**
+     * Get adjusted quotas for accounts in warm-up period.
+     * Day 1-3: browse only
+     * Day 4-5: likes only (≤20/day)
+     * Day 6-7: likes + comments + follows
+     * Day 8-14: first publish, gradually increase
+     * Day 15+: normal operation
+     */
+    getWarmupQuota(account: Account): {
+        canPublish: boolean;
+        likes: number;
+        comments: number;
+        follows: number;
+        collects: number;
+        browseMins: number;
+    };
+    /**
+     * Pause an account (set to cooling status).
+     */
+    pauseAccount(accountId: string): void;
+    /**
+     * Resume an account.
+     */
+    resumeAccount(accountId: string): void;
+    /**
+     * Flag an account for manual review.
+     */
+    flagForReview(accountId: string): void;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/actions/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/actions/account.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAchE,qBAAa,aAAa;IAEtB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,gBAAgB;gBADhB,EAAE,EAAE,WAAW,EACf,gBAAgB,EAAE,gBAAgB;IAG5C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,YAAY;IAsCvD;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAa5C;;OAEG;IACH,mBAAmB,IAAI,KAAK,CAAC,OAAO,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAO/D;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAKrC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAKtC;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAoBjJ;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGvC"}

package/dist/actions/account.js

@@ -0,0 +1,142 @@
+// ============================================================
+// Account Action — Account management and health monitoring
+// ============================================================
+import { v4 as uuid } from 'uuid';
+import { hoursSince } from '../utils/helpers.js';
+/** Account health score thresholds */
+const HEALTH_THRESHOLDS = {
+    HEALTHY: 70,
+    WARNING: 40,
+    CRITICAL: 0,
+};
+/** New account warm-up period in days */
+const WARMUP_DAYS = 14;
+export class AccountAction {
+    db;
+    fingerprintGuard;
+    constructor(db, fingerprintGuard) {
+        this.db = db;
+        this.fingerprintGuard = fingerprintGuard;
+    }
+    /**
+     * Import multiple accounts into the system.
+     */
+    importAccounts(accounts) {
+        const result = {
+            total: accounts.length,
+            success: 0,
+            failed: 0,
+            errors: [],
+        };
+        for (const acc of accounts) {
+            try {
+                const id = uuid();
+                this.db.createAccount({
+                    id,
+                    nickname: acc.nickname,
+                    niche: acc.niche,
+                    sessionFile: acc.sessionFile,
+                    proxy: acc.proxy,
+                    fingerprintId: id,
+                    status: 'active',
+                    timezone: 'Asia/Shanghai',
+                });
+                // Pre-generate a stable fingerprint for this account
+                this.fingerprintGuard.getOrCreateFingerprint(id);
+                result.success++;
+            }
+            catch (error) {
+                result.failed++;
+                result.errors.push({
+                    nickname: acc.nickname,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * Compute health score for an account (0-100).
+     */
+    computeHealthScore(account) {
+        const { consecutiveErrors, banSignals, lastActiveAt } = account.dailyStats;
+        let score = 100;
+        score -= consecutiveErrors * 15;
+        score -= banSignals * 30;
+        if (hoursSince(lastActiveAt) > 72)
+            score -= 20;
+        if (hoursSince(lastActiveAt) > 168)
+            score -= 30; // >1 week
+        return Math.max(0, Math.min(100, score));
+    }
+    /**
+     * Get accounts sorted by health score (highest first).
+     */
+    getAccountsByHealth() {
+        const accounts = this.db.getAllAccounts('active');
+        return accounts
+            .map((acc) => ({ ...acc, healthScore: this.computeHealthScore(acc) }))
+            .sort((a, b) => b.healthScore - a.healthScore);
+    }
+    /**
+     * Check if an account is in warm-up period (new account).
+     */
+    isInWarmup(account) {
+        const daysSinceCreation = hoursSince(account.createdAt) / 24;
+        return daysSinceCreation < WARMUP_DAYS;
+    }
+    /**
+     * Get warm-up day number (1-14) for quota adjustment.
+     */
+    getWarmupDay(account) {
+        const daysSinceCreation = Math.floor(hoursSince(account.createdAt) / 24) + 1;
+        return Math.min(daysSinceCreation, WARMUP_DAYS);
+    }
+    /**
+     * Get adjusted quotas for accounts in warm-up period.
+     * Day 1-3: browse only
+     * Day 4-5: likes only (≤20/day)
+     * Day 6-7: likes + comments + follows
+     * Day 8-14: first publish, gradually increase
+     * Day 15+: normal operation
+     */
+    getWarmupQuota(account) {
+        const day = this.getWarmupDay(account);
+        if (day <= 3) {
+            return { canPublish: false, likes: 0, comments: 0, follows: 0, collects: 0, browseMins: randomRange(5, 15) };
+        }
+        if (day <= 5) {
+            return { canPublish: false, likes: 20, comments: 0, follows: 0, collects: 5, browseMins: randomRange(10, 20) };
+        }
+        if (day <= 7) {
+            return { canPublish: false, likes: 30, comments: 5, follows: 10, collects: 10, browseMins: randomRange(10, 25) };
+        }
+        if (day <= 14) {
+            return { canPublish: true, likes: 50, comments: 15, follows: 20, collects: 20, browseMins: randomRange(15, 30) };
+        }
+        // Day 15+: full quota (handled by rate-guard)
+        return { canPublish: true, likes: 80, comments: 30, follows: 50, collects: 50, browseMins: 0 };
+    }
+    /**
+     * Pause an account (set to cooling status).
+     */
+    pauseAccount(accountId) {
+        this.db.updateAccountStatus(accountId, 'cooling');
+    }
+    /**
+     * Resume an account.
+     */
+    resumeAccount(accountId) {
+        this.db.updateAccountStatus(accountId, 'active');
+    }
+    /**
+     * Flag an account for manual review.
+     */
+    flagForReview(accountId) {
+        this.db.updateAccountStatus(accountId, 'manual_review');
+    }
+}
+function randomRange(min, max) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+//# sourceMappingURL=account.js.map

package/dist/actions/account.js.map

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

package/dist/actions/interact.d.ts

@@ -0,0 +1,37 @@
+import type { OpenClawRuntime, Account, InteractTask, InteractTarget } from '../types/index.js';
+import { FingerprintGuard } from '../risk/fingerprint-guard.js';
+import { RateGuard } from '../risk/rate-guard.js';
+export declare class InteractAction {
+    private runtime;
+    private fingerprintGuard;
+    private rateGuard;
+    private humanizer;
+    private copywriter;
+    constructor(runtime: OpenClawRuntime, fingerprintGuard: FingerprintGuard, rateGuard: RateGuard);
+    /**
+     * Execute a single interaction task.
+     */
+    executeTask(account: Account, task: InteractTask): Promise<void>;
+    /**
+     * Execute a batch of interaction tasks with rate-limited delays.
+     */
+    executeBatch(account: Account, targets: InteractTarget[], quota: {
+        likes: number;
+        comments: number;
+        follows: number;
+        collects: number;
+    }): Promise<{
+        completed: number;
+        failed: number;
+    }>;
+    /**
+     * Discover relevant notes/users to interact with in a niche.
+     */
+    discoverTargets(account: Account, niche: string, count?: number): Promise<InteractTarget[]>;
+    private likeNote;
+    private commentOnNote;
+    private followUser;
+    private collectNote;
+    private buildTasksFromTargets;
+}
+//# sourceMappingURL=interact.d.ts.map

package/dist/actions/interact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interact.d.ts","sourceRoot":"","sources":["../../src/actions/interact.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,YAAY,EACZ,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAsB,MAAM,uBAAuB,CAAC;AAItE,qBAAa,cAAc;IAKvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,SAAS;IANnB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,UAAU,CAAa;gBAGrB,OAAO,EAAE,eAAe,EACxB,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,EAAE,SAAS;IAM9B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCtE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB9L;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YA4CvF,QAAQ;YAYR,aAAa;YA6Bb,UAAU;YAYV,WAAW;IAYzB,OAAO,CAAC,qBAAqB;CAoC9B"}

package/dist/actions/interact.js

@@ -0,0 +1,205 @@
+// ============================================================
+// Interact Action — Social interaction automation (like, comment, follow, collect)
+// ============================================================
+import { BehaviorHumanizer } from '../risk/behavior-humanizer.js';
+import { QuotaExceededError } from '../risk/rate-guard.js';
+import { Copywriter } from '../agents/copywriter.js';
+import { randomBetween } from '../utils/helpers.js';
+export class InteractAction {
+    runtime;
+    fingerprintGuard;
+    rateGuard;
+    humanizer;
+    copywriter;
+    constructor(runtime, fingerprintGuard, rateGuard) {
+        this.runtime = runtime;
+        this.fingerprintGuard = fingerprintGuard;
+        this.rateGuard = rateGuard;
+        this.humanizer = new BehaviorHumanizer();
+        this.copywriter = new Copywriter(runtime);
+    }
+    /**
+     * Execute a single interaction task.
+     */
+    async executeTask(account, task) {
+        const quota = this.rateGuard.checkQuota(account.id, task.type);
+        if (!quota.allowed) {
+            throw new QuotaExceededError(quota.resetAt);
+        }
+        const page = await this.runtime.browser.newPage({
+            cookieFile: account.sessionFile,
+            proxy: account.proxy,
+        });
+        try {
+            await this.fingerprintGuard.applyFingerprint(page, account.id);
+            // Browse randomly before interacting (simulate natural usage)
+            await this.humanizer.browseRandomly(page, randomBetween(3, 8));
+            switch (task.type) {
+                case 'like':
+                    await this.likeNote(page, task.targetNoteId);
+                    break;
+                case 'comment':
+                    await this.commentOnNote(page, task.targetNoteId, task.commentContent);
+                    break;
+                case 'follow':
+                    await this.followUser(page, task.targetUserId);
+                    break;
+                case 'collect':
+                    await this.collectNote(page, task.targetNoteId);
+                    break;
+            }
+            this.rateGuard.recordAction(account.id, task.type, task.targetNoteId || task.targetUserId);
+        }
+        catch (error) {
+            this.rateGuard.recordFailure(account.id);
+            throw error;
+        }
+        finally {
+            await page.close();
+        }
+    }
+    /**
+     * Execute a batch of interaction tasks with rate-limited delays.
+     */
+    async executeBatch(account, targets, quota) {
+        let completed = 0;
+        let failed = 0;
+        const tasks = this.buildTasksFromTargets(targets, quota);
+        for (const task of tasks) {
+            try {
+                await this.executeTask(account, task);
+                completed++;
+            }
+            catch (error) {
+                if (error instanceof QuotaExceededError)
+                    break;
+                failed++;
+            }
+            // Random delay between tasks
+            await this.humanizer.waitRandom(randomBetween(5000, 15000), randomBetween(20000, 40000));
+        }
+        return { completed, failed };
+    }
+    /**
+     * Discover relevant notes/users to interact with in a niche.
+     */
+    async discoverTargets(account, niche, count = 20) {
+        const page = await this.runtime.browser.newPage({
+            cookieFile: account.sessionFile,
+            proxy: account.proxy,
+        });
+        try {
+            await this.fingerprintGuard.applyFingerprint(page, account.id);
+            // Search for niche content
+            await page.navigate(`https://www.xiaohongshu.com/search_result?keyword=${encodeURIComponent(niche)}`);
+            await this.humanizer.waitRandom(2000, 4000);
+            // Scroll and collect note cards
+            const targets = [];
+            for (let i = 0; i < Math.ceil(count / 10); i++) {
+                const cards = await page.$$('.note-card, [data-type="note"]');
+                for (const card of cards) {
+                    if (targets.length >= count)
+                        break;
+                    const noteId = await card.getAttribute('data-note-id');
+                    const userId = await card.getAttribute('data-user-id');
+                    if (noteId && userId) {
+                        targets.push({
+                            noteId,
+                            userId,
+                            relevanceScore: 1 - (targets.length / count), // Simple decay
+                        });
+                    }
+                }
+                // Scroll for more
+                await this.humanizer.browseRandomly(page, randomBetween(2, 5));
+            }
+            return targets;
+        }
+        finally {
+            await page.close();
+        }
+    }
+    async likeNote(page, noteId) {
+        await page.navigate(`https://www.xiaohongshu.com/explore/${noteId}`);
+        await this.humanizer.waitRandom(1500, 3000);
+        // Scroll to read the note naturally
+        await this.humanizer.browseRandomly(page, randomBetween(3, 8));
+        // Click like button
+        await this.humanizer.clickNatural(page, '.like-btn, [data-type="like"]');
+        await this.humanizer.waitRandom(500, 1000);
+    }
+    async commentOnNote(page, noteId, content) {
+        await page.navigate(`https://www.xiaohongshu.com/explore/${noteId}`);
+        await this.humanizer.waitRandom(1500, 3000);
+        // Read the note first
+        await this.humanizer.browseRandomly(page, randomBetween(5, 12));
+        // Generate comment if not provided
+        if (!content) {
+            const titleEl = await page.$('.note-title, h1');
+            const bodyEl = await page.$('.note-content, .note-text');
+            const title = (await titleEl?.textContent()) || '';
+            const body = (await bodyEl?.textContent()) || '';
+            content = await this.copywriter.generateComment(title, body.slice(0, 200));
+        }
+        // Click comment area and type
+        await this.humanizer.clickNatural(page, '.comment-input, [data-type="comment-input"]');
+        await this.humanizer.waitRandom(300, 600);
+        await this.humanizer.typeHuman(page, '.comment-input textarea', content, {
+            wpm: randomBetween(40, 80),
+        });
+        await this.humanizer.waitRandom(500, 1500);
+        // Submit comment
+        await this.humanizer.clickNatural(page, '.comment-submit, [data-type="comment-submit"]');
+        await this.humanizer.waitRandom(1000, 2000);
+    }
+    async followUser(page, userId) {
+        await page.navigate(`https://www.xiaohongshu.com/user/profile/${userId}`);
+        await this.humanizer.waitRandom(2000, 4000);
+        // Browse the user's profile
+        await this.humanizer.browseRandomly(page, randomBetween(3, 6));
+        // Click follow button
+        await this.humanizer.clickNatural(page, '.follow-btn, [data-type="follow"]');
+        await this.humanizer.waitRandom(500, 1000);
+    }
+    async collectNote(page, noteId) {
+        await page.navigate(`https://www.xiaohongshu.com/explore/${noteId}`);
+        await this.humanizer.waitRandom(1500, 3000);
+        // Read the note
+        await this.humanizer.browseRandomly(page, randomBetween(4, 8));
+        // Click collect button
+        await this.humanizer.clickNatural(page, '.collect-btn, [data-type="collect"]');
+        await this.humanizer.waitRandom(500, 1000);
+    }
+    buildTasksFromTargets(targets, quota) {
+        const tasks = [];
+        let likeCount = 0;
+        let commentCount = 0;
+        let followCount = 0;
+        let collectCount = 0;
+        for (const target of targets) {
+            // Like most targets
+            if (likeCount < quota.likes) {
+                tasks.push({ type: 'like', targetNoteId: target.noteId });
+                likeCount++;
+            }
+            // Comment on high-relevance targets
+            if (commentCount < quota.comments && target.relevanceScore > 0.5) {
+                tasks.push({ type: 'comment', targetNoteId: target.noteId });
+                commentCount++;
+            }
+            // Follow selectively
+            if (followCount < quota.follows && target.relevanceScore > 0.7) {
+                tasks.push({ type: 'follow', targetUserId: target.userId });
+                followCount++;
+            }
+            // Collect high-quality content
+            if (collectCount < quota.collects && target.relevanceScore > 0.6) {
+                tasks.push({ type: 'collect', targetNoteId: target.noteId });
+                collectCount++;
+            }
+        }
+        // Shuffle for more natural behavior
+        return tasks.sort(() => Math.random() - 0.5);
+    }
+}
+//# sourceMappingURL=interact.js.map

package/dist/actions/interact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interact.js","sourceRoot":"","sources":["../../src/actions/interact.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mFAAmF;AACnF,+DAA+D;AAS/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAa,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,cAAc;IAKf;IACA;IACA;IANF,SAAS,CAAoB;IAC7B,UAAU,CAAa;IAE/B,YACU,OAAwB,EACxB,gBAAkC,EAClC,SAAoB;QAFpB,YAAO,GAAP,OAAO,CAAiB;QACxB,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,cAAS,GAAT,SAAS,CAAW;QAE5B,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAgB,EAAE,IAAkB;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9C,UAAU,EAAE,OAAO,CAAC,WAAW;YAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAE/D,8DAA8D;YAC9D,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAE/D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,KAAK,MAAM;oBACT,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,YAAa,CAAC,CAAC;oBAC9C,MAAM;gBACR,KAAK,SAAS;oBACZ,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,YAAa,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;oBACxE,MAAM;gBACR,KAAK,QAAQ;oBACX,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,YAAa,CAAC,CAAC;oBAChD,MAAM;gBACR,KAAK,SAAS;oBACZ,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,YAAa,CAAC,CAAC;oBACjD,MAAM;YACV,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACzC,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAgB,EAAE,OAAyB,EAAE,KAA6E;QAC3I,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACtC,SAAS,EAAE,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,kBAAkB;oBAAE,MAAM;gBAC/C,MAAM,EAAE,CAAC;YACX,CAAC;YAED,6BAA6B;YAC7B,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAC7B,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,EAC1B,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAC5B,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAgB,EAAE,KAAa,EAAE,QAAgB,EAAE;QACvE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9C,UAAU,EAAE,OAAO,CAAC,WAAW;YAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAE/D,2BAA2B;YAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,qDAAqD,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAE5C,gCAAgC;YAChC,MAAM,OAAO,GAAqB,EAAE,CAAC;YAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC;gBAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;wBAAE,MAAM;oBAEnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;oBACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;oBAEvD,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;wBACrB,OAAO,CAAC,IAAI,CAAC;4BACX,MAAM;4BACN,MAAM;4BACN,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,eAAe;yBAC9D,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,kBAAkB;gBAClB,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAU,EAAE,MAAc;QAC/C,MAAM,IAAI,CAAC,QAAQ,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE5C,oCAAoC;QACpC,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/D,oBAAoB;QACpB,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;QACzE,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,IAAU,EAAE,MAAc,EAAE,OAAgB;QACtE,MAAM,IAAI,CAAC,QAAQ,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE5C,sBAAsB;QACtB,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAEhE,mCAAmC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YACjD,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,8BAA8B;QAC9B,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC;QACvF,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE;YACvE,GAAG,EAAE,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC;SAC3B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE3C,iBAAiB;QACjB,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAC;QACzF,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAU,EAAE,MAAc;QACjD,MAAM,IAAI,CAAC,QAAQ,CAAC,4CAA4C,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE5C,4BAA4B;QAC5B,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/D,sBAAsB;QACtB,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,mCAAmC,CAAC,CAAC;QAC7E,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAU,EAAE,MAAc;QAClD,MAAM,IAAI,CAAC,QAAQ,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE5C,gBAAgB;QAChB,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/D,uBAAuB;QACvB,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,qCAAqC,CAAC,CAAC;QAC/E,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAEO,qBAAqB,CAAC,OAAyB,EAAE,KAA6E;QACpI,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,oBAAoB;YACpB,IAAI,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC1D,SAAS,EAAE,CAAC;YACd,CAAC;YAED,oCAAoC;YACpC,IAAI,YAAY,GAAG,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC;gBACjE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7D,YAAY,EAAE,CAAC;YACjB,CAAC;YAED,qBAAqB;YACrB,IAAI,WAAW,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC;gBAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC5D,WAAW,EAAE,CAAC;YAChB,CAAC;YAED,+BAA+B;YAC/B,IAAI,YAAY,GAAG,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC;gBACjE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7D,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/actions/publish.d.ts

@@ -0,0 +1,18 @@
+import type { OpenClawRuntime, Account, NoteContent, PublishResult } from '../types/index.js';
+import { FingerprintGuard } from '../risk/fingerprint-guard.js';
+import { RateGuard } from '../risk/rate-guard.js';
+export declare class PublishAction {
+    private runtime;
+    private fingerprintGuard;
+    private rateGuard;
+    private humanizer;
+    constructor(runtime: OpenClawRuntime, fingerprintGuard: FingerprintGuard, rateGuard: RateGuard);
+    /**
+     * Publish a note with images to XHS.
+     */
+    publishNote(account: Account, note: NoteContent, images: Buffer[]): Promise<PublishResult>;
+    private uploadImages;
+    private addHashtag;
+    private waitForPublishSuccess;
+}
+//# sourceMappingURL=publish.d.ts.map

package/dist/actions/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/actions/publish.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,WAAW,EACX,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAsB,MAAM,uBAAuB,CAAC;AAKtE,qBAAa,aAAa;IAItB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,SAAS;IALnB,OAAO,CAAC,SAAS,CAAoB;gBAG3B,OAAO,EAAE,eAAe,EACxB,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,EAAE,SAAS;IAK9B;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,aAAa,CAAC;YA+DX,YAAY;YAmBZ,UAAU;YAsBV,qBAAqB;CA6BpC"}