Oil UI
Agent 指南 · OpenAI Codex

OpenAI Codex UI 設計指南:用 Oil UI 做出高完成度網頁、後台與 App

OpenAI Codex 與 GPT 系列模型在程式碼執行、複雜狀態聯動和資料密集型介面上表現突出。搭配 Oil UI Skill 後,Codex 能夠把這種工程執行力轉化為耐看的版式與順手的互動——無論是可即時試排的字體鑄造廠官網、拖曳時間軸對齊日誌的運維監控台,還是 390×844 的多畫面衝浪預報 App。

核心要點

要點 1

透過 npx skills add oil-oil/oil-ui 為 Codex 安裝設計流程,讓模型在寫程式碼前先確立版式重心與色彩克制原則。

Codex 擅長實現真互動

在提示詞裡明確寫出“調字重即時算授權價”或“拖時間軸同步高亮拓撲與日誌”,效果遠好於靜態展示頁。

要點 3

同一份任務簡報可以讓 Codex 生成多個截然不同的方向(如畫廊中的 Orvo 九方向、Atelier Volders 與 Fonderie Mercier 系列)。

要點 4

結合 1440×900 與 390×844 真實視口截圖和子 Agent 盲審,消除表格溢出、字級斷層和多餘邊框。

頁間 · 獨立出版工作臺第 07 期 · 秋刊

作者稿酬結算單

結算日 11.20
待結算總額¥8,640.00
2 筆資料齊備 · 1 筆待補開戶行
作者與稿件稅後稿酬 (¥)狀態
林遙沿水而行 · 長文3,200.00可結算
陳舟器物的另一面 · 攝影2,880.00可結算
許南庭院寫生 · 插畫2,560.00待補行號
待補資料的稿件自動順延至下期
為 OpenAI Codex 安裝 Oil UI 開源版
npx skills add oil-oil/oil-ui

執行後在互動列表中選擇 Codex / OpenAI Agent 目錄即可。

Codex 做介面的強項與常見盲區

畫廊中超過八成的作品由 GPT / Codex 系列模型(如 GPT 6.1 Sol、GPT 6 Luna、GPT 6 Astra)搭配 Oil UI 完成。從實際產出看,Codex 非常擅長處理帶真實邏輯的介面:例如《Fieldwork Type》裡邊打字邊改字寬與授權計價,《Nightwatch》裡拖曳故障時間窗聯動拓撲圖與部署標記,以及《Vesper》裡篩選異常帳單並展開 Webhook 負載。

但如果缺少設計限制,Codex 也容易把頁面寫成“工程師除錯面板”——所有欄位平鋪直敘、邊框線過密、狀態按鈕堆成一排,主次關係被淹沒在密集的表格框線裡。Oil UI 的作用就是幫 Codex 先立住視覺主次,再做減法。

畫廊中 Codex / GPT 代表作品與互動重心
作品與模型介面形態核心互動重心視口與狀態設計
Fieldwork Type (GPT 6.1 Sol)獨立字體鑄造廠官網線上試排字樣與按用途即時計價的授權選擇器1440×900 響應式至 390 寬,含試排展開態與購入態
Nightwatch (GPT 6.1 Sol)運維監控與故障處理拖曳時間範圍同步對齊拓撲、部署標記與峰值日誌1440×900 四狀態:正常、告警中、峰值排查、發布歸因
Vesper (GPT 6.1 Sol)API 用量計費後台按用量閾值篩選客戶、檢視異常帳單明細與重試扣款1440×900 三狀態:日常看板、異常帳單抽屜、指令面板
Tide (GPT 6.1 Sol)衝浪與潮汐預報 App拖曳時間軸同時重新整理浪高、風向、潮汐曲線與下水建議390×844 手機端,提供單頁與三畫面並排 screens.html

在 Codex 中跑通“方向對比 → 狀態實現 → 截圖走查”

在 Codex 裡使用 Oil UI 時,建議把一次大任務拆成清晰的階段,讓模型在每個階段都有明確的驗收標準,而不是一口氣生成幾千行未驗證的程式碼。

  1. 安裝 Skill 並傳入真實任務簡報

    執行 npx skills add oil-oil/oil-ui 完成安裝。給 Codex 的任務簡報應當包含產品定位、核心物件、必選狀態和視口尺寸。

    npx skills add oil-oil/oil-ui
  2. 先看多方向同畫面對比,選定唯一主方向

    讓 Codex 先圍繞真實內容提出 3 到 4 個在構圖、字體氣質和色彩明度上拉開差距的方案。選定一個方案後,禁止把落選方案的碎塊拼回主稿。

  3. 用 URL 參數或螢幕並排頁固定關鍵狀態

    像畫廊裡的《Nightwatch》和《Vesper》一樣,讓 Codex 用 ?state=incident 或 screens.html 把 3 個核心業務狀態做成可直接開啟的檢視,方便逐一截圖檢驗。

  4. 按 100% 與 200% 截圖做減法與盲審

    截取各狀態的真實渲染圖,檢查是否有折行錯位、多餘的分隔線或對比度不足的次要文字,修乾淨後再結束任務。

適合 Codex 的任務提示詞範例

給 Codex 寫提示詞時,越具體地描述“使用者操作什麼控制項、介面哪幾處隨之變化”,做出來的產品感就越扎實。下面是一段可直接改寫的提示詞:

Codex 資料與互動密集型介面提示詞範本
用 Oil UI 設計並實現一個 [產品名稱與類型,例如:面向 AI 團隊的 API 用量計費與帳單控制台],桌面端視口 1440×900。
- 核心任務:管理訂閱方案與即時 API 用量,核對當期應收與異常帳單,按狀態或用量閾值篩選客戶,點開單條記錄檢視明細行、扣款與 Webhook 時間線。
- 關鍵聯動:篩選條件變化時列表與頂部趨勢同步更新;點開異常帳單時可直接觸發重試扣款、調整配額或匯出帳單。
- 交付狀態:實現 1) 日常總覽與即時篩選、2) 異常帳單詳情與恢復操作、3) 快捷指令面板三個狀態,並在瀏覽器中截圖走查。

這段結構直接源自畫廊作品《Vesper》的真實任務提示詞,你可以替換成自己的業務物件。

畫廊真實案例與提示詞參考

瀏覽同類案例合集 →
Oil UI Pro

在 Codex 中使用 Oil UI Pro 做複雜後台與既有專案改造

當你需要讓 Codex 搭建 10 類專業後台工作台(告別頂部四張假統計卡)、翻新現有前端倉庫的散亂樣式並沉澱 DESIGN.md,或執行最多 3 輪衝 9 分盲審時,可直接安裝 Oil UI Pro($19.99 一次買斷)。

了解 Oil UI Pro 完整功能 →
複製 Pro 安裝提示詞
npx github:oil-oil/oil-cli install oil-ui-pro

常見問題

畫廊裡同一個產品為什麼會有多個 Codex 作品(比如 Orvo 有 9 個版本)?

這是為了展示同一份產品簡報在不同設計方向下的真實表現。比如 Orvo 的 9 件作品使用了相同的產品定位與三檔定價($0 / $24.99 / $34.99),但在“創作花園”“同路同行”“海岸工坊”“開放工作室”等不同方向下,版式、色調和敘事方式截然不同。

Codex 做行動端介面時怎麼避免做成縮小的網頁?

在提示詞裡明確指定 390×844 視口,並要求同時交付單畫面可互動頁與多畫面並排的 screens.html。Oil UI 會引導模型按拇指熱區、底部或分段導覽以及單畫面單一主任務來組織移動介面,而不是把桌面三欄強行壓成一列。

Codex 寫出的深色模式介面容易發灰或刺眼,Oil UI 怎麼處理?

Oil UI 會根據產品場景決定明暗背景(例如夜間車載中控《沿途》與運維值班台《Nightwatch》採用深色,日常閱讀與表單工具採用淺色),並嚴格限制高飽和發光色只用於關鍵路徑與告警狀態,避免整頁泛霓虹紫光。

已經安裝了 Oil UI 開源版,裝 Pro 時怎麼切換?

執行 npx github:oil-oil/oil-cli install oil-ui-pro 安裝 Pro 後,把舊的開源版目錄移除即可。Pro 完整包含了開源版的所有能力。

延伸閱讀

Claude Code UI 設計指南 ↗官網與 SaaS 落地頁設計實戰 ↗後台與桌面工作台設計實戰 ↗