Task Plugin V3

Name: Task Plugin V3
Rating: 3.5 (1 reviews)
Author: bjyounger

By bjyounger 👁 2 views ▲ 0 votes

Task Plugin V3 for OpenClaw - API封装、任务管理、类型安全

GitHub

Install

npm install task-plugin-v3

README

# Task Plugin V3 for OpenClaw

**版本**: 3.0.0
**状态**: 开发完成
**作者**: 杨珂

---

## 简介

Task Plugin V3 是一个用于 OpenClaw 的任务管理框架，提供：

- ✅ **API 封装** - 正确封装 OpenClaw 的 `runtime.taskFlow` API
- ✅ **类型安全** - 完整的 TypeScript 类型定义
- ✅ **任务管理** - 创建、查询、取消任务
- ✅ **事件系统** - 15 种类型安全的事件类型
- ✅ **记忆管理** - 三层记忆架构
- ✅ **审计日志** - 完整的任务审计
- ✅ **数据加密** - 任务数据加密存储

---

## 架构设计

### 四层架构

```
┌─────────────────────────────────────────┐
│      Application Layer (应用层)          │
│  SessionTaskManager (核心协调器)          │
└─────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────┐
│     Coordination Layer (协调层)          │
│  EventManager | MemoryManager | Audit   │
└─────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────┐
│     Capability Layer (能力层)            │
│  OpenClawBridge | Encryption | Storage  │
└─────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────┐
│    OpenClaw Native Layer (原生层)        │
│        runtime.taskFlow API             │
└─────────────────────────────────────────┘
```

---

## 核心功能

### 1. 任务创建

```typescript
import { SessionTaskManager } from 'task-plugin-v3';

const manager = new SessionTaskManager({
  bridge: new OpenClawBridge({ ctx })
});

// 创建主任务
const mainTask = await manager.createMainTask({
  label: '数据处理任务',
  task: 'process-data',
  priority: 'high'
});

// 创建子任务
const subTask = await manager.createSubTask({
  parentTaskId: mainTask.id,
  label: '数据下载',
  task: 'download'
});
```

### 2. 任务查询

```typescript
// 查询单个任务
const task = await manager.getTask(taskId);

// 查询任务流
const flow = await manager.getTaskFlow(flowId);

// 批量查询
const tasks = await manager.queryTasks({
  status: 'running',
  limit: 10
});
```

### 3. 事件监听

```typescript
manager.eventManager.on('task:created', (event) => {
  console.log('Task created:', event.taskId);
});

manager.eventManager.on('task:completed', (event) => {
  console.log('Task completed:', event.taskId);
});
```

---

## 安装

```bash
npm install task-plugin-v3
# 或
yarn add task-plugin-v3
# 或
pnpm add task-plugin-v3
```

---

## 开发

### 安装依赖

```bash
pnpm install
```

### 运行测试

```bash
pnpm test
```

### 构建

```bash
pnpm build
```

---

## 项目结构

```
task-plugin-v3/
├── src/
│   ├── core/
│   │   ├── bridge.ts          # OpenClaw API 桥接
│   │   ├── types.ts           # 类型定义
│   │   ├── events/            # 事件系统
│   │   └── managers/          # 管理器
│   └── index.ts               # 入口文件
├── tests/                     # 测试文件
├── docs/                      # 文档
├── examples/                  # 示例代码
├── package.json
├── tsconfig.json
└── README.md
```

---

## 文档

- [架构设计](./docs/architecture/)
- [API 参考](./docs/api/)
- [使用指南](./docs/guides/)
- [示例代码](./examples/)

---

## 特性对比

| 特性 | v3 | 说明 |
|------|----|----|
| **正确 API** | ✅ | 使用 `runtime.taskFlow` |
| **类型安全** | ✅ | 完整 TypeScript |
| **事件系统** | ✅ | 15 种事件类型 |
| **记忆管理** | ✅ | 三层架构 |
| **审计日志** | ✅ | 完整审计 |
| **数据加密** | ✅ | AES 加密 |
| **生产验证** | ⏳ | 待验证 |

---

## 许可证

MIT

---

## 作者

**杨珂**
- GitHub: [@bjyounger](https://github.com/bjyounger)

---

## 相关项目

- [OpenClaw](https://github.com/openclaw/openclaw) - OpenClaw 主项目
- [task-monitor-v14](https://github.com/bjyounger/openclaw-task-monitor) - Task Monitor v14

---

**Created**: 2026-04-17
**Last Updated**: 2026-04-17

integration