llm-to-agent/docs/features/extensions.md
2026-08-21 16:33:23 +08:00

66 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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