Pi 为核心，
能力随需而至。
终端与本地 Web 工作台、独立上下文的子代理、Workflow 与后台任务，装进同一个 Pi。普通对话不常驻任何 OpenPI 工具——不用时，依然是 Pi。
复杂度只在值得的时候出现。
普通编码任务继续走 Pi 原生路径：read、bash、edit、write，完整历史与会话压缩。 任务一旦需要长期进程、并行调研、隔离实现或跨回合推进，高级能力仍然完整存在—— 直接说出需求，OpenPI 就在当轮加载对应能力。轻路径不缴复杂度税，重任务不缺工程能力。
轻路径不缴复杂度税，
重任务不缺工程能力。
Pi 原生，始终存在本轮加载资源真实存在后才出现只讨论「子代理是什么」不会加载；否定与条件句保持 fail closed。想让模型自己判断，可在 /openpi-setup 开启 adaptive——只常驻一个小型 openpi_load_tools 网关。
一个工作台，
而不是一组互不协调的插件。
开发服务器、监听任务、长测试放进后台。独立日志、超时与完成通知；bg_kill 终止整个进程树，会话结束时有界清理。
每个子代理是独立的进程内 Pi 会话，默认继承 Provider 与模型；可 check、wait、cancel，也能继续对话。并行写入用独立 worktree，自定义角色的显式工具列表由运行时强制。
pipeline / parallel、结构化输出、结果交接、调用账本与安全重放。一次调用是可审计的生命周期，而不是「进程退出 0」。
看得见，才停得住。
终端里，状态压进一行，工具结果折叠成语义摘要；需要看清多个项目的对话与工具轨迹时，输入 /web 打开本机 Web 工作台。两边使用同一套能力，会话彼此独立。
Ctrl+O 随时展开完整证据。→ 只填入不提交。默认关闭，写入会话之外。~/.pi/agent/agents/*.md 或项目 .pi/agents/*.md 覆盖内置角色，可指定独立模型与推理档位。/openpi-setup 调整。openpi web /path/to/repo 单独启动。fd、rg、git_show / git_diff / git_log 以结构化参数调用，不拼接 Shell，输出有界。Pi 始终拥有主会话。
终端、子代理与工作流是三条执行路径；工作项、目标与上下文切换保持连续性；状态栏、仪表盘与清理逻辑负责观察和控制。增强 Pi 的深度，不扩大隐式权限。
把一次调用，拆成
可以审计的生命周期。
结果交接与派生图谱
成功调用返回不透明引用 ref，后续调用通过 inputs 显式接收上游结论，并标记为不可信数据。产物从引用派生只读图谱，可观察血缘，不参与调度。
调用账本
每次 agent() 独立记录意图、准入与执行状态。崩溃后未终结的调用恢复为 uncertain——不猜成成功、失败或安全重试。
安全重放
resume_from_run_id 只重放可证明只读且指纹未变的调用。指纹覆盖提示词、结构、模型、仓库状态与信任决策；不确定就真实执行。
Worktree 交接
清理隔离 checkout 前，原子保存 patch、分支 / HEAD、未跟踪文件清单与清理回执。状态不明就保留现场，不自动 merge、apply 或强删。