matematicsolutions/awesome-matematic-skills-pl / dokumenty/skills/let-it-be
let-it-be
VerifiedAnonimizacja i pseudonimizacja polskich danych osobowych (PESEL, NIP, REGON, KRS, telefon, e-mail, imiona i nazwiska, nazwy firm) w tekscie - RODO-safe, offline, deterministycznie (bez wysylania tresci do modelu). Uzywaj gdy uzytkownik chce zanonimizowac lub spseudonimizowac dokument, usunac dane osobowe z pisma, przygotowac tekst do publikacji albo do wyslania do LLM, lub mowi o PESEL/NIP/REGON/RODO/anonimizacji/pseudonimizacji.
src/weryfikacja.mjs
View on GitHub// Weryfikacja pliku PO zapisie, wlasnym czytnikiem.
//
// Wzorzec z oceny paszkiewiczmichal/poufnik (#12, idea, nie kod): bramka "no PII
// leaves" sprawdza tekst w pamieci, a do odbiorcy idzie PLIK. Zapis bywa inny niz
// tekst (kodowanie, uciecie, pozniejsza zmiana formatu wyjscia), wiec plik jest
// czytany od nowa i sprawdzany niezaleznie od tego, kto go zapisal:
//
// oryginaly - zaden oryginal nie wystepuje w pliku czesciej niz w tekscie
// po podmianie (zwykle: zero razy) -> BLOKADA
// tokeny - kontrola POZYTYWNA: kazdy wydany token jest w pliku;
// brak tokenu = plik nie jest tym, co zatwierdzila bramka
// -> BLOKADA
// zero tokenow = nie ma czego sprawdzic -> UWAGI
// surowe-bajty - oryginal w bajtach pliku w trzech kodowaniach: UTF-8 (NFC),
// UTF-8 (NFD - tak bywa po kopiowaniu z PDF), UTF-16LE
// -> BLOKADA
// ponowna-detekcja - silnik na odczytanym pliku nie znajduje danych osobowych
// -> UWAGI
//
// Wynik: trojstan OK / UWAGI / BLOKADA. Komunikaty niosa WYLACZNIE liczniki i typy,
// nigdy wartosci - raport mozna zalogowac.
import { readFile } from "node:fs/promises";
import { detect, countByType } from "./detect.mjs";
export const WERYFIKACJA_OK = "OK";
export const WERYFIKACJA_UWAGI = "UWAGI";
export const WERYFIKACJA_BLOKADA = "BLOKADA";
/** Ten sam prog co bramka residual: krotsze oryginaly to inicjaly, szum. */
const MIN_DLUGOSC = 2;
function ileRazy(tekst, fraza) {
if (!fraza) return 0;
let n = 0;
for (let i = tekst.indexOf(fraza); i !== -1; i = tekst.indexOf(fraza, i + fraza.length)) n++;
return n;
}
function ileRazyBajty(bufor, wzor) {
if (wzor.length === 0) return 0;
let n = 0;
for (let i = bufor.indexOf(wzor); i !== -1; i = bufor.indexOf(wzor, i + wzor.length)) n++;
return n;
}
const KODOWANIA = [
["UTF-8", (s) => Buffer.from(s.normalize("NFC"), "utf8")],
["UTF-8 NFD", (s) => Buffer.from(s.normalize("NFD"), "utf8")],
["UTF-16LE", (s) => Buffer.from(s.normalize("NFC"), "utf16le")],
];
/**
* Czyta zapisany plik od nowa i sprawdza go niezaleznie od zapisu.
*
* @param {string} sciezka zapisany plik wynikowy.
* @param {object} oczekiwane
* @param {string} oczekiwane.tekst tekst po podmianie, ktory przeszedl bramke.
* @param {string[]} oczekiwane.oryginaly oryginalne wartosci PII (wejscie bramki).
* @param {string[]} oczekiwane.tokeny tokeny wydane dla tego pliku.
* @param {object} [oczekiwane.opts] opcje detect() uzyte przy podmianie.
* @returns {Promise<{status:string, kontrole:Array<{kontrola:string, status:string, opis:string}>}>}
*/
export async function zweryfikujEksport(sciezka, { tekst, oryginaly = [], tokeny = [], opts = {} }) {
const kontrole = [];
const dodaj = (kontrola, status, opis) => kontrole.push({ kontrola, status, opis });
let bufor;
try {
bufor = await readFile(sciezka);
} catch (err) {
dodaj("odczyt", WERYFIKACJA_BLOKADA, `nie da sie odczytac zapisanego pliku (${err.code ?? "blad"})`);
return { status: WERYFIKACJA_BLOKADA, kontrole };
}
const odczytany = bufor.toString("utf8").normalize("NFC");
const oczekiwany = String(tekst ?? "").normalize("NFC");
const doSprawdzenia = [...new Set(oryginaly)].filter((o) => typeof o === "string" && o.length >= MIN_DLUGOSC);
// 1. Oryginaly w odczytanym tekscie.
const nadmiarowe = doSprawdzenia.filter((o) => {
const n = o.normalize("NFC");
return ileRazy(odczytany, n) > ileRazy(oczekiwany, n);
}).length;
dodaj("oryginaly", nadmiarowe ? WERYFIKACJA_BLOKADA : WERYFIKACJA_OK, nadmiarowe
? `${nadmiarowe} z ${doSprawdzenia.length} oryginalow jest w pliku czesciej niz w tekscie po podmianie`
: `${doSprawdzenia.length} oryginalow - zaden nie przetrwal w pliku`);
// 2. Kontrola pozytywna: tokeny.
const unikalneTokeny = [...new Set(tokeny)];
if (unikalneTokeny.length === 0) {
dodaj("tokeny", WERYFIKACJA_UWAGI, "zero tokenow - nic nie zamaskowano, kontrola pozytywna nie ma czego sprawdzic");
} else {
const brakujace = unikalneTokeny.filter((t) => !odczytany.includes(t)).length;
dodaj("tokeny", brakujace ? WERYFIKACJA_BLOKADA : WERYFIKACJA_OK, brakujace
? `${brakujace} z ${unikalneTokeny.length} tokenow brak w pliku - zapis rozni sie od zatwierdzonego tekstu`
: `${unikalneTokeny.length} tokenow - wszystkie sa w pliku`);
}
// 3. Surowe bajty w trzech kodowaniach.
const oczekiwaneBajty = Buffer.from(oczekiwany, "utf8");
const trafienia = {};
for (const o of doSprawdzenia) {
const widziane = new Set();
for (const [nazwa, koduj] of KODOWANIA) {
const wzor = koduj(o);
const klucz = wzor.toString("hex");
if (widziane.has(klucz)) continue; // NFD == NFC dla napisow bez znakow diakrytycznych
widziane.add(klucz);
if (ileRazyBajty(bufor, wzor) > ileRazyBajty(oczekiwaneBajty, wzor)) {
trafienia[nazwa] = (trafienia[nazwa] ?? 0) + 1;
}
}
}
const opisTrafien = Object.entries(trafienia).map(([k, n]) => `${k}:${n}`).join(", ");
dodaj("surowe-bajty", opisTrafien ? WERYFIKACJA_BLOKADA : WERYFIKACJA_OK, opisTrafien
? `oryginaly w surowych bajtach pliku (${opisTrafien})`
: `${doSprawdzenia.length} oryginalow x ${KODOWANIA.length} kodowania - zero trafien`);
// 4. Ponowna detekcja na odczytanym pliku.
const ponownie = detect(odczytany, opts).entities.filter((e) => e.isPii);
const typy = Object.entries(countByType(ponownie)).map(([k, n]) => `${k}:${n}`).join(",");
dodaj("ponowna-detekcja", ponownie.length ? WERYFIKACJA_UWAGI : WERYFIKACJA_OK, ponownie.length
? `silnik widzi w zapisanym pliku ${ponownie.length} danych osobowych ({${typy}}) - przejrzyj przed wyslaniem`
: "silnik nie widzi w zapisanym pliku danych osobowych");
const status = kontrole.some((k) => k.status === WERYFIKACJA_BLOKADA) ? WERYFIKACJA_BLOKADA
: kontrole.some((k) => k.status === WERYFIKACJA_UWAGI) ? WERYFIKACJA_UWAGI
: WERYFIKACJA_OK;
return { status, kontrole };
}
/** Jedna linia do stderr: status + kontrole niebedace OK. Bez wartosci. */
export function opiszWeryfikacje(w) {
const problemy = w.kontrole.filter((k) => k.status !== WERYFIKACJA_OK);
const szczegoly = problemy.length
? problemy.map((k) => `[${k.status}] ${k.kontrola}: ${k.opis}`).join("; ")
: `${w.kontrole.length} kontrole`;
return `Weryfikacja eksportu: ${w.status} (${szczegoly})`;
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |