讓貓咪跟著你的鍵盤、鼠標(biāo)和手柄一起動(dòng)BongoCat 桌面寵物上手指南【免費(fèi)下載鏈接】BongoCat 跨平臺(tái)互動(dòng)桌寵 BongoCat為桌面增添樂趣項(xiàng)目地址: https://gitcode.com/gh_mirrors/bong/BongoCatBongoCat 是一款跨平臺(tái)的互動(dòng)桌寵它常駐在桌面上實(shí)時(shí)接收你的鍵盤、鼠標(biāo)或游戲手柄輸入并同步做出敲擊、彈跳等動(dòng)作。項(xiàng)目基于 Tauri 框架開發(fā)支持 macOS、Windows 和 Linuxx11完全開源、離線運(yùn)行不收集任何用戶數(shù)據(jù)。如果你長(zhǎng)時(shí)間面對(duì)屏幕想讓打字和打游戲的過程多一點(diǎn)視覺反饋它就是一個(gè)低門檻、可定制的起點(diǎn)。第一次使用前先確認(rèn)三件事桌寵不響應(yīng)輸入90% 的情況出在這三步之外動(dòng)手前先花一分鐘核對(duì)你的輸入方式是什么。BongoCat 按輸入源區(qū)分模型鍵盤、手柄各有專屬內(nèi)置模型先確定你主要用哪種方式操作電腦再選對(duì)應(yīng)模型后面的行為配置才有意義。系統(tǒng)權(quán)限是否給到位。macOS 需要「輸入監(jiān)控」權(quán)限Windows 需要以管理員身份運(yùn)行缺少授權(quán)時(shí)應(yīng)用根本收不到鍵盤事件貓咪會(huì)一動(dòng)不動(dòng)。輸入設(shè)備是否可用。手柄模式要確認(rèn)設(shè)備已被系統(tǒng)識(shí)別鍵盤模式則確認(rèn)驅(qū)動(dòng)正常。設(shè)備連不上后面所有映射都是空談?？焖匍_始最短路徑跑起來獲取應(yīng)用。從項(xiàng)目 Releases 下載對(duì)應(yīng)平臺(tái)的安裝包Windows / macOS / Linux解壓或安裝后直接啟動(dòng)如果你打算自己編譯運(yùn)行可克隆倉(cāng)庫(kù)https://gitcode.com/gh_mirrors/bong/BongoCat構(gòu)建需要 Node.js 與 Rust/Tauri 工具鏈具體以項(xiàng)目文檔為準(zhǔn)。啟動(dòng)并授權(quán)。首次打開設(shè)置窗口后按系統(tǒng)提示授權(quán)macOS 會(huì)彈窗引導(dǎo)去「系統(tǒng)設(shè)置 → 隱私與安全性 → 輸入監(jiān)控」添加 BongoCatWindows 若未以管理員身份運(yùn)行會(huì)提示退出后用管理員權(quán)限重新啟動(dòng)。驗(yàn)證結(jié)果。授權(quán)后回到桌面敲幾下鍵盤——默認(rèn)模型下的貓爪應(yīng)該立刻落下并抬起。動(dòng)作出現(xiàn)說明輸入鏈路已經(jīng)通了。如果這一步失敗直接跳到文末的快速排錯(cuò)表。按你的輸入方式選擇配置路徑BongoCat 的三套內(nèi)置模型分別放在src-tauri/assets/models/的 keyboard、gamepad、standard 子目錄中對(duì)應(yīng)不同的動(dòng)作設(shè)計(jì)。在「設(shè)置 → 模型」頁(yè)點(diǎn)擊縮略圖即可切換當(dāng)前生效的模型會(huì)顯示對(duì)勾。鍵盤模式打字時(shí)的默認(rèn)選擇選鍵盤模型后你按下的鍵會(huì)映射為貓爪敲擊動(dòng)作。想精細(xì)控制哪些鍵觸發(fā)哪些動(dòng)作可以打開模型頁(yè)的行為編輯器模型卡片上的表情圖標(biāo)入口逐條調(diào)整按鍵與動(dòng)畫的對(duì)應(yīng)關(guān)系保存后立即生效。適合寫代碼、寫文檔等以鍵盤為主的工作流。手柄模式游戲和直播的加分項(xiàng)手柄模型把按鍵和扳機(jī)映射成貓的動(dòng)作。注意手柄輸入本身不需要額外驅(qū)動(dòng)授權(quán)但前提有兩個(gè)——設(shè)備已被系統(tǒng)識(shí)別并且你當(dāng)前切換到了手柄模型。映射同樣在行為編輯器里逐條配置改完用真實(shí)按鍵驗(yàn)證一遍確認(rèn)沒有按錯(cuò)鍵位。鼠標(biāo)響應(yīng)可以開也可以完全關(guān)掉「模型」設(shè)置里有兩個(gè)與鼠標(biāo)相關(guān)的開關(guān)一個(gè)控制貓咪是否跟隨鼠標(biāo)動(dòng)作做出鏡像動(dòng)作另一個(gè)可以直接忽略鼠標(biāo)輸入。如果你只想讓貓咪響應(yīng)鍵盤或手柄把鼠標(biāo)忽略打開最干凈開啟鏡像則適合想讓貓對(duì)鼠標(biāo)移動(dòng)也有反饋的場(chǎng)景。個(gè)性化外觀與資源替換導(dǎo)入你自己的 Live2D 模型Live2D 模型是帶動(dòng)畫的 2D 角色資源包本質(zhì)是一組貼圖、動(dòng)作和配置文件的集合。導(dǎo)入路徑在「設(shè)置 → 模型」頁(yè)瀑布流最上方是上傳卡片選擇你的模型目錄完成導(dǎo)入后它會(huì)以縮略圖卡片出現(xiàn)在列表里點(diǎn)擊即切換卡片上的文件夾圖標(biāo)可以直接在文件管理器中打開模型目錄刪除按鈕僅對(duì)非內(nèi)置模型可用。內(nèi)置模型有固定的封面和貼圖文件如各模型目錄下的resources/cover.png自定義模型按相同結(jié)構(gòu)組織即可被正確識(shí)別。窗口顯示參數(shù)「設(shè)置 → 貓咪」頁(yè)集中管理顯示相關(guān)項(xiàng)每一項(xiàng)都對(duì)應(yīng)可感知的效果鏡像 / 鼠標(biāo)鏡像調(diào)整動(dòng)作方向讓貓的動(dòng)作與你的習(xí)慣一致。動(dòng)作音效敲擊時(shí)是否發(fā)聲。窗口大小1% 到 500% 的縮放多屏大桌面可以放大到 200% 以上。透明度10% 到 100%調(diào)低后貓咪不擋視覺焦點(diǎn)。點(diǎn)擊穿透開啟后窗口不再攔截鼠標(biāo)點(diǎn)擊適合把貓咪放在常用區(qū)域。始終置頂 / 保持在屏幕內(nèi)控制層級(jí)與邊界行為避免拖出屏幕找不到。懸停隱藏鼠標(biāo)懸停指定秒數(shù)后自動(dòng)隱藏讓路給正常操作。平臺(tái)差異與系統(tǒng)設(shè)置平臺(tái)授權(quán)方式生效條件macOS「系統(tǒng)設(shè)置 → 隱私與安全性 → 輸入監(jiān)控」中添加 BongoCat授權(quán)后重啟應(yīng)用Windows以管理員身份運(yùn)行啟動(dòng)時(shí)即以管理員身份運(yùn)行Linux需 x11 會(huì)話環(huán)境啟動(dòng)后直接驗(yàn)證macOS 的細(xì)節(jié)如果之前授權(quán)過舊版本先在輸入監(jiān)控列表中移除 BongoCat 再重新添加然后重啟應(yīng)用權(quán)限才正式生效設(shè)置窗口內(nèi)會(huì)顯示當(dāng)前授權(quán)狀態(tài)。Windows 的細(xì)節(jié)普通用戶身份啟動(dòng)時(shí)應(yīng)用收不到全局鍵盤事件必須重新以管理員身份啟動(dòng)Linux 目前適配 x11 桌面環(huán)境Wayland 等環(huán)境的可用性以項(xiàng)目實(shí)際支持為準(zhǔn)。體驗(yàn)優(yōu)化與性能控制控制幀率上限?！肛堖洹乖O(shè)置里的最大幀率默認(rèn) 60低配機(jī)器可以下調(diào)到 30 左右動(dòng)作流暢度幾乎不受影響渲染開銷明顯下降。按鍵自動(dòng)松開。Windows 下的自動(dòng)松開延遲秒用于兜底極端情況下按鍵事件沒被正確釋放時(shí)貓咪動(dòng)作會(huì)卡在半空調(diào)大這個(gè)值能讓它按時(shí)復(fù)位。多屏布局。直接拖拽貓咪窗口到副屏配合「保持在屏幕內(nèi)」開關(guān)防止越界副屏分辨率較低時(shí)把窗口縮放到 50%~100% 比較穩(wěn)妥。資源占用過高時(shí)。依次嘗試降幀率、換貼圖更簡(jiǎn)單的模型、開啟懸停隱藏必要時(shí)重啟應(yīng)用釋放內(nèi)存?？焖倥佩e(cuò)現(xiàn)象優(yōu)先檢查處理動(dòng)作驗(yàn)證方式敲鍵盤貓沒反應(yīng)系統(tǒng)授權(quán)macOS 輸入監(jiān)控 / Windows 管理員按平臺(tái)差異一節(jié)重新授權(quán)重啟應(yīng)用敲擊鍵盤貓爪落下并抬起動(dòng)作有延遲或掉幀最大幀率設(shè)置、系統(tǒng)負(fù)載幀率下調(diào)至 30關(guān)閉后臺(tái)高占用程序連續(xù)快速敲擊觀察動(dòng)作是否連貫動(dòng)作卡住不回位Windows 自動(dòng)松開延遲適當(dāng)調(diào)大該延遲值秒長(zhǎng)按后松開貓咪按時(shí)復(fù)位貓咪擋住點(diǎn)擊操作點(diǎn)擊穿透、懸停隱藏開啟點(diǎn)擊穿透或設(shè)置懸停幾秒后隱藏鼠標(biāo)懸停后點(diǎn)擊貓咪背后的窗口手柄輸入無反應(yīng)設(shè)備識(shí)別、當(dāng)前模型確認(rèn)系統(tǒng)已識(shí)別手柄切換到手柄模型并檢查映射逐個(gè)按鍵確認(rèn)對(duì)應(yīng)動(dòng)作觸發(fā)適合場(chǎng)景與擴(kuò)展建議編程開發(fā)寫代碼、等編譯時(shí)貓咪隨鍵盤敲擊視覺反饋比單純靜音環(huán)境更有節(jié)奏感。直播與錄屏鏡頭前同時(shí)出現(xiàn)貓咪對(duì)按鍵的響應(yīng)觀眾能直觀看到你敲了多少鍵是天然的互動(dòng)元素。手柄游戲手柄模型讓貓咪跟隨游戲輸入動(dòng)作娛樂場(chǎng)景更有陪伴感。學(xué)習(xí)辦公長(zhǎng)時(shí)間伏案時(shí)角落里的桌寵提供低打擾的陪伴。模型社區(qū)分享導(dǎo)入自定義 Live2D 模型后也可以參考上游社區(qū)的模型倉(cāng)庫(kù)交流作品以社區(qū)倉(cāng)庫(kù)實(shí)際內(nèi)容為準(zhǔn)。下一步清單按主要輸入方式選好模型并在行為編輯器里過一遍映射。按機(jī)器性能設(shè)定最大幀率低配建議 30 起步。把透明度與點(diǎn)擊穿透調(diào)到不擋正常工作的程度。替換一個(gè)自己滿意的 Live2D 模型完成個(gè)性化。多屏用戶拖到副屏、調(diào)整縮放確認(rèn)「保持在屏幕內(nèi)」已開啟。遇到不確定的行為優(yōu)先回到「設(shè)置 → 貓咪」逐開關(guān)排查——這個(gè)項(xiàng)目的大部分表現(xiàn)問題都能在權(quán)限和這兩組設(shè)置里找到答案?！久赓M(fèi)下載鏈接】BongoCat 跨平臺(tái)互動(dòng)桌寵 BongoCat為桌面增添樂趣項(xiàng)目地址: https://gitcode.com/gh_mirrors/bong/BongoCat創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考