SuperAPI AI 工具集

cap-plugins

通用与其它

查看项目

更新于 10-16 09:47

技能介绍

用途:帮助在 SAP CAP 项目中添加官方(first-party)插件,并遵循一致的安装方式与最佳实践。主参考:https://cap.cloud.sap/docs/plugins/。

统一安装:所有官方插件均通过 npm install @cap-js/<plugin-name> 安装,由 CAP 插件机制自动激活,无需在 cds.requires 中配置条目。

主要插件与能力:

  • 变更跟踪 @cap-js/change-tracking:用 @changelog 注解记录字段级变更,支持关联字段;实体新增 Changes composition,需在服务中暴露。v2 改为数据库原生触发器,批量操作最高约 50 倍性能提升,有破坏性模式变更,升级需数据库迁移。
  • 审计日志 @cap-js/audit-logging:用 @PersonalData 注解标记敏感数据,生产环境绑定 SAP Audit Log Service,开发环境可 kind: audit-log-to-console。
  • 附件 @cap-js/attachments:支持数据库或对象存储(AWS S3、Azure Blob、GCS)存储;kind: standard 可自动识别超大规模云;mta.yaml 需绑定 objectstore;含恶意软件扫描,超过 400 MB 显示扫描失败。
  • 通知 @cap-js/notifications:向 Launchpad / Work Zone 发送 BTP 通知。
  • 遥测 @cap-js/telemetry:自动激活,导出 traces、metrics、logs 到 OpenTelemetry 兼容后端(Dynatrace、Cloud Logging、Jaeger)。
  • GraphQL @cap-js/graphql:以 @graphql 暴露服务,访问路径如 /graphql。
  • WebSocket @cap-js-community/websocket:以 @protocol: 'websocket' 提供实时事件。
  • 数据检查 @cap-js/data-inspector:提供查询执行分析与数据库检查 UI。
  • 数据隐私 @cap-js/data-privacy(Beta):集成 SAP DPI,自动暴露数据主体请求与删除工作流端点。
  • AI @cap-js/ai:为 @Common.ValueList 注解字段提供 UI 字段推荐,并集成 SAP AI Core。
  • MCP @cap-js/mcp:将 CAP 服务作为 MCP 端点暴露给 AI 智能体,用 @mcp 注解服务,自动生成 describe、query、call_action 工具;注意它与开发工具 @sap/cds-mcp 不同。
  • 打印 @cap-js/print、SDM @cap-js/sdm、事件代理 @cap-js/event-broker 等。

常见误区:不要为自动激活插件添加 cds.requires;不要使用已弃用的 @attachments.disable_facet;多租户应用启用对象存储需按租户绑定;生产环境不要用 audit-log-to-console;记得在 mta.yaml 绑定 BTP 服务;kind: standard 可自动识别,不必硬编码 kind: s3。