01
idle
待機
沒事時呼吸、眨眼，安靜陪你。
CODEX DESKTOP 自訂動態寵物教學
把你的角色圖，
孵成會動的桌面夥伴。
不用自己切 88 格、不用背規格。準備一張角色圖，告訴 Codex 你想保留的特色，就能得到可安裝的九種完整動畫。
✓ v2 規格✓ 9 種狀態✓ 自動 QA✓ 可直接安裝
✦
●
little-yoyo / running
Codex 正在工作，小 YOYO 也開工
先懂一件事
只要一張角色圖，
加上一個技能包。
臉型、身體比例、服裝、主色、眼鏡、髮型與配件，都是角色辨識度。告訴 Codex 哪些特色一定要保留，它就會依照技能規格，替角色製作每一種動作。
01 · 角色原圖
✦HATCH!→
02 · 動態寵物
給學員直接用
一段就夠的
自訂寵物指令
附上自己的角色圖；如果有特別想要的動作，再多附一張參考圖。把寵物名稱填好，整段貼給 Codex。
💡 這是通用版，不會把學員的寵物做成小 YOYO。
給 Codex 的訊息通用短版
請使用 hatch-pet 技能，把我附上的角色圖製作成可安裝到 Codex Desktop 的 v2 自訂動態寵物。請保持角色的臉型、比例、服裝、配色與配件一致，完成九種標準動畫狀態；工作中（running）請依我附的動作參考製作。最後輸出 pet.json、spritesheet.webp、九種預覽動畫、驗證結果與安裝說明。寵物名稱：＿＿＿＿。若找不到 hatch-pet，請先檢查本機技能或協助安裝。
完整流程
四站孵化路線
Codex 會自己讀技能規格、生成動畫、拼成 spritesheet，再做安裝前檢查。你負責看角色像不像、動作喜不喜歡。
🧰
要先告訴 Codex 技能在哪裡嗎？
通常不用。直接說「使用 hatch-pet 技能」即可，Codex 會從已安裝技能清單尋找。不同版本或電腦不保證都預裝，所以指令最後保留「若找不到，請檢查或協助安裝」最穩妥。
v2 標準配備
九種樣貌，
每一種都可以自訂。
狀態的「用途」固定，角色在那個狀態做什麼可以改。例如工作中不一定要跑步，也可以像小 YOYO 一樣坐下來打電腦。
02
runLeft
向左移動
寵物沿著畫面往左跑。
03
runRight
向右移動
寵物沿著畫面往右跑。
04
waving招手
自然舉手打招呼，別遮到臉。
05
jumping
跳躍
收到好消息時，輕快跳一下。
06
failed
失敗
任務失敗時的小沮喪。
07
waiting
等待
正在等工具、授權或回覆。
08
running工作中
主工作狀態；小 YOYO 會打電腦。
想讓寵物工作時打電腦，就設計在這一列。09
review
等你確認
完成一段工作，請你回來看看。
動作怎麼被控制？
不是寵物猜心情，
是 Codex Desktop 發出狀態。
1主聊天狀態工作、等待、完成或失敗
→
2選擇動畫列例如 running / waiting
→
3播放你的畫面打電腦、眨眼、招手……
主聊天正在工作
會播放 running
所以把打電腦畫在 running，主工作運行時就會看到它敲鍵盤。
工作交給子代理
不一定持續顯示工作中
子代理在背景忙時，主聊天可能只被判定為等待或閒置，因此回到 waiting 或 idle。這不是動畫漏做。
語音小插曲
為什麼一開語音，
寵物變成一顆球？
完整的語音對話模式使用一套獨立的即時語音介面，會暫時以語音球取代寵物。這不是九種寵物狀態之一，所以目前不能在 pet.json 裡把球換回寵物。
想說話又想留著寵物？
使用「語音輸入／聽寫」把話轉成文字，不要進入完整語音對話模式。
使用「語音輸入／聽寫」把話轉成文字，不要進入完整語音對話模式。
最後一分鐘
在 Codex 裡打開新朋友
1
打開 Pets 設定
在 Codex Desktop 開啟 Settings → Pets。
2
找到你的新寵物
在寵物清單找到剛完成的名稱；如果還沒出現，重新整理一次。
3
按下「選擇」
按鈕顯示「已選取」就完成了。關閉設定後，寵物會出現在 Codex。
交作業前
可愛也要通過
五項 QA
- ✓角色沒有走樣臉型、比例、服裝、顏色與配件一致
- ✓九列全部能動不是只有一張靜態圖，也沒有缺列
- ✓動作不互相穿模手不遮眼鏡、電腦不切到臉、腳底不漂移
- ✓透明背景乾淨角色周圍沒有白邊、色塊或殘影
- ✓v2 規格驗證通過pet.json、尺寸、列數與方向語意都正確
FAQ
孵化途中，大家最常問
九種狀態可以改嗎？ ＋
可以改「演出內容」，不能任意改狀態鍵值。例如 running 仍代表主工作中，但畫面可以是跑步、打字、畫圖或看書。
為什麼思考時沒有打電腦？ ＋
先確認打電腦是否放在 running。如果工作被交給子代理，主聊天可能轉成等待或閒置，因此不一定持續播放 running。
語音狀態一定會變球嗎？ ＋
完整語音模式目前會使用獨立語音球，pet.json 不能覆寫。改用語音輸入／聽寫，可以說話輸入又保留寵物。
寵物完成後，要去哪裡開啟？ ＋
開啟 Codex Desktop 的 Settings → Pets，在清單找到新寵物，點選並開啟顯示即可。檔案安裝會由 Codex 代為完成。
舊寵物或舊動畫還在怎麼辦？ ＋
刪除或移走舊的寵物資料夾，確認新檔案已覆蓋，然後重新啟動或重新整理 Codex Desktop，避免仍讀到快取。
要把技能路徑寫進指令嗎？ ＋
通常不需要。直接點名 hatch-pet 即可；為了兼容不同版本，在句尾加上「若找不到請檢查或協助安裝」就很完整。
YOUR OWN PET
下一隻，換你的角色登場。
準備一張清楚的角色圖，填好寵物名稱，把通用指令貼給 Codex。
本教學由 一百分遊戲教育 Work shop 製作把遊戲和科技，
把遊戲和科技，
放進真正的教學現場。
我們設計實境解謎工作坊、桌遊式課程，也把老師與自學者真正用得上的 AI 工具整理成簡單、好玩的實戰教學。
實境解謎桌遊課程AI 工具實戰
到粉專看課程、免費教學與學員作品 ↗