
这个工具解决什么问题
一篇两千字的技术笔记,写完自己读了两遍,觉得逻辑没问题,发出去阅读量也还行。可你拿文章里的核心问题去问 AI 搜索,它引用的却是别人写的那篇——排版不如你、例子不如你,就是被引用了。问题往往不在内容,而在结构:你的开头两段还在铺垫「随着……不断发展」,人家的第一句就是结论;你的正文四个大段、每段五百多字,人家每节三个短段、配一张参数表;你通篇写「很快」「很小」,人家写「42 秒」「11.3 MB」。这些差别肉眼几乎看不出来,因为它们不在句子里,而在段落与段落的组织方式上。想改,又不知道从哪一段下手,于是每次都凭感觉改两句措辞,发出去还是老样子。
- 原来的做法:通读一遍凭感觉改措辞 → 猜「是不是标题不够吸引」→ 猜「是不是关键词没写够」→ 改完还是不知道有没有变好,也没有改前改后的对比
- 用这个工具:选一个存到本地的页面 → 点「开始体检」→ 拿到 6 个维度的分数和一份按严重程度排序的问题清单,每条都带实测数值(第几段、多少字、几处套话)和具体改法 → 改完再体检一次,分数直接对比
- 省下来的:定位问题从「通读两遍 + 猜」变成看一眼清单;改前改后有同一个分数可比,不用再凭感觉判断
技术实现
整条链路是「解析 → 评分 → 呈现」三段,前两段全是纯函数,只有最后一段碰界面。这样切的好处是打分规则可以脱离窗口验证:100 条断言在 0.3 秒内跑完,改一条阈值不用靠手点按钮确认。解析层自己用 html.parser 搭了一棵轻量 DOM,先剔噪(脚本、导航、侧栏、评论区、页脚)再挑正文容器,避免侧栏的推荐语被当成正文段落——这一步如果做错,后面所有分数都是错的。评分层把 25 条规则写成互相独立的小函数,每条只回答一个二值问题(首段有没有数字?段落平均多长?),分数只是它们的加权和。整个工具不引第三方库:断词、DOM、报告样式全部手写,运行版才能做成一个 11 MB 的单文件 exe,用户那台机器上不需要任何环境。
- 两遍剔噪,再按文字量选正文容器:第一遍按标签丢:script、style、nav、aside、footer、form、svg、iframe、button 整段不要;第二遍按 class/id 丢:命中 sidebar、comment、copyright、related、share、breadcrumb、advert、pagination 的容器也不要。之后在 article、main 以及 class/id 命中 content、post、article、entry 的元素里,挑「可见文字最多」的那个当正文根——网页存档里侧栏与评论区经常比正文还长,按位置猜必错,按文字量挑才稳。抽出来的段落总字数不足 300 时,退回整棵树再抽一次,兜住那些正文直接挂在 body 下的站点。
- 只取叶子块,避免父子重复计数:网页里嵌套很常见:blockquote 里套 p,li 里套 p。如果见到块级标签就收,同一段文字会被数两遍,段落数、平均段长、事实密度全部失真。判定办法是「叶子块」——内部不含任何块级子元素的 p / li / div 才收;再用前 60 字做去重键,防止同一段换行反复出现。代码块 pre 直接跳过:它不是自然段,混进平均段长会把分数拉偏。
- 事实正则的分支顺序决定分数准不准:「一条事实」= 带单位的数值、日期、版本号、两位以上数字。难点在顺序:如果先把「数字+单位」放在前面,「2026 年 11 月」里的「年」会被当成单位,一句话被拆成两条事实,密度直接翻倍。现在的顺序是日期整串优先,其次数字+单位,再次版本号(v1.2.3),最后才是裸数字。密度按每千字条数算,字数不足 300 时按 300 兜底,否则短文本的密度会虚高。
- 空值单独拦截,别让空白文档拿高分:「平均段长 0」「平均句长 0」在字面上都满足阈值,如果不判空,一篇空白文档能拿到 30 分以上,用户第一次试就会觉得这工具在瞎给分。规则 8(层级不跳级)、11(平均段长)、14(平均句长)都加了空值拦截:没有标题、没有段落、没有句子时一律不给分。自测里有一条专门断言空文档分数 ≤30。
- 问题清单用卡片,不用 Treeview:ttk.Treeview 的单元格不换行,一条 60 字的整改建议塞进去必然被截断,右边一列永远看不全。改成 Canvas + 内嵌 Frame 的卡片列表后,每条问题是一张卡:左侧色条区分严重/建议,卡内自动换行,级别、维度、实测现象、改法、位置一屏读完。换行宽度跟着画布宽度走,窗口拉宽文字自动铺开,不用重新布局。
- DPI 等比缩放与无控制台的两个坑:声明 DPI 感知后,175% 缩放下 9pt 字会渲染成 21px 高,窗口尺寸若还按 100% 像素写,文字会顶出窗口。现在从 tk scaling 除以 1.3333 取缩放系数,窗口、行高、列宽、内边距全部乘这一个系数。另一个坑是打包参数:PyInstaller 加了 --noconsole 之后 sys.stdout 与 sys.stderr 都是 None,任何 print 或 traceback.print_exc 都会抛 AttributeError——而且在开发环境里直接运行是测不出来的,所以入口第一句就把标准流兜到 os.devnull。
技术栈:Python 3.12、tkinter 界面、纯标准库(零第三方依赖)、html.parser 构建轻量 DOM、6 维度 25 条规则评分、单文件免安装
已知局限:只解析静态 HTML,正文由脚本异步渲染的页面解析出来会是空的(本工具面向「已经保存下来的成品页面」)。图片只统计数量与 alt 缺失,不参与评分。它检查的是「结构像不像一个可摘录的答案」,不判断内容是否真实、观点是否正确——数据造假同样能拿高分。所有阈值是经验值:段落 160 字、每千字 6 条事实这些数字来自对公开技术文章的统计,不同体裁(小说、公告、法律条文)需要按自己的场景调整。单文件建议 8 MB 以内,更大的文档界面会有明显卡顿。
同类软件对照
下面几款都是公开可查的同类软件,定位各不相同。这里只说明各自的定位,以及本工具在其中的位置,方便你判断哪一类更契合自己的用法。
| 软件 | 它的定位 | 本工具的定位 |
|---|---|---|
| Rankfender | Product Hunt 上发布的 SEO / GEO 运营系统,面向团队与 AI Agent 做站点级的搜索表现管理 | 它是「站点级 + 在线协作」的运营平台,管的是排名、内容日历与多站点流程;本工具只查单篇文章的正文结构,本地单文件运行,不上传内容,也不需要账号 |
| Surfer SEO | 云端内容编辑与评分平台,围绕目标关键词与竞品页面给出写作建议 | 它的指标围绕关键词覆盖、篇幅与竞品对比;本工具不碰关键词,只看「答案前置、段落颗粒、事实密度」这些影响摘录的结构特征,并且完全离线 |
| Yoast SEO | WordPress 上的 SEO 插件,在发布后台给单篇文章打可读性与关键词分 | 它绑定在 WordPress 后台,指标面向传统搜索与页面可读性;本工具独立运行,任何导出的页面都能查,指标面向生成式搜索能不能整段摘走 |
| Google Lighthouse | 开源的网页质量审计工具,检查性能、可访问性与 SEO 基础项 | 它审的是页面技术质量(能不能顺利加载、有没有基础元信息),不评正文结构;本工具不看性能与资源,只读文本,回答「这段能不能当答案」 |
以上仅作定位对照,各软件的可用性、授权方式与功能范围请以其官方页面为准。
操作教程
- 打开程序
解压后双击「AI引用友好度体检.exe」。窗口从上到下是:工具栏、成绩卡片、问题清单 / 可引用段落两个标签页、状态栏。
预期结果:窗口正常出现,状态栏显示「就绪。选一个网页存档或 Markdown 文件,点开始体检」 - 载入要体检的文章
三种方式任选:点「选择文件…」选 .html / .md / .txt;点「粘贴文本」把正文贴进来;或者点「载入示例」先看看效果。
预期结果:工具栏右侧显示文件名(粘贴时显示「粘贴的正文」),状态栏显示字数与段数 - 开始体检
点右上角「开始体检」。程序会在本地解析并打分,通常不到 1 秒。
预期结果:左边出现大号总分与等级,右边六条维度比例条按分数变绿/蓝/橙/红 - 读问题清单
切到「问题清单」标签页,每条问题是一张卡:左上角是「严重 / 建议」标记,右上角是位置(第几段、正文全文、页面头部),中间是实测到的现象,下面一行是改法。
预期结果:问题按严重程度排序,严重项在最上面;卡片文字完整换行,不需要横向滚动 - 看最可能被摘录的段落
切到「可引用段落」标签页,列出可引用度最高的 3 段,以及选它们的理由(几条事实、多少字、是否含判断句)。
预期结果:每段前面标着「第 N 段 · 可引用度 X」,下面是段落原文 - 导出报告
点「导出报告…」,存成 .html(带颜色,可离线打开)或 .txt(纯文本清单,适合贴进工单)。
预期结果:保存后弹窗询问是否立即打开;报告里含总分、各维度、问题清单与可引用段落
常见问题
技术实现与后续维护
工具由一个可执行文件和一份使用说明组成,解压即用、不写注册表、不驻留后台。技术上只依赖 Python 标准库:DOM 用 html.parser 自建,词表与正则手写,界面用 tkinter,报告用字符串模板拼接,因此不会因为某个第三方库升级而失效。判定规则集中在 analyze.py 的 25 个独立方法里,每条只回答一个二值问题,改动后用 selftest.py 跑一遍(100 条断言,0.3 秒)即可确认没有回归。内置示例文章的分数被断言钉死,用来发现「无意中改了评分口径」。已知局限见上文「技术实现」末尾。若需要按行业改阈值、做批量体检或接进内部发稿流程,可以在本站联系页留言。
技术构成:
main.py—— 入口:标准流兜底、DPI 感知、未捕获异常弹窗、自测与示例开关gui.py—— 窗口布局、维度比例条、问题卡片列表、粘贴对话框、报告导出extract.py—— HTML 轻量 DOM、剔噪与正文容器选择、Markdown / 纯文本解析、编码识别analyze.py—— 六维度 25 条规则、问题清单生成、可引用段落排序report.py—— HTML / TXT 报告渲染与保存selftest.py—— 100 条无界面断言(解析、评分、报告、打包回归)
运行环境:
Windows 10/11 64 位。运行版是单文件 exe,已内置 Python 运行时与 tkinter,解压双击即可,不需要装 Python、不写注册表、不驻留后台。
可扩展方向:
- 按体裁切换阈值模板(技术文 / 公告 / 教程 / 产品页各一套),公告类不该因为「没有 FAQ」扣分
- 批量体检整个目录,输出一张汇总表:哪几篇最该改、各自的严重问题数
- 接自己的写作规范:把行业词表、禁用词、必填字段做成可编辑的配置文件
- 对比模式:贴两份报告,自动算出每个维度涨了多少分
- 导出为待办清单,按「严重 / 建议」分组,可直接贴进项目管理工具
本工具免费提供使用,功能完整、不设限制。如果你需要在本工具基础上做功能调整、对接内部系统或长期维护,可以联系我们做二次开发。
需要其它功能?可以定制
这个工具只做一件事:文章发出去人看得到,AI 搜索却从不引用它,自己盯着看半天也说不清差在哪一段。如果你的场景还需要别的处理,可以联系我们做二次开发,按你的实际数据格式和流程定制。
常见的定制需求:
- 企业站运营:把公司 200 篇产品文档批量体检一遍,先改最严重的那 20 篇
- 自媒体团队:把「引用友好度」作为发稿前的固定检查项,低于 70 分打回
- 行业媒体:按自己的体裁定一套阈值(比如法律解读类允许更长的段落)
- SEO 服务商:给客户交付一份可对比的改前改后报告
- 联系方式:邮箱/微信见站内「联系我们」页面,或在本文下方留言
- 定制说明:请附上你的数据样例(脱敏即可)和期望结果,方便快速评估工作量
- 交付形式:定制项目交付可执行程序,支持后续版本迭代与长期维护
使用说明与免责声明
- 本工具在本地运行,不联网、不上传任何数据到服务器。
- 涉及文件改写的功能,请在使用前备份原始文件。
- 软件完全免费,可自由使用与转发,请勿用于倒卖。
- 因误操作造成的数据问题请自行承担。
本工具的评分基于公开可见的写作结构经验值,用于自查文章是否便于被 AI 搜索摘录,不代表任何搜索引擎或 AI 产品的官方判定标准,也不构成对内容质量或事实准确性的评价。分数高不等于内容正确,请自行核对文中的数据与结论。

