# 道具

> 会流转的物件：品类与标签、叙事权重五档、持有人与关系说明、正文方括号建档与剧本出场。

Source: https://loomworld.cn/docs/module-props

## 什么样的物件值得建一张道具卡

道具卡管的是"会流转的东西"：一把信物匕首第三幕在谁手里、经了几手；一枚伪造的印章是谁的把柄。判断标准很实际——它多次登场、承担叙事功能、或在人物之间转移，就值得建档；只出现过一次的背景物件，写进描述就够了。

道具不是剧本里的节点类型。正文用内联链接把它连到档案（下一节讲），档案再反过来告诉你它出现在哪些场、被谁拿着。

## 在哪进入：一屏列表加一条工具栏

左侧导航「道具」进入道具页，标题旁是道具总数。顶部一条工具栏从左到右是：搜索（按名称、描述或别名）、叙事权重筛选、品类筛选、排序，以及「+ 新建道具」。

- 排序有四种：最新创建、名称排序、出场次数、叙事权重。后两个把「谁在剧本里更忙、谁更不能丢」直接排给你看。
- 品类筛选里可选「所有品类」或任一品类的卡片数，找不到就在「搜索品类…」里输入；一个都没命中时显示「无匹配」，没填品类的道具显示「未分类」。
- 空项目显示「还没有道具」；筛选过头显示「没有符合条件的道具 · 调整搜索或筛选条件试试」。

卡片支持多选：选中若干张后底部浮出批量条——「已选 N 个道具」，可「全选当前」「取消选择」，「设为：」后面是五档权重一键改，「删除」会先告诉你将删掉几个（"确认删除选中的 N 个道具？此操作不可恢复。"）。

## 建档：一张卡上要填什么

- **新建**点「+ 新建道具」，或从正文里的道具链接点开预览再进详情。

- **填字段**抽屉「编辑道具」自上而下：名称、道具图片、品类、叙事权重、代表色、别称/俗名（回车添加）、基础描述、外观特征、叙事功能、标签、持有人与关系说明、备忘录、剧本出场。

- **保存**底部按钮依次显示「保存」→「保存中」。带着未保存的改动想关掉，会先问「有未保存的修改，确定丢弃？」。

三个字段是"给未来的自己看的"：外观特征写材质、颜色、破损痕迹；叙事功能写"解谜关键 / 角色情感寄托 / 凶器"这类作用；备忘录放隐藏细节和后续伏笔。标签可自由写（凶器 / 定情物 / 伪造…），和品类互不替代——品类是归类口径，标签是你自己的检索词。

图片两种来路：点图片区上传本地图片，或点「✦ 生成道具图」让智能体按设定起草提示词再出图（需登录账号，可改词后「采用」或「重新生成」）。读不到的文件会报"无法读取图片 / 无法处理图片"。

## 叙事权重：五档，而不是一句「重要」

权重分核心、重要、普通、辅助、背景五档，各有固定色。它是你给道具定的戏份承诺：排行榜、出场热力图和列表排序都按它排。新建道具默认落在普通。

代表色是另一回事——它只影响地图画笔、榜单与卡片上的标识，由同一个 64 色网格选择器挑，道具的"代表色"、章节色、伏笔色、地点色共用这块色板。

## 持有人与关系说明

持有人是从人物库里选出来的，不是从正文名字猜的：点「添加持有人」→「选择角色…」，可给每位持有人补一句关系说明（"如：祖传…"）。一件道具可以同时有几位持有人，基础值表示故事开始时的持有状态。

需要它中途易主，就在「持有人与关系说明」上点亮逐章变化：持有人和关系说明作为一个完整变化一起记录，不会出现"人换了、说明还留在上一章"。空值也是一个明确变化，不是漏填。

## 和正文的连接：写对方括号，它就进库

正文里写 `[旧怀表]`，提交后"旧怀表"渲染成绿色链接，道具库里同时多出这张卡。点链接弹出轻量详情预览，不打断写作；抽屉里的「剧本出场」再逐条列出它出现在哪些场（场 N · 地点），点一下跳到剧本对应位置。

如果一段文字只是自动识别到了道具名，织境只做弱提示：字符下方有很淡的点状标记，点它会给出「转为关联」按钮——你确认后才转成真正的道具链接。识别不等于关联，同名文字也不会被全局替换。

## 让智能体记一笔道具

对话里说"给这章添一件能开锁的东西""把匕首的持有人改成阿珍"，智能体会先读项目再出确认卡：可新建道具（至少给名字）、改字段（名称、别称、描述、品类、叙事权重、外观、叙事功能、持有人）、删除道具。一张卡最多 8 个操作，确认后一次撤销整卡撤回。详见 [AI 协作总览](https://loomworld.cn/docs/ai-overview)。

## 限制与排错

- 正文出现道具名不等于建档：只有方括号链接（或你点「转为关联」）才会写进道具库。
- 出场次数按道具在剧本里被引用的场次统计；没引用过的道具恒为 0，排序时它自然沉底。
- 道具排行榜不在道具页，而在设定页右侧的常驻榜单侧栏，四类实体共用一套，见「设定」。
- 删除道具会一并清掉正文里指向它的链接，这一步不可恢复，先看清确认框里的数量。
