版本更新

重构与优化

节头注释识别与缩进机制深度升级

• 新增 sectionCommentPrefixes 配置集合，集中管控节头注释前缀规则，显著提升识别准确性与后续扩展灵活性。
• 实现 isSectionLeadingComment 判定函数，精准区分节头注释与普通单行/多行注释、字符串文本等干扰内容，杜绝误识别。
• 引入 stackWithoutTrailingSections 工具方法，在计算缩进层级时自动剥离末尾冗余节头标记，使栈深度更真实反映代码语义嵌套关系。
• 重构缩进计算逻辑：对节头注释行启用“修正栈深度”作为缩进依据，替代原始嵌套计数，彻底规避节头注释被错误缩进的问题。
• 明确节头注释与其所属代码块之间的视觉层级关系定义，统一采用同级对齐策略，有效降低阅读过程中的结构跳跃感，提升可读性。

---

新增功能

节头注释与关联代码块的自适应缩进对齐能力

• 为节头注释设计专属缩进规则引擎，支持其自动匹配并严格对齐至对应功能节的起始缩进位置。
• 借助栈深度动态校准机制，防止节头注释被误纳入语句缩进链路，避免出现非预期的深层缩进。
• 全面支持连续多个节头注释的批量识别与协同对齐，保障大型配置文件或模块化文档中结构表达的一致性与专业性。
• 内置容错型降级策略，在极端缩进嵌套或混合语法场景下仍能维持基础对齐精度，确保稳定性优先。

---

行为改进

缩进系统整体健壮性与边界兼容性强化

• 优化栈状态变更路径，消除因节头标记插入/移除引发的深度偏移误差，提升层级追踪可靠性。
• 增加前缀有效性验证与伪节头过滤流程，大幅降低异常注释格式导致的识别失准率。
• 加强对各类边缘用例的支持，涵盖文件首行为节头、节头嵌套、无后续代码的孤立节头注释等典型复杂场景。
• 进一步收敛缩进输出波动范围，在高嵌套、多注释混合的工程文件中保持结果高度稳定与可复现。

若在使用过程中发现任何异常或疑问，欢迎随时 提交 Issue 反馈

源码地址：点击下载