SuperAPI AI 工具集

init-config-file

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:作为 ***plain 项目中 config.yaml 的唯一权威写入者,把 forge-plain 第三阶段已锁定的决策(单元测试、一致性测试、prepare-environment、模板、构建目录等)落成配置文件,供 codeplain 渲染器读取。渲染器把这些键读入与 CLI 标志相同的 argparse 命名空间,因此配置值与命令行 --flag 等价。

运行时机:forge-plain 第三阶段结束、第四阶段开始(测试脚本决策全部确定后,再委派给 plain-healthcheck);add-feature 第三阶段触及测试面时;实现单元测试、一致性测试、prepare-environment 脚本或新增模板、导入模块之后;用户要求重建配置、查询有效键或发现配置被手改、不一致时。若仅修改 .plain 内拼写且测试面未变,无需重跑。

主要能力:确定项目需要几份 config.yaml(每个拥有独立测试脚本的部件一份,如 backend/config.yaml、frontend/config.yaml;单栈项目仅根目录一份);从项目当前状态收集已决定值;按规范键名、字母分组、仅输出实际使用的键,写出一致的 YAML;用渲染器相同的查找规则(绝对路径→相对配置文件目录→相对渲染器目录)校验各 *-script 路径是否存在于磁盘。

常用键:unittests-script 必填;conformance-tests-script 在用户选择一致性测试时加入;prepare-environment-script 仅当同时设置 conformance-tests-script 时才可用(否则 plain-healthcheck 会硬失败);template-dir 用于导入模块或自定义模板目录;logging-config-path 指向 dictConfig 用的 YAML;build-dest 固定写 dist,build-folder 默认 plain_modules 且必须与 build-dest 不同;还有 test-script-timeout、conformance-tests-folder、base-folder,以及 copy-build、copy-conformance-tests、conformance-tests-dest、log-to-file、log-file-name、render-machine-graph、headless、api 等按需项。键名用连字符形式;除 template_dir/template-dir 外不接受下划线。

限制:不生成测试脚本,不决定是否要一致性测试或 copy-build 等(属 forge-plain 第三阶段),不为未决策的键编造值,缺失即省略并回退默认值。绝不写入 api-key(应放 CODEPLAIN_API_KEY 环境变量),也不写入 dry-run、full-plain、render-range、render-from、replay-with、config-name、filename 等按次调用或内部标志。日志级别只由 logging-config-path 指向的文件控制,log-to-file/log-file-name 只决定是否与在哪写日志;该日志文件不被 plain-healthcheck 校验。文件内不放注释,重跑应产生字节级一致结果。