Krita 線稿重建工具
打包並執行一個經過驗證、可投入生產的 1x 原生 Krita 線稿重建流程,從點陣參考插圖開始。
此工具是與代理無關的:數學軌跡合成、拓撲骨架追蹤、校準和驗證嚴格地透過 scripts/krita_adapter.py 與 Krita RPC/MCP/CLI 執行隔離。
嚴格的生產範圍邊界
- 僅原生
1x解析度:請勿啟用2x超取樣或合併的2x + adaptive縮放。adaptive_subdivision.py和stroke_planner.py都會拒絕resolution_scale != 1/supersample_factor != 1。 - 僅線稿:輸出清晰的
#000000墨水到專用的Lineart繪圖層(RGBA U8,300 dpi,sRGB-elle-V2-srgbtrc.icc)。不執行平塗、陰影、漸層、環境光遮蔽、照明疊層或渲染。 - 僅原生 Krita 筆刷:僅透過校準的筆刷預設(
d) Ink-3 Gpen和用於寬幅圖形填充的b) Basic-5 Size)合成筆觸,而非導入點陣化疊層。
核心管線工作流程
-
參考分析與墨水提取(
scripts/ink_analysis.py):- 雙層閾值處理可捕捉固體深色墨水(
inv > 42.0)和細微的低對比紋理(相對於高斯sigma = 4.0,local_dark > 14.0 & inv > 18.0),以及可選的邊界框細部覆寫(region_overrides),用於密集的狹小間隙,例如虹膜同心環。 - 透過歐幾里德距離轉換(
edt >= 2.8 px,面積>= 20 px)偵測粗體圖形黑色核心,並提取等距掃描輪廓(1.35 .. 16.20 px)。 - 對剩餘墨水進行骨架化,修剪短量化毛刺(
<= 4次迭代),跨角度>= 3的接合點(cos <= -0.68)拼接共線軌跡,將中心線細化到亞像素精度(refine_ridge_subpixel),並在尖銳轉角(> 72 deg)或最大跨度540 px處進行分割。
- 雙層閾值處理可捕捉固體深色墨水(
-
樣條擬合與驗證的自適應頂點密度(
scripts/bezier_core.py、scripts/adaptive_subdivision.py):- 使用最小二乘最優切線手柄擬合 G1 連續的分段三次貝茲曲線段。
- 使用優先佇列遞迴三次貝茲細分(在
1x的實驗 2 中驗證)改進弦採樣,將每個筆觸的頂點數限制在 Krita 的硬限制128點內,同時保持對弦垂度、切線角偏轉、曲率弧積、壓力錐度保真度和直線弦長的嚴格容差。
-
Krita 6.0.4 筆刷與座標校準(
scripts/pressure_calibration.py、scripts/stroke_planner.py):- 沿局部法線積分光學線寬,並使用谷值停止(
max_half = 4.8 px)以避免鄰近線束膨脹。 - 選擇雙模式經驗
d) Ink-3 Gpen壓力曲線(brush_size <= 4.5 px時為GPEN_THIN;brush_size > 4.5 px時為GPEN_STD)或configs/pressure_tables_krita604.json中定義的b) Basic-5 Size表格。 - 將頂點樣本和貝茲控制點位移
+0.58 px(PIXEL_CENTER_SHIFT),使筆觸點與 Krita 像素中心對齊,並將筆觸排序到階段 1-6(圖形核心 -> 外部輪廓 -> 焦點區域 -> 內部結構 -> 細微髮絲)。
- 沿局部法線積分光學線寬,並使用谷值停止(
-
執行與閉環視覺回饋(
scripts/reconstruct_lineart.py、scripts/refinement.py):- 透過
KritaAdapter以dry_run(可移植 JSON 批次匯出)、http_bridge(POST /rpc)或krita_mcp_cli(krita-mcp --call)執行,使用<= 32筆觸的批次(嚴格遵守每次draw_brush呼叫<= 64筆觸)。 - 匯出渲染的畫布灰階影像,並可選擇執行
--feedback-canvas <png>(階段 7),以在參考筆觸被遺漏(dist >= 1.35 px)或亮度不足的地方合成目標微筆觸。
- 透過
-
驗證與交接(
scripts/validate_lineart.py):- 驗證清單結構限制,計算全畫布及區域的
SSIM、PSNR_dB、Contour_F1(1.5 px)、Exact_Pixel_F1(0.5 px)、Fine_Detail_Recall、Narrow_Gap_Preservation,並產生紅/藍/深灰對齊差異 PNG 圖。 - 線稿通過驗證後,交接給
krita-flat-colouring。
- 驗證清單結構限制,計算全畫布及區域的
快速 CLI 呼叫
離線規劃筆觸、驗證清單範圍,並輸出具可移植性的 Krita MCP 批次 JSON:
python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
--input path/to/reference.png \
--preset skills/krita-lineart-reconstruction/examples/sample_region_preset.json \
--output-manifest out/lineart_manifest.json \
--batch-dir out/batches \
--mode dry_run
針對正在執行的 Krita 6.0.4 工作階段進行即時執行:
python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
--input path/to/reference.png \
--output-manifest out/lineart_manifest.json \
--mode http_bridge \
--doc-name Character_Lineart
參考指南與設定檔
references/architecture.md— 模組佈局和與代理無關的隔離邊界。references/bezier-and-sampling.md— G1 三次貝茲曲線擬合、優先佇列遞迴細分與傳統採樣器的比較,以及為何排除超取樣。references/calibration.md—+0.58 px座標校準以及雙模式Ink-3 Gpen/Basic-5 Size表格。references/krita-interface.md— Krita 6.0.4 原生橋接協議、硬性結構限制和錯誤處理。references/validation.md— 保真度指標、閉環殘差回饋和通過標準。references/troubleshooting.md— 診斷遺漏細節、頂點裁切和橋接錯誤。configs/default_config.json與configs/pressure_tables_krita604.jsonexamples/workflow_example.md