Architecture

┌──────────────────────────────────────────────────────────────┐
│  React 渲染端 (src/, packages/ui/*)                          │
│    Vite + React 18 + Zustand stores                          │
│    基底: --wb-* tokens, 207 图标, 品牌原子                   │
└──────────────────────┬───────────────────────────────────────┘
                       │  window.api(类型化 contextBridge)
┌──────────────────────┴───────────────────────────────────────┐
│  Electron Main + preload bridge                              │
│    ipc.ts                ← 白名单 IPC 处理器                 │
│    agent-host.ts         ← Pi AgentSession 生命周期           │
│    pi-event-bridge.ts    ← 具备清理意识的 pi://* 事件          │
│    pi-resources.ts       ← 本地持久化(Cordis fs)              │
│    capability-*.ts       ← Cordis 能力服务                    │
└──────────────────────┬───────────────────────────────────────┘
                       │  类型化 Pi 会话事件
┌──────────────────────┴───────────────────────────────────────┐
│  Pi AgentSession + Cordis 能力服务                            │
│    providers, tools, permissions, plans, tasks, persistence  │
└──────────────────────────────────────────────────────────────┘

import { Context, OpenBuddyService } from "@openbuddy/cordis";

export class MemoryService extends OpenBuddyService {
  constructor(ctx: Context, options?: Partial<Config>) {
    super(ctx, "openbuddy.capability.memory", options);
    this.cache = new Map();
  }

  async recall(query: string): Promise<string[]> {
    return this.cache.get(query) ?? [];
  }

  async remember(key: string, value: string) {
    this.cache.set(key, [value]);
    this.ctx.emit("memory:written", { key, value });
  }
}

export default function apply(ctx: Context) {
  ctx.plugin(MemoryService, ctx.config);
}

1. 用户在 Composer.tsx 输入
2. Composer 调 window.api.invoke("agent:prompt", { text, context })
3. preload/index.ts 转发到 ipc.ts 处理器 "agent:prompt"
4. agent-host.ts 调用 Pi AgentSession.prompt()
5. Pi 决策: "调 read_file(path=…) 工具"
6. AgentSession 调 Cordis 上下文 plugin(FileService).read(path)
7. FileService 用 @openbuddy/fs-fs-local 从磁盘读
8. 权限检查:路径在用户已授权信任的文件夹内吗?
   ├─ 是 → 继续
   └─ 否 → 发出 permission:request 事件 → 渲染端弹模态框
9. Pi 用结果调 LLM(Anthropic / OpenAI / NewAPI)
10. LLM 流式返回总结
11. AgentSession 发出 pi://message-delta 事件
12. pi-event-bridge 经 webContents.send 转发给渲染端
13. ChatView.tsx 把 delta 追加到可见消息
14. 完成时 AgentSession 发出 pi://done
15. Composer 把结果存进 @openbuddy/capability-memory