核心功能
Supernal Interface 是一款面向开发者的 AI 可控性框架，通过 TypeScript 装饰器模式将应用函数自动暴露为 LLM 可调用的工具。核心设计哲学是"装饰即接口"——仅需 @Tool 装饰器即可让 AI 发现并调用应用功能，无需手写工具描述或 JSON Schema。
显著优点
1. 零样板集成：autoRegisterTools 与 autoRegisterReadables 实现全自动工具发现，减少 80% 集成代码量
2. 类型安全保证：基于 TypeScript 装饰器实现编译期类型检查，AI 调用参数与返回值全程受控
3. CopilotKit 原生支持：官方适配器深度集成 CopilotKit，支持 React 生态一键接入
4. 企业级扩展：提供测试自动生成（Gherkin 解析）、Story 系统性能优化（50-80% 提升）、多模型路由、审计日志等高级功能
5. 存储抽象层：内置 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 调用的函数仍需独立校验输入，装饰器本身不提供运行时沙箱