程式又不聽話？乖乖拜拜怎麼放進你的專案？

電腦旁放一包綠色乖乖，程式乖乖跑、檔案乖乖開，這個願望也能搬進工作檔裡，乖乖拜拜（Kuai Kuai Bye Bye）讓工程師在程式裡放護身註解，設計師把圖檔藏進最底層，動畫師讓它陪著每一個合成。

我做的乖乖拜拜，把這個祈福的小玩笑做成可以下載、安放與撤除的工具，裡面有綠色乖乖圖檔、護身卡，以及幫你放好位置的腳本，也就是能替你執行一小段操作的程式。

我會先在專案副本放一包，讓工作多一點幽默就好，乖乖沒有修復程式、降低當機率或讓客戶少改稿的功能，真的出錯，請把錯誤訊息留下來，該除錯還是要除錯。

不會寫程式，也能放數位乖乖嗎？

可以，先看你想放在哪裡，設計師可以自己置入圖檔，工程師可以用指令，平常已用能操作本機檔案的 AI，也能請它幫忙。

你正在做什麼	可以先選哪種方式	放好後看見什麼
寫程式，想讓乖乖跟著專案保存	建立護身資料夾	專案裡多出圖檔、護身卡與位置清冊
想在某個程式檔留個小玩笑	加入指定檔案的註解	程式裡多出護身文字，原本邏輯保留
只想讓終端機出現綠色乖乖	執行字元圖腳本	用文字拼出的乖乖出現在指令視窗
做 Photoshop 或 Illustrator 設計	把圖檔放進底層	工作檔裡保留乖乖，交付畫面不露出來
做 After Effects 動畫	放進合成底部	乖乖留在專案裡，關閉可見性並排除輸出

下載時，打開 GitHub 專案頁，按 Code，再選 Download ZIP，解壓縮後，素材位於 skills/kuai-kuai-bye-bye/assets/，程式位於同一個技能資料夾裡的 scripts/，這個專案的入口是檔案，沒有另外需要登入的產品網頁。

如果你只想手動放圖，就從 assets/kuai-kuai-official-green.webp 開始，這是隨專案附上的官方商品圖，圖片使用條件在後面另有說明。

想讓 AI 幫我放，該怎麼說？

專案附有 Skill（技能包），可以把它想成給 AI 的操作說明書，告訴 AI 要讀哪些檔案、把乖乖放哪裡，以及放好後要檢查什麼。

把完整的 skills/kuai-kuai-bye-bye/ 資料夾交給支援本機技能的 AI，請它先讀 SKILL.md，圖檔與腳本都要一起保留，只複製說明書，AI 會找不到需要的素材。

第一次可以說：「請幫我的專案放一包數位乖乖，專案位置是 /path/to/project，先建立護身卡，不要改程式碼，完成後告訴我新增了哪些檔案、放在哪裡」，其中 /path/to/project 要換成你自己的專案資料夾位置。

如果你想放進某個程式檔，再明確給檔名，例如 src/main.py，只有聊天能力、沒有本機或桌面軟體操作工具的 AI，可以提供素材與步驟，還不能替你修改電腦裡的檔案。

工程師要怎麼放，又怎麼知道放好了？

自己執行也可以，這條路需要電腦已有 Python 3，安放腳本使用它內建的功能，不需要另裝 npm 套件、填 API Key，也就是服務存取金鑰，下載好檔案後，安放腳本本身不需要網路。

以 Mac 為例，先開啟「終端機」，輸入 python3 --version，出現 Python 3 開頭的版本資訊，才繼續執行腳本，如果顯示找不到指令，就先處理 Python 安裝，或改請能操作本機的 AI 協助。

接著輸入 cd ，注意後面有一個空格，把解壓縮後的 kuai-kuai-bye-bye 資料夾從 Finder 拖進終端機，再按 Enter，這會把目前位置切到腳本所在的專案根目錄，以下指令都從這裡執行，雙引號裡的 /path/to/project 則換成你要安放乖乖的既有資料夾。

先建立護身卡，要貼哪個指令？

執行 python3 skills/kuai-kuai-bye-bye/scripts/kuai.py init --project "/path/to/project"，它會建立 .kuai-kuai/ 資料夾，裡面有圖檔、talisman.md 護身卡與 manifest.json 清冊，這一步不修改程式碼。

清冊記錄檔案位置和雜湊值，你可以把雜湊想成檔案指紋，之後用來比對圖檔有沒有被換掉或改動，不需要自己編輯清冊。

想在程式裡加註解，要多做什麼？

執行 python3 skills/kuai-kuai-bye-bye/scripts/kuai.py bless --project "/path/to/project" --file "src/main.py"，把 src/main.py 換成專案內要安放的相對路徑，它會加入帶有 DIGITAL-KUAI-KUAI 標記的護身註解，註解是給人看的文字，不改原本程式邏輯。

腳本會依副檔名選擇註解寫法，同一個位置重跑不會多塞一包，JSON 沒有這種註解位置，就保留旁邊的護身卡，不要硬塞，加入註解後仍要照原專案跑語法檢查、建置或測試。

出現「乖乖已到位」，代表程式沒問題嗎？

執行 python3 skills/kuai-kuai-bye-bye/scripts/kuai.py doctor --project "/path/to/project"，它會檢查圖檔是否完整、已登記的註解是否還在，看到「乖乖已到位」，代表乖乖圖檔與登記的護身註解完整。

這個檢查沒有跑你的專案測試，畫面也會提醒「沒有執行專案測試，也沒有測量當機率或結案率」，把它當成確認乖乖還在原位就好。

只想讓終端機出現乖乖，可以不放圖片嗎？

可以，字元圖腳本用文字字元拼出包裝、五官與手腳，再用 ANSI 終端機顏色控制碼讓它變綠，圖案寫在程式裡，不讀取商品圖片。

在專案根目錄執行 python3 skills/kuai-kuai-bye-bye/scripts/code-kuai-kuai.py --event build --on-build 就能看見輸出，需要純文字紀錄時加上 --plain，就不帶顏色控制碼。

想在建置完成或開發啟動時看到它，需要另外把呼叫放進自己的流程，兩種事件預設關閉，指令裡寫 build 不代表它替你執行建置，開發啟動則可依專案說明使用 --event dev --on-dev。

設計稿裡要放哪裡，才不會出現在成品？

關鍵是「留在工作檔，輸出時看不見」，只放到最下面還不夠，遇到透明背景，乖乖可能露出來，每種軟體都要確認隱藏和鎖定狀態。

Photoshop 要怎麼放？

先開啟 PSD，從「檔案 → 指令碼 → 瀏覽」執行 scripts/ 裡的 photoshop-kuai.jsx，依Photoshop 腳本，它會請你選擇有權使用的圖檔，再加入名為 __乖乖拜拜_請勿刪除__ 的圖層，關閉眼睛並鎖定。

圖層會放在可用的底部，如果原本有 Background（背景圖層），就放在它上方，背景保持原樣，腳本不自動儲存 PSD，檢查好再另存工作副本。

Illustrator 要怎麼放？

Illustrator 採手動操作，置入圖檔，讓圖片留在畫板上，把 Layers（圖層）面板裡的乖乖圖層列拖到最底部，將 Opacity（透明度）設為 0%，眼睛保持開啟，最後鎖定。

這裡是把圖層列移到最下面，圖片本身仍在畫板上，不要把圖片拖進右側面板，展示時若暫時調高透明度，交付前要恢復 0%。

After Effects 要怎麼放？

先開啟目標合成，從「File → Scripts → Run Script File」執行 after-effects-kuai.jsx，依After Effects 腳本，選好圖檔後會放到合成底部，設成 Guide Layer（參考圖層）、關閉 Video switch（可見性開關）並鎖定，Render Settings 的 Guide Layers 也要選 All Off。

把圖檔留在專案固定的素材資料夾，搬專案時保留來源或用 Collect Files（收集檔案）打包，避免日後找不到圖片，腳本不會自動儲存，也不會開始渲染。

依專案驗證說明，Adobe 腳本尚未在 Photoshop 與 After Effects 桌面軟體實機驗證，先用副本試，檢查圖層與輸出，首頁 GIF 是繪製的操作示意，不是安裝後就會自動發生的功能。

想換一包或拿掉，會不會動到原本檔案？

專案設定每 30 天補貨一次，重新執行 init 會更新儀式日期，到期只提醒，不會讓 CI（持續整合，也就是自動建置與測試流程）因為乖乖過期而失敗。

拿掉一個程式檔的註解，用 python3 skills/kuai-kuai-bye-bye/scripts/kuai.py remove --project "/path/to/project" --file "src/main.py"，它只核對指定的完整註解，後來新增的正常程式內容保留，註解被改過、遺失或重複時會停止，不檢查圖檔或其他檔案。

整包撤下用 python3 skills/kuai-kuai-bye-bye/scripts/kuai.py uninstall --project "/path/to/project"，這一步會先檢查所有登記註解、資產指紋與資料夾清單，發現改動或額外檔案就停止，通過才移除登記的註解與資產，遇到停止訊息，先看差異再處理，不要把清冊或護身標記隨手改掉。

程式與文件採 MIT License（MIT 授權），附帶的商品圖與商標仍有原本的權利條件，對外或商業使用時，確認圖片用途，必要時使用自己已取得授權的圖檔。

延伸閱讀

• 用免費工具錄影剪片，一年可省近180美元：開源省錢管家，想找能實際完成錄影、剪輯與文書工作的工具，可以從自己的需求和帳單開始比較。

參考資料

• 乖乖拜拜官方專案與使用說明，下載圖檔與技能包，查看程式、設計與動畫的安放方式。
• 安放、檢查與撤除腳本，核對各指令實際會修改哪些內容，以及停止條件。
• 設計與動畫安放規則，確認圖層位置、可見性、鎖定與輸出要求。
• MIT 授權文件，程式與文件的使用條件，商品圖不因此取得相同授權。

常見問題 FAQ