QuickSnipe 插件使用教程
本教程将为您详细介绍如何使用 QuickSnipe 插件。
如有BUG 及时反馈文章源自助手阿喜-https://zsaxi.com/5146
如果需要定制功能，联系我。文章源自助手阿喜-https://zsaxi.com/5146
重要提示：所有功能均需在添加商品并设置价格信息后方可生效。文章源自助手阿喜-https://zsaxi.com/5146
在开始使用前，请务必确认已安装以下两个依赖插件，以便在遇到报错时进行调试：文章源自助手阿喜-https://zsaxi.com/5146
BugSack文章源自助手阿喜-https://zsaxi.com/5146
!BugGrabber文章源自助手阿喜-https://zsaxi.com/5146
本插件创立初衷仅为减少因价格输入错误而导致的不必要损失，请勿滥用。文章源自助手阿喜-https://zsaxi.com/5146
更新日志
2026年5月18日文章源自助手阿喜-https://zsaxi.com/5146
1，[更新] 导入导出 现已可以正确处理 邮寄列表 。文章源自助手阿喜-https://zsaxi.com/5146
2，[更新] 导入导出 现已可以正确处理 邮件配置 的 回收装备 价格。文章源自助手阿喜-https://zsaxi.com/5146
3，[更新] 导入导出 现已可以正确处理 自动喊话 的 喊话设置和回复设置。
4，[修复] 导入导出 导致 数字0显示为"-0" 的BUG
5，[修复] MailerDB.items / customItems / decs.autoFetchItems 改造为 itemID(字符串)为 key。
6，[修复] 切换分组或取消勾选某分组后 制造列队 残留问题
7，[修复] 日志自动裁剪 COD 条目保护,保留 COD 支付/退信/拒收
8，[修复] 邮寄列表,收件人 下拉菜单列表被遮挡的问题
9，[新增] 价格设置导入导出 扫货价/钓鱼价/成本价/上架价格（默认价）
2026年5月17日
1，[新增] 自动回复 功能，可能存在BUG
2026年5月15日
1，[更新] 移除了根据 物品 "classID" 过滤方式
2，[修复] 修复了一些已知的 Bug
2026年5月14日
1，[新增] COD 装备 新增拒绝回收选项, 拖拽/或者输入 物品ID添加。例如制造业物品不在回收范围。
2，[新增] COD 如需回收制造业装备，需要添加到 回收其他，设置对应 才会回收。
3，[新增] 部分做拽添加已经新增通过物品ID添加。
4，[修复] COD 装备 因GetItemInfo为异步API，故如未获取信息本次跳过，下次获取信息后在再处理。
5，[新增] 分解中心 模式下，新增对COD支持，新增对装备取出的支持。
6，[新增] 自动发件 现在已经支持 对 未绑定 绿/蓝/紫 装备进行定向邮寄。需要提前设置收件人。
7，[注意] 首次使用 回收装备 需要先点击【重置数据】。
2026年5月13日
1，[修复] 分解装备 随机附魔导致识别异常的问题，改为 itemid 识别
2，[修复] COD 付费取信 装备 位置的 读取错误。
3，[优化] 喊话模式 设置方式 , 喊话效果 可 勾选 显示日志 查看效果。
4，如有其它建议 可联系我
2026年5月12日
1，[修复] F8 自动取件和收取金币，在完成操作后，会刷新收件箱。
2，[新增] 自动喊话模块,没有单独快捷键，在F8 自动取件，或者操作拍卖行 或者F7 自动制作分解的时候会根据设置 是否喊话。喊话内容可自定义，或者随机生成。
3，[新增] 喊话间隔 指的大周期，频道间隔指的多个频道是否有间隔还是一次性发出，如果设置了间隔，需要多次按键才能发送完毕，如果设置0，那就会一次性发出。频道：勾选需要发送消息的频道，支持多选。
4，[新增] 现在可以正确的 喊话+收取COD物品了！步骤： 1 打开邮箱，2, 勾选启动自动喊话，3，按F8。
5，[新增] 注意 还不能正确处理 装备自动发件的问题。回收装备如果没有自动分解，可能会有爆邮箱的问题。
6，[新增] 组价阈值, 如果单个物品收获价格小于 这个值，那么久按 组来喊价。
7，[新增] 自由发挥 勾选后 喊话时会根据【邮件助手】【邮件配置】【回收其他】【回收装备】自动生成消息，并且 物品顺序随机。回收装备 未测试，建议固定消息。同时 需要设置 “取样内容”
8，[新增] 追加列表 勾选后 下拉菜单中的 信息会加入到喊话。建议回收装备使用此功能，如果勾选自由发回。
9，[修复] 邮件助手-邮件配置-回收其他 列表显示 现在改为 itemid 排序
10，[注意] 必须设置一条喊话内容，并添加后，才可以正常使用。
2026年5月11日
1，[修复] 修复轮流制作逻辑导致 没有设置轮流任务导致 不按顺序制作的bug。
2026年5月9日
1，[修复] 邮件日志 漏记的问题。
2，[新增] 邮件日志 分类 调整为 多选/单选 模式 M 多选 / S单选
3，[新增] 拍卖助手 分组 调整为 多选/单选 模式 M 多选 / S单选 , 方便不同角色不同专业使用快速使用不同数据。
4，[新增] 拍卖助手 在物品的鼠标提示上 显示当前物品 已在哪些分组。
5，[修复] 邮件日志 金额对齐问题，新增对应 字体。
2026年5月8日
1，[修复] 分解中心 -- 制造选项 不能自动切换 指定数量 轮询制作的问题。【使用方式, 在生产队列页面打开专业，选择配方 设置数量 勾选制造，如设置 朴素血玉石 1，符文血玉石 1，那么 分解中心 制作的时候，会按照 这两个物品交替制作1个进行。】 注意，如果还有其他没有设置 数量的制造物，可能会有bug，没有经过严格测试。
2，[新增] 邮件助手-- 默认收件人 按钮 删除/ 添加，左键保留原来功能，右键改为添加和删除白名单角色名功能。设置白名单的角色，视为是自己，忽略压价等。
3，[新增] 邮件助手 页面 新增 邮件日志 记录一些邮寄数据，鼠标移动到对应条目会显示详情。
4，[新增] 邮件助手 新增 退信 功能，开关在原来的 付费取信 右侧，如果勾选退信，会退回 金额不对的付费取信邮件。
5，[注意] 付费取信 比较敏感，避免钱货两空，请用自己角色测试验证后再投入使用。
6，[修复] 记录下 买入卖出信息，可能还是有问题。
2026年5月7日
1，[修复] 修复48h最低价数量连续叠加问题
2，[修复] 修复UI缩放时窗口抖动问题
3，[新增] 右下角缩放图标：拖拽拉伸 + 滚轮微调 + Tooltip
2026年5月6日
1，[新增] 邮件助手— "分解排除" 设置选项, 数据应用在 分解窗口 -- 分解中心，排除的物品将不再显示在列表中。
2，[修复] 导入分组 如果未勾选合并，会先清空分组数据，再添加数据
3，[修复] 导入全部 分组数据 使用覆盖模式，只有 排除列表，收件，分解取出，发件 等 使用合并操作。
4，[新增] 分解中心调用 生产队列 的 制造业 轮流制作逻辑。需要轮流制作的，切换到 “生产队列” 标签 对 指定 配方 设置 “数量”，再切换到 分解中心 就可以轮流制作，只经过简单测试,有bug 反馈。
2026年5月5日
1， [修复] 禁用 勾选 “材料齐备”
2026年4月30日
1，[新增] 导入导出面板 — "合并导入"勾选框 + 全局存储变量,
2，[重构] priceHistory 统一迁移至全局存储 鼠标移动到 拍卖窗口 物品上显示 最近低价。
3， [修复] HasMailToSend qty 计算不一致
4， [优化] 左侧导航栏宽度可配置
5， [优化] 新增对 裁缝，制皮，炼金术的支持。
6， [优化] 邮件助手中 添加 收件人 改为手动，而非修改 mailer.lua 文件
- **影响范围**: - **导入分组 (`ImportData`)**: ItemList 按 itemID 去重 - **导入所有 (`ImportDataAll`)**: 以下 10 个字段受控： | # | 字段 | 合并去重键 | |---|------|-----------| | 1 | `decs.autoFetchItems` | itemID / name | | 2 | `MailConfig.Zhuangbei` | [等级][品质] → itemID | | 3 | `MailConfig.Caoyao` | [等级][品质] → itemID | | 4 | `MailConfig.Cailiao` | [等级][品质] → itemID | | 5 | `MailerDB.recipientList` | 收件人名称字符串 | | 6 | `MailerDB.items` | itemID (自然键) | | 7 | `CraftQueue.merchant` | 物品名称 (自然键) | | 8 | `CraftQueue.favorites` | spellName (自然键) | | 9 | `CraftQueue.items` | spellName + profession 组合 | | 10 | `ItemList` | itemID |
2026年4月27日 移除卖店功能
界面与启动
当您打开拍卖行后，插件界面将自动显示。点击购物车图标即可打开工具箱界面，只有在打开拍卖行时，拍卖助手才会生效。 
数据导入与导出
-
导出分组
导出当前分组信息，供其他窗口或角色导入使用。
-
导入分组
导入之前已导出的分组数据。
-
导出所有
导出所有分组数据及部分设置（注：部分全局设置不会被导出）。
-
导入所有
导入所有分组数据及设置。
按钮与功能详解
- 工具箱：进入基本设置界面。
- 导出：根据当前模式（买入/卖出）导出商品名称，方便核对数据。
- 刷新异常：当界面显示异常时点击刷新。首次使用时请务必点击此按钮以初始化数据。
- 分类选择：针对列表过长的问题，选中此项后仅显示所选分类的商品。
核心功能开关
- 快速上架：搜索时，若背包中有对应物品，自动放入卖出栏位。
- 自动取消：发现更低价格时，自动取消自己的上架物品。
- 自动取件：打开邮箱后自动取件。默认取完自动关闭邮箱；按下 F8 或点击按钮后，取件将不再自动关闭邮箱。
- 考虑手续费：输入成本价时，是否额外计入 5% 的拍卖行手续费。
- 语音播报：开启后，上下架与取消操作将有语音提醒（细分选项见下）。
- 取消语音：播报取消提醒。
- 上架语音：播报上架提醒。
- 可购语音：播报购入提醒。
- 卖出语音：播报卖出提醒。
- 显示卖家：买入商品时，是否在聊天框打印卖家信息。
- 必须首位：卖出商品时，是否必须保持自己排在首位。
- 立即补货：物品售出后，若背包仍有库存，立即自动补充至上架队列。
- 付费取信：是否启用付费取信功能（需在下方“邮件助手--配置编辑器”中进行设置）。
- 取消优先：遇到需取消的物品时，决定是“先上架再取消”还是“先取消再上架”。前者可能导致多上架一件物品（若未能及时获取销售列表）。
- 操作间隔：增加操作间的延迟，避免因快捷键操作过快导致异常。
- 取件间隔：自动取出邮件时的时间间隔。
- 清空销量：清空当前的销量统计数据。
高级功能：钓鱼（防压价策略）
- 我要钓鱼：对指定商品进行钓鱼操作（摆放极低价格，数量 1）。
- 鱼饵频率：设置最短上架时间。统计单个物品被买走后，再次上架的最短间隔时间。
- 不吃鱼饵：开启后，不买入堆叠数低于指定数量的物品。
- 鱼饵数量：设置“不吃鱼饵”的堆叠数阈值（不包含该数值本身）。
- 鱼饵金额：当鱼饵单价大于此金额时，即使不满足数量条件也执行买入。
- 鱼饵排名：当存在大量小于指定堆叠数的商品时，买入指定排名以外的商品。
- 同步成本：全局扫描后点击，根据设置的材料分组信息更新制作成本（如雕文、附魔卷轴），并显示在 成本价 字段。
运行方式与快捷键
选择所需的运行方式，配合 SHIFT+鼠标点击或快捷键执行：
- F10：使用命令模拟查询物品信息（有操作间隔，约 8-10 秒/次）。
- F6：手动输入商品名称，设置好价格信息后按 F6，自动执行对应的买入/卖出等操作。
选择任务模式
- 买入：仅执行买入动作，根据设置的扫货价格信息买入物品。
- 卖出：仅执行卖出动作，根据设置的卖货/制作信息出售或生产物品。
*注：两项可同时勾选，实现同时买卖。*
第一步：添加商品（基本设置 -- 综合 -- 底部）
鼠标点击背包中的物品并拖动到添加窗口，系统将自动填写物品名称与 ID。若未正确填写，插件将出现异常。
商品参数说明：
- 上架数量：您希望上架的次数。
- 堆叠：每次上架的物品数量。若背包物品不足，将按当前剩余数量上架。
- 制作数量：需要制作的物品数量。
- 扫货价：最高买入价格。若在上架时发现低于此价格的物品，且商品同时勾选了“是否购入”与“是否出售”，系统将自动买入。
- 成本价：当前最低售价阈值。低于此价格将不上架。
- 默认价：若拍卖行无此物品，或遇到“千金党”，则按此价格上架（可能存在无法正常上架的极端情况，目前尚未遇到）。
- 下架排名：排名高于此数值时自动下架。
功能复选框说明：
- 是否购入：是否启用该商品的自动买入功能。
- 是否出售：是否启用该商品的自动卖出功能。
- 是否竞价：（功能暂未实装，启用将占用资金）。
- 自动下架：是否启用自动下架（需大开关“自动取消”勾选生效）。
- 是否制作：库存不足时是否自动制作商品（根据制作数量判断。若设为 1，背包保持 1 库存。目前已在铭文、附魔专业测试通过，因背包事件刷新速度问题，可能会偶尔多制作一件）。
添加按钮说明：
- 添加：添加商品并关闭添加窗口。
- 连续添加：添加商品且保持窗口开启，继续添加。
- 导入雕文：一键添加背包中的雕文商品，窗口保持开启。
- 导入附魔：一键添加背包中的附魔商品，窗口保持开启（需附魔专业才可生效）。
- 导入背包：一键添加背包中所有未绑定的物品，窗口保持开启。
- 忽略无库存：导入时，背包内无库存的物品将不被设置为出售状态。
第二步：切换买入/卖出/买与卖模式（手动模式下）
本框架的核心功能之一是允许您自由切换右键操作的目标。只需在设置中选择模式，右键点击游戏内商品的功能便会相应改变：
- 选择“买入”：Shift + 右键点击商品执行购买操作。
- 选择“卖出”：Shift + 右键点击商品执行出售操作或下架。
- 选择“买和卖”：Shift + 右键点击商品，系统将根据当前行情智能判断：若有低于扫货价的商品则买入，反之则执行卖出。
通过此设置，您可快速适应不同交易场景，无需反复调整复杂设置。 *注：若要执行卖出动作，还需在设置中勾选“快速上架”。*
第三步：在买入模式下，设置商品购买限价
当您处于“买入”模式时，可按以下步骤为特定商品设置最高购买价格（扫货价），确保交易符合预算：
- 添加监控商品：
- 点击框架上的“添加”按钮，手动输入商品名称与商品 ID。
- 快捷操作：也可直接从游戏背包中将对应物品拖拽至框架内，系统将自动填充信息。
- 设置价格与启用购买：
- 在“扫货价”字段中，填入您愿意支付的最高单价。
- 勾选“是否购入”选项，激活对此商品的监控与自动购买功能。
- 价格单位说明：价格设置单位为金币（G），支持精确到银币（S）。
- 执行购买操作（仅买入模式下）：
- Shift + 左键单击游戏内商品：触发物品搜索。
- Shift + 右键单击商品：执行买入操作。系统将自动购买单价不高于您所设“扫货价”的物品。
第四步：在卖出模式下，无限价限制
当您处于“卖出”模式时，需勾选：更多功能 --> 更多设置 --> 快速上架。
- 执行卖出操作（仅卖出模式下）：
- Shift + 左键单击游戏内商品：触发物品搜索。
- Shift + 右键单击商品：触发卖出，默认价格为当前最低价 -1铜。
- 扫货价：如需同时扫货，填写最高买入价，系统将买入不高于此价格的物品。
- 成本价：如需限制最低售价，填写成本价，系统将拒绝低于此价格的卖出。
- 取消：若发现低价且设置了下架信息，系统将自动下架您的物品。
第五步：在买与卖模式下
同时执行买入与卖出的逻辑，系统将根据您设置的价格阈值智能决策。
第六步：钓鱼（防压价）设置
勾选【我要钓鱼】后，需设置鱼饵金额、鱼饵数量、频率、排行及不吃鱼饵规则。
- 若未勾选【不吃鱼饵】，系统将买入任意低于扫货价格的对应物品。
- 鱼饵频率：例如设置为 1，则间隔 1 分钟。期间若物品被买走则不上架，若物品仍存在也不上架。
- 鱼饵数量：堆叠数少于该数值的物品将被视为鱼饵，系统将不买入（或根据排行/金额规则买入）。
- 鱼饵金额：例如设置为 2（金）。若该物品虽小于指定数量但单价较高，同样执行买入。
- 鱼饵排名：若堆叠数小于设置值的商品数量已有足够鱼饵，系统将对排名之外的符合条件的商品执行买入。
第七步：付费取信设置与邮件配置
1. 路径：工具箱 -- 邮件助手 -- 勾选“付费取信” 2. 在配置编辑器中设置回收价格。
使用此功能需自行在模块内配置收件人列表。如有多个收件人，请按格式添加。如需配合付费取信使用，请自行严格测试，不排除因游戏卡顿导致发送异常的可能，风险需自行承担。
新增功能：生产队列
点击“增减”来添加或减少制作数量，点击“x”删除数量，点击首个勾选框可前置显示。 点击“开始制作”即可一键制作，快捷键为 F7（注：分解中心快捷键同为 F7）。
一键选矿流程：打开邮箱与分解窗口，持续按 F7，背包满后将自动邮寄物品，并过滤掉设定的矿石。邮寄目标需提前在邮寄列表中设置。
默认情况下 只显示 材料齐备并且 冷却完成的 技能，如果需要显示全部，勾选 【显示所有配方】
勾选Auto会自动刷新列表。
勾选 “制造”，对应配方会 自动出现在 分解中心 方便一键制作。
新增功能：分组复制
右击 列表中的物品，有一个 复制到 菜单，方便分组管理。
总结与提示
QuickSnipe 框架通过简化的右键模式切换和直观的限价设置，大幅提升了手动交易的效率和可控性。建议初次使用时，先添加少量商品进行测试，熟悉操作流程后再应用于大批量交易，以确保资产安全。
