# 時間軸

> 多條劇情線：卡片流排先後，刻度軸管年份時長，事件可掛在劇本的某一處並跳回去。

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

## 時間軸是什麼，在哪進入

時間軸是劇本前期的手工整理板：幫你檢查敘事先後、真實時間和相關對象，不會從劇本自動產生事件，也不會覆蓋你排好的順序。入口在左側導覽「時間軸」，標題旁是事件總數，下方一行顯示「劇情線 N」「已關聯劇本 N」「時間點／時間段 N / N」。

一個專案可以有多條時間軸，各自獨立：主劇情線、女主角線、幕後線各自排定。每條線在首頁就能直接編輯，沒有單獨的「專注編輯」分流。

## 新增一條線：建的時候就把模式定了

點擊右上角「+ 新增劇情線」，快顯視窗裡填寫名稱（預設提示「例如：主線劇情」）並選擇呈現模式：

- 「卡片流 (順序排布，可拖曳)」——只排先後。
- 「時間軸 (物理刻度，雙軌道)」——管年份與時長；這條線呈現在卡片上會標示為「刻度軸」。

若一開始就在整理紀年，就直接建立為時間軸，別建完再去設定裡切換。已有線條也能在「設定 → 劇情線設定」裡修改名稱、呈現模式、座標軸起點與終點（留空即「自動」），以及刪除劇情線。

一條線還沒有內容時顯示「暫無卡片。」或「暫無時間點或時間段。」；整個專案一條線都沒有時，頁面直接告訴你「目前還沒有任何劇情線 / 點擊右上角 + 新增劇情線 開始建立你的第一條線索。」

## 卡片流：只管先後

卡片依從左到右、從上到下的閱讀順序排列，寬度自適應、放不下就自動換行；拖曳卡片變更順序，順序就是敘事先後。它不表達真實時間比例——「初遇」和「結盟」之間隔了三個月還是三年，這裡看不出來，也不該看出來。

新增入口依模式提供：卡片流上方是「+ 加入卡片」，不讓你在快顯視窗裡二次選擇類型。

## 刻度軸：年份、時長與分行

刻度軸使用物理座標：時間點落在軸線上（圓點加膠囊），時間段落在軸線下方，左側起始、中央名稱、右側結束，長度就是它的持續範圍，刻度數字貼著主軸。

- 預設 100% 全覽。有橫向可視範圍時：普通滾輪或觸控板橫移即前後平移，Shift + 滾輪圍繞游標在 100%–600% 之間縮放，底部滑桿同步顯示位置。在軸線內捲動到邊緣或全覽時，縱向滾動交給頁面繼續往下捲，不會被軸線吞掉。
- 拖曳即可調整：時間點吸附到整數座標；時間段拖曳中間整體平移，拖曳左右兩端分別修改起止點，最短保留 1 個整數單位。拖曳過程中不寫入資料庫，放開手才儲存最終位置——輕按依然是開啟事件詳情。
- 時間段預設不是一段佔用一行：互不重疊的段落會盡量共用同一行，只有橫向實際重疊時才往下分行。你也可以把某個時間段上下拖曳到其他行，落點依然會進行避讓校正，因此同一行內不會出現橫向重疊。
- 按兩下軸線上的空白處直接新增：刻度軸上分為「連按兩下加入時間點」和「連按兩下加入時間段」，新建立項目的預設起止會被壓縮在目前可視範圍內，避免出現「建立了但看不見」。

卡片高度依內容自適應，節點較多時整張線向下延伸，不會被壓縮在固定高度裡。

## 掛在劇本的哪一處

卡片、時間點、時間段都可以選擇一個「發生位置」：章節、場次、時空或某個內容區塊（也可以「不關聯劇本位置」）。時間軸只儲存引用，不複製劇本文字，事件詳情裡的「跳到劇本」會帶你回到該處繼續寫作。

相關對象（人物、地點、道具、設定）單獨記錄：選擇器把已選取的對象置頂顯示、附帶分類小標記，四類預設摺疊並在標題上顯示「已選 / 總數」，上方搜尋框依名稱和別稱篩選——即使對象眾多也不會把彈出視窗撐到看不完。描述裡還可以使用 @ 提及實體。

兩者用途不同：相關對象是你確認過的關聯，用於篩選、彙整和提供給 AI 作為上下文；@ 只負責閱讀時跳轉。它們都不會推斷因果，也不替你計算「誰在場」。

## 讓 AI 代理整理時間軸

對話裡說「把結盟排在第 3 章之後」「給女主角線補一條從流亡到重逢的骨架」，AI 代理會走確認卡：新建或修改劇情線（名稱、顏色、模式、軸範圍）、新建／修改／刪除事件（所屬線、標題、說明、發生位置、相關與關聯對象、點段時間、關聯場次地點）。

驗證在 Runtime 嚴格執行：發生位置必須指向真實存在且層級一致的章／場／時空／內容區塊；時間段的結束座標必須大於起始座標；刪除一條線會連帶刪除其中的事件，確認卡上會列出將要刪除幾個項目。整張卡一次確認生效，確認後一次復原撤回全部。「AI 自動整理整段時間軸」不在這套能力範圍內。

## 限制與排錯

新增與編輯都會當場驗證，不會無聲失敗：

- 「請先填寫事件標題。」／「請先填寫起始座標。」／「請先填寫結束座標。」／「時間段的結束座標需要大於起始座標。」
- 在同一張確認卡裡「新建一條劇情線 + 把新事件掛到這條新線上」目前不支援：線條的識別碼要寫入資料庫後才產生，請分兩步進行。
- 卡片流與刻度軸是同一批內容的兩種視角，但兩者幾何互不換算：切換模式不會替你產生時間點，也不會把順序變成時長。
- 時間軸取消過專注編輯分流，所有操作都在首頁完成；不要去別處尋找編輯入口。