用途:为 Domo 应用调用 Code Engine 函数提供契约优先的集成规则,避免依赖旧式 endpoint-first 写法。
主要能力:推荐直接使用 domo.post('/domo/codeengine/v2/packages/{alias}', params) 调用函数;要求 manifest 使用 packagesMapping(注意带 s),并为 parameters 与 output 填写完整契约字段,包括 name、displayName、type、value、nullable、isList、children、entitySubType、alias。
使用方式:先安装依赖 npm install ryuu.js,再 import domo from 'ryuu.js',然后以 await domo.post(...) 发起调用。首次集成需 console.log 响应并判断真实结构,解析时兼容 response.body、response.data 或原始 response,并处理 output、result、value 或直接返回体,按 number、string、object 分别处理,无法解析时抛出错误。调用需用 try/catch 捕获并向上抛出或记录日志。生成或推荐调用时,必须明确告知用户输入参数名称、类型、nullable 期望,以及输出名称、类型与形态。
适用场景:Domo App Platform 中需要从应用调用 Code Engine 函数的集成与开发。
限制:资料未提供 Code Engine 的具体收费、平台范围、性能或效果信息;旧 endpoint-first 指引已归档到 archive/legacy-rules/domo-code-engine.md。相关规则参考 .cursor/rules/04-toolkit.mdc、06-manifest.mdc、09-gotchas.mdc。