写作守卫 xmutfyh/dsh-plugin-writing-guard

Writing Guard

面向 AI 辅助科研的科学写作与文档完整性守卫

少解释，多论证。守住科学本身。

Writing Guard 把提示词引导的科学写作规范，与确定性的完整性检查结合起来，服务 AI 辅助科研。
它从五个层面保护你的稿件：

| 守卫 | 防的是什么 | 风险 |
| STYLE | 论证经济性 | 防御性写作、过度解释、语义重复、模板腔 |
| EVIDENCE | 科学漂移 | 数值、单位、引用、结论被改 |
| JOURNAL | 期刊不匹配 | scope/style/convention 不匹配 |
| DELIVERY | 上下文泄漏 | prompt、notes、workflow metadata 泄漏 |
| DOCUMENT 🆕 | 文档损坏 | Word 格式、公式、表格、OOXML 被破坏 |

提示词引导写作 · 确定性完整性内核 · 394 项测试

npm install dsh-plugin-writing-guard

Writing Guard 不替你写论文。
它让 AI 辅助写作交付得更安全。

2.0 新增 —— 论证经济性与控制面分离

Writing Guard 2.0 把语义层面的风格决策挪到生成之前，让确定性代码专注做完整性检查。

- 批评不是内容 —— 审稿人、用户、守卫的措辞属于控制上下文，不是稿件证据。
- 能删就别改 —— 如果一句话只是为了挡批评、安抚审稿人、宣传重要性，或者重复一个显而易见的推论，删掉它。
- 不要闭合每个语义环 —— 证据加必要解读之后就停笔；保留不显而易见的统计解读和可复现性细节。
- 只改风格的修订默认等长或更短 —— 没有新增有据内容，就不许解释性膨胀。
- 自动审计不再回注片段或改写建议 —— 只把结构化的规则与动作元数据发回给智能体。
- 新增中英文线索，识别防御性目的框架、语义闭合标记、无内容评价。

示例：

Avoid: To prevent data leakage, normalization was carefully performed using only the training data.
Prefer: Normalization parameters were estimated from the training data.

第二句只陈述方法事实，没有把「为什么要提这件事」的防御理由一并带进来。

🛡️ Word 文档守卫（1.8 引入）

要求改的改，没要求改的验。

AI 辅助编辑文档有个隐蔽风险：要求改的文本可能变好了，稿件里无关的部分却悄悄变了。

你让 AI 智能体「只重写第 3 段」，它可能顺手改掉：

- 公式结构
- 表格边框
- 编号
- 样式
- 版面几何
- 关系
- 嵌入媒体
- OOXML 包部件

Writing Guard 1.8 为 Word 稿件引入文档完整性层：

| 功能 | 作用 |
| 安全范围编辑 | 只有指定范围可以改动 |
| 包校验 | 编辑后验证 DOCX/OOXML 包的完整性 |
| 结构指纹 | 对比编辑前后的文档结构 |
| 公式完整性 | 检查公式结构、编号连续性、数学字体漂移 |
| 学术表格感知 | 区分数据表格与版面/图片容器 |
| 前后完整性验证 | 确定性验证，不是「我觉得没问题」 |

前后对比

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

用 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.

快速开始

Install
dsh plugin add dsh-plugin-writing-guard

Restart
dsh web

自然语言用法

安装完成后，你可以直接用自然语言：

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

五道防线 — 详解

STYLE — 论证经济性与行文纪律

在写作前引导宿主模型，随后用确定性线索审查机械、防御性、过度解释的行文：

- 修订残留：revised、as requested、本轮、审稿人要求
- 防御性写作：堆叠让步、预先化解局限
- 机械修辞：不是X而是Y、滥用 rather than、三重排比
- LLM 高频词：delve / tapestry / testament（按密度判断）
- 中文句式与平均句长异常

EVIDENCE — 学术性 + 认识论锁定

在 AI 编辑过程中保护科学事实：

- 数字、百分比、p 值、置信区间、单位
- 引用、图/表编号、DOI
- 因果强度：associated with 不能变成 caused
- 阴性结果：no significant difference 不能消失
- 范围边界与证据状态

JOURNAL — 目标期刊契合度

按目标期刊惯例校准稿件：

- 句法结构（句长、段长）
- 语态与人称（被动语态、第一人称使用）
- 引用（文献引用、图/表引用）
- 科学论断（论断密度、因果/证据强度）
- 修辞动作（覆盖范围、规范顺序）

DELIVERY — 上下文泄漏检测

阻止工作流上下文泄漏到最终产物里：

- 被否决的备选方案
- 修订过程残留
- 来源泄漏
- 防御性模糊表述泄漏

DOCUMENT — Word 文档完整性 🆕

安全编辑 Word 稿件，不破坏结构：

writing_word_scan → writing_word_edit → writing_word_scope_check

13 个工具，覆盖完整的文档完整性检查：

| 工具 | 用途 |
| writing_word_scan | 结构扫描 |
| writing_word_edit | 安全范围编辑 |
| writing_word_audit | .docx 写作审计 |
| writing_word_scope_check | 范围完整性校验 |
| writing_word_format_tables | 三线表格式化 |
| writing_word_audit_equations | OMML 公式审计 |
| writing_word_package_validate | OOXML 包校验 |
| writing_word_fingerprint | 基线格式指纹 |
| writing_audit | 文本写作审计 |
| writing_rules | 写作规范 |
| writing_style_profile | 作者风格配置档 |
| writing_journal_profile | 期刊配置档 |
| writing_delivery_audit | 交付完整性审计 |

安装

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

前置条件：
- Node.js ≥ 18
- Python 3.10+，并安装 python-docx（pip install python-docx）

架构

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

设计原则： 基线稿件 > 期刊/模板 > 插件默认值。

LLM/智能体决定改什么。确定性的 Word 代码决定怎么改，同时不悄悄改动无关格式。

测试

npm test

394 个确定性测试，覆盖：
- STYLE、Scholarship Lock、Epistemic Lock
- 主张对齐、局部引用完整性
- Journal Profile、Journal Fit
- DELIVERY（CAL 检测）
- Word Guard（v1.8.2）：OOXML 校验、指纹、公式审计

安全与隐私

- 确定性完整性检查在本地运行；语义写作决策由宿主模型在 Writing Guard 策略下处理。
- 插件只读取正在编辑的文件。
- 插件本身不上传、不收集稿件内容。
- 见 SECURITY.md

为什么需要 Writing Guard？

| | Writing Guard | Humanizer | AI Detector |
| 写作前规则 | ✅ | ❌ | ❌ |
| 写作中检查 | ✅ | 通常 ❌ | ❌ |
| 自动监控稿件 | ✅ | ❌ | ❌ |
| 全文重写 | ❌ | ✅ | ❌ |
| 问题可解释 | ✅ | 部分 | 部分 |
| 确定性完整性检查 | ✅ | 通常没有 | 视情况而定 |

Humanizer 在写完后重写。Writing Guard 在写作过程中预防。

品牌

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

经典口号： Less AI. More Evidence. Better Journal Fit. Clean Delivery.

文档口号： Change what was requested. Verify what wasn't.

CHANGELOG

见 CHANGELOG.md。

License

MIT