GEO Writing Check

unlisted

by 包参谋

检查文章是否便于 AI 搜索理解和引用:开头是否直接回答、主体是否明确、说法有无出处、段落能否单独摘录。Check Chinese articles for AI search citability: answer-first leads, clear entities, sourced claims, self-contained passages. Works fully offline.

Updated 10d agoMIT
View on GitHub

GEO 写作检查

GEO 写作检查

English · 中文

Release License: MIT Node.js build Gitee 镜像

一个 Obsidian 插件,给写官网文章、知乎回答和品牌内容的人用:写完一篇中文文章,检查它是否便于 AI 搜索理解和引用。开头有没有直接回答、主体写没写清楚、说法有没有出处、段落单独拿出来能不能看懂,逐项给出情况、改法和具体位置。

插件英文名 GEO Writing Check,插件 ID geo-writing-check。纯本地运行,不联网,不调用 AI,不上传任何笔记内容。

适合谁、什么时候用

  • 写官网文章和问答内容:希望文章能被 AI 搜索准确理解、在回答里被引用,发布前按同一套标准检查一遍。
  • 品牌内容团队统一写法:多人写稿时,“开头先给结论”“说法要有出处”“不用‘最近’‘去年’”这类要求很难靠口头传达,插件把它变成可检查的项目。
  • 改旧文章:打开一篇旧稿,面板直接列出哪一段该改、改成什么样,按位置逐条处理。
  • 给作者反馈:复制检查报告,附上分数、每一项的情况和具体位置。

能做什么

  • 17 项检查,分五类:直接回答、主体明确、证据可核、便于摘录、时效清楚。
  • 引用友好度 0–100 分:按权重汇总,85 分以上为“便于引用”,65 到 84 分为“基本可用”。
  • 具体位置:每一项列出问题所在的行,点击跳到原文。
  • 编辑器标注:需要修改的位置画紫色虚线,鼠标停留显示改法。停止输入 0.4 秒后才重新分析,不影响打字。
  • 读取笔记属性:自动识别标题、关键词、主体名称和发布日期,常见的中英文属性名都能认。
  • 检查报告:复制成 Markdown,包含分数、每一项的结果和位置。
  • 可调:每一项可以单独关闭,字数阈值可以改,空泛形容和相对时间可以设置不提示的词。

效果示例

下面是一篇虚构的社区面馆外卖菜单文章。

编辑器里用紫色虚线标出铺垫开头、指代开头、“一站式”“匠心”“深受喜爱”“最近”“数据显示”;右侧面板显示引用友好度 56 分,按类别列出每一项的结果、改法和位置

这篇文章得 56 分。开头是“随着生活节奏越来越快……”式的铺垫,没有直接回答;第二节以“它”开头,单独引用时会失去所指;用了“一站式”“匠心”这类不提供信息的形容;“数据显示”没有写出处;“最近”离开发布日期后无法判断。

鼠标停在“最近”上:

悬停提示:不用相对时间,换成具体的年月,例如“2026 年 9 月”

工作流程

工作流程:打开一篇文章、读取笔记属性、17 项规则检查、算引用友好度、逐项给出位置、修改后复查

检查什么

类别检查项看什么权重
直接回答开头直接回答第一段是否直接给出结论,而不是背景铺垫或反问;第一段不超过 150 字3
小节先给结论每个二级、三级标题下的第一段是否先回答2
标题说清主题标题 8 到 32 字;设了关键词时,是否出现在标题、第一段和一个小标题2
主体明确主体名称出现品牌或机构名称是否写出,是否在前三分之一出现2
段落不以指代开头以“它”“这个”“该产品”开头的段落,被单独引用时会失去所指2
自称带上名称“本公司”“我司”“小编”无法被归到具体主体1
证据可核具体数字与事实是否有年份、数量、比例、价格等可核对的信息3
说法有出处“数据显示”“研究表明”同一句里是否写明来源3
少用空泛形容“领先的”“一站式”“匠心”等词的密度2
引用来源800 字以上的文章是否引用了外部资料或文件1
便于摘录段落长度段落不超过 220 字2
句子长度句子不超过 80 字1
标题层级不跳级;800 字以上的文章有小标题1
问句式小标题小标题写成读者会问的问题,更容易对上提问提示
列表或表格步骤、对比、参数适合用列表或表格提示
时效清楚日期信息属性或正文里有明确日期1
不用相对时间“最近”“今年”“去年”离开发布日期后无法判断所指2

每项通过得满分、可改进得一半、需修改不得分,按权重加总成 0 到 100 分。“提示”类和已关闭的检查项不计分。表中的字数都可以在设置里调整。

安装

插件市场:上架 Obsidian 社区插件目录后,可在 设置 → 第三方插件 → 浏览 中搜索 “GEO Writing Check” 安装。

手动安装(上架前请用这种方式):

  1. 从 Releases 下载 main.js、manifest.json、styles.css 三个文件。
  2. 在你的库里新建文件夹 .obsidian/plugins/geo-writing-check/,把三个文件放进去。
  3. 重启 Obsidian,在 设置 → 第三方插件 里启用 “GEO Writing Check”。

国内访问 GitHub 较慢时,可以从 Gitee 镜像获取源码后自行构建(需要 Node.js 18 以上),构建出的三个文件同样放进上面的文件夹:

git clone https://gitee.com/baocanmou/obsidian-geo-writing-check.git
cd obsidian-geo-writing-check
npm install
npm run build

使用方法

  1. 在 设置 → GEO Writing Check → 主体名称 里填写你的品牌或机构名称,第一行是主名称,其余行可以写城市、主营业务等希望文中出现的词。
  2. 打开一篇文章,点击左侧放大镜图标,或运行命令“打开检查面板”,查看分数和每一项结果。
  3. 点击面板里的位置跳到原文;编辑器里的紫色虚线处,鼠标停留可看改法。
  4. 改完再看分数变化,或点“复制检查报告”发给作者。

用到的笔记属性

---
title: 社区面馆怎么做外卖菜单
主关键词: 外卖菜单
品牌: 示例面馆
发布日期: 2026-09-20
GEO检查: false
---
属性默认识别的名称作用
标题title、meta_title、标题没有时用一级标题,再没有用文件名
关键词主关键词、目标关键词、primary_keyword、keyword有值时检查关键词位置
主体品牌、brand、GEO主体这一篇的主名称,优先于设置里的全局名称
日期发布日期、更新日期、date、updated、published_at、modified_at、created有值即视为有日期
开关GEO检查写成 false 关闭这一篇的检查

属性名都可以在设置里修改。

命令

命令作用
打开检查面板在右侧栏显示分数和每一项结果
复制检查报告复制 Markdown 报告
跳到下一处待修改位置依次选中需要修改的位置
开关编辑器实时标注只保留面板,不在编辑器里画线

边界

  • 分数只反映写法,不代表会被收录、引用或推荐。AI 搜索是否引用一篇内容,还取决于站点的可信度、是否可抓取、内容是否独到等本插件看不到的因素。
  • 基于规则,不理解语义:能发现“第一段是铺垫”,不能判断“回答得对不对”。
  • 不要为了分数硬凑:没有可靠数字就不要编,没有步骤就不必加列表。不适用的检查项可以在设置里关掉。
  • 只检查中文写法:规则针对中文文章设计。
  • 正文少于 300 字的笔记不检查,超过 30 万字符的笔记也不检查。

常见问题

会上传我的文章吗? 不会。插件不联网,所有检查在本机完成。

“主体名称出现”一直显示“提示”? 还没有设置主体名称。在设置里填写,或在笔记属性里写 品牌: 名称。

为什么分数和我感觉的不一样? 分数只看可以用规则判断的写法问题,不评价观点和内容质量。看分数时以每一项的具体情况为准,不必追求满分。

某一项不适合我们的文章怎么办? 在设置的“检查项”里关掉它,关掉后不显示,也不计入分数。

手机上能用吗? 插件没有使用桌面端专有接口,理论上可以在 Obsidian 移动端运行,但目前只在桌面端验证过。

版本与更新

当前版本 0.1.0。各版本的变化见 Releases。

参与开发:

npm install
npm run dev    # 监听构建
npm test       # 检查规则测试
npm run lint
npm run build

许可与署名

出品:包参谋 / BaoCanMou
发起与产品方向:易慧庭 / Yi Huiting

按 MIT 开源。

包参谋其他开源项目

项目做什么国内镜像
发布前合规检查Obsidian 插件:写作时标出广告法风险表达,给出依据和改法Gitee
平台成稿检查Obsidian 插件:按公众号、小红书等平台检查成稿,管理文末落款Gitee
餐饮广告语·十法三选按 10 种名家方法各写一条餐饮广告语,比较后推荐 3 条Gitee
策划资料变 PPT把简报和调研做成有来源、可编辑的提案 PPTGitee
GEO 效果优化诊断品牌在 AI 搜索中的提及、引用和推荐,按证据排改进任务Gitee
Open GEO SEO Console可自行部署的 SEO 与 GEO 监控后台Gitee
包参谋 AI 技能中心盘点本机 AI Skill 并统一连接多种 AI 工具的桌面应用Gitee

关于包参谋

包参谋,全称南昌包参谋品牌策划有限公司,2012 年创立于江西南昌,提供品牌定位、Logo/VI 设计、包装设计、品牌空间与传播内容服务,主要服务餐饮、连锁门店、食品快消和地方特色品牌。创始人易慧庭。官网:www.bcmsj.com。

我们先定位,后设计。这些开源工具来自我们在实际项目里反复做的工作,我们把判断标准写清楚,让 AI 按同样的标准做事。

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.