DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-writing-discipline

o

dsh-writing-discipline

Manifest valid

DSH plugin: defensive-writing gate with fact-conservation lock (zero network, zero LLM)

hasBundlePatch

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」「能力有限」「如有疏漏」占篇幅,零信息
说教劝退「请注意」「务必确保」「建议谨慎」用姿态替代参数
无意义对冲「可能或许大概」「一定程度上」主张被稀释到无法据此决策
过程旁白「首先我需要了解…」「接下来我将」纯噪音

这些不是风格偏好问题:它们让读者无法行动。而清理它们的最大风险不是删不干净,是顺手把真事实一起删了——数字、引用、否定、适用边界、主张强度。所以本项目做两件事,缺一不可:

  1. wd_scan / wd_rewrite:找出并清掉防御性噪音;
  2. 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同上,元评论残留加重
academichedge 全部降级为 INFO——学术 hedging 是 ICMJE 认可的正当表达,不该判失败
review「as requested」「按要求」类过程残留不报

wd_rules — 规则速查

列出 24 条规则 + 3 条密度规则在指定 profile 下的实际严重度。写作前扫一眼,比写完再改便宜。

wd_rewrite — 确定性改写

只做三件有把握的事:

  1. 剥离引子:好的, / 请注意, / 需要注意的是, / 温馨提示:
  2. 压缩堆叠:可能或许 → 可能;may potentially → may
  3. 删纯防御句:整句只承担免责/客套功能

硬约束:含数字、引用、图表编号、链接的句子永不删除。 返回改写后文本 + 逐条变更记录 + 改后复扫。

它不生成新句子。语义级改写仍要人来做——但这一遍能便宜地砍掉大半噪音。

wd_conservation — 守恒锁

{ "original": 原文, "revised": 改后文本 }   // 或 originalPath / revisedPath

检查四类事实漂移:

检查级别说明
数字 / 单位 / 百分比 / p 值 / n=INVARIANT丢失即 HIGH,必须回滚
引用键 / 图表编号 / DOI / URLINVARIANT同上
主张强度上调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

生成一个单文件网页,双击就开。没有基线也能出——自动降级成「这篇前后一不一致」。

整页只有三块:

  1. 一句结论——有基线时是「这篇读起来就是你 / 大体是你的路子,但有 N 段不像 / 这篇不太像你」;没基线时是「这篇前后是一个人在写 / 这篇不太统一:有 N 段和其余部分不像」
  2. 几处不一样——每条一句人话,配你自己的句子和这篇的句子做对照;段落层面的会指出第几段、为什么
  3. 一条段带 + 一排竖条——段带里一个方块是一段,红的是和其余部分不像的那几段;竖条是每句话的长短,一眼看出「参差」还是「整齐」

数字全藏在最下面的「这些结论是怎么算的」里,想看再点。

没旧稿时的退路

{ "action": "self", "filePath": "新稿.md" }

拿这篇自己的多数段落当尺子,找出「不像其余部分」的段落——专治开头像你、结尾像模型。至少 4 段、每段 25 字以上才有效。

判定

结论什么情况
像你句长、参差度、用词都在你平时的范围
有点漂有一两处偏了(通常是润色后句子变长、变整齐)
不像你多处偏,且偏得远

它不打分,也不判好坏。 你写得比平时好,它也会说「偏离」——那时候忽略就行。它同样不能证明一段文字是不是 AI 写的,只能告诉你离你自己有多远。

上传稿子,换一份「写作说明书」

不用命令行。双击打开 tools/fingerprint-lab.html,把几篇你自己写的 txt / md 拖进去(也可以直接粘贴),页面当场算出你的习惯,给两样东西:

  1. 一段可以直接发给 AI 的要求——一句话几个字、最长多少、逗号上限、常用词、不要写什么。复制就走。
  2. 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-writing skill(本工作区,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

dsh-lang-guard

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.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-lang-guard

by xuxucodepractice-code

A deterministic pre-write claim guard for supported DeepSeek Harness file tools.

Security & AuditManifest valid

★ 0

MIT

JavaScript

Sep 3, 2026

dsh plugin --profile web add dsh-claim-guard

Commitment 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

Security & AuditDevelopment & InfrastructureManifest valid

★ 0

↓ 54/wk

dsh plugin --profile web add dsh-write-gate

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

Development & InfrastructureManifest valid

★ 0

NOASSERTION

TypeScript

Sep 20, 2026

dsh plugin --profile web add dsh-capability-hint

by 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

Security & AuditManifest valid

★ 29

↓ 204/wk

MIT

JavaScript

Nov 18, 2026

dsh plugin --profile web add @zseven-w/dsh-harbor

by 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 安全护栏插件。

Manifest valid

★ 0

MIT

JavaScript

Nov 5, 2026

dsh plugin --profile web add dsh-guardrail