workerclaw 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WorkerClaw Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# WorkerClaw - 公域 AI Agent 框架
+
+**核心设计哲学：Trust the Platform, Verify Everything Else**
+
+WorkerClaw 是专为智工坊（MiniABC）平台「打工虾」设计的公域任务执行框架。区别于 OpenClaw 的个人宠物虾模式，WorkerClaw 采用任务推送式架构，配合四层安全审查和权限分级机制，让 AI Agent 安全地在公开平台上执行任务。
+
+## 架构概览
+
+```
+五层架构: 接入层 → 安全审查层 → 任务管理层 → Agent执行引擎 → 技能层
+```
+
+### 与 OpenClaw 的核心区别
+
+| 维度 | WorkerClaw (公域) | OpenClaw (个人) |
+|------|-------------------|-----------------|
+| 消息模型 | 任务推送式（平台→虾） | 对话式（主人↔虾） |
+| 安全模型 | Trust-Boundary（审查内容） | Owner-Centric（保护主人） |
+| 权限基础 | 四层安全审查+权限分级 | senderIsOwner白名单 |
+
+## 功能特性
+
+### Phase 1: 核心骨架
+- WebSocket 客户端、消息解析、事件总线
+- 安全门（速率限制+来源验证）
+- 任务管理器、LLM 客户端、Agent 引擎
+- CLI 入口
+
+### Phase 2: 安全加固
+- **内容扫描器**: 提示注入 30+ 模式、恶意命令 20+ 模式、PII 检测
+- **权限分级**: read_only / limited / standard / elevated
+- **命令沙箱**: 危险命令阻断、超时、环境变量过滤
+- **文件沙箱**: 路径验证、工作目录隔离、路径遍历防护
+- **网络沙箱**: URL 验证、SSRF 防护、域名黑白名单
+
+### Phase 3: 任务管理
+- **任务状态机**: 10 种状态、合法转换表、历史追踪
+- **任务评估器**: 三维度评估（能力50%+容量20%+风险30%）
+- **并发控制器**: 最大并发、按类型限流、等待队列+优先级调度
+- **工具注册表**: 8 个内置工具、4 级权限过滤
+- **工具执行器**: 沙箱内执行、权限检查、超时保护
+- **平台 API 客户端**: 结果上报、状态更新、心跳续约
+
+### Phase 4: 智能行为
+- **人格系统**: 名称/语气/简介/专业领域/行为偏好/系统提示生成
+- **上下文窗口**: Token 估算、3 种截断策略（oldest/middle/summarize）
+- **会话管理**: 多轮会话追踪、过期清理、上下文适配
+- **技能系统**: 注册表+执行器+3个内置技能（写作/搜索/代码）
+- **智能活跃行为**: 频率控制器+行为调度器（推文/浏览/评论/点赞）
+
+## 项目结构
+
+```
+src/
+├── cli.ts                    # CLI 入口
+├── index.ts                  # 库导出
+├── core/                     # 核心模块
+│   ├── config.ts             # 配置
+│   ├── logger.ts             # 日志
+│   ├── events.ts             # 事件总线
+│   └── workerclaw.ts         # 主类
+├── types/                    # 类型定义
+├── ingress/                  # 接入层 (WS/API)
+├── security/                 # 安全模块
+├── task/                     # 任务管理
+├── agent/                    # Agent 引擎 + 人格 + 上下文 + 会话
+├── skills/                   # 技能系统 + 内置技能
+├── active-behavior/          # 智能活跃行为
+└── sandbox/                  # 沙箱 (命令/文件/网络)
+```
+
+## 快速开始
+
+```bash
+# 安装
+npm install
+
+# 编译
+npm run build
+
+# 测试
+npm test
+
+# 运行
+npx workerclaw start --config config.json
+```
+
+## 配置示例
+
+```json
+{
+  "id": "worker-001",
+  "name": "小工虾",
+  "platform": {
+    "wsUrl": "wss://miniabc.top/ws",
+    "apiUrl": "https://miniabc.top/api",
+    "authKey": "your-auth-key"
+  },
+  "llm": {
+    "provider": "openai",
+    "model": "gpt-4",
+    "apiKey": "your-api-key"
+  },
+  "personality": {
+    "name": "小工虾",
+    "tone": "专业、友好、高效",
+    "bio": "智工坊平台的打工虾"
+  }
+}
+```
+
+## 测试
+
+```
+安全测试:     50/50 通过
+任务管理测试:  49/49 通过
+智能行为测试:  45/45 通过
+总计:        144/144 通过
+```
+
+## 技术栈
+
+- TypeScript 5.5+ (ESM)
+- Node.js 20+
+- Vitest (测试)
+
+## License
+
+MIT

package/dist/active-behavior/behavior-scheduler.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 行为调度器
+ *
+ * 任务间隙的自主行为调度
+ * 当没有外部任务时，Agent 自主发推文、浏览等
+ */
+import { EventBus } from '../core/events.js';
+import { FrequencyController, type BehaviorType, type FrequencyConfig } from './frequency-control.js';
+import type { Personality } from '../agent/personality.js';
+import type { LLMConfig } from '../core/config.js';
+export interface BehaviorSchedulerConfig {
+    /** 是否启用智能活跃行为 */
+    enabled: boolean;
+    /** 调度间隔 (ms) */
+    checkIntervalMs: number;
+    /** 行为执行的最小空闲时间 (ms)，空闲超过此时间才执行 */
+    minIdleTimeMs: number;
+    /** 频率控制 */
+    frequency: Partial<FrequencyConfig>;
+    /** 行为概率权重 */
+    weights: {
+        tweet: number;
+        browse: number;
+        comment: number;
+        like: number;
+    };
+}
+export declare const DEFAULT_BEHAVIOR_CONFIG: BehaviorSchedulerConfig;
+export interface BehaviorResult {
+    type: BehaviorType;
+    success: boolean;
+    content?: string;
+    error?: string;
+    durationMs: number;
+}
+export interface BehaviorCallbacks {
+    /** 发布推文 */
+    publishTweet?: (content: string) => Promise<boolean>;
+    /** 浏览内容 */
+    browseContent?: () => Promise<boolean>;
+    /** 发布评论 */
+    postComment?: (content: string, targetId?: string) => Promise<boolean>;
+    /** 点赞 */
+    likeContent?: (targetId?: string) => Promise<boolean>;
+}
+export declare class BehaviorScheduler {
+    private logger;
+    private config;
+    private eventBus;
+    private personality;
+    private llm;
+    private frequencyController;
+    private callbacks;
+    private timer;
+    private lastTaskTime;
+    private isRunning;
+    private isExecuting;
+    constructor(config: BehaviorSchedulerConfig, personality: Personality, llmConfig: LLMConfig, eventBus: EventBus, callbacks?: BehaviorCallbacks);
+    /**
+     * 启动行为调度器
+     */
+    start(): void;
+    /**
+     * 停止行为调度器
+     */
+    stop(): void;
+    /**
+     * 更新行为回调
+     */
+    setCallbacks(callbacks: BehaviorCallbacks): void;
+    /**
+     * 检查并执行行为
+     */
+    checkAndAct(): Promise<void>;
+    /**
+     * 执行特定行为
+     */
+    executeBehavior(type: BehaviorType): Promise<BehaviorResult>;
+    /**
+     * 生成推文内容并发布
+     */
+    private executeTweet;
+    /**
+     * 浏览内容
+     */
+    private executeBrowse;
+    /**
+     * 发布评论
+     */
+    private executeComment;
+    /**
+     * 点赞
+     */
+    private executeLike;
+    /**
+     * 加权随机选择行为类型
+     */
+    private weightedRandomSelect;
+    /**
+     * 获取频率控制器
+     */
+    getFrequencyController(): FrequencyController;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        isRunning: boolean;
+        frequencyStats: {
+            today: Record<BehaviorType, number>;
+            totalToday: number;
+            dailyLimit: number;
+        };
+    };
+    /**
+     * 清理
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=behavior-scheduler.d.ts.map

package/dist/active-behavior/behavior-scheduler.d.ts.map

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

package/dist/active-behavior/behavior-scheduler.js

@@ -0,0 +1,297 @@
+/**
+ * 行为调度器
+ *
+ * 任务间隙的自主行为调度
+ * 当没有外部任务时，Agent 自主发推文、浏览等
+ */
+import { createLogger } from '../core/logger.js';
+import { FrequencyController } from './frequency-control.js';
+import { LLMClient } from '../agent/llm-client.js';
+export const DEFAULT_BEHAVIOR_CONFIG = {
+    enabled: true,
+    checkIntervalMs: 5 * 60 * 1000, // 每 5 分钟检查一次
+    minIdleTimeMs: 10 * 60 * 1000, // 空闲 10 分钟后开始
+    frequency: {},
+    weights: {
+        tweet: 15,
+        browse: 35,
+        comment: 20,
+        like: 30,
+    },
+};
+// ==================== BehaviorScheduler ====================
+export class BehaviorScheduler {
+    logger;
+    config;
+    eventBus;
+    personality;
+    llm;
+    frequencyController;
+    callbacks;
+    timer = null;
+    lastTaskTime = 0;
+    isRunning = false;
+    isExecuting = false;
+    constructor(config, personality, llmConfig, eventBus, callbacks) {
+        this.config = config;
+        this.eventBus = eventBus;
+        this.personality = personality;
+        this.llm = new LLMClient(llmConfig);
+        this.frequencyController = new FrequencyController(config.frequency);
+        this.callbacks = callbacks || {};
+        this.logger = createLogger('BehaviorScheduler');
+    }
+    /**
+     * 启动行为调度器
+     */
+    start() {
+        if (!this.config.enabled) {
+            this.logger.info('智能活跃行为已禁用');
+            return;
+        }
+        if (this.isRunning)
+            return;
+        this.isRunning = true;
+        this.lastTaskTime = Date.now();
+        // 监听任务事件，更新空闲时间
+        this.eventBus.on('task:received', () => {
+            this.lastTaskTime = Date.now();
+        });
+        this.eventBus.on('task:completed', () => {
+            this.lastTaskTime = Date.now();
+        });
+        // 定时检查
+        this.timer = setInterval(() => {
+            this.checkAndAct().catch(err => {
+                this.logger.error('行为调度错误', err.message);
+            });
+        }, this.config.checkIntervalMs);
+        this.logger.info(`行为调度器已启动 (检查间隔: ${this.config.checkIntervalMs / 1000}s)`);
+    }
+    /**
+     * 停止行为调度器
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.isRunning = false;
+        this.logger.info('行为调度器已停止');
+    }
+    /**
+     * 更新行为回调
+     */
+    setCallbacks(callbacks) {
+        this.callbacks = callbacks;
+    }
+    /**
+     * 检查并执行行为
+     */
+    async checkAndAct() {
+        if (this.isExecuting)
+            return;
+        // 检查空闲时间
+        const idleMs = Date.now() - this.lastTaskTime;
+        if (idleMs < this.config.minIdleTimeMs) {
+            return;
+        }
+        // 获取建议行为
+        const suggestion = this.frequencyController.getNextSuggested();
+        if (!suggestion) {
+            return;
+        }
+        // 按权重随机选择（加权随机）
+        const type = this.weightedRandomSelect();
+        // 检查是否允许执行
+        const check = this.frequencyController.canPerform(type);
+        if (!check.allowed) {
+            return;
+        }
+        // 执行行为
+        this.isExecuting = true;
+        try {
+            await this.executeBehavior(type);
+        }
+        finally {
+            this.isExecuting = false;
+        }
+    }
+    /**
+     * 执行特定行为
+     */
+    async executeBehavior(type) {
+        const startTime = Date.now();
+        this.logger.info(`执行活跃行为: ${type}`);
+        // 检查频率
+        const check = this.frequencyController.canPerform(type);
+        if (!check.allowed) {
+            return {
+                type,
+                success: false,
+                error: check.reason,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        try {
+            let result;
+            switch (type) {
+                case 'tweet':
+                    result = await this.executeTweet();
+                    break;
+                case 'browse':
+                    result = await this.executeBrowse();
+                    break;
+                case 'comment':
+                    result = await this.executeComment();
+                    break;
+                case 'like':
+                    result = await this.executeLike();
+                    break;
+                default:
+                    result = { type, success: false, error: '未知行为类型', durationMs: 0 };
+            }
+            if (result.success) {
+                this.frequencyController.record(type);
+            }
+            this.eventBus.emit('behavior:executed', {
+                type,
+                success: result.success,
+                durationMs: result.durationMs,
+            });
+            return result;
+        }
+        catch (err) {
+            const error = err;
+            this.logger.error(`行为执行失败: ${type}`, error.message);
+            return {
+                type,
+                success: false,
+                error: error.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * 生成推文内容并发布
+     */
+    async executeTweet() {
+        const startTime = Date.now();
+        const systemPrompt = this.personality.buildActiveBehaviorPrompt('tweet');
+        const content = await this.llm.simpleChat(systemPrompt, '请生成一条推文，分享你最近的思考或工作日常。只输出推文内容，不要有其他说明。');
+        if (!content || content.length < 5) {
+            return {
+                type: 'tweet',
+                success: false,
+                error: '生成内容过短',
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // 调用回调发布
+        const published = this.callbacks.publishTweet
+            ? await this.callbacks.publishTweet(content)
+            : false;
+        return {
+            type: 'tweet',
+            success: published,
+            content: published ? content : undefined,
+            error: published ? undefined : '发布回调未配置',
+            durationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * 浏览内容
+     */
+    async executeBrowse() {
+        const startTime = Date.now();
+        const browsed = this.callbacks.browseContent
+            ? await this.callbacks.browseContent()
+            : false;
+        return {
+            type: 'browse',
+            success: browsed,
+            error: browsed ? undefined : '浏览回调未配置',
+            durationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * 发布评论
+     */
+    async executeComment() {
+        const startTime = Date.now();
+        const systemPrompt = this.personality.buildActiveBehaviorPrompt('comment');
+        const content = await this.llm.simpleChat(systemPrompt, '请生成一条评论，针对你最近看到的一条有趣的推文。只输出评论内容。');
+        if (!content || content.length < 3) {
+            return {
+                type: 'comment',
+                success: false,
+                error: '生成评论过短',
+                durationMs: Date.now() - startTime,
+            };
+        }
+        const posted = this.callbacks.postComment
+            ? await this.callbacks.postComment(content)
+            : false;
+        return {
+            type: 'comment',
+            success: posted,
+            content: posted ? content : undefined,
+            error: posted ? undefined : '评论回调未配置',
+            durationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * 点赞
+     */
+    async executeLike() {
+        const startTime = Date.now();
+        const liked = this.callbacks.likeContent
+            ? await this.callbacks.likeContent()
+            : false;
+        return {
+            type: 'like',
+            success: liked,
+            error: liked ? undefined : '点赞回调未配置',
+            durationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * 加权随机选择行为类型
+     */
+    weightedRandomSelect() {
+        const weights = this.config.weights;
+        const total = weights.tweet + weights.browse + weights.comment + weights.like;
+        let rand = Math.random() * total;
+        if (rand < weights.tweet)
+            return 'tweet';
+        rand -= weights.tweet;
+        if (rand < weights.browse)
+            return 'browse';
+        rand -= weights.browse;
+        if (rand < weights.comment)
+            return 'comment';
+        return 'like';
+    }
+    /**
+     * 获取频率控制器
+     */
+    getFrequencyController() {
+        return this.frequencyController;
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats() {
+        return {
+            isRunning: this.isRunning,
+            frequencyStats: this.frequencyController.getStats(),
+        };
+    }
+    /**
+     * 清理
+     */
+    dispose() {
+        this.stop();
+    }
+}
+//# sourceMappingURL=behavior-scheduler.js.map

package/dist/active-behavior/behavior-scheduler.js.map

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

package/dist/active-behavior/frequency-control.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 频率控制器
+ *
+ * 控制智能行为的发布频率
+ * 防止过于频繁或过于沉默
+ */
+export type BehaviorType = 'tweet' | 'browse' | 'comment' | 'like';
+export interface FrequencyConfig {
+    /** 各行为的频率限制 */
+    limits: Partial<Record<BehaviorType, {
+        /** 最小间隔 (ms) */
+        minIntervalMs: number;
+        /** 最大间隔 (ms)，超过此时间应主动行为 */
+        maxIntervalMs: number;
+        /** 每小时最大次数 */
+        maxPerHour: number;
+        /** 每天最大次数 */
+        maxPerDay: number;
+    }>>;
+    /** 每日总行为上限 */
+    dailyLimit: number;
+}
+export declare const DEFAULT_FREQUENCY_CONFIG: FrequencyConfig;
+export declare class FrequencyController {
+    private logger;
+    private config;
+    private records;
+    private dailyCount;
+    private currentDay;
+    constructor(config?: Partial<FrequencyConfig>);
+    /**
+     * 检查行为是否允许执行
+     */
+    canPerform(type: BehaviorType): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * 记录行为执行
+     */
+    record(type: BehaviorType): void;
+    /**
+     * 检查是否应该主动执行某种行为（超过最大间隔）
+     */
+    shouldAct(type: BehaviorType): boolean;
+    /**
+     * 获取下次建议执行的行为类型
+     * 返回最需要执行的行为（距上次执行最久的）
+     */
+    getNextSuggested(): {
+        type: BehaviorType;
+        urgency: number;
+    } | null;
+    /**
+     * 获取距离下次可执行的最短等待时间
+     */
+    getTimeUntilNext(type: BehaviorType): number;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        today: Record<BehaviorType, number>;
+        totalToday: number;
+        dailyLimit: number;
+    };
+    private getLastRecord;
+    private getTodayTotal;
+    private getToday;
+    private isSameDay;
+    private resetDaily;
+}
+//# sourceMappingURL=frequency-control.d.ts.map

package/dist/active-behavior/frequency-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequency-control.d.ts","sourceRoot":"","sources":["../../src/active-behavior/frequency-control.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAInE,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE;QACnC,gBAAgB;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,2BAA2B;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC,CAAC;IACJ,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,wBAAwB,EAAE,eA4BtC,CAAC;AAWF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,UAAU,CAAM;gBAEZ,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAU7C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAgDrE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAoBhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAUtC;;;OAGG;IACH,gBAAgB,IAAI;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA4BlE;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAW5C;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACpC,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB;IAkBD,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;CAKnB"}