# GeoCore

**Repository Path**: bty1987/GeoCore

## Basic Information

- **Project Name**: GeoCore
- **Description**: GEO（AI 搜索可见性）业务总仓库：商业战略、渠道合作、客户交付模板、监测引擎与六件工具链、报价前端、6 条 PDF 设计产线；GEO 服务主线 + 系统定制开发拓展线双线互哺。私有商业仓库，保持私有。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-10
- **Last Updated**: 2026-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 数字营销, geo, AI搜索

## README

<div align="center">

# GeoCore

**GEO 业务总仓库 · AI 搜索可见性服务 + 系统定制开发**

_战略 · 渠道 · 交付 · 引擎 · 工具链 · 设计产线_

**GEO 把客户带到门口，系统把推荐来的生意接住。**

[![star](https://gitee.com/bty1987/GeoCore/badge/star.svg?theme=gitee)](https://gitee.com/bty1987/GeoCore/stargazers)
[![fork](https://gitee.com/bty1987/GeoCore/badge/fork.svg?theme=gitee)](https://gitee.com/bty1987/GeoCore/members)
![attr](https://img.shields.io/badge/attr-PRIVATE-red)
![Python](https://img.shields.io/badge/Python-3.x-3776AB)
![Playwright](https://img.shields.io/badge/Playwright-engine%20%2F%20pdf-2EAD33)
![Frontend](https://img.shields.io/badge/Frontend-HTML%2FJS%20zero--build-42B883)

</div>

---

## 这是什么

GeoCore 是 GEO（AI 搜索可见性）业务的**唯一资料主场**：商业战略、渠道合作、客户交付模板、监测引擎代码、设计产线、归档情报，全部资产一处存放、跨设备长期维护。它承载的不是单个产品，而是**两条互哺的业务线**——主线做 GEO 服务（让客户在豆包/元宝/DeepSeek 等 AI 回答里被提及、被推荐），拓展线接住由此长出来的系统定制开发生意。

**它解决的真实问题：**

- 客户在 AI 回答里"搜不到、不被提及、不被推荐"，传统 SEO 接不了这一层——**GEO 主线**解决（L1 诊断 → L2 监测 → L3 优化执行 → L4 战略托管）；
- GEO 客户每月看数据，天然暴露"线索没人跟、库存靠 Excel、审批靠签字"——**定制开发拓展线**接住；
- 周报靠人手拼、效果证据链不完整——**监测引擎 + 六件工具链**解决（引擎未上线前手填 CSV 同 schema，链路照跑）。

**仓库边界（卖点，也是底线）**：私有商业仓库——含定价、渠道条款与客户进展，**保持私有**；对外文档不留 AI 痕迹、不虚构案例；空针=自建试验田，对外不得包装成案例。

### 基本信息

| 项 | 内容 |
|---|---|
| 仓库 | `bty1987/GeoCore` · `https://gitee.com/bty1987/GeoCore` |
| 属性 | 私有商业仓库 · 建仓 2026-09-10 · 跨设备长期维护 |
| 当前阶段 | 商业物料、交付模板、引擎工具链、6 条 PDF 产线全部就绪，进入首批客户验证 |
| 资产规模 | 102 个文件 · 6 条 PDF 产线（已交付 7 份）· 监测引擎 v0 + 6 件工具链 · geo-web 3 个前端页面 |
| 监测口径 | 40 词 × 3 平台（豆包/腾讯元宝/DeepSeek）；优化平台另计 6 家可选 |
| 维护方式 | 改完即 commit，`git push` 推送（凭证在系统钥匙串）；过时资料进 `99-归档/` |

## 能力全景

```text
┌──────────────────────────────────────────────────────┐
│  设计产线    6条PDF产线：启动书/手册/作战包/服务说明/…      │
├──────────────────────────────────────────────────────┤
│  报价前端    演示版 · 客户在线询价 · 渠道底价助手            │
├──────────────────────────────────────────────────────┤
│  数据工具链  周报 · 快查 · 归因 · 只读门户 · 内容量产工作台  │
├──────────────────────────────────────────────────────┤
│  监测引擎    40词×3平台 · 适配器抽象 · 限频调度 · 截图存证   │
├──────────────────────────────────────────────────────┤
│  商业底座    商业计划书 · 12周执行手册 · 渠道物料 · 交付模板 │
└──────────────────────────────────────────────────────┘
     底座：私有仓库 · 跨设备长期维护 · 证据链完整
```

| 板块 | 说明 | 状态 |
|---|---|---|
| 📋 商业战略 | 商业计划书（市场/L1–L4 定价/GTM/财务/路线图）+ 12 周执行手册（40 词/账号矩阵/内容日历） | ✅ 就绪 |
| 🤝 渠道物料 | 合伙人提案 v1.1 · 协议条款清单 · 演示包 · 转述手册，含双线佣金结构 | ✅ 就绪 |
| 📬 客户交付模板 | 启动书 · 资料清单 · 宣传手册 · 产品描述，【】占位改写即用 | ✅ 就绪 |
| 🔧 监测引擎 v0 | 适配器抽象 + 豆包骨架 + 限频调度（单账号日查 ≤15）+ 全页截图存证 | 🚧 v0 推进中 |
| 🛠️ 数据工具链 | 基线表 / 周报 / 快查 / 归因 / 只读门户 / 内容工作台，P0–P2 六件 | ✅ 全就绪 |
| 🌐 geo-web | 演示版 · 客户询价 · 渠道底价助手（主机白名单 + 口令双护栏） | ✅ v3.4 |
| 🖨️ PDF 设计产线 | 六条产线已交付 7 份 PDF（4–9 页不等），全部逐页验收通过 | ✅ 就绪 |
| 📦 定制开发线 | 合同底稿：变更管理/验收/背景知识产权三柱子 | ✅ 底稿就绪 |

> **规划中（不作为当期承诺）**：引擎 40 词全自动采集闭环 · LLM 解析提及/位次/倾向（v1）· 客户意向提取与跟进助手。

## 双线业务定位与市场卡位

| 线 | 内容 | 逻辑 |
|---|---|---|
| **① GEO 产品线（主线）** | AI 可见性服务：L1 诊断 → L2 监测 → L3 优化执行 → L4 战略托管 | 让客户在豆包/元宝/DeepSeek 等 AI 回答里被提及、被推荐 |
| **② 系统开发拓展线（粮草）** | 进销存 / CRM / 财务对接 / OA / 行业 ERP / 定制开发 | 通过 GEO 客户的长期维护与合伙人、客户推荐，获取系统开发机会 |

两线关系一句话：**GEO 把客户带到门口，系统把推荐来的生意接住。** 系统客户的获客焦虑又反哺 GEO。渠道合伙人双线佣金：GEO 首年 15%–25%，开发项目首单 10%–15%、续约 5%。

| 市场参照 | 量级 | 相对位置 |
|---|---|---|
| 摩尔 GEO | ~2 万/年 | 低价量贩带 |
| 蓝标 BlueGEO | 15 万/月起 | 大厂高端带 |
| **本项目 GEO 服务（空针数据）** | 中间空档带 | 中小客户的专业服务卡位（详见商业计划书） |

## 业务架构（每周闭环）

```text
空针 40 词 × 3 平台（豆包 / 腾讯元宝 / DeepSeek）
 ▼
geo-engine-v0 监测引擎（限频调度 · 截图存证 · CSV 台账）
 ├─▶ weekly_report.py  周报草稿 ── --json ─▶ portal.html 客户只读门户
 ├─▶ quickcheck.py     快查报告（获客钩子，客户视角）
 └─▶ attribution.py    归因核对（发布台账 × 监测引用）
        ▲                            │
        │ 发布登记                    │ 引用回血验证
 内容量产工作台（事实库 + 六平台模板 + 起草 prompt）◀── 周报"需优化词清单"
```

引擎未上线期间，手动填写基线记录表（14 列 schema 与引擎产出同源）即可跑通全链路：监测/填表 → 周报（+门户数据）→ 未提及词喂内容工作台出内容 → 发布登记归因台账 → 归因核对。

## 技术栈

| 层 | 技术 | 说明 |
|---|---|---|
| 监测引擎 | Python 3 + Playwright | 适配器抽象（豆包先行）、限频调度（单账号日查 ≤15）、全页截图存证 |
| 数据工具链 | Python 标准库（CSV/JSON） | 周报/快查/归因三脚本，引擎产出与手工填写同一 schema，可无缝切换 |
| Web 前端 | 纯 HTML/JS，单文件 SPA，零后端零构建 | localStorage 演示存储；配置文件与页面分离，调价只改配置 |
| PDF 产线 | Node + Playwright（HTML→PDF） | 咨询报告体模板家族，六个项目共用导出脚本 |
| 渲染质检 | Python + pypdfium2 | 逐页 PNG，供人工/评审验收 |

## 快速开始 / 常用操作

### geo-web 本地预览
```bash
cd 05-引擎/geo-web && python3 -m http.server 8777
# 演示版   http://127.0.0.1:8777/index.html
# 客户询价 http://127.0.0.1:8777/quotation.html
# 渠道助手 http://127.0.0.1:8777/quotation-dealer.html（禁公网部署，口令见 quotation-dealer.config.js）
```

### 周报 / 快查 / 归因（引擎工具链）
```bash
cd 05-引擎/geo-engine-v0
python weekly_report.py --this-week 本周台账.csv [--last-week 上周台账.csv]   # 周报草稿，--json 出门户数据
python quickcheck.py --this-week 台账_快查_YYMMDD.csv [--industry 房产家装]  # 客户视角快查报告（获客钩子）
python attribution.py --book 发布台账.csv --ledger output/ledger_doubao_*.csv # 发布×引用归因核对
```

### 给客户/合伙人出新 PDF（三步）
1. 改 `03-客户交付模板/` 对应模板里的【】占位符
2. 改 `06-设计工程/<项目>/design-demos/` 里选定的 HTML（内容同步）
3. 导出：
```bash
cd 06-设计工程/GEO客户启动书/scripts
node export_pdf.js ../design-demos/<源html>.html "../<输出>.pdf" "<页脚文档名>"
# 合伙人转述手册项目同理，需指定依赖：
NODE_PATH="$PWD/../GEO客户启动书/scripts/node_modules" node export_pdf.js
```

### PDF 渲染质检（逐页 PNG）
```bash
python3 06-设计工程/render_pages.py "<某.pdf>"   # 依赖：pip install pypdfium2
```

### 环境依赖（一次性）
- node + playwright（`06-设计工程/GEO客户启动书/scripts` 下 `npm i playwright && npx playwright install chromium`）
- python3 + pypdfium2（渲染质检）

## 目录结构

```text
GeoCore/
├── 01-商业战略/          商业模式与执行方法
├── 02-渠道合作/          合伙人/渠道全套物料
├── 03-客户交付模板/      客户沟通模板（【】占位，按客户复制改写）
├── 04-定制开发线/        拓展线的合同与交付底稿
├── 05-引擎/              监测引擎 + 工具链 + 报价前端（产品化的种子）
├── 06-设计工程/          PDF 设计产线（模板→HTML→PDF）
└── 99-归档/              过时文档与一次性情报
```

## 资产索引（按角色从哪读起）

| 你想做什么 | 入口 |
|---|---|
| 了解这门生意 | `01-商业战略/GEO服务商商业计划书.md` |
| 谈渠道 / 见合伙人 | `02-渠道合作/GEO服务-合伙人合作提案.md` + `GEO-合伙人演示包.md` |
| 服务客户 / 出交付物 | `03-客户交付模板/` |
| 跑监测 / 出周报 | `05-引擎/geo-engine-v0/README.md`（工具链总览 + 每周闭环） |
| 出 PDF | `06-设计工程/`（六条产线） |
| 报价 / 询价 | `05-引擎/geo-web/` |

### 01-商业战略/
| 文件 | 说明 |
|---|---|
| `GEO服务商商业计划书.md` | 完整商业计划：市场/技术架构/L1–L4 定价/GTM/财务/路线图。定价卡位：摩尔GEO（~2万/年）与蓝标 BlueGEO（15万/月起）之间的空档带 |
| `空针数据-GEO执行手册.md` | 12 周执行手册：40 条监测查询词、账号矩阵、内容日历、平台模板、周/月报流程。空针=自建试验田（非外部客户，对外不得包装成案例） |

### 02-渠道合作/
| 文件 | 说明 |
|---|---|
| `GEO服务-合伙人合作提案.md` | 发给合伙人的提案 v1.1：市场逻辑、四层服务、效果模型、佣金结构、自建试验田披露、销售话术。含 6.5 定制开发居间佣金条款 |
| `GEO服务-渠道合作协议条款清单.md` | 渠道协议谈判底稿：客户归属保护、承诺红线（不让）、佣金结算、退出机制 |
| `GEO-合伙人演示包.md` | 合伙人开打三件套：30 分钟会议脚本／试验田一页纸／GEO+定制两张价卡 |
| `合伙人转述手册-开发能力与产品线-模板.md` | 拓展线赋能件（源稿）：教非技术合伙人听懂开发能力、听出商机信号、照抄话术。对应设计工程里已有 9 页 PDF 版 |

### 03-客户交付模板/
| 文件 | 说明 |
|---|---|
| `GEO客户启动书-模板.md` | 售前说服用：为什么做 + 效果预期 + 承诺边界 + 14 项启动资料清单。【】占位按客户替换 |
| `GEO客户资料准备清单-模板.md` | 客户确认合作后收资料用：P0/P1 优先级、3 个填写模板、FAQ、命名规范。**与启动书分工勿混：启动书=售前，清单=售后** |
| `客户宣传手册-模板.md` | 对外宣传册源稿（客户直接阅读）：双线业务介绍，六节结构；不放价格与商务条款，空针只用试验田口径 |
| `GEO产品描述-模板.md` | GEO 独立产品描述多场景文案：一句话版 / 30 字电梯版 / 200 字标准版 / 详细版（含适合谁·不适合谁），按场合取用 |

### 04-定制开发线/
| 文件 | 说明 |
|---|---|
| `定制开发-合同模板条款版.md` | 定制开发合同底稿：三柱子=变更管理/验收/背景知识产权；附《服务确认函》《变更单》模板 |

### 05-引擎/
| 目录 | 说明 |
|---|---|
| `geo-engine-v0/` | 监测引擎脚手架：适配器抽象 + 豆包骨架 + 限频调度 + 空针 40 词表。v0 目标：自动化跑 40 词 × 平台监测（原目标 2026-10-05）。密钥只放 `config.yaml`（已 gitignore），只提交 `config.example.yaml`。**已就绪工具链（2026-10-01）：基线记录表模板/周报生成器/快查报告/归因核对/客户只读门户，详见其 README 工具链总览** |
| `geo-web/` | GEO检测系统网页前端：`index.html` 演示版 + `quotation.html` 客户版询价 + `quotation-dealer.html` 渠道版（含底价，禁公网部署，主机白名单+口令双护栏）。预览 `cd 05-引擎/geo-web && python3 -m http.server 8777` |
| `内容工作台/` | P1-3 内容量产：事实库模板 + 六平台内容模板 + 强制引用事实库的起草 prompt + 每周节奏（接周报"需优化词清单"） |

### 06-设计工程/
| 目录 | 说明 |
|---|---|
| `GEO客户启动书/` | 启动书/资料清单 PDF 产线：design-demos（选定 V2 咨询报告体）+ 两份已交付 PDF（各 6 页，judge 验收）+ scripts/export_pdf.js + assets（平台 logo base64 缓存） |
| `合伙人转述手册/` | 转述手册 PDF 产线：design-demos/consulting-report.html + `合伙人转述手册-咨询报告体.pdf`（9 页，judge 三轮验收）+ render/ 逐页 PNG |
| `售前聊作战包/` | 售前聊 PDF 产线：design-demos/consulting-report.html + `售前聊与预诊断作战包.pdf`（5 页，judge 验收通过）+ scripts/export_pdf.js；豁免记录 direction-approved.md |
| `客户宣传手册/` | 对外宣传册 PDF 产线：design-demos/consulting-report.html + `客户宣传手册-团队与业务介绍.pdf`（5 页）+ scripts/export_pdf.js；direction-approved.md |
| `GEO服务说明-客户版/` | GEO 单品客户版 PDF 产线：design-demos/consulting-report.html + `GEO服务说明-客户版.pdf`（4 页，judge 4/4 通过）；与《客户宣传手册》分工：手册=双线总览，本册=GEO 单品深版 |
| `消息自动化场景说明/` | 消息自动化与 AI 客户经营 PDF 产线：design-demos/consulting-report.html + `消息自动化与AI客户经营-客户场景说明.pdf`（7 页，逐页图像分析 7/7 通过；客户说明+售前弹药双受众）；direction-approved.md（单版直出豁免） |

### 99-归档/
| 文件 | 说明 |
|---|---|
| `竞品情报-量贩式GEO报价单-2026-09.md` | 2026-09 合伙人转来的量贩式 GEO 报价单分析：条数经济学拆解 + 鉴别三问。一次性情报，留档备查 |

## 里程碑

当前阶段：六件工具链与六条 PDF 产线全部就绪，进入**首批客户验证**（渠道首单已建档，2026-09-30）。

| 日期 | 里程碑 |
|---|---|
| 2026-09-08 | 监测引擎创建（geo-engine-v0，适配器抽象 + 空针 40 词表） |
| 2026-09-10 | **GeoCore 建仓**：GEO 业务总资料迁移归档，六大目录成型 |
| 2026-09-11 | 三条 PDF 产线落地：售前作战包（5页）／客户宣传手册（5页）／GEO 服务说明客户版（4页） |
| 2026-09-14 | geo-web 一日四级跳 v1→v3.2（落地页→空针品牌闭环→三阶段问法矩阵→报告文档式版式与校准）；消息自动化产线（7页）；首个客户通话配套交付 |
| 2026-09-22 | geo-web v3.4：报价工具 v1（客户版在线询价 + 渠道版底价助手，双配置防底价泄漏） |
| 2026-09-30 | P0 落地：基线记录表模板 + 周报半自动生成器；渠道首单建档（李宏浩-大连，归属证据归档） |
| 2026-10-01 | **工具链收官**：P1-3 内容工作台／P1-4 快查报告／P2-5 只读门户／P2-6 归因核对，六件产品全就绪 |
| 2026-10-09 | README 改版：对齐 ArchCore 说明文档结构（能力全景/业务架构/FAQ/边界） |

## 常见问题（FAQ）

**Q：「空针数据」是什么？**
自建试验田的品牌名——非外部客户，对外不得包装成案例；geo-web 与演示材料的品牌位用它，对外口径只用"试验田"。

**Q：引擎自动化还没跑通，周报怎么出？**
基线记录表手动填写（14 列 schema 与引擎产出同源），`weekly_report.py` 照常统计出稿，`--json` 出门户数据；引擎上线后无缝切自动采集。

**Q：渠道版报价助手为什么禁止公网部署？**
它含底价/毛利/提成测算。护栏是三层：不随公网部署、主机白名单软校验（仅本地/白名单域名可开）、口令帘（只是防随手点开，不是安全机制）。底价口径只存在于仓库与渠道私发件中。

**Q：监测会不会把账号弄封？**
纪律先于功能：单账号日查询 ≤15、查询间随机等待 3–10 分钟、全任务错峰、账号/指纹/代理一一绑定——宁可慢，不可封。

**Q：密钥和运行数据放哪？**
`config.yaml` 与 `output/` 已 gitignore 不入库，仓库只提交 `config.example.yaml`；交付模板不带客户名，按客户复制时另命名。

## 使用边界与维护规则

- **红线**：本仓库含商业定价与渠道条款，**保持私有**；对外文档不留 AI 痕迹、不虚构案例
- **归档**：过时的谈判底稿、一次性竞品情报、被新版替代的文档 → 进 `99-归档/`，文件名带年月
- **命名**：正式交付物带版本与日期（如 `xxx-v2咨询报告体.pdf`）；模板不带客户名，按客户复制时另命名
- **提交**：改完即 commit，一句话说明改了什么；推送 `git push`（凭证在系统钥匙串）
- **部署**：geo-web 公网只上传客户版白名单文件（`index.html`/`quotation.html`/`quotation-config.js`），渠道版两件绝不公网部署

## 许可证

本仓库为**私有商业仓库，保留所有权利（All Rights Reserved）**。仅限内部与授权渠道使用，不对第三方开放；如需引用其中任何材料，请先与作者取得联系。