版本更新
重构与优化
节头注释识别与缩进机制深度升级
- 新增
sectionCommentPrefixes配置集合，集中管控节头注释前缀规则，显著提升识别准确性与后续扩展灵活性。 - 实现
isSectionLeadingComment判定函数，精准区分节头注释与普通单行/多行注释、字符串文本等干扰内容，杜绝误识别。 - 引入
stackWithoutTrailingSections工具方法，在计算缩进层级时自动剥离末尾冗余节头标记，使栈深度更真实反映代码语义嵌套关系。 - 重构缩进计算逻辑：对节头注释行启用“修正栈深度”作为缩进依据，替代原始嵌套计数，彻底规避节头注释被错误缩进的问题。
- 明确节头注释与其所属代码块之间的视觉层级关系定义，统一采用同级对齐策略，有效降低阅读过程中的结构跳跃感，提升可读性。
新增功能
节头注释与关联代码块的自适应缩进对齐能力
- 为节头注释设计专属缩进规则引擎，支持其自动匹配并严格对齐至对应功能节的起始缩进位置。
- 借助栈深度动态校准机制，防止节头注释被误纳入语句缩进链路，避免出现非预期的深层缩进。
- 全面支持连续多个节头注释的批量识别与协同对齐，保障大型配置文件或模块化文档中结构表达的一致性与专业性。
- 内置容错型降级策略，在极端缩进嵌套或混合语法场景下仍能维持基础对齐精度，确保稳定性优先。
行为改进
缩进系统整体健壮性与边界兼容性强化
- 优化栈状态变更路径，消除因节头标记插入/移除引发的深度偏移误差，提升层级追踪可靠性。
- 增加前缀有效性验证与伪节头过滤流程，大幅降低异常注释格式导致的识别失准率。
- 加强对各类边缘用例的支持，涵盖文件首行为节头、节头嵌套、无后续代码的孤立节头注释等典型复杂场景。
- 进一步收敛缩进输出波动范围，在高嵌套、多注释混合的工程文件中保持结果高度稳定与可复现。
若在使用过程中发现任何异常或疑问，欢迎随时 提交 Issue 反馈
源码地址：点击下载
