Community图像github.com

krita-lineart-reconstruction

使用 G1 三次贝塞尔拟合、优先级队列递归细分、双模式 Krita 6.0.4 画笔压力校准、+0.58 像素坐标校准和闭环视觉反馈,在原生 1x 分辨率下重建干净的、原生的 Krita 线稿。严格限定于线稿处理(无超采样、无平涂上色、无阴影或自主渲染)。

krita-lineart-reconstruction 是什么?

此技能(Agent Skill)实现了一个完整、生产级别的 Krita 线稿重建管线,可从栅格参考插图中提取并重建出原生 1x 分辨率的干净 Krita 线稿。该技能是“Agent 无关”的,其核心的数学轨迹合成、骨架跟踪、校准和验证逻辑通过一个 Python 适配器与 Krita 的 RPC/MCP/CLI 接口完全解耦,这意味着它可以被 Claude Code、Cursor 或 Codex 等各种 AI Agent 无缝集成。它的工作流程包括:对参考图进行双阈值墨迹分析以提取精细线条;使用 G1 连续分段三次贝塞尔曲线进行拟合,并通过优先级队列递归细分算法确保顶点密度达到最优;然后应用校准后的 Krita 6.0.4 画笔压力曲线和 +0.58 像素的坐标偏移;最后,通过闭环反馈步骤生成微小的补充笔触,以修复遗漏细节。整个管线严格遵守生产边界:仅支持 1x 分辨率,仅输出线稿层,并且只使用原生 Krita 画笔预设。完成重建后,它会生成详细的验证报告(包括 SSIM、PSNR 和 F1 分数),并准备好将线稿传递给下一个上色技能(如 krita-flat-colouring)。

兼容平台~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 线稿重建管线,输入为光栅参考插画。

此技能是 Agent 无关的:数学轨迹合成、拓扑骨架追踪、校准和验证逻辑通过 scripts/krita_adapter.py 与 Krita RPC/MCP/CLI 执行严格隔离。

严格的生产范围边界

  • 仅限原生 1x 分辨率:不要启用 2x 超采样或组合的 2x + adaptive 缩放。adaptive_subdivision.py 和 stroke_planner.py 都会拒绝 resolution_scale != 1 / supersample_factor != 1。
  • 仅限线稿:输出在专用 Lineart 绘画层(RGBA U8,300 dpi,sRGB-elle-V2-srgbtrc.icc)上的清晰 #000000 墨水。不执行平涂上色、阴影化、渐变、环境光遮蔽、光照层次或渲染。
  • 仅限原生 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.

相关技能