Writing Guard

September 1, 2026 · View on GitHub

Scientific Writing & Document Integrity Guard for AI-assisted research

Less AI. More Evidence. Better Journal Fit. Safer Documents.

Writing Guard is a local, deterministic guardrail for AI-assisted scientific writing. It protects your manuscript across five layers:

Guard	Protects against	Risk
STYLE	AI writing fingerprints	机械排比、过度连接词、模板腔
EVIDENCE	Scientific drift	数值、单位、引用、结论被改
JOURNAL	Journal mismatch	scope/style/convention 不匹配
DELIVERY	Context leakage	prompt、notes、workflow metadata 泄漏
DOCUMENT 🆕	Document corruption	Word 格式、公式、表格、OOXML 被破坏

Local · Deterministic · Zero Network · Zero LLM · 380+ Tests

npm install dsh-plugin-writing-guard

Writing Guard does not write your paper for you. It makes AI-assisted writing safer to ship.

🛡️ New in 1.8 — Word Document Guard

Change what was requested. Verify what wasn't.

AI-assisted document editing introduces a subtle risk: the requested text may improve while unrelated parts of the manuscript silently change.

When you ask an AI agent to "rewrite paragraph 3 only," it may inadvertently modify:

equation structures
table borders
numbering
styles
section geometry
relationships
embedded media
OOXML package parts

Writing Guard 1.8 introduces a document-integrity layer for Word manuscripts:

Feature	What it does
Safe scoped editing	Only the specified range can change
Package validation	Verifies DOCX/OOXML package integrity after editing
Structural fingerprinting	Compares document structure before and after
Equation integrity	Checks equation structure, numbering continuity, math-font drift
Scholarly table awareness	Distinguishes data tables from layout/figure containers
Pre/post integrity verification	Deterministic verification, not "I think it's fine"

Before / After

Without Writing Guard:

"Please improve the wording in paragraph 3."
→ AI agent modifies DOCX.
→ Result: paragraph looks better.
→ Unknown: what else changed?

With Writing Guard:

"Please improve the wording in paragraph 3."
→ Writing Guard:
   ✓ scope validated
   ✓ package valid
   ✓ equations preserved
   ✓ protected structures unchanged
   ✓ document fingerprint checked
→ Result: paragraph changed — and unintended document drift is detected.

Quick Start

# Install
dsh plugin add dsh-plugin-writing-guard

# Restart
dsh web

Natural Language Usage

Once installed, you can use natural language:

Say this	Writing Guard does this
"帮我检查论文写作质量"	`writing_word_audit`
"把表格改成三线表"	`writing_word_format_tables`
"扫描DOCX结构"	`writing_word_scan`
"修改第三章的XXX"	`writing_word_edit`
"编辑后验证范围"	`writing_word_scope_check`
"检查有没有AI味"	`writing_audit`

Five Guards — Detailed

STYLE — AI Writing Detection

Detects and reduces机械化、模板化、过度防御的 AI writing:

Revision residue: revised, as requested, 本轮, 审稿人要求
Defensive writing: concession stacking, limitation pre-emption
Mechanical rhetoric: 不是X而是Y, rather than abuse, triple parallelism
LLM high-frequency words: delve / tapestry / testament (density-based)
Chinese patterns and average sentence length anomalies

EVIDENCE — Scholarship + Epistemic Lock

Protects scientific facts during AI editing:

Numbers, percentages, p-values, confidence intervals, units
Citations, Figure/Table numbers, DOI
Causal strength: associated with cannot become caused
Null findings: no significant difference cannot disappear
Scope boundaries and evidence status

JOURNAL — Target Journal Fit

Calibrates manuscript against target journal conventions:

Syntax structure (sentence length, paragraph length)
Voice and person (passive voice, first-person usage)
Citations (bibliographic, figure/table references)
Scientific claims (claim density, causal/evidential strength)
Rhetorical moves (coverage, canonical order)

DELIVERY — Context Leakage Detection

Stops workflow context from leaking into final artifacts:

Rejected alternatives
Revision process residue
Provenance leakage
Defensive hedge leakage

DOCUMENT — Word Document Integrity 🆕

Safely edit Word manuscripts without breaking structure:

writing_word_scan → writing_word_edit → writing_word_scope_check

13 tools for complete document integrity:

Tool	Purpose
`writing_word_scan`	Structural scan
`writing_word_edit`	Safe scoped editing
`writing_word_audit`	Writing audit for .docx
`writing_word_scope_check`	Scope integrity verification
`writing_word_format_tables`	Three-line table formatting
`writing_word_audit_equations`	OMML equation audit
`writing_word_package_validate`	OOXML package validation
`writing_word_fingerprint`	Baseline formatting fingerprint
`writing_audit`	Text writing audit
`writing_rules`	Writing guidelines
`writing_style_profile`	Author style profile
`writing_journal_profile`	Journal profile
`writing_delivery_audit`	Delivery integrity audit

Installation

# From npm (recommended)
dsh plugin add dsh-plugin-writing-guard

# From GitHub
dsh plugin add github:xmutfyh/dsh-plugin-writing-guard

# From local source
dsh plugin add ./path/to/dsh-plugin-writing-guard

Prerequisites:

Node.js ≥ 18
Python 3.10+ with python-docx (pip install python-docx)

Architecture

Writing Guard
├── STYLE (writing_audit)
│   ├── Revision residue detection
│   ├── AI style patterns
│   └── Density-based thresholds
├── EVIDENCE (Scholarship/Epistemic Lock)
│   ├── Number/unit preservation
│   ├── Citation integrity
│   └── Claim strength conservation
├── JOURNAL (Journal Profile)
│   ├── Corpus-aware analysis
│   ├── Section-level comparison
│   └── Rhetorical move matching
├── DELIVERY (CAL Detection)
│   ├── Rejected alternative leakage
│   ├── Process residue
│   └── Baseline reality check
└── DOCUMENT (Word Guard) 🆕
    ├── Structural scanning
    ├── Safe editing
    ├── Package validation
    ├── Fingerprinting
    └── Equation audit

Design principle: Baseline manuscript > journal/template > plugin defaults.

The LLM/agent decides what should change. Deterministic Word code decides how to make that change without silently altering unrelated formatting.

Tests

npm test

380+ deterministic tests covering:

STYLE, Scholarship Lock, Epistemic Lock
Claim alignment, local citation integrity
Journal Profile, Journal Fit
DELIVERY (CAL detection)
Word Guard (v1.8.2): OOXML validation, fingerprinting, equation audit

Security & Privacy

All rules run locally: zero network, zero LLM
Plugin only reads files being edited
No content collection or upload
See SECURITY.md

Why Writing Guard?

	Writing Guard	Humanizer	AI Detector
Pre-writing rules	✅	❌	❌
During-writing checks	✅	Usually ❌	❌
Auto-monitor manuscript	✅	❌	❌
Full rewrite	❌	✅	❌
Explainable issues	✅	Partial	Partial
Local rules (zero LLM)	✅	Usually no	Depends

Humanizer rewrites after writing. Writing Guard prevents during writing.

Brand

                  WRITING GUARD
                       │
       Scientific Writing & Document Integrity
                       │
 ┌─────────┬──────────┬─────────┬──────────┬──────────┐
 STYLE   EVIDENCE   JOURNAL   DELIVERY   DOCUMENT
                                            │
                               Change what was requested.
                               Verify what wasn't.

Classic slogan: Less AI. More Evidence. Better Journal Fit. Clean Delivery.

Document slogan: Change what was requested. Verify what wasn't.

CHANGELOG

See CHANGELOG.md.

License

MIT