当前约定：
- 章节写作时不再要求添加 XML 标签
- Data Agent 会自动从纯正文中提取实体，写入 index.db
- 标签仅用于手动标注场景（如明确标记重要实体、补充提取遗漏）
- 如果你选择使用标签，请遵循以下规范</context>
标签总览
| 标签 | 用途 | 必填属性 |
|---|---|---|
<entity> |
新建/自动更新实体（角色/地点/物品/势力/招式） | type, name |
<entity-alias> |
注册实体别名/称号 | id/ref, alias |
<entity-update> |
更新实体属性（支持 set/unset/add/remove/inc + 历史追踪） | id/ref, <set> 等 |
<skill> |
金手指技能 | name, level, desc, cooldown |
<foreshadow> |
伏笔埋设 | content, tier |
<relationship> |
角色关系 | char1, char2, type |
<deviation> |
大纲偏离标记 | reason |
属性详解
tier（层级）
- 核心: 影响主线剧情，必须追踪
- 支线: 丰富剧情，应该追踪
- 装饰: 增加真实感，可选追踪
type（实体类型）
角色 / 地点 / 物品 / 势力 / 招式
id / ref（实体引用）
- id（推荐）: 稳定唯一标识（便于后续更新/加别名）
- ref: 用已出现过的名称/别名引用（通过 index.db aliases 表自动解析）
- type（可选）: 当 ref 有歧义时用于消歧（如同名不同人）；若仍歧义必须改用
id
<entity-update> 子操作
- set:
<set key="k" value="v" reason="可选"/> - unset:
<unset key="k" reason="可选"/> - add:
<add key="k" value="v" reason="可选"/>（数组追加，自动去重） - remove:
<remove key="k" value="v" reason="可选"/>（数组移除） - inc:
<inc key="k" delta="1" reason="可选"/>（数值递增，默认 +1）
顶层字段白名单（可直接更新实体顶层而非 current）：tier, desc, canonical_name, importance, status, parent
建议:
<entity>强烈建议补充desc和tier，否则后续检索和一致性检查会变差。
放置规则
- 推荐: 章节末尾统一放置（便于管理）
- 允许: 实体首次出现的段落末尾
- 要求: 标签独占一行，不夹在正文句子中
隐藏写法（推荐）
正文内容...
<!--
<entity type="角色" id="luchen" name="陆辰" desc="主角，觉醒时空能力" tier="核心"/>
<entity-alias id="luchen" alias="陆队" context="加入特勤队后"/>
<entity-update id="luchen"><set key="realm" value="F级-觉醒者" reason="觉醒完成"/></entity-update>
<skill name="时间回溯" level="1" desc="回到10秒前" cooldown="24小时"/>
<foreshadow content="神秘老者的玉佩" tier="核心" target="50"/>
<relationship char1_id="luchen" char2_id="liwe" type="ally" intensity="60" desc="初步合作"/>
-->