gate-exchange-assets-manager

解析 gate-cli（二进制路径）

按以下顺序解析 gate-cli：(1) command -v gate-cli 和 gate-cli --version 均成功；(2) 如果 ${HOME}/.local/bin/gate-cli 可执行，则使用该路径；(3) 如果 ${HOME}/.openclaw/skills/bin/gate-cli 可执行，则使用该路径。规范规则：exchange-runtime-rules.md §4（或 gate-runtime-rules.md §4）。

Gate 账户与资产管理器

这是一个 L2 复合技能，可在 7 个 L1 技能中协调调用 58 次去重后的 MCP 工具（54 次读取 + 4 次写入）。它提供统一入口，用于查看账户和资产概况、评估保证金和强平风险、查看 SimpleEarn 和质押收益快照、查询联盟佣金，以及执行统一账户写入操作（借款、抵押品、杠杆设置）。 此技能仅面向年满 18 周岁且具有完全民事行为能力的用户。

通用规则

⚠️ 停止 — 继续之前，必须阅读并严格遵守共享运行时规则。 在读完所有规则之前，不得选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md

• 只能使用此技能中明确列出的 gate-cli 命令。 即使其他接口提供了这些工作流所需的命令，也不得运行此处未记录的命令。

技能依赖

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex alpha account balances
• gate-cli cex alpha market currencies
• gate-cli cex alpha market tickers
• gate-cli cex alpha market tokens
• gate-cli cex earn staking assets
• gate-cli cex earn staking awards
• gate-cli cex earn staking find
• gate-cli cex earn uni currency
• gate-cli cex earn uni interest
• gate-cli cex earn dual balance
• gate-cli cex earn dual orders
• cex_earn_list_structured_orders
• gate-cli cex earn uni currencies
• gate-cli cex earn uni rate
• gate-cli cex earn uni lends
• gate-cli cex earn staking orders
• gate-cli cex futures account get
• gate-cli cex futures market candlesticks
• gate-cli cex futures market contract
• gate-cli cex futures market funding-rate
• gate-cli cex futures market orderbook
• gate-cli cex futures market premium
• gate-cli cex futures market tickers
• gate-cli cex futures market trades
• gate-cli cex futures market liquidations
• gate-cli cex futures position list
• gate-cli cex margin account list
• gate-cli cex options account get
• gate-cli cex rebate broker commissions
• gate-cli cex rebate broker transactions
• gate-cli cex rebate partner commissions
• gate-cli cex rebate partner sub-list
• gate-cli cex rebate partner transactions
• gate-cli cex rebate user-info
• gate-cli cex rebate sub-relation
• gate-cli cex spot account get
• gate-cli cex spot market candlesticks
• gate-cli cex spot market orderbook
• gate-cli cex spot market tickers
• gate-cli cex spot market trades
• gate-cli cex spot account book
• gate-cli cex tradfi account assets
• gate-cli cex unified account get
• gate-cli cex unified query borrowable
• gate-cli cex unified query estimate-rate
• gate-cli cex unified mode get
• gate-cli cex unified query transferable
• gate-cli cex unified config leverage-get
• gate-cli cex unified config discount-tiers
• gate-cli cex unified account currencies
• gate-cli cex unified loan interest
• gate-cli cex unified loan records
• gate-cli cex wallet balance total

执行操作（写入）

• gate-cli cex unified loan create
• gate-cli cex unified config collateral
• gate-cli cex unified mode set
• gate-cli cex unified config leverage-set

身份验证

• **交互式文件配置：**如果主机上未同时设置 GATE_API_KEY 和 GATE_API_SECRET，请运行 gate-cli config init，完成 API 密钥、密钥、配置文件和默认值的设置向导（参见 gate-cli）。
• 环境变量 / 标志：如果已提供凭据，则无需运行 gate-cli config init——例如，主机上已同时设置 GATE_API_KEY 和 GATE_API_SECRET，或在支持的情况下使用 --api-key / --api-secret——绝不要要求用户在聊天中粘贴密钥。
• **权限：**Alpha:Read、Earn:Read、Fx:Read、Margin:Read、Options:Read、Rebate:Read、Spot:Read、Tradfi:Read、Unified:Write、Wallet:Read
• **门户：**请在聊天之外创建或轮换密钥：https://www.gate.com/myaccount/profile/api-key/manage

安装检查

• 必需项：gate-cli（如果缺失，请在此技能目录中运行 sh ./setup.sh；可选设置 GATE_CLI_SETUP_MODE=release）。
• 如果要按名称调用 gate-cli，请将 $HOME/.openclaw/skills/bin 添加到 PATH（或者添加 setup.sh 安装它的目录）。
• 凭据：如果主机上同时设置了非空的 GATE_API_KEY 和 GATE_API_SECRET，不要要求运行 gate-cli config init——这对 gate-cli 来说等效于有效配置。如果两者均未设置或为空，请提醒操作者运行 gate-cli config init，或在技能库中相应的技能内配置 GATE_API_KEY / GATE_API_SECRET（绝不要要求用户在聊天中粘贴密钥）。
• **基本检查：**在认证调用前，确认 CLI 行为符合预期（例如运行 gate-cli --version，或执行此技能中的只读 gate-cli cex ... 命令）；在执行更改操作前，确认凭据已正确解析。

执行模式

阅读并严格遵循 references/gate-cli.md，然后执行此技能中的模块路由。

• SKILL.md 保留了跨账户领域的编排 / 路由逻辑。
• references/gate-cli.md 是关于模块聚合、部分降级策略和统一更改操作安全措施的权威 gate-cli 执行规范。

子模块

模块	L1 来源	工具数量	读 / 写	用途
S1 资产 / 概览	gate-exchange-assets、gate-exchange-alpha	10+	只读	多账户余额全景
S2 风险 / 保证金	gate-exchange-unified、gate-exchange-marketanalysis	6+	只读	保证金率、清算价格、未实现盈亏
S3 Earn / 收益	gate-exchange-simpleearn、gate-exchange-staking	4	只读	当前 SimpleEarn 和质押仓位 / 利息快照
S4 联盟 / 返佣	gate-exchange-affiliate	7	只读	返佣用户信息（可能为空）、合作伙伴佣金历史、下级关系
S5 借款 / 转账（写入）	gate-exchange-unified	6	2 读 + 4 写	借款、设置抵押品、设置杠杆、切换模式

注意：TradFi 工具（来自 gate-exchange-tradfi，共 10 个只读工具）均为只读，用于资产清单查询。它们计入去重后的 58 个工具总数，但未在上方的子模块表中单独列为 L1 模块。

路由规则

设计原则

用户的查询通常涉及多个维度（例如，“检查我的 earn 利息，以及我是否会被清算”涵盖 S3 和 S2）。此技能不强制进行单一意图分类，而是采用信号叠加：分别从查询中检测 5 个信号维度，激活的维度各自贡献相应的工具集。最终工具集是所有已激活信号对应工具的并集，执行前会进行去重。

信号维度定义

信号	维度	触发条件	触发关键词	工具子集
S1	资产 / 概览	用户询问整体资产、多账户余额、资产清单；也包括只读的可借额度 / 利率查询（无执行意图）和可划转额度快照	资产、余额、账户、多少、总资产、清单；可借额度（仅查询）、可划转额度	gate-cli cex wallet balance total、gate-cli cex spot account get、gate-cli cex unified account get、gate-cli cex futures account get、gate-cli cex margin account list、gate-cli cex options account get、gate-cli cex earn uni lends、gate-cli cex earn staking assets、gate-cli cex alpha account balances、gate-cli cex tradfi account assets；查询子集：+ gate-cli cex unified query borrowable、gate-cli cex unified query estimate-rate、gate-cli cex unified query transferable
S2	风险 / 保证金	用户询问强平、保证金、强平价格、未实现盈亏、仓位风险	强平、保证金、强平价格、未实现盈亏、仓位、风险、追加保证金通知	gate-cli cex unified account get、gate-cli cex futures position list、gate-cli cex futures market tickers、gate-cli cex futures market contract、gate-cli cex futures market funding-rate、gate-cli cex futures market premium
S3	理财 / 收益	用户询问现有 SimpleEarn 或质押仓位、累计利息和奖励（仅查询快照，不涉及产品选择）	理财仓位、质押仓位、利息、收益、奖励	gate-cli cex earn uni lends、gate-cli cex earn uni interest、gate-cli cex earn staking assets、gate-cli cex earn staking awards（注意：不包括 list_uni_currencies / list_uni_rate / find_coin，这些是产品选择工具；此类请求会路由至 smart earn）
S4	联盟 / 返佣	用户询问联盟状态、合作伙伴数据、佣金	返佣、联盟、佣金、合作伙伴、经纪商、推荐	gate-cli cex rebate user-info、gate-cli cex rebate partner commissions、gate-cli cex rebate partner sub-list、gate-cli cex rebate partner transactions、gate-cli cex rebate sub-relation、gate-cli cex rebate broker commissions、gate-cli cex rebate broker transactions
S5	借款 / 划转（写入）	用户明确表达执行意图：借款金额、追加保证金、设置抵押品、切换模式。对于仅查询的请求（如“我能借多少”）或带有“暂时不要借”等否定表述的请求，不会触发此维度	借款 [金额]、追加保证金、划转至期货、设置抵押品、切换模式	gate-cli cex unified query borrowable、gate-cli cex unified query estimate-rate、gate-cli cex unified loan create、gate-cli cex unified config collateral、gate-cli cex unified mode set、gate-cli cex unified config leverage-set

路由流程

Input: User Query
Output: activated_signals[] + params{action_type, accounts[]}

1. Parameter Extraction
 Extract accounts[] (account types mentioned, 0-N)
 Extract action_type (borrow / transfer / add margin / setting / none)

2. Signal Detection (each dimension independent, non-exclusive, multi-select)
 S1 <- contains asset/balance/account/inventory expressions
 S2 <- contains liquidation/margin/position/risk expressions
 S3 <- contains earn/staking position/interest/rewards expressions
 S4 <- contains rebate/affiliate/commission/partner expressions
 S5 <- contains borrow/transfer/add-margin/setting expressions AND execution intent

3. Fallback Rules (if no signal explicitly activated)
 Vague account intent (e.g. "check my account") -> default S1 (asset overview)
 Account + risk keywords (e.g. "is it safe") -> default S1 + S2

4. Execution Mode
 S5 not activated -> read-only mode (query and summarise)
 S5 activated -> read+write mode (query -> Action Draft -> confirm -> execute)

5. Tool Set Assembly
 Tool Set = Union(all activated signal tool subsets)
 Deduplicate same tool + same parameters
 Independent tools run in parallel; S5 write operations run serially after reads

外部路由（范围外）

用户意图	路由至
交易执行（现货 / 期货开仓和平仓）	交易副驾技能
币种研究、市场分析、新闻	市场研究技能
闲置资金配置、产品选择、APY 对比	smart earn 技能
闪兑 / 币种兑换	闪兑技能
子账户管理	不在范围内
资产周报、跨周期分析	当前 API 不支持；引导用户查看 App 报告
所有业务线的总盈亏账本	数据源校准不可靠；按模块展示快照

路由示例表

用户查询	accounts	已触发信号	说明
“查看我的账户”	[]	S1（回退）	没有明确的维度关键词；回退到资产概览
“我有多少钱，会被强平吗？”	[]	S1 + S2	“多少钱”触发 S1，“强平”触发 S2
“我的统一保证金充足吗？”	[unified]	S2	“保证金”触发风险
“显示强平价格和未实现盈亏”	[]	S2	“强平价格 / 未实现盈亏”触发风险
“赚币和质押赚了多少钱？”	[]	S3	“赚币 / 质押 / 多少钱”触发收益
“我应该把闲置资金放进 SimpleEarn 还是质押？”	[]	—	路由到智能赚币；此技能不负责资金分配
“我有多少返佣？”	[]	S4	“返佣”触发联盟推广
“保证金不足，帮我追加保证金”	[]	S2 + S5	“保证金不足”触发 S2，“追加保证金”触发 S5 写入
“我最多能借多少？先别借”	[]	S1	否定执行意图 -> 不会触发 S5；使用 borrowable + estimate_rate（查询子集）
“我最多能借多少？借 500 USDT”	[]	S5	执行意图 -> 查询，然后生成操作草案 -> 确认 -> create_loan
“我最多能转出多少 USDT？（不要转账）”	[unified]	S1	仅读取可转账额度 -> transferable + unified_accounts；不是转账执行
“同时显示总资产和期货保证金（不做分析）”	[]	S1 + S2	事实快照，不触发 S3，也不提供健康状况 / 盈亏分析
“给我做一份资产周报 / 总盈亏账本”	[]	—	不予受理：API 无法支持可靠的资产分析或总盈亏计算；说明限制并引导用户查看 App 报告
“快要被强平了，现货余额里有闲钱吗？我能追加保证金吗？”	[]	S2 + S1 + S5	“强平”触发 S2，“现货余额”触发 S1，“追加保证金”触发 S5

L1/L2 并存策略

有些用户查询可以通过单个 L1 技能的工具满足（例如，“我有多少钱”只需要几个资产工具）。此 L2 通过跨 L1 编排提供更全面的聚合报告。

• 推荐策略：所有“账户 / 资产 / 风险”请求都通过此 L2 统一入口处理。如果子意图只需要单个 L1 的工具集，则仅调用该子集并正常输出（短路优化）。
• 原则：统一入口确保所有账户 / 资产 / 风险查询的用户体验一致；内部根据需要调用 1-N 个工具，无需强制执行完整编排。

混合意图处理

当用户查询同时包含账户 / 风险意图和其他 L2 意图时（例如，“查看我的账户，然后买入 BTC”）：

1. 拆分为两个部分：账户 / 风险部分由此技能处理并输出结论
2. 交易 / 研究部分路由到对应的 L2（交易副驾 / 市场研究），各自独立执行
3. 示例：“查看我的账户，然后买一些 BTC” -> 此技能完成资产概览 -> 提示“交易部分已路由到交易副驾”

边界情况处理

场景	处理方式
用户只说“检查我的账户”，未提供详细信息	使用回退方案 S1（资产概览），输出完整资产全景
用户询问“安全吗”／“我没问题吧”	使用回退方案 S1 + S2，输出资产全景 + 保证金／强平评估
用户询问子账户	明确说明“此技能不涵盖子账户管理”
写入操作参数不完整（例如只说“借款”，未提供金额）	请用户补充：“请确认要借入的币种和金额”；不要猜测
多语言／中英混合提示词	正常解析意图和参数；若可识别为账户／资产／风险相关，则启用此技能
用户询问“哪种赚币产品最好”	属于产品推荐范围；转至智能赚币。此技能仅查询现有持仓／收益
gate-cli cex rebate user-info 返回空对象	仍使用 gate-cli cex rebate partner commissions 和其他 S4 工具生成 S4 部分；不要将空的 user_info 视为“没有联盟数据”。参见领域知识：联盟／返佣数据（S4）。

执行

只读场景（S1-S4，不含 S5）

1. 根据用户查询启用相应信号维度
2. 汇总所有已启用维度的工具集并去重
3. 并行执行所有工具（无串行依赖）
4. 大模型汇总多来源结果，标注数据时间戳和来源
5. 按已启用维度输出结构化报告

写入场景（启用 S5）

1. 阶段 1（并行读取）：执行 S1/S2 工具以获取当前账户状态
2. 大模型评估可行性并生成操作草案（遵循 G. 写入操作分级：中风险 = 风险提示 + 模式切换的不可逆性；高风险借款／还款 = 金额 + 币种 + 利率）
3. 向用户展示操作草案、关键参数和风险提示
4. 等待用户明确确认（Y/N）
5. 阶段 2（执行）：仅在确认后提交写入工具调用
6. 输出执行结果

工具去重规则

• 同一请求中，工具和参数相同：仅执行一次，并在多个汇总步骤中复用结果
• 示例：gate-cli cex unified account get 同时用于 S1 和 S2 时，仅执行一次

gate-cli 命令索引

完整去重后的工具清单（58 个工具：54 个只读 + 4 个写入）

资产领域（11 个工具，均为只读）

#	工具名称	R/W	用途
1	gate-cli cex wallet balance total	R	以 USDT 等值表示的总余额
2	gate-cli cex spot account get	R	现货账户各币种余额
3	gate-cli cex unified account get	R	统一账户权益／保证金／借款
4	gate-cli cex futures account get	R	合约账户可用余额
5	gate-cli cex options account get	R	期权账户余额
6	gate-cli cex margin account list	R	逐仓保证金账户
7	gate-cli cex tradfi account assets	R	TradFi 账户权益
8	gate-cli cex earn dual balance	R	双币投资余额
9	gate-cli cex earn dual orders	R	双币投资订单
10	cex_earn_list_structured_orders（在 gate-cli/cmd/cex 中无 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）	R	结构化产品订单
11	gate-cli cex spot account book	R	现货账户账本

统一账户领域（14 个工具，10 个读取 + 4 个写入）

#	工具名称	R/W	用途
12	gate-cli cex unified account get	R	统一账户权益／保证金比率／借款余额
13	gate-cli cex unified mode get	R	当前统一账户模式
14	gate-cli cex unified query borrowable	R	每种币种的可借额度
15	gate-cli cex unified query transferable	R	可转账额度
16	gate-cli cex unified query estimate-rate	R	每种币种的统一账户每小时预计借款利率（API 字符串格式的小数；不是年化 APR/APY）。请参阅“领域知识：统一账户预计借款利率”。
17	gate-cli cex unified account currencies	R	支持的统一账户币种
18	gate-cli cex unified loan records	R	借款记录
19	gate-cli cex unified loan interest	R	借款利息记录
20	gate-cli cex unified config leverage-get	R	每种币种的杠杆设置
21	gate-cli cex unified config discount-tiers	R	抵押品折扣等级
22	gate-cli cex unified mode set	W	切换统一账户模式
23	gate-cli cex unified loan create	W	执行借款／还款
24	gate-cli cex unified config leverage-set	W	设置每种币种的杠杆
25	gate-cli cex unified config collateral	W	设置抵押品币种

SimpleEarn 领域（5 个工具，全部为读取）

#	工具名称	R/W	用途
26	gate-cli cex earn uni currencies	R	SimpleEarn 支持的币种
27	gate-cli cex earn uni currency	R	单个币种的 SimpleEarn 详情
28	gate-cli cex earn uni lends	R	用户的 SimpleEarn 持仓
29	gate-cli cex earn uni interest	R	SimpleEarn 利息收益
30	gate-cli cex earn uni rate	R	SimpleEarn APY 利率

质押领域（4 个工具，全部为读取）

#	工具名称	R/W	用途
31	gate-cli cex earn staking assets	R	质押持仓
32	gate-cli cex earn staking awards	R	质押奖励记录
33	gate-cli cex earn staking find	R	可质押币种搜索
34	gate-cli cex earn staking orders	R	质押订单历史

市场分析领域（12 个工具，全部为读取）

#	工具名称	R/W	用途
35	gate-cli cex spot market orderbook	R	现货订单簿
36	gate-cli cex spot market candlesticks	R	现货 K 线数据
37	gate-cli cex spot market tickers	R	现货行情快照
38	gate-cli cex spot market trades	R	现货交易记录
39	gate-cli cex futures market contract	R	期货合约规格
40	gate-cli cex futures market orderbook	R	期货订单簿
41	gate-cli cex futures market candlesticks	R	期货 K 线数据
42	gate-cli cex futures market tickers	R	期货行情（标记价格）
43	gate-cli cex futures market trades	R	期货交易记录
44	gate-cli cex futures market funding-rate	R	资金费率
45	gate-cli cex futures market liquidations	R	强平订单
46	gate-cli cex futures market premium	R	基差／溢价指数

期货持仓（1 个工具，读取）

#	工具名称	R/W	用途
47	gate-cli cex futures position list	R	所有期货持仓（未实现盈亏、强平价格）

联盟返佣领域（7 个工具，均为只读）

#	工具名称	读/写	用途
48	gate-cli cex rebate user-info	R	用户返佣摘要（可能返回空对象；为空时请参考佣金历史记录）
49	gate-cli cex rebate sub-relation	R	用户联盟关系
50	gate-cli cex rebate partner sub-list	R	合作伙伴客户列表
51	gate-cli cex rebate partner commissions	R	合作伙伴佣金历史记录
52	gate-cli cex rebate partner transactions	R	客户交易历史记录
53	gate-cli cex rebate broker commissions	R	经纪商佣金历史记录
54	gate-cli cex rebate broker transactions	R	经纪商交易历史记录

Alpha 领域（4 个工具，均为只读）

#	工具名称	读/写	用途
55	gate-cli cex alpha market currencies	R	Alpha 支持的币种
56	gate-cli cex alpha market tokens	R	Alpha 代币列表
57	gate-cli cex alpha market tickers	R	Alpha 行情快照
58	gate-cli cex alpha account balances	R	用户 Alpha 持仓

领域知识

核心价值主张

• 通过单次查询即可了解“我的资金在哪里、收益/联盟返佣情况如何、我是否会被强平”，无需在多个页面间切换（不生成资产周报、总盈亏台账或闲置资金分配计划）
• 根据场景编排 58 个工具调用，并考虑并行/串行；结论和数据来源均可追溯
• 写入操作（借款/设置）必须经过确认；杜绝意外执行风险；读取操作完全并行化，以加快响应
• 所有工具均需通过 API Key 进行身份验证；数据仅限经过身份验证的用户本人查看

目标用户

• 持有未平仓头寸、需要快速了解资产概况的活跃交易者
• 关注资产安全和风险控制（保证金、强平）的用户
• 定期查看 Earn/Staking 收益和联盟佣金摘要的用户
• 使用统一账户借款、杠杆和抵押功能的高级用户

关键限制

• 此技能仅涵盖主账户；子账户管理不在范围内。
• 保证金率和强平价格为参考值；务必注明“以交易所实际强平规则为准”。
• 资产数据存在快照延迟；输出中务必标注数据时间戳。
• 借款会产生利息；用户必须自行评估还款能力。
• 资产数据仅限用户本人查看，不得泄露到其他上下文中。
• 查询未返回有意义的业务数据时（列表为空、没有记录），不要在面向用户的输出中列出或强调 cex_* 工具名称；请使用“未找到记录”等自然语言表述。

能力边界（此技能不提供的功能）

• 不执行交易（现货/期货开仓、平仓）——请转至交易副驾驶
• 不进行币种研究、市场分析或新闻分析——请转至市场研究
• 不推荐 Earn 产品或处理订阅——请转至智能 Earn
• 不管理子账户
• 不生成资产周报或跨周期资产分析（API 限制）
• 不生成涵盖所有业务线的总盈亏台账（数据来源不一致）
• 不提供闲置资金分配建议或产品对比——请转至智能 Earn

统一账户预估借款利率（gate-cli cex unified query estimate-rate）

• 语义（Gate API）： 该工具按币种返回当前小时的预估借款利率，数值为字符串形式的小数（例如 "0.000002"）。这与公开 API 的约定一致：这是小时预估值，并非固定的年化报价。
• 面向用户的输出： 始终说明该数值是小时预估利率（或同等表述）。不要将原始数值表述为年化 APR/APY，除非进行了明确换算，并清楚标注为仅供参考（例如，简单换算：小时利率 × 24 × 365——实际计息遵循平台规则）。
• 区分： SimpleEarn 工具（如 gate-cli cex earn uni rate）提供的是产品 APY 风格的数据；它们与统一账户的借款预估值属于不同产品线。不要在同一句话中混用单位而不注明各自的数据来源。

常见误解

误解	实际情况
gate-cli cex unified query estimate-rate 返回的数值是年利率（APR）	这是按币种计算的小时预估借款利率。应标注为小时利率；只有在用户要求时，才可明确换算成年化值，并注明“仅供参考”。
“检查我的账户并买入 BTC”会通过此技能执行交易	此技能仅处理账户、资产和风险查询，以及有限的写入操作（借款/设置）。交易执行由交易 copilot 处理。
清算警告等同于实际清算线	此技能基于快照数据评估风险。务必注明“以交易所的实际清算规则为准”。
此技能可以查询或管理子账户	此技能仅涵盖主账户；子账户管理不在范围内。
“我应该把闲置资金放入 SimpleEarn 还是质押”会由此技能回答	产品选择和资金配置由 smart earn 技能处理。此技能仅提供现有持仓的仓位和收益快照。
gate-cli cex rebate user-info 为空意味着我没有佣金	gate-cli cex rebate partner commissions 中仍可能存在合作伙伴佣金记录；user_info 为空并不妨碍生成 S4 报告。

联盟 / 返佣数据（S4）

• gate-cli cex rebate user-info 可能返回空对象。 仍可通过 gate-cli cex rebate partner commissions（以及其他 S4 读取工具，如合作伙伴子账户列表和交易历史）生成有意义的 S4 报告。user_info 为空不代表没有佣金数据。
• 佣金流水的权威来源： gate-cli cex rebate partner commissions 返回历史佣金记录。commissionAsset 通常为 USDT 或 POINT；记录还可能包含来源维度，例如 FUTURES、SPOT、TradFi 或 ALPHA（名称以 API 返回为准）。
• 不得编造累计返佣总额： 当 user_info 未提供现成的累计返佣数值时，不要臆造一个“返佣总额”。若仅根据历史记录报出 USDT 和 POINT 汇总值，必须翻页获取完整历史记录（使用 API 的 offset/limit 参数，例如每次请求 limit 100），重复查询直至没有更多记录，然后按 commissionAsset 分组汇总 commissionAmount。如果本次会话尚未完成所有分页，必须明确说明，不要猜测总额。
• 官方总额： 如用户需要在本次会话未完整翻页的情况下获取单一官方数值，应引导其前往 Gate App 或 Web 的合作伙伴或返佣中心查询权威累计数据。
• 可选的后续操作： 如果用户提出要求，可以继续仅为返佣数据翻页查询，并报告佣金历史中的 USDT 总额和 POINT 总额。不要将这些返佣总额计入 SimpleEarn、质押或其他收益部分（不要跨部分混算“总收入”）。

参考文档

• gate-runtime-rules.md — 交易所运行时规则（精度、价格限制），在执行借款操作前参考

注意：统一账户规格（保证金率计算、借款规则、模式切换限制）已嵌入此 SKILL.md 的领域知识和安全规则部分。有关统一账户规则的详细信息，请参阅 gate-exchange-unified L1 技能。

安全规则

G. 写入操作确认机制和安全规则

类别：强确认 · 操作草案 — 以下所有统一账户变更都必须先提供操作草案，并在紧接着的上一轮中获得用户明确确认。不得静默执行。

写入操作分级（按风险级别）

风险级别	操作类型	涉及的工具	确认要求
中	切换统一账户模式 / 设置单币种杠杆 / 设置抵押品	gate-cli cex unified mode set、gate-cli cex unified config leverage-set、gate-cli cex unified config collateral	单次确认，并在操作草案中披露风险。如果操作包含模式切换（gate-cli cex unified mode set），草案必须说明模式变更不可逆（或使用其他含义明确的措辞）。
高	借贷 — 借款或还款	gate-cli cex unified loan create	操作草案必须列出金额、币种和预估或适用利率（来自 gate-cli cex unified query estimate-rate — 小时预估 — 或 API 响应），然后在执行前获得用户确认。

实施说明

• gate-cli cex unified query estimate-rate： 向用户引用或填写操作草案时，将返回的利率视为小时预估值（参见领域知识：统一账户预估借款利率）。
• 中风险与高风险：中风险工具仍须使用操作草案；区别在于强调重点 — 中风险设置需要简洁的风险提示（切换模式时还须说明不可逆）。高风险借贷要求在确认前于草案中明确列出财务字段（金額、币种、利率）。
• 如果参数不同，每批确认仅使用一个工具；不要把无关的写入操作打包成一个笼统的“OK”。

用户确认要求

所有写入操作都必须在执行前获得用户明确确认。确认流程如下：

1. 操作草案：展示操作类型、目标、参数、预估影响和风险提示（中风险与高风险所需内容见上方分级表）
2. 等待确认：用户必须明确回复批准（Y / 确认）
3. 执行：仅在获得批准后提交写入工具调用
4. 单次有效：确认使用一次后即失效；参数变更后必须重新确认
5. 逐步确认：多步骤写入操作的每一步都需要单独确认

写入操作分类（摘要）

风险级别	操作	工具	确认
中	切换统一模式、设置杠杆、设置抵押品	gate-cli cex unified mode set、gate-cli cex unified config leverage-set、gate-cli cex unified config collateral	操作草案 + 单次确认 + 风险提示；模式切换：必须说明不可逆性
高	借款 / 还款	gate-cli cex unified loan create	包含金额、币种、利率的操作草案 → 用户确认

未确认保护机制

未经用户明确确认，不执行任何写入操作。仅允许执行读取和查询操作。

过期确认处理

如果确认后参数发生变化（币种、金额或操作类型不同），先前的确认即失效，必须重新提交操作草案。

强制阻止规则

• 上一条用户消息未明确确认时，绝不调用变更工具
• 绝不猜测参数；如果缺少金额、币种或方向，请询问用户
• 绝不编造数据；如果工具调用失败，请妥善处理，并注明“数据暂时不可用”
• 强平预警仅供参考；务必注明“实际规则以交易所规则为准”

错误处理

错误类型	处理策略
单个读取工具超时/出错	跳过该维度，注明“此部分暂时不可用”，继续处理其他维度
写入工具失败	不要重试；说明失败原因，并引导用户前往 App/Web 手动操作
缺少必需参数（写入）	请用户指定（例如：“请确认借款的币种和金额”）
无法识别的意图	回退至 S1（资产概览）
工具调用返回空数据	使用自然语言说明“未找到记录”；不要显示工具名称

风险免责声明

• 数字资产交易风险重大，可能导致投资部分或全部损失。
• 杠杆交易（期货、保证金、期权、交割合约）可能导致损失超过初始保证金。市场的小幅波动也可能造成保证金全部损失。
• 以上内容仅供参考，不构成投资、财务、税务或法律建议。
• AI 辅助生成的内容仅供一般信息参考，不构成 Gate 作出的任何陈述、保证或担保。
• 用户必须遵守其所在司法管辖区的法律法规。Gate 服务可能无法在受限地区使用。

报告模板

只读报告

## Account and Asset Risk Report

| Dimension | Status |
|-----------|--------|
| Data Timestamp | {timestamp} |
| Activated Signals | {S1/S2/S3/S4} |

### S1 Asset Overview (if activated)
{asset_panorama_table}

### S2 Risk and Margin (if activated)
{margin_and_position_risk_table}
Note: Liquidation prices and margin ratios are reference values. Subject to the exchange's actual liquidation rules.

### S3 Earn Snapshot (if activated)
{simpleearn_and_staking_summary}

### S4 Affiliate Report (if activated)
{rebate_and_commission_summary}
Note: If `gate-cli cex rebate user-info` is empty, rely on `gate-cli cex rebate partner commissions` (and other S4 tools). Do not fabricate lifetime USDT/POINT totals unless all history pages were fetched and summed by `commissionAsset`. Point to App/Web partner center for official cumulative figures when appropriate.

写入操作报告

中风险设置（set_unified_mode、set_user_leverage_currency_setting、set_unified_collateral）：

## Action Draft (medium-risk · strong confirmation)

| Item | Value |
|------|-------|
| Operation | {set collateral / set leverage / switch unified mode} |
| Target | {currency / mode / leverage value} |
| Amount or config | {as applicable} |
| Risk warning | {e.g. impact on margin; if mode switch: **this change is irreversible**} |

Reply **Y** to confirm or **N** to cancel.

高风险借贷（create_unified_loan — 借款或还款）：

## Action Draft (high-risk · strong confirmation)

| Item | Value |
|------|-------|
| Operation | {borrow / repay} |
| Currency | {e.g. USDT} |
| Amount | {numeric amount} |
| Interest rate | {hourly estimated rate from `gate-cli cex unified query estimate-rate` / API; state **hourly** — not APR unless explicitly converted and labeled reference-only} |
| Risk warning | {e.g. interest accrual, repayment obligation} |

Reply **Y** to confirm or **N** to cancel.

跨技能工作流

工作流 A：检查风险后追加保证金

1. 此技能评估持仓风险（S2）和可用现货余额（S1）
2. 如果保证金不足，则生成追加保证金操作草案（S5）
3. 确认后，执行抵押品设置

工作流 B：检查可借额度后借款

1. 此技能查询可借额度和预估利率（S1 查询子集）
2. 如果用户确认借款意图，则启用 S5 并生成借款操作草案
3. 确认后，执行借款；如果用户想要交易，则转至交易副驾驶