mirror of
https://github.com/wiltodelta/remove-ai-watermarks.git
synced 2026-08-19 20:17:12 +02:00
Victor KuznetsovandClaude Opus 5
78d9e81d0f
The visible-mark path had grown three copies of one ladder sweep, four
near-identical `detect` arms, and four hand-rolled `footprint_mask` overrides;
mark knowledge sat in five hand-maintained tables across three modules; and the
flagship `all`/`batch` pipeline existed only in cli.py, written twice with
divergent behavior.
Detection is now one measurement. `_ladder_best` replaces the three sweeps,
`_scan`/`_verdict` replace the four arms, and the winning box travels to the
mask on `TextMarkDetection.match_box` instead of being swept a second time.
`detect_both` returns the strict and relaxed verdicts from one scan, which
halves the arbiter's perception cost (260 -> 130 matchTemplate calls on a 2048²
image, verdicts identical field for field). A per-mark demotion goes in the new
`_post_gate` hook, never in a `detect` override -- an override is invisible to
the single-pass path, which is how the RunningHub and Yuanbao anchor gates
briefly stopped applying.
Everything about a mark is now one registry row: product, label regime, the
platform sentence `identify` reports, the metadata signals that confirm it, and
its TC260 producer codes. `identify._VISIBLE_MARK_PLATFORM`, the signal mapping
in `api.visible_provenance`, `_PRODUCT_OF` and the pill veto are derived from
those rows.
`api.remove_all` / `api.remove_batch` are the library form of the `all` and
`batch` commands; the CLI is a wrapper that owns console text and exit codes.
Progress is a `(stage, detail)` pair of stable tokens, so the CLI keys its
wording off structure rather than parsing the library's prose back.
Two intentional behavior changes, both verified against a recorded 811-image
sample of detector verdicts, removal-mask hashes, arbiter decisions and
`identify` reports:
* A TC260 label now relaxes the vendor its `ContentProducer` names rather than
ByteDance's pair on every China-AIGC image. 333 of 811 samples move; on 185
of them the previously relaxed pair was simply the wrong vendor, and the
mark actually present never reached the relaxed gate its own
`provenance_ncc_factor` was calibrated for.
* A confident LibLibAI detection suppresses the Jimeng pill, like every other
TC260 product's mark. It was registered alongside RunningHub and Baidu, both
of which were added to the hand-written veto list, and it was not. 1 sample
moves, and it is exactly the co-firing case.
Nothing else in that record changes: detector verdicts, mask hashes and
`identify` verdicts are byte-identical, and all 200 calibration constants are
untouched.
Also: `aigc_label` and friends plus `extract_c2pa_info` are memoized on
(path, mtime_ns, size) -- size because this package rewrites in place; the
native TC260 container readers route on magic bytes instead of the file
extension, so a mislabeled AVI or FLV is no longer invisible; `identify` shares
one pixel decode between the DWT-DCT and visible stages (TrustMark keeps its own
Pillow decode, which is not substitutable); and the six `stabilize_*` video
wrappers collapse into one policy table.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
131 lines
6.2 KiB
Python
131 lines
6.2 KiB
Python
"""Kling (可灵, Kuaishou) visible watermark detector/localizer.
|
|
|
|
Kling stamps its generations with a thin, light-gray "可灵AI 3.0" text strip in the
|
|
bottom-right corner, preceded by the vendor's spiral logo (not part of the detection
|
|
silhouette -- logos vary between releases, the text run is what discriminates).
|
|
Known variants: an "Omni" suffix release, a latin "KlingAI 3.0" release, and a
|
|
version-less "可灵AI" -- the silhouette targets the common "可灵AI 3.0" core, so the
|
|
suffix variants are only caught when the core run is bold enough (measured below).
|
|
|
|
Detection matches the bundled glyph silhouette against the corner; removal is the
|
|
shared **localize -> fill** (the glyph-bbox :meth:`footprint_mask` feeds
|
|
``region_eraser``), NOT reverse-alpha. This module supplies only Kling's tuned
|
|
:class:`TextMarkConfig` (``assets/kling_alpha.png`` -- a font-rendered synthetic
|
|
silhouette from ``scripts/render_vendor_silhouettes.py``, never cut from an
|
|
upload). It also feeds ``identify`` as the medium-confidence ``visible_kling``
|
|
signal via the registry.
|
|
|
|
EVERY tuned number below was measured on the vendor cohort (30 TC260 carriers whose
|
|
producer USCC 91110108335469089C names the entity, 2026-07-21; harness
|
|
``scripts/vendor_mark_calibrate.py``), NOT inherited from Doubao:
|
|
|
|
* The mark scales with the SHORT side at ~0.12 of it (mark_w/short measured
|
|
0.118-0.122 across portrait AND landscape carriers -- unimodal, so the shipped
|
|
3-rung ladder covers it) and sits ~0.03 off the right/bottom edges; the locate
|
|
box fractions below are fitted from the measured absolute mark rects.
|
|
* ``alpha_height_frac`` comes from the silhouette aspect (0.239) at the fitted
|
|
width, matching the aspect the fit converged on (0.25).
|
|
* Gate 0.35, one step above the clean arm's max: on the cohort-vs-clean run
|
|
(cohort-contamination-guarded, 286 hand-labelled clean frames) the clean arm
|
|
scored p99 0.304 / max 0.320, and every cohort frame >= 0.35 carries a visible
|
|
可灵AI 3.0 mark (9 of ~19 eyeballed visible marks fire = ~47% recall of visible
|
|
marks; the misses are the faint "Omni"-suffix release, the latin "KlingAI"
|
|
release and the version-less "可灵AI", which score 0.17-0.25 and cannot be
|
|
reached without engulfing the clean arm).
|
|
* STRICT ONLY (``provenance_ncc_factor`` 1.0): the sub-gate band holds real Kling
|
|
variants AND the clean arm's top (clean p90 0.220 vs variant marks at 0.17-0.25
|
|
-- they overlap), so a provenance-relaxed arm cannot separate them. No
|
|
provenance relaxation exists for this mark.
|
|
* No rival margin: at the shipped gate the template fires on 1 of 400
|
|
Doubao-marked frames (0.2%, a 豆包 frame sitting INSIDE the Kling cohort, still
|
|
below the gate), 0 of 298 Jimeng-marked frames and 0 of 286 hand-labelled clean
|
|
frames, and a 0.10 rival margin costs zero genuine Kling detections -- so it is
|
|
simply unnecessary (same conclusion shape as Qwen).
|
|
"""
|
|
# The module-level _alpha_template / _glyph_silhouette / _template_match_score below
|
|
# are thin test-facing shims (imported by tests/), so pyright's src-only pass sees them
|
|
# as unused; the use is cross-module.
|
|
# pyright: reportUnusedFunction=false
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING, Any
|
|
|
|
from remove_ai_watermarks import _text_mark_engine
|
|
from remove_ai_watermarks._text_mark_engine import TextMarkConfig, TextMarkEngine
|
|
|
|
if TYPE_CHECKING:
|
|
from numpy.typing import NDArray
|
|
|
|
# Locate geometry as a fraction of the image SHORT side (measured basis -- see
|
|
# scale_base). The box is fitted to the measured mark rects: the mark's right
|
|
# margin is ~0.034 of the short side and its bottom margin ~0.027; width/height
|
|
# cover the mark plus NCC slack.
|
|
WM_WIDTH_FRAC = 0.19
|
|
WM_HEIGHT_FRAC = 0.05
|
|
MARGIN_RIGHT_FRAC = 0.03
|
|
MARGIN_BOTTOM_FRAC = 0.023
|
|
|
|
# Glyph appearance: a light, low-saturation gray rendered brighter than the local
|
|
# background (white top-hat), same overlay class as Doubao -- inherited, and
|
|
# harmless because the tophat front-end turns these gates into weights.
|
|
MAX_SATURATION = 55
|
|
LOGO_MIN_LUMA = 150
|
|
TOPHAT_DELTA = 12
|
|
|
|
DETECT_MIN_COVERAGE = 0.04 # unused by the tophat front-end (kept for config parity)
|
|
# Calibrated 2026-07-21 on the vendor cohort vs 286 hand-labelled clean frames
|
|
# (cohort-contamination-guarded): clean p99 0.304 / max 0.320, and every cohort
|
|
# frame scoring >= 0.35 carries a visible 可灵AI 3.0 mark. 0.35 was picked over
|
|
# 0.33 (also zero clean fires) for margin against unseen clean content at a cost
|
|
# of zero measured cohort detections.
|
|
DETECT_NCC_THRESHOLD = 0.35
|
|
|
|
# Detection-silhouette geometry (fraction of the short side), fitted on the
|
|
# cohort: the mark's width (0.12, unimodal) and the silhouette aspect (0.239).
|
|
_ALPHA_WIDTH_FRAC = 0.12
|
|
_ALPHA_HEIGHT_FRAC = 0.0287
|
|
|
|
_CONFIG = TextMarkConfig(
|
|
name="Kling",
|
|
asset_name="kling_alpha.png",
|
|
corner="br",
|
|
margin_floor=4,
|
|
width_frac=WM_WIDTH_FRAC,
|
|
height_frac=WM_HEIGHT_FRAC,
|
|
margin_x_frac=MARGIN_RIGHT_FRAC,
|
|
margin_bottom_frac=MARGIN_BOTTOM_FRAC,
|
|
max_saturation=MAX_SATURATION,
|
|
logo_min_luma=LOGO_MIN_LUMA,
|
|
tophat_delta=TOPHAT_DELTA,
|
|
morph_open_size=5,
|
|
detect_min_coverage=DETECT_MIN_COVERAGE,
|
|
detect_ncc_threshold=DETECT_NCC_THRESHOLD,
|
|
detect_frontend="tophat",
|
|
scale_basis="short", # measured: mark_w/short 0.118-0.122 across orientations
|
|
alpha_width_frac=_ALPHA_WIDTH_FRAC,
|
|
alpha_height_frac=_ALPHA_HEIGHT_FRAC,
|
|
min_gw=8,
|
|
# STRICT ONLY: the sub-gate band (real Kling variants at 0.17-0.25) overlaps
|
|
# the clean arm's top (p90 0.220), so provenance relaxation is disabled
|
|
# outright (factor 1.0 = never relaxed).
|
|
provenance_ncc_factor=1.0,
|
|
)
|
|
|
|
|
|
def _alpha_template() -> NDArray[Any] | None:
|
|
"""The bundled Kling alpha template (float [0,1]), or None."""
|
|
return _text_mark_engine.load_alpha_template(_CONFIG.asset_name)
|
|
|
|
|
|
def _glyph_silhouette() -> NDArray[Any] | None:
|
|
"""Binary "可灵AI 3.0" silhouette (255 = glyph) from the alpha map, or None."""
|
|
return _text_mark_engine.glyph_silhouette(_CONFIG.asset_name)
|
|
|
|
|
|
class KlingEngine(TextMarkEngine):
|
|
"""Detect/localize the visible Kling "可灵AI 3.0" watermark (locate -> mask; mask feeds the fill)."""
|
|
|
|
def __init__(self) -> None:
|
|
super().__init__(_CONFIG)
|