redlines — Wordi dokumendi redline’imise teek

Millal kasutada

AI-genereeritud muudatuste teisendamine Wordi jälgitavateks muudatusteks
Diff-väljundi rakendamine DOCX-failidele natiivse revisjonimärgistusega
Juriidiliste tööriistade ehitamine, mis toodavad redline’itud dokumente
Automatiseeritud dokumendivõrdlus Wordiga ühilduva väljundiga
„Draft by exception“ töövood, kus jälgid standardklauslite erandeid

Kuidas see töötab

Võtab diff-väljundi (mis tahes allikast) ja rakendab selle DOCX-ile natiivsete Wordi jälgitavate muudatustena. Ehitatud praktiseeriva Singapuri nõustaja poolt, kes vajas deterministlikku dokumenditeisendust.

Sisend

Algne DOCX
Muudetud tekst või diff-väljund

Väljund

DOCX Wordi natiivsete jälgitavate muudatustega (lisandused siniselt, kustutused läbijoonitult)

Kasutus

import { applyRedlines } from '@houfu/redlines';

const result = applyRedlines({
  originalDoc: './contract.docx',
  modifiedText: 'modified contract text here',
  author: 'LQClaw'
});

result.toDocx('./contract-redlined.docx');

Peamised disainiotsused

Deterministlik — sama sisend toodab identse väljundi
Vormingu säilitamine — päised, loendid, tabelid jäävad teisendusel alles
Standardile vastav — väljund on kehtiv DOCX, mida Word renderdab korrektselt
Ilma Wordi ringreisita — töötab peata, Office’i paigaldust ei vaja

Auditoorium ja töö kuju

Auditoorium: juriidilised insenerid ja nõustajad, kes on mugavad JavaScripti teegi kutsungiga töövoost. See ei ole iseteenindustööriist ülevaatuspartnerile ega mõeldud mittetehnilistele kasutajatele. Otsustus, milliseid muudatusi rakendada, jääb selle oskuse ülesvoolu; see oskus kannab need vaid DOCX-i.

Töö kuju: piiritletud tehinguline primitiiv. Tekst sisse (või diff sisse) → DOCX välja. Teisendus on mehaaniline. See ei ole redline’i ülevaataja, ei ole redline’i generaator ega sisuline ülevaatuse samm.

Ulatus ja juriidiline kasutus

See oskus pakub juriidilist tuge, mitte juriidilist nõu. Jälgitavate muudatustega DOCX-i tootmine on mehaaniline dokumenditöötlus; redline’itud väljund on mustand, mitte advokaadi kinnitatud redline ega allkirjastatud tööprodukt. Edukas käivitus tähendab „edastatud muudatused kanti faili Wordi revisjonidena“ — mitte „need muudatused on õiged“ ega „see mustand on saatmiskõlblik“.

Privilegeeritus ja metaandmete avalikustumine. Jälgitavad muudatused kannavad autori metaandmed dokumenti. Kutse author väli (nt 'LQClaw') kirjutatakse Wordi XML-i koos revisjoni ajatemplitega ja säilib salvestatud failis. Igaüks, kes DOCX-i avab (vastaspool, vastasadvokaat, saaja tootmisel), saab seda lugeda. Hoiaak: AI-autorlus peaks olema nähtav — ära maskeeri AI-genereeritud revisjone advokaadi nime või firma identiteedi taha. Käitle redline’itud DOCX-i mustanddokumendina ja hinda andmevoogu firmaga enne mustandfailide väljastamist; privilegeeritud mustandite redline’id võivad olla avastatavad ja võivad privilegeeritust mõjutada, kui neid ringlusse lastakse. Kinnita metaandmete puhastamise samm enne iga välist tarnet ja kinnita firmaga, et ülesvoolu diff ja lähte-DOCX tohivad kutsuvas torustikus töödelda.

Vastutus. Väljund on ülesvoolu diff’i mehaaniline teisendus. Kvalifitseeritud, nimeline advokaat peab redline’itud DOCX-i lehekülg-leheküljelt läbi lugema enne mis tahes kliendi või vastaspoole tarnet. Oskus ei templi provenance’i, ei pea auditi logi ega määra väljundi omanikku — kutsuv töövoog peab tegema kõik kolm.

Kindlusribad

High — lihtsad lõigutaseme diff’id lineaarses kehatekstis, lähtefailis pole olemasolevaid revisjone, diff ei puuduta kommentaare ega joonealuseid, diff ankurdub puhtalt allikale.
Medium — diff puudutab loendeid või tabeleid või ületab lõigupiire; nummerdus säilib, kuid tuleks silmaga üle vaadata. Suuna advokaadi ülevaatusele.
Low / Review — pesastatud nummerdus, joonealused, ristviited, kommentaarid, redline’id, mis ületavad struktuurseid murdekohti (sektsiooni/pealkirja piirid), lähte-DOCX sisaldab juba jälgitavaid muudatusi või diff ei ankurdu üheselt. Ära käsitle väljundit puhta redline’ina; peatu ja eskaleeri.

Väljaspool ulatust

Ei genereeri redline’i — diff või muudetud tekst peab tulema ülesvoolust.
Ei vaata redline’i juriidilise sisu ega muudatuste õigsuse suhtes üle.
Ei säilita kommentaare, joonealuseid ega ristviiteid, kui neid pole käesoleva dokumendikuju jaoks otseselt testitud.
Ei käsitle skaneeritud PDF-e, pilte, parooliga kaitstud faile ega DRM-i all olevaid faile.
Ei käsitle struktuurseid teisendusi (klauslite ümberjärjestamine, lisade liigutused).
Ei moodusta redline’i ülevaatust ega kvaliteedikontrolli allkirjastust kutse-eetika reeglite tähenduses.
Ei puhasta autori metaandmeid, kommentaare ega revisjonide ajalugu väljundist — see on eraldi samm, mida kutsuja omab.

Eskaleerimine

Peatu ja suuna vastutavale advokaadile, kui: - diff ei ankurdu puhtalt allikale (tagasta struktureeritud viga, ära kirjuta osalist redline’i); - lähte-DOCX sisaldab juba jälgitavaid muudatusi või lahendamata kommentaare; - lähte-DOCX on parooliga kaitstud, rikutud või ei ole parsitudav; - diff puudutab joonealuseid, ristviiteid, defineeritud termini paigutust või pesastatud nummerdust; - redline’itud DOCX on firmat lahkumas ja metaandmete puhastamise / provenance’i templi sammu ei ole käivitatud; - kindlusriba Medium või Low on välja antud ja ühtegi nimelist advokaati pole väljundi ülevaatuseks määratud.

Piirangud

Keerukad pesastatud struktuurid võivad vajada käsitsi ülevaatust
Käsitleb ainult tekstitaseme muudatusi (mitte struktuurseid teisendusi)

QA parandus (LegalQuants, 2026-05)

Algne autor: Hou Fu Ang. Tehniline sisu (When to Use, How It Works, Input, Output, Usage, Key Design Decisions, Limitations) säilitatud sõna-sõnalt.

LegalQuants rakendas QA paranduse Legal Skill Design Framework’i vastu 2026-05-11 vastuseks QA aruandele /tmp/qa-results/redlines.md (otsus: MATERIAL CONCERNS — kolm juriidilist tõrkerežiimi adresseerimata). Lisatud: version, last_reviewed, last_reviewed_by frontmatteris; Audience and Work Shape; Scope and Legal Use, mis katab kolm kohustuslikku juriidilist tõrkerežiimi (advice-vs-support, privilege/metadata, accountability), koos Wordi XML autori metaandmete püsivuse spetsiifilise käsitlusega ja hoiakuga, et AI-autorlus peaks olema nähtav, mitte maskeeritud; Confidence Bands seotud dokumendikujuga; Out of Scope („does NOT do“); Escalation päästikud. Tehnilisi juhiseid ega @houfu/redlines API-t ei muudetud.

Muudatuste märgistus