sglv-shelf | ScriptCat

S

sglv-shelf

•

创建于 8 天前

•

更新于 6 天前

Steam 商店全域可达的「暂存箱」——把暂时不想买/想买但现在不买的 * 商品、愿望单项、外部链接与备忘统一暂存，随时查看与恢复。

#Steam

#购物车

#愿望单

#暂存箱

数据统计

总安装量

55

近 24 小时

+6

用户评分

-

广告

paperbuddy

描述

版本

评分0

权限说明

为 Steam 商店提供暂存箱，统一管理暂存商品、愿望单与备忘。

加载中…

// @require https://scriptcat.org/lib/8457/1.1.2/sglv-shelf.js?sha384-SOzjWpAONDcgs/mFVFGypGtB82b1yvMTqDq8cmx1rhUBKLX0AD7JUJhA/gPkNOUr

数据统计

总安装量

55

近 24 小时

+6

用户评分

-

库详情

这是一个用户脚本使用的库，你可以在你的脚本中直接引用它。

许可协议

未声明

未声明协议，他人引用需谨慎

SGLV 暂存箱库 (sglv-shelf)
定位：Steam 商店全域可达的「暂存箱」——把暂时不想买/想买但现在不买的

  商品、愿望单项、外部链接与备忘统一暂存，随时查看与恢复。

与 Steam-Cart-Enhanced.js（购物车增强）的关系
共享 localStorage['sce_cart_shelf_v1']，即「购物类」记录（kind =
app/bundle/package）双向互通：SCE 暂存的项在 SGLV 浮窗可见，SGLV 从
购物车暂存的项在 SCE 暂存架可见。用户未安装 SCE 时该 key 由本库独享，
行为完全一致，无需任何配置。
为什么 wishlist/note 不写进同一个 items 数组
SCE 的 loadShelf() 过滤条件为

it.id && (it.appid || it.bundleid || it.packageid || appids.length)

且 saveShelf() 用过滤后的 shelf.items 整体重写 items 数组。
若把备忘录/外部链接塞进同一数组，用户一旦在购物车页使用 SCE 暂存，
这些记录会被 SCE 静默丢弃（无 appid/bundleid/packageid）。
故采用双桶：

INTEROP_KEY = 'sce_cart_shelf_v1'   购物类，与 SCE 互通（有损风险 0）

EXTRA_KEY   = 'sglv_shelf_extra_v1' 愿望单/备忘，本库独享

读取时合并为统一视图，写入时按 kind 路由，用户感知不到分桶。
扩展字段安全性
顶层未知字段（如自定义 meta）会被 SCE 的 saveShelf 丢弃，故所有扩展
一律挂在「记录级」字段上——SCE 只改写它认识的字段，记录级扩展可无损
往返。写入互通桶时保留 days/tab 等 SCE 需要的顶层键（Object.assign 合并）。
能力边界（诚实声明）
· 恢复（加购）走 AddItemsToCart/v1，全站可用，但依赖当前登录账号：
记录写入时记 steamid，恢复前校验，不匹配直接拒绝（参考脚本无此保护，
跨账号会静默加到错误账号的购物车）。
· 暂存（移出购物车）没有官方 API，只能点 Steam 自己的「移除」按钮，
因此仅在 /cart 页可用（与 SCE 同一约束）。其他页面按钮置灰并给跳转。
· 愿望单不提供移除 API，故 wishlist 记录只做「打开/定位 + 记录管理」。
· 折扣到期时间 endTs 仅当记录带有该字段时显示倒计时（由 SCE 写入）；
本库从购物车暂存时不主动拉折扣数据。
桥接契约（宿主注入，见 init(ShelfHost)）