全球市场界面
全球市场界面组包含七个配置文件，覆盖全球市场的主列表、详情页、比价、分类、搜索、排序和上架管理。
全球市场商品列表（global_market_item.yml）
global_market_item.yml 主要控制列表中每个挂单物品的展示模板；主界面的 layout 与 icons 实际来自 shop/global_market.yml。当前默认主界面展示所有在售挂单，并提供分类、属性筛选、排序、卖家筛选状态和我的上架入口。
title: '&0全球市场'
layout:
- '#########'
- ' g g g g '
- ' g g g g '
- '#########'
- 'PCFSLU#BN'
布局字符
| 字符 | 含义 |
|---|---|
g | 商品槽位（默认 28 个，4 行展示，数量由 shop/global_market.yml -> layout 决定） |
P | 上一页 |
C | 分类菜单 |
F | 属性筛选菜单 |
S | 排序菜单 |
L | 卖家筛选状态 / 清除卖家筛选 |
U | 我的上架 |
B | 关闭界面 |
N | 下一页 |
图标动作
| 图标 | 左键 |
|---|---|
P | page pre |
C | malkuth global_market category |
F | malkuth global_market filter |
S | malkuth global_market sort |
L | malkuth global_market clear_seller_filter |
U | malkuth global_market upload |
B | menu close |
N | page next |
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 物品描述 |
{seller} | 卖家名称 |
{price} | 当前挂单价格；整批购买模式下表示整批总价 |
{listing_price} | 挂单原始价格 |
{avg_price} | 近期 24 小时均价或成交总价 |
{stock} | 库存数量 |
{category} | 当前挂单分类显示名；分类未启用时为空 |
{category_id} | 当前挂单分类 ID |
{expire_time} / {expire_remaining} | 到期时间与剩余时间 |
{tax_rate} / {tax_amount} / {seller_income} | 税率、税费与卖家实收 |
{action_hint} | 动态操作提示（左键购买/右键详情等） |
全球市场详情页（global_market_detail.yml）
功能最丰富的单页界面，用于查看挂单详情、收藏、比价、搜索同类、改价、购买/下架。
title: '&8全球市场详情 &7{name}'
layout:
- '#########'
- '##I#g#A##'
- '#F#C#S#P#'
- '###Y#D###'
- '####B####'
布局字符
| 字符 | 含义 |
|---|---|
I | 商品信息（卖家、价格、库存、时间、均价、来源、收藏状态） |
g | 商品展示 |
A | 上架信息（挂单 ID、材质、是否自己挂单） |
F | 收藏/取消收藏 |
C | 同类比价 |
S | 搜索同类（左键按名称、右键按来源） |
P | 修改价格 |
Y | 购买（若为自己的挂单则行为变化） |
D | 下架 |
B | 返回市场列表 |
图标动作
| 图标 | 左键 | 右键 |
|---|---|---|
F | malkuth global_market favorite | — |
C | malkuth global_market compare | — |
S | malkuth global_market search_similar | malkuth global_market search_source |
P | malkuth global_market edit_price | — |
| 续期按钮 | malkuth global_market renew | — |
Y | malkuth global_market confirm | — |
D | malkuth global_market delist | — |
B | menu back | — |
标题变量
| 变量 | 说明 |
|---|---|
{name} | 物品名称 |
商品信息图标变量
| 变量 | 说明 |
|---|---|
{seller} | 卖家名称 |
{price} | 当前单价 |
{stock} | 当前库存数量 |
{listed_time} | 格式化后的上架时间（由 detail.date-format 控制） |
{avg_price} | 最近 24 小时均价；无数据时显示语言文件默认文本 |
{source_id} | 识别到的来源 ID；关闭 show-source-id 时为空 |
{favorite_state} | 当前收藏状态文本 |
{expire_time} | 挂单到期时间 |
{expire_remaining} | 挂单剩余时间 |
{renew_enabled} | 是否启用续期 |
{renew_available} | 当前挂单是否可续期 |
{renew_cost} | 续期费用 |
{renew_count} | 当前已续期次数 |
{renew_max_times} | 最大续期次数 |
{renew_cooldown_remaining} | 续期冷却剩余时间 |
{renew_state} | 续期状态文本 |
{tax_rate} | 最终税率百分比 |
{tax_amount} | 税费金额 |
{seller_income} | 卖家实收金额 |
上架信息图标变量
| 变量 | 说明 |
|---|---|
{listing_id} | 当前挂单唯一 ID |
{material} | 物品材质 |
{is_own} | 是否为自己的挂单 |
提示
详情页没有单独的"打开详情"动作指令，而是由列表点击语义控制：别人商品默认左键购买、右键详情；自己的商品默认右键详情，左键行为由 detail.own-left-action 决定，Shift + 左键 固定走下架确认。
全球市场同类比价（global_market_compare.yml）
展示与指定挂单同类物品的其他挂单列表，支持分页浏览。
title: '&8全球市场比价 {page}/{max-page}'
layout:
- '#########'
- 'ggggggggg' # x4 行
- 'P###B###N'
布局字符
| 字符 | 含义 |
|---|---|
g | 比价商品槽位（共 36 个，4 行） |
P | 上一页 |
B | 返回详情 |
N | 下一页 |
| 图标 | 左键 |
|---|---|
P | page pre |
N | page next |
B | menu back |
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 物品描述 |
{seller} | 卖家名称 |
{price} | 当前单价 |
{stock} | 当前库存 |
{listed_time} | 格式化上架时间 |
{source_id} | 来源 ID |
{match_type} | 匹配方式：current（当前挂单）、source_id、display_name 或 material |
{page} | 当前页码（用于标题） |
{max-page} | 最大页数（用于标题） |
全球市场分类选择（global_market_category.yml）
分类菜单用于按 shop/global_market.yml -> categories.groups 选择分类。
title: '&0选择分类'
layout:
- '#########'
- 'A c c c U'
- ' c c c c '
- '#########'
- '####B####'
布局字符
| 字符 | 含义 |
|---|---|
A | 全部商品 |
c | 自定义分类槽位 |
U | 未分类 / 其他商品 |
B | 返回全球市场 |
# | 填充 |
图标动作
分类槽位由系统代码绑定点击逻辑，不需要在 icons 中配置动作。
| 图标 | 左键 |
|---|---|
A | 切换到全部商品 |
c | 切换到对应分类 |
U | 切换到未分类商品 |
B | 返回全球市场 |
可用变量
| 变量 | 说明 |
|---|---|
{count} | 当前分类下的挂单数量 |
{category_id} | 分类 ID；全部商品为 all，未分类为系统内置 ID |
{category} | 分类显示名 |
全球市场搜索菜单（global_market_search.yml）
搜索菜单用于统一处理关键词搜索、卖家搜索和清除筛选。
title: '&0全球市场搜索'
layout:
- '#########'
- '##K#S#C##'
- '####B####'
布局字符
| 字符 | 含义 |
|---|---|
K | 物品关键词搜索 |
S | 卖家搜索 |
C | 清除关键词、卖家、属性、分类与排序 |
B | 返回 |
# | 填充 |
图标动作
| 图标 | 左键 |
|---|---|
K | malkuth global_market search_keyword |
S | malkuth global_market search_seller |
C | malkuth global_market clear_all_filters |
B | menu back |
可用变量
| 变量 | 说明 |
|---|---|
{search_keyword} | 当前关键词；未设置时显示语言文件中的“无” |
{seller_filter} | 当前卖家筛选；未设置时显示语言文件中的“无” |
全球市场属性筛选菜单（内置布局）
属性筛选菜单由源码按 shop/global_market.yml -> filters.attributes 动态生成，不单独读取一个 UI 文件。第一层展示每个筛选维度、清除筛选和搜索入口；第二层展示该维度的关键词，并提供升序、降序、清除排序和返回。
| 内置按钮 | 行为 |
|---|---|
| 筛选维度 | 进入该维度关键词选择页 |
| 清除筛选 | 清空当前属性筛选与属性排序 |
| 搜索 | 打开 global_market_search.yml 搜索菜单 |
| 关键词 | 设置该维度的当前关键词 |
| 升序 / 降序 | 按当前维度命中的 Lore 行排序 |
| 清除排序 | 只清除该维度排序，保留筛选关键词 |
全球市场排序菜单（global_market_sort.yml）
选择全球市场商品列表的排序方式。
title: '&0排序方式'
layout:
- '#########'
- '#p#r#i#c#'
- '####e####'
布局字符
| 字符 | 含义 |
|---|---|
p | 价格升序 |
r | 价格降序 |
i | 名称升序 |
c | 名称降序 |
e | 清除排序 |
messages 自定义
messages:
selected_marker: '&a✔ 当前选中'
| 消息键 | 说明 |
|---|---|
selected_marker | 当前选中项的标记文本，替换 {selected} 变量 |
排序图标使用 {selected} 变量动态标记当前选中项，无显式 actions（由系统代码绑定排序逻辑）。
全球市场上架管理（upload_global_market.yml）
管理自己已上架挂单的界面。
title: '&0管理我的商品'
layout:
- '#########'
- ' g g g g '
- ' g g g g '
- '#########'
- '###U###B#'
布局字符
| 字符 | 含义 |
|---|---|
g | 已上架商品槽位（共 8 个，分两行） |
U | 上架新商品 |
B | 返回 |
| 图标 | 左键 |
|---|---|
U | malkuth global_market upload |
B | menu back |
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 物品描述 |
{price} | 价格 |
{amount} | 数量 |