🎲 SillyTavern Tracker 說明書
本說明書以繁體中文撰寫,幫助你快速上手並完全客製化 SillyTavern Tracker 擴充功能。Tracker 可自動追蹤角色扮演中的場景細節(時間、地點、角色服裝等),讓你的故事更有一致性。
🤖 下載 AI 助理 Skill(幫你設計欄位)什麼是 Tracker?
SillyTavern Tracker 是一個場景追蹤擴充功能,在每次 AI 回覆時自動維護一份「場景快照」,記錄:
- ⏰ 時間:場景內的當前時刻
- 📍 地點:確切的位置描述
- 🌤️ 天氣:當前天氣狀況
- 👗 角色服裝與外觀:每位角色的完整裝束
- 💬 主題與情緒氛圍:場景的關鍵詞標籤
- ✋ 姿勢與互動:角色的姿態和動作
安裝擴充功能
在 SillyTavern 頂部點選 擴充功能 圖示(插頭圖示)
切換到 安裝擴充功能 分頁
在網址欄貼上以下連結後按 安裝:
https://github.com/Minijinai75/SillyTavern-Tracker
安裝完成後重新整理頁面,擴充功能即可啟用
快速開始
安裝後,Tracker 預設會自動開始追蹤場景。以下是最簡單的使用流程:
開啟追蹤器面板
有兩種方式:
- 方式 A:點選 SillyTavern 頂部的
擴充功能選單→ 「追蹤器」 - 方式 B:點選訊息旁邊的
</>圖示,查看該訊息的追蹤器
切換檢視 / 編輯模式
追蹤器面板右下角有三個按鈕:
| 按鈕 | 功能 |
|---|---|
檢視 |
以唯讀模式顯示當前追蹤器內容 |
編輯 |
手動修改追蹤器中的任何欄位 |
重新生成 |
讓 AI 重新掃描訊息,更新追蹤器 |
重新生成選項
「重新生成」旁的下拉選單可控制哪些欄位會被重新生成:
| 選項 | 說明 |
|---|---|
| 不含靜態欄位 | 只重新生成「動態」和「臨時」欄位(預設) |
| 所有欄位 | 重新生成全部欄位,包含靜態欄位 |
| 僅靜態欄位 | 只重新生成「靜態」標記的欄位 |
設定頁面
點選 SillyTavern 頂部的 擴充功能 → Tracker Settings 可開啟設定頁面。
主要設定項目
| 設定項目 | 說明 |
|---|---|
| 啟用/停用 | 開關 Tracker 功能(不影響已存的追蹤資料) |
| 生成目標 | 要追蹤「使用者」、「角色」或「兩者」的訊息 |
| 格式 | AI 輸出格式:JSON 或 YAML(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 以獲得穩定的結構化輸出 |
💡 省 API 費用:用 Grok 當追蹤器 API
Tracker 的工作是填結構化資料,不需要高創意,很適合用免費或低成本的 API來處理,把貴的 API 留給主要對話。
在 SillyTavern API 設定頁面,新增一個 Grok 的連線設定檔(來源選「OpenAI Compatible」,填入 Grok 的 API 金鑰和端點)
開啟 Tracker 設定頁面,找到「覆寫用於追蹤器生成的連線設定檔」
從下拉選單選擇你的 Grok 連線設定檔
(建議)在「覆寫補全預設詞」也選一個低 Temperature 預設(如 Precise),讓輸出更穩定
追蹤器介面
點擊訊息旁的 </> 按鈕,可開啟浮動的追蹤器視窗。
檢視模式
以分層結構顯示所有欄位和值。無法編輯。
編輯模式
可以直接修改追蹤器中的任何欄位值。注意:
- 不允許使用雙引號(
"),會自動替換為單引號 - 點選「移除」可刪除陣列中的項目
- 點選「新增項目」可在陣列中加入新項目
- 點選「新增鍵值」可在物件類型欄位中加入新鍵
- 修改後自動儲存(即時更新)
提詞製作工具
在設定頁面點選「開啟提詞製作工具」,可視覺化地管理所有追蹤欄位。
工具按鈕說明
| 按鈕 | 功能 |
|---|---|
新增欄位 |
在頂層新增一個欄位 |
新增範例值 |
為所有欄位同時新增一組範例值 |
移除範例值 |
移除所有欄位的最後一組範例值 |
新增巢狀欄位 |
在該欄位下新增子欄位(需為物件類型) |
移除欄位 |
刪除該欄位(會跳出確認提示) |
每個欄位的屬性
| 屬性 | 說明 |
|---|---|
| 欄位名稱 | 欄位的 key(不可含雙引號)。AI 用這個名稱識別欄位 |
| 存在方式 | 動態 / 臨時 / 靜態(見下方詳細說明) |
| 欄位類型 | 資料的結構類型(見下方詳細說明) |
| 提詞或備注 | 告訴 AI 如何填寫這個欄位的指示 |
| 預設值 | 欄位的預設佔位值描述 |
| 範例值 | 提供給 AI 參考的範例,幫助 AI 理解格式 |
欄位類型說明
範例值:
09:15:30; 10/16/2024 (Wednesday)
範例:在場人物列表
["Emma", "James", "Sophia"]
範例:一個角色同時記錄髮型、妝容、服裝。
範例:Characters 欄位,每位角色都有 Hair / Makeup / Outfit 子欄位。
範例:每位角色的過去台詞清單。
範例:Topics 欄位,每個主題都有多個子屬性。
存在方式說明
「存在方式」決定欄位在何種情況下被更新:
| 方式 | 說明 | 適用場景 |
|---|---|---|
| 動態 | 每次都會根據最新訊息重新生成/更新 | 時間、地點、天氣、姿勢、服裝狀態等隨時可能變化的欄位 |
| 臨時 | 只在有明確變化時更新,否則留空 | 偶爾才會出現的動作或事件 |
| 靜態 | 預設不更新,除非手動指定重新生成 | 通常不會改變的固有特徵(如角色的基本體型、髮色等) |
新增自訂欄位
以下是一個實際範例:新增一個「情緒」(Mood)欄位來追蹤角色目前的心情。
在設定頁面點選「開啟提詞製作工具」
點選底部的「新增欄位」按鈕
填寫欄位屬性:
| 欄位名稱 | Mood(英文,AI 識別用) |
| 存在方式 | 動態 |
| 欄位類型 | 字串 |
| 提詞或備注 | Describe the character's current emotional state in one or two words.
|
| 預設值 | <Current mood> |
(選用)點選「新增範例值」並填入 Nervous、Excited、Calm
設定會自動儲存。下次 AI 生成時就會追蹤此欄位
Mood、Temperature),因為 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 更好理解格式:
| 欄位 | 範例值 |
|---|---|
| 好感度 | 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 的主要回覆中,出現在回覆最前面。
- ✅ 不消耗額外 API 請求
- ✅ 設定最簡單
- ❌ 佔用主要回覆的 token 上限
- ❌ AI 可能在文章中混入追蹤資料
Single Stage(單階段)
對追蹤器進行一次獨立的 API 呼叫,不影響主要回覆。
- ✅ 追蹤資料不佔用主要 token
- ✅ 品質穩定
- ❌ 額外一次 API 呼叫(速度稍慢)
Two Stage(兩階段)
先用第一次呼叫「摘要」最新訊息的變化,再用第二次呼叫「更新」追蹤器。
- ✅ 追蹤最精準,適合複雜場景
- ✅ 減少 AI 遺漏細節的機率
- ❌ 需要兩次額外 API 呼叫(最慢)
常見問題
追蹤器沒有自動生成?
請確認:
- 設定頁面的「啟用」是否有開啟
- 「生成目標」是否正確設定(User / Character / Both)
- 「最小深度」設定不要太大(設為 0 即可立即開始追蹤)
AI 生成的追蹤器內容不準確?
- 嘗試在「提詞或備注」欄位加入更明確的指示
- 增加「範例值」幫助 AI 理解格式
- 改用 Two Stage 模式以提高精準度
- 增加「訊息數量」設定,讓 AI 參考更多上下文
如何刪除或重置追蹤器?
在編輯模式下手動清空欄位,或在追蹤器面板中點選「重新生成」讓 AI 重新建立。
欄位名稱可以用中文嗎?
技術上可以,但不建議。AI 用英文 key 識別欄位,中文 key 可能導致 AI 在結構化輸出時出錯。建議 key 用英文,提詞內容可以用中文。
如何完全重置為預設設定?
在設定頁面的「預設組合」下拉選單選擇 Default-SingleStage,然後點選「載入」,即可恢復預設欄位定義和提詞。
Tracker 資料儲存在哪裡?
追蹤器資料儲存在 SillyTavern 的對話 JSON 檔案中,每條訊息都有一個對應的 tracker 物件。備份對話時,Tracker 資料也會一起備份。