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)合成笔触,而不是导入栅格化的覆盖层。
核心管线工作流程
-
参考分析 & 墨迹提取(
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— 模块布局和 Agent 无关隔离边界。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