openvibe 0.63.2 → 0.63.3

package/docs/HYBRID_CLOUD_README.md

@@ -0,0 +1,188 @@
+# OpenVibe Hybrid Cloud Architecture
+
+## 云端-本地混合 AI 架构实现
+
+此架构实现了云端 AI (Claude Code) 与本地计算资源的协同工作，支持将计算密集型任务卸载到本地执行。
+
+## 当前实现状态
+
+### MVP 版本 (HTTP 实现)
+
+OpenVibe 当前通过内置 HTTP 服务提供本地执行能力：
+
+- **协议**: HTTP REST API
+- **服务**: CompanionHttpServer (TypeScript)
+- **端口**: 默认 50051
+- **主机**: 127.0.0.1 (本地绑定)
+
+### 配置方式
+
+在 `~/.openvibe/settings.json` 中添加:
+
+```json
+{
+  "companion": {
+    "enabled": true,
+    "autoStart": true,
+    "port": 50051,
+    "host": "127.0.0.1",
+    "apiKey": "optional-api-key"
+  }
+}
+```
+
+### 可用功能
+
+| 功能 | 说明 |
+|------|------|
+| 资源监控 | CPU/内存/磁盘实时状态 |
+| 命令执行 | 安全沙箱内执行白名单命令 |
+| 任务调度 | 优先级队列与超时管理 |
+
+### Slash 命令
+
+| 命令 | 功能 |
+|------|------|
+| `/local-status` | 显示本地资源状态 |
+| `/local-execute <cmd>` | 在沙箱中执行本地命令 |
+
+### 安全机制
+
+当前实现包含以下安全措施：
+
+- **命令白名单**: 仅允许预定义的安全命令
+- **路径访问控制**: 阻止访问敏感系统路径
+- **资源限制**: 执行时间与内存使用上限
+- **网络隔离**: 默认禁止网络访问
+
+---
+
+## 架构设计 (未来规划)
+
+以下架构计划在后续版本实现：
+
+### 目标架构图
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                          云端层                                  │
+│                    OpenVibe (Claude Code)                        │
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐  │
+│  │   推理引擎    │  │ Hybrid Cloud │  │   Local Agent Client │  │
+│  │  (Claude)    │  │   Manager    │  │   (TypeScript/gRPC)  │  │
+│  └──────┬───────┘  └──────┬───────┘  └──────────┬───────────┘  │
+│         └─────────────────┼─────────────────────┘              │
+│                           │ WebSocket / gRPC                   │
+└───────────────────────────┼────────────────────────────────────┘
+                            │ TLS 1.3 + mTLS
+                            ▼
+┌───────────────────────────┼────────────────────────────────────┐
+│                      本地代理层 (Local Agent)                    │
+│                        Rust + Tokio                              │
+│  ┌────────────────────────┴─────────────────────────────────┐  │
+│  │                 Local Agent Daemon                         │  │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐   │  │
+│  │  │ 调度器       │  │  执行器      │  │   安全模块       │   │  │
+│  │  │(Scheduler)  │  │ (Executor)  │  │   (Sandbox)     │   │  │
+│  │  └──────┬──────┘  └──────┬──────┘  └─────────────────┘   │  │
+│  │         └────────────────┼─────────────────────────────   │  │
+│  │                          ▼                                 │  │
+│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │  │
+│  │  │ CPU 池   │  │ GPU 池   │  │ 磁盘 I/O │  │ 网络      │   │  │
+│  │  │(多线程)  │  │(CUDA)    │  │(异步)    │  │(流式)    │   │  │
+│  │  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │  │
+│  └────────────────────────────────────────────────────────────┘  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+### 目标特性
+
+1. **gRPC 通信协议**
+   - 双向流式通信
+   - 更低延迟
+   - 更高吞吐量
+
+2. **Rust 本地代理**
+   - 高性能任务执行
+   - GPU 计算支持 (CUDA/ROCm)
+   - 智能调度算法
+
+3. **增强安全**
+   - mTLS 认证
+   - seccomp 沙箱
+   - 完整审计日志
+
+---
+
+## 多语言执行支持
+
+| 语言 | 执行环境 | 沙箱 |
+|------|---------|------|
+| Python | python3 | 受限文件访问 |
+| JavaScript | Node.js | 受限文件访问 |
+| Rust | cargo | 编译沙箱 |
+| Bash | bash | 命令白名单 |
+
+---
+
+## 性能目标
+
+| 指标 | 当前 (HTTP) | 目标 (gRPC) |
+|------|-------------|-------------|
+| 任务调度延迟 | ~20ms | < 10ms |
+| 云端-本地延迟 | ~50ms | < 20ms |
+| 任务吞吐量 | ~500 TPS | > 1000 TPS |
+| 故障恢复时间 | ~5s | < 2s |
+
+---
+
+## 故障排查
+
+### 常见问题
+
+1. **服务未启动**
+   ```bash
+   # 检查服务状态
+   netstat -an | grep 50051
+
+   # 手动启动
+   openvibe --enable-companion
+   ```
+
+2. **命令被拒绝**
+   - 检查命令是否在白名单中
+   - 查看 `~/.openvibe/agent-debug.log` 获取详情
+
+3. **资源不足**
+   - 检查本地资源状态: `/local-status`
+   - 调整 `companion.port` 或 `companion.host`
+
+### 日志位置
+
+- OpenVibe: `~/.openvibe/agent-debug.log`
+- 配置文件: `~/.openvibe/settings.json`
+
+---
+
+## 路线图
+
+### Phase 1: MVP ✅ (当前)
+- [x] HTTP REST API 服务
+- [x] 基础命令执行
+- [x] 资源监控
+
+### Phase 2: 核心功能 (计划中)
+- [ ] gRPC 协议迁移
+- [ ] Rust 本地代理
+- [ ] GPU 计算支持
+
+### Phase 3: 生产就绪
+- [ ] 高可用部署
+- [ ] 多租户支持
+- [ ] 企业安全合规
+
+---
+
+## 许可证
+
+MIT License - 详见 LICENSE 文件

package/docs/hybrid-architecture-design.md

@@ -0,0 +1,317 @@
+# 云端-本地混合 AI 架构设计
+
+## 1. 架构总览
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                           云端层 (Cloud Layer)                           │
+│  ┌─────────────────────────────────────────────────────────────────┐   │
+│  │                    Claude Code (云端推理引擎)                     │   │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │   │
+│  │  │  推理规划    │  │  代码生成    │  │     Tool 调用编排        │ │   │
+│  │  │  (Reasoning)│  │  (Codegen)  │  │   (Tool Orchestration)  │ │   │
+│  │  └──────┬──────┘  └──────┬──────┘  └───────────┬─────────────┘ │   │
+│  │         └─────────────────┼─────────────────────┘               │   │
+│  │                           ▼                                      │   │
+│  │              ┌─────────────────────────┐                        │   │
+│  │              │    本地资源代理客户端     │                        │   │
+│  │              │   (Local Agent Client)  │                        │   │
+│  │              └───────────┬─────────────┘                        │   │
+│  └──────────────────────────┼──────────────────────────────────────┘   │
+└─────────────────────────────┼───────────────────────────────────────────┘
+                              │ WebSocket / gRPC / HTTP/2
+                              │ (双向流式通信)
+┌─────────────────────────────┼───────────────────────────────────────────┐
+│                      本地代理层 (Local Agent Layer)                      │
+│  ┌──────────────────────────┼──────────────────────────────────────┐   │
+│  │                          ▼                                       │   │
+│  │            ┌─────────────────────────┐                          │   │
+│  │            │     本地代理服务         │                          │   │
+│  │            │    (Local Agent Daemon) │                          │   │
+│  │            │  - 安全沙箱执行环境       │                          │   │
+│  │            │  - 资源调度管理器         │                          │   │
+│  │            │  - 任务队列处理器         │                          │   │
+│  │            └───────────┬─────────────┘                          │   │
+│  │                        │                                         │   │
+│  │         ┌──────────────┼──────────────┐                        │   │
+│  │         ▼              ▼              ▼                        │   │
+│  │  ┌────────────┐  ┌────────────┐  ┌────────────┐               │   │
+│  │  │  CPU 池    │  │  GPU 池    │  │  磁盘 I/O  │               │   │
+│  │  │(计算密集型)│  │(CUDA/ROCm) │  │(异步读写)  │               │   │
+│  │  └──────┬─────┘  └──────┬─────┘  └──────┬─────┘               │   │
+│  │         │              │              │                       │   │
+│  │         └──────────────┼──────────────┘                       │   │
+│  │                        ▼                                       │   │
+│  │              ┌─────────────────┐                              │   │
+│  │              │   结果聚合器     │                              │   │
+│  │              │  (Aggregator)   │                              │   │
+│  │              └────────┬────────┘                              │   │
+│  └───────────────────────┼────────────────────────────────────────┘   │
+└──────────────────────────┼────────────────────────────────────────────┘
+                           │
+                           ▼ WebSocket / gRPC Response
+              ┌─────────────────────────┐
+              │   云端结果接收 & 展示    │
+              └─────────────────────────┘
+```
+
+## 2. 核心组件详解
+
+### 2.1 云端层 (Cloud Layer)
+
+| 模块 | 职责 | 技术栈 |
+|------|------|--------|
+| Reasoning Engine | 复杂推理规划 | Claude 3.5/4 |
+| Code Generator | 代码生成与优化 | 多语言支持 |
+| Tool Orchestrator | 工具调用编排 | 动态调度 |
+| Local Agent Client | 与本地代理通信 | gRPC/WebSocket |
+
+### 2.2 本地代理层 (Local Agent Layer)
+
+| 模块 | 职责 | 技术栈 |
+|------|------|--------|
+| Agent Daemon | 核心服务进程 | Node.js / Rust |
+| Security Sandbox | 安全执行环境 | seccomp / gVisor |
+| Resource Manager | 资源调度管理 | 自定义调度器 |
+| Task Queue | 任务队列处理 | Bull / RabbitMQ |
+| CPU Pool | 多线程计算 | Worker Threads |
+| GPU Pool | GPU 计算 | CUDA / ROCm |
+| I/O Scheduler | 异步磁盘 I/O | libuv / io_uring |
+
+## 3. 通信协议设计
+
+### 3.1 消息类型
+
+```typescript
+// 任务请求
+interface TaskRequest {
+  taskId: string;
+  type: 'compute' | 'io' | 'gpu';
+  priority: number;
+  payload: {
+    code?: string;
+    files?: string[];
+    parameters?: Record<string, unknown>;
+  };
+  resourceRequirements: {
+    minCpuCores?: number;
+    minGpuMemory?: number;
+    timeout: number;
+  };
+}
+
+// 任务响应
+interface TaskResponse {
+  taskId: string;
+  status: 'pending' | 'running' | 'completed' | 'failed';
+  result?: unknown;
+  error?: string;
+  metrics: {
+    cpuTime: number;
+    gpuTime?: number;
+    memoryUsed: number;
+  };
+}
+
+// 资源状态
+interface ResourceStatus {
+  timestamp: number;
+  cpu: {
+    cores: number;
+    usage: number[];
+    available: number;
+  };
+  gpu: {
+    devices: Array<{
+      id: number;
+      name: string;
+      memoryTotal: number;
+      memoryUsed: number;
+      utilization: number;
+    }>;
+  };
+  disk: {
+    readSpeed: number;
+    writeSpeed: number;
+    queueDepth: number;
+  };
+}
+```
+
+### 3.2 通信流程
+
+```
+1. 云端发起任务请求 (TaskRequest)
+   ↓ WebSocket/gRPC 流
+2. 本地代理接收任务，进行资源评估
+   ↓
+3. 根据资源需求调度到合适执行器
+   ↓
+4. 实时推送进度更新 (Stream)
+   ↓ WebSocket/gRPC 双向流
+5. 任务完成，返回结果 (TaskResponse)
+   ↓
+6. 云端接收结果，继续推理
+```
+
+## 4. 安全架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      安全边界设计                             │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│   ┌─────────────┐         TLS 1.3          ┌─────────────┐ │
+│   │   云端      │◄───────────────────────►│  本地网关    │ │
+│   └─────────────┘      双向认证             └──────┬──────┘ │
+│                                                   │        │
+│                                              本地防火墙     │
+│                                                   │        │
+│                                            ┌──────▼──────┐ │
+│                                            │  本地代理    │ │
+│                                            │  (沙箱内)    │ │
+│                                            └──────┬──────┘ │
+│                                                   │        │
+│                                            seccomp-bpf     │
+│                                                   │        │
+│                                            ┌──────▼──────┐ │
+│                                            │  资源执行器  │ │
+│                                            │ (受限权限)   │ │
+│                                            └─────────────┘ │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 5. 资源调度策略
+
+### 5.1 调度算法
+
+```
+┌───────────────────────────────────────────────────────────────┐
+│                    智能调度器 (Scheduler)                      │
+├───────────────────────────────────────────────────────────────┤
+│                                                               │
+│  1. 任务分类                                                  │
+│     ├── CPU 密集型 (编译、数据处理)                             │
+│     ├── GPU 密集型 (模型推理、训练)                             │
+│     └── I/O 密集型 (文件操作、网络请求)                          │
+│                                                               │
+│  2. 资源匹配                                                   │
+│     └── 根据任务类型匹配最优资源池                              │
+│                                                               │
+│  3. 优先级队列                                                 │
+│     ├── P0: 用户交互响应 (实时性要求)                           │
+│     ├── P1: 计算任务 (性能要求)                                 │
+│     └── P2: 后台任务 (资源空闲时执行)                           │
+│                                                               │
+│  4. 动态扩缩容                                                 │
+│     └── 根据负载自动调整工作线程数                              │
+│                                                               │
+└───────────────────────────────────────────────────────────────┘
+```
+
+## 6. 部署架构
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         云端部署                                 │
+│  ┌─────────────────────────────────────────────────────────┐   │
+│  │  Kubernetes Cluster                                      │   │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │   │
+│  │  │ Claude Pod  │  │ Claude Pod  │  │ Claude Pod  │     │   │
+│  │  │   (推理)     │  │   (推理)     │  │   (推理)     │     │   │
+│  │  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘     │   │
+│  │         └─────────────────┼─────────────────┘            │   │
+│  │                           ▼                              │   │
+│  │                  ┌─────────────────┐                     │   │
+│  │                  │  Load Balancer  │                     │   │
+│  │                  └─────────────────┘                     │   │
+│  └─────────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────┘
+                                    │
+                                    │ Internet
+                                    │ (WebSocket/WSS)
+                                    ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                         用户本地                                │
+│  ┌─────────────────────────────────────────────────────────┐   │
+│  │  Local Agent Service                                     │   │
+│  │  ┌─────────────────────────────────────────────────┐    │   │
+│  │  │  Systemd / Windows Service / macOS LaunchAgent  │    │   │
+│  │  │  - 开机自启动                                    │    │   │
+│  │  │  - 自动重连                                      │    │   │
+│  │  │  - 资源监控                                      │    │   │
+│  │  └─────────────────────────────────────────────────┘    │   │
+│  └─────────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## 7. 技术选型建议
+
+| 层次 | 方案 A (Node.js) | 方案 B (Rust) | 推荐 |
+|------|-----------------|---------------|------|
+| 本地代理 | Node.js + TypeScript | Rust + Tokio | Rust (性能) |
+| 通信协议 | Socket.io | gRPC + Tonic | gRPC |
+| 任务队列 | BullMQ | Apache Kafka | BullMQ |
+| GPU 计算 | CUDA Node.js bindings | Rust CUDA | 混合方案 |
+| 沙箱 | vm2 + seccomp | Firecracker | Firecracker |
+
+## 8. 核心代码结构
+
+```
+local-agent/
+├── src/
+│   ├── main.rs              # 入口
+│   ├── server/
+│   │   ├── grpc.rs          # gRPC 服务
+│   │   └── websocket.rs     # WebSocket 服务
+│   ├── scheduler/
+│   │   ├── mod.rs           # 调度器
+│   │   ├── cpu_pool.rs      # CPU 池
+│   │   ├── gpu_pool.rs      # GPU 池
+│   │   └── io_pool.rs       # I/O 池
+│   ├── executor/
+│   │   ├── mod.rs           # 执行器
+│   │   ├── sandbox.rs       # 沙箱
+│   │   └── monitor.rs       # 监控
+│   ├── security/
+│   │   ├── auth.rs          # 认证
+│   │   └── acl.rs           # 权限
+│   └── proto/
+│       └── agent.proto      # Protocol Buffers
+├── Cargo.toml
+└── config.yaml
+```
+
+## 9. 性能指标目标
+
+| 指标 | 目标值 |
+|------|--------|
+| 任务调度延迟 | < 10ms |
+| 云端-本地通信延迟 | < 50ms (同城) |
+| CPU 利用率 | > 80% (满负载) |
+| GPU 内存利用率 | > 70% |
+| 任务吞吐量 | > 1000 TPS |
+| 故障恢复时间 | < 5s |
+
+## 10. 实现路线图
+
+### Phase 1: MVP (4周)
+- [ ] 基础 gRPC 通信
+- [ ] 简单任务执行 (bash)
+- [ ] 基础资源监控
+
+### Phase 2: 核心功能 (6周)
+- [ ] CPU/GPU 资源池
+- [ ] 任务调度器
+- [ ] 安全沙箱
+
+### Phase 3: 优化 (4周)
+- [ ] 智能调度算法
+- [ ] 性能优化
+- [ ] 监控告警
+
+### Phase 4: 生产就绪 (4周)
+- [ ] 高可用部署
+- [ ] 多租户支持
+- [ ] 企业安全合规

package/docs/todo.md

@@ -0,0 +1,71 @@
+# Todo 列表功能
+
+OpenVibe 内置了智能的待办事项管理功能，AI 会自动为复杂任务创建和管理任务列表。
+
+## AI 自动任务管理
+
+当 AI 检测到复杂或多步骤任务时，会自动创建 todo 列表来跟踪进度：
+
+### 自动创建任务的场景
+
+AI 会在以下情况自动创建任务列表：
+- 复杂功能实现
+- 多文件重构
+- 需要多个步骤的 bug 修复
+- 项目设置或配置
+- 包含多个问题的代码审查
+
+### 工作流程示例
+
+**用户:** 帮我添加用户认证功能
+
+**AI:** (自动创建任务列表)
+```
+I'll create a todo list to track our progress on this task:
+
+1. [ ] Analyze current codebase structure
+2. [ ] Design authentication flow
+3. [ ] Create auth middleware (high priority)
+4. [ ] Implement login endpoint
+5. [ ] Add session/token management
+6. [ ] Test complete implementation
+```
+
+然后 AI 会在完成每个步骤时自动标记为完成。
+
+## 斜杠命令
+
+你也可以手动管理任务：
+
+| 命令 | 功能 |
+|------|------|
+| `/todo` | 显示所有待办事项 |
+| `/todo:add <text>` | 添加任务 |
+| `/todo:done <id/text>` | 完成任务 |
+| `/todo:undo <id/text>` | 重新打开任务 |
+| `/todo:remove <id/text>` | 删除任务 |
+| `/todo:clear` | 清除已完成任务 |
+| `/todo:clear-all` | 清除所有任务 |
+
+## 优先级说明
+
+任务支持三种优先级：
+- `high` / `!!!` - 关键路径项目，阻塞依赖
+- `medium` / `!!` - 重要但不阻塞（默认）
+- `low` / `!` - 可选改进
+
+添加任务时指定优先级：
+```
+/todo:add 修复关键bug priority:high
+```
+
+## 数据存储
+
+Todo 列表数据存储在 `~/.openvibe/agent/todo.json`，会在会话间保持同步。
+
+## 提示 AI 使用任务管理
+
+如果你想让 AI 为特定任务创建 todo 列表，可以说：
+- "创建一个任务列表来跟踪这个"
+- "帮我分解这个任务"
+- "使用 todo 来管理这个任务"

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-custom-provider",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-custom-provider",
-      "version": "1.8.1",
+      "version": "1.8.2",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.52.0"
       }

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-anthropic",
   "private": true,
-  "version": "1.8.1",
+  "version": "1.8.2",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-gitlab-duo",
   "private": true,
-  "version": "1.8.1",
+  "version": "1.8.2",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-qwen-cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-qwen-cli",
   "private": true,
-  "version": "1.7.1",
+  "version": "1.7.2",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "1.21.1",
+  "version": "1.21.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "1.21.1",
+      "version": "1.21.2",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-with-deps",
   "private": true,
-  "version": "1.21.1",
+  "version": "1.21.2",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "openvibe",
-	"version": "0.63.2",
+	"version": "0.63.3",
 	"description": "OpenVibe - AI Coding Assistant CLI",
 	"type": "module",
 	"piConfig": {
@@ -42,9 +42,9 @@
 	},
 	"dependencies": {
 		"@mariozechner/jiti": "^2.6.2",
-		"@boxiaolanya2008/pi-agent-core": "^0.62.0",
-		"@boxiaolanya2008/pi-ai": "^0.62.0",
-		"@boxiaolanya2008/pi-tui": "^0.62.0",
+		"@boxiaolanya2008/pi-agent-core": "^0.63.3",
+		"@boxiaolanya2008/pi-ai": "^0.63.3",
+		"@boxiaolanya2008/pi-tui": "^0.63.3",
 		"@silvia-odwyer/photon-node": "^0.3.4",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",