AI 桌寵自制工坊使用教程從上傳角色到打包運行全程零代碼快速開始十分鐘做一個桌寵啟動 Web 工作室在web目錄執行node scripts/serve.mjs瀏覽器打開http://localhost:4173角色Web 工作室「角色」面板 → 上傳一張 PNG透明背景最佳→ 預覽里立刻動起來行為在「行為」面板加一條規則如點擊 → 播放開心動畫 說一句話人格填名字、角色設定、說話風格聲音可選勾選 TTS 朗讀回復選一個音色模型先用「演示模式」跑通鏈路無需 Key要用真 AI切到 DeepSeek / OpenAI 等并填 API Key導出右上角「導出項目 JSON」→ 得到.companion.json8.運行雙擊AI Companion-0.1.0.exe→ 聊天窗「導入項目」選擇剛才的 JSON。完成后寵物會出現在屏幕底部能走動、被點擊、被拖拽、和你聊天。## Web 工作室各模塊說明頂部可切換三種形態 桌寵純桌寵無 AI/ AI 伴侶聊天記憶主動關心/ AI 代理工具自動化Beta。左側是創建步驟右側是配置面板角色 / 人格 / 模型 / 聲音 / 記憶 / 參數 / 行為 / 打包角色上傳 PNG / JPG / WebP / GIF「角色大小」滑桿調節高度未上傳用內置演示小貓行為每條規則 觸發條件 動作列表如點擊 → 播放 happy 動畫 說好開心人格名字 / 角色設定 / 關系 / 說話風格 性格滑桿親密度、幽默、活力、嚴肅、好奇記憶對話記憶上下文輪數 1–50、事實提取、關系記憶參數角色大小、自動去背景、角色數量、鼠標感應、自動散步開關、散步速度 / 間隔、臺詞與開場白。## 桌面運行端使用| 操作 | 效果 || — | — || 單擊寵物 | 開心動畫 臺詞 配音 || 拖動寵物 | 移到任意位置松手停在那 || 鼠標懸停 | 寵物歪頭看你 || 待機 | 自動散步可在參數關閉、隨機閑聊 |- 寵物窗口是全屏透明覆蓋層只有寵物本身可交互其余區域鼠標穿透不擋操作聊天窗默認折疊成小圓球小火箭可拖動松手吸附屏幕左 / 右邊緣-托盤菜單回到屏幕底部 / 退出導入新配置聊天窗 → 導入 → 選.companion.json寵物即時更新無需重新打包- 用戶數據在%APPDATA%\companion-runtime\。語音設置語音輸入你說它聽點擊說話 / 按住說話 / 快捷鍵默認AltSpaceWeb 端走瀏覽器云端識別桌面端走本地 Whisper離線語音輸出它念給你聽勾選「TTS 朗讀回復」選音色調語速 / 音調自定義配音片段選時機打招呼 / 點擊 / 拖動 / 說話→ 上傳音頻MP3/WAV/OGG/M4A/WEBM≤8MB內嵌進項目包離線播放。## 知識庫 / 任務 / 提醒知識庫上傳 TXT / Markdown 文本資料或直接粘貼文本聊天時寵物始終參考這些資料回答資料沒有的再用常識可暫停 / 刪除單條任務提取點「提取計劃」從資料中識別帶日期的事項如「明天交報告」「周一開會」勾選確認后加入計劃列表可標記完成 / 刪除每日提醒結合日程在程序啟動后約 8 秒、每 30 分鐘、以及電腦喚醒時檢查并提醒當天事項一次最多 5 條遵守勿擾 / 冷卻 / 每日上限。模型配置演示模式無需 Key返回固定演示回復用于跑通「發送 → 流式氣泡 → 朗讀」鏈路真實模型BYOK提供者 DeepSeek / OpenAI / 兼容端點 / Ollama / LM Studio填 Base URL、模型名、API KeyKey 本機加密保存導出項目時可一鍵清理替換為[已清理]- 可調參數溫度、最大輸出 tokens、備用模型列表。打包與發布導出項目 JSON右上角「導出項目 JSON」→.companion.json勾選「導出清理敏感信息」會清空 API Key / 令牌分享安全兩種運行方式 - 導入運行雙擊 exe → 導入.companion.json無需重新打包適合調試 - 打進 exe在companion-runtime目錄執行node scripts/publish.mjs 路徑/xxx.companion.json生成攜帶該項目的AI Companion-0.1.0.exe。## 常見問題 FAQ精選寵物不動 / 不散步在「參數」面板確認「自動散步」已勾選點擊寵物沒反應確認點在了寵物本體上寵物以外區域是穿透的一直固定回復說明當前是「演示模式mock」到「模型」面板切真實提供者并填 API Key語音識別聽不到 / 網絡錯誤Web 端依賴瀏覽器云端服務網絡波動會時好時壞桌面端請確認本地 Whisper 模型已就緒為什么寵物不記得我說過的話「事實提取」「關系記憶」默認關閉需在「記憶」面板打開「對話記憶」只保留當前會話換臺電腦還能用嗎能。.companion.json自帶資源和配置但 API Key 會被清理需在新機器上重新填入。 適用版本V1.0 Beta · Windows 10/11。當前 Beta 已知限制視覺感知、情景記憶、聲音克隆為規劃中多顯示器僅漫游主屏長時間運行穩定性仍在驗證中。本文根據《AI 桌寵自制工坊》使用說明書整理截圖來自 Web 工作室實際界面。 AI 桌寵自制工坊使用教程：從上傳角色到打包運行，全程零代碼
AI 桌寵自制工坊使用教程從上傳角色到打包運行全程零代碼快速開始十分鐘做一個桌寵啟動 Web 工作室在web目錄執行node scripts/serve.mjs瀏覽器打開http://localhost:4173角色Web 工作室「角色」面板 → 上傳一張 PNG透明背景最佳→ 預覽里立刻動起來行為在「行為」面板加一條規則如點擊 → 播放開心動畫 說一句話人格填名字、角色設定、說話風格聲音可選勾選 TTS 朗讀回復選一個音色模型先用「演示模式」跑通鏈路無需 Key要用真 AI切到 DeepSeek / OpenAI 等并填 API Key導出右上角「導出項目 JSON」→ 得到.companion.json8.運行雙擊AI Companion-0.1.0.exe→ 聊天窗「導入項目」選擇剛才的 JSON。完成后寵物會出現在屏幕底部能走動、被點擊、被拖拽、和你聊天。## Web 工作室各模塊說明頂部可切換三種形態 桌寵純桌寵無 AI/ AI 伴侶聊天記憶主動關心/ AI 代理工具自動化Beta。左側是創建步驟右側是配置面板角色 / 人格 / 模型 / 聲音 / 記憶 / 參數 / 行為 / 打包角色上傳 PNG / JPG / WebP / GIF「角色大小」滑桿調節高度未上傳用內置演示小貓行為每條規則 觸發條件 動作列表如點擊 → 播放 happy 動畫 說好開心人格名字 / 角色設定 / 關系 / 說話風格 性格滑桿親密度、幽默、活力、嚴肅、好奇記憶對話記憶上下文輪數 1–50、事實提取、關系記憶參數角色大小、自動去背景、角色數量、鼠標感應、自動散步開關、散步速度 / 間隔、臺詞與開場白。## 桌面運行端使用| 操作 | 效果 || — | — || 單擊寵物 | 開心動畫 臺詞 配音 || 拖動寵物 | 移到任意位置松手停在那 || 鼠標懸停 | 寵物歪頭看你 || 待機 | 自動散步可在參數關閉、隨機閑聊 |- 寵物窗口是全屏透明覆蓋層只有寵物本身可交互其余區域鼠標穿透不擋操作聊天窗默認折疊成小圓球小火箭可拖動松手吸附屏幕左 / 右邊緣-托盤菜單回到屏幕底部 / 退出導入新配置聊天窗 → 導入 → 選.companion.json寵物即時更新無需重新打包- 用戶數據在%APPDATA%\companion-runtime\。語音設置語音輸入你說它聽點擊說話 / 按住說話 / 快捷鍵默認AltSpaceWeb 端走瀏覽器云端識別桌面端走本地 Whisper離線語音輸出它念給你聽勾選「TTS 朗讀回復」選音色調語速 / 音調自定義配音片段選時機打招呼 / 點擊 / 拖動 / 說話→ 上傳音頻MP3/WAV/OGG/M4A/WEBM≤8MB內嵌進項目包離線播放。## 知識庫 / 任務 / 提醒知識庫上傳 TXT / Markdown 文本資料或直接粘貼文本聊天時寵物始終參考這些資料回答資料沒有的再用常識可暫停 / 刪除單條任務提取點「提取計劃」從資料中識別帶日期的事項如「明天交報告」「周一開會」勾選確認后加入計劃列表可標記完成 / 刪除每日提醒結合日程在程序啟動后約 8 秒、每 30 分鐘、以及電腦喚醒時檢查并提醒當天事項一次最多 5 條遵守勿擾 / 冷卻 / 每日上限。模型配置演示模式無需 Key返回固定演示回復用于跑通「發送 → 流式氣泡 → 朗讀」鏈路真實模型BYOK提供者 DeepSeek / OpenAI / 兼容端點 / Ollama / LM Studio填 Base URL、模型名、API KeyKey 本機加密保存導出項目時可一鍵清理替換為[已清理]- 可調參數溫度、最大輸出 tokens、備用模型列表。打包與發布導出項目 JSON右上角「導出項目 JSON」→.companion.json勾選「導出清理敏感信息」會清空 API Key / 令牌分享安全兩種運行方式 - 導入運行雙擊 exe → 導入.companion.json無需重新打包適合調試 - 打進 exe在companion-runtime目錄執行node scripts/publish.mjs 路徑/xxx.companion.json生成攜帶該項目的AI Companion-0.1.0.exe。## 常見問題 FAQ精選寵物不動 / 不散步在「參數」面板確認「自動散步」已勾選點擊寵物沒反應確認點在了寵物本體上寵物以外區域是穿透的一直固定回復說明當前是「演示模式mock」到「模型」面板切真實提供者并填 API Key語音識別聽不到 / 網絡錯誤Web 端依賴瀏覽器云端服務網絡波動會時好時壞桌面端請確認本地 Whisper 模型已就緒為什么寵物不記得我說過的話「事實提取」「關系記憶」默認關閉需在「記憶」面板打開「對話記憶」只保留當前會話換臺電腦還能用嗎能。.companion.json自帶資源和配置但 API Key 會被清理需在新機器上重新填入。 適用版本V1.0 Beta · Windows 10/11。當前 Beta 已知限制視覺感知、情景記憶、聲音克隆為規劃中多顯示器僅漫游主屏長時間運行穩定性仍在驗證中。本文根據《AI 桌寵自制工坊》使用說明書整理截圖來自 Web 工作室實際界面。