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