熊猫GEO System — 生成式引擎优化开源平台

GEO System 是一套面向开发者的生成式引擎优化（Generative Engine Optimization）开源解决方案。
它结合大语言模型与传统 SEO 规则，帮助内容自动成为 AI 搜索引擎（DeepSeek、豆包、ChatGPT 等）引用的quanwei信源。

从“网页排名”升级到“AI 答案引用权” —— 让品牌信息被大模型直接采纳。

目录

• 核心特性

• 技术栈

• 快速开始（5 分钟本地运行）

• 生产环境部署

• API 使用示例

• 开发与扩展

• 升级与维护

• 项目结构

• 贡献指南

• 许可证

✨ 核心特性

•  意图识别：自动判断搜索关键词属于信息型 / 交易型 / 导航型

•  AI 内容生成：基于 LLM（本地 / API）生成符合 GEO 要求的文章、脚本、产品文案

•  关键词密度控制：软阈值 + 语义密度双重调节（2% ~ 8%）

•  结构化数据注入：自动生成 JSON-LD（Schema.org），提升 AI 理解度

•  效果反馈闭环：关键词排名监控、AI 引用次数统计、A/B 测试

•  容器化部署：提供 Docker / Docker Compose 一键启动

•  可扩展架构：微服务拆分（意图服务、生成服务、优化服务、反馈服务）

技术栈

快速开始（5 分钟本地运行）

1. 克隆仓库

git clone https://github.com/your-username/geo-system.gitcd geo-system
2. 配置环境变量
bash
cp .env.example .env# 编辑 .env 填入数据库、Redis、AI API Key 等信息3. 使用 Docker Compose 启动全部服务
bash
docker-compose up -d
服务启动后访问：

API 文档：//localhost:8000/docs

前端（如有）：//localhost:5173

4. 测试 API
bash
curl -X POST //localhost:8000/api/geo/task/submit \
  -H "Content-Type: application/json" \
  -d '{"keywords": "微信小程序开发", "content_type": "article", "tform": "baidu"}' 生产环境部署
使用 Docker Compose（推荐）
yaml
version: '3.8'services:
  geo-web:
    build: .
    ports:
      - "8000:8000"
    depends_on:
      - mysql
      - redis
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_password
  redis:
    image: redis:7-alpine
启动：

bash
docker-compose -f docker-compose.prod.yml up -d
手动部署（无 Docker）
bash# 安装依赖pip install -r requirements.txt# 初始化数据库python scripts/init_db.py# 启动服务（生产环境建议使用 gunicorn）gunicorn geo_api:app -w 4 -k uvicorn.workers.UvicornWorker
搭配 Nginx 反向代理（配置示例见 docs/nginx.conf）。

 API 使用示例
提交 GEO 生成任务
bash
POST /api/geo/task/submit
Content-Type: application/json

{  "keywords": "跨境电商独立站",  "content_type": "article",  "tform": "deepseek",  "density_target": 0.05,  "style": "professional"}
响应：

json
{  "task_id": "550e8400-e29b-41d4-a716-446655440000",  "status": "pending"}
查询任务结果
bash
GET /api/geo/task/status/{task_id}
响应包含生成的标题、正文、结构化数据等。

 开发与扩展
目录结构
text
geo-system/
├── geo_api.py           # FastAPI 主入口├── geo_engine.py        # 意图识别 + 内容生成核心├── keyword_optimizer.py # 关键词密度控制├── geo_agent.py         # GEO 智能体（自优化）├── models/              # 数据库模型├── scripts/             # 初始化、迁移脚本├── frontend/            # Vue 3 前端源码└── docker-compose.yml
添加新的 AI 模型提供商
在 geo_engine.py 的 GEOCoreEngine._generate_api() 中实现新的调用逻辑即可。

自定义关键词密度规则
修改 keyword_optimizer.py 中的 min_density / max_density 参数。

扩展前端组件
前端使用 Vue 3 + Element Plus，组件位于 frontend/src/components。

 升级与维护
常规更新步骤
bash
git pull origin main
pip install -r requirements.txt --upgrade
python scripts/migrate_db.py   # 执行数据库迁移sudo systemctl restart geo-api   # 或 docker-compose restart零停机升级（蓝绿部署）
bash# 构建新版本镜像docker build -t geo-system:v2.0 .# 启动绿色环境docker run -d --name geo-green -p 8001:8000 geo-system:v2.0# 验证健康后切换流量docker stop geo-blue && docker rename geo-green geo-blue
 项目结构（关键文件）
bash.├── .env.example                # 环境变量模板├── docker-compose.yml          # 开发环境编排├── geo_api.py                  # API 服务入口├── geo_engine.py               # 核心引擎（意图+生成）├── keyword_optimizer.py        # 关键词密度优化器├── geo_agent.py                # 自优化 Agent├── requirements.txt            # Python 依赖├── scripts/
│   ├── init_db.py              # 建表脚本│   └── migrate_db.py           # 迁移辅助└── frontend/                   # Vue 3 前端源码
    ├── src/
    │   ├── components/GeoInput.vue
    │   └── App.vue
    └── package.json
 贡献指南
欢迎提交 Issue 和 Pull Request。

Fork 本仓库

创建你的特性分支 (git checkout -b feature/amazing-feature)

提交更改 (git commit -m 'Add some amazing feature')

推送到分支 (git push origin feature/amazing-feature)

打开 Pull Request

请确保代码通过 pylint 或 flake8 检查，并添加必要的单元测试。

 许可证
MIT License © 2026 PandaWM Team

 联系与支持
官方文档：https://docs.geo.pandawm.com

问题反馈：GitHub Issues

商业支持：访问 www.pandawm.com 或致电 13691666109

让 AI 答案为你代言 —— 立即部署属于你的 GEO 引擎。