dsh-writing-discipline
Manifest validDSH plugin: defensive-writing gate with fact-conservation lock (zero network, zero LLM)
dsh-writing-discipline
给 DeepSeek Harness(DSH)的写作纪律闸门:把「防御性写作」从输出里剃掉,同时锁住事实层不许被动。
零网络、零 LLM、纯本地正则 + 统计。六个工具加一道交付闸门,全部确定性:同样的输入永远给同样的输出,可进 CI、可写进 pre-commit。
输入:作为一个AI助手,我无法保证该结论的准确性。请注意,生产环境操作存在风险。本内容仅供参考。
输出:写作纪律检查:发现 6 处问题(ERROR 5 / WARN 1 / INFO 0)
🔴 [ERROR · defensive · CUT] 能力自贬(自我指认) @ L1
「作为一个AI助手」 …作为一个AI助手,我无法保证该结论的准确性。…
→ 删掉自我指认,直接从结论开始。
为什么需要它
模型写东西时会为不被指责而写,不是为把事交付而写。表现是五类固定动作:
| 病灶 | 典型形态 | 代价 |
|---|---|---|
| 免责 | 「仅供参考」「不构成任何建议」 | 交付物变成半成品,责任推回读者 |
| 能力自贬 | 「作为一个 AI」「能力有限」「如有疏漏」 | 占篇幅,零信息 |
| 说教劝退 | 「请注意」「务必确保」「建议谨慎」 | 用姿态替代参数 |
| 无意义对冲 | 「可能或许大概」「一定程度上」 | 主张被稀释到无法据此决策 |
| 过程旁白 | 「首先我需要了解…」「接下来我将」 | 纯噪音 |
这些不是风格偏好问题:它们让读者无法行动。而清理它们的最大风险不是删不干净,是顺手把真事实一起删了——数字、引用、否定、适用边界、主张强度。所以本项目做两件事,缺一不可:
wd_scan/wd_rewrite:找出并清掉防御性噪音;wd_conservation:对比改写前后,证明事实层一个字都没动。
只做第 1 件是排版工具,只做第 2 件是审计工具。两个一起才是「能放心自动跑」的闸门。
交付闸门:为什么不靠自觉
扫描器有个致命弱点:它只有被调用时才存在。
真实事故:一份 8 页课程作业,插件装在本机、工具就在手边,但第一版从头到尾没被扫过一次。事后初扫才发现 ERROR 1 / WARN 11、破折号密度 8.9‰、六处「不是X而是Y」——典型的模型味。工具没失效,是流程没闭环:靠「记得调用」的护栏,等于没有护栏。
所以 0.3.0 把判定挪到 present 之前,并且按文件内容 sha256 记账:
| 情况 | present 的结果 |
|---|---|
| 扫过且 ERROR 0,内容未变 | 放行 |
| 从未扫描 | 拒绝,理由里给出该文件的确切 wd_scan 命令 |
| 扫描后仍有 ERROR | 拒绝,要求改完重扫 |
| 扫描后又改过文件 | 拒绝——内容指纹变了,旧通行证自动失效 |
| 非文档(图片、数据、压缩包) | 不拦 |
两个挂载点:tools/pre-execute(主判定,异步校验指纹)与 ctx.tools.guard(同步兜底,防其他监听器把 deny 改名放行)。.pdf 认源文件:同目录同名 .docx/.pptx/.xlsx/.md/.tex 通过即放行。
配置在插件 config 里:gate: 'block' | 'warn' | 'off',默认 block。
直接读 Office 文件
wd_scan / wd_stats / wd_conservation 现在接受 .docx/.docm/.pptx/.pptm/.xlsx/.xlsm:内置 ZIP 中央目录解析 + zlib.inflateRawSync,抽取 OOXML 正文(含表格单元格),不需要先转文本。这样闸门才能直接校验你真正要交付的那个文件,而不是它的某个中间副本。
wd_scan({"filePath":"作业.docx","profile":"report"}) → 抽正文、扫描、记账
present({"files":[{"path":"作业.docx"}]}) → 校验指纹后放行或拒绝
安装
方式 A:本地 link(开发/自用)
dsh plugin --profile desktop add link:C:/path/to/dsh-writing-discipline
方式 B:从 GitHub 装
dsh plugin --profile desktop add github:oobitoooo/dsh-writing-discipline
装完重启 DSH(或等插件热加载),wd_* 五个工具即出现在工具表里。
兼容性:只用到 ctx.tools.register + defineTool,DSH 0.1.x 与 0.2.x 均可。没有 postinstall 脚本、不写磁盘、不改配置。
八个工具
wd_scan — 扫描
{ "text": "……", "profile": "chat", "severityMin": "warn", "maxWarn": 3, "verbose": true }
// 或 { "filePath": "docs/report.md" }
返回 ERROR / WARN / INFO 计数、逐条命中(ruleId / 行号 / 段落 / 命中原文 / 语义片段 / 建议动作)、以及文本指标(平均句长、对冲密度、破折号密度)。
profile 影响判定严格度:
| profile | 行为 |
|---|---|
chat(默认常见) | hedge 记 WARN,说教/免责记 ERROR |
report / readme / email | 同上,元评论残留加重 |
academic | hedge 全部降级为 INFO——学术 hedging 是 ICMJE 认可的正当表达,不该判失败 |
review | 「as requested」「按要求」类过程残留不报 |
wd_rules — 规则速查
列出 24 条规则 + 3 条密度规则在指定 profile 下的实际严重度。写作前扫一眼,比写完再改便宜。
wd_rewrite — 确定性改写
只做三件有把握的事:
- 剥离引子:
好的,/请注意,/需要注意的是,/温馨提示: - 压缩堆叠:
可能或许→可能;may potentially→may - 删纯防御句:整句只承担免责/客套功能
硬约束:含数字、引用、图表编号、链接的句子永不删除。 返回改写后文本 + 逐条变更记录 + 改后复扫。
它不生成新句子。语义级改写仍要人来做——但这一遍能便宜地砍掉大半噪音。
wd_conservation — 守恒锁
{ "original": 原文, "revised": 改后文本 } // 或 originalPath / revisedPath
检查四类事实漂移:
| 检查 | 级别 | 说明 |
|---|---|---|
| 数字 / 单位 / 百分比 / p 值 / n= | INVARIANT | 丢失即 HIGH,必须回滚 |
| 引用键 / 图表编号 / DOI / URL | INVARIANT | 同上 |
| 主张强度上调 | VIOLATION | 可能→导致、associated→caused、suggests→proves |
| 段落否定漂移 | INVARIANT | 相似度 ≥40% 的段落里 不/未/never 数量变了 |
| 适用边界词消失 | CANDIDATE | 仅/限于/only/within 被删——人工确认 |
INVARIANT / VIOLATION 出现即 ok: false,CI 直接红。
wd_stats — 指标
字符 / 中文词数 / 英文词数 / 段落 / 句数 / 平均句长 / 对冲密度(每千语言单位)/ 破折号密度。改写前后各跑一次,数字会说话。
wd_learn — 用户词表(处理误报)
内置规则误报时,别整条关掉——记一条反例,下次自动放行:
{ "action": "add", "phrase": "这个方案可能有效", "label": "这句是我要的写法" } // 默认 suppress:压制误报
{ "action": "add", "phrase": "赋能矩阵", "mode": "rule", "severity": "error" } // 或加成主动规则
{ "action": "list" } // 看现有条目
{ "action": "remove", "id": "user.21ff2332" }
存在 ~/.dsh/writing-discipline/learned.json(纯 JSON,可审计、可进 git、可回滚)。suppress 的判定范围是命中片段前后 20 字——不是一个词压掉整行。
命令行(CI / pre-commit)
插件不只在对话里能用,也带一个独立 CLI——装了包就有 wd-lint:
wd-lint README.md docs/DESIGN.md # 多文件
cat x.md | wd-lint - # stdin
wd-lint -t "本内容仅供参考。" # 直接测一段
wd-lint -m 3 src/ # WARN 预算 3
wd-lint --json x.md # JSON,给 CI 解析
wd-lint --fix x.md # 就地改写(原文件存 .bak)
wd-lint --diff before.md after.md # 守恒锁:两版事实是否漂移
退出码:0 通过 / 1 有 ERROR 或超出 WARN 预算 / 2 用法或 IO 错误。
WARN 预算是给存量项目用的:一开始必然一堆 WARN,直接卡死没人会开。先清到 ERROR=0,再把预算从 20 一周周压到 0——wd-lint -m 3 就是「这周最多容忍 3 个 WARN」。
pre-commit 示例:
- repo: local
hooks:
- id: writing-discipline
name: writing discipline
entry: wd-lint -m 0
language: node
types: [markdown, text]
判定分级
| 级别 | 含义 | CI 策略 |
|---|---|---|
ERROR | 防御性写作,删掉不损失信息 | 必须为 0 |
WARN | 可疑:软对冲、绝对化、套话 | 设阈值,看趋势 |
INFO | 学术语境下的正当 hedging | 不计入失败 |
每条命中都带 action:
CUT— 整句删TIGHTEN— 压缩(保留信息,去掉保险层)REFRAME— 改写成事实句(条件 → 后果)REVIEW— 需要人判,别自动删
REVIEW 存在的理由:不是X而是Y 用一次是强调,用三次是套路;我们认为 有时是弱的正当解释。工具只负责把它标出来,删不删由你定。
规则表(25 条 + 3 条密度)
| 组 | 规则 |
|---|---|
| 防御性 | 能力自贬、拒绝式措辞、道歉、自我评价、免责类、防御性声明、推责专业人士、合规姿态 |
| 元评论 | 社交尾巴、开场白、过程旁白、反问请示、修改过程残留 |
| 对冲 | 中文信使词、英文信使词、模糊程度词、限定词堆叠(ERROR) |
| 文体 | 绝对化、填充开头、中文套话、英文套话、不是X而是Y、元评论开场白、铺垫式开头 |
| 密度 | 段落软对冲 ≥3 处且 0 处量化数据 → ERROR、破折号 >6‰、超长句(中 >55 字 / 英 >34 词) |
密度规则是这套工具和普通禁词表的关键差别:单个 可能 不是问题,一段里三个 可能 且一个数字都没有才是问题。
中文语境专门适配(v0.4.0)
中文不是英文的翻译版。同一句「高度重视、狠抓落实」,在公文里是合规句式,在技术复盘里是空转,在营销文案里是话术——判定标准随语域变化,所以中文单独成层,不再往通用规则表里塞正则。
选语域:
| profile | 场景 | 专属检测 |
|---|---|---|
gov | 公文 / 通报 / 请示 | 特此通知、现将…通知如下、请遵照执行(INFO,公文里属合规)、口号式动词串、"根据有关规定" |
tech | 技术方案 / 复盘 | "性能得到明显提升"(无指标)→ ERROR、大量/少量/比较快(无数量级) |
support | 客服 / 工单回复 | 亲 / 宝子、感谢您的理解与支持、如有疑问请联系客服 |
marketing | 营销 / 推广 | 全网最低、100% 正品 → ERROR、限时抢购、仅剩 N 件、手慢无 |
media | 媒体稿 / 公众号 | 你有没有发现…、让我们拭目以待 |
通用部分(所有语域都跑):名词化冗余(「进行了优化」→「优化了」)、「被…所」、长「的」链、约…左右 / 超过…以上、半角标点混入中文、连续感叹号、文言式对冲(恐怕/兴许/未必)、话语填充(从某种意义上说)。
中文密度两条:单句逗号 ≥5、单句汉字 ≥60;另有节奏判定(句长变异系数 <0.25 视为过于均匀)与结构三条(三连排比、连续转折词、列表疲劳)。指标按字算,不按词:
中文层:中文占比 96%|按字句长 24.5(最长 78)|逗号链 ≤6|「的」链 ≤4|被字句 3|半角标点 2
wd-lint -p gov 通报.md
wd-lint -p tech src/方案.md
wd-lint -p support 工单回复.md
wd-lint -p marketing -l en 文案.md # 关掉中文层做对照
locale:auto(默认,中文占比 ≥30% 自动启用)/ zh(强制)/ en(关闭)。
完整规则表、误报取舍、指标读法见 docs/ZH.md。
文风指纹:像不像你
前面所有规则回答的是「这段有没有毛病」。指纹回答另一个问题:「这段还像不像你写的」。
两者不是一回事。让模型润色一段话,数字没变、引用没少、套话也清干净了——但读起来不是你。句长从十来个字变成四十个字,句子整整齐齐,你常说的那几个词全没了。规则查不出来,因为它没毛病。
建基线(一次就够)
node tools/report.mjs 新稿.md --build 我以前的文档/
或者用工具:
{ "action": "build", "paths": ["D:/写作/旧稿"] }
扫一遍你以前的稿子,统计句长、长短参差度、逗号链、「的」链、被动句、口头禅。只存统计数字,不存原文,落在 ~/.dsh/writing-discipline/baseline.json。
小提示:Markdown 的标题、列表、表格会被先剔掉再统计——那些不是你说话的样子,混进去会把平均句长拉到 4 个字。
看报告
node tools/report.mjs 新稿.md --out 像不像你.html
生成一个单文件网页,双击就开。没有基线也能出——自动降级成「这篇前后一不一致」。
整页只有三块:
- 一句结论——有基线时是「这篇读起来就是你 / 大体是你的路子,但有 N 段不像 / 这篇不太像你」;没基线时是「这篇前后是一个人在写 / 这篇不太统一:有 N 段和其余部分不像」
- 几处不一样——每条一句人话,配你自己的句子和这篇的句子做对照;段落层面的会指出第几段、为什么
- 一条段带 + 一排竖条——段带里一个方块是一段,红的是和其余部分不像的那几段;竖条是每句话的长短,一眼看出「参差」还是「整齐」
数字全藏在最下面的「这些结论是怎么算的」里,想看再点。
没旧稿时的退路
{ "action": "self", "filePath": "新稿.md" }
拿这篇自己的多数段落当尺子,找出「不像其余部分」的段落——专治开头像你、结尾像模型。至少 4 段、每段 25 字以上才有效。
判定
| 结论 | 什么情况 |
|---|---|
| 像你 | 句长、参差度、用词都在你平时的范围 |
| 有点漂 | 有一两处偏了(通常是润色后句子变长、变整齐) |
| 不像你 | 多处偏,且偏得远 |
它不打分,也不判好坏。 你写得比平时好,它也会说「偏离」——那时候忽略就行。它同样不能证明一段文字是不是 AI 写的,只能告诉你离你自己有多远。
上传稿子,换一份「写作说明书」
不用命令行。双击打开 tools/fingerprint-lab.html,把几篇你自己写的 txt / md 拖进去(也可以直接粘贴),页面当场算出你的习惯,给两样东西:
- 一段可以直接发给 AI 的要求——一句话几个字、最长多少、逗号上限、常用词、不要写什么。复制就走。
baseline.json——下载后丢进~/.dsh/writing-discipline/,插件之后的wd_profile compare就用这份基线。
全程在浏览器里算,不上传、不联网,也没有任何外部依赖。算法和 lib/fingerprint.js 是同一套阈值,test/lab-core.mjs 会拿两边对拍,防止改一边忘了另一边。
接 CI
- name: writing discipline
run: node -e "import('./lib/rules.js').then(m=>{const r=m.scan(require('fs').readFileSync('dist/README.md','utf8'),{profile:'readme'});if(!r.ok){console.error(m.formatReport(r));process.exit(1)}})"
或直接调工具函数(scan / rewrite / conservation / stats 都是纯函数,不依赖 DSH 运行时):
import { scan, conservation } from 'dsh-writing-discipline/rules'
const r = scan(text, { profile: 'report' })
if (!r.ok) throw new Error(`防御性写作 ${r.counts.error} 处`)
const c = conservation(before, after)
if (!c.ok) throw new Error('改写破坏了事实层:' + c.items.filter(i => i.severity === 'error').map(i => i.message).join('; '))
已知边界
- 中文规则偏严格:
可能在技术文本里常是真的不确定,不是防御。用profile=academic或severityMin=warn过滤。 - 不改写语义:
wd_rewrite只删不造。它给不出「把这句话改成事实句」的替代文本——那需要判断,判断要人做。 - 守恒锁是启发式:数字比对按字面 token,
840 ms与840ms会被视为不同;主张强度靠成对词表,覆盖不到所有动词。它是安全带,不是刹车。 - 不处理 .docx/.pdf:纯文本进,纯文本出。Office 文档请先用对应 skill 抽取。
数据边界
代码和规则全开源,你的文字永远不出本机。
文风基线(baseline.json)、用户词表(learned.json)、生成的报告,都只在你机器的 ~/.dsh/writing-discipline/ 和你指定的目录里,已写进 .gitignore,git status 看不到。仓库里也没有任何人的示例基线。
完整说明见 docs/PRIVACY.md。
致谢
这个插件的判定模型站在两个人的肩膀上,完整说明见 docs/CREDITS.md:
- @xmutfyh — dsh-plugin-writing-guard(MIT):设计原型。规则分层、密度门控、「可能承担正当功能,勿自动删」的 candidate 判定、按文档类型调严格度、改写不许改科学事实——这几条都是从它那里看清的。没有复制任何代码,规则与实现全部独立编写;我在本机装过它做过行为对照。
anti-defensive-writingskill(本工作区,2026-11-05):本项目的前身形态。前后对照表、--max-warn、可执行入口、交付前自检清单四项直接演化成了EXAMPLES/maxWarn/wd-lint/CHECKLIST。
开发
npm test # 17 个用例,纯 node:assert,无依赖
npm run check # node --check 两个入口文件
规则都在 lib/rules.js 的 RULES 数组里,加一条就是加一个对象:id / label / kind / severity / action / patterns / advice / demoteIn。提交前跑测试,test/smoke.mjs 会校验「所有正则都能编译」和「ruleId 不重复」。
许可
MIT。规则表欢迎 PR——尤其欢迎误报:贴一段被误判的文本,比贴十条新规则有用。
Comments
Loading…
Similar plugins
by Xin-kon
DeepSeek Harness (DSH) plugin that pins zh-CN thinking and replies into the system prompt. Zero runtime deps, single file, capability probing, silent degradation.
★ 0
MIT
JavaScript
Oct 19, 2026
dsh plugin --profile web add dsh-lang-guardby xuxucodepractice-code
A deterministic pre-write claim guard for supported DeepSeek Harness file tools.
★ 0
MIT
JavaScript
Sep 3, 2026
dsh plugin --profile web add dsh-claim-guardCommitment write-gate: operator-authored rules enforced before a tool call runs — a deterministic guard tier plus an LLM-judge tier, fail-closed by default, every block written to a contradictions log
★ 0
↓ 54/wk
dsh plugin --profile web add dsh-write-gateby Gavin237
DSH plugin: inject a one-line hint naming skills that match the current turn, so installed-but-forgotten methodology skills actually get used. Deterministic matching, no LLM calls, fail-open.
★ 0
NOASSERTION
TypeScript
Sep 20, 2026
dsh plugin --profile web add dsh-capability-hintby ZSeven-W
DeepSeek Harness (DSH) plugin: a read-only ledger for the plugins you already have installed — a capability inventory with file:line evidence, declared-vs-detected reconciliation, cross-profile versio
★ 29
↓ 204/wk
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add @zseven-w/dsh-harborby darkmagic-ai
DSH (DeepSeek Harness) security guard plugin: blocks/asks on dangerous commands & sensitive paths, redacts secrets in tool output, local JSONL audit log + guard_report. DSH 安全护栏插件。
★ 0
MIT
JavaScript
Nov 5, 2026
dsh plugin --profile web add dsh-guardrail