Community影像github.com

refkit

為手繪或手畫的使用者準備參考照片:明暗構成、五階調值、灰階、網格、有限調色板與顏料調配配方,並輸出可列印的 A4 工作單。

refkit 是什麼?

refkit 是一個專為傳統手繪與手畫創作者設計的參考資料準備工具。它不會代替使用者繪圖,而是透過一系列電腦視覺演算法,將使用者提供的照片轉換成多種輔助素材,包括明暗構成圖、五階調值研究、灰階圖、繪圖網格、以及由 K-means 分群產生的有限調色板,並為每個顏色提供基於十種常見管裝顏料的 Kubelka-Munk 模型混合配方。這些素材會整合成一張 A4 橫式工作單,方便列印後掛在畫架上參考。支援油畫、壓克力、水彩等媒材設定,並可自訂畫布尺寸、網格密度、調色板大小等參數。refkit 完全離線運作,無需任何影像模型,僅依賴 Python、Pillow、NumPy、OpenCV、scikit-image 與 scikit-learn。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thibaud360/refkit/tree/HEAD/skills/refkit

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

# refkit

為手繪或手畫的使用者準備參考素材。Claude 不會為使用者繪圖:而是準備參考資料,讓使用者能動手畫。執行 `scripts/refkit.py`(需要 Python 3、Pillow、NumPy、OpenCV、scikit-image、scikit-learn)。無需影像模型。

## 會產出的檔案(在 `refkit_out/` 目錄中)

| 檔案 | 內容 |
|---|---|
| `*_notan.png` | 2 階與 3 階明暗構成圖,附各階面積佔比 |
| `*_values5.png` | 五階調值研究圖,附調值階梯圖例 |
| `*_gray.png` | 灰階圖(感知亮度,階調拉伸) |
| `*_grid.png` | 照片加上繪圖網格,欄位標示 A、B、C,列位標示 1、2、3 |
| `*_palette.png` | 3-10 種顏色(K-means 分群),每種顏色附顏料調配配方 |
| `*_sheet.png`、`*_sheet.pdf` | 所有素材整合在一張 A4 橫式工作單上,方便列印後掛在畫架旁 |

## 操作步驟

1. 找到使用者的照片(使用者自己的照片或畫作)。確認相依套件已安裝:`pip install pillow numpy opencv-python-headless scikit-image scikit-learn`(如果 pip 要求,加上 `--break-system-packages`)。
2. 若尚未詢問:詢問畫布尺寸(公分)與媒材(油畫、壓克力或水粉 = `oil`/`gouache`;水彩 = `watercolor`)。不要過度審問;可直接使用預設值。
3. 執行:`python scripts/refkit.py PHOTO -o refkit_out [選項]`
4. 在傳送前,至少檢視工作單、網格圖與調色板圖。如果某個配方看起來奇怪,請告知混合比例僅為估算。
5. 先傳送工作單(PNG 與 PDF),若使用者要求再傳送單張圖片。提供一次微調選項:增減網格格數、改變調色板大小、或變更媒材。

## 選項,以及使用者說了什麼

- `--canvas 40x50`(公分,或 A4..A1)。照片會依此比例裁剪(中心裁剪),應用於所有輸出。當使用者指定畫布或紙張尺寸時使用。
- `--grid N` 長邊的網格格數(預設 8)。「更多細節」表示更大的 N。
- `--grid-cm 5` 每格邊長(公分);需搭配 `--canvas`。用於「每 5 公分一個網格」。
- `--palette N` 顏色數量,3 到 10(預設 6)。「有限調色板」通常指 4 到 6 色。
- `--paints oil|watercolor|gouache`。水彩沒有白色:亮色透過加水稀釋,白色部分保留紙張底色。
- `--values 2,3,5` 要製作哪些調值研究(預設全部製作)。
- `--width PX` 工作尺寸(預設 1600),`--dpi` 工作單解析度(預設 200),`--strip` 同時產出處理前後的對比條。

範例:`python scripts/refkit.py photo.jpg --canvas 30x40 --grid-cm 5 --palette 7 --paints oil`

## 如何向使用者說明

將其定位為幫助使用者自己繪圖的工具:明暗構成圖呈現大塊形狀,調值圖顯示明暗分布,網格用於轉移構圖,配方則是一個起點。切勿稱之為 AI 藝術。混合配方是根據十種常見管裝顏料(鈦白、象牙黑、鎘黃淺色、土黃、鎘紅、茜素深紅、群青、酞菁藍、焦赭、焦紅)的 Kubelka-Munk 模型計算而來。不同品牌顏料有差異,請告知使用者先在廢紙上測試。比例為體積比。

## 如果腳本遺失

`git clone --depth 1 https://github.com/thibaud360/refkit /tmp/refkit` 然後使用 `/tmp/refkit/skills/refkit/scripts/refkit.py`。

相關技能