（3003期）Supernal Interface – 装饰器驱动的AI可控框架

装饰器驱动的AI可控框架 基于装饰器的AI可控框架，让应用函数自动暴露为LLM可调用的工具，支持CopilotKit集成与类型安全调用。 使用说明 核心功能 Supernal Interface 是一款面向开发者的 AI 可控性框架，通过 TypeScript 装饰器模式将应用函数自动暴露为 LLM 可调用的工具。核心设计哲学是"装饰即接口"——仅需 @Tool 装饰器即可让 AI 发现并调用应用功能，无需手写工具描述或 JSON Schema。 显著优点 零样板集成：autoRegisterTools 与 autoRegisterReadables 实现全自动工具发现，减少 80% 集成代码量 类型安全保证：基于 TypeScript 装饰器实现编译期类型检查，AI 调用参数与返回值全程受控 CopilotKit 原生支持：官方适配器深度集成 CopilotKit，支持 React 生态一键接入 企业级扩展：提供测试自动生成（Gherkin 解析）、Story 系统性能优化（50-80% 提升）、多模型路由、审计日志等高级功能 存储抽象层：内置 StateManager 与 LocalStorageAdapter，支持会话状态持久化 潜在局限 框架耦合风险：@supernal/interface 为私有命名空间，实际未在 npm 公开验证，存在供应链可信度疑问 企业功能闭源：核心性能优化与合规功能需商业授权，开源版本能力边界不明确 React 生态依赖：Hooks 与组件装饰器设计深度绑定 React，Vue/Svelte 等框架支持待验证 装饰器语法争议：TC39 装饰器提案仍处于 Stage 3，Babel/TypeScript 版本差异可能引发兼容性风险 适合人群 构建 AI 原生应用（AI-native apps）的前端/全栈开发者 已有 React 技术栈、计划集成 CopilotKit 的团队 需要快速将现有 CRUD 应用升级为 LLM 可控的企业开发团队 常规风险 供应链安全：@supernal/interface 包体未经验证下载量，建议锁定版本并审计 lockfile 数据隐私：autoRegisterReadables 可能意外暴露敏感状态，需显式配置可读作用域 提示注入：AI 调用的函数仍需独立校验输入，装饰器本身不提供运行时沙箱 原始说明 Universal AI Interface framework for making applications AI-controllable. Use when adding AI tool decorators, setting up chat adapters, creating AI-callable functions, or integrating CopilotKit.