SuperAPI AI 工具集

make-app-service

编程与开发

查看项目

更新于 10-15 21:39

技能介绍

用途:处理 Make App Service API 相关工作,包括 apps/ui 与 apps/service 之间的 Service API 契约、薄层 Make Data API 编排、Service 路由形态、Make 适配器运行时配置语义、Make 响应直通透传、Service 侧校验、边界日志与 Service API 测试。

主要能力与范围:定义 schema、records、candidates、lookup options、文件代理及薄层自定义编排等 Service 自有 API;可记录路由名、query/body 形态、响应封装与适配器行为;可定义 Service 侧 Make 适配器配置语义与环境变量名,如 MAKE_APP_KEY、MAKE_API_BASE_URL。

使用方式:先检查 apps/docs/api.md、apps/service/src、config.ts(或宿主等价配置入口)、现有测试与宿主声明的数据流。任何 Service 路由或响应形态变更前或同时更新 apps/docs/api.md。按默认分层源码树组织:app.ts、server.ts、config.ts、logger.ts、make-client/、services/、utils/,测试与所覆盖的路由/适配器/辅助函数同目录。路由处理器保持精简,仅做输入校验、调用 service/adapter、映射 Service 自有预检错误、记录安全边界上下文并返回文档化响应。普通 Make 直连代理保留已完成的 2xx/4xx/5xx 状态、Content-Type 与 body;仅当 apps/docs/api.md 明确标注为非代理时,聚合/规范化路由才可定义自己的成功结果。

适用场景:Make App Service API 的生成、重构、评审与调试;路由设计;契约文档维护;适配器与日志分层;契约测试补充。

限制:不负责 record-action 行为(make-app-actions)、排序(make-app-sort)、过滤(make-app-filter)、分组(make-app-group)、Make AI 助手传输语义(make-ai-assistant)、UI 布局(makeui)、认证实现(make-app-auth)、单应用权限逻辑(make-app-permission)、运行时构建/启动契约(make-app-runtime)、DSL 建模(makedsl)、Make CLI 执行(makecli)及 CanvasTable 渲染/编辑(canvas-table-integration)。不硬编码环境到域名映射。已发布/运行时 Service 不得用 makecli 作数据源。资料未提供具体收费、价格与平台信息。