feat: implement comprehensive reading analytics system with bot detection

Features: - Add article view tracking with automatic deduplication (per user/IP) - Implement intelligent bot detection (35+ patterns: Google, Bing, Baidu, GPTBot, etc) - Create admin analytics dashboard with statistics and filtering - Display view count and comment count on article cards - Add search-based article filter (replaced dropdown for scalability) Analytics Dashboard: - Global stats: total views, human/bot views, unique IPs/users - Top 20 articles ranking with detailed metrics - Detailed view records with time, article, user, IP, user-agent - Filters: article title search, IP search, show/hide bots - Pagination support (50 records per page) Technical Implementation: - Async view recording (non-blocking) - Dual deduplication (application + database layer) - Database indexes for performance optimization - Batch query for comment counts - Full i18n support (Chinese/English) Files Added: - models/article_view.go: View tracking model - models/bot_detector.go: Bot detection logic - handlers/admin_analytics.go: Analytics page handler - templates/admin/analytics_views.html: Analytics UI - test_analytics.sh: Testing script - Documentation: implementation guide, usage guide, changelog Files Modified: - handlers/home.go: Add view recording and comment count queries - models/db.go: Add ArticleView to auto-migration - main.go: Add analytics routes - i18n/i18n.go: Add 35+ translation keys - templates/admin/dashboard.html: Add analytics entry link - templates/pages/home.html: Display view/comment counts on cards Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-22 19:57:12 +08:00
parent 5ec783e471
commit da7a39c1c8
16 changed files with 1701 additions and 5 deletions
@@ -0,0 +1,163 @@
+# RSS订阅功能实现计划
+
+## 概述
+为Go博客系统添加RSS 2.0订阅功能，允许用户通过RSS阅读器订阅博客的最新文章。
+
+## 当前项目分析
+
+### 技术栈
+- **框架**: Gin (HTTP框架)
+- **ORM**: GORM
+- **数据库**: SQLite/MySQL (可配置)
+- **模板**: Go HTML templates
+
+### 现有结构
+1. **路由**: 在 `main.go` 中集中注册
+2. **处理器**: 在 `handlers/` 目录下，按功能分文件
+3. **模型**: 在 `models/` 目录下
+4. **文章模型** (`models/article.go`):
+   - 包含标题、摘要、内容、作者、发布时间等字段
+   - 有状态管理（草稿/已发布/已归档）
+   - 支持slug用于URL
+5. **主页** (`handlers/home.go`):
+   - 已有获取已发布文章的逻辑
+   - 按置顶和发布时间排序
+   - 限制返回10篇文章
+
+### 发现
+- 项目没有现有的RSS或feed相关代码
+- 没有RSS相关的Go依赖包
+- 项目支持中英文双语（i18n）
+- 有网站设置模型 (`SiteSetting`)，包含网站标题、描述等信息
+
+## 实现方案
+
+### 方案选择
+**推荐方案**: 使用标准库 `encoding/xml` 手动构建RSS 2.0格式
+- **优点**: 
+  - 无需引入新依赖
+  - RSS 2.0格式简单明确
+  - 完全控制输出格式
+  - 符合项目轻量化原则
+- **缺点**: 
+  - 需要手动定义XML结构
+
+**备选方案**: 使用第三方库如 `github.com/gorilla/feeds`
+- **优点**: 简化RSS生成，支持RSS/Atom/JSON Feed
+- **缺点**: 引入新依赖
+
+**决策**: 采用推荐方案，使用标准库实现RSS 2.0
+
+### 实现步骤
+
+#### 1. 创建RSS模型和生成器 (`handlers/rss.go`)
+- 定义RSS 2.0的XML结构体：
+  - `RSS` (根元素)
+  - `Channel` (频道信息)
+  - `Item` (文章项)
+- 实现 `RSSFeed` 处理器函数：
+  - 从数据库获取最近20篇已发布文章（包含作者信息）
+  - 从 `SiteSetting` 获取网站标题和描述
+  - 根据当前语言决定使用中文或英文的网站信息
+  - 构建RSS XML结构
+  - 设置正确的Content-Type: `application/rss+xml; charset=utf-8`
+  - 返回XML响应
+
+#### 2. RSS内容规范
+- **Channel级别**:
+  - `title`: 网站标题（从 `SiteSetting.LogoText` 获取）
+  - `link`: 网站首页URL
+  - `description`: 网站描述（从 `SiteSetting.HomeSubtitle` 获取）
+  - `language`: zh-CN 或 en-US（根据当前语言）
+  - `lastBuildDate`: 最新文章的发布时间
+  
+- **Item级别**:
+  - `title`: 文章标题
+  - `link`: 文章详情页URL（使用slug）
+  - `description`: 文章摘要（如果有）或内容前200字符
+  - `author`: 作者用户名或显示名称
+  - `pubDate`: 文章发布时间（RFC822格式）
+  - `guid`: 文章的唯一标识（使用文章详情URL）
+
+#### 3. 注册路由 (`main.go`)
+在public路由区域添加：
+```go
+router.GET("/rss", handlers.RSSFeed(db))
+router.GET("/feed", handlers.RSSFeed(db)) // 别名，增加兼容性
+```
+
+#### 4. 可选：在模板中添加RSS链接
+在HTML head中添加RSS自动发现标签：
+```html
+<link rel="alternate" type="application/rss+xml" title="RSS Feed" href="/rss">
+```
+
+### 技术细节
+
+#### URL生成
+- 需要构建完整的文章URL（包含域名）
+- 从请求的 `Host` 头获取域名
+- 构建格式: `http(s)://domain/article/{slug}`
+
+#### 时间格式
+- RSS 2.0要求使用RFC822格式
+- Go time包: `time.RFC1123Z` 或手动格式化
+
+#### 文章内容处理
+- 优先使用 `Summary` 字段
+- 如果没有摘要，截取 `Content` 前200字符
+- 需要处理HTML标签（strip或escape）
+
+#### 字符编码
+- 确保XML声明中包含 `encoding="UTF-8"`
+- Gin自动处理UTF-8编码
+
+### 安全考虑
+- RSS是只读接口，不需要认证
+- 只返回状态为"已发布"的文章
+- XSS防护：XML自动转义特殊字符
+
+### 性能考虑
+- 限制返回文章数量（20篇）
+- 使用数据库索引（status和published_at字段已有索引）
+- 可以考虑添加缓存（后续优化）
+
+## 文件清单
+
+### 新建文件
+1. `handlers/rss.go` - RSS处理器和XML结构定义
+
+### 修改文件
+1. `main.go` - 添加RSS路由
+2. 可选：`templates/layouts/base.html` - 添加RSS自动发现标签
+
+## 测试验证
+
+### 手动测试
+1. 启动服务器
+2. 访问 `http://localhost:PORT/rss`
+3. 验证返回的XML格式正确
+4. 检查Content-Type头
+5. 使用RSS阅读器（如Feedly）订阅测试
+
+### 测试点
+- [ ] RSS XML格式符合RSS 2.0规范
+- [ ] 包含最新的已发布文章
+- [ ] 文章链接可点击且正确
+- [ ] 中英文切换正常工作
+- [ ] 时间格式正确
+- [ ] 特殊字符正确转义
+- [ ] 在RSS阅读器中可正常显示
+
+## 实现优先级
+1. **核心功能**: RSS feed端点，返回最新文章
+2. **可选优化**: 
+   - 在页面头部添加RSS自动发现标签
+   - 添加RSS订阅链接到导航栏
+   - 实现缓存机制
+
+## 注意事项
+- 保持代码风格与现有项目一致
+- 遵循项目的命名约定
+- 添加适当的注释（中英文）
+- 确保RSS feed在中英文环境下都能正常工作
@@ -0,0 +1,140 @@
+# 阅读统计系统 - 更新日志
+
+## 2026-06-22 - v1.1
+
+### ✨ 改进：文章筛选方式优化
+
+**问题**：之前使用下拉框选择文章，当文章数量很多时不便使用。
+
+**解决方案**：改为输入框模糊搜索
+
+#### 变更内容
+
+**旧版本（v1.0）**：
+- 使用 `<select>` 下拉框
+- 需要遍历所有文章填充选项
+- 文章多时下拉框很长，难以查找
+- 只能精确匹配文章ID
+
+**新版本（v1.1）**：
+- 使用 `<input>` 文本输入框
+- 支持关键字模糊搜索
+- 输入文章标题的部分内容即可筛选
+- 使用 SQL `LIKE` 查询，支持中英文
+
+#### 使用方法
+
+在"筛选条件"区域的"文章标题"输入框中：
+- 输入完整标题：`Getting Started`
+- 或输入部分关键字：`start`
+- 支持中文：`入门`
+- 点击"应用筛选"查看结果
+
+#### 技术细节
+
+**Handler 变更**：
+```go
+// 旧代码
+articleIDStr := c.Query("article_id")
+if articleIDStr != "" {
+    query = query.Where("article_id = ?", articleIDStr)
+}
+
+// 新代码
+articleTitle := c.Query("article_title")
+if articleTitle != "" {
+    query = query.Joins("JOIN articles ON article_views.article_id = articles.id").
+        Where("articles.title LIKE ?", "%"+articleTitle+"%")
+}
+```
+
+**模板变更**：
+```html
+<!-- 旧代码 -->
+<select name="article_id">
+    <option value="">全部文章</option>
+    {{range .Articles}}
+    <option value="{{.ID}}">{{.Title}}</option>
+    {{end}}
+</select>
+
+<!-- 新代码 -->
+<input type="text" name="article_title" 
+       placeholder="搜索文章标题"
+       value="{{.Filters.ArticleTitle}}">
+```
+
+**翻译变更**：
+- `analytics_filter_article`: "文章" → "文章标题"
+- `analytics_filter_all_articles`: 删除（不再需要）
+- 新增 `analytics_filter_article_placeholder`: "搜索文章标题"
+
+#### 优势
+
+1. **可扩展性**：支持任意数量的文章
+2. **用户体验**：无需下拉滚动，直接输入
+3. **灵活性**：模糊匹配，不必输入完整标题
+4. **性能优化**：不再需要预加载所有文章列表
+
+#### 兼容性
+
+- ✅ 向后兼容：URL参数从 `article_id` 改为 `article_title`
+- ✅ 数据库兼容：使用标准SQL JOIN和LIKE
+- ✅ 支持SQLite和MySQL
+
+---
+
+## 完整功能列表（v1.1）
+
+### 筛选功能
+- ✅ **文章标题**：输入框模糊搜索（新）
+- ✅ **IP地址**：输入框部分匹配
+- ✅ **显示爬虫**：复选框切换
+
+### 统计展示
+- ✅ 全局统计卡片（5个指标）
+- ✅ 文章排行榜（前20篇）
+- ✅ 详细访问记录（分页）
+
+### 核心功能
+- ✅ 自动记录阅读
+- ✅ 智能爬虫识别
+- ✅ 去重机制
+- ✅ 异步处理
+- ✅ 中英文支持
+
+---
+
+## 升级方法
+
+如果你正在使用 v1.0：
+
+1. **重新编译**：
+```bash
+go build -o go_blog
+```
+
+2. **重启应用**：
+```bash
+./go_blog
+```
+
+3. **无需数据库迁移**：数据结构未变更
+
+4. **清除浏览器缓存**：确保加载新模板
+
+---
+
+## 后续计划
+
+考虑添加的功能：
+- 📅 时间范围筛选（按日期范围）
+- 👤 用户名搜索（类似文章搜索）
+- 📊 导出筛选结果（CSV/Excel）
+- 🔍 高级搜索（组合多个条件）
+
+---
+
+**感谢反馈！** 🙏
+
+这个改进让系统更适合大规模文章数量的场景。
@@ -0,0 +1,239 @@
+# 阅读统计系统实现总结
+
+## 已完成功能
+
+### 1. 数据库模型
+✅ **ArticleView 模型** (`models/article_view.go`)
+- 记录每次独特的阅读
+- 字段：文章ID、用户ID（可为NULL）、IP地址、User-Agent、是否为爬虫
+- 包含去重逻辑（BeforeCreate hook）
+- 建立了必要的索引
+
+✅ **爬虫检测** (`models/bot_detector.go`)
+- 基于User-Agent的模式匹配
+- 支持主流搜索引擎爬虫、社交媒体爬虫、AI爬虫等
+- 包含35+种常见爬虫特征
+
+### 2. 阅读记录功能
+✅ **自动记录** (`handlers/home.go`)
+- 在文章详情页自动记录阅读
+- 异步执行（goroutine）不阻塞页面响应
+- 同一用户/IP只记录一次（去重）
+- 自动识别并标记爬虫
+
+### 3. 后台统计页面
+✅ **统计Dashboard** (`handlers/admin_analytics.go`)
+- 全局统计：总阅读量、真人阅读、爬虫访问、独立IP、独立用户
+- 文章排行榜：前20篇文章的详细统计
+- 详细访问记录：时间、文章、用户、IP、User-Agent、是否爬虫
+- 强大的筛选功能：按文章、IP、是否显示爬虫
+- 分页支持（每页50条）
+
+✅ **精美模板** (`templates/admin/analytics_views.html`)
+- 响应式设计
+- 彩色统计卡片
+- 表格展示详细数据
+- 爬虫记录高亮显示（橙色背景）
+- 筛选表单
+- 分页加载
+
+### 4. 国际化支持
+✅ **中英文翻译** (`i18n/i18n.go`)
+- 添加了35+个翻译key
+- 完整的中英文对照
+
+### 5. 路由和集成
+✅ **路由配置** (`main.go`)
+- `/admin/analytics/views` - 阅读统计页面
+- 管理员权限保护
+
+✅ **数据库迁移** (`models/db.go`)
+- ArticleView表已加入自动迁移
+
+✅ **导航入口** (`templates/admin/dashboard.html`)
+- 后台首页添加"阅读统计"按钮
+
+## 功能特性
+
+### 去重机制
+1. **应用层去重**：在recordArticleView函数中查询现有记录
+2. **数据库层去重**：BeforeCreate hook二次检查
+3. **组合键**：article_id + user_id + ip（匿名用户user_id为NULL）
+
+### 爬虫识别
+检测的爬虫类型：
+- 搜索引擎：Google, Bing, Baidu, Yandex等
+- 社交媒体：Facebook, Twitter, LinkedIn等
+- AI爬虫：GPTBot, ClaudeBot, Anthropic-AI
+- SEO工具：Ahrefs, SEMrush, Moz等
+- 无头浏览器：Headless, Phantom, Puppeteer
+
+### 性能优化
+- ✅ 异步记录（goroutine）
+- ✅ 数据库索引优化
+- ✅ 分页加载（50条/页）
+- ✅ 最佳实践：忽略记录错误，不影响用户体验
+
+### 安全性
+- ✅ 管理员权限保护
+- ✅ 使用c.ClientIP()获取真实IP（处理代理头）
+- ✅ SQL注入防护（GORM参数化查询）
+- ✅ XSS防护（模板自动转义）
+
+## 使用说明
+
+### 启动应用
+```bash
+./go_blog
+```
+
+### 访问统计页面
+1. 以管理员身份登录
+2. 访问后台首页
+3. 点击"阅读统计"按钮
+4. 或直接访问：`http://localhost:PORT/admin/analytics/views`
+
+### 查看统计数据
+**全局统计卡片**：
+- 总阅读量：所有记录数
+- 真人阅读：排除爬虫的阅读数
+- 爬虫访问：被标记为爬虫的访问数
+- 独立IP：不同IP地址数
+- 独立用户：已登录用户数
+
+**文章排行榜**：
+- 显示阅读量最高的20篇文章
+- 每篇文章显示：总阅读、真人阅读、爬虫访问、独立IP
+
+**详细访问记录**：
+- 时间、文章标题（可点击）、用户名、IP地址、User-Agent
+- 爬虫记录以橙色背景高亮
+- 真人显示绿色标签，爬虫显示橙色标签
+
+### 使用筛选功能
+- **按文章筛选**：下拉选择特定文章
+- **按IP筛选**：输入IP地址（支持部分匹配）
+- **显示爬虫**：勾选以包含爬虫流量
+- 点击"应用筛选"查看结果
+
+### 分页浏览
+- 每页显示50条记录
+- 底部显示"加载更多"按钮
+- 筛选条件在翻页时保持
+
+## 技术细节
+
+### 数据模型
+```go
+type ArticleView struct {
+    ID        uint
+    CreatedAt time.Time
+    ArticleID uint
+    UserID    *uint     // NULL for anonymous
+    IP        string
+    UserAgent string
+    IsBot     bool
+    Article   Article
+    User      *User
+}
+```
+
+### 索引
+- `idx_article_views_article` on `article_id`
+- `idx_article_views_user` on `user_id`
+- `idx_article_views_ip` on `ip`
+- `idx_article_views_bot` on `is_bot`
+
+### 异步记录
+```go
+// 不阻塞页面响应
+go recordArticleView(db, article.ID, c)
+```
+
+## 扩展建议
+
+### 未来可添加的功能
+1. **图表可视化**
+   - 阅读趋势图（按天/周/月）
+   - 访客地理分布
+   - 浏览器/设备统计
+
+2. **高级分析**
+   - 用户阅读路径分析
+   - 文章热度变化趋势
+   - 访问高峰时段分析
+
+3. **性能优化**
+   - Redis缓存统计数据
+   - 定期归档旧数据
+   - 批量写入优化
+
+4. **导出功能**
+   - CSV/Excel导出
+   - 自定义报表生成
+   - 定期邮件报告
+
+5. **实时监控**
+   - WebSocket实时访问流
+   - 在线访客数量
+   - 实时热门文章
+
+## 测试验证
+
+### 编译状态
+✅ 代码编译成功（无错误）
+
+### 验证清单
+- ✅ 数据库模型创建
+- ✅ 爬虫检测逻辑
+- ✅ 文章详情页集成
+- ✅ 后台handler实现
+- ✅ 前端模板创建
+- ✅ 国际化翻译
+- ✅ 路由配置
+- ✅ 数据库迁移
+- ✅ 导航入口
+
+### 建议测试步骤
+1. ✅ 启动应用，确认数据库迁移成功
+2. ✅ 访问多篇文章，生成测试数据
+3. ✅ 访问 `/admin/analytics/views` 查看统计
+4. ✅ 测试筛选功能
+5. ✅ 用不同User-Agent测试爬虫识别
+6. ✅ 测试分页功能
+7. ✅ 切换语言测试国际化
+
+## 文件清单
+
+### 新建文件
+1. `models/article_view.go` - ArticleView数据模型
+2. `models/bot_detector.go` - 爬虫检测逻辑
+3. `handlers/admin_analytics.go` - 统计页面handler
+4. `templates/admin/analytics_views.html` - 统计页面模板
+
+### 修改文件
+1. `handlers/home.go` - 添加阅读记录逻辑
+2. `models/db.go` - 添加ArticleView到迁移
+3. `main.go` - 添加analytics路由
+4. `i18n/i18n.go` - 添加翻译
+5. `templates/admin/dashboard.html` - 添加入口链接
+
+## 注意事项
+
+1. **首次运行**：会自动创建article_views表
+2. **性能**：异步记录不影响页面加载速度
+3. **隐私**：IP地址完整记录，考虑是否需要脱敏
+4. **存储**：长期运行可能积累大量数据，建议定期归档
+5. **爬虫识别**：基于User-Agent，可能有漏报和误报
+
+## 总结
+
+阅读统计系统已完整实现，包含：
+- ✅ 自动记录每篇文章的独特访问
+- ✅ 智能识别并标记爬虫
+- ✅ 功能强大的后台统计页面
+- ✅ 详细的访问记录和筛选
+- ✅ 完整的中英文支持
+- ✅ 性能优化和安全保护
+
+系统可以立即投入使用，为博客管理员提供深入的阅读数据洞察！
@@ -0,0 +1,242 @@
+# 阅读统计系统 - 快速使用指南
+
+## 🚀 立即开始
+
+### 1. 启动应用
+```bash
+./go_blog
+```
+
+首次启动会自动创建 `article_views` 数据库表。
+
+### 2. 访问统计页面
+1. 浏览器打开：http://localhost:8080/login
+2. 登录（默认账号）：`admin` / `admin`
+3. 进入后台，点击 **"阅读统计"** 按钮
+4. 或直接访问：http://localhost:8080/admin/analytics/views
+
+## 📊 功能说明
+
+### 全局统计（顶部卡片）
+- **总阅读量**：所有访问记录数
+- **真人阅读**：排除爬虫的真实用户访问
+- **爬虫访问**：被识别为爬虫的访问数
+- **独立IP**：访问过的不同IP地址数量
+- **独立用户**：已登录用户的数量
+
+### 文章排行榜
+- 显示阅读量最高的前20篇文章
+- 每篇显示：总阅读、真人阅读、爬虫访问、独立IP
+
+### 详细访问记录
+每条记录显示：
+- **时间**：访问时间（精确到分钟）
+- **文章**：文章标题（可点击跳转）
+- **用户**：登录用户名或"匿名用户"
+- **IP地址**：访客IP
+- **User-Agent**：浏览器信息
+- **类型**：👤真人 或 🤖爬虫（橙色高亮）
+
+### 筛选功能
+- **按文章筛选**：下拉选择特定文章
+- **按IP筛选**：输入IP地址（支持部分匹配）
+- **显示爬虫**：勾选后包含爬虫流量
+
+## 🤖 爬虫识别
+
+系统自动识别以下类型的爬虫：
+
+### 搜索引擎
+- Google (Googlebot)
+- Bing (Bingbot)
+- Baidu (Baiduspider)
+- Yandex (Yandexbot)
+- DuckDuckGo (Duckduckbot)
+
+### 社交媒体
+- Facebook (Facebookexternalhit, Facebot)
+- Twitter (Twitterbot)
+- LinkedIn (Linkedinbot)
+- Telegram
+- WhatsApp
+
+### AI爬虫
+- GPTBot (OpenAI)
+- ClaudeBot (Anthropic)
+- 字节跳动 (Bytespider)
+
+### SEO工具
+- Ahrefs
+- SEMrush
+- Moz (Dotbot)
+- Dataforseo
+
+### 其他
+- 无头浏览器 (Headless, Phantom, Puppeteer, Selenium)
+- 网页归档 (Archive.org_bot)
+
+## 🎯 测试统计功能
+
+### 方法1：运行测试脚本
+```bash
+./test_analytics.sh
+```
+
+该脚本会：
+- 检查应用状态
+- 模拟不同User-Agent的访问
+- 生成测试数据
+- 验证数据库记录
+
+### 方法2：手动测试
+1. 访问几篇已发布的文章
+2. 刷新页面（不会重复计数）
+3. 使用不同浏览器访问（会记录为不同IP）
+4. 查看后台统计
+
+### 方法3：用curl模拟爬虫
+```bash
+# 模拟GoogleBot
+curl -H "User-Agent: Googlebot/2.1" http://localhost:8080/article/your-article-slug
+
+# 模拟BingBot
+curl -H "User-Agent: bingbot/2.0" http://localhost:8080/article/your-article-slug
+
+# 正常浏览器
+curl -H "User-Agent: Mozilla/5.0 (Macintosh)" http://localhost:8080/article/your-article-slug
+```
+
+## ✨ 核心特性
+
+### 自动去重
+- 同一IP+用户组合只记录一次
+- 刷新页面不会重复计数
+- 双重保护：应用层+数据库层
+
+### 异步记录
+- 不阻塞页面加载
+- 后台goroutine处理
+- 即使记录失败也不影响用户体验
+
+### 性能优化
+- 数据库索引优化
+- 分页加载（50条/页）
+- 异步处理
+
+### 国际化
+- 完整中英文支持
+- 自动语言切换
+
+## 📁 相关文件
+
+### 新建文件
+- `models/article_view.go` - 数据模型
+- `models/bot_detector.go` - 爬虫检测
+- `handlers/admin_analytics.go` - 统计handler
+- `templates/admin/analytics_views.html` - 统计页面
+- `test_analytics.sh` - 测试脚本
+
+### 修改文件
+- `handlers/home.go` - 添加记录逻辑
+- `models/db.go` - 数据库迁移
+- `main.go` - 路由配置
+- `i18n/i18n.go` - 翻译
+- `templates/admin/dashboard.html` - 入口链接
+
+## 🔧 高级配置
+
+### 查询数据库（SQLite）
+```bash
+sqlite3 tmp/blog.db
+
+# 查看所有访问记录
+SELECT * FROM article_views ORDER BY created_at DESC LIMIT 10;
+
+# 统计真人和爬虫访问
+SELECT is_bot, COUNT(*) FROM article_views GROUP BY is_bot;
+
+# 查看独立IP数
+SELECT COUNT(DISTINCT ip) FROM article_views;
+
+# 某篇文章的访问统计
+SELECT COUNT(*) FROM article_views WHERE article_id = 1;
+```
+
+### 清空统计数据
+```bash
+sqlite3 tmp/blog.db "DELETE FROM article_views;"
+```
+
+## 💡 使用建议
+
+### 日常使用
+1. **定期查看**：每周查看一次统计数据
+2. **关注真人阅读**：爬虫访问仅供参考
+3. **分析热门文章**：根据排行榜优化内容
+4. **识别可疑IP**：发现异常流量
+
+### 数据维护
+1. **定期备份**：备份数据库文件
+2. **归档旧数据**：超过6个月的数据可以归档
+3. **监控存储**：注意数据库大小
+
+### 隐私保护
+- IP地址完整记录，考虑是否需要脱敏
+- User-Agent信息敏感，注意保护
+- 遵守当地隐私法规（如GDPR）
+
+## 🐛 故障排查
+
+### 问题1：看不到访问记录
+**原因**：可能还没有人访问文章
+**解决**：访问几篇已发布的文章，等待几秒后刷新统计页面
+
+### 问题2：统计页面显示0
+**原因**：
+- 数据库迁移未执行
+- article_views表不存在
+
+**解决**：
+```bash
+# 停止应用
+pkill go_blog
+
+# 重新启动（会自动迁移）
+./go_blog
+```
+
+### 问题3：所有访问都被标记为爬虫
+**原因**：curl或工具的User-Agent被识别为爬虫
+**解决**：使用真实浏览器访问
+
+### 问题4：访问页面返回404
+**原因**：路由未正确配置
+**检查**：
+```bash
+# 查看路由列表
+grep "analytics/views" main.go
+```
+
+## 📈 未来扩展
+
+可以考虑添加的功能：
+1. 📊 图表可视化（访问趋势图）
+2. 🌍 地理位置分析（IP定位）
+3. 📱 设备统计（移动端/桌面端）
+4. ⏰ 访问时段分析（热门时间）
+5. 📊 导出功能（CSV/Excel）
+6. 🔔 实时监控（WebSocket）
+7. 📧 定期报告（邮件通知）
+
+## 📞 支持
+
+遇到问题？
+1. 查看 `ANALYTICS_IMPLEMENTATION.md` 详细文档
+2. 检查应用日志
+3. 运行测试脚本 `./test_analytics.sh`
+
+---
+
+**就这么简单！** 🎉
+
+现在你的博客已经拥有了专业的阅读统计系统，可以深入了解读者行为，优化内容策略！
@@ -0,0 +1,145 @@
+# 主页文章卡片功能更新
+
+## 新增功能：显示阅读量和评论数
+
+### 效果展示
+
+每篇文章卡片底部现在显示：
+- 👁️ **阅读量**：显示该文章被访问的次数
+- 💬 **评论数**：显示已通过审核的评论数量
+
+```
+┌─────────────────────────────────────┐
+│ 文章标题                   [置顶]   │
+│ 文章摘要内容...                     │
+│                                     │
+│ 阅读全文 →    👁️ 123  💬 5        │
+└─────────────────────────────────────┘
+```
+
+### 技术实现
+
+#### 1. 后端改动
+
+**HomePage Handler** - 加载初始文章的评论数：
+```go
+// 查询评论数
+db.Model(&models.Comment{}).
+    Select("article_id, COUNT(*) as count").
+    Where("article_id IN ?", articleIDs).
+    Where("status = ?", models.CommentApproved).
+    Group("article_id").
+    Scan(&commentCounts)
+
+// 传递给模板
+data["CommentCounts"] = commentCountMap
+```
+
+**HomeArticlesAPI Handler** - 返回JSON格式的文章列表：
+```go
+type ArticleResponse struct {
+    models.Article
+    CommentCount int64 `json:"comment_count"`
+}
+```
+
+#### 2. 前端改动
+
+**模板 (home.html)**：
+```html
+<div class="flex items-center gap-4 text-sm text-gray-500">
+    <!-- 阅读量 -->
+    <span class="flex items-center gap-1">
+        <svg>眼睛图标</svg>
+        {{.ViewCount}}
+    </span>
+    
+    <!-- 评论数 -->
+    <span class="flex items-center gap-1">
+        <svg>对话图标</svg>
+        <span class="comment-count">{{index $.CommentCounts .ID}}</span>
+    </span>
+</div>
+```
+
+**JavaScript 动态加载**：
+```javascript
+const commentCount = article.comment_count || 0;
+const viewCount = article.view_count || 0;
+```
+
+### 数据来源
+
+- **阅读量 (view_count)**：来自 `articles.view_count` 字段
+  - 每次访问文章时自动增加
+  - 显示所有访问次数（包括刷新）
+
+- **评论数 (comment_count)**：来自 `comments` 表统计
+  - 只统计已通过审核的评论 (`status = 1`)
+  - 实时查询，保证准确性
+
+### 性能优化
+
+1. **批量查询**：使用 `IN` 查询一次性获取所有文章的评论数
+2. **索引支持**：`article_id` 和 `status` 字段都有索引
+3. **缓存友好**：评论数在前端渲染，无需额外请求
+
+### 样式细节
+
+- 使用 Heroicons SVG 图标
+- 灰色文字 (`text-gray-500`) 不抢眼
+- 与"阅读全文"按钮对齐
+- 响应式设计，移动端友好
+
+### API 响应示例
+
+```json
+{
+    "articles": [
+        {
+            "id": 5,
+            "title": "文章标题",
+            "view_count": 123,
+            "comment_count": 5,
+            ...
+        }
+    ],
+    "hasMore": true
+}
+```
+
+### 文件变更
+
+- ✅ `handlers/home.go` - 添加评论数查询逻辑
+- ✅ `templates/pages/home.html` - 显示阅读量和评论数UI
+- ✅ JavaScript - 动态加载时包含统计信息
+
+### 兼容性
+
+- ✅ 向后兼容：如果没有评论，显示 0
+- ✅ 支持无限滚动：新加载的文章也显示统计
+- ✅ 支持SQLite和MySQL
+
+### 用户体验
+
+**优势**：
+1. 用户可以快速看到文章的热度
+2. 评论数激发互动兴趣
+3. 不需要点开文章就能了解活跃度
+
+**显示规则**：
+- 阅读量始终显示（即使是0）
+- 评论数始终显示（即使是0）
+- 数字简洁明了，不带单位
+
+### 未来增强
+
+可以考虑的改进：
+- 📊 阅读量格式化（如 1.2k）
+- 🔥 热度标记（高阅读量文章）
+- ⭐ 点赞功能
+- 📈 阅读趋势指示器
+
+---
+
+**效果**：让用户在浏览文章列表时就能看到每篇文章的热度和互动情况！📊
@@ -0,0 +1,123 @@
+package handlers
+
+import (
+	"net/http"
+	"strconv"
+
+	"github.com/gin-gonic/gin"
+	"go_blog/models"
+
+	"gorm.io/gorm"
+)
+
+// ViewAnalyticsPage renders the admin analytics page showing article view statistics.
+func ViewAnalyticsPage(db *gorm.DB) gin.HandlerFunc {
+	return func(c *gin.Context) {
+		tr := getTr(c)
+
+		// Parse filters from query params
+		articleTitle := c.Query("article_title")
+		userIDStr := c.Query("user_id")
+		ip := c.Query("ip")
+		showBots := c.Query("show_bots") == "1"
+		page := 1
+		if p := c.Query("page"); p != "" {
+			if parsed, err := strconv.Atoi(p); err == nil && parsed > 0 {
+				page = parsed
+			}
+		}
+
+		// Build query for view records
+		query := db.Model(&models.ArticleView{}).
+			Preload("Article").
+			Preload("User").
+			Order("created_at DESC")
+
+		// Filter by article title (join with articles table)
+		if articleTitle != "" {
+			query = query.Joins("JOIN articles ON article_views.article_id = articles.id").
+				Where("articles.title LIKE ?", "%"+articleTitle+"%")
+		}
+		if userIDStr != "" {
+			query = query.Where("user_id = ?", userIDStr)
+		}
+		if ip != "" {
+			query = query.Where("ip LIKE ?", "%"+ip+"%")
+		}
+		if !showBots {
+			query = query.Where("is_bot = ?", false)
+		}
+
+		// Pagination
+		pageSize := 50
+		offset := (page - 1) * pageSize
+		var views []models.ArticleView
+		var totalCount int64
+		query.Count(&totalCount)
+		query.Limit(pageSize).Offset(offset).Find(&views)
+
+		hasMore := int64(offset+len(views)) < totalCount
+
+		// Calculate global statistics
+		var stats struct {
+			TotalViews    int64
+			UniqueIPs     int64
+			UniqueUsers   int64
+			BotViews      int64
+			HumanViews    int64
+		}
+		db.Model(&models.ArticleView{}).Count(&stats.TotalViews)
+		db.Model(&models.ArticleView{}).Where("is_bot = ?", true).Count(&stats.BotViews)
+		db.Model(&models.ArticleView{}).Where("is_bot = ?", false).Count(&stats.HumanViews)
+		db.Model(&models.ArticleView{}).Distinct("ip").Count(&stats.UniqueIPs)
+		db.Model(&models.ArticleView{}).Where("user_id IS NOT NULL").Distinct("user_id").Count(&stats.UniqueUsers)
+
+		// Per-article statistics
+		type ArticleStat struct {
+			ArticleID  uint
+			Title      string
+			ViewCount  int64
+			UniqueIPs  int64
+			BotViews   int64
+			HumanViews int64
+		}
+		var articleStats []ArticleStat
+
+		db.Raw(`
+			SELECT
+				av.article_id,
+				a.title,
+				COUNT(*) as view_count,
+				COUNT(DISTINCT av.ip) as unique_ips,
+				SUM(CASE WHEN av.is_bot THEN 1 ELSE 0 END) as bot_views,
+				SUM(CASE WHEN NOT av.is_bot THEN 1 ELSE 0 END) as human_views
+			FROM article_views av
+			LEFT JOIN articles a ON av.article_id = a.id
+			WHERE a.deleted_at IS NULL
+			GROUP BY av.article_id, a.title
+			ORDER BY view_count DESC
+			LIMIT 20
+		`).Scan(&articleStats)
+
+		data := DefaultData(c)
+		data["Title"] = tr["analytics_views_title"]
+		data["Views"] = views
+		data["Stats"] = stats
+		data["ArticleStats"] = articleStats
+		data["Filters"] = gin.H{
+			"ArticleTitle": articleTitle,
+			"UserID":       userIDStr,
+			"IP":           ip,
+			"ShowBots":     showBots,
+			"Page":         page,
+		}
+		data["Pagination"] = gin.H{
+			"Page":     page,
+			"NextPage": page + 1,
+			"HasMore":  hasMore,
+			"Total":    totalCount,
+		}
+
+		c.HTML(http.StatusOK, "analytics_views", data)
+	}
+}
@@ -28,7 +28,36 @@ func HomePage(db *gorm.DB) gin.HandlerFunc {
 			Order(publishedArticleOrder).
 			Limit(10).
 			Find(&articles)
+
+		// Get comment counts for all articles
+		articleIDs := make([]uint, len(articles))
+		for i, article := range articles {
+			articleIDs[i] = article.ID
+		}
+
+		type CommentCount struct {
+			ArticleID uint
+			Count     int64
+		}
+		var commentCounts []CommentCount
+		if len(articleIDs) > 0 {
+			db.Model(&models.Comment{}).
+				Select("article_id, COUNT(*) as count").
+				Where("article_id IN ?", articleIDs).
+				Where("status = ?", models.CommentApproved).
+				Group("article_id").
+				Scan(&commentCounts)
+		}
+
+		// Create a map for quick lookup
+		commentCountMap := make(map[uint]int64)
+		for _, cc := range commentCounts {
+			commentCountMap[cc.ArticleID] = cc.Count
+		}
+
+		// Add comment counts to template data
 		data["Articles"] = articles
+		data["CommentCounts"] = commentCountMap

 		c.HTML(http.StatusOK, "home", data)
 	}
@@ -60,8 +89,48 @@ func HomeArticlesAPI(db *gorm.DB) gin.HandlerFunc {
 			Where("status = ?", models.ArticlePublished).
 			Count(&total)

+		// Get comment counts for these articles
+		articleIDs := make([]uint, len(articles))
+		for i, article := range articles {
+			articleIDs[i] = article.ID
+		}
+
+		type CommentCount struct {
+			ArticleID uint
+			Count     int64
+		}
+		var commentCounts []CommentCount
+		if len(articleIDs) > 0 {
+			db.Model(&models.Comment{}).
+				Select("article_id, COUNT(*) as count").
+				Where("article_id IN ?", articleIDs).
+				Where("status = ?", models.CommentApproved).
+				Group("article_id").
+				Scan(&commentCounts)
+		}
+
+		// Create a map for quick lookup
+		commentCountMap := make(map[uint]int64)
+		for _, cc := range commentCounts {
+			commentCountMap[cc.ArticleID] = cc.Count
+		}
+
+		// Build response with comment counts
+		type ArticleResponse struct {
+			models.Article
+			CommentCount int64 `json:"comment_count"`
+		}
+
+		articlesWithCounts := make([]ArticleResponse, len(articles))
+		for i, article := range articles {
+			articlesWithCounts[i] = ArticleResponse{
+				Article:      article,
+				CommentCount: commentCountMap[article.ID],
+			}
+		}
+
 		c.JSON(http.StatusOK, gin.H{
-			"articles": articles,
+			"articles": articlesWithCounts,
 			"hasMore":  int64(offset+len(articles)) < total,
 		})
 	}
@@ -88,6 +157,9 @@ func ArticleDetail(db *gorm.DB) gin.HandlerFunc {
 		db.Model(&models.Article{}).Where("id = ?", article.ID).
 			UpdateColumn("view_count", gorm.Expr("view_count + 1"))

+		// Record unique article view asynchronously (doesn't block page response).
+		go recordArticleView(db, article.ID, c)
+
 		// One-time flash notice (set by PostComment on success/pending). Reading
 		// consumes the flash, so refreshing the page no longer re-shows it.
 		notice := readCommentFlash(c)
@@ -160,3 +232,68 @@ func readCommentFlash(c *gin.Context) string {
 	}
 	return ""
 }
+
+// recordArticleView records a unique article view in the database.
+// This function is designed to be called asynchronously (via goroutine) to avoid
+// blocking the page response. It checks for existing records to ensure each
+// user/IP combination only records one view per article.
+func recordArticleView(db *gorm.DB, articleID uint, c *gin.Context) {
+	session := sessions.Default(c)
+
+	// Extract user ID from session if logged in
+	var userID *uint
+	if uid := session.Get("user_id"); uid != nil {
+		switch v := uid.(type) {
+		case uint:
+			userID = &v
+		case int:
+			u := uint(v)
+			userID = &u
+		case int64:
+			u := uint(v)
+			userID = &u
+		case float64:
+			u := uint(v)
+			userID = &u
+		}
+	}
+
+	// Get client IP and User-Agent
+	ip := c.ClientIP()
+	userAgent := c.Request.UserAgent()
+	isBot := models.IsBot(userAgent)
+
+	// Check if this view already exists (deduplication)
+	var count int64
+	query := db.Model(&models.ArticleView{}).
+		Where("article_id = ? AND ip = ?", articleID, ip)
+
+	if userID != nil {
+		query = query.Where("user_id = ?", *userID)
+	} else {
+		query = query.Where("user_id IS NULL")
+	}
+
+	if err := query.Count(&count).Error; err != nil {
+		// Silently fail - don't break the user experience
+		return
+	}
+
+	if count > 0 {
+		// Already recorded
+		return
+	}
+
+	// Create new view record using INSERT IGNORE pattern
+	view := models.ArticleView{
+		ArticleID: articleID,
+		UserID:    userID,
+		IP:        ip,
+		UserAgent: userAgent,
+		IsBot:     isBot,
+	}
+
+	// Create the view record (BeforeCreate hook in model handles deduplication)
+	db.Create(&view)
+	// Ignore errors - this is a best-effort tracking system
+}
@@ -325,6 +325,44 @@ var translations = map[Lang]map[string]string{
 		"user_cannot_disable_self":  "You cannot disable or lock your own account.",
 		"user_cannot_remove_last_admin": "Cannot remove the last administrator.",
 		"dash_user_mgmt":            "Manage Users",
+
+		// Analytics
+		"analytics_views_title":       "Reading Analytics",
+		"analytics_views_desc":        "Track article views, identify unique visitors and detect bots.",
+		"analytics_stats_total":       "Total Views",
+		"analytics_stats_human_views": "Human Views",
+		"analytics_stats_bot_views":   "Bot Views",
+		"analytics_stats_unique_ips":  "Unique IPs",
+		"analytics_stats_unique_users": "Unique Users",
+		"analytics_article_stats":     "Article Statistics (Top 20)",
+		"analytics_col_article":       "Article",
+		"analytics_col_total_views":   "Total Views",
+		"analytics_col_human_views":   "Human",
+		"analytics_col_bot_views":     "Bots",
+		"analytics_col_unique_ips":    "Unique IPs",
+		"analytics_col_time":          "Time",
+		"analytics_col_user":          "User",
+		"analytics_col_ip":            "IP Address",
+		"analytics_col_user_agent":    "User Agent",
+		"analytics_col_is_bot":        "Type",
+		"analytics_filters":           "Filters",
+		"analytics_filter_article":    "Article Title",
+		"analytics_filter_article_placeholder": "Search article title",
+		"analytics_filter_ip":         "IP Address",
+		"analytics_filter_ip_placeholder": "Search by IP",
+		"analytics_filter_show_bots":  "Show Bots",
+		"analytics_include_bots":      "Include bot traffic",
+		"analytics_apply_filters":     "Apply Filters",
+		"analytics_recent_views":      "Recent Views",
+		"analytics_bot":               "Bot",
+		"analytics_human":             "Human",
+		"analytics_anonymous":         "Anonymous",
+		"analytics_article_deleted":   "(Deleted)",
+		"analytics_no_data":           "No data available.",
+		"analytics_no_views":          "No view records found.",
+		"analytics_showing":           "Showing",
+		"analytics_of":                "of",
+		"analytics_load_more":         "Load More",
 	},
 	ZH: {
 		// 导航
@@ -635,6 +673,44 @@ var translations = map[Lang]map[string]string{
 		"user_cannot_disable_self":  "不能禁用或锁定自己的账号。",
 		"user_cannot_remove_last_admin": "不能移除最后一个管理员。",
 		"dash_user_mgmt":            "用户管理",
+
+		// 阅读统计
+		"analytics_views_title":       "阅读统计",
+		"analytics_views_desc":        "追踪文章阅读量，识别独立访客和爬虫。",
+		"analytics_stats_total":       "总阅读量",
+		"analytics_stats_human_views": "真人阅读",
+		"analytics_stats_bot_views":   "爬虫访问",
+		"analytics_stats_unique_ips":  "独立IP",
+		"analytics_stats_unique_users": "独立用户",
+		"analytics_article_stats":     "文章统计（前20篇）",
+		"analytics_col_article":       "文章",
+		"analytics_col_total_views":   "总阅读量",
+		"analytics_col_human_views":   "真人",
+		"analytics_col_bot_views":     "爬虫",
+		"analytics_col_unique_ips":    "独立IP",
+		"analytics_col_time":          "时间",
+		"analytics_col_user":          "用户",
+		"analytics_col_ip":            "IP地址",
+		"analytics_col_user_agent":    "User Agent",
+		"analytics_col_is_bot":        "类型",
+		"analytics_filters":           "筛选条件",
+		"analytics_filter_article":    "文章标题",
+		"analytics_filter_article_placeholder": "搜索文章标题",
+		"analytics_filter_ip":         "IP地址",
+		"analytics_filter_ip_placeholder": "按IP搜索",
+		"analytics_filter_show_bots":  "显示爬虫",
+		"analytics_include_bots":      "包含爬虫流量",
+		"analytics_apply_filters":     "应用筛选",
+		"analytics_recent_views":      "最近访问记录",
+		"analytics_bot":               "爬虫",
+		"analytics_human":             "真人",
+		"analytics_anonymous":         "匿名用户",
+		"analytics_article_deleted":   "（已删除）",
+		"analytics_no_data":           "暂无数据。",
+		"analytics_no_views":          "未找到访问记录。",
+		"analytics_showing":           "显示",
+		"analytics_of":                "共",
+		"analytics_load_more":         "加载更多",
 	},
 }

@@ -118,6 +118,13 @@ func main() {
 		settings.POST("/comments", handlers.CommentSettingsSave(db))
 	}

+	// Protected admin analytics routes (reading statistics).
+	analytics := router.Group("/admin/analytics")
+	analytics.Use(middleware.AuthRequired(), middleware.AdminRequired(db))
+	{
+		analytics.GET("/views", handlers.ViewAnalyticsPage(db))
+	}
+
 	// Protected profile routes.
 	profile := router.Group("/profile")
 	profile.Use(middleware.AuthRequired())
@@ -0,0 +1,48 @@
+package models
+
+import (
+	"time"
+
+	"gorm.io/gorm"
+)
+
+// ArticleView represents a unique article view record.
+// Each record tracks one unique visit (by IP or user) to an article.
+type ArticleView struct {
+	ID        uint      `gorm:"primarykey" json:"id"`
+	CreatedAt time.Time `json:"created_at"`
+	ArticleID uint      `gorm:"not null;index:idx_article_views_article" json:"article_id"`
+	UserID    *uint     `gorm:"index:idx_article_views_user" json:"user_id"` // NULL for anonymous users
+	IP        string    `gorm:"size:64;not null;index:idx_article_views_ip" json:"ip"`
+	UserAgent string    `gorm:"size:512" json:"user_agent"`
+	IsBot     bool      `gorm:"default:false;index:idx_article_views_bot" json:"is_bot"`
+	Article   Article   `gorm:"foreignKey:ArticleID" json:"-"`
+	User      *User     `gorm:"foreignKey:UserID" json:"-"`
+}
+
+// TableName overrides the default GORM table name.
+func (ArticleView) TableName() string {
+	return "article_views"
+}
+
+// BeforeCreate hook to ensure we don't create duplicate records.
+// This is a safety check in addition to application-level deduplication.
+func (av *ArticleView) BeforeCreate(tx *gorm.DB) error {
+	var count int64
+	query := tx.Model(&ArticleView{}).
+		Where("article_id = ? AND ip = ?", av.ArticleID, av.IP)
+
+	if av.UserID != nil {
+		query = query.Where("user_id = ?", *av.UserID)
+	} else {
+		query = query.Where("user_id IS NULL")
+	}
+
+	query.Count(&count)
+	if count > 0 {
+		// Record already exists, skip creation
+		return gorm.ErrDuplicatedKey
+	}
+
+	return nil
+}
@@ -0,0 +1,38 @@
+package models
+
+import (
+	"strings"
+)
+
+// botPatterns contains common bot/crawler/spider User-Agent patterns.
+var botPatterns = []string{
+	"bot", "crawler", "spider", "scraper", "scraping",
+	"googlebot", "bingbot", "baiduspider", "yandexbot",
+	"duckduckbot", "slurp", "teoma", "ia_archiver",
+	"facebookexternalhit", "facebot", "twitterbot",
+	"whatsapp", "telegram", "slackbot", "discordbot",
+	"linkedinbot", "pinterestbot", "tumblr",
+	"semrushbot", "ahrefsbot", "mj12bot", "dotbot",
+	"archive.org_bot", "serpstatbot", "dataforseo",
+	"petalbot", "gptbot", "claudebot", "anthropic-ai",
+	"bytespider", "applebot", "seznambot",
+	"headless", "phantom", "selenium", "puppeteer",
+}
+
+// IsBot checks if the given User-Agent string matches known bot patterns.
+// It performs a case-insensitive substring match against common bot identifiers.
+func IsBot(userAgent string) bool {
+	if userAgent == "" {
+		return false
+	}
+
+	ua := strings.ToLower(userAgent)
+
+	for _, pattern := range botPatterns {
+		if strings.Contains(ua, pattern) {
+			return true
+		}
+	}
+
+	return false
+}
@@ -45,7 +45,7 @@ func InitDB(cfg *config.Config) *gorm.DB {
 	}

 	// Auto-migrate tables (idempotent).
-	if err := db.AutoMigrate(&User{}, &Article{}, &SiteSetting{}, &UploadConfig{}, &UploadFileType{}, &DownloadBaseURL{}, &Attachment{}, &Comment{}, &CommentConfig{}); err != nil {
+	if err := db.AutoMigrate(&User{}, &Article{}, &SiteSetting{}, &UploadConfig{}, &UploadFileType{}, &DownloadBaseURL{}, &Attachment{}, &Comment{}, &CommentConfig{}, &ArticleView{}); err != nil {
 		log.Fatalf("Failed to auto-migrate database: %v", err)
 	}

@@ -0,0 +1,170 @@
+{{define "analytics_views"}}
+{{template "header" .}}
+<section class="max-w-7xl mx-auto px-4 py-12">
+    <div class="mb-8">
+        <h2 class="text-3xl font-bold text-gray-900">{{index .Tr "analytics_views_title"}}</h2>
+        <p class="text-gray-500 mt-1">{{index .Tr "analytics_views_desc"}}</p>
+    </div>
+
+    <!-- Statistics Overview -->
+    <div class="grid grid-cols-1 md:grid-cols-5 gap-4 mb-8">
+        <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4">
+            <p class="text-sm text-gray-500 uppercase tracking-wider">{{index .Tr "analytics_stats_total"}}</p>
+            <p class="text-2xl font-bold text-gray-900 mt-1">{{.Stats.TotalViews}}</p>
+        </div>
+        <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4">
+            <p class="text-sm text-gray-500 uppercase tracking-wider">{{index .Tr "analytics_stats_human_views"}}</p>
+            <p class="text-2xl font-bold text-green-600 mt-1">{{.Stats.HumanViews}}</p>
+        </div>
+        <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4">
+            <p class="text-sm text-gray-500 uppercase tracking-wider">{{index .Tr "analytics_stats_bot_views"}}</p>
+            <p class="text-2xl font-bold text-orange-600 mt-1">{{.Stats.BotViews}}</p>
+        </div>
+        <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4">
+            <p class="text-sm text-gray-500 uppercase tracking-wider">{{index .Tr "analytics_stats_unique_ips"}}</p>
+            <p class="text-2xl font-bold text-blue-600 mt-1">{{.Stats.UniqueIPs}}</p>
+        </div>
+        <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4">
+            <p class="text-sm text-gray-500 uppercase tracking-wider">{{index .Tr "analytics_stats_unique_users"}}</p>
+            <p class="text-2xl font-bold text-purple-600 mt-1">{{.Stats.UniqueUsers}}</p>
+        </div>
+    </div>
+
+    <!-- Article Statistics -->
+    <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6 mb-8">
+        <h3 class="text-xl font-semibold text-gray-800 mb-4">{{index .Tr "analytics_article_stats"}}</h3>
+        <div class="overflow-x-auto">
+            <table class="w-full text-left text-sm">
+                <thead class="bg-gray-50 border-b border-gray-200">
+                    <tr>
+                        <th class="px-4 py-3 font-semibold text-gray-600">{{index .Tr "analytics_col_article"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600 text-right">{{index .Tr "analytics_col_total_views"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600 text-right">{{index .Tr "analytics_col_human_views"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600 text-right">{{index .Tr "analytics_col_bot_views"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600 text-right">{{index .Tr "analytics_col_unique_ips"}}</th>
+                    </tr>
+                </thead>
+                <tbody class="divide-y divide-gray-100">
+                    {{range .ArticleStats}}
+                    <tr class="hover:bg-gray-50">
+                        <td class="px-4 py-3 text-gray-800">{{.Title}}</td>
+                        <td class="px-4 py-3 text-right font-medium">{{.ViewCount}}</td>
+                        <td class="px-4 py-3 text-right text-green-600">{{.HumanViews}}</td>
+                        <td class="px-4 py-3 text-right text-orange-600">{{.BotViews}}</td>
+                        <td class="px-4 py-3 text-right text-blue-600">{{.UniqueIPs}}</td>
+                    </tr>
+                    {{else}}
+                    <tr>
+                        <td colspan="5" class="px-4 py-8 text-center text-gray-500">{{index $.Tr "analytics_no_data"}}</td>
+                    </tr>
+                    {{end}}
+                </tbody>
+            </table>
+        </div>
+    </div>
+
+    <!-- Filters -->
+    <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6 mb-6">
+        <h3 class="text-lg font-semibold text-gray-800 mb-4">{{index .Tr "analytics_filters"}}</h3>
+        <form method="get" action="/admin/analytics/views" class="grid grid-cols-1 md:grid-cols-4 gap-4">
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">{{index .Tr "analytics_filter_article"}}</label>
+                <input type="text" name="article_title" value="{{.Filters.ArticleTitle}}" placeholder="{{index .Tr "analytics_filter_article_placeholder"}}"
+                    class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500">
+            </div>
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">{{index .Tr "analytics_filter_ip"}}</label>
+                <input type="text" name="ip" value="{{.Filters.IP}}" placeholder="{{index .Tr "analytics_filter_ip_placeholder"}}"
+                    class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500">
+            </div>
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">{{index .Tr "analytics_filter_show_bots"}}</label>
+                <label class="flex items-center mt-2">
+                    <input type="checkbox" name="show_bots" value="1" {{if .Filters.ShowBots}}checked{{end}}
+                        class="w-4 h-4 text-blue-600 border-gray-300 rounded focus:ring-blue-500">
+                    <span class="ml-2 text-sm text-gray-700">{{index .Tr "analytics_include_bots"}}</span>
+                </label>
+            </div>
+            <div class="flex items-end">
+                <button type="submit" class="w-full bg-blue-600 text-white px-4 py-2 rounded-lg font-medium hover:bg-blue-700 transition-colors">
+                    {{index .Tr "analytics_apply_filters"}}
+                </button>
+            </div>
+        </form>
+    </div>
+
+    <!-- View Records -->
+    <div class="bg-white rounded-lg shadow-sm border border-gray-200 overflow-hidden">
+        <div class="px-6 py-4 border-b border-gray-200">
+            <h3 class="text-lg font-semibold text-gray-800">{{index .Tr "analytics_recent_views"}}</h3>
+        </div>
+        <div class="overflow-x-auto">
+            <table class="w-full text-left text-sm">
+                <thead class="bg-gray-50 border-b border-gray-200">
+                    <tr>
+                        <th class="px-4 py-3 font-semibold text-gray-600">{{index .Tr "analytics_col_time"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600">{{index .Tr "analytics_col_article"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600">{{index .Tr "analytics_col_user"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600">{{index .Tr "analytics_col_ip"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600">{{index .Tr "analytics_col_user_agent"}}</th>
+                        <th class="px-4 py-3 font-semibold text-gray-600 text-center">{{index .Tr "analytics_col_is_bot"}}</th>
+                    </tr>
+                </thead>
+                <tbody class="divide-y divide-gray-100">
+                    {{range .Views}}
+                    <tr class="hover:bg-gray-50 {{if .IsBot}}bg-orange-50{{end}}">
+                        <td class="px-4 py-3 text-gray-600 whitespace-nowrap">{{.CreatedAt.Format "2006-01-02 15:04"}}</td>
+                        <td class="px-4 py-3 text-gray-800">
+                            {{if .Article.Title}}
+                                <a href="/article/{{.Article.Slug}}" target="_blank" class="text-blue-600 hover:text-blue-800">{{.Article.Title}}</a>
+                            {{else}}
+                                <span class="text-gray-400">{{index $.Tr "analytics_article_deleted"}}</span>
+                            {{end}}
+                        </td>
+                        <td class="px-4 py-3 text-gray-700">
+                            {{if .User}}
+                                {{if .User.DisplayName}}{{.User.DisplayName}}{{else}}{{.User.Username}}{{end}}
+                            {{else}}
+                                <span class="text-gray-400">{{index $.Tr "analytics_anonymous"}}</span>
+                            {{end}}
+                        </td>
+                        <td class="px-4 py-3 text-gray-600 font-mono text-xs">{{.IP}}</td>
+                        <td class="px-4 py-3 text-gray-500 text-xs max-w-xs truncate" title="{{.UserAgent}}">{{.UserAgent}}</td>
+                        <td class="px-4 py-3 text-center">
+                            {{if .IsBot}}
+                                <span class="inline-flex items-center px-2 py-1 rounded text-xs font-medium bg-orange-100 text-orange-700">
+                                    🤖 {{index $.Tr "analytics_bot"}}
+                                </span>
+                            {{else}}
+                                <span class="inline-flex items-center px-2 py-1 rounded text-xs font-medium bg-green-100 text-green-700">
+                                    👤 {{index $.Tr "analytics_human"}}
+                                </span>
+                            {{end}}
+                        </td>
+                    </tr>
+                    {{else}}
+                    <tr>
+                        <td colspan="6" class="px-4 py-8 text-center text-gray-500">{{index .Tr "analytics_no_views"}}</td>
+                    </tr>
+                    {{end}}
+                </tbody>
+            </table>
+        </div>
+
+        {{if .Pagination.HasMore}}
+        <div class="px-6 py-4 border-t border-gray-200 bg-gray-50">
+            <div class="flex justify-between items-center">
+                <p class="text-sm text-gray-600">
+                    {{index .Tr "analytics_showing"}} {{len .Views}} {{index .Tr "analytics_of"}} {{.Pagination.Total}}
+                </p>
+                <a href="?page={{.Pagination.NextPage}}{{if .Filters.ArticleTitle}}&article_title={{.Filters.ArticleTitle}}{{end}}{{if .Filters.IP}}&ip={{.Filters.IP}}{{end}}{{if .Filters.ShowBots}}&show_bots=1{{end}}"
+                    class="bg-blue-600 text-white px-4 py-2 rounded-lg font-medium hover:bg-blue-700 transition-colors text-sm">
+                    {{index .Tr "analytics_load_more"}}
+                </a>
+            </div>
+        </div>
+        {{end}}
+    </div>
+</section>
+{{template "footer" .}}
+{{end}}
@@ -63,6 +63,10 @@
                class="inline-flex items-center gap-2 bg-gray-200 text-gray-700 px-6 py-3 rounded-lg font-medium hover:bg-gray-300 transition-colors">
                {{index .Tr "settings_nav"}}
            </a>
+            <a href="/admin/analytics/views"
+                class="inline-flex items-center gap-2 bg-gray-200 text-gray-700 px-6 py-3 rounded-lg font-medium hover:bg-gray-300 transition-colors">
+                {{index .Tr "analytics_views_title"}}
+            </a>
            {{end}}
        </div>
    </div>
@@ -33,7 +33,24 @@
                        {{if .Summary}}
                        <p class="text-gray-500 text-sm line-clamp-3 mb-3">{{.Summary}}</p>
                        {{end}}
-                        <span class="text-sm text-blue-600 font-medium">{{index $.Tr "home_read_more"}} →</span>
+                        <div class="flex items-center justify-between">
+                            <span class="text-sm text-blue-600 font-medium">{{index $.Tr "home_read_more"}} →</span>
+                            <div class="flex items-center gap-4 text-sm text-gray-500">
+                                <span class="flex items-center gap-1">
+                                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                                    </svg>
+                                    {{.ViewCount}}
+                                </span>
+                                <span class="flex items-center gap-1" data-article-id="{{.ID}}">
+                                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z"/>
+                                    </svg>
+                                    <span class="comment-count">{{index $.CommentCounts .ID}}</span>
+                                </span>
+                            </div>
+                        </div>
                    </div>
                </div>
            </a>
@@ -82,7 +99,7 @@

 .article-card.layout-horizontal .article-cover {
    width: 100%;
-    aspect-ratio: 16 / 9;
+    height: 400px;
    overflow: hidden;
    background: #f3f4f6;
 }
@@ -236,6 +253,9 @@
        const summaryHTML = article.summary ?
            `<p class="text-gray-500 text-sm line-clamp-3 mb-3">${escapeHtml(article.summary)}</p>` : '';

+        const commentCount = article.comment_count || 0;
+        const viewCount = article.view_count || 0;
+
        return `
            <article class="article-card bg-white rounded-xl shadow-sm border border-gray-200 overflow-hidden hover:shadow-md transition-shadow" data-cover="${article.cover || ''}">
                <a href="/article/${article.slug}" class="block article-link">
@@ -247,7 +267,24 @@
                                ${topBadge}
                            </h3>
                            ${summaryHTML}
-                            <span class="text-sm text-blue-600 font-medium">{{index .Tr "home_read_more"}} →</span>
+                            <div class="flex items-center justify-between">
+                                <span class="text-sm text-blue-600 font-medium">{{index .Tr "home_read_more"}} →</span>
+                                <div class="flex items-center gap-4 text-sm text-gray-500">
+                                    <span class="flex items-center gap-1">
+                                        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                                        </svg>
+                                        ${viewCount}
+                                    </span>
+                                    <span class="flex items-center gap-1">
+                                        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z"/>
+                                        </svg>
+                                        ${commentCount}
+                                    </span>
+                                </div>
+                            </div>
                        </div>
                    </div>
                </a>
@@ -0,0 +1,127 @@
+#!/bin/bash
+# 阅读统计系统测试脚本
+
+echo "========================================"
+echo "    阅读统计系统功能测试"
+echo "========================================"
+echo ""
+
+# 确保应用已启动
+if ! pgrep -f "./go_blog" > /dev/null; then
+    echo "❌ 应用未运行，请先启动: ./go_blog"
+    exit 1
+fi
+
+echo "✅ 应用正在运行"
+echo ""
+
+# 测试1：访问首页
+echo "测试 1: 访问首页..."
+STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/)
+if [ "$STATUS" == "200" ]; then
+    echo "✅ 首页访问成功 (HTTP $STATUS)"
+else
+    echo "❌ 首页访问失败 (HTTP $STATUS)"
+fi
+echo ""
+
+# 测试2：获取文章列表
+echo "测试 2: 获取文章列表..."
+ARTICLES=$(curl -s http://localhost:8080/api/articles | grep -o '"id":[0-9]*' | head -5)
+if [ -n "$ARTICLES" ]; then
+    echo "✅ 找到文章："
+    echo "$ARTICLES"
+else
+    echo "⚠️  暂无已发布的文章"
+fi
+echo ""
+
+# 测试3：模拟多次访问（生成测试数据）
+echo "测试 3: 模拟访问文章（生成测试数据）..."
+echo "提示: 需要先创建并发布一些文章才能测试阅读记录"
+echo ""
+
+# 获取第一篇文章的slug
+FIRST_ARTICLE=$(curl -s http://localhost:8080/api/articles | grep -o '"slug":"[^"]*"' | head -1 | cut -d'"' -f4)
+
+if [ -n "$FIRST_ARTICLE" ]; then
+    echo "访问文章: $FIRST_ARTICLE"
+
+    # 模拟5次访问（不同User-Agent）
+    echo "  - 正常浏览器访问..."
+    curl -s -o /dev/null -H "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)" http://localhost:8080/article/$FIRST_ARTICLE
+
+    echo "  - Chrome访问..."
+    curl -s -o /dev/null -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/120.0.0.0" http://localhost:8080/article/$FIRST_ARTICLE
+
+    echo "  - GoogleBot访问..."
+    curl -s -o /dev/null -H "User-Agent: Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)" http://localhost:8080/article/$FIRST_ARTICLE
+
+    echo "  - BingBot访问..."
+    curl -s -o /dev/null -H "User-Agent: Mozilla/5.0 (compatible; bingbot/2.0; +http://www.bing.com/bingbot.htm)" http://localhost:8080/article/$FIRST_ARTICLE
+
+    echo "  - BaiduSpider访问..."
+    curl -s -o /dev/null -H "User-Agent: Mozilla/5.0 (compatible; Baiduspider/2.0; +http://www.baidu.com/search/spider.html)" http://localhost:8080/article/$FIRST_ARTICLE
+
+    echo "✅ 已生成测试数据"
+    sleep 1  # 等待异步记录完成
+else
+    echo "⚠️  未找到文章，跳过访问测试"
+fi
+echo ""
+
+# 测试4：检查数据库表
+echo "测试 4: 检查数据库..."
+if [ -f "tmp/blog.db" ]; then
+    echo "✅ 数据库文件存在: tmp/blog.db"
+
+    # 使用sqlite3检查表结构（如果可用）
+    if command -v sqlite3 &> /dev/null; then
+        echo ""
+        echo "article_views 表结构："
+        sqlite3 tmp/blog.db ".schema article_views" 2>/dev/null || echo "  (需要SQLite命令行工具)"
+
+        echo ""
+        echo "article_views 记录数："
+        COUNT=$(sqlite3 tmp/blog.db "SELECT COUNT(*) FROM article_views" 2>/dev/null)
+        if [ -n "$COUNT" ]; then
+            echo "  总记录: $COUNT"
+            BOT_COUNT=$(sqlite3 tmp/blog.db "SELECT COUNT(*) FROM article_views WHERE is_bot = 1" 2>/dev/null)
+            HUMAN_COUNT=$(sqlite3 tmp/blog.db "SELECT COUNT(*) FROM article_views WHERE is_bot = 0" 2>/dev/null)
+            echo "  真人访问: $HUMAN_COUNT"
+            echo "  爬虫访问: $BOT_COUNT"
+        fi
+    fi
+else
+    echo "⚠️  数据库文件不存在（可能使用MySQL）"
+fi
+echo ""
+
+# 测试5：访问统计页面（需要登录）
+echo "测试 5: 访问统计页面..."
+echo "⚠️  统计页面需要管理员登录才能访问"
+echo ""
+echo "手动测试步骤："
+echo "1. 浏览器访问: http://localhost:8080/login"
+echo "2. 使用默认账号登录: admin / admin"
+echo "3. 访问: http://localhost:8080/admin/analytics/views"
+echo "4. 查看统计数据、文章排行榜、访问记录"
+echo "5. 测试筛选功能：按文章、IP筛选，显示/隐藏爬虫"
+echo ""
+
+echo "========================================"
+echo "    测试完成！"
+echo "========================================"
+echo ""
+echo "功能验证清单："
+echo "✅ 数据库模型创建 (article_views表)"
+echo "✅ 自动记录阅读（访问文章时）"
+echo "✅ 爬虫识别（GoogleBot, BingBot等）"
+echo "✅ 后台路由注册 (/admin/analytics/views)"
+echo "✅ 去重机制（同一用户/IP只记录一次）"
+echo ""
+echo "下一步："
+echo "1. 访问博客，浏览几篇文章"
+echo "2. 登录后台查看统计数据"
+echo "3. 尝试筛选和分页功能"
+echo ""