版本更新

重构与优化

节头注释识别与缩进系统全面优化

• 新增 sectionCommentPrefixes 集合，统一管理节头注释前缀，提升节头识别的一致性与可扩展性。
• 实现 isSectionLeadingComment 方法，精准判断行是否为节头注释，避免误判普通注释或文本内容。
• 引入 stackWithoutTrailingSections 辅助函数，在缩进计算时自动移除尾部节头标记，确保深度信息更贴合真实语义结构。
• 调整缩进计算流程：对节头注释行采用“修正后栈深度”替代原始嵌套深度，避免节头注释出现多余缩进。
• 明确节头注释与其对应代码块在视觉层级上的对齐策略，使整体结构更符合阅读预期并减少层级跳跃感。

新增功能

节头注释与代码块的智能缩进对齐

• 针对节头注释引入独立的缩进规则，使其自动与对应代码节头对齐。
• 通过栈深度修正机制确保节头注释不会被当作普通语句导致过度缩进。
• 支持批量连续节头注释的识别与对齐，确保文档结构保持一致性与清晰度。
• 引入安全降级策略，在复杂缩进结构中仍能保证基本对齐正确。

行为改进

整体缩进体系的鲁棒性提升

• 优化栈深度变动流程，减少因节头标记产生的深度误差。
• 通过程序化过滤无效节头与伪前缀，确保识别逻辑更稳定可靠。
• 提升边界条件处理能力，包括文件首行节头、嵌套节头、孤立注释行等特殊情况。
• 进一步减少缩进计算在复杂结构下的波动，使输出结果更稳定可预测。

如遇到使用问题，欢迎及时 提交 Issue