用途:为在 Factorial Code 平台上运行的 Python 代码提供编写规范,运行时为 Python 3.13,进程入口文件为 main.py,入口点为 def main()。平台模型(进程、模块、datastore)参见 fcode-core-concepts。
主要能力与用法:参数通过 fcode.context.parameters 读取;环境变量用 os.getenv("X") 或 fcode.env.X;导入模块用 fcode.import_module("module-slug"),名称必须是硬编码字符串字面量,可指定版本标签。数据存储 fcode.datastore 仅存字符串/数字,对象需 json.dumps 后再 set、get 后 json.loads;敏感值可在 set 第三参数传 True 加密。文件用 fcode.storage 上传、下载、列举、删除及生成签名 URL,临时文件写入 os.environ.get("TMP_DATA_DIR")。可读写团队变量 fcode.variables、管理 fcode.schedule 定时任务、通过 fcode.oauth.start 发起第三方 OAuth 授权、用 fcode.send_mail 发送邮件。日志通过 fcode.import_module("fcode-logs") 获取,读取 LOG_LEVEL 团队变量。返回值支持标准消息、自定义 HTTP 状态、transient 及 UI 触发按钮结果。
限制与注意:不要自行调用 main();fcode.import_module() 名称不可用变量;不可别名 fcode.i18n,否则运行时报错;不要硬编码或记录密钥;每次执行日志上限 500 行/500 KB,返回值上限 500 KB;默认每次执行最多发 3 封邮件,本地 fcode run 不发邮件仅记录;fcode.variables.set/delete 仅服务端持久化,同一次运行内不反映到 fcode.env。