← 整体架构解析

核心插件深度解析

每个核心包的独立页面:源码级深度解析(file:line 引用 + 机制拆解)+ 自定制插件完整清单。 先读整体架构,再按需进入各包。

7 个核心包 · 每页含"定制插件需要完成哪些事情"
◆ 阅读顺序建议 — 按依赖方向:先 scope(地基,纯库)与 session(唯一真相), 再 system-promptllm(词汇),然后 tools(执行), 最后 agent(接口)→ agent-loop(循环实现,harness 中唯一含具体循环逻辑的包)。
packages/core/session
事件溯源会话日志:append-only SessionEvent、内存存储、从日志投影派生模型历史。持久化是插件关注点。
ctx.sessions3300 行Service 包
packages/core/tools
工具注册表 + 守卫执行管线(pre→execute→post 瀑布)、schema DSL/JSON Schema 子集、Code Mode、UI 渲染意图。
ctx.tools5800 行Service 包
packages/core/agent
Agent 接口、活体注册表、agent/* 事件词汇、工厂委托、进程内 initiator scope。零循环依赖
ctx.agents1757 行Service 包
packages/core/agent-loop
唯一的具体循环实现:ReactLoopAgent 驱动 turn/step 生命周期、请求装配、并行工具调度与模型序提交。
ctx.agentLoop1777 行Service 包
packages/core/system-prompt
提示词组装注册表:section/context/tool schema/变量,每 step 重建一次;scoped persona shadow 全局默认。
ctx.systemPrompt695 行Service 包
packages/core/scope
作用域注册原语:createScope / scopeTarget / ScopedLayers。可见性与生命周期同一来源;shadowing 在 store 层。
无 ctx key(纯库)598 行函数库
packages/llm/llm
Provider 中立的 LLM 词汇与抽象服务:适配器注册表(all-or-nothing 原子替换)、流式调用 API、失败归一、归属头。
ctx.llm2726 行Service 包
◆ 每页统一结构 — 01 包定位与入口(name/inject/Config)→ 02 核心接口(真实签名)→ 03 事件 → 04 关键机制深度解析(file:line + 代码) → 05 自定制插件指南(实现什么、注册什么、监听什么、测试要求)→ 06 关键陷阱与约定。