SuperAPI AI 工具集

alef-generated-bindings

编程与开发

查看项目

更新于 10-16 07:18

技能介绍

用途:本页说明由 Alef 管理的生成式绑定(generated bindings)的维护流程。packages/*/ 与 binding crates 中的文件均由 Alef 生成,不应手动编辑。

主要能力与用法:编辑 packages/*/ 或 binding crate 前先查看 alef.toml;随后修改 Rust 源文件或 alef.toml 本身;运行 task alef:generate 重新生成全部 Alef 管理的输出,且不格式化(即 alef all --clean --format=false);如需 Alef 生成后格式化,显式运行 task alef:format;用 task e2e:test 或 task e2e:all 验证;将 Rust 源文件、alef.toml 与重新生成的绑定一并原子提交。

重命名映射(来自 alef.toml):Go 中 DocumentExtractor 重命名为 Extractor;其他语言无重命名。

新鲜度检查:task alef:generate && git diff --exit-code packages/ crates/xberg-node/ crates/xberg-wasm/ crates/xberg-ffi/。

alef.toml 关键区段:[crate] 指定解析类型与函数提取的 Rust 源文件;[languages.*] 配置各语言输出路径、模块名与重命名映射;[e2e] 配置端到端测试生成,包括 fixtures 目录、输出目录与各语言调用覆盖;[readme] 按语言包生成 README 模板。

e2e 规范任务为 task e2e:generate、task e2e:build、task e2e:test、task e2e:all,不要新增旧式别名。

限制:具体依赖版本、支持语言清单、CI 配置与故障排查步骤暂未提供。