LDStatus Pro 产品需求文档 (PRD)

产品名称: LDStatus Pro
版本: v3.5.4.8
文档版本: 1.0
最后更新: 2026 年 1 月 12 日
产品负责人: JackLiii

---

#📋 文档概述

#文档目的

本文档详细描述 LDStatus Pro 浏览器用户脚本的产品功能需求、技术架构和实现规范，为开发、测试和运维提供统一参考。

#目标读者

• 产品经理
• 开发工程师
• 测试工程师
• 运维人员
• 社区贡献者

---

#1. 产品概述

#1.1 产品定位

LDStatus Pro 是一款面向 Linux.do 和 IDCFlare 社区的浏览器增强工具，以 Tampermonkey 用户脚本形式运行，提供信任级别追踪、阅读统计、排行榜系统、云同步等功能，帮助用户更好地了解和管理自己的社区参与情况。

#1.2 产品愿景

打造社区用户最好用的数据追踪和分析工具，让用户清晰了解自己的社区贡献，激励持续参与。

#1.3 核心价值主张

#1.4 支持平台

#1.5 技术栈概览

---

#2. 用户角色与场景

#2.1 用户角色

#2.2 核心用户场景

场景 1: 新用户首次使用

用户安装脚本 → 访问 Linux.do → 自动显示面板 → 查看信任等级进度 → (可选)登录启用云同步

场景 2: 跨设备同步

用户在设备A登录 → 阅读数据自动上传 → 切换到设备B登录 → 自动下载并合并数据

场景 3: 查看帖子总结

用户浏览话题 → 点击「吃瓜」按钮 → 选择总结模式 → AI 生成总结 → 支持追问对话

场景 4: 商品兑换

用户打开 LD士多 → 浏览商品 → 选择 CDK 商品 → LDC 支付 → 自动获取 CDK

---

#3. 功能需求

#3.1 功能架构图

┌─────────────────────────────────────────────────────────────┐
│                    LDStatus Pro 功能架构                      │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐       │
│  │   核心功能    │  │   社交功能    │  │   辅助功能    │       │
│  ├──────────────┤  ├──────────────┤  ├──────────────┤       │
│  │ 信任等级追踪  │  │ 排行榜系统   │  │ 吃瓜助手     │       │
│  │ 阅读时间统计  │  │ 云端同步     │  │ 我的活动     │       │
│  │ 趋势分析     │  │ OAuth 登录   │  │ LDC 积分     │       │
│  │ 里程碑通知   │  │ 工单反馈     │  │ LD士多       │       │
│  │ 热力图      │  │              │  │ CDK 面板     │       │
│  └──────────────┘  └──────────────┘  └──────────────┘       │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────────────────────────────────────────────────┐   │
│  │                    基础设施                           │   │
│  │  主题系统 │ 响应式布局 │ 多标签页管理 │ 本地存储      │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

#3.2 核心功能模块

3.2.1 信任等级追踪

功能描述: 实时显示用户在论坛的信任等级进度，包括当前等级、升级要求、完成进度。

功能需求:

界面示意:

┌─────────────────────────────┐
│  [头像]  用户名              │
│          信任等级 2          │
│                             │
│      ╭─────────────╮        │
│      │    75%     │ ← 环形进度│
│      ╰─────────────╯        │
│                             │
│  浏览话题: 500/1000  [+10]  │
│  已读帖子: 2000/5000 [+50]  │
│  获赞:     100/200   [+5]   │
│  送出赞:   150/200          │
│  回复:     50/100    [+2]   │
└─────────────────────────────┘

3.2.2 阅读时间统计

功能描述: 自动追踪用户在论坛的阅读时间，提供多维度统计分析。

功能需求:

阅读等级配置:

3.2.3 趋势分析

功能描述: 以图表形式展示历史数据变化趋势。

功能需求:

3.2.4 排行榜系统

功能描述: 展示阅读时间排行榜，激励用户参与。

功能需求:

缓存策略:

3.2.5 云端同步

功能描述: 支持阅读数据跨设备同步。

功能需求:

同步间隔配置:

#3.3 辅助功能模块

3.3.1 吃瓜助手 (AI 总结)

功能描述: 使用 AI 自动总结帖子内容。

功能需求:

3.3.2 我的活动

功能描述: 查看用户在论坛的各类活动记录。

功能需求:

3.3.3 LDC 积分

功能描述: 查看 Linux.do Credit (LDC) 积分信息。

功能需求:

3.3.4 LD 士多 (小卖部)

功能描述: 虚拟物品和服务兑换平台。

功能需求:

商品类型:

3.3.5 CDK 面板

功能描述: 在 cdk.linux.do 查看 CDK 信息。

功能需求:

3.3.6 工单反馈

功能描述: 用户反馈和问题报告系统。

功能需求:

3.3.7 话题导出

功能描述: 将话题内容导出为文件。

功能需求:

#3.4 基础功能模块

3.4.1 界面系统

功能需求:

响应式断点:

3.4.2 多标签页管理

功能描述: 处理多标签页同时打开的场景。

功能需求:

3.4.3 数据存储

本地存储键:

---

#4. 非功能需求

#4.1 性能需求

#4.2 可靠性需求

#4.3 安全需求

#4.4 兼容性需求

浏览器支持:

---

#5. 技术架构

#5.1 系统架构图

┌─────────────────────────────────────────────────────────────────┐
│                         用户浏览器                               │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │              Tampermonkey / Stay                         │   │
│  │  ┌───────────────────────────────────────────────────┐  │   │
│  │  │           LDStatusPro.user.js (16000+ 行)         │  │   │
│  │  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │  │   │
│  │  │  │ Core    │ │ UI      │ │ Network │ │ Storage │  │  │   │
│  │  │  │ Module  │ │ Module  │ │ Module  │ │ Module  │  │  │   │
│  │  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘  │  │   │
│  │  └───────────────────────────────────────────────────┘  │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼ HTTPS
┌─────────────────────────────────────────────────────────────────┐
│                    Cloudflare Edge Network                       │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                   Workers Runtime                         │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐        │   │
│  │  │ Router  │ │ Auth    │ │ Reading │ │ Shop    │        │   │
│  │  │ Module  │ │ Service │ │ Service │ │ Service │        │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘        │   │
│  └─────────────────────────────────────────────────────────┘   │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐            │
│  │ D1 Database │  │ R2 Storage  │  │ Cache API   │            │
│  │ (SQLite)    │  │ (Backup)    │  │ (边缘缓存)  │            │
│  └─────────────┘  └─────────────┘  └─────────────┘            │
└─────────────────────────────────────────────────────────────────┘

#5.2 数据库设计

核心表:

#5.3 API 设计

主要接口:

---

#6. 里程碑与路线图

#6.1 已完成版本

#6.2 未来规划

---

#7. 风险与依赖

#7.1 技术风险

#7.2 外部依赖

---

#8. 附录

#8.1 术语表

#8.2 参考文档

• 详细功能文档
• 更新日志
• 后端 API 文档
• 数据库设计

#8.3 联系方式

• GitHub: caigg188/LDStatusPro
• 问题反馈: GitHub Issues
• 官网: ldspro.qzz.io

---

文档结束