# 跨模块联动

> 联动是单向的：正文沉淀资料，身份跟着改名走，删除才受保护，AI 写入走同一张确认卡。

Source: https://loomworld.cn/docs/cross-sync

## 方向：剧本 → 资料，不反写

织境的联动是有方向的：你在正文里写下的东西会沉淀为资料；反过来，在资料模块里手动建的条目不会因为剧本删了某一行就消失。这条规则决定了绝大多数"它会不会自己改掉"的疑问——不会。

## 写作时自动发生的三处连接

- 「角色」行提交（回车、光标移开、编辑器失焦）时，按归一化名字（去首尾空格 + 忽略大小写）查人物库，别称也参与匹配；命中就绑定，没有就新建一张人物卡，层级默认落在「闲角」。输入停顿和半个名字都不会建卡。
- 场次节点的地点在失焦或回车时按同一规则匹配地点库，没有就新建。
- 正文里写 [旧怀表] 这类内联链接，提交时按名字查道具库，没有就新建道具；这一行的道具引用会被记录下来。

建项开场与续写走同一套：模型流式输出的过程中，半个场次头、半个人名、半个道具引用都只留在旁路草稿里，不建任何卡；完成、停止或失败结算时才把整段解析成节点。所以你不会看到按字建出来的一堆碎片档案。

## 仍然由你亲手维护的部分

关系、持有人、章节演变、伏笔锚点、排行榜分值、地图映射、随航面板里的摆放位置——这些都只有你说了才算。系统不猜动机，不推断谁爱谁，也不会因为你写了"他拿起剑"就建一把剑。

时空的地点是例外中的例外：它的输入提交会创建或复用一张地点卡，但那是在本场主地点的子树内进行的；改绑定不改名，清空或删除只解除引用，不删档案。

## 改名牵连与删除牵连

- 改名几乎不牵连：势力卡改名，成员标签、名册分组、排行榜与 AI 读到的内容一起跟上；地点改名，平面标签与剧本引用显示最新名称。因为存的是身份，不是文字。
- 删除才牵连：删人物同时删掉它的关系线；地点或其子树仍被场次 / 时空引用时，整次删除被拒绝，单个地点被引用时也不能改父级；删剧情线会级联删掉线内事件；删章节或场次会清掉指向它们的伏笔与时间线锚点，不留悬挂 ID。
- 地图只影响表现：删一处映射只删当前视图的这一处表现，不删地点档案、不删另一视图的几何，也不动子地图。
- 势力「退出分类」要走影响确认：在同一次更新里清掉人物基础关系、逐章关键帧和排行榜筛选，并且可以一次撤销。

## 按章状态怎么被读到

人物与道具的逐章变化只在读取时合并：基础值是故事开始时的状态，关键帧从所在章起沿用，直到下一个变化点。查某一章的有效状态时，不会把该章之后的变化混进来；要看变化历史，必须同时给出起止章节，返回逐条改前 / 改后。

AI 也按同一口径读：读人物状态要带章节，返回"截至这一章"的年龄、身份、所属势力与阶段状态，势力以当前正式名加卡片 ID 表达；图谱里人物与势力之间只按有效归属生成成员边，不靠名称或别名兜底。

## AI 的写入也走同一套规则

智能体改资料不靠"识别到就顺手改"。所有写动作都经同一张确认卡：一次最多 8 个原子操作、同一事务提交；目标在你确认前已被别处改过时整卡拒绝，不会静默覆盖；确认后整卡进入项目撤销栈，一次撤销全部回来。删除类操作在卡上先列出影响（出场、关系、子树、入向关联、线内事件、剧本锚点的计数）。

详见 [AI 协作总览](https://loomworld.cn/docs/ai-overview)。

## 限制与排错

- 联动是单向的：资料卡的变化不会擅自重写正文；正文的变化也不会替你补设定或补关系。
- 自动建档只按名称与别称归一匹配。想让「阿珍」「林医生」指同一个人，把别称加进档案，而不是期待系统猜。
- 外部导入的项目包里若存在悬空 ID，会在导入时清理基础值、逐章关键帧与排行榜条件并给出摘要，不会按同名卡静默改绑。
