Git、Realtime、Tunnel、Telemetry 与 Updater

Git / Workspace

默认共享 cwd；显式 isolate 才创建独立 worktree

spawnAgentCore 在 isRepo 且 isolate=true 时，从当前 branch 创建 `agent/<id>` 分支与 `<harnessHome>/worktrees/<id>`。失败是 best-effort 降级而非硬失败。回收前检查 dirty 与 ahead commits；有未集成工作就保留。

交互图解

Worktree 隔离与保全策略

检查 Git repomainRepoRoot

创建 agent/<id>worktrees/<id>

Agent 执行独立 cwd

退出审计dirty / ahead?

保留或清理fail safe

隔离是 best-effort；清理则偏向保全，脏或领先分支不会被自动删除。

固定源码证据

src/main/git.tsL212-L330

mainRepoRootaddWorktreeremoveWorktreeworktreeHasUnintegratedWorkworktreeIsGcSafe

worktree 生命周期采用 fail-safe 数据保护。

已核验

src/main/index.tsL2631-L2667

addWorktreeworktreePathsworktreeOrigins

spawn 时仅在用户请求且 repo 有效时隔离。

已核验

src/main/index.tsL517-L620

finalizeWorkerWorktreepreservedWorktrees

teardown 会先判断未集成工作再决定 remove 或 preserve。

已核验

Git / GitHub 能力

Git 封装是只读浏览 + 受保护 checkout；GitHub 通过 gh CLI

main/git.ts 封装 status、log、diff、branch、compare、worktree 与 checkout；checkout 在 dirty working tree 时 fail-safe 拒绝。main/github.ts 仅用 gh CLI 读取 issues 和 CI runs，不是完整 PR 协调层。

固定源码证据

src/main/git.tsL59-L209

getStatusgetLoggetDiff

所有 git/fs 访问留在 Main，renderer 只拿结构化文本。

已核验

src/main/git.tsL331-L489

getLogGraphcompareRefslistWorktreescheckoutRef

历史、比较和 checkout 有 rev/path/dirty guard。

已核验

src/main/github.tsL25-L118

listIssueslistCIRuns

GitHub 集成是小型 gh adapter。

已核验

Realtime / Voice / Tunnel

语音 orchestrator 在 Renderer；真实 OpenAI key 留在 Main

Realtime Michael 通过 Main mint 的短期 token 建立 WebRTC session，并使用工具读写 Hive；高风险动作必须语音确认。Slack/Webhook 在 Main 开本地 server，可选 localtunnel/tunnelmole 暴露公网 URL。

固定源码证据

src/renderer/src/realtime/session.tsL1-L40

RealtimeSessionOpenAIRealtimeWebRTC

voice session 明确运行在 renderer，并使用 ephemeral secret。

已核验

src/main/realtime.ts

mintRealtimeToken

Main 用 write-only secret broker mint 短期 token。

已核验

src/main/realtimeActions.tsL100-L170

VERBSSETTING_POLICYPENDING_TTL_MS

动作按 soft/destructive 分层并限定可写设置。

已核验

src/main/slack.ts

SlackServer

Slack request 验签与解析留在 Main。

已核验

src/main/webhook.ts

WebhookServer

Generic webhook 使用 endpoint secret 与本地 server。

已核验

Telemetry / Analytics / Update

本地 OTel 与外发 PostHog 是两套不同数据面

telemetry.ts 是 loopback-only OTLP collector，用于 token/cost/tool 状态和 breaker；analytics.ts 才是匿名 allowlist PostHog，受 build key、DO_NOT_TRACK 与设置三重门控。updater 只在 packaged build 使用 electron-updater，并提供 GitHub release notify fallback。

固定源码证据

src/main/telemetry.tsL1-L30

TelemetryCollectorOTLP

本地 collector 不向外发送 prompt 或内容。

已核验

src/main/analytics.tsL1-L32

AnalyticsEVENTSDO_NOT_TRACK

外发事件由 per-event property allowlist 限制。

已核验

TELEMETRY.mdL1-L107

Privacy contract

隐私契约列明发送内容与三种完全禁用方式。

已核验

src/main/updater.tsL11-L36

initAutoUpdater

更新只在 packaged build 生效，失败降级为 release 页面通知。

已核验

边界审计

为每个集成画五列：入口、认证、权限、数据、撤销

GitHub CLI、Slack loopback、公开 webhook 和 Realtime 会话使用不同信任模型。统一到一个“integration manager”不会消除这些差异。

门禁卡、客服电话和快递口都连接外部，但不能共用一把万能钥匙。

Git、Realtime、Tunnel、Telemetry 与 Updater

默认共享 cwd；显式 isolate 才创建独立 worktree

Worktree 隔离与保全策略

Git 封装是只读浏览 + 受保护 checkout；GitHub 通过 gh CLI

语音 orchestrator 在 Renderer；真实 OpenAI key 留在 Main

本地 OTel 与外发 PostHog 是两套不同数据面

为每个集成画五列：入口、认证、权限、数据、撤销

能用自己的话回答核心问题了吗？