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