TurnkeyAI

本项目的目标，是构建一套本地优先、可扩展、可审计的协作式 Agent Runtime。

它不是单一的聊天应用，也不是单一的 browser automation demo。它更像一个逐步成型的本地 Agent Workbench：支持 Team、Role、Worker、Browser Runtime、Prompt/Context 管理，以及后续的桌面端壳层。

当前状态

当前仓库已经进入“核心机制第一版落地”阶段，不再是纯设计稿。

已经具备：

• 本地 daemon + TUI 调试入口
• Team / Flow / Role Run 基础运行时
• 多模型 adapter 抽象
• Browser session / target / artifact / ref 的基础持久化
• Browser Runtime v2 的 session/target 控制面
• Worker spawn / send / resume / interrupt / cancel
• browser / explore / finance 三类 worker
• 受控并行的 sub-session / worker fan-out 基础能力
• Prompt assembly / context budgeting / summary / scratchpad 第一版
• layered thread memory / journal / scratchpad / summary 持久化边界
• Scheduled task runtime 与 re-entry capsule 第一版
• structured continuation context 与 role-level continuity 第一版
• QC / replay / API diagnosis 第一版

还没有具备：

• 通用 subagent runtime v2
• 产品级的并行 sub-agent orchestration 与 merge/synthesis 控制
• 稳定的 context / memory / compression v2
• 产品级长期 browser runtime
• 完整的 replay / evaluation harness
• Electron GUI

一句话判断：

• 核心执行内核：已经跑起来
• 产品级协作桌面：还没到

当前优先级

现在最重要的不是继续堆单点业务链，也不是立刻把所有理想 kernel 一次做完，而是先把系统优化到能稳定支撑真实日常任务。

接下来的优先级明确分成两期：

Phase 1: Production Hardening

1. prompt / memory / compaction 稳定化
2. sub-session / continue / re-entry / timeout summarize
3. 并行 sub-agent orchestration / fan-out / merge-synthesis 稳定化
4. tool registry / permission / audit / transport hierarchy
5. browser session / target / ownership / reconnect
6. replay / failure analysis 第一层产品化

Phase 2: Runtime Kernel Lift

1. durable execution journal / worker envelope
2. context compiler / memory hierarchy / cache taxonomy
3. tool policy kernel
4. typed delegation / work package / merge gate
5. 更完整的 replay / eval / trace

先把第一期这些生产优化主线做稳，再推进第二期的 kernel 化，成本会低很多。

当前状态：

• Batch 1 已完成
• 当前主线切换到 Batch 2：并行 orchestration、tool governance、browser ownership/reconnect

快速开始

npm install
npm run typecheck
npm test

启动本地 daemon：

npm run daemon

启动 TUI：

npm run tui

当前 daemon 主要提供：

• thread / message / flow 调试接口
• browser session / target 控制接口
• scheduled task 调试接口
• capability discovery 查询接口

仓库结构

主要 package：

• packages/core-types: shared contracts
• packages/team-store: file-backed stores
• packages/team-runtime: team / flow / scheduling runtime
• packages/role-runtime: prompt policy / context assembly / role execution
• packages/worker-runtime: worker registry / worker handlers
• packages/browser-bridge: browser session / target / bridge runtime
• packages/llm-adapter: multi-provider model adapters
• packages/qc-runtime: verification / diagnosis / replay helpers
• packages/app-gateway: local daemon entry
• packages/tui: terminal debug client

文档入口

• Vision
• Milestones
• Roadmap
• Production Hardening Checklist
• Runtime Core v2 Plan
• Project Foundation
• Browser Session And Worker Protocol
• Prompt Context Compression Design

当前里程碑判断

如果把目标定义为“本地可跑的多角色 runtime 骨架”，当前大致在：

• 85%

如果把目标定义为“可日常使用的协作式 agent 桌面工作台”，当前大致在：

• 40%

差距主要集中在：

• bounded 真实任务的稳定性与续跑体验
• 长任务 context / memory / compression
• 长期 browser session 稳定性
• tool governance / replay 产品化
• GUI

开源阶段说明

当前项目仍处于内核快速演进阶段。

这意味着：

• 对外接口还会继续收敛
• 存储 schema 还会继续打磨
• 重点优先放在 runtime 稳定性，而不是 UI 完整度

如果你现在阅读这个仓库，最适合把它理解成：

• 一个正在成型的本地 Agent Runtime
• 而不是一个已经完整打磨好的桌面产品