Community影像github.com

krita-lineart-reconstruction

重建乾淨、原生的 Krita 線稿,以 1x 原生解析度進行,使用 G1 三次貝茲曲線擬合、優先佇列遞迴三次貝茲細分、雙模式 Krita 6.0.4 筆刷壓力校準、+0.58 px 座標校準以及閉環視覺回饋。嚴格限於線稿(無超取樣、無平塗、無陰影或自主渲染)。

krita-lineart-reconstruction 是什麼?

此工具專注於將參考圖稿重建為 Krita 1x 原生解析度的乾淨線稿,透過一系列嚴謹的數學與校準步驟實現。它先從參考影像中提取墨水線條,進行骨架化與拓撲追蹤,再以 G1 連續的貝茲曲線擬合,並透過優先佇列遞迴細分來最佳化頂點分佈。校準階段則整合了雙模式壓力曲線與 +0.58 px 的像素中心偏移,確保筆觸準確對齊 Krita 的像素網格。此工具完全隔離於 Krita 的 RPC/MCP/CLI 執行層,支援離線規劃與即時執行,並內建一系列驗證指標(如 SSIM、PSNR、Contour F1)與閉環視覺回饋機制,可用於偵測遺漏或亮度不足的區域,再自動補上微調筆觸。輸出的線稿為獨立的純黑(#000000)線稿圖層(RGBA U8,300 dpi,sRGB 色彩空間),且完全符合 Krita 6.0.4 的筆刷限制與繪圖協議。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ashdawgthegoat/krita-illustration-skills/tree/HEAD/skills/krita-lineart-reconstruction

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

在你喜歡的 AI 中提問

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

說明文件

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)合成筆觸,而非導入點陣化疊層。

核心管線工作流程

  1. 參考分析與墨水提取(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 處進行分割。
  2. 樣條擬合與驗證的自適應頂點密度(scripts/bezier_core.py、scripts/adaptive_subdivision.py):

    • 使用最小二乘最優切線手柄擬合 G1 連續的分段三次貝茲曲線段。
    • 使用優先佇列遞迴三次貝茲細分(在 1x 的實驗 2 中驗證)改進弦採樣,將每個筆觸的頂點數限制在 Krita 的硬限制 128 點內,同時保持對弦垂度、切線角偏轉、曲率弧積、壓力錐度保真度和直線弦長的嚴格容差。
  3. 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(圖形核心 -> 外部輪廓 -> 焦點區域 -> 內部結構 -> 細微髮絲)。
  4. 執行與閉環視覺回饋(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)或亮度不足的地方合成目標微筆觸。
  5. 驗證與交接(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

參考指南與設定檔

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能