DesktopST 使用者教學

第一次使用 DesktopST？這份文件帶你跑完所有功能

DesktopST 是一隻會聊天的桌面寵物。角色站在你的桌面上，點一下身體叫出輸入框，他就會用自己的個性回你。多放幾隻在桌面上，他們還會自己互相對話。

這份文件不需要任何程式經驗。整份照順序看下來大約 15 分鐘，就能用熟所有功能。

1. 怎麼跟角色聊天？

角色要能講話，需要先連到一家 AI 服務（OpenAI / Gemini / Grok / Claude 任選）。連線用的是「API Key」，你可以把它想成 AI 公司發的通行證。

申請 API Key。第一次使用建議從 Gemini 開始，因為它最容易用免費額度測試。詳細步驟在另一份文件：API Key 新手申請與省錢測試指南。
把 Key 貼進 DesktopST。滑鼠移到角色身上，點齒輪圖示「共通設定」→ 切到「LLM」分頁 → 選服務商 → 把 Key 貼進對應欄位 → 選一個模型。
確認連線正常。貼完 Key、選完模型後，先按一下「連線」，等旁邊出現綠色 ● 已驗證；再按「測試訊息」，等出現綠色 ● 代表 AI 有回應。兩個都亮綠燈才算設定成功。
點角色身體。輸入視窗會從畫面下方跳出來。
打字、按 Enter（換行用 Shift+Enter）。角色頭上會冒出一個泡泡顯示回應，幾秒後自動消失。

小撇步：「連線」只驗證 Key 格式是否有效，「測試訊息」才會真的花一點點額度打一句 Hello 給 AI——兩個都過才算真的通了，之後再開始長聊比較不會踩坑。

看到 Invalid API key 或 Quota exceeded 不是程式壞了，是 AI 服務那邊的提示。請對照 API Key 教學第 11 節處理。

2. 怎麼移動、縮放、翻轉角色？

移動

直接拖角色身體就可以。桌面上沒有看到視窗邊框是正常的，因為角色背景是透明的——點不到的「空白區域」不是 bug，是程式刻意讓滑鼠穿過去點到下面的東西。

滑鼠移上去會出現的選單

滑鼠停在角色身上，左側會出現三個圓形按鈕：

👤 角色設定

開啟角色庫 / 此角色的角色卡編輯視窗。可以改名字、個性、招呼語、情緒圖等。

↘ 縮放角色

進入縮放模式。可以拖 slider 即時預覽，或直接打數字。按確定才會存檔。

⚙ 共通設定

API Key、世界觀、Persona、介面外觀、資料路徑等全域設定都在這。

另外，角色頭頂會浮現兩個小按鈕：

說點什麼（對話框圖示）：讓這個角色立刻根據目前對話發一句話，不需要使用者開口。
禁言 / 取消禁言（喇叭圖示）：群組對話時這個角色是否會跟著講。被禁言時頭頂圖示變叉叉。

桌面上有兩個以上角色時，還會多出「加入角色」「開啟角色庫」「從桌面移除」三個按鈕。只剩一個角色時，移除按鈕會自動隱藏，避免桌面空無一人。

翻轉

角色想朝另一邊看？右鍵角色→「水平翻轉」。設定會記下來，下次開啟還是翻著的。

關不掉輸入視窗？再點一次角色身體就會收起來。或者按輸入視窗右上角的叉叉。

3. 看對話記錄、調整角色表情

打開對話記錄

點輸入視窗右上角的「對話記錄」圖示，會跳出 Log 視窗，裡面是這次對話的完整歷史。

對訊息可以做什麼？

把滑鼠移到一則訊息上，會出現操作按鈕：

動作	用途
🗑 刪除	把這則訊息從記錄移除（也不會再餵給 AI）。
✏ 編輯	修改訊息文字。同樣會影響後續 AI 看到的上下文。
🔄 重新生成	讓 AI 重講一次最後一句（覺得回得不好用的）。
🎭 換表情	角色訊息可以下拉選表情，立刻在桌面上反映。
🔍 看完整指令	展開 debug 區塊，可看到這次送給 AI 的完整 prompt（角色卡 + 世界觀 + 歷史）。
👆 點訊息本身	把這句話重新顯示在角色頭上的泡泡裡。

調表情有兩種方式

讓 AI 自己決定。AI 回應的第一行會有 [joy] 這種標記，程式會根據這個切到對應的情緒圖。
使用者手動覆蓋。在 Log 視窗對某則訊息的表情下拉換成想要的，桌面角色會立刻換圖。

多組對話

Log 視窗也是對話切換的入口。可以新增對話、重新命名、刪除、切換到舊對話。切換後桌面角色和記憶都會跟著改變，舊對話保留在硬碟裡不會弄丟。

4. 自訂自己的角色

點任何角色身上的「角色設定」按鈕，就會開啟角色卡編輯視窗。也可以從「共通設定」→ 角色庫 → 新增。

角色卡有什麼欄位？

欄位	建議怎麼填
名字	角色的名字。AI 對話中會用這個稱呼自己。
頭像	沒有設定情緒圖時，桌面上會顯示這張。透明背景的 PNG 效果最好。
簡介	短短一兩句，用來在角色庫卡片上顯示，不送 AI。
個性	送 AI 的主要設定。寫得越具體越好（性格、口頭禪、喜好、語氣）。
招呼語	新對話開始時這個角色自動講的第一句話。
對話範例	教 AI「這個角色平常怎麼講話」。寫個 2-3 組來回最有效。
Scenario（進階）	這次對話的場景背景（例如「主角是咖啡店店員，使用者是客人」）。
System Prompt 覆蓋（進階）	留空就用全域世界觀。除非你很清楚在做什麼，否則留空。

角色卡怎麼寫才好用？

第一版先寫短一點。個性 100-300 字就好，先確認 AI 抓得到方向。寫太長有時候反而矛盾，AI 會混亂。
用具體的描述。「溫柔」太抽象，「講話末尾常加『呢～』、被誇獎會害羞地否認」就具體得多。
怕忘的話寫在「對話範例」。AI 很會模仿範例的語氣，比寫一堆形容詞還準。
常見問題：講話太正經、不像角色。通常是因為個性裡只有形容詞、沒有「實際怎麼說話」的範例。

情緒圖片

角色卡的「情緒圖片」分頁有 28 種預設情緒（joy、sadness、anger、surprise 之類）。每種情緒可以上傳一張圖，AI 回應時會自動切換。沒上傳的情緒會 fallback 回頭像。

新手建議：先做 4-5 張就夠用（neutral、joy、sadness、surprise、love）。等用熟了再慢慢補。

怎麼傳圖片進來？

在角色卡的頭像欄位或情緒圖片分頁點上傳按鈕。
從電腦選一張圖（PNG / JPG 都可以）。建議用透明背景 PNG，桌面顯示效果最好。
程式會把圖片複製到 DesktopST 的資料夾，所以原檔搬走也沒關係。

從 SillyTavern 匯入

如果你已經有 SillyTavern 格式的角色卡（JSON 或內嵌資料的 PNG），可以在角色庫直接「匯入 ST 角色卡」。圖片和人格欄位會一起搬過來。

5. 桌面放多個角色 — 群組對話

DesktopST 最有趣的功能之一：桌面上同時放兩個以上角色，他們會自己互相對話。

怎麼放第二個角色到桌面？

滑鼠移到桌面角色身上，點「開啟角色庫首頁」（資料夾圖示）。
角色庫視窗會列出所有角色卡。選一個拖到桌面，或點卡片選「召喚到桌面」。

群組對話怎麼運作？

你送出一句話，未被禁言的角色會依加入桌面的順序輪流回應。
訊息中有提到某個角色的名字（例如 @小明或直接稱呼），那個角色會被優先點名。
一次最多跑 N 輪（預設 3，可在共通設定 → LLM 改）。一輪 = 所有未禁言的角色各說一次（也可能選擇不說）。

讓某個角色暫時閉嘴

滑鼠移到該角色，點頭頂的喇叭圖示就會切換禁言。禁言中的角色不會參與群組對話，但你還是可以單獨點他、強制他發話。

群聊比較花 API 用量。每個角色都是一次獨立的 AI 呼叫，桌面三個角色聊兩輪就是六次呼叫。剛開始建議：兩個角色、一輪、便宜模型。

6. 在對話裡傳圖片 / 截圖

輸入視窗下方有兩個跟圖片相關的按鈕：

🖼 附加圖片

點開檔案選擇器，挑一張或多張圖。也可以直接拖檔案投到輸入框，或在輸入框內按 Ctrl+V 貼上剪貼簿的圖。

📸 截圖

程式會自動隱藏所有視窗、進入框選模式。框完之後截圖會自動附加到訊息。

兩種截圖模式

不含角色：截圖前把 DesktopST 全部視窗藏起來，純截桌面。適合給 AI 看「我電腦螢幕在幹嘛」。
含角色：保留角色在畫面上一起拍。適合做合照、想跟 AI 講「你看你在這裡耶」。

圖片數量上限

單則訊息預設最多 5 張，可在「共通設定 → LLM → 單訊息圖片上限」改。每張圖會被算進輸入 token，圖片很吃額度，新手測試先一張兩張就好。

並不是所有模型都看得到圖。OpenAI 的 4o 系列、Claude 4 系列、Gemini 2/3 系列、Grok 4 系列都支援。如果選了不支援的模型送圖，AI 會回應「我看不到圖」之類的訊息。

7. 便利貼功能

便利貼是貼在桌面上的小紙條，不會送進對話、不影響 AI，純粹當備忘錄。

怎麼新增一張便利貼？

點輸入視窗下方的 📌 便利貼按鈕。
桌面會出現一張黃色小卡，點內容就可以直接打字。
拖邊框可以調大小，拖卡身可以移位置。

便利貼可以做什麼？

調顏色：點便利貼上的顏色點，會跳出選色器。
調字級：個別便利貼可以單獨調字大小，重要的東西字放大。
隱藏 / 還原：先收進管理員，之後再拿出來。資料不會消失。
刪除：右上角叉叉，確認後永久刪除。

便利貼管理員

桌面便利貼貼多了會擋畫面。從 Windows 右下角系統托盤點 DesktopST 圖示 → 「開啟便利貼管理」，可以列出所有便利貼（包含隱藏的），統一管理。

8. 提醒功能

讓角色在指定時間或頻率主動跳出來說話，像個會說話的鬧鐘。

怎麼新增提醒？

點輸入視窗下方的 ⏰ 提醒按鈕，或從系統托盤點「管理提醒」。
填提醒名稱（例如「喝水」、「該休息了」）。
選由哪個角色說話。也可以選「隨機桌面角色」，由當下桌面上未禁言的角色之一講。
選觸發時機（看下面四種）。
選填「自訂指令」。例如填「叫我去喝水，要可愛一點」，AI 就會用這段指示生成符合角色個性的台詞。留空的話會用提醒名稱當指令。
儲存。回到列表，左邊的勾勾可以快速啟用 / 停用。

四種觸發時機

類型	什麼時候會觸發	適合用來
每次啟動	程式開啟後幾秒。	早安問候、開機後的小提醒。
每天	每天的指定時間（例如 12:00）。	午餐、午睡、下班鈴。
每隔幾分鐘	固定間隔（最少 5 分鐘）。	喝水、伸展、休息眼睛。
一次性	指定的某天某時某分一次。	會議、約會、生日。

提醒會吃 API。每次觸發都是一次 AI 呼叫（要生成符合角色個性的台詞）。設「每 5 分鐘」一整天就會跑很多次，請斟酌。

進階小技巧：如果你用便利貼記了當天的待辦事項，提醒觸發時 AI 會看到這些便利貼內容（在共通設定打開「注入便利貼」），就會自動把待辦項目融進台詞裡。

9. 讓 AI 知道「使用者是誰」 — Persona 與世界觀

很多時候角色講話不對勁，不是角色卡有問題，而是 AI不知道你是誰，也不知道你們處在什麼世界。這兩件事在共通設定的「使用者」和「世界觀」分頁裡。

使用者 Persona

顯示名稱：你希望角色叫你什麼名字。
暱稱：例如「主人」「老闆」「同學」。可以跟名字不同。
自我介紹：你的背景設定。例如「我是一名軟體工程師」「我目前是高中生」。AI 會根據這個調整對話內容。

世界觀

世界觀：故事背景。例如「現代日常」「奇幻冒險」「賽博龐克城市」。
角色互動範例：跨角色的互動風格，例如「角色之間彼此認識，會互相吐槽」。

多組預設可切換

Persona 和世界觀都支援多組預設。可以為不同情境準備不同設定（例如「工作模式」用比較專業的 persona，「放鬆模式」用閒聊的）。下拉選單切換即可，舊的不會被覆蓋。

新手建議：第一次什麼都不改，用內建的泛用預設先玩。等到發現「角色叫我的方式不對」「世界觀感覺很尷尬」再回來調整。

10. 介面外觀 — 配色與字級

共通設定 → 介面分頁裡有兩個外觀調整：

色彩主題（9 種）

mint（薄荷綠，預設）、butter（奶油黃）、peach（蜜桃）、aqua（水藍）、sky（天空藍）、blush（粉紅）、lavender（薰衣草紫）、white（純白）、dark（深色）。

這是介面的配色，不影響角色本身。

字型大小

從 xs 到 xl 五段。對話框、Log 視窗、設定面板的文字會同步放大或縮小。

其他介面選項

未聚焦泡泡透明度：當你沒在跟角色互動時，他頭上的泡泡會變多淡。設 0 就完全隱形。
滑鼠移到角色才顯示選單：關掉之後選單會一直浮著。常用建議開著。
角色保持在最上層：托盤右鍵可以快速切換。寫文章時角色擋畫面，可以暫時關掉。

12. 資料存哪裡？備份與換電腦

你的資料在這裡

所有角色、對話、設定、便利貼預設都存在：

%APPDATA%\DesktopST\

在 Windows 檔案總管的網址列貼上這串就會直接打開。或者從「共通設定 → 資料 → 開啟資料夾」按鈕也可以。

裡面有什麼？

資料夾 / 檔案	內容
`settings.json`	全域設定（含加密過的 API Key）
`characters\`	所有角色卡與情緒圖
`conversations\`	所有對話歷史
`personas\`	使用者 Persona 預設組
`worlds\`	世界觀預設組
`pinned-notes.json`	便利貼
`reminders.json`	提醒

備份

最簡單的備份：把整個 %APPDATA%\DesktopST\ 資料夾複製一份到雲端 / 隨身碟。要還原時整包蓋回去即可。

或從「共通設定 → 資料 → 備份」匯出整包 ZIP。

換電腦時要注意

API Key 不能直接搬。DesktopST 用 Windows 內建的 DPAPI 加密 Key，這個加密綁在你目前的 Windows 使用者帳號。整份資料搬到新電腦後，API Key 會解不開——必須打開設定重新貼一次。

除了 API Key，其他角色、對話、設定、便利貼都可以原樣搬遷。

解除安裝會不會刪資料？

不會。DesktopST 解除安裝只會移除程式本體，%APPDATA%\DesktopST\ 裡面的資料保留。要徹底清空請手動刪那個資料夾。

13. 找不到視窗？看右下角系統托盤

DesktopST 的視窗都可以關掉，但程式還在背景跑。找不到時看 Windows右下角系統托盤（時鐘旁邊那排小圖示），DesktopST 的圖示就在那。

左鍵點托盤圖示

切換輸入視窗的顯示。最常用的「我要打字但輸入視窗不見了」就靠這個。

右鍵點托盤圖示

跳出選單，可以：

收起 / 重新開啟所有輔助視窗（角色保留在桌面上）
開啟輸入視窗
開啟便利貼管理
管理提醒
切換角色是否保持在最上層
開啟共通設定
結束程式

14. 進階：當預設功能不夠用時

DesktopST 程式碼公開、可閱讀與修改（採作者自訂授權條款，非 MIT／非標準 CC），這代表只要你願意花一點時間，幾乎所有功能都能改成自己想要的樣子。下面是三個常見情境的處理方式：

我想要 XX 功能，但這程式沒有

從 DesktopST 的 GitHub repo 把原始碼下載下來。然後用會寫程式的 AI 助手（Claude、ChatGPT、Cursor、Claude Code 都可以），把你的需求說清楚請他幫你改。例如：「幫我新增一個讓角色講話時搖晃的動畫效果」。

因為這個專案的程式碼有完整的 CLAUDE.md 和規格書，AI 助手讀完就大致能上手，比從零開始的程式好改很多。

改完之後用 npm install 裝套件、npm run build 打包出新的 .exe。

我不會畫圖，想用自己的角色圖怎麼辦？

三個方向，依預算和需求挑：

請 AI 幫你畫：用 ChatGPT 的 DALL·E、Gemini 的 Imagen、Midjourney、Stable Diffusion 等都可以。生出來通常還要做一點修圖（去背、裁切、調表情），可以用 Photopea（免費網頁版 Photoshop）或 GIMP。
用現成素材：到 SillyTavern 的角色卡分享網站找喜歡的，直接匯入 PNG 即可使用。
付錢委託繪師：在 Twitter / X、Pixiv、Skeb 等平台都可以找接案的繪師。建議跟對方確認「商用 / 非商用」「可改作 / 不可改作」這幾件事。

圖片格式建議：透明背景 PNG、長寬比 1:1 或接近正方形、解析度 512×512 起跳。28 種情緒可以分批做，先做 5 種最常用的（neutral、joy、sadness、surprise、love）就夠用很久。

角色講話一直不符合我的期望怎麼辦？

照下面順序排查，通常前兩步就能解決：

看完整指令。Log 視窗對某則回應點「看完整指令」，會展開實際送給 AI 的 prompt。看看是不是有哪段設定矛盾、或者根本沒注入到。
調整角色卡。常見問題：個性太抽象（多寫具體行為）、對話範例太少（補幾組來回）、招呼語跟個性不一致。
調整 Persona / 世界觀。角色不知道你是誰、處在什麼背景，講話自然會卡。回到第 9 章把 persona 補完。
換模型試試。Gemini Flash 系列很省錢但個性表現相對平淡；Claude Sonnet / GPT-4o / Grok 4 對角色扮演的細膩度普遍更好。
最後手段：改系統指令。如果上面都試過還不行，下載原始碼，找到 src/main/llm/ 裡的 prompt 組裝邏輯，請 AI 助手幫你調整 system prompt 的寫法。這需要一點程式背景，但 AI 助手能幫上大忙。

15. 快速操作對照表

想做什麼	怎麼做
叫出輸入視窗	點角色身體、或左鍵點托盤圖示
關掉輸入視窗	再點一次角色、或按輸入視窗叉叉
送訊息	Enter
輸入框換行	Shift+Enter
移動角色	直接拖角色身體
縮放角色	滑鼠移到角色 → 點縮放圖示
翻轉角色	右鍵角色 → 水平翻轉
禁言 / 取消禁言	滑鼠移到角色 → 頭頂的喇叭圖示
強制角色說話	滑鼠移到角色 → 頭頂的對話框圖示
打開對話記錄	輸入視窗右上角的記錄圖示
新增便利貼	輸入視窗下方的 📌 按鈕
新增提醒	輸入視窗下方的 ⏰ 按鈕，或托盤 → 管理提醒
新增角色	滑鼠移到角色 → 角色設定 → 新增
打開全域設定	滑鼠移到角色 → 齒輪圖示，或托盤 → 開啟設定
找不到視窗	右下角系統托盤點 DesktopST 圖示