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 核心价值主张

价值点	描述
📊 数据可视化	直观展示信任等级进度、阅读时间、趋势变化
☁️ 跨设备同步	支持多设备数据云同步，随时随地查看
🏆 社交激励	排行榜系统激励用户持续参与社区
🛡️ 隐私优先	用户自主选择参与，数据本地存储为主
🍉 内容辅助	AI 帖子总结、活动记录查看等辅助功能

1.4 支持平台

站点	域名	功能支持
Linux.do	linux.do	全功能
IDCFlare	idcflare.com	全功能

1.5 技术栈概览

层级	技术方案
客户端	原生 JavaScript (Tampermonkey 用户脚本)
后端	Cloudflare Workers + D1 Database
存储	Cloudflare R2 (备份)
认证	OAuth 2.0 (Discourse Connect)
管理面板	Vue 3 + Pinia + Tailwind CSS
官网	React 19 + TypeScript + Framer Motion

---

2. 用户角色与场景

2.1 用户角色

角色	描述	主要需求
普通用户	Linux.do/IDCFlare 社区成员	查看信任等级进度、阅读统计、参与排行榜
活跃用户	高频访问社区的用户	跨设备同步、趋势分析、里程碑成就
内容消费者	喜欢浏览帖子的用户	AI 总结、阅读记录、收藏管理
商家用户	发布商品的卖家	LD 士多商品发布、CDK 管理、订单管理
管理员	系统管理人员	用户管理、数据监控、配置管理

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 信任等级追踪

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

功能需求:

需求 ID	需求描述	优先级	状态
TL-001	自动获取用户当前信任等级 (0-4 级)	P0	✅
TL-002	显示环形进度条，展示升级完成度	P0	✅
TL-003	列出各项升级要求 (浏览话题、已读帖子、获赞、送出赞、回复等)	P0	✅
TL-004	实时高亮显示数值变化 (增加/减少)	P1	✅
TL-005	等级专属配色方案 (Lv1 灰/Lv2 蓝/Lv3 紫青/Lv4 金橙红)	P1	✅
TL-006	等级变化时显示通知 (升级祝贺/降级提醒)	P1	✅

界面示意:

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

3.2.2 阅读时间统计

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

功能需求:

需求 ID	需求描述	优先级	状态
RT-001	每 10 秒检测用户活动状态 (鼠标/键盘/滚动)	P0	✅
RT-002	60 秒无活动自动暂停计时	P0	✅
RT-003	显示今日阅读时长 (分钟/小时)	P0	✅
RT-004	7 级阅读等级系统 (可扩展至 10 级)	P0	✅
RT-005	等级进度条和下一等级剩余时间	P1	✅
RT-006	本周/本月/总计阅读统计	P1	✅
RT-007	阅读等级配置支持服务端管理	P2	✅

阅读等级配置:

等级	图标	默认阈值	颜色
刚起步	🌱	0-30 分钟	灰色
热身中	📖	30-90 分钟	蓝色
渐入佳境	📚	90-180 分钟	绿色
沉浸阅读	🔥	180-300 分钟	黄色
深度学习	⚡	300-450 分钟	橙色
LD 达人	🏆	450-600 分钟	紫色
超级水怪	👑	600+分钟	粉色

3.2.3 趋势分析

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

功能需求:

需求 ID	需求描述	优先级	状态
TR-001	本周每日增量柱状图	P0	✅
TR-002	本月每周增量柱状图	P0	✅
TR-003	本年每月增量柱状图	P1	✅
TR-004	年度热力图 (365 天)	P1	✅
TR-005	悬浮提示显示具体数值	P1	✅
TR-006	支持切换不同统计维度	P2	✅

3.2.4 排行榜系统

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

功能需求:

需求 ID	需求描述	优先级	状态
LB-001	日榜/周榜/月榜三榜切换	P0	✅
LB-002	显示 Top 50 用户	P0	✅
LB-003	前三名金银铜牌特殊展示	P1	✅
LB-004	当前用户排名高亮	P1	✅
LB-005	点击用户名跳转主页	P2	✅
LB-006	手动刷新 (5 分钟冷却，各榜独立)	P1	✅
LB-007	隐私优先，用户自主选择加入	P0	✅

缓存策略:

榜单类型	服务端更新频率	客户端缓存时间
日榜	每 5 分钟	10 分钟
周榜	每小时	2 小时
月榜	每 3 小时	6 小时

3.2.5 云端同步

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

功能需求:

需求 ID	需求描述	优先级	状态
CS-001	OAuth 2.0 登录认证	P0	✅
CS-002	阅读时间数据自动上传 (30 分钟间隔)	P0	✅
CS-003	自动下载云端数据 (6 小时间隔)	P0	✅
CS-004	智能合并策略 (取较大值)	P0	✅
CS-005	新设备自动恢复 365 天历史	P1	✅
CS-006	手动触发同步	P1	✅
CS-007	升级要求数据云同步	P2	✅

同步间隔配置:

同步类型	间隔时间
上传同步	60 分钟
下载同步	12 小时
同步检查	10 分钟

3.3 辅助功能模块

3.3.1 吃瓜助手 (AI 总结)

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

功能需求:

需求 ID	需求描述	优先级	状态
AI-001	简略模式 (~150 字) / 详细模式 (完整分析)	P0	✅
AI-002	流式输出，实时显示	P0	✅
AI-003	自定义楼层范围	P1	✅
AI-004	历史记录保存 (最多 100 条)	P1	✅
AI-005	追问对话 (多轮问答)	P1	✅
AI-006	自定义 API 地址和提示词	P2	✅
AI-007	展开查看弹窗 (可拖拽/调整大小)	P2	✅

3.3.2 我的活动

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

功能需求:

需求 ID	需求描述	优先级	状态
MA-001	已读话题列表	P0	✅
MA-002	收藏列表	P0	✅
MA-003	回复记录	P0	✅
MA-004	点赞历史	P1	✅
MA-005	我的话题	P1	✅
MA-006	互动记录 (Reactions)	P2	✅
MA-007	搜索功能 (标题/标签)	P1	✅
MA-008	批量加载 (20/50/100/200/300 条)	P2	✅

3.3.3 LDC 积分

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

功能需求:

需求 ID	需求描述	优先级	状态
LDC-001	显示积分余额	P0	✅
LDC-002	7 日收支统计图表	P0	✅
LDC-003	当日预估收益	P1	✅
LDC-004	交易记录列表 (分页加载)	P0	✅
LDC-005	时间/类型筛选	P1	✅
LDC-006	交易详情查看	P2	✅
LDC-007	赞赏支持 (2/5/10/50 LDC)	P2	✅

3.3.4 LD 士多 (小卖部)

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

功能需求:

需求 ID	需求描述	优先级	状态
SH-001	商品列表浏览 (瀑布流加载)	P0	✅
SH-002	分类筛选 (AI/存储/小鸡/咨询/订阅/接码/服务/小店/入站)	P0	✅
SH-003	CDK 商品自动发货	P0	✅
SH-004	LDC 积分支付	P0	✅
SH-005	订单管理 (买家/卖家视角)	P0	✅
SH-006	商家入驻 (绑定 LDC 账户)	P1	✅
SH-007	CDK 库存管理	P1	✅
SH-008	商品编辑/上下架	P1	✅

商品类型:

类型	说明	发货方式
link	链接类型	跳转外部链接
cdk	CDK 类型	自动发放
shop	小店类型	链接到外部商城

3.3.5 CDK 面板

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

功能需求:

需求 ID	需求描述	优先级	状态
CDK-001	显示用户信息 (头像/昵称/等级/CDK 分数)	P0	✅
CDK-002	领取记录列表	P0	✅
CDK-003	项目详情查看	P1	✅
CDK-004	一键复制 CDK	P1	✅

3.3.6 工单反馈

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

功能需求:

需求 ID	需求描述	优先级	状态
TK-001	提交功能建议/BUG 反馈	P0	✅
TK-002	查看工单状态	P0	✅
TK-003	双向回复沟通	P1	✅
TK-004	未读提醒 (红点)	P1	✅

3.3.7 话题导出

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

功能需求:

需求 ID	需求描述	优先级	状态
EX-001	导出为 HTML 文件	P1	✅
EX-002	导出为 PDF 文件	P1	✅
EX-003	自定义楼层范围	P2	✅
EX-004	支持中断导出	P2	✅

3.4 基础功能模块

3.4.1 界面系统

功能需求:

需求 ID	需求描述	优先级	状态
UI-001	深色/浅色/自动主题切换	P0	✅
UI-002	面板拖拽移动	P0	✅
UI-003	面板折叠/展开	P0	✅
UI-004	响应式布局 (适配各尺寸屏幕)	P0	✅
UI-005	移动端触摸支持	P1	✅
UI-006	100%完成度庆祝动画	P2	✅
UI-007	等级徽章动效	P2	✅
UI-008	玻璃拟态设计风格	P2	✅

响应式断点:

断点	条件	行为
大屏	≥1920px	面板宽度 340px
中屏	≤768px	面板宽度 280px
小屏	≤480px	面板宽度 260px
超小屏	≤360px	精简布局

3.4.2 多标签页管理

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

功能需求:

需求 ID	需求描述	优先级	状态
MT-001	TabLeader 机制 (只有一个标签页执行定时任务)	P0	✅
MT-002	领导者标签页关闭自动切换	P0	✅
MT-003	数据不重复写入	P0	✅

3.4.3 数据存储

本地存储键:

存储键	说明	同步到云端
position	面板位置	❌
collapsed	折叠状态	❌
theme	主题设置	❌
history	信任等级历史	❌
readingTime	阅读时间数据	✅
milestones	已显示里程碑	❌
leaderboardToken	认证令牌	❌

---

4. 非功能需求

4.1 性能需求

指标	目标值	说明
首次加载时间	< 500ms	面板显示时间
内存占用	< 30MB	常驻内存
API 响应时间	< 500ms	平均响应时间
脚本体积	< 500KB	压缩后大小

4.2 可靠性需求

指标	目标值
API 可用性	99.9%
数据同步成功率	99%
错误自动恢复	支持降级模式

4.3 安全需求

需求	措施
XSS 防护	所有用户输入转义
SQL 注入防护	参数化查询
认证安全	OAuth 2.0 + JWT
数据加密	HTTPS 传输 + CDK AES 加密

4.4 兼容性需求

浏览器支持:

浏览器	最低版本	脚本管理器
Chrome	80+	Tampermonkey
Firefox	78+	Tampermonkey
Edge	80+	Tampermonkey
Safari (macOS)	14+	Tampermonkey
Safari (iOS)	15+	Stay

---

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 数据库设计

核心表:

表名	说明	主要字段
users	用户表	id, site, user_id, username, trust_level, is_active
reading_daily	每日阅读	site, user_id, date, minutes
reading_weekly	周汇总	site, user_id, week, minutes
reading_monthly	月汇总	site, user_id, month, minutes
leaderboard_cache	排行榜缓存	site, type, period, data
shop_products	商品表	id, seller_id, product_type, price, stock
shop_orders	订单表	id, order_no, buyer_id, product_id, status
shop_cdks	CDK 表	id, product_id, code, status

5.3 API 设计

主要接口:

路径	方法	说明	认证
/api/user/sync	POST	用户信息同步	❌
/api/reading/sync	POST	阅读数据同步	❌
/api/reading/history	GET	阅读历史查询	❌
/api/leaderboard/:type	GET	排行榜查询	❌
/api/shop/products	GET	商品列表	❌
/api/shop/orders	POST	创建订单	✅
/api/admin/*	*	管理接口	✅

---

6. 里程碑与路线图

6.1 已完成版本

版本	日期	主要功能
v1.0	2024-Q2	基础信任等级追踪
v2.0	2024-Q3	阅读时间统计、趋势图
v3.0	2024-Q4	排行榜系统、云同步
v3.3	2024-12	工单系统、全新配色
v3.4	2025-01	数据归档、性能优化
v3.5	2025-01	吃瓜助手、LD 士多、LDC 积分

6.2 未来规划

版本	预计时间	规划功能
v3.6	2025-Q1	数据可视化增强、年度报告
v4.0	2025-Q2	多语言支持、主题商店

---

7. 风险与依赖

7.1 技术风险

风险	影响	缓解措施
Cloudflare 服务故障	API 不可用	本地降级模式
论坛 API 变更	数据获取失败	版本适配、快速响应
浏览器扩展政策变更	脚本无法运行	多平台适配

7.2 外部依赖

依赖	用途	备选方案
Linux.do OAuth	用户认证	仅本地模式
credit.linux.do	LDC 积分	提示用户登录
OpenAI 兼容 API	AI 总结	用户自配

---

8. 附录

8.1 术语表

术语	说明
信任等级	Discourse 论坛的用户等级系统 (0-4 级)
LDC	Linux.do Credit，论坛积分系统
CDK	Card Key，兑换码
OAuth	开放授权协议
Tampermonkey	最流行的浏览器用户脚本管理器

8.2 参考文档

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

8.3 联系方式

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

---

文档结束