OpenBuddy 代码库分析

openbuddy/                          # monorepo 根 (moon workspace)
├── moon.yml                        # 渲染端 moon 工程 (Vite + React)        [V]
├── electron/
│   └── moon.yml                    # Electron 主进程 + preload moon 工程      [V]
├── electron.vite.config.ts         # 别名 @openbuddy/* → packages/*/src/index.ts [V]
├── electron-builder.yml            # productName: OpenBuddy, appId: com.openbuddy.desktop [V]
├── src/                            # React 渲染端(由 electron-vite 别名解析)
├── packages/                       # 64 个已发布的 workspace 包              [V]
├── apps/                           # admin-portal(Casdoor OIDC + Resource Gateway SPA) [OOS]
├── evals/                          # node 评测 harness(MT-Bench、BFCL、AgentBench……) [V]
├── scripts/                        # 开发/构建/评测辅助脚本                  [V]
├── docs/                           # 本文档所在位置                          [V]
├── public/                         # 静态资源(favicon、locales)              [V]
├── build/                          # electron-builder 构建资源               [V]
├── deploy/                         # 部署模板                                [OOS]
├── services/                       # 发布的 systemd 单元 / launchd plist      [OOS]
├── playwright.config.ts            # Electron UI 烟测                        [V]
├── vitest.config.ts                # vitest 单元/集成测试 runner              [V]
├── tsconfig.json / tsconfig.base.json  # 严格 TS 5.6、路径                  [V]
└── pnpm-workspace.yaml             # workspace 根(packages/*、apps/*、services/*) [V]

projects:
  globs:
    - "packages/*/*"
    - "moon.yml"
    - "electron/moon.yml"

find packages -mindepth 2 -name "package.json" \
  -not -path "*/node_modules/*" \
  -not -path "*/__fixtures__/*" \
  -exec grep -h '"name":' {} \;

electron/
├── moon.yml                        # Electron 宿主 moon 工程         [V]
├── main/                           # 主进程(Node + Cordis)            [V]
│   ├── agent/                      # Pi AgentSession 生命周期          [V]
│   ├── ipc/                        # IPC 处理器(白名单)               [V]
│   ├── capability/                 # Cordis 能力接线                  [V]
│   ├── casdoor/                    # Casdoor OIDC 客户端              [V]
│   ├── collaboration/              # 协作运行时                       [V]
│   ├── harness/                    # 评测/审计的 WebSocket harness     [V]
│   ├── deepseek/                   # DeepSeek 兼容垫片                [V]
│   ├── security/                   # CSP / 权限 / folder-trust        [V]
│   └── __tests__/                  # 主进程单元测试                    [V]
├── preload/
│   └── index.ts                    # contextBridge 表面                [V]
└── tsconfig.json                   # 比根 tsconfig 严格(无 DOM)       [V]

packages/<group>/openbuddy-<name>/
├── package.json                    # name: @openbuddy/<name>
├── tsconfig.json
├── src/
│   ├── index.ts                    # apply(ctx: Context) 默认导出
│   ├── service.ts                  # OpenBuddyService 子类
│   ├── types.ts                    # 导出接口
│   └── __tests__/
│       └── service.test.ts
└── README.md                       # 能力专属文档

d6968901 docs: verified 2026-09-05 codebase analysis + README polish + screenshots
b535ba98 feat(MVP-9): defer hydrateMessageQueue state write to microtask
810f6ef9 feat(MVP-8): inject compact-announce user message via sendUserMessage
3450e060 perf(p1-17): wire harness lifecycleRevisions cleanup to host/session-removed + close()
a9d240ff feat(pi-observability): forward session_tree / session_before_fork / provider hooks
bf81f87c feat(MVP-2): part-aware replay for historical sessions
7b38675d perf(p1-12): async batched I/O for collaboration-runtime event log + state files
34f75d3c feat(MVP-3): subagent parent-child indicator in sidebar
69244294 perf(R-ToolStream-1): forward tool execution partial results + fix test regex
81336854 perf(p1-09): debounce projects-store localStorage writes (300ms)

# 1. 核验清单
find packages -mindepth 2 -name "package.json" \
  -not -path "*/node_modules/*" -not -path "*/__fixtures__/*" \
  | wc -l                                       # → 64

# 2. 核验 moon 工程数
ls .moon/workspace.yml electron/moon.yml moon.yml
find packages -mindepth 2 -maxdepth 2 -name "moon.yml" \
  -not -path "*/node_modules/*" \
  | wc -l                                       # → 4(组级别工程)

# 3. 核验测试数
find . -name "*.test.*" -not -path "*/node_modules/*" \
  -not -path "*/dist/*" -not -path "*/out/*" \
  | wc -l                                       # → 455

# 4. 核验打包产物
pnpm electron:dir:mac
ls release/mac-arm64/                            # → OpenBuddy.app

# 5. 核验开发渲染端在 1420 端口
pnpm electron:dev &
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:1420/   # → 200

# 6. 核验 MVP-9 修复
pnpm vitest run src/stores/__tests__/message-queue-store-mvp9.test.ts