# 道具

> 會流轉的物件：品類與標籤、敘事權重五級、持有人與關係說明、正文方括號建檔與劇本出場。

Source: https://loomworld.ai/zh-tw/docs/module-props

## 什麼樣的物件值得建一張道具卡

道具卡管的是「會流轉的東西」：一把信物匕首第三幕在誰手裡、經了幾手；一枚偽造的印章是誰的把柄。判斷標準很實際——它多次登場、承擔敘事功能、或在人物之間轉移，就值得建檔；只出現過一次的背景物件，寫進描述裡就足夠了。

道具不是劇本裡的節點類型。正文使用行內連結把它連結到檔案（下一節說明），檔案再反過來告訴你它出現在哪些場次、由誰持有。

## 在哪進入：一屏列表加一條工具列

從左側導覽「道具」進入道具頁，標題旁是道具總數。頂部一條工具列從左到右依序是：搜尋（依名稱、描述或別名）、敘事權重篩選、品類篩選、排序，以及「+ 新增道具」。

- 排序有四種：最新建立、名稱排序、出場次數、敘事權重。後兩種把「誰在劇本裡更忙碌、誰更不能丟失」直接排給你看。
- 品類篩選中可選「所有品類」或任一品類的卡片數，找不到就在「搜尋品類…」裡輸入；一個都沒有命中時顯示「無相符項目」，未填寫品類的道具顯示「未分類」。
- 空白專案顯示「還沒有道具」；篩選條件過於嚴格顯示「沒有符合條件的道具 · 調整搜尋或篩選條件試試」。

卡片支援多選：選取若干張後底部浮現批次列——「已選 N 個道具」，可「全選目前」「取消選取」，「設為：」後面是五級權重一鍵變更，「刪除」會先告訴你將刪除幾個（「確認刪除選取的 N 個道具？此操作不可恢復。」）。

## 建檔：一張卡上要填什麼

- **新增**點擊「+ 新增道具」，或從正文裡的道具連結點開預覽再進入詳情。

- **填寫欄位**抽屜「編輯道具」自上而下依序是：名稱、道具圖片、品類、敘事權重、代表色、別稱／俗名（按 Enter 加入）、基本描述、外觀特徵、敘事功能、標籤、持有人與關係說明、備忘錄、劇本出場。

- **儲存**底部按鈕依序顯示「儲存」→「儲存中」。帶有未儲存的修改想要關閉時，會先詢問「有未儲存的修改，確定捨棄？」。

有三個欄位是「留給未來的自己看的」：外觀特徵寫材質、顏色、破損痕跡；敘事功能寫「解謎關鍵／角色情感寄託／凶器」這類作用；備忘錄放隱藏細節和後續伏筆。標籤可自由填寫（凶器／定情物／偽造…），與品類互不替代——品類是分類標準，標籤是你自己的檢索詞。

圖片有兩種來源：點擊圖片區域上傳本機圖片，或點擊「✦ 產生道具圖」讓 AI 代理依設定起草提示詞再繪製圖片（需登入帳號，可修改提示詞後「採用」或「重新產生」）。讀取不到的檔案會提示「無法讀取圖片／無法處理圖片」。

## 敘事權重：五級，而不是一句「重要」

權重分核心、重要、普通、輔助、背景五級，各有固定顏色。它是你給道具設定的戲份承諾：排行榜、出場熱力圖和列表排序都依它排列。新增道具預設落在普通。

代表色則是另一回事——它只影響地圖畫筆、榜單與卡片上的標識，由同一個 64 色色盤選擇器挑選，道具的「代表色」、章節色、伏筆色、地點色共用這塊色盤。

## 持有人與關係說明

持有人是從人物庫裡挑選出來的，不是從正文姓名猜測的：點擊「加入持有人」→「選擇角色…」，可給每位持有人補上一句關係說明（「如：祖傳…」）。一件道具可以同時有多位持有人，基本值表示故事開始時的持有狀態。

需要它中途易主時，就在「持有人與關係說明」上點亮逐章變化：持有人和關係說明會作為一個完整的變化一起記錄，不會出現「人換了、說明還留在上一章」的情況。空值也是一個明確的變化，而不是漏填。

## 和正文的連接：寫對方括號，它就入庫

正文裡寫 `[舊懷錶]`，送出後「舊懷錶」會呈現為綠色連結，道具庫裡同時多出這張卡片。點擊連結會彈出輕量詳情預覽，不打斷寫作；抽屜裡的「劇本出場」再逐條列出它出現在哪些場次（第 N 場 · 地點），點一下即可跳轉到劇本對應位置。

如果一段文字只是自動辨識到了道具名稱，織境只會提供弱提示：字元下方有很淡的點狀標記，點擊它會顯示「轉為關聯」按鈕——經你確認後才會轉成真正的道具連結。辨識不等於關聯，同名文字也不會被全域取代。

## 讓 AI 代理記一筆道具

對話裡說「給這章添一件能開鎖的東西」「把匕首的持有人改成阿珍」，AI 代理會先讀取專案再給出確認卡：可新建道具（至少提供名稱）、修改欄位（名稱、別稱、描述、品類、敘事權重、外觀、敘事功能、持有人）、刪除道具。一張卡最多 8 個操作，確認後可一次復原整卡撤回。詳見 [AI 協作總覽](https://loomworld.ai/zh-tw/docs/ai-overview)。

## 限制與排錯

- 正文中出現道具名稱不等於建檔：只有方括號連結（或你點擊「轉為關聯」）才會寫入道具庫。
- 出場次數依道具在劇本裡被引用的場次統計；未曾引用過的道具恆為 0，排序時自然沉底。
- 道具排行榜不在道具頁，而是在設定頁右側的常駐榜單側欄，四類實體共用一套，見「設定」。
- 刪除道具會一併清除正文裡指向它的連結，這一步無法恢復，請先看清楚確認視窗中的數量。
