llm-to-agent/docs/features/extensions.md

扩展、Hooks 与 Profile

静态扩展装配

实现阶段：P1

• Runtime Host 通过明确的 composition root 装配首批 Adapter 和 Behavior。
• P2 在同一机制中加入 Tool 与基础 Hook，不使用动态扫描或 manifest。
• 扩展只能通过 Microkernel 公共接口注册，不能反向依赖 Host 内部实现。

基础 Hook Pipeline

实现阶段：P2

• 围绕 Tool 调用和 Run 完成提供少量稳定 Hook 点。
• Hook 与 Run Event 分离：Hook 执行附加逻辑，Event 记录已经发生的事实。
• Hook 失败不会悄然破坏主流程，执行结果进入 Run 日志。

Hook 管理与诊断

实现阶段：P4

• 支持 Hook 顺序、启停、异常隔离、耗时和调用链查看。
• 明确哪些 Hook 只观察、哪些可以拒绝或结构化修改调用。
• 为日志、摘要、确认、通知和评估提供稳定接缝。

本地扩展加载

实现阶段：P4

• 加载本地 Tool、Adapter、Hook 和 Behavior，并校验声明与依赖。
• 支持安装、启用、禁用、重新加载和错误回退。
• 内置模块与外部扩展使用相同的运行接缝，但 Application Runtime 领域不插件化。

Profile 组合

实现阶段：P4

• 声明每种 Space 默认使用的 Behavior、Tools、Hooks、模型和上下文策略。
• 支持全局默认、Project/Task/System Evolution Profile 和 Space 级覆盖。
• 运行前得到确定的能力集合，并能向用户解释最终配置来源。

扩展开发与版本管理

实现阶段：P4

• 提供扩展模板、测试工具、调试输出和兼容性检查。
• 将扩展变更纳入 System Evolution 的候选、测试和回退流程。
• 当内部模块真实长大后，支持从目录提升为独立 package，而不要求一开始拆包。

Behavior 与 Skill 能力包

实现阶段：P5

• 将可复用的 Agent 角色、提示词、上下文策略和工作方法封装成能力包。
• 支持 Behavior 组合、参数化和按 Profile 选择。
• Skill 复用现有 Tool 和 Run 机制，不建立绕过 Microkernel 的第二套执行系统。

扩展分发

实现阶段：P8

• 支持本地扩展打包、来源记录、版本锁定、更新和卸载。
• 对不兼容或启动失败的扩展提供隔离和回退。
• 分发机制服务个人设备与自举，不以建设公共插件市场为前提。