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

English · 中文
一个 Obsidian 插件,给写官网文章、知乎回答和品牌内容的人用:写完一篇中文文章,检查它是否便于 AI 搜索理解和引用。开头有没有直接回答、主体写没写清楚、说法有没有出处、段落单独拿出来能不能看懂,逐项给出情况、改法和具体位置。
插件英文名 GEO Writing Check,插件 ID geo-writing-check。纯本地运行,不联网,不调用 AI,不上传任何笔记内容。
适合谁、什么时候用
- 写官网文章和问答内容:希望文章能被 AI 搜索准确理解、在回答里被引用,发布前按同一套标准检查一遍。
- 品牌内容团队统一写法:多人写稿时,“开头先给结论”“说法要有出处”“不用‘最近’‘去年’”这类要求很难靠口头传达,插件把它变成可检查的项目。
- 改旧文章:打开一篇旧稿,面板直接列出哪一段该改、改成什么样,按位置逐条处理。
- 给作者反馈:复制检查报告,附上分数、每一项的情况和具体位置。
能做什么
- 17 项检查,分五类:直接回答、主体明确、证据可核、便于摘录、时效清楚。
- 引用友好度 0–100 分:按权重汇总,85 分以上为“便于引用”,65 到 84 分为“基本可用”。
- 具体位置:每一项列出问题所在的行,点击跳到原文。
- 编辑器标注:需要修改的位置画紫色虚线,鼠标停留显示改法。停止输入 0.4 秒后才重新分析,不影响打字。
- 读取笔记属性:自动识别标题、关键词、主体名称和发布日期,常见的中英文属性名都能认。
- 检查报告:复制成 Markdown,包含分数、每一项的结果和位置。
- 可调:每一项可以单独关闭,字数阈值可以改,空泛形容和相对时间可以设置不提示的词。
效果示例
下面是一篇虚构的社区面馆外卖菜单文章。

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

工作流程
检查什么
| 类别 | 检查项 | 看什么 | 权重 |
|---|---|---|---|
| 直接回答 | 开头直接回答 | 第一段是否直接给出结论,而不是背景铺垫或反问;第一段不超过 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” 安装。
手动安装(上架前请用这种方式):
- 从 Releases 下载
main.js、manifest.json、styles.css三个文件。 - 在你的库里新建文件夹
.obsidian/plugins/geo-writing-check/,把三个文件放进去。 - 重启 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
使用方法
- 在 设置 → GEO Writing Check → 主体名称 里填写你的品牌或机构名称,第一行是主名称,其余行可以写城市、主营业务等希望文中出现的词。
- 打开一篇文章,点击左侧放大镜图标,或运行命令“打开检查面板”,查看分数和每一项结果。
- 点击面板里的位置跳到原文;编辑器里的紫色虚线处,鼠标停留可看改法。
- 改完再看分数变化,或点“复制检查报告”发给作者。
用到的笔记属性
---
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 | 把简报和调研做成有来源、可编辑的提案 PPT | Gitee |
| 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.