Skip to content

About

鸿蒙激励计划小助手

Resources

Stars

9 stars

Watchers

0 watching

Forks

Latest commit

 

History

16 Commits

Folders and files

Repository files navigation

鸿蒙激励计划小助手

Version Chrome Extension Manifest License

一个专为华为鸿蒙激励计划开发者打造的数据统计与可视化 Chrome 浏览器插件

功能特点 • 安全保障 • 安装方法 • 使用说明 • 项目结构 • 技术实现

Chrome Web Store


🎉 最新更新 (v3.1.0)

  • 🐛 修复昨日新增计算 - 修复首次加载时昨日新增显示不正确的问题

✨ 功能特点

📊 核心功能

  • 智能数据捕获 - 自动拦截并解析华为开发者平台的 API 请求
  • 实时数据统计 - 动态计算应用总数、激励金额、达标情况等关键指标
  • 可视化展示 - 美观的侧边栏界面,清晰展示所有统计数据
  • 分类统计 - 自动区分应用和游戏类型,分别统计
  • 阶段追踪 - 追踪应用在各个激励阶段的分布情况
  • 日活数据统计 - 展示应用的昨日新增、首月、次月、第三月日活数据
  • 趋势图表 - 可视化显示应用日活数据走势图,支持展开查看详情
  • 搜索筛选 - 支持应用名称实时搜索,多条件组合筛选
  • 多列排序 - 支持按名称、日期、日活数据等多列排序
  • 海报生成 - 一键生成精美的数据统计海报,支持下载分享
  • 🪷 鸿蒙功德木鱼 - 趣味互动,点击敲木鱼积累功德

🎨 界面特性

  • ✅ 现代化的渐变色设计
  • ✅ 固定在页面右侧,不影响正常浏览
  • ✅ 可收起/展开,灵活控制显示
  • ✅ 响应式布局,适配不同屏幕
  • ✅ 清晰的数据可视化卡片
  • ✅ 支持暗色主题适配

📈 统计指标

  • 应用总数 - 显示应用和游戏的总数量
  • 预估激励 - 根据应用/游戏数量预估总激励(应用¥10,000,游戏¥2,000)
  • 已获激励 - 实际已达标的激励金额总和
  • 平均激励 - 单个应用的平均激励金额
  • 达标情况 - 基础激励、一阶段、二阶段的达标数量和比例
  • 阶段分布 - 各阶段应用数量的可视化展示
  • 日活数据 - 昨日新增日活、首月(1-30天)、次月(31-60天)、第三月(61-90天)日活统计
  • 趋势可视化 - 点击应用卡片展开,查看日活数据趋势图表

🔒 安全保障

🛡️ 隐私与安全

  • ✅ 本地运行 - 所有数据处理均在浏览器本地完成,无需远程服务器
  • ✅ 完全离线 - 插件不联网,不收集、不上传任何用户数据
  • ✅ 开源透明 - 所有代码完全开源,可随时审查和验证
  • ✅ 数据安全 - 数据仅存储在本地浏览器,用户完全掌控
  • ✅ 无后门风险 - 无任何第三方服务依赖,无隐私泄露风险

本插件严格遵循隐私保护原则,您的数据安全是我们的首要承诺!


📦 安装方法

方式一:Chrome 网上应用店安装(推荐)

  1. 访问插件页面

  2. 安装插件

    • 点击"添加至 Chrome"按钮
    • 在弹出的确认对话框中点击"添加扩展程序"
    • 等待安装完成
  3. 开始使用

    • 访问华为鸿蒙激励计划数据查询页面即可自动使用

方式二:开发者模式安装(开发测试)

  1. 下载项目代码

    git clone https://github.com/zwpro/harmonyos-incentive.git
    cd harmonyos-incentive
  2. 打开 Chrome 扩展管理页面

    • 在地址栏输入:chrome://extensions/
    • 或点击菜单 → 更多工具 → 扩展程序
  3. 启用开发者模式

    • 打开页面右上角的"开发者模式"开关
  4. 加载插件

    • 点击"加载已解压的扩展程序"
    • 选择项目所在的文件夹
    • 确认加载成功

🚀 使用说明

基本使用

  1. 访问目标页面

  2. 等待数据加载

    • 插件会自动在页面右侧显示侧边栏
    • 等待页面数据加载完成(或切换分页、刷新页面)
  3. 查看统计数据

    • 侧边栏自动展示所有应用的统计信息
    • 包括总数、激励金额、达标情况等

高级功能

📱 生成统计海报

  1. 点击侧边栏中的"生成海报"按钮
  2. 等待海报生成(基于 html2canvas 技术)
  3. 在弹窗中预览海报效果
  4. 点击"下载海报"保存到本地,或直接关闭

🔍 应用详情查看

  • 每个应用卡片显示:应用名称、包名、类型、当前阶段、各阶段激励金额
  • 支持按阶段、类型、激励、状态筛选和查看
  • 搜索功能:输入应用名称实时搜索筛选
  • 排序功能:点击表头按应用名称、上架日期、日活数据排序
  • 清晰的达标状态标识
  • 日活数据展示:显示昨日新增、首月、次月、第三月日活数据
  • 趋势图表:点击应用卡片展开,查看日活数据的可视化趋势图

🪷 鸿蒙功德木鱼

趣味互动功能,为开发之旅增添乐趣:

  • 点击木鱼图标积累功德,配合敲击动画和音效
  • 统计今日和总计敲击次数,数据本地保存

🎛️ 侧边栏控制

  • 收起侧边栏:点击右上角的 × 按钮
  • 展开侧边栏:点击页面右侧的悬浮按钮
  • 社群交流:点击"进群"按钮查看二维码

📁 项目结构

dataquery/
├── app.js                    # 主应用入口
├── content.js                # 内容脚本(如存在)
├── inject.js                 # API 拦截注入脚本
├── manifest.json             # 插件配置文件
├── icons.js                  # SVG 图标定义
│
├── core/                     # 核心业务逻辑
│   ├── config.js            # 全局配置(版本、GitHub、社群等)
│   ├── state.js             # 状态管理(应用数据存储)
│   ├── dataProcessor.js     # 数据处理(解析 API 响应)
│   └── statistics.js        # 统计计算(各项指标计算)
│
├── events/                   # 事件处理
│   └── handlers.js          # 各类事件绑定和处理
│
├── features/                 # 功能模块
│   └── poster.js            # 海报生成功能
│
├── ui/                       # 界面渲染
│   ├── renderer.js          # UI 渲染逻辑
│   ├── appRow.js            # 应用卡片组件
│   └── styles.css           # 样式文件
│
├── utils/                    # 工具函数
│   └── mask.js              # 遮罩层工具
│
├── libs/                     # 第三方库
│   ├── html2canvas.min.js   # 截图库
│   └── chart.min.js         # 图表库(Chart.js)
│
└── images/                   # 图片资源
    ├── logo.png             # Logo 图标
    ├── muyu.png             # 木鱼图片
    ├── bangzi.png           # 木鱼棒子图片
    └── README.md            # 图片说明

🔧 技术实现

核心技术栈

  • Chrome Extension Manifest V3 - 最新的扩展清单版本
  • 原生 JavaScript (ES6+) - 无框架依赖,轻量高效
  • CSS3 - 现代化样式,渐变、动画、响应式
  • html2canvas - 将 DOM 转换为 Canvas 图片
  • Chart.js - 数据可视化图表库
  • LocalStorage - 本地数据持久化存储

关键技术点

1. API 拦截技术

通过注入脚本拦截 XMLHttpRequest 和 fetch 请求:

// inject.js 核心逻辑
const originalFetch = window.fetch;
window.fetch = function(...args) {
  return originalFetch.apply(this, args).then(response => {
    // 拦截并解析响应数据
    return response;
  });
};

2. 模块化架构

采用模块化设计,职责清晰:

  • core/ - 核心业务逻辑和状态管理
  • ui/ - 界面渲染和组件
  • events/ - 事件处理
  • features/ - 独立功能模块

3. 状态管理

使用 Map 数据结构管理应用列表,高效去重和查询:

// core/state.js
const AppState = {
  appsMap: new Map(), // 应用数据存储
  apiRequests: [],    // API 请求记录
  cutOffTime: null    // 截止时间
};

4. 数据统计算法

实时计算多维度统计指标:

  • 总激励 = Σ(各应用激励)
  • 预估激励 = 应用数 × 10000 + 游戏数 × 2000
  • 达标率 = 达标数量 / 总数量 × 100%

🎨 自定义配置

修改版本信息

编辑 core/config.js:

const AppConfig = {
  version: 'v1.0.0',
  appName: '鸿蒙激励计划小助手',
  githubUrl: 'https://github.com/zwpro/harmonyos-incentive',
  community: {
    qrCodeUrl: 'https://your-qrcode-url.png'
  }
};

修改样式

编辑 ui/styles.css,可自定义:

  • 侧边栏宽度、颜色
  • 卡片样式
  • 按钮效果
  • 动画过渡

修改统计规则

编辑 core/statistics.js,调整统计计算逻辑。


🤝 贡献指南

欢迎提交 Issue 和 Pull Request!

开发流程

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 提交 Pull Request

开发规范

  • 遵循现有的代码风格
  • 添加必要的注释
  • 测试新功能是否正常工作
  • 更新相关文档

📝 更新日志

v3.1.0 (2026-01-31)

  • 🐛 修复昨日新增计算 - 修复首次加载时昨日新增显示不正确的问题(显示为前天数据)

v3.0.0 (2026-01-02)

  • 🎊 活动结束庆祝横幅 - 鸿蒙激励计划圆满结束,新增庆祝横幅展示
  • 🔍 应用名称搜索 - 新增应用名称实时搜索筛选功能
  • 📊 多列排序功能 - 支持按应用名称、上架日期、昨天新增、各阶段日活排序
  • 🎨 优化筛选器布局,新增状态筛选(紧急/即将到期/时间充足)
  • ⚡ 性能优化,排序和筛选更加流畅

v2.0.0 (2025-11-08)

  • ✨ 新增日活数据统计 - 显示昨日新增、首月、次月、第三月日活数据
  • ✨ 新增趋势图表 - 点击应用展开查看日活数据可视化图表
  • ✨ 新增鸿蒙功德木鱼 - 趣味互动功能,点击木鱼积累功德
  • 🎨 优化表格展示,增加日活数据列
  • 🎨 木鱼敲击动画、音效和特效
  • 💾 功德数据本地持久化存储
  • 📊 集成 Chart.js 图表库

v1.0.0 (2025-11-02)

  • 🎉 首次发布
  • ✨ 支持自动数据捕获和统计
  • ✨ 实现侧边栏可视化展示
  • ✨ 支持海报生成和下载
  • ✨ 完整的应用和游戏分类统计
  • ✨ 多维度数据指标展示

❓ 常见问题

Q: 为什么看不到数据?

A: 请确保:

  1. 已正确安装插件并刷新页面
  2. 访问的是正确的华为开发者平台页面
  3. 页面数据已加载完成(可尝试切换分页)

Q: 海报生成失败怎么办?

A: 可能原因:

  1. html2canvas 库未正确加载 - 尝试重新加载插件
  2. 浏览器兼容性问题 - 建议使用最新版 Chrome

Q: 如何更新插件?

A:

  • 从 Chrome 网上应用店安装的用户:插件会自动更新,无需手动操作
  • 开发者模式安装的用户:
    1. 拉取最新代码:git pull
    2. 在扩展管理页面点击刷新图标

📄 许可证

本项目基于 MIT License 开源。


🔗 相关链接


💬 交流与支持

如果这个插件对您有帮助,欢迎:

  • ⭐ Star 本项目
  • 🐛 提交 Bug 报告
  • 💡 提出新功能建议
  • 📢 分享给其他开发者

Made with ❤️ for HarmonyOS Developers

About

鸿蒙激励计划小助手

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages