Scramble项目v0.12.0-alpha.1版本发布：API文档生成工具的重大更新

Scramble是一个用于自动生成API文档的PHP工具，它能够通过分析代码注释和类型信息自动生成OpenAPI规范的文档。这个工具特别适合Laravel开发者，能够显著减少手动维护API文档的工作量。最新发布的v0.12.0-alpha.1版本带来了多项重要改进，使API文档生成更加灵活和强大。

端点分组与排序功能增强

新版本引入了#[Group]属性，允许开发者显式地对API端点进行分组和排序。这个改进解决了之前版本中端点排序可能不够直观的问题。现在，开发者可以：

1. 使用#[Group]属性为API端点指定所属分组
2. 通过属性参数控制分组内的排序顺序
3. 默认情况下，端点将按照它们在代码中声明的顺序排列

这一特性特别适合大型项目，其中API端点数量众多，需要更精细的组织结构。开发者现在可以按照业务逻辑或功能模块对API进行分组，使生成的文档更加清晰易读。

显式命名类基础Schema

新版本增加了#[SchemaName]属性，允许开发者显式地为基于类的Schema指定名称。这个改进解决了以下问题：

1. 自动生成的Schema名称可能不够直观或不符合团队命名规范
2. 在不同地方使用相同类时可能导致Schema名称冲突
3. 需要更精确控制文档中展示的Schema名称

通过使用#[SchemaName]属性，开发者可以确保生成的文档中使用一致且符合业务术语的Schema名称，提高文档的可读性和一致性。

请求参数手动注解支持

v0.12.0-alpha.1版本增强了请求参数的处理能力，新增了对手动注解的支持。开发者现在可以：

1. 使用属性明确标注请求参数的类型、描述和验证规则
2. 覆盖自动推断的参数信息
3. 为复杂参数提供更详细的文档说明

这一特性特别适用于参数类型复杂或需要额外说明的API端点，确保生成的文档准确反映API的实际行为。

类型系统改进

新版本对类型系统进行了多项增强：

1. 添加了对self::*类型引用的支持，能够正确处理类内部常量定义的类型
2. 改进了从数组值创建类型的能力，可以更准确地推断数组元素的类型
3. 优化了类名处理逻辑，避免了Schema重复的问题

这些改进使得类型推断更加准确，减少了需要手动干预的情况，同时生成的文档也更加精确。

总结

Scramble v0.12.0-alpha.1版本通过引入新的属性和改进类型系统，显著提升了API文档生成的灵活性和准确性。这些改进使开发者能够：

1. 更精细地控制API文档的组织结构
2. 确保Schema命名的一致性和可读性
3. 为复杂参数提供更精确的文档
4. 减少类型推断不准确导致的文档问题

对于正在使用或考虑使用Scramble的项目，这个版本提供了更强大的工具来创建和维护高质量的API文档。虽然目前是预发布版本，但这些改进已经显示出Scramble在API文档生成领域的持续进步和创新能力。