🎲 SillyTavern Tracker 說明書

本說明書以繁體中文撰寫,幫助你快速上手並完全客製化 SillyTavern Tracker 擴充功能。Tracker 可自動追蹤角色扮演中的場景細節(時間、地點、角色服裝等),讓你的故事更有一致性。

🤖 下載 AI 助理 Skill(幫你設計欄位)

什麼是 Tracker?

SillyTavern Tracker 是一個場景追蹤擴充功能,在每次 AI 回覆時自動維護一份「場景快照」,記錄:

💡 為什麼需要 Tracker? AI 在長對話中容易「忘記」之前確立的細節(角色換了衣服、位置移動等)。Tracker 讓 AI 每次都能參考最新狀態,避免前後矛盾。

安裝擴充功能

在 SillyTavern 頂部點選 擴充功能 圖示(插頭圖示)

切換到 安裝擴充功能 分頁

在網址欄貼上以下連結後按 安裝

https://github.com/Minijinai75/SillyTavern-Tracker

安裝完成後重新整理頁面,擴充功能即可啟用

⚠️ 注意 若已安裝舊版英文版,請先解除安裝舊版,再重新安裝此繁體中文版。

快速開始

安裝後,Tracker 預設會自動開始追蹤場景。以下是最簡單的使用流程:

開啟追蹤器面板

有兩種方式:

切換檢視 / 編輯模式

追蹤器面板右下角有三個按鈕:

按鈕 功能
檢視 以唯讀模式顯示當前追蹤器內容
編輯 手動修改追蹤器中的任何欄位
重新生成 讓 AI 重新掃描訊息,更新追蹤器

重新生成選項

「重新生成」旁的下拉選單可控制哪些欄位會被重新生成:

選項 說明
不含靜態欄位 只重新生成「動態」和「臨時」欄位(預設)
所有欄位 重新生成全部欄位,包含靜態欄位
僅靜態欄位 只重新生成「靜態」標記的欄位

設定頁面

點選 SillyTavern 頂部的 擴充功能Tracker Settings 可開啟設定頁面。

主要設定項目

設定項目 說明
啟用/停用 開關 Tracker 功能(不影響已存的追蹤資料)
生成目標 要追蹤「使用者」、「角色」或「兩者」的訊息
格式 AI 輸出格式:JSONYAML(YAML 更節省 token)
生成模式 Inline / Single Stage / Two Stage(詳見下方)
預設組合 快速切換完整的 prompt 設定
訊息數量 提供給 AI 參考的最近幾條訊息數量
最小深度 前幾條訊息內不生成 Tracker

🔌 連線設定檔(Connection Profile)

決定 Tracker 生成時呼叫哪個 API 端點(服務商、金鑰、模型)。

設定項目 說明
覆寫用於追蹤器生成的連線設定檔 讓 Tracker 的 API 呼叫走不同的連線,與主對話完全獨立

⚙️ 補全預設詞(Completion Preset)

決定 AI 生成時的參數設定(Temperature、Top-P、最大長度等),與 API 來源是兩回事。

設定項目 說明
覆寫用於追蹤器生成的補全預設詞 讓 Tracker 使用不同的生成參數,例如更低的 Temperature 以獲得穩定的結構化輸出
⚠️ Chat Completion 注意事項 使用 Chat Completion 模式時,「補全預設詞」必須與你的 API 來源相容。例如:使用 Grok(OpenAI 格式)→ 選 OpenAI 系列預設詞;使用 Claude API → 選 Claude 系列預設詞。混用會導致參數錯誤。

💡 省 API 費用:用 Grok 當追蹤器 API

Tracker 的工作是填結構化資料,不需要高創意,很適合用免費或低成本的 API來處理,把貴的 API 留給主要對話。

在 SillyTavern API 設定頁面,新增一個 Grok 的連線設定檔(來源選「OpenAI Compatible」,填入 Grok 的 API 金鑰和端點)

開啟 Tracker 設定頁面,找到「覆寫用於追蹤器生成的連線設定檔

從下拉選單選擇你的 Grok 連線設定檔

(建議)在「覆寫補全預設詞」也選一個低 Temperature 預設(如 Precise),讓輸出更穩定

✅ 結果 主對話 → 繼續用你喜歡的高品質模型;Tracker 更新 → 走 Grok(免費/省錢),互不干擾。
💡 建議設定 初次使用建議使用預設組合「Default-SingleStage」,格式選「YAML」以節省 token。

追蹤器介面

點擊訊息旁的 </> 按鈕,可開啟浮動的追蹤器視窗。

檢視模式

以分層結構顯示所有欄位和值。無法編輯。

編輯模式

可以直接修改追蹤器中的任何欄位值。注意:

提詞製作工具

在設定頁面點選「開啟提詞製作工具」,可視覺化地管理所有追蹤欄位。

📌 用途 這裡定義的欄位,決定了 AI 要追蹤哪些資訊,以及如何追蹤它們。

工具按鈕說明

按鈕 功能
新增欄位 在頂層新增一個欄位
新增範例值 為所有欄位同時新增一組範例值
移除範例值 移除所有欄位的最後一組範例值
新增巢狀欄位 在該欄位下新增子欄位(需為物件類型)
移除欄位 刪除該欄位(會跳出確認提示)

每個欄位的屬性

屬性 說明
欄位名稱 欄位的 key(不可含雙引號)。AI 用這個名稱識別欄位
存在方式 動態 / 臨時 / 靜態(見下方詳細說明)
欄位類型 資料的結構類型(見下方詳細說明)
提詞或備注 告訴 AI 如何填寫這個欄位的指示
預設值 欄位的預設佔位值描述
範例值 提供給 AI 參考的範例,幫助 AI 理解格式

欄位類型說明

字串(STRING)
最基本的文字欄位。適合時間、地點、天氣、描述等純文字內容。
範例值09:15:30; 10/16/2024 (Wednesday)
陣列(ARRAY)
一組字串的列表。適合記錄多個項目的清單。
範例:在場人物列表 ["Emma", "James", "Sophia"]
物件(OBJECT)
包含多個子欄位的結構。適合分組管理相關屬性。
範例:一個角色同時記錄髮型、妝容、服裝。
逐一物件(FOR_EACH_OBJECT)
對每個動態 key(如角色名稱)套用相同的子欄位結構。
範例:Characters 欄位,每位角色都有 Hair / Makeup / Outfit 子欄位。
逐一陣列(FOR_EACH_ARRAY)
對每個動態 key 儲存一組陣列。
範例:每位角色的過去台詞清單。
陣列物件(ARRAY_OBJECT)
類似陣列,但內部是有結構的物件。
範例:Topics 欄位,每個主題都有多個子屬性。

存在方式說明

「存在方式」決定欄位在何種情況下被更新:

方式 說明 適用場景
動態 每次都會根據最新訊息重新生成/更新 時間、地點、天氣、姿勢、服裝狀態等隨時可能變化的欄位
臨時 只在有明確變化時更新,否則留空 偶爾才會出現的動作或事件
靜態 預設不更新,除非手動指定重新生成 通常不會改變的固有特徵(如角色的基本體型、髮色等)
💡 省 Token 技巧 把很少變化的欄位設為「靜態」,可以減少 AI 每次更新時的 token 消耗。

新增自訂欄位

以下是一個實際範例:新增一個「情緒」(Mood)欄位來追蹤角色目前的心情。

在設定頁面點選「開啟提詞製作工具

點選底部的「新增欄位」按鈕

填寫欄位屬性:

欄位名稱 Mood(英文,AI 識別用)
存在方式 動態
欄位類型 字串
提詞或備注 Describe the character's current emotional state in one or two words.
預設值 <Current mood>

(選用)點選「新增範例值」並填入 NervousExcitedCalm

設定會自動儲存。下次 AI 生成時就會追蹤此欄位

⚠️ 欄位命名建議 欄位名稱盡量使用英文(如 MoodTemperature),因為 AI 是用英文理解欄位結構。提詞和說明則可以用中文,但英文效果通常更好。

更複雜的範例:角色情緒物件

如果你想讓每位角色都有獨立的「情緒」追蹤,可以在 角色 欄位底下,點選「新增巢狀欄位」,新增子欄位 心情(字串)。


🧊 實戰範例:冰室逝藍的雙軸追蹤系統

逝藍這個角色有一套獨特的「雙軸驅動系統」,用 Tracker 來追蹤能讓 AI 的行為更一致,不容易跑偏。

📌 什麼是雙軸系統? 逝藍的行為同時受兩個獨立的數值影響:好感度(心理層面)體溫熱度(生理本能)。兩者組合決定他的台詞風格、敬語使用、是否會顯形。

建議追蹤的欄位

欄位名稱 類型 存在方式 說明 可能的值
好感度 字串 動態 逝藍對 USER 的心理情感層級 Cold / Warm / Melted
體溫熱度 字串 動態 因肢體接觸積累的生理熱度(影響顯形) / /
逝藍體溫 字串 動態 逝藍當前體溫(基準 29°C,接觸後上升) 29°C / 31°C / 33°C
顯形狀態 字串 動態 逝藍的外觀模式(體溫高時自動顯形) 擬態(黑髮) / 顯形(冰藍長髮)
互動層級 字串 動態 當前場景對應的行為層級 層級一:絕對零度層級五:溫存絮語
語言模式 字串 動態 逝藍使用的敬語層級(跟好感度連動) 敬體(ですます調) / 敬常體混用 / 常體(親密)
結晶化進度 字串 靜態 心臟結晶化狀況(除非劇情發展否則不更新) 穩定 / 輕微加劇 / 逆轉中

提詞設定範例(Prompt 欄位填入)

好感度欄位的提詞建議填入(英文效果最好):

Track Seiran's current affection level toward the user: Cold (treats user as a tool, professional distance), Warm (curious about user, tests compatibility), or Melted (treats user as soulmate, shows vulnerability and clinginess). Must match his dialogue style and behavior tier.

體溫熱度欄位的提詞:

Track the accumulated heat level from physical contact: 低 (low, no recent contact, rational control), 中 (medium, brief contact, comfortable but controllable), 高 (high, prolonged contact, losing control, hair may shift to ice-blue). Heat dissipates gradually over time without contact.

顯形狀態欄位的提詞:

Track Seiran's current appearance mode. 擬態(黑髮)is his default work mode. 顯形(冰藍長髮)only activates when Heat Level is 高 or under extreme emotional stress. Hair returns to black after body temperature normalizes.
💡 搭配使用技巧 把這些欄位的值也加入到「訊息追蹤器模板」顯示出來,這樣你一眼就能確認 AI 有沒有正確維持角色狀態,發現偏差時可以手動用編輯模式修正。

加入範例值

在提詞製作工具按「新增範例值」,填入以下一組完整範例讓 AI 更好理解格式:

欄位 範例值
好感度 Warm
體溫熱度
逝藍體溫 31°C
顯形狀態 擬態(黑髮)
互動層級 層級三:依戀與撒嬌
語言模式 敬常體混用
結晶化進度 穩定

自訂訊息顯示模板

設定頁面的「訊息追蹤器模板」欄位,控制追蹤器資料如何顯示在訊息上方。

模板語法

語法 說明
{{欄位名稱}} 顯示該欄位的值
{{#foreach 集合 項目}} ... {{/foreach}} 循環顯示集合中的每個項目
{{#if 條件}} ... {{/if}} 條件判斷
{{#join "; " 陣列}} 將陣列用分隔符號連接
{{欄位 | toUpperCase()}} 轉換為大寫
{{欄位 | toLowerCase()}} 轉換為小寫

範例:簡潔模板

<!-- 只顯示時間和地點 -->
<div class="tracker-compact">
  ⏰ {{Time}} | 📍 {{Location}}
</div>
<hr>

範例:完整模板

<table>
  <tr><td>時間</td><td>{{Time}}</td></tr>
  <tr><td>地點</td><td>{{Location}}</td></tr>
  <tr><td>天氣</td><td>{{Weather}}</td></tr>
</table>

<!-- 列出所有角色 -->
{{#foreach Characters character}}
<strong>{{character}}</strong>:
服裝:{{character.Outfit}}
{{/foreach}}
<hr>

預設組合管理

「預設組合」可以儲存一套完整的設定(包含提詞、模板、欄位定義),方便快速切換不同的追蹤風格。

預設的三個組合

名稱 說明 適合情境
Default-SingleStage 單一階段生成 大多數情況的最佳選擇,速度與品質平衡
Default-TwoStage 兩階段生成(先摘要再更新) 長對話、複雜場景,追蹤更精準但較慢
Default-Inline 追蹤器內嵌在 AI 回覆開頭 不想使用額外 API 呼叫的輕量化方案

建立自訂預設組合

在設定頁面調整好所有你想要的設定

在「預設組合」旁邊輸入新名稱

點選「儲存」建立新預設

生成模式說明

Inline(內嵌)

追蹤器直接嵌入 AI 的主要回覆中,出現在回覆最前面。

Single Stage(單階段)

對追蹤器進行一次獨立的 API 呼叫,不影響主要回覆。

Two Stage(兩階段)

先用第一次呼叫「摘要」最新訊息的變化,再用第二次呼叫「更新」追蹤器。

常見問題

追蹤器沒有自動生成?

請確認:

AI 生成的追蹤器內容不準確?

如何刪除或重置追蹤器?

在編輯模式下手動清空欄位,或在追蹤器面板中點選「重新生成」讓 AI 重新建立。

欄位名稱可以用中文嗎?

技術上可以,但不建議。AI 用英文 key 識別欄位,中文 key 可能導致 AI 在結構化輸出時出錯。建議 key 用英文,提詞內容可以用中文。

如何完全重置為預設設定?

在設定頁面的「預設組合」下拉選單選擇 Default-SingleStage,然後點選「載入」,即可恢復預設欄位定義和提詞。

Tracker 資料儲存在哪裡?

追蹤器資料儲存在 SillyTavern 的對話 JSON 檔案中,每條訊息都有一個對應的 tracker 物件。備份對話時,Tracker 資料也會一起備份。