如何在streetmerchant项目中添加新商店和配置Discord通知

如何在streetmerchant项目中添加新商店和配置Discord通知

streetmerchant 🤖 The world's easiest, most powerful stock checker 项目地址: https://gitcode.com/gh_mirrors/st/streetmerchant

前言

streetmerchant是一个自动化库存监控工具，主要用于追踪热门商品（如显卡、娱乐设备等）的库存情况。本文将详细介绍如何在该项目中添加新的商店支持，以及如何配置Discord通知功能。

添加新商店

准备工作

在开始添加新商店前，你需要了解以下概念：

1. 选择器(Selector)：用于定位网页中特定元素的CSS路径
2. 商店模型(Store Model)：定义商店特定信息的TypeScript接口
3. 品牌/系列/型号(Brand/Series/Model)：商品分类体系

创建商店文件

1. 在src/store/model目录下创建新的TypeScript文件，例如new-store.ts
2. 可以复制现有商店文件作为模板进行修改

获取网页元素选择器

正确获取网页元素选择器是关键步骤：

1. 打开目标商店网站
2. 使用浏览器开发者工具（F12键打开）
3. 通过以下方式定位元素：
   • 点击"选择元素"按钮（箭头图标）
   • 或右键点击元素选择"检查"
4. 获取元素选择器建议：
   • 优先选择具有唯一性的父元素
   • 避免使用过于通用的类名
   • 可通过右键元素→复制→复制选择器快速获取

更新项目模型

添加新商店后，需要更新相关模型文件：

1. 在src/store/model/index.ts中添加新商店的导入和映射
2. 如果需要新增品牌/系列/型号，需更新：
   • src/store/model/store.ts中的类型定义
   • src/config.ts中的配置项

测试与验证

完成代码修改后，建议：

1. 运行项目测试新商店功能
2. 检查是否能正确识别库存状态
3. 验证通知功能是否正常工作

配置Discord通知

Discord通知功能可以让库存变化实时推送到指定频道。

创建Webhook

1. 进入Discord服务器设置
2. 选择"集成"→"Webhook"
3. 点击"新建Webhook"按钮
4. 配置Webhook名称和频道
5. 复制生成的Webhook URL

项目配置

1. 将复制的Webhook URL设置为环境变量DISCORD_WEB_HOOK
2. 可根据需要调整通知格式和内容

通知功能特点

• 实时性：库存变化会立即触发通知
• 可定制：可配置通知内容和格式
• 多平台支持：除Discord外，还支持多种通知方式

最佳实践

1. 选择器优化：

   • 使用具有唯一性的父元素
   • 避免使用可能变化的动态类名
   • 考虑页面加载时序，添加适当的等待逻辑

2. 模型定义：

   • 保持品牌/系列/型号命名一致性
   • 为新增商品类型添加完整配置

3. 通知配置：

   • 测试Webhook是否正常工作
   • 考虑设置合理的通知频率避免刷屏

结语

通过本文介绍，你应该已经掌握了在streetmerchant项目中添加新商店和配置Discord通知的方法。这些功能可以显著提升库存监控的效率和及时性。在实际操作中，建议先在小范围内测试，确认功能正常后再广泛使用。

streetmerchant 🤖 The world's easiest, most powerful stock checker 项目地址: https://gitcode.com/gh_mirrors/st/streetmerchant