用途:在不全篇重构的前提下,对指定 Markdown 文件完成三件事——生成全局导航、局部重构指定章节、把越界内容路由到合适位置。依赖 $learning-notes-organizer(边界判断、归类、学习路径、精修重写、格式保真)与 $planning-with-files(组织执行流程与交付结构)。
输入:必填 target_file(目标文件路径)与 focus_sections(需重构的章节列表,1~N 个,支持标题名模糊匹配或标题路径精确匹配,如 ["学习资源与概览"] 或 ["核心概念与内存背景/ByteBuf"])。
主要能力:为每个 H1-H6 标题输出一句话“含义”与一句话“引导注释”;对指定章节调整内部结构与顺序、标记越界内容块;将越界内容映射到目标标题,目标标题下缺容器时新增子标题“待整理”;可为迁移内容生成 MIG-xxx 标记便于后续点名整理。
执行步骤按 $planning-with-files 输出:抽取(标题树+含义+引导注释)→规划(章节边界、结构顺序、越界块)→映射(旧位置到新位置、来源到目标路径、新增待整理)→交付(全标题索引、重构后 Markdown、迁移与待整理清单、变更摘要)。
可选参数默认值:heading_level_support 为 H1-H6;meaning_source 为 title_plus_snippets;intro_policy 为 prefer_existing_then_generate;section_match_policy 为 prefer_path_then_title;duplicate_title_policy 为 pick_best_match_with_reason;routing_unit 为 paragraph_block;todo_bucket_name 为“待整理”;add_todo_bucket_policy 为 only_when_needed;todo_insert_position 为 top_of_target_section;outside_scope_edit_policy 为 minimal_only;migration_id_policy 为 auto_ids。
限制:范围外章节默认不改;minimal_only 仅允许新增“待整理”并插入迁移内容,allow_small_fixes 可在其基础上做断链/术语一致/必要过渡等小修复,不得扩展为范围外重写。具体收费、价格、效果等暂未提供。