Krita 均勻平塗上色技能 是做什麼的?
將乾淨、完成的 Krita 線稿轉化為可編輯、可投入生產的 Krita 插畫,組織成語義化的、均勻單一十六進位平面色彩圖層,隨時可供人類藝術家接手。
本技能為代理無關:拓撲分割、輪廓多邊形提取與均勻性驗證均透過 scripts/krita_adapter.py 與 Krita 傳輸解耦。
硬性生產範圍邊界(止於平塗)
- 嚴格的純平塗保證:每個葉節點圖層輸出恰好一個目標十六進位 RGB(
alpha == 255,opacity = 1.0)。 - 嚴格禁止的操作(由
configs/default_config.json與KritaAdapter強制執行):- 禁止陰影、暗部、環境光遮擋、高光、邊緣光或皮下泛紅。
- 禁止漸層、柔和噴槍、繪畫性混色(厚塗)或眼球高光。
- 禁止全域打光圖層堆疊(
multiply、lighten、overlay、add、screen、soft_light、color_dodge)。 - 禁止線稿色彩保持重新著色。
- 線稿保留:先將原始線稿複製到鎖定、隱藏的備份圖層,再新增色彩群組。當實心黑色服裝/配件剪影包含平面內部色彩時,使用可逆的
transparencymask,而不是擦除或重畫線稿像素。
核心管線工作流程
-
線稿攝入與連通元件標記(
scripts/region_segmentation.py):- 對墨線進行閾值處理(
gray < 200),閉合 1 像素筆畫針孔(3x3二元閉合運算),並標記內部區域。 - 自動從接觸邊界的背景標籤(或
--spec中宣告的exterior_bg_labels)識別外部剪影。
- 對墨線進行閾值處理(
-
語義與拓撲分區(
scripts/region_segmentation.py):- 墨水廊道材質區域:隔離由
ink & geometry & silhouette邊界定義的深色服裝/配件帶狀/條狀區域,可選擇侵蝕2 px以在深色內部區域上產生可逆的Fill_Window透明度遮罩。 - 前/後覆蓋層:隔離有邊界的鞏膜、虹膜或小型區域。
- Voronoi EDT 競爭:透過歐幾里得距離轉換解決相鄰材質之間(例如頭髮 vs. 皮膚、主髮 vs. 後辮)的邊界陰影區域。
- 1 像素墨跡捕捉:將填充區域沿邊界墨線輪廓向外擴張
1 px,使反鋸齒筆畫邊緣不留白色光暈。 - 通用後備方案:若無語義化的
--spec,則將封閉的內部元件(>= 16 px)自動標記為獨立的Flats/Region_NN圖層,並記錄較小/未映射的區域。
- 墨水廊道材質區域:隔離由
-
非破壞性階層與多邊形包含筆刷掃掠(
scripts/layer_setup.py、scripts/polygon_selection.py、scripts/flat_fill_planner.py):- 在
Lineart/下方建立獨立的blending_mode = "normal"、inherit_alpha = false圖層群組。 - 將遮罩轉換為 Krita
select_polygon外部(replace/add)+ 孔洞(subtract)調用,使用校正後的+0.58 px位移(SUBPX = 0.58)。 - 使用
"b) Basic-5 Size"筆刷,以全壓力(1.0)、全不透明度(1.0)繪製蛇形筆刷掃掠,封裝為<= 60個編輯的edit_batch區塊(低於 Krita 的64個編輯上限)。 - 填充後將葉節點平面圖層設為
alpha_locked = true,以便藝術家能立即在邊界內進行陰影處理。
- 在
-
驗證與藝術家交接報告(
scripts/validate_flat_color.py):- 確認匯出的不透明像素中100% 為單一十六進位 RGB 均勻。
- 驗證角色剪影外部零溢出。
- 記錄任何半開放或模糊的解剖區域(例如模糊的未封閉指甲、半開放的小指甲邊緣)供人工藝術家審查,而非自行猜測。
快速 CLI 調用
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart path/to/clean_lineart.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir work/flat_batches \
--diag-out work/flat_diag.png \
--audit-out work/flat_audit.json \
--setup-layers \
--mode dry_run
直接對運作中的 Krita 6.0.4 文件執行:
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart path/to/clean_lineart.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir work/flat_batches \
--setup-layers \
--mode http_bridge
參考指南與設定檔
references/architecture.md— 範圍邊界、模組分離與藝術家交接圖層結構。references/region-segmentation.md— 連通元件隔離、Voronoi EDT 連結、墨跡捕捉與宣告式region_spec.jsonDSL。references/flat-execution-and-layers.md— 多邊形孔洞減法、+0.58 px掃掠、edit_batch封裝與transparencymask開窗。references/krita-interface.md— Krita 6.0.4 原生橋接限制、模式驗證與非平面執行時保護。references/validation.md— 單一十六進位均勻性檢查、溢出控制與未解決區域記錄。references/troubleshooting.md— 修復半開放漏縫、多邊形頂點溢位與橋接錯誤。configs/default_config.json與configs/layer_hierarchy_template.jsonexamples/workflow_example.md