@chongqingliangyunzhijing/ssquant-cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# SSQUANT 期货仿真 CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+使用 Node.js 18 或更高版本安装 `npm install -g @chongqingliangyunzhijing/ssquant-cli`。
+执行 `ssquant login` 登录 PandaAI，再执行 `ssquant account list --json` 查看账户名额。`ssquant account create` 交互输入初始资金，单位万元，范围 1 至 10000。`ssquant account use <账户号>` 选择交易账户。
+
+## 发给 AI
+
+> 请完整读取 https://www.pandaaiquant.com/ssquant/openapi/v1/agent-install-guide/cli ，按指引帮我安装 SSQUANT 期货仿真交易 CLI，使用我的 PandaAI 账号登录。请完成安装和环境检查，需要浏览器登录、验证码或授权时提醒我。登录后列出账户和剩余名额。如果我需要开户，问我初始资金（万元，1 至 10000），换算成人民币元，等我确认再创建。最后告诉我账户和就绪状态。本次仅做接入和开户。
+
+运行 `ssquant --help` 查看交易命令。查询、开户、交易计划和操作状态支持 `--json`。
+删除使用 `ssquant account delete <账户号>`。确认后释放本地名额，柜台已有委托仍可能成交。

package/bin/ssquant.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { EXIT_BIZ, fail, setJsonMode, setUpdateNotice } from '../src/output.js';
+import * as sys from '../src/commands/system.js';
+import * as acct from '../src/commands/account.js';
+import * as trade from '../src/commands/trade.js';
+import * as mandate from '../src/commands/mandate.js';
+import * as plans from '../src/commands/plan.js';
+import { CLIENT_VERSION } from '../src/version.js';
+import * as sim from '../src/commands/sim.js';
+
+const program = new Command();
+
+program
+  .name('ssquant')
+  .description('SSQUANT 期货仿真交易')
+  .version(CLIENT_VERSION)
+  .option('--json', '以 JSON 输出，便于 Agent 解析')
+  .hook('preAction', async (thisCmd, actionCmd) => {
+    setJsonMode(!!thisCmd.opts().json);
+  });
+
+/** 统一异常出口：把 ApiError 的 code/suggestion 透出给 Agent */
+function run(fn) {
+  return async (...args) => {
+    try {
+      await fn(...args);
+    } catch (e) {
+      fail(e, e.exitCode || EXIT_BIZ);
+    }
+  };
+}
+
+// ── 认证与环境 ──
+program.command('login')
+  .description('授权登录（浏览器）')
+  .action(run(sys.login));
+
+program.command('logout').description('登出并清除本地凭证').action(run(async () => sys.logout()));
+program.command('whoami').description('查看登录状态与绑定账户').action(run(sys.whoami));
+program.command('doctor').description('连通性与状态自检').action(run(sys.doctor));
+const plan = program.command('plan').description('冻结交易计划');
+plan.command('create')
+  .requiredOption('--operation <name>', 'place_order/cancel_order/cancel_all/close_all/rollover/target_position')
+  .option('--parameters <json>', '计划参数 JSON', '{}')
+  .description('生成计划，不执行真实交易')
+  .action(run(plans.create));
+plan.command('show').argument('<planId>').description('查看计划').action(run(plans.show));
+plan.command('execute').argument('<planId>').description('确认并执行计划')
+  .option('--client-request-id <id>', '网络重试复用的幂等号')
+  .requiredOption('-y, --yes', '确认执行该冻结计划')
+  .action(run(plans.execute));
+
+const operation = program.command('operation').description('交易操作状态');
+operation.command('show').argument('<operationId>').description('查询操作回报')
+  .action(run(plans.operationShow));
+operation.command('watch').argument('<operationId>').description('按间隔轮询操作回报')
+  .option('--interval <seconds>', '轮询间隔，至少1秒', '2')
+  .option('--max-polls <n>', '最多轮询次数', '10')
+  .action(run(plans.operationWatch));
+
+// ── 账户 ──
+program.command('varieties')
+  .description('列出全部品种，或按中文、品种码搜索候选')
+  .option('-q, --query <text>', '搜索中文品种名、别名或品种码')
+  .option('--exchange <code>', '按交易所筛选，如 SHFE、DCE')
+  .option('--prefix', '仅按前缀联想', false)
+  .action(run(acct.varieties));
+program.command('resolve')
+  .argument('<query>', '品种名称、代码或指定月份合约')
+  .description('识别品种并返回歧义候选，不查询主力或下单')
+  .action(run(acct.resolveVariety));
+const accounts = program.command('account').description('仿真账户管理与资金查询').action(run(acct.account));
+accounts.command('list').description('账户列表与可用名额').action(run(sim.list));
+accounts.command('create').option('--capital-wan <amount>', '初始资金（万元）').option('--request-id <key>', '开户幂等号').option('-y, --yes', '确认开户').action(run(sim.create));
+accounts.command('use <id>').description('选择当前交易账户').action(run(sim.use));
+accounts.command('delete <id>').option('-y, --yes', '确认本地删除').action(run(sim.remove));
+accounts.command('status <id>').description('查看开户进度').action(run(sim.status));
+program.command('equity').action(run(sim.equity));
+program.command('settlement').option('--date <yyyymmdd>').action(run(sim.settlement));
+program.command('position').description('持仓').action(run(acct.position));
+program.command('positions').description('持仓（position 的别名）').action(run(acct.position));
+program.command('snapshot').description('资金 + 持仓 + 挂单，一次拿齐').action(run(acct.snapshot));
+program.command('quote')
+  .argument('<symbol>', '中文品种名、品种码或实际合约，如 黄金、AU、au2610')
+  .description('查询单品种最新行情')
+  .action(run(acct.quote));
+
+program.command('contract-spec')
+  .argument('<symbol>', '中文品种名、品种码或实际合约，如 纯碱、SA、SA2701.CZC')
+  .description('查询合约乘数、参考保证金和最后交易日')
+  .action(run(acct.contractSpec));
+
+program.command('orders')
+  .description('委托查询')
+  .option('-s, --status <status>', 'active=在途挂单 / filled / cancelled / all')
+  .option('-d, --date <yyyymmdd>', '交易日')
+  .option('--last-id <id>', '游标：上一页最后一条委托的 id')
+  .option('--order-id <id>', '按柜台委托号精确查询')
+  .option('--client-order-id <id>', '按幂等号精确查询')
+  .option('-c, --count <n>', '条数（历史订单默认最近 20 条；挂单默认全部）')
+  .action(run(acct.orders));
+
+program.command('trades')
+  .description('成交查询')
+  .option('-d, --date <yyyymmdd>', '交易日')
+  .option('--last-id <id>', '游标：上一页最后一条成交的 id')
+  .option('-c, --count <n>', '条数，默认最近 20 条')
+  .action(run(acct.trades));
+
+program.command('settlements')
+  .description('每日结算明细，默认最近 5 个交易日，最多 30 个交易日')
+  .option('--limit <n>', '交易日数量', '5')
+  .option('--from-date <date>', '起始交易日 YYYY-MM-DD 或 YYYYMMDD')
+  .option('--to-date <date>', '结束交易日 YYYY-MM-DD 或 YYYYMMDD')
+  .action(run(acct.settlements));
+
+// ── 交易 ──
+program.command('order')
+  .description('下单')
+  .requiredOption('--symbol <code-or-name>', '实际合约代码，或开仓品种名/品种码，例如 rb2610、原油、SC')
+  .requiredOption('--direction <buy|sell>', '买卖方向')
+  .requiredOption('--offset <open|close>', '开平仓')
+  .option('--type <limit|market>', '兼容参数；传价格自动限价 GFD，不传价格自动市价 IOC')
+  .option('--price <price>', '传入即按 GFD 限价单；不传即按 IOC 市价单')
+  .requiredOption('--volume <n>', '手数')
+  .option('--dry-run', '预演：走完全部校验但不真下单', false)
+  .option('--client-order-id <id>', '幂等号')
+  .option('-y, --yes', '跳过交互确认（Agent 用）', false)
+  .action(run(trade.order));
+
+program.command('cancel')
+  .argument('<orderId>', '委托号')
+  .description('撤单')
+  .action(run(trade.cancel));
+
+program.command('cancel-all')
+  .description('撤掉当前全部挂单（服务端编排）')
+  .option('--symbol <code>', '只撤指定合约')
+  .option('--client-request-id <id>', '批次幂等号，重试时复用')
+  .option('--dry-run', '只预演并列出将撤销的委托号', false)
+  .option('-y, --yes', '跳过交互确认', false)
+  .action(run(trade.cancelAll));
+
+program.command('close-all')
+  .description('一键平仓（Agent 止损常用）')
+  .option('--symbol <code>', '只平该合约')
+  .option('--client-request-id <id>', '批次幂等号，重试时复用')
+  .option('--dry-run', '预演', false)
+  .option('-y, --yes', '跳过交互确认', false)
+  .action(run(trade.closeAll));
+
+program.command('rollover')
+  .description('按手数移仓到当前主力合约')
+  .option('--symbol <name>', '品种别名或品种码；不传则扫描全部持仓')
+  .option('--volume <n>', '移仓手数')
+  .option('--direction <long|short>', '多头或空头')
+  .option('--from-contract <code>', '多个旧合约时指定旧合约')
+  .option('--client-request-id <id>', '批次幂等号，真实执行重试时复用')
+  .option('--dry-run', '只预演，不执行', false)
+  .option('-y, --yes', '跳过交互确认', false)
+  .action(run(trade.rollover));
+
+program.command('target-position')
+  .description('把指定品种调到目标多空仓位（默认预演）')
+  .requiredOption('--targets <json>', 'JSON 数组，例如 [{"symbol":"黄金","direction":"long","volume":5}]')
+  .option('--client-request-id <id>', '批次幂等号，重试时复用')
+  .option('--dry-run', '只预演，不执行', false)
+  .option('-y, --yes', '跳过交互确认', false)
+  .action(run(trade.targetPosition));
+
+// ── 授权边界 ──
+const md = program.command('mandate').description('查看自动交易授权状态（安装后自动启用）');
+md.command('show').description('查看当前授权状态').action(run(mandate.show));
+md.command('create')
+  .description('兼容旧版：手动声明自定义授权边界（正常安装无需执行）')
+  .requiredOption('--symbols <list>', '允许交易的合约，逗号分隔')
+  .option('--direction <long|short|both>', '允许方向', 'both')
+  .requiredOption('--max-volume-per-order <n>', '单笔最大手数')
+  .requiredOption('--max-orders-per-day <n>', '单日最大委托笔数')
+  .requiredOption('--max-position <n>', '总持仓手数上限')
+  .option('--max-margin-ratio <r>', '保证金占用比上限，如 0.6')
+  .option('--stop-loss <r>', '权益回撤触及即冻结授权，如 0.15')
+  .requiredOption('--expires <iso>', '失效时间，如 2026-08-10T15:00:00')
+  .option('-y, --yes', '跳过交互确认（仅供选手自己写脚本，skill 禁止 Agent 使用）', false)
+  .action(run(mandate.create));
+md.command('revoke').description('紧急撤销授权（立即生效）')
+  .action(run(mandate.revoke));
+
+program.parseAsync(process.argv).catch((e) => {
+  fail(e, e.exitCode || EXIT_BIZ);
+});

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "@chongqingliangyunzhijing/ssquant-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "SSQUANT 期货仿真交易命令行工具",
+  "type": "module",
+  "bin": {
+    "ssquant": "bin/ssquant.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test": "node --test test/*.mjs"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  }
+}

package/src/auth.js

@@ -0,0 +1,167 @@
+/**
+ * 登录：唯一入口是浏览器 OAuth2.1 + PKCE。
+ *
+ * 身份始终在 PandaAI 官网浏览器页面完成，CLI 只拿到本服务签发的 pt_ token。
+ * 当前不提供设备码或其他远程授权方式。
+ */
+import crypto from 'node:crypto';
+import http from 'node:http';
+import { spawn } from 'node:child_process';
+import { apiUrl, clientId, saveCredentials } from './config.js';
+import { ApiError, requestAnon } from './http.js';
+import { say } from './output.js';
+
+export const LOGIN_HOME_URL = 'https://www.pandaaiquant.com/ssquant/openapi/v1/login-complete';
+
+function b64url(buf) {
+  return buf.toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+
+export function makePkce() {
+  const verifier = b64url(crypto.randomBytes(48));
+  const challenge = b64url(crypto.createHash('sha256').update(verifier).digest());
+  return { verifier, challenge };
+}
+
+export function browserLaunchSpec(url, platform = process.platform) {
+  // Windows 不使用 `cmd /c start` 或 explorer.exe：前者会解析 URL 中的
+  // `&`，后者在部分系统会打开资源管理器。系统 URL 协议处理器能保留完整参数。
+  const cmd = platform === 'win32' ? 'rundll32.exe'
+    : platform === 'darwin' ? 'open' : 'xdg-open';
+  const args = platform === 'win32'
+    ? ['url.dll,FileProtocolHandler', url]
+    : [url];
+  return { cmd, args };
+}
+
+export function openBrowser(url) {
+  const { cmd, args } = browserLaunchSpec(url);
+  try {
+    const p = spawn(cmd, args, { detached: true, stdio: 'ignore' });
+    p.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function hasDisplay() {
+  if (process.platform === 'win32' || process.platform === 'darwin') return true;
+  // Linux 上没有 DISPLAY / WAYLAND_DISPLAY 基本就是无头服务器
+  return !!(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
+}
+
+/** ── 浏览器授权 ────────────────────────────────────────── */
+export async function loginBrowser({ scope = 'futures:read futures:trade', timeout = 300 } = {}) {
+  if (!hasDisplay()) {
+    throw new ApiError('no_browser',
+      '当前 CLI 登录仅支持本机浏览器 OAuth，请在有图形界面的电脑上执行 ssquant login',
+      { suggestion: '请在桌面环境运行 ssquant login，不要使用其他授权方式' });
+  }
+  const { verifier, challenge } = makePkce();
+  const state = b64url(crypto.randomBytes(16));
+
+  const { server, port, waitForCode } = await startCallbackServer(timeout);
+  const redirectUri = `http://127.0.0.1:${port}/callback`;
+
+  const url = apiUrl('/oauth/authorize') + '?' + new URLSearchParams({
+    response_type: 'code',
+    client_id: clientId(),
+    redirect_uri: redirectUri,
+    code_challenge: challenge,
+    code_challenge_method: 'S256',
+    scope,
+    state,
+  }).toString();
+
+  say('正在打开浏览器完成授权…');
+  say(`若没有自动打开，请手动访问：\n  ${url}\n`);
+  openBrowser(url);
+
+  try {
+    const { code, state: got } = await waitForCode;
+    if (got !== state) {
+      throw new ApiError('state_mismatch', '授权回调 state 不匹配，可能遭到 CSRF，已中止');
+    }
+    const { data } = await requestAnon('/oauth/token', {
+      form: true,
+      body: {
+        grant_type: 'authorization_code',
+        code,
+        code_verifier: verifier,
+        redirect_uri: redirectUri,
+        client_id: clientId(),
+      },
+    });
+    return persist(data);
+  } finally {
+    server.close();
+  }
+}
+
+function startCallbackServer(timeoutSec) {
+  return new Promise((resolve, reject) => {
+    let settle;
+    const waitForCode = new Promise((res, rej) => {
+      settle = { res, rej };
+    });
+
+    const server = http.createServer((req, res) => {
+      const u = new URL(req.url, 'http://127.0.0.1');
+      if (!u.pathname.startsWith('/callback')) {
+        res.writeHead(404).end();
+        return;
+      }
+      const err = u.searchParams.get('error');
+      const html = (msg) =>
+        `<!doctype html><meta charset="utf-8"><body style="font-family:system-ui;padding:40px">
+         <h2>${msg}</h2><p>可以关闭本页面，回到命令行继续。</p></body>`;
+      if (err) {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
+          .end(html('✗ 授权被拒绝'));
+        settle.rej(new ApiError('access_denied', '你在浏览器中拒绝了授权'));
+        return;
+      }
+      // 回调只负责交付一次性 code；交付后离开 localhost 页面，避免把 code
+      // 留在地址栏或让用户看到一个简陋的本地确认页。
+      res.writeHead(303, {
+        Location: LOGIN_HOME_URL,
+        'Cache-Control': 'no-store',
+        'Referrer-Policy': 'no-referrer',
+      }).end();
+      settle.res({
+        code: u.searchParams.get('code'),
+        state: u.searchParams.get('state'),
+      });
+    });
+
+    const timer = setTimeout(() => {
+      settle.rej(new ApiError('timeout', `等待授权超时（${timeoutSec}s）`,
+        { suggestion: '请重新执行 ssquant login，并在浏览器中完成授权' }));
+      server.close();
+    }, timeoutSec * 1000);
+    waitForCode.finally(() => clearTimeout(timer)).catch(() => {});
+
+    // 端口交给系统分配：固定端口会在多开时冲突
+    server.listen(0, '127.0.0.1', () => {
+      resolve({ server, port: server.address().port, waitForCode });
+    });
+    server.on('error', reject);
+  });
+}
+
+export function persist(d) {
+  const saved = {
+    accessToken: d.access_token,
+    refreshToken: d.refresh_token,
+    tokenType: d.token_type || 'Bearer',
+    expiresAt: Date.now() + (d.expires_in || 2592000) * 1000,
+    scope: d.scope,
+    accountId: d.account_id,
+    market: d.market,
+    clientId: clientId(),
+    savedAt: new Date().toISOString(),
+  };
+  saveCredentials(saved);
+  return saved;
+}

package/src/commands/account.js

@@ -0,0 +1,190 @@
+/** 账户 / 持仓 / 委托 / 成交查询。 */
+import { qs, request } from '../http.js';
+import { emit, kv, num, pct, say, table } from '../output.js';
+
+export async function varieties(opts) {
+  const { data } = await request(`/futures/varieties${qs({ q: opts.query, exchange: opts.exchange,
+    prefix: opts.prefix ? 'true' : undefined })}`);
+  emit(data);
+  table(['品种码', '名称', '交易所', '目录状态'], data.items.map(item =>
+    [item.code, item.name, item.exchange, item.enabled ? '启用' : '未启用']));
+  say(`共 ${data.total} 项；品种目录不代表当前合约已经通过交易校验。`);
+}
+
+export async function resolveVariety(query) {
+  const { data } = await request(`/futures/resolve${qs({ q: query })}`);
+  emit(data);
+  kv([['识别状态', data.status], ['输入', data.input]]);
+  if (data.variety) kv([['品种', `${data.variety.name} ${data.variety.code}`],
+    ['交易所', data.variety.exchange], ['指定合约', data.specifiedContract || '未指定月份']]);
+  if (data.candidates?.length) {
+    table(['候选品种码', '名称', '交易所'], data.candidates.map(item => [item.code, item.name, item.exchange]));
+    say('请明确选择候选品种的名称或代码；此次识别不生成交易委托。');
+  }
+  if (data.message) say(data.message);
+}
+
+export async function account() {
+  const { data } = await request('/futures/account');
+  emit(data);
+  kv([
+    ['账户', data.accountId ?? '-'],
+    ['动态权益', num(data.totalProfit ?? data.equity)],
+    ['可用资金', num(data.availableFunds)],
+    ['占用保证金', num(data.margin)],
+    ['风险度', pct(data.riskRate)],
+    ['当日盈亏', num(data.dailyPnl)],
+    ['持仓盈亏', num(data.holdingPnl)],
+    ['累计盈亏', num(data.addProfit)],
+    ['手续费(当日)', num(data.cost)],
+  ]);
+}
+
+export function showQuote(data) {
+  if (!data?.ready) {
+    say(`最新行情：${data?.message || '暂无行情快照'}`);
+    return;
+  }
+  kv([
+    ['品种', `${data.name || data.variety || '-'} ${data.symbol || data.contractCode}`],
+    ['最新价', num(data.latestPrice ?? data.last)],
+    ['涨跌', `${num(data.change)} (${pct(data.changeRate)})`],
+    ['今开 / 高 / 低', `${num(data.open)} / ${num(data.high)} / ${num(data.low)}`],
+    ['买一', `${num(data.bidPrice1)} / ${data.bidVolume1 ?? 0} 手`],
+    ['卖一', `${num(data.askPrice1)} / ${data.askVolume1 ?? 0} 手`],
+    ['成交量 / 持仓量', `${data.volume ?? 0} / ${data.openInterest ?? 0}`],
+    ['行情时间(上海)', data.quoteTime || '-'],
+  ]);
+}
+
+export async function quote(symbol) {
+  const { data } = await request(`/futures/quote${qs({ symbol })}`);
+  emit(data);
+  showQuote(data);
+}
+
+export async function contractSpec(symbol) {
+  const { data } = await request(`/futures/contract-spec${qs({ symbol })}`);
+  emit(data);
+  showContractSpec(data);
+}
+
+export function showContractSpec(data) {
+  const value = (v, scale = 1, unit = '') => v == null ? '暂无数据'
+    : new Intl.NumberFormat('zh-CN', { useGrouping: false, maximumFractionDigits: 8 }).format(v * scale) + unit;
+  const margin = data.margin;
+  const day = data.lastTradeDate;
+  kv([
+    ['合约', data.symbol],
+    ['合约乘数', value(data.contractMultiplier)],
+    ['多头保证金率', value(margin.longMarginRatioByMoney, 100, '%')],
+    ['空头保证金率', value(margin.shortMarginRatioByMoney, 100, '%')],
+    ['多头每手保证金', value(margin.longMarginByVolume, 1, ' 元/手')],
+    ['空头每手保证金', value(margin.shortMarginByVolume, 1, ' 元/手')],
+    ['最后交易日', day ? `${day.slice(0, 4)}-${day.slice(4, 6)}-${day.slice(6)}` : '暂无数据'],
+  ]);
+  if (Object.hasOwn(data, 'deliveryDate')) {
+    const delivery = data.deliveryDate;
+    kv([['交割日', delivery ? `${delivery.slice(0, 4)}-${delivery.slice(4, 6)}-${delivery.slice(6)}` : '暂无数据']]);
+  }
+}
+
+export async function position() {
+  const { data } = await request('/futures/positions');
+  emit(data);
+  const rows = (data || []).map((p) => [
+    p.contractCode,
+    p.direction === 'long' ? '多' : '空',
+    p.volume ?? p.position ?? 0,
+    p.todayVolume ?? p.tdPosition ?? 0,
+    p.closable ?? p.sellable ?? 0,
+    num(p.openPrice ?? p.avgPrice),
+    num(p.lastPrice),
+    num(p.holdingPnl),
+    num(p.openMarketValue),
+    pct(p.holdingPnlRate),
+    num(p.margin),
+  ]);
+  table(['合约', '方向', '持仓', '今仓', '可平', '开仓价', '最新价', '浮盈', '开仓市值', '持仓收益率', '保证金'], rows);
+}
+
+export async function orders(opts) {
+  const status = opts.status;
+  const path = status === 'active' || status === 'open'
+    ? `/futures/orders/open${qs({ count: opts.count })}`
+    : `/futures/orders${qs({ status, tradeDate: opts.date, lastId: opts.lastId,
+      orderId: opts.orderId, clientOrderId: opts.clientOrderId, count: opts.count })}`;
+  const { data, meta } = await request(path);
+  emit(data, meta);
+  const rows = (data || []).map((o) => [
+    o.orderId,
+    o.contractCode,
+    o.exchange || '',
+    o.tradeDirectionText || `${o.sideText || o.side}${o.offsetText || o.offset}`,
+    o.volume ?? o.quantity,
+    o.filledVolume ?? o.filledQuantity ?? 0,
+    num(o.price),
+    o.statusText || o.status,
+    o.orderTime || '',
+    o.executionSourceText || '',
+    o.message || '',
+  ]);
+  table(['委托号', '合约', '交易所', '方向', '手数', '已成', '价格', '状态', '委托时间', '来源', '说明'], rows);
+}
+
+export async function trades(opts) {
+  const { data, meta } = await request(
+    `/futures/trades${qs({ tradeDate: opts.date, lastId: opts.lastId, count: opts.count })}`);
+  emit(data, meta);
+  const rows = (data || []).map((t) => [
+    t.tradeId,
+    t.orderId || '',
+    t.contractCode,
+    t.exchange || '',
+    t.tradeDirectionText || `${t.sideText || t.side}${t.offsetText || t.offset}`,
+    t.volume,
+    num(t.price),
+    num(t.cost ?? t.commission),
+    t.tradeTime || '',
+    t.executionSourceText || '',
+  ]);
+  table(['成交号', '委托号', '合约', '交易所', '方向', '手数', '成交价', '手续费', '成交时间', '来源'], rows);
+}
+
+export async function snapshot() {
+  const { data } = await request('/futures/snapshot');
+  emit(data);
+  const a = data.account || {};
+  say('【资金】');
+  kv([
+    ['动态权益', num(a.totalProfit ?? a.equity)],
+    ['可用资金', num(a.availableFunds)],
+    ['占用保证金', num(a.margin)],
+    ['风险度', pct(a.riskRate)],
+  ]);
+  say('\n【持仓】');
+  table(['合约', '方向', '持仓', '可平', '开仓价', '浮盈', '开仓市值', '持仓收益率'],
+    (data.positions || []).map((p) => [
+      p.contractCode, p.direction === 'long' ? '多' : '空',
+      p.volume ?? p.position, p.closable ?? p.sellable,
+      num(p.openPrice ?? p.avgPrice), num(p.holdingPnl), num(p.openMarketValue), pct(p.holdingPnlRate),
+    ]));
+  say('\n【挂单】');
+  table(['委托号', '合约', '方向', '手数', '未成'],
+    (data.openOrders || []).map((o) => [
+      o.orderId, o.contractCode, `${o.sideText || o.side}${o.offsetText || o.offset}`,
+      o.volume ?? o.quantity, o.unfilledVolume ?? o.unfilledQuantity,
+    ]));
+}
+
+export async function settlements(opts) {
+  const { data } = await request(`/futures/settlements${qs({
+    limit: opts.limit, fromDate: opts.fromDate, toDate: opts.toDate,
+  })}`);
+  emit(data);
+  table(['结算日', '当日盈亏', '收益率', '累计净值', '最大回撤', '手续费', '累计盈亏'],
+    (data.items || []).map((r) => [
+      r.settleDate || '-', num(r.dailyPnl), pct(r.dailyReturn), num(r.cumNav),
+      pct(r.maxDrawdown), num(r.commission), num(r.cumulativePnl),
+    ]));
+}