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

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