bithumb-system

Bithumb 系统 CLI

用于 Bithumb CLI 的本地审计日志和连接／身份验证诊断。所有命令均为只读。即使凭据无效，system diagnose 也能运行，可帮助排查身份验证问题。

技能路由

• 市场数据 → bithumb-market | 账户／钱包／密钥 → bithumb-account | 订单 → bithumb-trade | 充值 → bithumb-deposit | 提现 → bithumb-withdraw | 审计日志和诊断 → bithumb-system（本技能）

命令索引

#	命令	类型	描述
1	bithumb system diagnose	READ	连接、身份验证、配置和模块诊断
2	bithumb system audit	READ	本地审计日志（操作历史）

路由 — 识别系统操作

用户意图	命令
检查连接／身份验证／配置状态	bithumb system diagnose
查看过往操作（本地日志）	bithumb system audit

对于 "사용 가능한 기능 알려줘"／“你能做什么？”这类请求，应通过技能路由列表（market / account / trade / deposit / withdraw / system）作答，而不是调用工具。要检查特定环境中启用了哪些模块，请读取 bithumb system diagnose 返回的模块状态。

这里的所有命令均为只读，可立即运行，无需确认或在写入后验证。

CLI 参考

system diagnose — 系统诊断

bithumb system diagnose
# → API: reachable | Auth: valid | Config: OK | Modules: all active

检查 API 可访问性、身份验证状态、TOML 配置有效性和模块状态。其他需要身份验证的技能（account、trade、deposit、withdraw）会将其用作连接／身份验证的预检。如果检查失败，请停止操作，并引导用户设置 BITHUMB_ACCESS_KEY / BITHUMB_SECRET_KEY。

system audit — 审计日志

bithumb system audit [--tool <name>] [--level <INFO|WARN|ERROR|DEBUG>] [--limit <n>] [--since <timestamp>]
# Example: bithumb system audit --level ERROR --limit 10

参数	必填	默认值	描述
--tool	否	-	按工具／命令名称筛选
--level	否	-	筛选级别：INFO、WARN、ERROR、DEBUG
--limit	否	20	返回的最大条目数（>=1）
--since	否	-	ISO 8601 时间戳；返回此时间及之后的条目

跨技能工作流 — 系统健康检查

用户：“빗썸 연결 상태 확인해줘”

1. bithumb-system   bithumb system diagnose        → full diagnostics
2. bithumb-account  bithumb account wallet-status   → blockchain status

边缘情况

• 审计日志为本地日志：system audit 读取本地日志文件，而非 Bithumb 服务端历史记录。
• 无需身份验证即可诊断：即使凭据缺失／无效，system diagnose 也会运行，并准确报告缺少的内容。
• 审计日志为空：尚无操作日志时，会返回 "No audit entries found"。

全局说明

• 前置条件：安装 CLI（npm install -g @bithumb-official/bithumb-cli）；设置 BITHUMB_ACCESS_KEY / BITHUMB_SECRET_KEY，以获取 audit 内容并执行需要身份验证的诊断（diagnose 即使未设置这些变量也会运行）。
• 所有命令均为只读。bithumb system diagnose 是其他需要身份验证的技能共用的连接／身份验证检查。
• 在任意命令后添加 --json，即可获取原始 Bithumb API／工具响应。