xmutfyh/dsh-plugin-writing-guard · 上手攻略

  • 仓库：xmutfyh/dsh-plugin-writing-guard
  • 链接：https://github.com/xmutfyh/dsh-plugin-writing-guard
  • 分类：Developer Tools · 学术写作工具
  • 作者：Jay
  • 更新：2026-08-16

是什么

dsh-plugin-writing-guard 是 DeepSeek Harness（DSH）的论文写作守卫插件，在论文撰写和修改过程中自动检测常见 AI 写作风格、修改残留、防御性表达与机械化句式，同时提供 Scholarship Lock 功能在 AI 润色时保护科研事实（数字、p值、图表编号等核心实体不被悄悄改动）。定位是学术写作 linter——不是"写完再改"的 AI Humanizer，而是"边写边防"的实时守卫。

核心机制：本地正则/统计规则，零网络、零 LLM 调用，毫秒级返回（v0.7+）。

解决什么问题

  1. 修改过程残留：AI 辅助修改后，正文中遗留 "revised model"、"as requested by the reviewer"、"we have updated" 等元话语
  2. 防御性过度写作：滥用 hedge（may/might/could/potentially 密度过高），导致结论软弱无力
  3. LLM 高频机械表达：delve/tapestry/testament/leverage/robust/crucial 等词汇密度异常
  4. 科研实体被改：润色过程中数字、百分数、p 值、置信区间、Figure/Table 编号、DOI 等被悄悄改动
  5. 格式问题：破折号滥用、冒号标题、LaTeX 正文中出现 Unicode 数学符号
  6. 超长句与重复绕圈：一句话承载过多独立论点，或同一观点换三种说法重复表达

快速安装

从 npm 安装（已发布，推荐）

dsh plugin --profile web add dsh-plugin-writing-guard

从 GitHub 安装

# 方式一：GitHub 源
dsh plugin --profile web add github:xmutfyh/dsh-plugin-writing-guard

# 方式二：直接 tarball
dsh plugin --profile web add https://github.com/xmutfyh/dsh-plugin-writing-guard/archive/refs/heads/master.tar.gz

# 方式三：本地源码目录
dsh plugin --profile web add ./path/to/dsh-plugin-writing-guard

安装后重启生效：

dsh web

无 DSH 环境独立使用

仓库根提供独立 SKILL.md，可在 Codex / Claude Code / Antigravity 等无 DSH 环境中直接使用同一套写作纪律规则集。

核心工具与用法

1. writing_rules — 写作前加载纪律

在论文开始写作前调用，返回学术写作纪律速查（含 profile 说明与密度阈值），帮助在动笔前建立规范意识。

// DSH 工具调用示例
{
  "tool": "writing_rules",
  "parameters": {}
}

2. writing_audit — 扫描问题

核心工具，扫描文本或文件中的 AI 风格问题、修改残留、防御性写作等：

{
  "tool": "writing_audit",
  "parameters": {
    "filePath": "manuscript/main.md",
    "profile": "manuscript",
    "verbose": true
  }
}

参数说明： - text：直接传入待检文本 - filePath：文件路径，二选一 - profile：文档类型（manuscript / rebuttal / cover_letter / review / notes / unknown），路径含 rebuttal/cover_letter/manuscript 关键词时自动推断 - verbose：true 时返回每条问题的详细建议 - projectResidueTerms：自定义修改残留词表（追加到默认黑名单） - original（v0.6+）：Scholarship Lock，传入润色前原文，与当前版本对比科研实体变化 - styleProfile（v0.6+）：作者风格档案 JSON，来自 writing_style_profile 输出

输出示例（verbose=true）：

写作纪律检查报告（文档类型: manuscript）：发现 3 处问题（高 3 / 中 0 / 低 0）
- 统计：1 段 / 115 字符（英文 19 词）；破折号 0；rather than 0；三连排比 0…

🔴 [HIGH · conf high] 正文出现 "revised/revision" 修改过程残留 [para 0]
  原文：The revised model uses the ΔP regression objective only. As requested by the reviewer, we h…
  提示：正文中出现修改过程语言，这是写给审稿人的元话语；正式论文读者只应看到最终版本。
  建议：改为中性论文语言：the proposed model / the model / the present analysis

🔴 [HIGH · conf high] 审稿回应用语残留 [para 0]
  建议：直接陈述做法或结果本身，不引用审稿过程。

3. writing_style_profile（v0.6+）— 作者风格档案

从作者历史论文学习句长、破折号/hedge/连接词密度等指标，生成 JSON 风格档案，供 writing_audit 使用：

{
  "tool": "writing_style_profile",
  "parameters": {
    "filePath": "author/papers/previous_work.md",
    "learnDir": "author/papers/"   // 或指定目录
  }
}

典型适用场景

  1. SCI 论文写作：在 DSH 中写 manuscript 时，agent 每次 write/edit 论文文件后自动触发审计（v0.5 增量模式）
  2. rebuttal 润色：逐条回复审稿人时，检测 cover_letter/manuscript 中的修改残留，同时 rebuttal 本身不误报
  3. AI 润色后校验：用 ChatGPT/Claude 润色后，通过 Scholarship Lock 核验数字/图表编号是否被改动
  4. 批量扫描已有稿件：对已完成的论文进行离线检查，定位所有 AI 风格问题

规则体系（v0.7 核心规则一览）

类别 检测内容 阈值（英文） 阈值（中文）
修改过程残留 "revised model"/"as requested by the reviewer"/"we have updated" 等 — —
防御性过度写作 hedge 密度 ≥5 次且 ≥300/千句 ≥5 & ≥300/千句 同
限定词堆叠 一条 claim 套多层保险 may potentially suggest → 只留一层 同
超长句 >35 词且 ≥3 从句 >35 词 & ≥3 从句 >80 字 & ≥5 逗号 & ≥3 连接词
重复绕圈 同段相邻句 token 余弦相似 ≥0.72 且无新证据 ≥0.72 相似度 同
LLM 高频词 delve/tapestry/testament/leverage 等 ≥2 次且 ≥0.4/千词 —
中文空洞热词 robust/crucial/机制/耦合/范式 等 ≥5 且 ≥1.0/千词（中 ≥10 且 ≥3.0/千字） —
多重"的"字链 中文连续 ≥3 个"的"修饰嵌套 — ≥3 个"的"
破折号密度 — ≥5 次且 ≥0.5/千词 —
平均句长 全文均值 英 >18 词 中 >25 字
Scholarship Lock 🔴 数字/百分数/p值/置信区间/\cite/\ref/图表编号变化 — —
Unicode 数学符号 LaTeX 正文中 ₁₂₃²³αβ×− 等 — —

⚠️ 有证据的 hedging 是正确学术表达，本工具不是"反 hedge 工具"。rebuttal profile 下 hedge 密度正常不报警（ICMJE 要求）。

坑与注意

  1. 不是 AI 检测器：本工具检测的是机械化/模板化写作风格，而非"是否由 AI 生成"；定位是 linter，不是检测器
  2. rebuttal 不报警的原因：审稿回复信中"we have addressed"是正常表述，profile 为 rebuttal 时默认放行；cover_letter/manuscript 则严格检查
  3. Scholarship Lock 需主动传入原文：v0.6+ 支持，但需要调用方在润色前主动传入 original 参数，否则无法对比科研实体变化
  4. v0.5 增量模式：审计状态按文件持久化，重新启动 DSH 后自动从上次状态继续，适合长篇论文逐段推进
  5. 工具监听触发条件：仅在 write/edit 操作写入论文类文件（.md/.tex/.txt，路径含 manuscript/paper/revision/论文/修订/返修…）时触发，修改无关文件不触发

与同类对比

工具 定位 核心能力 局限
Writing Guard（本插件） 学术写作 linter 实时守卫 + 本地规则 + Scholarship Lock 需 DSH 环境
AI Humanizer（如 QuillBot） 改写工具 整段重写 写完再改，不检测
AI Detector（如 GPTZero） 检测器 判断是否 AI 所写 不告诉你为什么，且检测本身不可靠
LanguageTool 语法/风格检查 通用英语语法 不懂学术写作规则

Writing Guard 的差异化价值："边写边防"工作流 + 零网络 + 可解释的规则（每条带 confidence 标注）。

一句话推荐结论

写学术论文时，若在 DeepSeek Harness 中工作，dsh-plugin-writing-guard 是目前最贴近"学术写作纪律实时守卫"定位的工具——毫秒级本地检查，不依赖任何网络或 LLM，特别适合在 agent 辅助写作流程中作为自动化质量关卡。

原始链接：https://github.com/xmutfyh/dsh-plugin-writing-guard