# LAB 12｜GitHub 开源产品的 GEO

> 所属模块：技术品牌｜更新时间：2026-11-05｜性质：可复现实验，绝非 AI 引用保证。

## 你做完会得到什么

README、安装命令、API 文档和真实运行结果共同组成可被核验的技术内容。

## 准备（0–5 分钟）

只需电脑和网络浏览器、自己有权限的站点（部分实验无网站也能完成）。用 `docs/` 打开网站，用 `templates/` 保存可编辑文件；所有客户信息请先去标识化。

## 按顺序实操

### 1. 5 分钟 Quickstart

把安装与运行命令放在 README 前半页，确认在干净环境可执行。

**完成凭证：** 写入今天的日期、页面 URL 或源文件名，并保留能独立复核的截图/报告。

### 2. 公开一份演示

提供可下载样例、真实输入输出和常见错误；不能仅用效果图。

**完成凭证：** 写入今天的日期、页面 URL 或源文件名，并保留能独立复核的截图/报告。

### 3. 增加实际版本记录

提供 Release/CHANGELOG，标注兼容平台及限制。

**完成凭证：** 写入今天的日期、页面 URL 或源文件名，并保留能独立复核的截图/报告。

### 4. 互通官网和仓库

官网产品页指向官方仓库，仓库再指向官网的文档与支持入口。

**完成凭证：** 写入今天的日期、页面 URL 或源文件名，并保留能独立复核的截图/报告。

### 5. 测量用户行为

关注文档到安装、Issue 到 PR、站点访问到付费，而不是单追 Star。

**完成凭证：** 写入今天的日期、页面 URL 或源文件名，并保留能独立复核的截图/报告。

## 最终验收（必须具备）

一份完成独立环境测试的 Quickstart，含命令与运行日志。

## 常见失败和处理

GitHub Star 数量不等于真实用户、商机或收入。

如果无法访问某个平台或没有后台权限：填写「未执行 / 无权限 / 无数据」，保留截图和阻塞原因，继续做不依赖权限的部分。不要凭空补零。

## 资料来源

- [Google：生成式 AI 搜索优化](https://developers.google.com/search/docs/fundamentals/ai-optimization-guide)
- [OpenAI：搜索和训练爬虫](https://developers.openai.com/api/docs/bots)
- [Bing AI Performance](https://www.bing.com/webmasters/help/ai-performance-9f8e7d6c)

## 进阶实操：可直接抄的细节与排障

### 项目能运行，比项目介绍更重要

README 的第一屏先放一句实用价值、支持环境、安装命令、最小输入输出。准备一个 `examples/` 文件夹，提供可以离线运行的输入与预期输出。重要失败要有 FAQ，比如缺少权限、版本不兼容、网络受限、输入格式错误。让另一台全新电脑按 README 独立执行，不要默认作者的本地环境已经配置好。

### 技术内容怎么与 GEO 结合

官网技术介绍页提供目标用户的真实问题与可验证的功能说明，链接到官方 GitHub 代码、文档及 Release；仓库 README 再指回正式产品页和支持路径。每次版本变更写清兼容性、修复与已知限制。可以手工监测 ChatGPT/Bing 对相关技术问题是否出现该文档的 URL，但 Star、GitHub 搜索排名与 AI 引用是不同指标。

### 对抗式验收

让一名没看过源码的开发者在 5 分钟内尝试 Quickstart；失败则记录哪一步缺环境依赖、提示不清或输出不可复现。不要先让 AI 编一个漂亮示例，再把不能运行的代码宣传成「已验证」。