---
title: Wordi muudatuste jälgimine
description: Rakendab Wordi dokumentidele programmiliselt sõnatasemel jälgitavaid muudatusi, säilitades vorminduse.
category: Legal
sublabel: Dokumentide ülevaatus
author: LegalQuants
tags: 
license: Apache-2.0
source: https://github.com/LegalQuants/lq-skills
---

# office-word-diff

## Millal kasutada

- Pead rakendama tehisaru genereeritud muudatusi Wordi dokumentides jälgitavate muudatustena
- Ehitad juriidilist tööriista, mis toodab DOCX väljundit redline'idega
- Vajad deterministlikku sõnatasemel tekstivõrdlust (mitte ainult reatasemel diffi)
- Tahad säilitada vormingut dokumenditeisenduste jooksul
- Integreerud Claude Code'i, Cursori või teiste agentidega, mis toodavad dokumendimuudatusi

## Kuidas see töötab

### Põhiprobleem

Enamik diff-tööriistu töötab rea või lõigu tasemel. Wordi dokumentidel on struktuurne keerukus — pesastatud loendid, tabelid, päised, vormingujooksud —, mida reatasemel diffid hävitavad. `office-word-diff` lahendab tuumaprobleemi: sõnatasemel jälgitavate muudatuste rakendamine DOCX-ile vormingut säilitades.

### Arhitektuur

1. **Parseeri** — Loe DOCX Office.js API kaudu, võta välja tekstijooksud koos vormingu metaandmetega
2. **Diff** — Arvuta sõnatasemel erinevused vana ja uue teksti vahel
3. **Teisenda** — Lisa Wordiga ühilduvad jälgitavad muudatused (lisamised/kustutamised) vormingut säilitades
4. **Väljund** — Tagasta kehtiv DOCX natiivsete Wordi jälgitavate muudatustega

### Kasutamine

```javascript
import { diffWords } from 'office-word-diff';

const result = await diffWords(oldDoc, newDoc, {
  trackChanges: true,
  author: 'LQClaw'
});
```

### Peamised omadused

- **Granulaarsed jälgitavad muudatused** — sõnatasemel, mitte lõigutasemel
- **Vormingu säilitamine** — paks, kursiiv, allakriipsutused jäävad teisenduses ellu
- **Pesastatud struktuurid** — käsitleb tabeleid, loendeid, päiseid korrektselt
- **Agendisõbralik** — töötab Claude Code'i, Gemini CLI, Codexiga taustana
- **Deterministlik** — sama sisend toodab sama väljundi (erinevalt hapratest tekstivaste lähenemistest)

## Sihtgrupp ja töö kuju

Sihtgrupp: advokaadid ja arendajad, kes ehitavad Wordi lisarakendusi või dokumenditeisendustööriistu, mis väljastavad natiivseid jälgitavaid muudatusi. Väljundit tarbib Microsoft Word ja lõpuks kinnitab advokaat.

Töö kuju: Piiratud tehinguline. Oskus rakendab määratletud sõnatasemel muudatusi DOCX-ile ja väljastab muudetud DOCX-i. See ei otsusta, milliseid muudatusi rakendada.

## Ulatus ja õiguslik kasutus

See oskus pakub juriidilist *tuge*, mitte õigusnõu. Väljund on DOCX jälgitavate muudatustega — mitte kinnitatud, allkirjastatud ega vastaspoolele või kohtule saatmiseks sobiv redline.

**Privilege ja konfidentsiaalsus.** Jookseb kliendipoolselt Office.js kaudu. Võrgukutseid pole. Oskus ei edasta dokumendisisu kuhugi. Privilege'i risk sõltub täielikult sellest, mida kutsuv rakendus sisendi ja väljundiga teeb — advokaat peab andmevoogu kontrollima.

**Vastutus.** Kvalifitseeritud advokaat peab enne muudetud dokumendi vastuvõtmist, saatmist, esitamist või salvestamist üle vaatama iga jälgitava muudatuse. Autori väli (`author: 'LQClaw'` kasutusnäites) teeb tehisaru päritolu Wordi revisjoni metaandmetes nähtavaks — hoia see nähtavana, selle asemel et maskeerida inimese autoriks.

## Kindlusvahemikud

Diff ise on deterministlik, kuid `newDoc` *ülesvoolu* genereerimine (tehisaru agendilt) ei ole. Märgi jälgitavad muudatused ülesvoolu agendi kindlusega, kus võimalik:

- **Kõrge** — väike, piiritletud muudatus (kirjaviga, määratletud termini asendus, ristviite parandus).
- **Keskmine** — klauslite ümberkirjutused, lõikude ümberjärjestamine või mis tahes sisuline muutus. Alati advokaadi ülevaatusega.
- **Madal** — mitme klausli või terve jaotise ümberkirjutused. Käitle mustandettepanekuna, mitte redline'ina.

## Väljaspool ulatust

- Mitte **täidetud lepingute** jaoks ilma eraldi muudatusprotokolli kontrollideta.
- Mitte **kohtuvaidluse hoidmise** või e-avastamise all olevate dokumentide jaoks, kus originaalmetaandmed peavad säilima.
- Mitte lõplik saatmissamm — ära kunagi võta muudatusi automaatselt vastu ja edasta.
- Mitte dokumentidele, millel on **DRM, IRM või õigustega hallatud kaitse** (ebaõnnestub või eemaldab kaitse).
- Mitte dokumentidele, millel on olemasolevad **vastuvõtmata jälgitavad muudatused**, kui kutsuv tööriist neid eksplitsiitselt ei käsitle (olek peab esmalt olema ühildatud).

## Eskaleerimine

Peatu ja suuna vastutavale advokaadile, kui:
- pesastatud tabeli muudatust ei saa rakendada ilma struktuurikaotuseta;
- sisend-DOCX-il on olemasolevad vastuvõtmata jälgitavad muudatused teiselt autorilt;
- ülesvoolu agent tootis madala kindlusega muudatuste komplekti või vastuolulisi muudatusi;
- dokument on õigustega hallatud, krüpteeritud või kohtuvaidluse hoidmise all.

## Piirangud

- Nõuab Office.js-i (peab jooksma Wordi kontekstis või peata Wordis)
- Ainult Windows/macOS (Wordi jaoks Linuxi pole)
- Väga keerukatel pesastatud tabelitel võib olla äärealuseid juhtumeid