Square Couplets Master

概述

春聯斗方大師 (Square Couplets Master) 為使用 Google Gemini AI 生成傳統春聯斗方藝術作品的應用。輸入關鍵字（如財富、健康、萬馬奔騰等），可選上傳參考圖片以引導風格，由 AI 產出菱形斗方書法藝術圖，支援 1K、2K、4K 解析度與多模型選擇，並在 Web 介面中提供模型與解析度設定、結果預覽與下載，適合新年佈置、禮品或個人創作。

功能重點

AI 生成春聯斗方 — 輸入關鍵字即可自動生成傳統風格春聯斗方藝術圖。
參考圖片支援 — 可上傳參考圖片，AI 會參考其風格生成作品。
多種解析度 — 支援 1K、2K、4K 輸出；2K/4K 需使用較新的影像模型。
多模型選擇 — Gemini 2.5 Flash（快速、1K）、Gemini 3.1 Flash（速度與畫質平衡、1K/2K/4K）、Gemini 3 Pro（最高畫質、1K/2K/4K），可依預算與品質需求選擇。
互動式設定與預覽 — 透過設定面板調整模型與解析度，並在結果頁即時預覽與下載作品。

模型與解析度選擇

專案前端針對三種模型做了清楚分工：

模型	解析度支援	特點	建議用途
Gemini 2.5 Flash	1K	成本低、生成最快	草稿、快速測試、多輪迭代
Gemini 3.1 Flash	1K / 2K / 4K	畫質明顯優於 2.5、支援高解析度	需要較好畫質但仍在意成本與速度時
Gemini 3 Pro	1K / 2K / 4K	細節最豐富、風格理解最佳	最終成品、列印輸出、正式對外發佈

若 API Key 尚未啟用付費計費，建議先從 Gemini 2.5 Flash 或 Gemini 3.1 Flash 開始測試；追求最高品質時再切換至 Gemini 3 Pro。

範例作品與介面

以下為使用關鍵字「萬馬奔騰」的多組生成結果與 UI 介面示意。

模型輸出對比

Gemini 2.5 Flash 生成

快速生成，品質良好，僅支援 1K 解析度，適合快速測試與迭代。

Gemini 3.1 Flash 生成

在成本與速度之間取得平衡，畫質明顯優於 2.5 Flash，適合大部分實務情境。

Gemini 3 Pro 生成

生成時間較長，但細節更豐富、風格理解更準確，支援 2K 與 4K，適合最終作品與列印。

設定面板與結果頁

模型與解析度設定

在設定面板中可選擇使用的模型與輸出解析度，並管理 Gemini API Key 等配置。

生成結果預覽

生成完成後，可在結果頁預覽斗方作品，確認後下載高解析度圖片。

使用方式

輸入關鍵字 — 在輸入框輸入願望或祝福語（如財富、健康、萬馬奔騰）。
（可選）上傳參考圖 — 選擇一張圖片作為風格參考。
選擇模型與解析度 — 於設定面板中選擇 Gemini 2.5 Flash、Gemini 3.1 Flash 或 Gemini 3 Pro，以及輸出解析度（1K/2K/4K）。
生成與下載 — 點擊 Generate，於結果頁預覽並下載作品。

開發與部署

前置需求 — Node.js（建議使用最新 LTS 版本）。
本地開發
```
npm install
npm run dev
```
在瀏覽器開啟 http://localhost:5173（或終端輸出的實際位址）。
部署到 GitHub Pages — 專案已配置 GitHub Actions，推送到 main / master 後會自動建置並部署到 https://[使用者名稱].github.io/Square_Couplets_Master/。

技術棧

前端 — React 19、TypeScript、Tailwind CSS、Vite。
AI — Google Gemini 2.5 Flash、Gemini 3.1 Flash、Gemini 3 Pro 影像模型。

NPM 套件與 Claude Agent Skills

專案同時提供 NPM 版的 Square Couplets Master Skills 以及對應的 CLI：

全域安裝：npm install -g @justin_666/square-couplets-master-skills
初始化到專案中：doufang init --ai cursor（或 windsurf / antigravity / claude）
常用指令：
- doufang-prompt：依關鍵字生成春聯斗方 prompt
- doufang-image：呼叫 Gemini 影像模型生成斗方圖片（支援 1K/2K/4K）
- doufang-optimize：優化 prompt，減少過多留白、提升構圖

這些 Skills 可在 Cursor 等 IDE 以 slash command 或 CLI 方式使用，並支援進度提示、版本查詢與 DEBUG 模式，方便在 AI 開發流程中快速疊代與產生視覺素材。

應用情境

適用於農曆新年春聯、斗方佈置、賀卡、禮品或將祝福語轉為可列印藝術圖的情境；亦可搭配參考圖與不同模型設定產出特定書風或構圖風格，作為個人創作或設計靈感來源。