圖像畫布 桌面版
桌面版和網頁版是同一套畫布,差別只在生圖是誰算的。網頁版要你填 Gemini API 金鑰;桌面版改用你電腦上的 Codex CLI,登入自己的 ChatGPT 帳號後就吃訂閱額度,不用另外申請金鑰、也不用另外付 API 費用。
下載
安裝檔放在 GitHub Releases,選你的作業系統下載:
- Windows:
yiyang-image-canvas-*-x64.exe(安裝式,可自選安裝位置) - macOS:Apple 晶片下載
*-mac-arm64.dmg,Intel 機種下載*-mac-x64.dmg - Linux:
*-x86_64.AppImage,下載後chmod +x直接執行
如果那一頁目前是空的,代表還沒發佈第一個版本。你也可以自己從原始碼打包:git clone 後進
image-canvas/ 執行 npm ci && npm run dist,成品會出現在 image-canvas/release/。
第一次開啟會被系統擋下
這是小工作室的免費工具,沒有買 Apple 與微軟的程式碼簽章憑證(一年各要好幾百到上千美金),所以系統會顯示「無法確認開發者」之類的警告。 這不代表檔案有問題,但也請你只從上面那個 GitHub 連結下載。繞過方式:
- macOS:在應用程式上按右鍵 →「打開」,再按一次「打開」。直接雙擊會被擋。
- Windows:SmartScreen 出現時點「其他資訊」→「仍要執行」。
macOS 顯示「已損毀,無法打開」怎麼辦
這個訊息看起來像檔案下載壞掉,其實不是。macOS 會給從網路下載的檔案加上一個「隔離」標記, 沒有 Apple 憑證的程式碰到它就會被擋,而系統挑了「已損毀」這個誤導人的說法。 重新下載不會有幫助,把標記清掉就好。
- 先把 App 從 dmg 拖進「應用程式」資料夾,然後退出磁碟映像檔。
- 按 Command + 空白鍵打開 Spotlight,輸入
Terminal,按 Enter。 -
貼上這行,按 Enter:
xattr -cr "/Applications/Yiyang Image Canvas.app"
沒有任何訊息就是成功了。 -
到「應用程式」裡打開它。若還是被擋,再貼這行然後 Enter,之後重開一次:
codesign --force --deep --sign - "/Applications/Yiyang Image Canvas.app"
這兩行都只動你自己電腦上的這個 App,不會改到系統設定,也不會關掉 macOS 的任何防護。
安裝後的三個步驟
- 一、裝 Node.js 20 以上:到 nodejs.org 下載安裝。Codex CLI 需要它。
- 二、點左下角的狀態列:畫布開起來後左下角會顯示「未安裝 Codex CLI」,點一下會自動開一個終端機視窗,幫你安裝 Codex CLI 並帶你登入 ChatGPT 帳號。
- 三、回到畫布:登入完成後再點一次左下角重新檢測,狀態變成就緒就可以生圖了。
手動安裝/更新 Codex CLI
上面第二步的按鈕會自動處理,但如果按鈕沒反應、或是生成一直失敗,自己在終端機裡跑一次最保險。 下面兩個指令安裝和更新是同一件事——已經裝過的話,跑一次就會更新到最新版。
Windows 的操作步驟
- 按鍵盤上的 Win 鍵 + R(Win 鍵就是有視窗圖案那顆,在左邊 Ctrl 和 Alt 中間)。畫面左下角會跳出一個「執行」小視窗。
- 在框裡輸入
cmd,按 Enter。會開啟一個黑色的命令提示字元視窗。 -
輸入下面這行,然後按 Enter:
npm install -g @openai/codex@latest
等它跑完,看到類似changed 2 packages in 14s就是成功了(大約 10 到 60 秒)。 -
接著輸入這行登入,再按 Enter:
codex login
它會自動打開瀏覽器,用你的 ChatGPT 帳號登入即可。登入完視窗會顯示成功訊息。 - 關掉這個黑色視窗,回到畫布,點一下左下角的狀態列重新檢測。
提示:黑色視窗裡不能用 Ctrl + V 貼上,要按滑鼠右鍵才會貼上。 如果出現「'npm' 不是內部或外部命令」,代表 Node.js 沒裝好或還沒生效——重裝一次 Node.js,然後把這個視窗關掉重開。
macOS 的操作步驟
- 按 Command + 空白鍵打開 Spotlight,輸入
Terminal,按 Enter。 - 輸入
npm install -g @openai/codex@latest,按 Enter。若出現權限錯誤,改成sudo npm install -g @openai/codex@latest並輸入電腦密碼(打密碼時畫面不會有任何顯示,這是正常的)。 - 輸入
codex login,按 Enter,在跳出的瀏覽器完成 ChatGPT 登入。 - 回到畫布,點一下左下角狀態列重新檢測。
怎麼知道有新版
桌面版每次開啟會檢查一次版本,有新版就會在畫布下方顯示一條提示,按「前往下載」回到這一頁即可。
更新方式就是重新下載安裝一次,蓋過舊版,不需要先移除。
你的畫布與生成過的圖不會被動到(Windows 存在
%APPDATA%\Yiyang Image Canvas\data,macOS 存在
~/Library/Application Support/Yiyang Image Canvas/data)。
什麼時候要重跑這件事
OpenAI 會不定期把帳號切到新的模型,舊版 CLI 連模型清單都讀不懂,這時每一次生成都會失敗,
錯誤訊息裡會出現「requires a newer version of Codex」或「unknown variant」之類的字。
看到生成一直失敗,先跑一次 npm install -g @openai/codex@latest 就對了。
要換一個 ChatGPT 帳號(例如額度用完)的話,畫布左下角狀態列有「切換 ChatGPT 帳號」可以按;
想自己來就依序執行 codex logout 再 codex login。一定要先登出,不然
codex login 會直接沿用目前的帳號。
桌面版和網頁版差在哪
- 生圖額度:桌面版吃你的 ChatGPT 訂閱額度;網頁版吃你自己的 Gemini API 金鑰額度。
- 速度:桌面版一張圖大約要一到數分鐘(Codex 的 imagegen 就是這個速度);網頁版通常快得多。
- 存檔位置:桌面版存在專案的
data/canvas.json,網頁版存在瀏覽器裡。兩邊都可以用「匯出 JSON」互相搬移。 - 畫布功能:完全一樣——生成、混圖、擴圖、局部重繪、便條、手繪、影像調整都在。
提醒:Gemini Advanced、Google One AI Premium 這類訂閱只能在 Gemini App 裡用,沒有對應的 API,兩個版本都用不到。
隱私
桌面版不連藝洋的伺服器。你的 ChatGPT 登入資訊由 Codex CLI 自己保管在你的電腦上,畫布只是在本機呼叫它;生成的圖片與畫布檔也都留在你的電腦裡。
© 2016–2026 藝洋視覺設計工作室 · yiyangart.com
