erf-build 是 1С 外部报表(ERF)的构建技能:把 XML 源代码编译成 ERF 文件,底层复用 epf-build 的通用脚本。
用途与用法:命令为 /erf-build <ReportName> [SrcDir] [OutDir]。ReportName 必填,指根 XML 名称;SrcDir 默认 src;OutDir 默认 build。连接参数从项目根目录 .v8-project.json 读取 v8path 并解析数据库:用户直接给出路径或服务器时直接用;按名称给出时按 id/alias/name 查找;未给出时把当前 Git 分支与 databases[].branches 匹配,无匹配则用 default;无该文件或无数据库时在 ./base 创建空信息库。v8path 未设置时自动搜索:Get-ChildItem "C:\Program Files\1cv8*\bin\1cv8.exe" | Sort -Desc | Select -First 1。使用后若数据库未注册,会建议通过 /db-list add 添加。
实际执行调用 epf-build 的脚本:powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 <参数>。脚本参数包括 -V8Path、-InfoBasePath,或 -InfoBaseServer 加 -InfoBaseRef(二者必选其一),可选 -UserName、-Password,以及必填的 -SourceFile 与 -OutputFile。
返回码:0 表示成功,1 表示出错(见日志)。
限制:若报表使用引用类型(CatalogRef.XXX、DocumentRef.XXX),在空库中构建会因 XDTO 报错,需先用 /db-list add 注册带目标配置的数据库。