用途:按项目自身的代码风格设置重新格式化源代码,使改动符合项目既有风格。
两条路径:IDE 运行时,使用 IntelliJ 自带格式化器,保真度最高,并保持 IDE 的 VFS/PSI 缓存一致;IDE 不可达时,回退到项目自身的外部格式化器(Spotless / google-java-format / palantir-java-format),在控制台运行。
选择路径:先探测,再加载对应参考文件。调用 steroid_list_projects(若工具 schema 未加载,用 ToolSearch("steroid list projects execute code"))。返回当前仓库则走 IDE 路径:记下该项的 project_name(不透明路由键,而非可读名称),并参照 references/ide.md;其配方已知道 project_name,无需重复探测。调用失败或仓库未列出则走 CLI 回退路径,参照 references/fallback.md(检测 Spotless / java-format 并在控制台运行),并事先告知用户因 IDE 不可达而使用外部格式化器回退。
限制:块级/行范围格式化(IDE 配方 2)仅限 IDE,没有可靠的 CLI 等价实现。如果用户要求块格式化且 IDE 不可达,应如实说明,而非静默地重排整个文件。
结果报告:两条路径结束方式相同,运行 git diff --stat <paths> 并报告实际改动。若格式化未产生任何 diff,这也是有效结果,表示文件已符合风格,应如实说明,而不是暗示做了工作。