使用手册
记录，说明清楚。
本知识库涵盖 Golden Stallion 生态系统中面向玩家的所有功能：Discord 机器人命令、仪表板流程、通知、支持、市场术语,以及普通用户与服务器管理员之间的区别。
01
从这里开始
新用户快速入门
如果您刚接触这个生态系统，以下是从首次登录到日常使用的最快步骤。
- 1
1. 使用 Discord 登录
使用仪表盘登录流程，以便同一 Discord 身份关联您的仪表盘和机器人使用。
- 2
2. 打开投资组合
查看您的持仓，标记重要物品，并将仪表盘用作您的长期工作区。
- 3
3. 在 Discord 中使用机器人
使用 /price、/history、/watchlist、/settings、/support 和 /suggest 实现快速的服务器内工作流。
- 4
4. 需要时使用支持
从 Discord 或仪表盘开启工单。两者都汇入同一个工作人员处理流程。
02
实时页面
可视化演练
打开实时的 Market Observatory 和 Catalog Archive，直观了解公开记录。这个永久锚点不再展示模拟的产品截图。
03
工作区
如何使用仪表板
仪表盘是您用于合集管理、价格追踪、支持和通知偏好的长篇工作区。
投资组合
打开 →追踪持仓、查看洞察卡片、编辑数量，并为您的合集构建更清晰的视图。
- 标记物品以将其加入您的关注列表。
- 将投资组合用作主要的长篇工作区，而非 Discord 聊天。
- 当您返回该标签页时会悄然刷新。
支持
打开 →提交支持请求、监控状态、上传附件，并在支持团队回复后发送追加消息。
- 与 Discord 支持提交共享同一工作流。
- 在初始消息和仪表盘追加消息上均支持附件。
- 显示时间线、状态、关闭原因和完整的会话上下文。
知识库
打开 →使用本指南了解入门、命令参考、支持规则、术语表和角色指引。
- 包含快速入门、角色指引、常见问题、术语表和路由状态。
- 如果不确定某个功能在哪里，这里是最佳的第一站。
- 现在包含搜索、角色筛选和可展开的命令卡片。
关注列表
打开 →在一处查看您当前追踪的所有内容，附带实时价格和状态标识。
- 在 Discord（/watchlist）和仪表盘之间镜像同步。
- 每个账户最多 50 个物品。
- 当 /settings 已启用私信时，会驱动关注列表私信。
设置
打开 →在一处控制语言、Discord 私信偏好和仪表盘通知行为。
- 切换关注列表、价格提醒和支持私信。
- 更改 UI 语言——会在此设备上记住。
- 对于私信开关，与 Discord 中的 /settings 完全相同。
仪表板路由当前状态
主要持仓与合集工作区。
您当前正在追踪的所有内容的列表。
语言和私信通知偏好。
您近期活动的概要快照。
工单、时间线、附件和追加消息。
此帮助中心。
路由已存在，但面向用户的内容尚未构建完成。
路由已存在，但仍显示占位内容。
显示在标签页中，但尚无实时页面。
供价格更新员使用的运营控制台——普通用户不可见。
04
命令
如何使用 Discord 机器人
机器人最适合快速的服务器内工作：实时价格查询、关注列表管理、支持受理、通知偏好和服务器级配置。将阅读焦点设置为“普通用户”或“管理员”，即可仅查看适用于您的命令。
普通用户 (9)
任何有权使用机器人的成员均可使用的命令。
/price用户价格查询某个物品的当前价格区间。适用于 Golden Stallion 目录中已索引的任何物品。
参数
query——物品名称。输入两个或更多字符后，自动补全会提供建议。
发生的事情
如果只有一个物品匹配，机器人会公开发布价格卡片，并附带“价格历史”按钮。如果多个物品匹配，您可从私密下拉菜单中选择。如果物品有变体（例如宠物等级），机器人会私下询问您选择哪一个，然后再发布。
提示
变体选择器和多匹配选择器均为临时消息（只有您能看到）——最终的价格卡片才是公开发布的那张。
/vends search用户Vends查找某个精确目录物品当前所有已确认的摊位报价；如果该物品已发布，还会提供其规范 Item Intelligence。
参数
item——从自动补全中选择一个精确的目录身份。含糊或近似的自由文本会打开私密选择界面，而不会选取第一个子字符串匹配项。
发生的事情
机器人会精确匹配已解析的目录名称，然后返回价格、数量、摊主、商店、数据新鲜度、排序、分页和 realm 访问控件。公开物品链接在翻页和排序时始终保留。
提示
缺少公开 slug 或仪表板 URL 时，仅移除 Item Intelligence 链接；摊位搜索仍可正常使用。
/history用户价格查看某个物品最近 10 条记录的价格快照。
参数
item——带自动补全的物品名称。解析为第一个匹配项。
发生的事情
机器人会返回一个按日期从旧到新排列的快照列表，附带状态图标（上涨、下跌、稳定、不稳定）以及每个时间点记录的价格区间。
提示
您也可以通过附加在任意 /price 卡片上的“价格历史”按钮访问此功能。
/watchlist list用户关注列表显示您个人关注列表中当前的所有物品。
参数
无参数。始终私密响应。
发生的事情
机器人会返回一个临时卡片，列出每个关注物品、当前价格区间和市场状态标识。
/watchlist add用户关注列表将某个物品加入您的关注列表，以便追踪并（可选）接收更新私信。
参数
item——物品名称，由自动补全驱动。如果多个物品匹配，您可从私密下拉菜单中选择。
发生的事情
机器人会将该物品写入您的关注列表并私下确认。您最多可追踪 50 个物品。
提示
结合 /settings 来决定关注列表更新是否也会在 Discord 上私信您。
/watchlist remove用户关注列表通过私密选择器从您的关注列表中移除某个物品。
参数
无文本参数——您从下拉菜单中的当前条目里选择。
发生的事情
机器人会移除所选物品并私下确认变更。
/settings用户偏好通过交互式按钮查看和切换您的通知偏好。
参数
无参数。打开一个带有四个开关的临时卡片。
发生的事情
仪表板设置可控制关注列表、价格提醒、客服和售货机扫描的 Discord 私信与应用内投递。每日或每周频率会合并关注列表和价格提醒私信；客服与主动请求的扫描结果仍会即时发送。
提示
如果私信未送达，请再次确认您的隐私设置中已启用接收来自服务器成员的 Discord 私信。
/support用户支持从 Discord 任何位置向 Golden Stallion 团队提交支持请求。
参数
打开一个表单：游戏内昵称、消息（20–2000 个字符）和类别下拉菜单（Bug 报告、价格争议、账户问题、一般问题、其他）。
发生的事情
提交后，工单进入共享的工作人员审核队列。您最多可同时拥有 4 个开启的工单。
提示
您也可以从仪表盘的“支持”页面开启工单——两种流程都汇入同一个队列。
/suggest用户贡献为某个物品提交价格变动建议。工作人员会在专属频道中审核建议。
参数
item——带自动补全的物品名称。随后弹窗会询问最低价和最高价（cubits）、建议状态以及理由（10–1000 个字符）。
发生的事情
您的建议会发布在建议频道供工作人员审核。社区反馈（赞成／反对）会被记录并附加到该建议上。
提示
充分的理由能让您的建议更容易被采纳——尽可能附上近期的成交证据。
机器人如何与您交流
您在使用机器人命令时会遇到的交互式 UI 模式的快速参考。
自动补全
物品和操作字段会在您输入时建议匹配项——输入两个或更多字符即可看到结果。
临时消息
选择器、确认操作和私密状态均为临时消息——在频道中只有您能看到。
变体选择器
当物品有变体（例如宠物等级）时，机器人会私下询问您选择哪个变体，然后再公开发布价格卡片。
弹窗
/support 和 /suggest 会打开表单式弹窗，让您无需内联输入参数即可提交结构化文本。
按钮与开关
/settings 使用切换按钮，/price 卡片包含一个“价格历史”按钮，可获取最近十条快照。
私信调度器
私信送达是尽力而为的：它取决于调度器是否在线以及您的 Discord 私信设置是否允许机器人向您发送消息。
05
公开记录
物品情报
每份已发布的物品档案都会汇集选定的聚合估值、覆盖状态、数据新鲜度、历史记录和公开报价证据。未定价结果是一种如实呈现的状态，而不是编造的估值。
06
证据质量
估值置信度
置信度描述的是选定的聚合估值快照，并用于判断物品能否作为市场机会出现。它不属于任何单条报价，也不是概率或保证。
07
观测证据
公开报价
公开报价是从可发布 realm 保留的观测记录，并如实显示数据新鲜度和排除情况。单条报价可以成为有用的证据，但不会拥有自己的估值置信度分数。
08
准入条件
市场机会
市场机会是衍生的价差工具，只有在通过估值、数据新鲜度、覆盖范围和证据质量门槛后才会出现。它们只是信息线索，绝不承诺利润或可用性。
09
价格阅读
市场状态以及如何阅读价格卡片
整个生态系统中的价格均按市场状态分类，以标示价格当前的走势。学会这些图标即可一眼读懂卡片。
稳定
价格保持平稳。没有任何异常情况。
上升
在最近的快照中价格呈上涨趋势。
下降
在最近的快照中价格呈下跌趋势。
不稳定
价格波动或不规律。处理这些数值时请格外谨慎。
价格卡片的构成
每张价格卡片告诉你的远不止一个数字。以下是需要留意的内容。
价格区间
以最低价–最高价 cubits 的形式显示。若仅有一个数字，则表示最低价与最高价相等。
Cubits（货币）
Cubits 是游戏内货币。价格卡片上的数字旁会显示 Cubit 表情符号。
变体
宠物等物品可能有多个变体（例如按等级）。机器人会先询问您要为哪个变体定价，然后再发布。
展示卡片
价格卡片上的图片是一张生成的展示卡，以统一的样式呈现物品、其所属合集和元数据。
历史按钮
任意 /price 卡片上的“价格历史”按钮会私密地获取最近 10 条记录快照。
更新广播
在通过 /server_settings 选择加入的服务器中，工作人员的价格更新可广播到已配置的频道。
10
警报
通知、仪表板警报和 Discord 私信
通知行为因功能而略有不同。下表显示了每种事件使用的渠道以及在何处切换送达。
关注列表
关注列表更新遵循设置中的应用内和 Discord 私信选项。每日或每周频率会合并私信。
价格提醒
价格提醒遵循设置中的应用内和 Discord 私信选项。每日或每周频率会合并私信。
支持更新
客服更新遵循独立的应用内和 Discord 私信选项，并保持即时发送。
送达矩阵
每个个人事件渠道都遵循其已保存的设置。摘要频率只影响关注列表和价格提醒私信。
| 事件 | 仪表板 | Discord 私信 | 切换 |
|---|---|---|---|
| 关注列表价格更新 | 可选 | 可选 | /settings |
| 价格提醒已触发 | 可选 | 可选 | /settings |
| 支持工单更新 | 可选 | 可选 | /settings |
| 主动请求的售货机扫描结果 | 可选 | 可选 | /settings |
| 工作人员价格广播 | 服务器频道 | — | /server_settings |
11
帮助中心
支持系统的工作方式
支持在仪表盘和 Discord 之间共享。您可以从任一处开始，工作人员使用同一套统一的审核流程。
工单生命周期
已提交
从仪表盘或 Discord 机器人创建，并放入共享审核队列。
审核中
已由工作人员受理，或已开启为实时 Discord 工单频道。
已回复
工作人员已回复。您现在可以发送一条仪表盘追加消息。
已归档 / 已关闭
该工单已关闭，无法再接收回复或附件。
支持规则和限制
- 您最多可同时保留 4 个开启的工单。
- 支持团队回复后，您可以发送一条追加消息，然后须等待工作人员的下一次回复。
- 当存在实时工单时，仪表盘工单和仪表盘追加消息会镜像到 Discord 支持工作流中。
- 仪表盘流程中的初始消息和仪表盘追加消息均支持附件。
- 已归档的工单处于关闭状态，无法接收新的回复或附件。
- /support 消息长度须介于 20 到 2000 个字符之间，以便工作人员有足够的上下文提供帮助。
工单类别
您选择的类别有助于工作人员更快地分流。请选择最符合您请求的类别。
12
角色
谁能看到哪些工具
部分仪表盘控制台和机器人工具仅对拥有相应角色或 Discord 权限的用户显示。本节为面向用户的概要——工作人员的运营命令在此特意不予说明。
普通用户
可使用投资组合、关注列表、设置和支持功能，以及机器人命令：/price、/history、/watchlist、/settings、/support 和 /suggest。
服务器管理员
任何拥有 Discord 管理员权限的成员。新增 /server_settings（view、price_updates、set_channel）以配置服务器内的广播。
价格更新员
拥有价格更新运营控制台访问权限的工作人员角色。此级别的命令不在本指南范围内。
机器人所有者 / 管理员
拥有仅限所有者的控制台和破坏性操作访问权限的最高级工作人员。此级别的命令不在本指南范围内。
能力矩阵
一目了然地了解各级别用户在面向用户的产品中可执行的操作。
| 能力 | 普通用户 | 服务器管理员 | 工作人员 |
|---|---|---|---|
| 查询价格与历史 | 包含 | 包含 | 包含 |
| 管理个人关注列表 | 包含 | 包含 | 包含 |
| 提交价格建议 | 包含 | 包含 | 包含 |
| 使用仪表盘投资组合 | 包含 | 包含 | 包含 |
| 开启支持工单 | 包含 | 包含 | 包含 |
| 切换私信通知偏好 | 包含 | 包含 | 包含 |
| 配置各服务器广播 | 不包含 | 包含 | 包含 |
| 访问管理员仪表盘控制台 | 不包含 | 获授权时 | 包含 |
| 写入或编辑权威价格 | 不包含 | 不包含 | 包含 |
13
词汇
术语表
您将在仪表盘和 Discord 机器人中看到的 Golden Stallion 术语的简短定义。
- Cubits
- 游戏内货币。机器人和仪表盘中的价格均以 cubits 表示。
- 市场状态
- 对价格当前走势的分类：稳定、上涨、下跌或不稳定。
- 变体
- 物品的另一种版本——例如处于特定等级的宠物——它具有独立的价格。
- 关注列表
- 您正在追踪的个人物品列表，最多 50 个条目，用于通知和快速参考。
- 投资组合
- 您用于管理持仓和数量的仪表盘工作区。
- 分发器
- 负责发送 Discord 私信的机器人组件。仅在其在线且您的私信隐私设置允许时才会发送私信。
- 短暂消息
- 仅您可见的 Discord 消息，用于不适合出现在公开频道中的选择器和确认操作。
- 模态框
- Discord 内的弹出式表单。/support 和 /suggest 使用弹窗来收集结构化输入。
- 工单
- 单个支持请求及其持续的会话线程，跨仪表盘和 Discord 进行追踪。
14
答案
常见问题
点按任意问题即可展开。这些涵盖了用户在学习仪表盘和机器人时最常需要的说明。
我最多可以同时保留多少个开启的工单？
您最多可同时拥有 4 个开启的支持工单。
我可以在仪表盘而非 Discord 中开启支持吗？
可以。仪表盘支持请求与 Discord 机器人提交的请求进入同一套工作人员工作流。
我可以向支持上传文件吗？
可以。仪表盘支持在初始请求和仪表盘追加消息上均支持附件。
Discord 私信能保证送达吗？
无法保证。系统会尝试发送，但送达仍取决于 Discord 私信可用性以及机器人调度器是否在线。
我可以连续发送多条追加消息吗？
不可以。支持团队回复后，您可以发送一条追加消息，然后须等待工作人员的下一次回复。
每个仪表盘标签页和路由都已完全上线了吗？
尚未。投资组合、关注列表、设置、概览、支持和知识库均已上线。部分标签页（物品、市场、钱包）仍为占位内容。
我的关注列表最多可以放多少个物品？
每个账户最多 50 个物品，涵盖 /watchlist 和仪表盘两处。
如果我只用机器人来执行 /price，还需要 /server_settings 吗？
不需要。/server_settings 仅在您是服务器管理员且希望机器人在特定频道发布价格更新广播时才有用。
/price 和 /history 有什么区别？
/price 显示某个物品当前的价格区间和状态。/history 显示最近 10 条记录快照，以便您查看价格走势。
为什么 /price 有时会在发布前要求我先选择？
当您的搜索匹配到多个物品，或物品有变体（例如不同的宠物等级）时，就会出现这种情况。您先私下选择，然后最终的卡片才会公开发布。