Steam 消费历史分类器 (Steam Spending History Classifier) 使用手册
版本：2.1.24
适用页面：https://store.steampowered.com/account/history
作者：SmallFork
开源许可：MIT
📦 概述
Steam 消费历史分类器 是一款专为 Steam 账户消费历史页面设计的增强型用户脚本。它能自动识别并分类每笔交易（直购、内购、送礼、退款、充值、市场买入/卖出），提供多维度统计分析、可视化图表、转区 CD 查询、送礼额度计算、商店折扣统计以及内购分析等高级功能，帮助您全面掌握 Steam 钱包收支情况。
脚本完全在本地处理数据，不收集任何个人信息，所有统计均基于页面已加载的消费记录。
✨ 主要功能
| 功能模块 |
简要说明 |
| 自动分类 |
根据交易描述识别类别：直购、内购、送礼、退款、充值、市场买入/卖出 |
| 统计看板 |
顶部卡片显示各类交易笔数及金额（主货币），点击卡片筛选对应类别 |
| 搜索与分页 |
按物品名称搜索，支持分页浏览和“显示全部”模式 |
| 主货币切换 |
自动检测页面主货币，可手动切换，所有统计自动更新 |
| 次级货币统计 |
展开显示其他货币的交易汇总（按币种及支付方式） |
| 数据导出 |
一键导出为 CSV 或 JSON 格式 |
| 消费分类占比图 |
环形图同时展示笔数和金额占比（仅限商店消费类） |
| 收支柱状图 |
对比支出（商店、内购、送礼、市场买入）与收入（市场卖出、充值、退款） |
| 转区 CD 查询 |
自动检测历史货币变更记录，计算转区冷却期剩余天数，点击记录可跳转 |
| 送礼额度计算 |
基于商店消费、退款、已送礼金额计算剩余可用额度，支持滑块模拟调整 |
| 商店折扣统计 |
统计主货币直购订单的折扣分布、平均折扣、节省总额，列出原价购买明细 |
| 内购分析 |
按游戏汇总内购物品、购买次数、总花费，支持展开查看明细 |
| 键盘快捷键 |
快速打开各图表窗口及筛选操作 |
🖥️ 界面与使用指南
1️⃣ 安装与首次加载
- 在 Tampermonkey 或 Violentmonkey 中安装脚本后，访问 Steam 消费历史页面 即可生效。
- 脚本会自动加载当前页面的所有消费记录（支持“加载更多”按钮自动点击）。
- 加载完成后，页面顶部会出现筛选工具栏，原表格上方增加统计卡片和操作按钮。
2️⃣ 统计卡片与分类筛选
- 卡片从左到右：
全部、直购、内购、送礼、退款、充值、买入、卖出。
- 每个卡片显示该类别的交易笔数，单击卡片可筛选显示该类别（再次点击“全部”恢复）。
- 卡片主区域点击可在“笔数”和“金额”视图间切换，方便查看不同维度的统计。
- 统计卡片右侧有一个展开按钮（▸），点击可展开次级货币统计行，显示非主货币的交易汇总（按币种和支付方式分组）。
3️⃣ 搜索与分页
- 搜索框：位于页面标题右侧，输入物品名称即可实时过滤（支持模糊匹配）。
- 分页控件：位于工具栏右侧，包含上一页/下一页、页码输入框、总页数。
- “显示全部”按钮：点击后切换至显示全部模式（所有记录一次性展示，分页禁用）。再次点击恢复分页。
4️⃣ 主货币切换
- 页面顶部（“点击加载更多历史记录”提示旁）会显示当前主货币标识（国旗+符号）。
- 单击该标识，会弹出下拉菜单，列出所有在消费记录中出现过的货币。
- 选择任意货币，脚本将立即切换主货币，所有金额统计和图表将自动更新为所选货币。
- 切换后，后续页面刷新会记住选择（除非手动清除缓存）。
5️⃣ 数据导出
- 点击工具栏中的导出按钮（下载图标）弹出下拉菜单，选择 CSV 或 JSON。
- 导出的数据包含：日期、物品名称、操作类型、分类、总金额、钱包变更、支付方式及金额（最多三种）。
- 文件名自动包含时间戳（如
steam-history-2026-08-06_15_30_00.csv）。
6️⃣ 统计图表窗口（核心数据分析）
脚本提供了六个可独立打开的统计窗口，每个窗口均支持导航侧边栏，方便在窗口间快速切换。
🔵 消费分类占比 (D 键)
- 仅统计“商店消费”类（直购、内购、送礼），环形图同时展示笔数占比和金额占比。
- 图例显示各类别的具体数值。
🟣 收支柱状图 (B 键)
- 左侧柱状图：支出类（直购、内购、送礼、市场买入）。
- 右侧柱状图：收入类（市场卖出、充值、退款）。
- 数值均以主货币显示。
🟠 转区 CD 查询 (R 键)
- 自动分析历史记录中的货币转换事件，检测最近一次货币变更日期。
- 显示当前货币、转区前货币、变更日期、CD 到期日。
- 以环形进度条直观展示冷却进度，剩余天数醒目显示。
- 历史记录表格：列出所有货币变更记录（含日期、旧货币→新货币、间隔天数）。点击任意历史行，脚本会自动跳转到对应的消费记录行并高亮。
🟢 送礼额度计算 (G 键)
- 公式：剩余额度 = 商店直购总额 - 退款总额 - 已送礼总额。
- 显示四项关键数据：商店直购、退款、总可用额度、已送礼（全部）。
- 环形图展示剩余、已送礼、退款占比，并显示剩余额度数值。
- 滑块功能：可调整“已送礼(30天内)”金额，模拟不同送礼策略，图表和数值实时联动。
- 当剩余额度为负时，自动显示“已经超额”状态。
🟡 商店折扣统计 (K 键)
- 仅统计主货币的直购订单（排除内购、送礼等）。
- 显示：直购笔数、原价购买笔数、平均折扣率、商店实付总额、节省总额。
- 平均折扣进度条直观展示折扣深度。
- 折扣区间分布柱状图：按 0%、10%、20%…90% 分档，统计各区间订单数量。
- 原价购买明细：点击“原价购买”卡片，弹出窗口列出所有未打折的原价购买记录，支持按是否退款筛选，退款项目带有标记。
🔷 内购分析 (I 键)
- 汇总所有主货币的内购记录，按游戏分组。
- 每个游戏显示：内购物品种类数、总购买次数、总花费、均价（总花费/总次数）。
- 游戏列表按总花费降序排列，前三名高亮显示。
- 点击任意游戏行，可展开查看该游戏下每个物品的购买次数、总花费、均价。
- 顶部三张卡片汇总：物品种类数、总购买次数、内购总花费。
7️⃣ 快捷键
| 按键 |
功能 |
D |
打开消费分类占比图 |
B |
打开收支柱状图 |
R |
打开转区 CD 查询 |
G |
打开送礼额度计算 |
K |
打开商店折扣统计 |
I |
打开内购分析 |
C |
重置筛选为“全部”类别 |
S |
聚焦到搜索框（并选中内容） |
N |
下一页（分页模式下） |
P |
上一页（分页模式下） |
Esc |
关闭当前打开的模态框 / 取消输入框焦点 |
注意：快捷键在焦点处于输入框、下拉菜单或文本区域时不会触发（S 键例外，它会自动聚焦搜索框）。
⚙️ 高级设置（代码内可调参数）
脚本顶部 配置常量 区域包含可自定义参数：
| 参数 |
默认值 |
说明 |
CD_DAYS |
90 |
转区冷却天数 |
PAGE_SIZE |
30 |
每页显示记录数 |
DEBOUNCE_MS |
200 |
搜索输入防抖延迟 |
SETTLE_MS |
300 |
加载更多后稳定等待时间 |
SAFETY_TIMEOUT |
5000 |
加载超时保护 |
🔒 隐私与安全
- 脚本不收集任何个人数据，所有数据仅在本地处理。
- 主货币切换依赖页面已有的消费记录，不会向外部发送任何请求。
- 转区 CD 查询仅基于本地消费历史分析，不涉及 Steam API 调用。
- 所有图表和统计均为纯前端计算，无数据外传。
❓ 常见问题 (FAQ)
Q：为什么某些交易被归为“其他”？
A：脚本根据交易描述中的关键词匹配，若无法匹配到任何已知类别（如“市场交易”但钱包变更不含正负号），则归为“其他”，在表格中隐藏。您可以检查该条目的描述文本是否标准。
Q：主货币切换后，次级货币统计为何不显示？
A：次级货币统计只显示在切换后的主货币以外的其他货币交易。若某货币没有交易记录，则不会出现在列表中。
Q：转区 CD 查询没有显示任何历史记录？
A：这可能是因为您的账户从未发生过货币转换，或者转换记录被过滤掉了（例如仅充值卡兑换未触发实际货币变更）。脚本会尽量从消费记录中推断转换事件，若无则显示“未发生任何转区”。
Q：送礼额度中的“已送礼(30天内)”是什么意思？
A：该数值取自分类为“送礼”的交易总金额（脚本中目前未做30天限制，实际为所有送礼记录总和）。滑块允许您调整该数值，以模拟不同送礼策略对剩余额度的影响。
Q：折扣统计没有显示任何数据？
A：折扣统计仅针对主货币的“直购”订单，且要求订单中包含原价和折后价信息（即 wht_base_price 列有 wht_discounted_price 子元素）。若无此类订单，则相关统计为零。
Q：页面加载很慢，如何处理？
A：脚本在加载时会自动点击“加载更多”按钮以获取全部历史记录。如果记录非常多，建议耐心等待。您也可以手动滚动到底部点击“加载更多”，脚本会辅助处理。若仍过慢，可调高 SAFETY_TIMEOUT 值。
📜 开源与反馈
- 主页：Keylol 论坛发布帖
- GitHub：脚本通过 GreasyFork 托管，欢迎提交 Issue 或 PR。
- 更新：脚本会自动检查更新（通过 GreasyFork 的
@updateURL）。
本手册依据脚本源码 v2.1.24 编写，如有变更请以实际界面为准。
Happy spending tracking! 🛒
