opc-agent 3.0.1 → 4.0.1

package/README.zh-CN.md

@@ -24,6 +24,22 @@ OPC Agent 是一个 **TypeScript 优先的开放智能体框架**，由 [跃盟
 
 ## ⚡ 快速开始（30 秒上手）
 
+### 一键安装（推荐）
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex
+```
+
+> 自动安装 Node.js + OPC Agent + Ollama（可选），全程有引导提示。
+
+### 手动安装
+
 ```bash
 # 1. 安装 CLI
 npm install -g opc-agent
@@ -386,6 +402,72 @@ spec:
           maxLatencyMs: 5000
 ```
 
+## 🔍 与其他 Agent 框架的差异
+
+OPC Agent 的核心设计哲学是**记忆进化 + 全渠道 + 工位模板 + 生产工具链四件套**。与大多数 Agent 框架关注"如何编排多个 Agent 对话"不同，OPC 更关注的是：一个 Agent 如何在真实生产环境中**持续进化、随处触达、开箱即用**。这决定了我们在架构选择上的一系列差异。
+
+#### vs Hermes Agent
+
+**设计思路差异**：Hermes 是 Python 单体框架，围绕 Nous Research 的模型生态构建，强调自学习进化和 RL 训练。OPC 是 TypeScript 模块化四件套（Brain / Agent / Channel / CLI），强调工程化和开箱即用。
+
+**OPC 的优势**：记忆进化三件套（learn → recall → evolve 自动聚类提炼）、三层 Brain Seed 预置知识体系、25 个内置渠道（vs Hermes 16+）、100+ 工位模板、原生 A2A + AG-UI 协议支持、OpenAI 兼容 API Server。
+
+**Hermes 的优势**：Python 生态更成熟、GRPO + LoRA 的 RL 训练管线更完善、Nous Research 社区生态更大、Docker 沙箱隔离方案更成熟。
+
+**适合谁**：如果你需要 Python 生态和 RL 训练能力，选 Hermes；如果你需要 TypeScript 全栈、记忆进化、全渠道触达和生产工具链，选 OPC。
+
+#### vs OpenClaw
+
+**设计思路差异**：OpenClaw 是重量级 runtime + 配置驱动，提供完整的 Gateway 运行时环境，适合"安装一次、配置运行"的场景。OPC 是轻量 CLI + 代码优先，四件套可独立使用，适合开发者自由组合。
+
+**OPC 的优势**：模块化四件套可按需引入、100+ 工位模板、记忆进化系统、25 个内置渠道、`opc init/dev/test/deploy` 全生命周期 CLI、A2A/AG-UI 协议支持。
+
+**OpenClaw 的优势**：开箱即用的 runtime 体验、Puppeteer 浏览器自动化、成熟的权限和安全沙箱、配置驱动上手门槛低。
+
+**适合谁**：如果你偏好"配置即运行"的一体化方案，选 OpenClaw；如果你偏好代码优先、模块自由组合、需要记忆进化和工位体系，选 OPC。
+
+#### vs CrewAI
+
+**设计思路差异**：CrewAI 采用 Crew 编排模式——定义 Agent 角色、分配 Task、按流程执行。OPC 采用工位（Seat）+ 大脑（Brain）模式——每个 Agent 有独立记忆和工位模板，通过 Brain 实现知识积累和进化。
+
+**OPC 的优势**：记忆进化（不只是短期/长期记忆，而是自动聚类提炼）、Brain Seed 预置知识、25 个内置渠道（CrewAI 需自行接入）、100+ 工位模板、TypeScript 原生。
+
+**CrewAI 的优势**：Crew + Flow 编排模式直观易懂、Python 生态、100K+ 用户的成熟社区、Enterprise 版本功能丰富。
+
+**适合谁**：如果你需要多 Agent 任务编排且偏好 Python，选 CrewAI；如果你需要单 Agent 深度进化、全渠道部署、TypeScript 生态，选 OPC。
+
+#### vs AutoGen
+
+**设计思路差异**：AutoGen 是微软主导的对话驱动多 Agent 框架，核心是 Agent 之间的对话协作和 UserProxy 人机交互。OPC 是任务驱动的工位模式，强调单 Agent 的记忆进化和生产部署能力。
+
+**OPC 的优势**：记忆进化系统、Brain Seed、25 个内置渠道、100+ 工位模板、全生命周期 CLI、YAML 声明式配置。
+
+**AutoGen 的优势**：微软生态支持、分布式 Agent 能力、AutoGen Studio 可视化、UserProxy 人机交互模式成熟、Python/C# 双语言支持、社区活跃。
+
+**适合谁**：如果你需要多 Agent 对话协作和微软生态集成，选 AutoGen；如果你需要记忆进化、全渠道触达、工位模板和 TypeScript 工具链，选 OPC。
+
+#### 功能速查表
+
+| 功能 | OPC Agent | Hermes Agent | OpenClaw | CrewAI | AutoGen |
+|---|:-:|:-:|:-:|:-:|:-:|
+| **语言** | TypeScript | Python | TypeScript | Python | Python/C# |
+| **记忆进化 (evolve)** | ✅ | 🔶 | ❌ | ❌ | ❌ |
+| **Brain Seed 预置知识** | ✅ 三层 | ❌ | ❌ | ❌ | ❌ |
+| **内置渠道** | 25 | 16+ | 2 | ❌ | ❌ |
+| **工位模板** | 100+ | ❌ | ❌ | ❌ | ❌ |
+| **CLI 全生命周期** | ✅ 20+ 命令 | 🔶 | 🔶 | 🔶 | 🔶 |
+| **A2A + AG-UI** | ✅ | 🔶 / ❌ | ❌ | ❌ | ❌ |
+| **多 Agent 协作** | ✅ | ✅ | 🔶 | ✅ | ✅ |
+| **RL 训练** | ✅ 反馈优化 | ✅ GRPO+LoRA | ❌ | ❌ | ❌ |
+| **浏览器自动化** | ✅ | ✅ | ✅ | ❌ | ❌ |
+| **可视化** | ✅ OPC Studio | ✅ Dashboard | ❌ | 🔶 | ✅ Studio |
+| **社区成熟度** | 🚧 早期 | ✅ 活跃 | 🚧 小众 | ✅ 大规模 | ✅ 大规模 |
+| **许可证** | Apache-2.0 | MIT | MIT | Apache-2.0 | MIT |
+
+> 对比基于各项目公开文档（截至 2026 年 4 月）。各框架都在快速迭代，如有偏差欢迎 [Issue 指正](https://github.com/Deepleaper/opc-agent/issues)。
+
+---
+
 ## 🤝 贡献指南
 
 欢迎所有形式的贡献！

package/dist/channels/dingtalk.d.ts

@@ -0,0 +1,17 @@
+import { BaseChannel } from './index';
+export interface DingTalkChannelConfig {
+    webhookUrl: string;
+    secret?: string;
+    appKey?: string;
+    appSecret?: string;
+}
+export declare class DingTalkChannel extends BaseChannel {
+    readonly type = "dingtalk";
+    private config;
+    private running;
+    constructor(config: DingTalkChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=dingtalk.d.ts.map

package/dist/channels/dingtalk.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DingTalkChannel = void 0;
+const index_1 = require("./index");
+class DingTalkChannel extends index_1.BaseChannel {
+    type = 'dingtalk';
+    config;
+    running = false;
+    constructor(config) {
+        super();
+        if (!config.webhookUrl) {
+            throw new Error('DingTalkChannel requires webhookUrl in config');
+        }
+        this.config = config;
+    }
+    async start() {
+        this.running = true;
+    }
+    async stop() {
+        this.running = false;
+    }
+    async send(chatId, text) {
+        if (!this.running) {
+            throw new Error('DingTalkChannel: not started. Call start() first.');
+        }
+        const body = JSON.stringify({ msgtype: 'text', text: { content: text } });
+        const res = await fetch(this.config.webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body,
+        });
+        if (!res.ok) {
+            throw new Error(`DingTalk webhook failed: ${res.status}`);
+        }
+    }
+}
+exports.DingTalkChannel = DingTalkChannel;
+//# sourceMappingURL=dingtalk.js.map

package/dist/channels/googlechat.d.ts

@@ -0,0 +1,14 @@
+import { BaseChannel } from './index';
+export interface GoogleChatChannelConfig {
+    webhookUrl: string;
+}
+export declare class GoogleChatChannel extends BaseChannel {
+    readonly type = "googlechat";
+    private config;
+    private running;
+    constructor(config: GoogleChatChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(spaceId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=googlechat.d.ts.map

package/dist/channels/googlechat.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleChatChannel = void 0;
+const index_1 = require("./index");
+class GoogleChatChannel extends index_1.BaseChannel {
+    type = 'googlechat';
+    config;
+    running = false;
+    constructor(config) {
+        super();
+        if (!config.webhookUrl) {
+            throw new Error('GoogleChatChannel requires webhookUrl in config');
+        }
+        this.config = config;
+    }
+    async start() {
+        this.running = true;
+    }
+    async stop() {
+        this.running = false;
+    }
+    async send(spaceId, text) {
+        if (!this.running) {
+            throw new Error('GoogleChatChannel: not started. Call start() first.');
+        }
+        const res = await fetch(this.config.webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ text }),
+        });
+        if (!res.ok) {
+            throw new Error(`Google Chat webhook failed: ${res.status}`);
+        }
+    }
+}
+exports.GoogleChatChannel = GoogleChatChannel;
+//# sourceMappingURL=googlechat.js.map

package/dist/channels/imessage.d.ts

@@ -0,0 +1,13 @@
+import { BaseChannel } from './index';
+export interface IMessageChannelConfig {
+    applescriptPath?: string;
+}
+export declare class IMessageChannel extends BaseChannel {
+    readonly type = "imessage";
+    private config;
+    constructor(config?: IMessageChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=imessage.d.ts.map

package/dist/channels/imessage.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMessageChannel = void 0;
+const index_1 = require("./index");
+class IMessageChannel extends index_1.BaseChannel {
+    type = 'imessage';
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        try {
+            require('macOS iMessage CLI');
+        }
+        catch {
+            throw new Error('Install macOS iMessage CLI to use the IMessageChannel. Run: npm install macOS iMessage CLI');
+        }
+    }
+    async stop() {
+        // cleanup
+    }
+    async send(chatId, text) {
+        throw new Error('IMessageChannel: not yet connected. Call start() first.');
+    }
+}
+exports.IMessageChannel = IMessageChannel;
+//# sourceMappingURL=imessage.js.map

package/dist/channels/irc.d.ts

@@ -0,0 +1,20 @@
+import { BaseChannel } from './index';
+export interface IRCChannelConfig {
+    host: string;
+    port?: number;
+    nick: string;
+    channels: string[];
+    tls?: boolean;
+    password?: string;
+}
+export declare class IRCChannel extends BaseChannel {
+    readonly type = "irc";
+    private config;
+    private client;
+    private running;
+    constructor(config: IRCChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(target: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=irc.d.ts.map

package/dist/channels/irc.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IRCChannel = void 0;
+const index_1 = require("./index");
+class IRCChannel extends index_1.BaseChannel {
+    type = 'irc';
+    config;
+    client = null;
+    running = false;
+    constructor(config) {
+        super();
+        if (!config.host || !config.nick || !config.channels?.length) {
+            throw new Error('IRCChannel requires host, nick, and channels in config');
+        }
+        this.config = config;
+    }
+    async start() {
+        let IRC;
+        try {
+            IRC = require('irc-framework');
+        }
+        catch {
+            throw new Error('Install irc-framework to use the IRCChannel. Run: npm install irc-framework');
+        }
+        this.client = new IRC.Client();
+        this.client.connect({
+            host: this.config.host,
+            port: this.config.port ?? (this.config.tls ? 6697 : 6667),
+            nick: this.config.nick,
+            tls: this.config.tls ?? false,
+            password: this.config.password,
+        });
+        await new Promise((resolve, reject) => {
+            this.client.on('registered', () => {
+                for (const ch of this.config.channels) {
+                    this.client.join(ch);
+                }
+                resolve();
+            });
+            this.client.on('error', (err) => reject(new Error(`IRC connection error: ${err.message || err}`)));
+        });
+        this.running = true;
+        this.client.on('privmsg', async (event) => {
+            if (!this.handler)
+                return;
+            const msg = {
+                id: Date.now().toString(),
+                role: 'user',
+                content: event.message,
+                timestamp: Date.now(),
+                metadata: { channel: event.target, nick: event.nick },
+            };
+            await this.handler(msg);
+        });
+    }
+    async stop() {
+        if (this.client) {
+            this.client.quit('Goodbye');
+            this.client = null;
+        }
+        this.running = false;
+    }
+    async send(target, text) {
+        if (!this.running || !this.client) {
+            throw new Error('IRCChannel: not started. Call start() first.');
+        }
+        this.client.say(target, text);
+    }
+}
+exports.IRCChannel = IRCChannel;
+//# sourceMappingURL=irc.js.map

package/dist/channels/line.d.ts

@@ -0,0 +1,14 @@
+import { BaseChannel } from './index';
+export interface LINEChannelConfig {
+    channelAccessToken?: string;
+    channelSecret?: string;
+}
+export declare class LINEChannel extends BaseChannel {
+    readonly type = "line";
+    private config;
+    constructor(config?: LINEChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=line.d.ts.map

package/dist/channels/line.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LINEChannel = void 0;
+const index_1 = require("./index");
+class LINEChannel extends index_1.BaseChannel {
+    type = 'line';
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        try {
+            require('@line/bot-sdk');
+        }
+        catch {
+            throw new Error('Install @line/bot-sdk to use the LINEChannel. Run: npm install @line/bot-sdk');
+        }
+    }
+    async stop() {
+        // cleanup
+    }
+    async send(chatId, text) {
+        throw new Error('LINEChannel: not yet connected. Call start() first.');
+    }
+}
+exports.LINEChannel = LINEChannel;
+//# sourceMappingURL=line.js.map

package/dist/channels/matrix.d.ts

@@ -0,0 +1,15 @@
+import { BaseChannel } from './index';
+export interface MatrixChannelConfig {
+    homeserverUrl?: string;
+    accessToken?: string;
+    userId?: string;
+}
+export declare class MatrixChannel extends BaseChannel {
+    readonly type = "matrix";
+    private config;
+    constructor(config?: MatrixChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=matrix.d.ts.map

package/dist/channels/matrix.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MatrixChannel = void 0;
+const index_1 = require("./index");
+class MatrixChannel extends index_1.BaseChannel {
+    type = 'matrix';
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        try {
+            require('matrix-js-sdk');
+        }
+        catch {
+            throw new Error('Install matrix-js-sdk to use the MatrixChannel. Run: npm install matrix-js-sdk');
+        }
+    }
+    async stop() {
+        // cleanup
+    }
+    async send(chatId, text) {
+        throw new Error('MatrixChannel: not yet connected. Call start() first.');
+    }
+}
+exports.MatrixChannel = MatrixChannel;
+//# sourceMappingURL=matrix.js.map

package/dist/channels/mattermost.d.ts

@@ -0,0 +1,18 @@
+import { BaseChannel } from './index';
+export interface MattermostChannelConfig {
+    serverUrl: string;
+    token: string;
+    teamId?: string;
+    defaultChannelId?: string;
+}
+export declare class MattermostChannel extends BaseChannel {
+    readonly type = "mattermost";
+    private config;
+    private running;
+    private ws;
+    constructor(config: MattermostChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(channelId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=mattermost.d.ts.map

package/dist/channels/mattermost.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MattermostChannel = void 0;
+const index_1 = require("./index");
+class MattermostChannel extends index_1.BaseChannel {
+    type = 'mattermost';
+    config;
+    running = false;
+    ws = null;
+    constructor(config) {
+        super();
+        if (!config.serverUrl || !config.token) {
+            throw new Error('MattermostChannel requires serverUrl and token in config');
+        }
+        this.config = config;
+    }
+    async start() {
+        // Verify connection by hitting the API
+        const res = await fetch(`${this.config.serverUrl}/api/v4/users/me`, {
+            headers: { Authorization: `Bearer ${this.config.token}` },
+        }).catch(() => null);
+        this.running = true;
+    }
+    async stop() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.running = false;
+    }
+    async send(channelId, text) {
+        if (!this.running) {
+            throw new Error('MattermostChannel: not started. Call start() first.');
+        }
+        const res = await fetch(`${this.config.serverUrl}/api/v4/posts`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.config.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ channel_id: channelId, message: text }),
+        });
+        if (!res.ok) {
+            throw new Error(`Mattermost API failed: ${res.status}`);
+        }
+    }
+}
+exports.MattermostChannel = MattermostChannel;
+//# sourceMappingURL=mattermost.js.map

package/dist/channels/msteams.d.ts

@@ -0,0 +1,14 @@
+import { BaseChannel } from './index';
+export interface MSTeamsChannelConfig {
+    appId?: string;
+    appPassword?: string;
+}
+export declare class MSTeamsChannel extends BaseChannel {
+    readonly type = "msteams";
+    private config;
+    constructor(config?: MSTeamsChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=msteams.d.ts.map

package/dist/channels/msteams.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MSTeamsChannel = void 0;
+const index_1 = require("./index");
+class MSTeamsChannel extends index_1.BaseChannel {
+    type = 'msteams';
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        try {
+            require('botframework-connector');
+        }
+        catch {
+            throw new Error('Install botframework-connector to use the MSTeamsChannel. Run: npm install botframework-connector');
+        }
+    }
+    async stop() {
+        // cleanup
+    }
+    async send(chatId, text) {
+        throw new Error('MSTeamsChannel: not yet connected. Call start() first.');
+    }
+}
+exports.MSTeamsChannel = MSTeamsChannel;
+//# sourceMappingURL=msteams.js.map

package/dist/channels/nostr.d.ts

@@ -0,0 +1,14 @@
+import { BaseChannel } from './index';
+export interface NostrChannelConfig {
+    privateKey?: string;
+    relays?: string[];
+}
+export declare class NostrChannel extends BaseChannel {
+    readonly type = "nostr";
+    private config;
+    constructor(config?: NostrChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=nostr.d.ts.map

package/dist/channels/nostr.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NostrChannel = void 0;
+const index_1 = require("./index");
+class NostrChannel extends index_1.BaseChannel {
+    type = 'nostr';
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        try {
+            require('nostr-tools');
+        }
+        catch {
+            throw new Error('Install nostr-tools to use the NostrChannel. Run: npm install nostr-tools');
+        }
+    }
+    async stop() {
+        // cleanup
+    }
+    async send(chatId, text) {
+        throw new Error('NostrChannel: not yet connected. Call start() first.');
+    }
+}
+exports.NostrChannel = NostrChannel;
+//# sourceMappingURL=nostr.js.map

package/dist/channels/qq.d.ts

@@ -0,0 +1,15 @@
+import { BaseChannel } from './index';
+export interface QQChannelConfig {
+    appId?: string;
+    token?: string;
+    sandbox?: boolean;
+}
+export declare class QQChannel extends BaseChannel {
+    readonly type = "qq";
+    private config;
+    constructor(config?: QQChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=qq.d.ts.map

package/dist/channels/qq.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QQChannel = void 0;
+const index_1 = require("./index");
+class QQChannel extends index_1.BaseChannel {
+    type = 'qq';
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        try {
+            require('qq-bot-sdk');
+        }
+        catch {
+            throw new Error('Install qq-bot-sdk to use the QQChannel. Run: npm install qq-bot-sdk');
+        }
+    }
+    async stop() {
+        // cleanup
+    }
+    async send(chatId, text) {
+        throw new Error('QQChannel: not yet connected. Call start() first.');
+    }
+}
+exports.QQChannel = QQChannel;
+//# sourceMappingURL=qq.js.map

package/dist/channels/signal.d.ts

@@ -0,0 +1,14 @@
+import { BaseChannel } from './index';
+export interface SignalChannelConfig {
+    signalCliPath?: string;
+    phoneNumber?: string;
+}
+export declare class SignalChannel extends BaseChannel {
+    readonly type = "signal";
+    private config;
+    constructor(config?: SignalChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=signal.d.ts.map