feat: 重构项目结构并添加平台同步基础架构
- 重构项目目录结构，将功能模块移至 modules/ 目录 - 创建平台同步基础架构，包括发布器基类和 GitHub 发布器 - 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态 - 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip) - 整理文档结构，将所有文档分类移至 docs/ 目录 - 添加 .cursorrules 文件定义项目开发规范 - 清理根目录重复文件，保持项目结构整洁
This commit is contained in:
刘国栋
@@ -0,0 +1,228 @@
|
||||
# 资源推荐模块功能说明
|
||||
|
||||
## 📋 功能概述
|
||||
|
||||
资源推荐模块是 GEO 工具的辅助功能，用于提供 GEO 相关的资源推荐，包括代理服务、工具、论文指南和社区资源，帮助用户发现相关工具和资源，增强工具生态。
|
||||
|
||||
### 核心价值
|
||||
|
||||
- **增强工具生态**：提供 GEO 相关资源，完善工具生态
|
||||
- **发现相关工具**：帮助用户发现有用的 GEO 工具和资源
|
||||
- **学习资源**：提供论文、指南等学习资源
|
||||
- **社区连接**：连接 GEO 社区，促进交流
|
||||
|
||||
## 🎯 功能位置
|
||||
|
||||
### Tab8（GEO 资源库）
|
||||
|
||||
在 Tab8 中，提供完整的资源库展示界面，包含资源统计、搜索功能、分类浏览等。
|
||||
|
||||
## 📊 功能模块
|
||||
|
||||
### 1. GEO 代理列表
|
||||
|
||||
**功能说明**：
|
||||
- 推荐专业的 GEO 代理服务
|
||||
- 包含代理名称、描述、评分、功能特性、链接
|
||||
|
||||
**当前代理**：
|
||||
- **KrillinAI**：专业的 GEO 代理服务，提供高质量的内容生成和优化
|
||||
- **AutoGPT**：自动化 AI 代理，支持 GEO 内容创作
|
||||
- **AgentGPT**：基于 GPT 的智能代理，支持 GEO 策略执行
|
||||
|
||||
**显示信息**：
|
||||
- 代理名称和评分
|
||||
- 详细描述
|
||||
- 分类标签
|
||||
- 功能特性列表
|
||||
- 访问链接
|
||||
|
||||
---
|
||||
|
||||
### 2. 工具推荐
|
||||
|
||||
**功能说明**：
|
||||
- 推荐 GEO 相关的工具和服务
|
||||
- 包含工具名称、描述、评分、功能特性、链接
|
||||
|
||||
**工具分类**：
|
||||
- **SEO 工具**：Google Search Console、Bing Webmaster Tools
|
||||
- **技术工具**：Schema.org Validator、Rich Results Test
|
||||
- **性能工具**：PageSpeed Insights
|
||||
|
||||
**显示信息**：
|
||||
- 工具名称和评分
|
||||
- 详细描述
|
||||
- 分类标签
|
||||
- 功能特性列表
|
||||
- 访问链接
|
||||
|
||||
---
|
||||
|
||||
### 3. 论文/指南链接
|
||||
|
||||
**功能说明**：
|
||||
- 提供 GEO 相关的论文、指南、文档链接
|
||||
- 包含标题、描述、分类、日期、重要性
|
||||
|
||||
**资源分类**：
|
||||
- **官方指南**：Google E-E-A-T Guidelines
|
||||
- **技术文档**：Schema.org Documentation
|
||||
- **策略指南**：GEO Strategy Guide
|
||||
- **最佳实践**：AI Search Optimization
|
||||
- **技术指南**：LLM Prompt Engineering
|
||||
|
||||
**重要性等级**：
|
||||
- 🔥 **高**：核心资源，必读
|
||||
- ⭐ **中**：重要资源，推荐阅读
|
||||
- 📌 **低**：参考资源，可选阅读
|
||||
|
||||
**显示信息**：
|
||||
- 标题和重要性图标
|
||||
- 详细描述
|
||||
- 分类、日期、重要性
|
||||
- 访问链接
|
||||
|
||||
---
|
||||
|
||||
### 4. 社区资源
|
||||
|
||||
**功能说明**：
|
||||
- 提供 GEO 相关的社区和论坛链接
|
||||
- 包含社区名称、描述、评分、链接
|
||||
|
||||
**当前社区**：
|
||||
- **GEO Reddit Community**：GEO 相关讨论和经验分享
|
||||
- **AI SEO Discord**：AI SEO 和 GEO 技术交流社区
|
||||
|
||||
**显示信息**：
|
||||
- 社区名称和评分
|
||||
- 详细描述
|
||||
- 分类标签
|
||||
- 访问链接
|
||||
|
||||
---
|
||||
|
||||
### 5. 资源搜索
|
||||
|
||||
**功能说明**：
|
||||
- 支持关键词搜索所有资源
|
||||
- 可搜索代理、工具、论文、社区
|
||||
- 实时显示搜索结果
|
||||
|
||||
**搜索范围**：
|
||||
- 资源名称
|
||||
- 资源描述
|
||||
- 功能特性（代理和工具）
|
||||
|
||||
---
|
||||
|
||||
### 6. 分类浏览
|
||||
|
||||
**功能说明**：
|
||||
- 使用标签页分类浏览资源
|
||||
- 四个分类：代理、工具、论文、社区
|
||||
- 每个分类独立展示
|
||||
|
||||
---
|
||||
|
||||
### 7. 资源统计
|
||||
|
||||
**功能说明**：
|
||||
- 显示资源总数和分类统计
|
||||
- 格式：共 X 个资源（代理 X | 工具 X | 论文 X | 社区 X）
|
||||
|
||||
## 🔄 使用方式
|
||||
|
||||
### 1. 打开资源库
|
||||
|
||||
1. 点击顶部导航栏的"8 GEO 资源库"标签页
|
||||
2. 进入资源库主界面
|
||||
|
||||
### 2. 浏览资源
|
||||
|
||||
1. 选择分类标签页（代理、工具、论文、社区）
|
||||
2. 浏览该分类下的所有资源
|
||||
3. 点击链接访问资源
|
||||
|
||||
### 3. 搜索资源
|
||||
|
||||
1. 在搜索框输入关键词
|
||||
2. 系统自动搜索所有资源
|
||||
3. 查看搜索结果
|
||||
|
||||
### 4. 查看资源详情
|
||||
|
||||
每个资源卡片显示：
|
||||
- 名称和评分
|
||||
- 详细描述
|
||||
- 分类信息
|
||||
- 功能特性（如适用）
|
||||
- 访问链接
|
||||
|
||||
## 💡 使用建议
|
||||
|
||||
### 1. 定期查看
|
||||
|
||||
建议定期查看资源库，发现新的工具和资源。
|
||||
|
||||
### 2. 按需搜索
|
||||
|
||||
使用搜索功能快速找到需要的资源。
|
||||
|
||||
### 3. 分类浏览
|
||||
|
||||
根据需求选择相应的分类标签页浏览。
|
||||
|
||||
### 4. 收藏重要资源
|
||||
|
||||
将重要的资源链接收藏，方便后续使用。
|
||||
|
||||
## 🔧 技术实现
|
||||
|
||||
### 模块位置
|
||||
|
||||
- **推荐模块**：`modules/resource_recommender.py`
|
||||
- **UI 集成**：`modules/geo_tool.py` Tab8
|
||||
|
||||
### 核心类
|
||||
|
||||
- `ResourceRecommender`：资源推荐器
|
||||
- `get_agents()`：获取代理列表
|
||||
- `get_tools()`：获取工具列表
|
||||
- `get_papers()`：获取论文/指南列表
|
||||
- `get_communities()`：获取社区列表
|
||||
- `search_resources()`：搜索资源
|
||||
- `get_resource_summary()`：获取资源统计
|
||||
|
||||
### 数据结构
|
||||
|
||||
资源数据结构：
|
||||
```python
|
||||
{
|
||||
"name": "资源名称",
|
||||
"description": "资源描述",
|
||||
"url": "资源链接",
|
||||
"category": "资源分类",
|
||||
"rating": "评分（可选）",
|
||||
"features": ["功能1", "功能2"]（可选）,
|
||||
"date": "日期（论文）"（可选）,
|
||||
"importance": "重要性（论文）"（可选）
|
||||
}
|
||||
```
|
||||
|
||||
## 📝 更新日志
|
||||
|
||||
- **2025-01-26**：初始版本发布
|
||||
- 实现 GEO 代理列表（3 个代理）
|
||||
- 实现工具推荐（5 个工具）
|
||||
- 实现论文/指南链接（5 个资源）
|
||||
- 实现社区资源（2 个社区）
|
||||
- 实现资源搜索功能
|
||||
- 实现分类浏览（4 个标签页）
|
||||
- 集成到 Tab8（GEO 资源库），提供完整的展示界面
|
||||
|
||||
---
|
||||
|
||||
**版本**：1.0.0
|
||||
**最后更新**：2025-01-26
|
||||
Reference in New Issue
Block a user