mirror of
https://github.com/NoFxAiOS/nofx.git
synced 2026-07-18 18:04:32 +08:00
feat: simplify Claw402 autopilot trading flow
This commit is contained in:
tinkle-community
@@ -1,207 +0,0 @@
|
||||
{
|
||||
"name": "exchange_management",
|
||||
"kind": "management",
|
||||
"domain": "exchange",
|
||||
"description": "当用户想创建、查看、修改或删除交易所账户配置时调用。适用于用户提到交易所账户、API Key、Secret、Passphrase、测试网开关、启用状态等配置管理需求。不用于排查 invalid signature、timestamp、权限不足、白名单限制等连接或鉴权诊断问题。",
|
||||
"field_constraints": {
|
||||
"exchange_type": {
|
||||
"type": "enum",
|
||||
"required": true,
|
||||
"values": ["binance", "bybit", "okx", "bitget", "gate", "kucoin", "hyperliquid", "aster", "lighter", "indodax"],
|
||||
"aliases": {"币安": "binance", "欧易": "okx", "必安": "binance", "bitget": "bitget", "bitget futures": "bitget", "bitget合约": "bitget", "库币": "kucoin", "gate.io": "gate", "hyper": "hyperliquid", "印尼站": "indodax"},
|
||||
"description": "交易所类型，必填，决定后续需要哪些凭证字段。"
|
||||
},
|
||||
"account_name": {
|
||||
"type": "string",
|
||||
"max_length": 50,
|
||||
"description": "账户显示名称，可选，用于区分同一交易所的多个账户。"
|
||||
},
|
||||
"api_key": {
|
||||
"type": "credential",
|
||||
"pattern": "^[A-Za-z0-9_\\-]{8,}$",
|
||||
"description": "交易所 API Key，至少 8 位字母数字。"
|
||||
},
|
||||
"secret_key": {
|
||||
"type": "credential",
|
||||
"pattern": "^([A-Za-z0-9_\\-]{8,}|(0x)?[A-Fa-f0-9]{16,})$",
|
||||
"description": "交易所 Secret Key，至少 8 位字母数字，或十六进制格式。"
|
||||
},
|
||||
"passphrase": {
|
||||
"type": "credential",
|
||||
"required_for": ["okx", "bitget", "kucoin"],
|
||||
"description": "OKX、Bitget、KuCoin 专用 Passphrase/API 口令，对这些交易所启用前必须填写；Binance、Bybit、Gate、Indodax 通常不需要。"
|
||||
},
|
||||
"testnet": {
|
||||
"type": "bool",
|
||||
"default": false,
|
||||
"description": "是否使用测试网（沙盒环境），默认 false（主网）。"
|
||||
},
|
||||
"enabled": {
|
||||
"type": "bool",
|
||||
"default": true,
|
||||
"description": "是否启用该交易所配置。只要必要字段齐全并配置成功，就默认启用。"
|
||||
},
|
||||
"hyperliquid_wallet_addr": {
|
||||
"type": "credential",
|
||||
"required_for": ["hyperliquid"],
|
||||
"description": "Hyperliquid 主钱包地址，Hyperliquid 账户启用前必须填写。"
|
||||
},
|
||||
"hyperliquid_unified_account": {
|
||||
"type": "bool",
|
||||
"default": false,
|
||||
"required_for": ["hyperliquid"],
|
||||
"description": "是否启用 Hyperliquid unified account 模式。"
|
||||
},
|
||||
"aster_user": {
|
||||
"type": "credential",
|
||||
"required_for": ["aster"],
|
||||
"description": "Aster 用户地址，Aster 账户启用前必须填写。"
|
||||
},
|
||||
"aster_signer": {
|
||||
"type": "credential",
|
||||
"required_for": ["aster"],
|
||||
"description": "Aster Signer 地址，Aster 账户启用前必须填写。"
|
||||
},
|
||||
"aster_private_key": {
|
||||
"type": "credential",
|
||||
"required_for": ["aster"],
|
||||
"description": "Aster 私钥，Aster 账户启用前必须填写。"
|
||||
},
|
||||
"lighter_wallet_addr": {
|
||||
"type": "credential",
|
||||
"required_for": ["lighter"],
|
||||
"description": "Lighter 钱包地址，Lighter 账户启用前必须填写。"
|
||||
},
|
||||
"lighter_private_key": {
|
||||
"type": "credential",
|
||||
"required_for": ["lighter"],
|
||||
"description": "Lighter 私钥，某些 Lighter 账户模式下启用前必须填写。"
|
||||
},
|
||||
"lighter_api_key_private_key": {
|
||||
"type": "credential",
|
||||
"required_for": ["lighter"],
|
||||
"description": "Lighter API Key 私钥，Lighter 账户启用前必须填写。"
|
||||
},
|
||||
"lighter_api_key_index": {
|
||||
"type": "int",
|
||||
"min": 0,
|
||||
"max": 255,
|
||||
"required_for": ["lighter"],
|
||||
"description": "Lighter API Key Index，范围 0～255，超出范围自动收敛并告知用户。"
|
||||
}
|
||||
},
|
||||
"validation_rules": [
|
||||
"api_key 格式：至少 8 位字母数字，不符合时提示用户重新输入完整 Key。",
|
||||
"secret_key 格式：至少 8 位字母数字，或十六进制格式，不符合时提示用户重新输入。",
|
||||
"OKX 账户启用前必须填写 passphrase，否则拒绝启用并提示补填。",
|
||||
"Bitget 和 KuCoin 页面流程里也需要 passphrase/API 口令，不能回答“没有就留空”；缺失时应明确提示补填。",
|
||||
"Hyperliquid 创建/更新时应与手动页面保持一致：至少收集 api_key + hyperliquid_wallet_addr。",
|
||||
"Hyperliquid 账户启用前必须填写 hyperliquid_wallet_addr。",
|
||||
"若用户使用 Hyperliquid unified account 模式，应明确记录 hyperliquid_unified_account 开关状态。",
|
||||
"Aster 账户启用前必须填写 aster_user、aster_signer、aster_private_key 三个字段，任一缺失都不能启用。",
|
||||
"Lighter 账户启用前必须填写 lighter_wallet_addr + lighter_api_key_private_key；若当前账户模式还依赖 lighter_private_key，也要先补齐后再启用。",
|
||||
"lighter_api_key_index 超出 0～255 时自动收敛到边界值并告知用户。",
|
||||
"删除操作不可逆，必须先向用户确认再执行。"
|
||||
],
|
||||
"per_exchange_required_fields": {
|
||||
"binance": ["api_key", "secret_key"],
|
||||
"okx": ["api_key", "secret_key", "passphrase"],
|
||||
"bybit": ["api_key", "secret_key"],
|
||||
"bitget": ["api_key", "secret_key", "passphrase"],
|
||||
"gate": ["api_key", "secret_key"],
|
||||
"kucoin": ["api_key", "secret_key", "passphrase"],
|
||||
"indodax": ["api_key", "secret_key"],
|
||||
"hyperliquid": ["api_key", "hyperliquid_wallet_addr"],
|
||||
"aster": ["aster_user", "aster_signer", "aster_private_key"],
|
||||
"lighter": ["lighter_wallet_addr", "lighter_api_key_private_key"]
|
||||
},
|
||||
"actions": {
|
||||
"create": {
|
||||
"description": "创建新的交易所配置。根据 exchange_type 决定需要收集哪些凭证字段。",
|
||||
"required_slots": ["exchange_type", "account_name"],
|
||||
"optional_slots": ["account_name", "api_key", "secret_key", "passphrase", "testnet", "hyperliquid_wallet_addr", "hyperliquid_unified_account", "aster_user", "aster_signer", "aster_private_key", "lighter_wallet_addr", "lighter_private_key", "lighter_api_key_private_key", "lighter_api_key_index"],
|
||||
"goal": "创建一个可供 trader 绑定使用的交易所配置。",
|
||||
"dynamic_rules": [
|
||||
"确认 exchange_type 后，根据 per_exchange_required_fields 决定需要追问哪些凭证字段。",
|
||||
"Binance/Bybit/Gate/Indodax 需要 API Key + Secret；OKX/Bitget/KuCoin 还必须追问 passphrase；Hyperliquid 必须追问 api_key + 钱包地址，并允许记录 unified account 开关；Aster 必须追问 user/signer/private_key；Lighter 必须追问钱包地址和 api_key_private_key。",
|
||||
"如果用户选择 OKX、Bitget 或 KuCoin，不能把 passphrase 说成可选项；没有 passphrase 时应停在补字段，不要创建半成品。",
|
||||
"凭证字段格式不符时，用人话告知用户正确格式，不要静默丢弃。",
|
||||
"若当前父任务只是缺一个可用交易所，本动作完成后应允许父任务恢复并消费新的 exchange_id。",
|
||||
"若请求只是在启用已有交易所，不应误走 create，应改走 update_status。"
|
||||
],
|
||||
"success_output": "返回新 exchange_id 和创建后的交易所配置摘要（类型、账户名、是否启用）。",
|
||||
"failure_output": "明确指出缺失的必填字段或非法凭证格式，禁止返回含糊的成功信息。"
|
||||
},
|
||||
"update": {
|
||||
"description": "更新已有交易所配置的任意可编辑字段。",
|
||||
"required_slots": ["target_ref"],
|
||||
"optional_slots": ["account_name", "api_key", "secret_key", "passphrase", "enabled", "testnet", "hyperliquid_wallet_addr", "hyperliquid_unified_account", "aster_user", "aster_signer", "aster_private_key", "lighter_wallet_addr", "lighter_private_key", "lighter_api_key_private_key", "lighter_api_key_index"],
|
||||
"goal": "更新一个已有交易所配置的指定字段，而不影响未提及字段。",
|
||||
"dynamic_rules": [
|
||||
"只更新用户明确提到的字段，不要覆盖未提及的字段。",
|
||||
"更新凭证字段时，格式不符则提示用户重新输入。"
|
||||
],
|
||||
"success_output": "返回 exchange_id 和更新后的交易所配置摘要。",
|
||||
"failure_output": "明确指出目标交易所不存在、凭证格式非法，或仍缺哪个字段。"
|
||||
},
|
||||
"update_name": {
|
||||
"description": "修改交易所配置中的账户显示名称字段。",
|
||||
"required_slots": ["target_ref", "account_name"],
|
||||
"goal": "修改交易所配置中的账户显示名称，而不影响其他字段。",
|
||||
"dynamic_rules": [
|
||||
"若用户同时提到其他字段，应优先走更通用的 update。"
|
||||
],
|
||||
"success_output": "返回 exchange_id，并明确告知交易所配置已更新。",
|
||||
"failure_output": "明确指出目标交易所不存在，或新的账户名称仍缺失。"
|
||||
},
|
||||
"update_status": {
|
||||
"description": "修改交易所配置中的启用开关。启用前系统会校验凭证完整性。",
|
||||
"required_slots": ["target_ref", "enabled"],
|
||||
"goal": "修改交易所配置中的启用状态字段。",
|
||||
"dynamic_rules": [
|
||||
"启用前根据 exchange_type 校验必填凭证是否齐全，不齐全则提示用户补填后再启用。"
|
||||
],
|
||||
"success_output": "返回 exchange_id，并明确告知交易所配置已更新。",
|
||||
"failure_output": "明确指出目标交易所不存在、缺少必填凭证，或当前状态切换失败。"
|
||||
},
|
||||
"delete": {
|
||||
"description": "删除交易所配置，不可逆操作，必须确认。",
|
||||
"required_slots": ["target_ref"],
|
||||
"needs_confirmation": true,
|
||||
"goal": "删除一个交易所配置。",
|
||||
"dynamic_rules": [
|
||||
"必须在确认后执行，并明确提醒删除不可逆。"
|
||||
],
|
||||
"success_output": "返回删除成功结果，并明确告知该交易所配置已被移除。",
|
||||
"failure_output": "明确指出缺少确认、目标交易所不存在，或删除失败原因。"
|
||||
},
|
||||
"query_list": {
|
||||
"description": "查询所有交易所配置列表，包含类型、账户名、启用状态。",
|
||||
"goal": "列出当前用户可用的交易所配置，便于后续绑定或选择。",
|
||||
"dynamic_rules": [
|
||||
"优先返回类型、账户名、启用状态，不返回敏感凭证明文。"
|
||||
],
|
||||
"success_output": "返回交易所配置列表摘要。",
|
||||
"failure_output": "若列表为空，应明确告知当前没有交易所配置。"
|
||||
},
|
||||
"query_detail": {
|
||||
"description": "查询某个交易所配置的详细信息。",
|
||||
"required_slots": ["target_ref"],
|
||||
"goal": "读取一个交易所配置的详细信息和当前状态。",
|
||||
"dynamic_rules": [
|
||||
"详情返回中只能暴露凭证存在性，不得返回凭证明文。"
|
||||
],
|
||||
"success_output": "返回目标交易所配置的详细摘要。",
|
||||
"failure_output": "明确指出目标交易所不存在，或当前引用已经失效。"
|
||||
}
|
||||
},
|
||||
"tool_mapping": {
|
||||
"create": "manage_exchange_config:create",
|
||||
"update": "manage_exchange_config:update",
|
||||
"update_name": "manage_exchange_config:update",
|
||||
"update_status": "manage_exchange_config:update",
|
||||
"delete": "manage_exchange_config:delete",
|
||||
"query_list": "get_exchange_configs",
|
||||
"query_detail": "get_exchange_configs"
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user