先选择最接近用户任务的扩展点，再在 activate(ctx) 中注册。一个插件可以组合多个扩展点，但每项都应有明确用途和独立权限。
UI 与页面
全局或局部插槽在宿主预留位置增加操作或状态。
页面与导航提供需要完整工作区的功能。
设置项让用户配置插件行为，避免把可变值写死。
组件应使用宿主共享的 React 和设计令牌。注册函数返回清理句柄时，在停用阶段释放，避免重载后重复注册。
文件与消息
文件预览为特定扩展名或内容提供查看器。
消息卡片把插件或工具结果渲染为可操作的会话内容。
输入区操作为清晰、频繁的命令增加入口。
文件解析和 UI 渲染应分离，解析失败时返回可理解的错误状态，不要让单个文件使整个会话视图崩溃。
Agent 能力
工具注册提供有固定输入输出契约的动作。
系统提示与技能补充领域规则和工作流程。
工具策略与继续执行控制工具可用性或任务推进。
工具输入使用 SDK 提供的结构化 schema，并把外部 I/O 错误映射为稳定结果。需要宿主文件、网络或模型能力时，先在清单中声明最小权限。
App Action
App Action 让插件通过宿主动作系统暴露可发现命令，适合导航、打开面板或执行确定性操作。