☰
check_prose.py 完整教程:human-writing 成稿自查脚本如何把禁用项清零
2026/9/26 7:36:23 网站建设 项目流程

check_prose.py 完整教程:human-writing 成稿自查脚本如何把禁用项清零

【免费下载链接】human-writing让 AI 写的中文读起来像一个具体的人在说话。通用创作与改稿 Skill,开箱即用。项目地址: https://gitcode.com/gh_mirrors/hu/human-writing

human-writing 是一套通用中文创作与改稿 Skill,目标是让 AI 写的中文读起来像一个具体的人在说话。它自带一个成稿自查脚本 check_prose.py,能自动扫出冒号、破折号、翻案句、商业黑话等禁用项,帮你把违规记录清零后再交稿。本文带你完整走一遍:怎么运行、怎么读报告、怎么把失败项清零。

这个自查脚本管什么

「活人感写作」的成稿硬规则写在 SKILL.md 里,而 check_prose.py 只负责机械执行「已经写明」的规则,不替作者决定文体。所有检查项分两层:

层级包含项处理要求
🛑 失败项(硬禁令)中英文冒号、破折号、硬停词、商业黑话、模型路标、翻案句命中就必须改,清零前不能交稿
💡 提醒项(软形状)需辨语境词、洞察路标、长前置成分、堆「的」长句、短句排队、开场重复、比喻换场结合语境人工判断,脚本不越权

两个设计值得记住:

  • 只报警,不自动改文。脚本从不碰你的稿件,改写永远由人完成(见 check_prose.py 的文档字符串)。
  • 自动屏蔽非正文。代码块、行内代码、网址、frontmatter 会先被 mask_non_prose 抹掉再检查,所以网址里的英文冒号不会误报。

一键运行:如何调用成稿自查脚本

只需两步:

  1. 把成稿保存为 Markdown 或纯文本文件;
  2. 在仓库根目录执行:
python3 human-writing/scripts/check_prose.py 稿件.md

传-可以从标准输入读取。脚本跑完只输出报告,原文件一个字符都不会变。

读懂报告:失败项、提醒项与退出码

报告结构非常固定,从上到下四段:

  1. 汉字数,以及翻案句、黑话、硬停词等每类命中数的汇总行;
  2. 「需要修改」列表:逐项给出失败项的标签、行号和原文摘录,例如「禁用翻案句,第 12 行,不是……而是……」;
  3. 「需要人工判断」列表:提醒项同样带行号和例句;
  4. 干净时直接显示「未发现这份检查器覆盖的问题」。

退出码可以接进任何自动化流程:

退出码含义下一步动作
0无失败项进入提醒项人工复查
1命中禁用项按清单逐条改写,重跑直到清零
2文件读不了或没检测到汉字检查路径与 UTF-8 编码

禁用项清零清单:五类硬禁令逐条过

失败项全部来自 SKILL.md 的交付禁令和 revision.md 的第五遍清稿规则,共五类:

1. 冒号与破折号:全文清零

中文冒号:、英文冒号:、破折号—和连接号式破折号–一律不允许出现在正文,网址、代码与无法改动的机器字段除外(见 check_prose.py)。

2. 硬停词:4 个

「不丢」「说白了」「说穿了」「先说结论」,命中即失败(check_prose.py)。

3. 翻案句:8 种句式

「不是……而是……」「并非……而是……」「不在于……而在于……」「与其说……不如说……」「不只……还/也……」「表面……其实/实际/实则……」「看似……实则……」及其变形,脚本用正则跨最多 90 字匹配(check_prose.py)。

4. 商业黑话:32 个绝对禁词

「赋能」「抓手」「闭环」「底层逻辑」「顶层设计」「降本增效」等,规则要求改回「人、动作、钱、时间与后果」(check_prose.py)。

5. 模型路标:6 个洞察短语

「更微妙的是」「还有一层」「只说对了一半」「值得注意的是」「需要指出的是」「从某种意义上说」。文字确实在说楼层、数量等本义时不受影响(check_prose.py)。

⚠️ 注意一条铁律:脚本里的硬禁词必须与 revision.md 完全一致,不能悄悄多出一套规则;反过来,原话命中禁令时也要改成转述,不能靠引号保留。

提醒项怎么用:别当噪音删

提醒项有内置阈值,不是越多越糟:

  • 需辨语境词:「沉淀」「颗粒度」「对齐」「协同」「链路」等 10 词,本义准确时保留,用来抬价时改写(check_prose.py)。
  • 洞察路标:「真正」「本质上」「归根结底」等,提醒线随篇幅放宽,约每 900 个汉字允许多出现 1 次。
  • 形状类警告:长前置成分(「在……的过程中,」)、一句四个以上「的」、七成段落只有一句话、连续 4 个短促单句段、同一开场词(「其实」「不过」等)出现 4 次以上,以及 800 字内挤进 3 套比喻。

这些警告服务于 revision.md 的改稿顺序:先看谁在说、再看文章有没有往前走,最后才轮到清句子。诗歌、剧本和实验写作只把失败项当硬要求,形状警告服从具体文体。

常见问题

代码块和网址里的冒号会误报吗?

不会。脚本先屏蔽 ``` 代码块、行内code、网址和 frontmatter,且保留行号,报告里的行号可直接定位原文。

脚本能自动改稿吗?

不能,这是刻意设计。修违禁句的正确姿势:先找这句话原本想说的事实,再用普通句子说出来,而不是换另一种漂亮句式继续绕。

提醒项很多,必须清零吗?

不必。硬要求只有失败项清零;提醒项交给人工判断。revision.md 明确「禁用项没有清零,不能交稿」,指的就是失败项。

从零到清零的完整闭环

整个流程其实只有四步:

  1. 用 human-writing 写出初稿;
  2. 保存为 Markdown,跑一遍check_prose.py;
  3. 按「需要修改」清单逐条改写,重跑;
  4. 失败项清零(退出码 0)后,人工过一遍提醒项,交稿。

想深入理解每条规则背后的写法,可以顺读 forum-prose.md 的长篇散文写法和 formats.md 的文体规则;项目总览见 README.md。把「自查—清零—复查」变成习惯,成稿的模型腔就会肉眼可见地少下去。

【免费下载链接】human-writing让 AI 写的中文读起来像一个具体的人在说话。通用创作与改稿 Skill,开箱即用。项目地址: https://gitcode.com/gh_mirrors/hu/human-writing

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询