requirements:
NodeJS >= v22.15.0 (I recommend you use v22.15.0)

$> npm install yarn -g # install 'yarn' for global
$> yarn # install components
$> npm run package-firefox # package zip file

A. 第三方包
1. fontjs.js，source：https://www.iconfont.cn/, transfer a svg icon to font icon, just like 'https://fontawesome.com/'.
2. exceljs.min.js，source：https://github.com/exceljs/exceljs/releases/tag/v3.8.2, Modify the image parameters to meet our image requirements. Changed line 462 of code from 18e4 to 30e4.

B. 有争议的文件
1. google.token.service.ts

Base on google TTK algorithm, translate 'string' to another 'string' (just like MD5) for disable invalidate requests, for 'B0B5VLCL1N' => '610414.902424'
2. analysis-util.ts
Our addon is a tool for Amazon Seller, basically it's original source. And its main function for parsing html node. let me introduce the main process method
1/ parse() method: 'for' -> javascript for loop function implement, 'selectorAll' -> document.selectorAll(), 'fHtml' -> get a nodeElement html text ...
2/ most methods, can be found at class 'AmazonDomUtil', 'AmazonPageUtil', 'AmazonUtil';
3/ analysis() the main entry of this class.
3. amazon-listing-analyzer.ts
implement for parsing 'Amazon Product Page' data, and its rule source: background/utils/rule/rules/listing-rule.json
4. amazon-page-util.ts
implement for parsing 'Amazon Searching/Best-Seller Page' data.
5. amazon-seller-analyzer.ts
implement for parsing 'Amazon Seller Page' data, and its rule source: background/utils/rule/rules/seller-rule.json
6. inventory-analyzer.ts
implement for parsing 'Amazon Product Inventory' data, and it's not minified file (source file, basically the naming is not good, so it look like minified file).
7. GA4ClickEvent
ga4.service.ts: if user disable with field 'enableCollectionListing', it will not be send GA4 data.
8. src\background\dto\
All the dtos Object are Entity that is the domain for server's request/response. All the dto/fields is easy to understand.
JAVA for dto explanation:
1/ https://medium.com/swlh/java-lombok-why-getters-and-setters-84607f0a9ade
9. injecting advertising into web page content
it's disabled when user agent is Firefox.
1/ background\service\top-banner.service.ts -> getFromRequest() -> if (!config.enableTopBanner || RuntimeService.USERAGENT_IS_FIREFOX) return [];
# besides, last version we add the tip of 'originating from the add-on', source amazon-root-ad.vue.<div class="native-banner-firefox-ad" v-if="firefoxAd">.
2/ background\service\corner-notice.service.ts -> getFromRequest() -> if (RuntimeService.USERAGENT_IS_FIREFOX) return null;
# corner-notice -- mainly for addon's upgrading tips, now it's disabled for firefox.

PPC竞价支持周更，并支持周历史趋势
筛查相关性、关键词收录，关键词支持翻译
修复若干Bug，优化用户体验

新增流量洞察功能
Listing详情页，直观展示流量词
全球售卖：支持查看未售卖站点
修复若干Bug，优化用户体验

新增绿标查询
英文、日文，Keepa支持AI分析
加入产品库支持记住状态
修复若干Bug，优化用户体验

产品查询迭代优化
Keepa插件替代 加入AI分析
查竞品支持识图查竞品
适配亚马逊改版：评论无法下载

店铺页优化 支持快速分析整个店铺所有ASIN
Listing页优化 支持查看asin变动历史；keepa趋势支持按天查看；变体对比优化
利润计算器重构优化
1688交易路径优化
适配亚马逊改版：评论下载不全

店铺页优化 支持快速分析整个店铺所有ASIN
Listing页优化 支持查看asin变动历史；keepa趋势支持按天查看；变体对比优化
利润计算器重构优化
1688交易路径优化
适配亚马逊改版：评论下载不全

权限优化调整
适配亚马逊改版

新增：亚马逊五点描述检测功能
优化：澳洲站货币显示
修复若干Bug，优化用户体验

新增：亚马逊五点描述检测功能
优化：澳洲站货币显示
修复若干Bug，优化用户体验

修复子体销量不展示问题
修复评论图片无法下载问题
修复与H10的样式冲突问题
加拿大站评论分析适配法语

新增外观专利查询
修复若干Bug，优化用户体验

Keepa插件替代：新增Prime价格、Coupon价格、子体销量等数据
支持导出360° view图
修复若干Bug，优化用户体验

Keepa插件替代：新增Prime价格、Coupon价格、子体销量等数据
支持导出360° view图
修复若干Bug，优化用户体验

关键词新增点击量、曝光量数据
产品查询支持批量查询
网页、插件销量数据表格统一
修复若干Bug，优化用户体验

新增子体销量趋势，支持变体销量对比
关键词导出支持导出前 3 ASIN
产品库支持批量导出历史销量

产品库支持大图模式
SBV视频支持下载
1688找货源优化，结果更精准
修复若干Bug，优化用户体验

产品查询：新增大图模式
亚马逊搜索下拉框，支持展示关键词搜索量
榜单分析支持查看类目搜索结果，解析类目Top400+
关键词收录支持指定页码搜索
快速预览、产品查询新增亚马逊子体销量
修复若干Bug，优化用户体验

产品材质支持导出
Q&A再次支持下载
榜单分析体验优化
修复若干Bug，优化用户体验

榜单页新增：该市场的概况分析
支持图片识别查找竞品
搜索趋势：支持导出周/月数据
快速预览：新增Coupon，并支持导出
产品库：支持添加备忘录
修复若干Bug，优化用户体验

Shulex联名版上线，支持批量评论分析、流行趋势洞察
A+视频支持下载
搜索量趋势支持周趋势
修复若干Bug，优化用户体验

Shulex联名版上线，支持批量评论分析、流行趋势洞察
A+视频支持下载
搜索量趋势支持周趋势
修复若干Bug，优化用户体验

新增墨西哥站点
修复卖家、卖家类型解析问题
修复库存监控获取问题
修复若干Bug，优化用户体验

产品查询：支持包含/排除品牌、卖家
产品查询：支持列表产品去重
修复若干Bug，优化用户体验

评论下载新增Vine评论标识
Tips支持一键关闭
修复若干Bug，优化用户体验