intelligent-import

智能导入 / 重整目录 skill

用途

专职整理文档的目录层级结构。在简单导入或完整导入入库后，对已有节点树做结构调整——新建虚拟容器节点叠章节层、调父子边、调兄弟顺序、给虚拟容器补章节名。

本 skill 不重做简单导入已识别的结构——能用正则/AST/格式规范做的事不调用 LLM API（成本约束）。

触发

• 导入流程入口：用户在导入对话框选"智能导入"，简单导入入库后自动触发本 skill；导入流程结束时弹强制审批对话框（接受全部/拒绝全部）。
• 重整目录入口：已导入文档上，用户在 LLM 协作模式对话区发起"用 LLM 重整目录"指令；产物按 15-7 路径进 LLM 对话区待审卡片，按 15-8/15-9 逐条或整批审。

输入

调用方上下文提供：

• 当前文档 docId 和 treeIndex（每个节点的地址、深度、子节点数、字数）
• 当前权限模式（必须为 agent.mode.edit 协作模式或更高）
• 触发场景（import-flow 或 restructure），用于决定审批 UI 走哪条路

输入产物来自完整导入（4-2）——智能导入入库阶段复用完整导入解析，不走简单导入失败拒绝。所以 treeIndex 反映的形态有三种：

1. 结构识别成功：节点 1 下有章节层、章节下有段落容器（虚拟节点）、段落下有句子节点
2. 结构识别失败：节点 1 下平铺段落容器（虚拟节点）、段落下有句子节点；无章节层
3. 极端兜底：节点 1 单节点（全文塞节点 1 正文），无子节点

skill 按需通过 db read <docId> <地址> 拉取节点正文；不拿原始源文件，因为节点已经反映了规则解析的产物。

输出

调用 database_mutation 产生 entry kinds 序列，写入 owner=llm 影子分支。允许的 entry kinds：

kind	用途
node.insert	新建虚拟容器节点
node.update	给虚拟容器节点写 node_title 字段
node.reparent	调节点父子边
node.moveBefore / node.moveAfter	调兄弟顺序
node.delete	删除已没有子节点的空虚拟容器

其余 entry kinds（node.split、node.mergeInto、axiom.*、ref.* 等）本 skill 不调用。

虚拟容器节点形态（强约束）

新建节点必须严格按 9-1-1 虚拟节点形态：

• text 为空
• node_type 用 TEXT，role 标记为容器类型（如 paragraph）
• source_position 取该容器所有子节点最早 source_position 减 0.5（半步偏移避免位置冲突）
• skipVector 为 true
• node_title 可写（章节名）；node_note 留空

未按此形态创建的节点会破坏 9-1 渲染规则，被判定为违规。

职责范围（"该/不该"，非系统级"能/不能"）

skill 做

• 新建虚拟容器节点做分组归类
• 给虚拟容器节点的 node_title 写章节名
• 调父子边把散落的同类节点归到一起
• 调兄弟顺序把章节按合理顺序排
• 删除已空的虚拟容器（其子节点全部被移走后）

skill 不涉及

• 正文编辑：text 字段修改归 LLM 系统级编辑能力（别的 skill 或人类编辑模式负责）。本 skill 不动任何节点正文。
• 节点摘要：给真实内容节点（有正文的）写 node_title 当摘要属于节点摘要 skill 范围。本 skill 只给虚拟容器写章节名。
• 段落切分/合并：段落容器和句子节点的粒度由 4-2 完整导入锁定（智能导入入库走完整导入解析）。本 skill 不动段落正文边界。
• 删带正文的真实内容节点：本 skill 只删自己创建的空虚拟容器。
• 事实前提：axiom.* 全部归 9-8 单独编辑路径。

工作流

1. 读 treeIndex 看当前结构，按上面三种输入产物形态分类。
2. 判断是否需要调整——保守原则，不为了"做点什么"而强行调整：
   • 结构识别成功 + 章节顺序合理 + 层级合理 → 返回空 entries
   • 结构识别成功 + 章节顺序乱（按 source_position 序号看不连续）或层级误划 → 重排或调层
   • 结构识别失败（节点 1 下平铺段落容器）→ 按段落正文聚类，新建章节虚拟容器作为段落容器的父节点
   • 极端兜底（节点 1 单节点）→ 返回空 entries 并在对话区说明"短文档/单句备忘无需结构化"
3. 必要时按 db read 拉节点正文 判断聚类——不要一次性拉所有正文，按 treeIndex 字数评估，只读相关节点。
4. 决定调整方案，生成 entry 序列。每个 entry 必须可在影子分支投影中合法应用（参考 edit-branch-projection.mjs）。
5. 保持节点集合恒等——真实内容节点不增不减，只调关系；只增删虚拟容器。