---

品牌与设计规范

LDSP 的现行品牌运营方案、设计语言、Logo、静态资源、动效、真实产品展示和桌面／平板／手机适配标准统一保存在 design/README.md。后续设计与界面开发以此为准；原始提案在 design/archive/ 中保留，仅供追溯。

🌟 核心功能

---

🌐 支持站点

两站点功能完全一致，独立 OAuth 认证，数据互不干扰

---

📱 全平台兼容

响应式设计

• 大屏优化 (≥1920px) - 面板宽度 340px，字体放大
• 中等屏幕 (≤768px) - 智能右对齐，280px 宽度
• 小屏设备 (≤480px) - 精简布局，260px 宽度
• 超矮屏 (≤500px) - 自动隐藏非必要元素

移动端支持

• ✅ 触摸拖拽移动面板
• ✅ 折叠状态下也可拖动
• ✅ 自适应字体和间距
• ✅ 优化的点击区域

---

🎨 UI/UX 设计

全新视觉体验

• 🎉 100%完成度庆祝 - 进度达成时礼炮撒花动画
• ✨ 等级徽章动效 - 悬浮 360° 翻转 + 渐变流动
• 🌈 等级专属配色 - Lv1 灰/Lv2 蓝/Lv3 紫青/Lv4 金橙红
• 🎨 玻璃拟态设计 - 毛玻璃效果 + 发光边框
• 💫 微交互动画 - 悬浮上浮/弹性缩放/阴影增强

主题系统

• 🌙 深色主题 - 深邃背景 + 玻璃卡片
• ☀️ 浅色主题 - 透明白色系 + 优雅阴影
• 🔄 一键切换 - 自动记忆用户偏好

---

🔐 安全与隐私

---

⚡ 快速开始

1. 安装脚本管理器

2. 安装脚本

3. 开始使用

• 访问 Linux.do 或 IDCFlare
• 面板自动显示在页面
• 点击登录启用云同步和排行榜
• 通过面板中的「士多」入口在新标签页打开 LD 士多网页版

---

📊 阅读等级系统

💡 管理员可在后台「系统设置」中自定义等级区间和名称

---

🛠️ 本仓库范围

本仓库只含前端三件套。后端、管理面板、安全服务、观测平台是独立仓库。

LDStatusPro/
├── LDStatusPro.user.js    # Tampermonkey 脚本（主 API：api1）
├── ld-store/              # LD 士多 Web（Vue 3 + Vite 8）→ https://ldcstore.com/
└── website/               # 产品官网（React 19 + Vite 7）→ https://ldspro.qzz.io/

技术栈

• 用户脚本: 原生 JavaScript，无运行时 npm 依赖，约 17665 行；版本 3.9.0.3
• 士多 Web: Vue 3.5 + Vite 8 + Pinia + Vue Router 4 + Tailwind 3.4
• 官网: React 19.2 + TypeScript + Vite 7.2 + Tailwind CSS 4 + Framer Motion；首页不走 CMS API
• 认证: 用户 OAuth 由 api1 签发 JWT；管理面板不在本仓

性能优化

• LRU 缓存历史数据聚合
• 批量写入合并存储操作
• API 响应缓存 + 请求去重 + 数据缓冲
• 异步渲染避免 UI 阻塞
• 指数退避重试机制
• 全局请求队列防止 429

---

📋 更新日志

v3.9.0.6

• 加固 CDK/LDC 桥接：URL 必须是 https、精确 origin、路径在 /api/ 下，父页和桥接页双侧校验
• 吃瓜 Markdown 先转义再排版，链接只允许 http(s)，避免模型输出 XSS
• 热路径调试日志改走 Logger，不再把 OAuth 与升级数据打到控制台
• 去掉面板全选择器 transition；LDC 心跳改为 5 秒，有 GM 监听时不再 500ms 轮询
• 安全纯函数抽到 src/core/sanitize.mjs，嵌入 SafeDom，可用 npm test 回归

v3.9.0.3

• 脚本元数据版本 3.9.0.3。近期变更主要在 ld-store（退款、公告、卖家 Telegram、checkout、图床鉴权），见 git log。

v3.9.0.0

• 修复 LDC 积分面板打开后概览页和记录页卡死的问题，补回缺失的请求、渲染与关闭逻辑
• 修复 LDC 面板右上角刷新、关闭按钮无响应的问题
• 修复 LDC 记录页连续触发自动加载请求的问题，恢复为滚动到底部时按页加载
• 修复 LDC 记录筛选载荷，类型筛选改为 types 数组并校正时间范围请求边界
• 完善 LDC 交易类型、收支方向与状态展示，新增在线流转、社区划转、商户分发的方向判断

v3.8.8.9

• 🔧 修复升级要求目标值偶发显示为 0 的问题，补强 connect 页面目标值解析
• 🪪 排行榜与用户头像新增字母头像兜底，远程头像失败时自动退避
• 🏪 移除脚本内嵌士多逻辑，保留入口并改为在新标签页打开网页版
• ✨ 恢复最小化图标的原设计与动画，同时提升渲染兼容性和稳定性
• 📘 README 同步更新安装链接、版本号与士多使用说明

v3.5.4.x 🏪 LD 士多

🏪 虚拟物品兑换信息中心

• 💳 LDC 积分兑换 - 使用 LDC 积分兑换虚拟物品和服务
• 📦 CDK 自动发放 - 兑换成功后自动获取卡密，支持一键复制
• 👤 商家入驻 - 绑定 LDC 账户发布兑换信息
• 📋 订单追踪 - 查看兑换记录和状态
• 🔑 CDK 管理 - 商家可批量添加、查看、复制 CDK

🛡️ 安全加固

• 🔒 XSS 防护增强 - 修复弹窗对话框中名称未转义的风险
• 🔐 CDK 竞态修复 - 使用原子 UPDATE 操作解决高并发问题
• 💉 SQL 注入防护 - 统一使用参数化查询

🎨 UI/UX 优化

• 🖼️ 详情页优化 - 图片 16:9 比例，描述区高度增加
• 📜 列表滚动记忆 - 返回列表时恢复滚动位置
• ⚠️ 拒绝/下架原因显示 - 我的发布中显示拒绝或下架原因

---

v3.5.2.x 🔑 CDK 面板 & 请求优化

🔑 新增 CDK 面板

• 在 cdk.linux.do 页面集成 CDK 面板
• 查看用户信息、领取记录、项目详情

⚡ 请求优化

• 🚦 全局请求队列 - 300ms 最小间隔防止 429
• ⏱️ 429 限流冷却 - 2 分钟内不再发起新请求
• 💬 错误提示优化 - 智能识别错误类型，友好提示

---

v3.5.0.x 🎉 核心功能

✨ 吃瓜助手

• 🍉 AI 帖子总结 / 📜 历史记录 / ✏️ 自定义提示词 / 💬 追问对话

📋 我的活动

• 📖 已读 / ⭐ 收藏 / 💬 回复 / ❤️ 赞过 / 📝 我的话题 / 🔍 搜索

🍟 LDC 积分

• 💰 积分余额 / 📊 7 日统计 / 📈 当日预估 / ❤️ 赞赏支持

查看完整更新日志

---

❓ 常见问题 (FAQ)

❗ 面板不显示怎么办？

如果安装脚本后面板没有显示，请按以下步骤排查：

1. 启用浏览器开发者模式

   • Chrome/Edge: 打开 chrome://extensions/，开启右上角「开发者模式」
   • Firefox: 打开 about:debugging，无需额外设置

2. 检查油猴扩展设置

   • 点击 Tampermonkey 图标 → 管理面板
   • 找到 LDStatus Pro 脚本，确保已启用（开关为开启状态）
   • 进入「设置」→ 确保「允许用户脚本访问的权限」设置正确

3. 刷新页面

   • 完成上述设置后，刷新 Linux.do 或 IDCFlare 页面
   • 面板应该会出现在页面

💡 如果仍然不显示，尝试禁用其他可能冲突的扩展后重试

🦊 Firefox 浏览器登录失败怎么办？

部分 Firefox 用户可能因隐私设置导致 OAuth 登录失败（授权成功但面板无更新）。请尝试以下排查步骤：

1. 检查增强型追踪保护

   • 打开 about:preferences#privacy
   • 如果设置为「严格」，尝试改为「标准」

2. 检查容器标签页 (如使用 Multi-Account Containers 扩展)

   • 确保授权弹窗和主页面在同一个容器中
   • 或暂时在「无容器」的普通标签页中登录

3. 检查第三方 Cookie 设置

   • 确保没有完全禁用第三方 Cookie
   • 可在 about:preferences#privacy → 「Cookie 和网站数据」中检查

💡 Chrome、Edge 等浏览器通常不会有此问题

📊 阅读时间为什么不增加？

• 脚本检测鼠标移动、滚动、点击等活动
• 60 秒无操作会自动暂停计时
• 恢复操作后会继续计时

☁️ 云同步数据会覆盖本地数据吗？

• 云同步采用取较大值合并策略
• 同一天的数据，保留本地和云端中的较大值
• 不会丢失任何已记录的阅读时间

🏪 如何打开 LD 士多？

1. 打开脚本面板中的「士多」入口
2. 脚本会在新标签页打开 LD 士多网页版
3. 当前 Linux.do / IDCFlare 页面会保持不变
4. 如果浏览器拦截了新标签页，请允许弹窗后重试

---

⭐ Star History

---

🤝 贡献

欢迎提交 Issue 和 Pull Request！

• 🐛 报告问题
• 💡 功能建议
• 📖 详细文档
• 🔧 CI / CD：推送跑检查，Pages 生产发布是手动的

---

📄 许可证

MIT License - 自由使用、修改和分发

---