SuperAPI AI 工具集

fcode-javascript

通用与其它

查看项目

更新于 10-15 21:40

技能介绍

用途:为在 Factorial Code 上运行的进程与模块编写 JavaScript 提供规范。运行时为 Node.js v22,进程入口文件为 index.js,入口点为 async function main(),必须导出 module.exports = { main },且不要自行调用 main()。

主要能力:通过 fcode.context.parameters 读取参数,用 process.env.X 或 fcode.env.X 读取变量;用 fcode.import("module-slug") 导入模块,名称必须是硬编码字符串字面量,可指定版本标签。fcode.i18n 不可别名调用,否则运行时报 i18n is disabled。数据存储仅支持字符串和数字,对象需 JSON.stringify 后写入、读取后解析;set 第三个参数传 true 可加密存储,get 自动解密。文件用 fcode.storage 上传、列出、下载、生成签名 URL 和删除,临时文件写入 process.env.TMP_DATA_DIR。

用法要点:日志通过 fcode.import("fcode-logs") 获取,级别由 LOG_LEVEL 控制,每次执行最多 500 行或 500 KB。外部 npm 包自动安装,名称不一致时用 @add-package 声明。可在运行时读写团队变量、管理进程定时任务(cron 或一次性 dateTime),并用 fcode.oauth.start 发起第三方 OAuth,回调进程接收 code、codeVerifier、redirectUri 等。内置 fcode.sendMail 无需 SMTP,默认每次执行最多发 3 封,本地运行只记录不发送。返回值上限 500 KB,可返回标准消息、自定义 HTTP 状态、transient 数据或 UI 触发结果。

限制:不得硬编码或记录密钥;异步操作使用 async/await,用 const/let;变量 set/delete 仅服务端持久化,同一次运行内 fcode.env 不更新;继承变量需覆盖而非删除。资料未提供收费、价格与平台支持范围等信息。