做 EO2Weave 的时候。有个问题困扰了我很久：Agent 的主要循环到底是自己写，还是用现成的？

自己写吧。容易写出 bug，而且 LLM 的各种边界情况比你想象的多得多。 用现成的吧，LangChain JS 太重；Vercel AI SDK 不够灵活；其他框架要么不支持浏览器；要么 API  设计让你觉得自己在写 Java。 >>>最终我选了  这篇聊聊为什么选它还有在浏览器端踩了多少坑。怎么说呢，

: Inline h styles avoided — using native heading below instead.

至于结构概览，层 包名 用途 LLM/API pi-ai多 Provider适配 流式 工具调用跨 Provider切换Agent循环 pi-agent-core工具执行事件流消息队列终�产品 pi-coding-agentCLI界面会话管理主题我只需要中间两层底下两层是 pi 的上面六块是 CreatorWeave 在上面造的轮子下面展开讲。

'— 功能齐全但太重' —> 光 '@langchain/core' 拽进来一堆依赖 浏览器打包体积感人而且 Agent 抽象层太多写工具得继承类实现接口注册到 registry…，写完感觉不是在写 Agent 像是在写 Java。

'— 轻量 React 集成好但设计初衷是对话 UI而非 Agent 工具循环想精细控制工具执行上下文压缩事件流抱歉这些得自己加。

'— 想过但 LLM 边界情况太多OpenAI reasoningcontent 和 Anthropic thinking 是两个字段Cerebras 不认 store 参数Mistral 用 maxtokens而不是 maxcompletiontokens…，这些坑 pi-ai 全踩过了。

最终选 pi-agent-core理由实在：

- 没黑魔法没隐式注入代码读得懂。- pi-ai 本身就支持浏览器运行 CORS 已处理。- 每一步都有事件 messagestart toolexecutionstart toolexecution_end完美适合做 UI。

学到了什么?

1. — pi-coding-agent 用四五个工具撑起全网最火编程 Agent少即是多但浏览场景太复杂总不能让使用者在浏览里开 bash这矛盾吗？不矛盾终端和浏览器是两个世界各有各刚刚够用./li>.

ToolRegistry — 工具注册中心-单例模式运行时动态注册注销内置工具基础MCP WebMCP WASM Plugin Skills按需注入所有输出统一 ToolEnvelopeV2信封格式 ok:true数据 或 ok:false错误前端解析再也不用猜格式。

SubAgent程序:-每个子 Agent都是完整 AgentLoop实例—not scripted puppets 有独立上下文能自主调用工具状态转换 CAS乐观并发控制 SQLite持久化页面刷新任务被标记SESSION_INTERRUPTED可恢复健康检测完成但输出极短且大量调用大概率API中断自动检测提示 resume。话说回来，

ContextManager:-上下文压缩Baseline机制智能截断前面挑战四里讲三层防御统一调度。

Prompt提高:-IntelligenceCoordinator负责注入人格记忆项目上下文Prompt分STABLE和DYNAMIC两层最大化利用LLM Prompt Cache省钱省时间

• 終於終於終於終於終於终于终于最终本质靠约束和取舍各司其职./li>/ul>