---
title: Muudatuste märgistus
description: Loob Wordi dokumentidesse võrdluse põhjal jälgitavad muudatused.
category: Legal
sublabel: Lepingud
author: LegalQuants
tags: 
license: Apache-2.0
source: https://github.com/LegalQuants/lq-skills
---

# 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

```javascript
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.