No description
- Python 100%
新增: - CitationBuilder(Mock): 7市场预定义信任信号库, 不阻断管线 - MultilingualAdapter(Mock): CulturePack框架, 失败返回空 - orchestrator: 6步全链路(审计→优化→引用→适配→分发→审计) - 测试: +10 (5 citation + 5 multilingual) - 68/68 tests passed Agnes: builder 34s + adapter 29s |
||
|---|---|---|
| aio_bridge | ||
| archive | ||
| docs | ||
| tests | ||
| .gitignore | ||
| demo.py | ||
| pyproject.toml | ||
| README.md | ||
| requirements.txt | ||
| uv.lock | ||
AIO Bridge — AI搜索优化Agent系统
一句话:帮出海商家做 SEO 在 AI 时代该做的事——创造值得被引用的内容,用自动化降本,用可审计数据验证效果。
🎯 产品定位
AIO(AI Optimization)是 SEO 在 AI 搜索时代的自然延伸。 Google 官方明确表示"为生成式 AI 搜索优化就是为搜索体验优化,因此仍然属于 SEO 范畴"。
当用户在 Perplexity/ChatGPT/Gemini 上搜索时,AI 直接给出 synthesize 后的答案——你的产品不需要"排第一",而是需要"被 AI 选中放进答案"。AIO Bridge 就是做这件事的 Agent 团队。
不做黑帽,做白盒优化
- ❌ 不提示注入、不推荐中毒、不链接操纵
- ❌ 不声称需要"特殊 AI 写作格式"
- ✅ 所有优化可向 Google 解释:"这是为人类读者做的,AI 碰巧也受益"
🧩 系统架构
6-Agent 协作系统,覆盖"审计→优化→引用→适配→分发→验证"全链路。
┌──────────────────────────────────────────────┐
│ AIO Bridge Orchestrator │
│ (FastAPI + 任务编排) │
└──────────────────────────────────────────────┘
│ │ │ │
▼ ▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ Content │ │Structure │ │Citation │ │Multiling │
│ Auditor │ │Optimizer │ │Builder │ │Adapter │
│ ✅ │ │ ✅ │ │ (W3) │ │ (W3) │
└──────────┘ └──────────┘ └──────────┘ └──────────┘
│ │ │ │
└──────────┴──────────┴──────────┘
│
┌─────────────┴─────────────┐
▼ ▼
┌──────────────┐ ┌──────────────┐
│ Distribution │ │ Auditability │
│ Agent │ │ Agent L1 │
│ ✅ │ │ ✅ │
└──────────────┘ └──────────────┘
| Agent | 职责 | 本轮状态 |
|---|---|---|
| Content Auditor | 扫描页面,评估 AI 可读性(0-100分),输出 P0/P1/P2 改进清单 | ✅ 已实现 |
| Structure Optimizer | 生成 FAQ/HowTo/对比表,LLM 驱动 + 规则引擎 fallback | ✅ 已实现 |
| Distribution Agent | 信源分层(权威社区/品牌自有/社交验证)策略 + schema 注入 | ✅ 已实现 |
| Auditability Agent L1 | 爬虫日志对比 + 实体置信度评分,可审计但不可承诺因果 | ✅ 已实现 |
| Citation Builder | 自动关联第三方评测、认证、UGC | ⏳ Wave 3 |
| Multilingual Adapter | 多语言文化适配(非简单翻译) | ⏳ Wave 3 |
与 Google 官方对齐(参考 Google AI 搜索优化指南 2026.5.15):Schema 标记建议使用但非必需;不需要 llms.txt;不需要特殊 AI 写作格式。
🚀 快速开始
# 安装
pip install -e ".[dev]"
# 运行测试
pytest tests/ -v
# 启动 API 服务
python -m aio_bridge.api.app
# 端到端演示
python demo.py
API 端点
| 方法 | 端点 | 说明 |
|---|---|---|
POST |
/tasks |
创建优化任务 |
GET |
/tasks/{id} |
查询任务状态 |
GET |
/tasks |
列出所有任务 |
POST |
/tasks/{id}/run |
执行优化全流程 |
GET |
/health |
健康检查 |
📊 测试
58 个单元测试,覆盖所有 4 个核心 Agent + API 端点。
tests/
├── test_api.py # API 端点测试(6 tests)
├── test_content_auditor.py # 内容审计(3 tests)
├── test_structure_optimizer.py # 结构优化(38 tests)
├── test_distribution_agent.py # 分发代理(4 tests)
└── test_auditability_agent.py # 可审计性(5 tests)
🏗️ 技术栈
- 后端:Python 3.11+ / FastAPI / httpx
- LLM:GLM-5.1(Synnovator 赛会算力)+ 规则引擎 fallback
- 数据库:SQLite (aiosqlite)
- 内容解析:BeautifulSoup4
📁 项目结构
aio_bridge/
├── agents/ # 6 Agent 实现
│ ├── content_auditor.py # Agent 1: 内容审计
│ ├── structure_optimizer.py # Agent 2: 结构优化 (LLM)
│ ├── distribution_agent.py # Agent 5: 分发
│ └── auditability_agent.py # Agent 6: 可审计性 L1
├── api/ # FastAPI 层
│ ├── app.py # 应用入口
│ ├── orchestrator.py # 任务编排
│ └── routes.py # API 路由
├── utils/ # 工具层
│ ├── config.py # 配置管理
│ ├── html_parser.py # HTML 解析
│ └── http_client.py # HTTP 客户端
├── models.py # 数据模型
├── db.py # 数据库
└── demo.py # 端到端演示脚本
🗺️ 路线图
| 阶段 | 目标 | 状态 |
|---|---|---|
| Wave 1 | 概念验证 + Specs 提交 | ✅ |
| Wave 2 | MVP 原型(4 Agent 可运行) | ✅ 当前 |
| Wave 3 | Citation Builder + Multilingual Adapter | ⏳ |
| Wave 4 | 产品化(管理后台、订阅、多平台) | 📅 |
📄 许可证
MIT
版本:v1.1 | 日期:2026-06-03 | 状态:Wave 2 复赛 | 审查:Hermes(pro) + Kimi + GLM 三方交叉审查