SuperAPI AI 工具集

writing-scripts

写作与研究

查看项目

更新于 10-16 09:51

技能介绍

用途:在 Celigo 数据管道中编写 JavaScript 脚本。脚本用于处理表达式、过滤器和可视化映射无法完成的逻辑,例如复杂条件、跨记录计算、管道内 API 调用和自定义路由。

主要钩子点:数据管道侧有 preSavePage(导出抓取后)、preMap(映射前)、postMap(映射后提交前)、postSubmit(提交后)、postAggregate(文件聚合后);记录级处理器有 filter、input_filter、transform;流程级有 postResponseMap;路由与处理器有 branching、handleRequest、contentBasedFlowRouter。各钩子对输入与返回值有严格契约,批量钩子通常要求返回数组且长度与输入一致,逐条错误应通过返回 { errors: [...] } 表达而非抛出异常。

可用模块:脚本可导入 integrator-api(调用 Celigo API)、dayjs(日期时间处理)、sjcl(哈希与加密)。一个脚本资源可包含多个导出函数,分别绑定到不同钩子。

使用方式:先确定目标对应的钩子点,检查是否可用表达式替代;再查看账号已有脚本,创建脚本资源(至少包含 name 与 content 字段),将脚本绑定到导出、导入或流程相应位置,最后测试迭代。绑定方式因钩子而异,部分为增量式附加,部分为替换式。

CLI:提供 celigo scripts list/get/create/update/set/delete,以及 enable-debug、disable-debug、debug-logs 等调试命令,可启用限时调试窗口、按流程或时间过滤日志。

限制:filter、input_filter、transform、branching 为可切换槽位,同一时刻只能保存声明式规则或脚本,二者互斥;postSubmit、postResponseMap、postAggregate、contentBasedFlowRouter、handleRequest 没有声明式等价物,只能使用脚本。脚本逻辑依赖运行时数据形状,需基于样本数据编写与验证。更新脚本时若省略 content 会清空代码,应先 GET 再修改后 PUT。具体收费与平台限制信息暂未提供。