@milian/linker-cli 0.0.0-stage → 0.17.3

package/src/commands/platform-create.js

@@ -0,0 +1,279 @@
+'use strict';
+
+const { loadCredentials } = require('../config');
+const { authedRequest } = require('../api');
+const { fetchGroups } = require('./groups');
+
+// 模板中的固定字段，逐字对齐平台前端提交格式
+const FIXED = {
+  source: 0,
+  businessTypeList: [0],
+  digiwinBO: {
+    restUrl: '',
+    callUrl: '',
+    ver: '',
+    prod: 'yipaas',
+    pid: '',
+    uid: '',
+    ip: '',
+    timezone: null
+  }
+};
+
+const DEFAULT_ICON = '30002';
+const DEFAULT_TYPE = 5;
+
+// platformType = 系统分类。数字为平台值，名称仅作命令行别名（方便 AI/人直接写 --type ERP）
+const TYPE_NAMES = {
+  1: 'OA',
+  2: 'CRM',
+  3: 'WMS',
+  4: 'ERP',
+  5: '其他'
+};
+
+// 分组 code 实测允许大小写（如 Weaver、TemplateStudio），故不强制小写
+const CODE_RE = /^[A-Za-z0-9_-]{1,64}$/;
+
+const USAGE = `用法: wb platform create --name <名称> --group <分组code> --host <http://ip:port> [选项]
+
+必填:
+  --name, -n <名称>       应用连接器名称
+  --group, -g <code>      分组 code，需全局唯一（先用 groups 查重）
+  --host, -H <url>        目标系统地址，形如 http://192.168.0.88:6001
+
+可选:
+  --remark, -r <描述>     系统描述，默认与名称相同
+  --type, -t <分类>       系统分类，默认 ${DEFAULT_TYPE}（其他）
+                          可填数字 1-5 或名称：1=OA 2=CRM 3=WMS 4=ERP 5=其他
+  --icon <id>             图标，默认 ${DEFAULT_ICON}
+  --dry-run               只打印将提交的 JSON，不发请求
+  --force                 跳过分组 code 重复预检（有风险）`;
+
+function parseArgs(argv) {
+  const opts = {
+    name: '',
+    group: '',
+    host: '',
+    remark: '',
+    type: '',
+    icon: DEFAULT_ICON,
+    dryRun: false,
+    force: false
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const a = argv[i];
+    const next = () => {
+      const v = argv[i + 1];
+      i += 1;
+      return v === undefined ? '' : v;
+    };
+    if (a === '--name' || a === '-n') opts.name = next();
+    else if (a === '--group' || a === '-g') opts.group = next();
+    else if (a === '--host' || a === '-H') opts.host = next();
+    else if (a === '--remark' || a === '-r') opts.remark = next();
+    else if (a === '--type' || a === '-t') opts.type = next();
+    else if (a === '--icon') opts.icon = next();
+    else if (a === '--dry-run') opts.dryRun = true;
+    else if (a === '--force') opts.force = true;
+    else if (a === '--help' || a === '-h') opts.help = true;
+    else if (!a.startsWith('-')) {
+      // 位置参数依次当作 name / group / host
+      if (!opts.name) opts.name = a;
+      else if (!opts.group) opts.group = a;
+      else if (!opts.host) opts.host = a;
+    }
+  }
+  return opts;
+}
+
+/**
+ * 解析 platformType：支持数字 1-5，也支持名称 OA/CRM/WMS/ERP/其他（大小写不敏感）。
+ * 拿不准系统属于哪一类时，按平台约定归到 5（其他）。
+ */
+function parseType(raw) {
+  const v = String(raw === undefined || raw === null ? '' : raw).trim();
+  if (!v) return DEFAULT_TYPE;
+  if (/^[1-5]$/.test(v)) return Number(v);
+
+  const upper = v.toUpperCase();
+  for (const [num, name] of Object.entries(TYPE_NAMES)) {
+    if (name.toUpperCase() === upper) return Number(num);
+  }
+  // 常见写法兜底
+  if (['其它', 'OTHER', 'OTHERS', 'UNKNOWN'].includes(upper)) return 5;
+
+  throw new Error(
+    `--type "${v}" 不合法：可选 1=OA / 2=CRM / 3=WMS / 4=ERP / 5=其他（也可直接写名称，或省略则默认 5）`
+  );
+}
+
+/** 第一步：收集并校验入参 */
+function collect(opts) {
+  const missing = [];
+  if (!String(opts.name).trim()) missing.push('--name   应用连接器名称');
+  if (!String(opts.group).trim()) missing.push('--group  分组 code（全局唯一，可用 groups 命令查看现有值）');
+  if (!String(opts.host).trim()) missing.push('--host   目标系统地址，如 http://192.168.0.88:6001');
+
+  if (missing.length) {
+    throw new Error(`缺少必填入参：\n        ${missing.join('\n        ')}\n\n${USAGE}`);
+  }
+
+  const name = opts.name.trim();
+  const group = opts.group.trim();
+  const host = opts.host.trim();
+
+  if (!CODE_RE.test(group)) {
+    throw new Error(
+      `分组 code "${group}" 不合法：只允许字母、数字、下划线、短横线，长度 1–64（实测大小写都可用）`
+    );
+  }
+  if (!/^https?:\/\/.+/i.test(host)) {
+    throw new Error(`地址 "${host}" 不合法：必须以 http:// 或 https:// 开头，并带上端口，如 http://192.168.0.88:6001`);
+  }
+
+  return {
+    name,
+    group,
+    host: host.replace(/\/+$/, ''),
+    remark: String(opts.remark || '').trim() || name,
+    type: parseType(opts.type),
+    icon: opts.icon || DEFAULT_ICON
+  };
+}
+
+/** 第二步：分组 code 查重（同时比对分组表与已建连接器，防止遗漏） */
+async function checkGroupCode(cfg, cred, group, opts) {
+  const { total, records } = await fetchGroups(cfg, cred);
+
+  // 大小写不同也算冲突：同一 code 仅差大小写会让人混淆，且不排除数据库层面不区分大小写
+  const hit = records.find(
+    (r) => String(r.groupPrefix || '').toLowerCase() === group.toLowerCase()
+  );
+
+  if (hit) {
+    if (opts.force) {
+      process.stderr.write(
+        `[warn] 分组 code "${group}" 已存在（${hit.groupName || '未命名'}，groupId=${hit.groupId}），因 --force 继续\n`
+      );
+      return { total, records, conflict: hit, forced: true };
+    }
+    const similar = records
+      .filter((r) => String(r.groupPrefix || '').toLowerCase().includes(group.toLowerCase().slice(0, 2)))
+      .slice(0, 5)
+      .map((r) => r.groupPrefix);
+    throw new Error(
+      `分组 code "${group}" 已被占用：${hit.groupName || '未命名'}（groupId=${hit.groupId}）\n` +
+        `        请换一个 code。${similar.length ? `相近的已有 code: ${similar.join(', ')}` : ''}\n` +
+        `        查看全部分组：wb groups`
+    );
+  }
+
+  return { total, records, conflict: null, forced: false };
+}
+
+/** 第三步：拼装请求体（严格对齐平台前端格式） */
+function buildBody(v) {
+  return {
+    source: FIXED.source,
+    platformName: v.name,
+    platformType: v.type,
+    businessTypeList: FIXED.businessTypeList,
+    digiwinBO: FIXED.digiwinBO,
+    groupPrefix: v.group,
+    remark: v.remark,
+    icon: v.icon,
+    hostList: [{ host: v.host, sortOrder: 1 }]
+  };
+}
+
+/**
+ * 创建成功的返回（已实测确认）：
+ *   {"code":200,"msg":"操作成功","data":"2118536154193555456"}
+ * data 就是新建的 platformId 字符串。
+ * 仍保留对象形态的兜底，防止平台后续改结构。
+ */
+function pickNewId(data) {
+  if (data == null || data === '') return '';
+  if (typeof data === 'string' || typeof data === 'number') return String(data);
+  if (typeof data === 'object') {
+    return String(data.platformId || data.id || (data.record && data.record.platformId) || '');
+  }
+  return '';
+}
+
+/**
+ * 创建应用连接器
+ * 编排：收集入参 → 查全部 code 判重 → POST /index/sys/api/v1/platforms
+ */
+async function commandPlatformCreate(cfg, argv) {
+  const opts = parseArgs(argv);
+  if (opts.help) {
+    process.stdout.write(USAGE + '\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  const cred = loadCredentials();
+  if (!cred || !cred.tokenValue) {
+    throw new Error('未登录或授权已失效，请先执行 auth login');
+  }
+
+  // 步骤 1/3：入参
+  const v = collect(opts);
+  process.stdout.write('[1/3] 入参收集完成\n');
+  process.stdout.write(`      platformName = ${v.name}\n`);
+  process.stdout.write(`      groupPrefix  = ${v.group}\n`);
+  process.stdout.write(`      platformType = ${v.type}（${TYPE_NAMES[v.type] || '未知'}）\n`);
+  process.stdout.write(`      host         = ${v.host}\n`);
+  process.stdout.write(`      remark       = ${v.remark}\n`);
+
+  // 步骤 2/3：分组 code 查重
+  const { total } = await checkGroupCode(cfg, cred, v.group, opts);
+  process.stdout.write(`[2/3] 分组 code 检查通过（系统现有 ${total} 个分组）\n`);
+
+  const body = buildBody(v);
+
+  if (opts.dryRun) {
+    process.stdout.write('[3/3] --dry-run，未提交。将发送：\n');
+    process.stdout.write(`POST {baseUrl}/index/sys/api/v1/platforms\n`);
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  // 步骤 3/3：提交
+  const res = await authedRequest(cfg, cred, 'POST', '/sys/api/v1/platforms', body);
+  const json = res.json;
+
+  if (!json || typeof json !== 'object') {
+    throw new Error(`创建失败：接口返回异常（HTTP ${res.status}）${String(res.text).slice(0, 200)}`);
+  }
+  if (json.code !== 200) {
+    throw new Error(
+      `创建失败：code=${json.code} msg=${json.msg || '未知错误'}\n` +
+        `        已提交的分组 code: ${v.group}（若平台已建出分组但连接器未建成，需在平台侧清理）`
+    );
+  }
+
+  const newId = pickNewId(json.data);
+  process.stdout.write('[3/3] 创建成功\n');
+  if (newId) process.stdout.write(`      platformId   = ${newId}\n`);
+  process.stdout.write(`      platformName = ${v.name}\n`);
+  process.stdout.write(`      groupPrefix  = ${v.group}\n`);
+  process.stdout.write(`\n可用 platforms --name ${v.name} 复核\n`);
+  process.exitCode = 0;
+}
+
+module.exports = {
+  commandPlatformCreate,
+  buildBody,
+  pickNewId,
+  collect,
+  parseType,
+  FIXED,
+  TYPE_NAMES,
+  DEFAULT_ICON,
+  DEFAULT_TYPE
+};

package/src/commands/platforms.js

@@ -0,0 +1,206 @@
+'use strict';
+
+const { loadCredentials } = require('../config');
+const { authedRequest } = require('../api');
+const { renderTable } = require('../ui');
+
+const MAX_PAGE_SIZE = 10000;
+
+/** 终端显示宽度：CJK 字符占 2 列 */
+function dispWidth(s) {
+  let w = 0;
+  for (const ch of String(s == null ? '' : s)) {
+    w += /[\u1100-\u115F\u2E80-\uA4CF\uAC00-\uD7A3\uF900-\uFAFF\uFE30-\uFE4F\uFF00-\uFF60\uFFE0-\uFFE6]/.test(ch)
+      ? 2
+      : 1;
+  }
+  return w;
+}
+
+function pad(s, n) {
+  const str = String(s == null ? '' : s);
+  const w = dispWidth(str);
+  return w >= n ? str : str + ' '.repeat(n - w);
+}
+
+function parseArgs(argv) {
+  const opts = { name: '', page: 1, size: MAX_PAGE_SIZE, json: false };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const a = argv[i];
+    if (a === '--name' || a === '-n') {
+      opts.name = argv[i + 1] || '';
+      i += 1;
+    } else if (a === '--page') {
+      const v = Number(argv[i + 1]);
+      opts.page = Number.isFinite(v) && v > 0 ? v : 1;
+      i += 1;
+    } else if (a === '--size') {
+      const v = Number(argv[i + 1]);
+      opts.size = Number.isFinite(v) && v > 0 ? Math.min(v, MAX_PAGE_SIZE) : MAX_PAGE_SIZE;
+      i += 1;
+    } else if (a === '--all') {
+      opts.size = MAX_PAGE_SIZE;
+    } else if (a === '--json') {
+      opts.json = true;
+    } else if (!a.startsWith('-')) {
+      // 位置参数直接当作连接器名称关键词
+      opts.name = a;
+    }
+  }
+  return opts;
+}
+
+/**
+ * 查询连接器应用列表（供其他命令复用）。
+ * 覆盖接口：GET /index/sys/api/v1/platforms?platformName=&pageNum=1&pageSize=10000
+ */
+async function fetchPlatforms(cfg, cred, opts) {
+  const o = Object.assign({ name: '', page: 1, size: MAX_PAGE_SIZE }, opts || {});
+  const qs =
+    `/sys/api/v1/platforms?platformName=${encodeURIComponent(o.name || '')}` +
+    `&pageNum=${o.page}&pageSize=${o.size}`;
+
+  const res = await authedRequest(cfg, cred, 'GET', qs);
+  const json = res.json;
+
+  if (!json || typeof json !== 'object') {
+    throw new Error(`接口返回异常（HTTP ${res.status}）：${String(res.text).slice(0, 200)}`);
+  }
+  if (json.code !== 200) {
+    throw new Error(`查询连接器失败：code=${json.code} msg=${json.msg || '未知错误'}`);
+  }
+  const data = json.data || {};
+  const records = Array.isArray(data.records) ? data.records : [];
+  return {
+    total: typeof data.total === 'number' ? data.total : records.length,
+    records,
+    current: typeof data.current === 'number' ? data.current : o.page,
+    size: typeof data.size === 'number' ? data.size : o.size,
+    raw: json
+  };
+}
+
+/**
+ * 把「platformId 或连接器名称」解析成完整记录（含 hostBOList）。
+ * 创建 API 资源需要 platformHostId，它只在 hostBOList[0].platformHostId 里，所以必须拿整条记录。
+ *
+ * @returns {{platformId:string, platformName:string, platformHostId:string, host:string, hostBOList:object[], raw:object|null}}
+ */
+async function resolvePlatformRecord(cfg, cred, input, out) {
+  const raw = String(input == null ? '' : input).trim();
+  if (!raw) throw new Error('缺少 --platform（连接器 platformId 或名称）');
+
+  const byId = /^\d+$/.test(raw);
+  const { total, records } = await fetchPlatforms(cfg, cred, {
+    name: byId ? '' : raw,
+    size: MAX_PAGE_SIZE
+  });
+
+  let hit = null;
+  if (byId) {
+    hit = records.find((r) => String(r.platformId) === raw) || null;
+    if (!hit) {
+      // 全量里查不到也放行：可能刚好在分页外，交由调用方决定是否补 --host-id
+      return {
+        platformId: raw,
+        platformName: '',
+        platformHostId: '',
+        host: '',
+        hostBOList: [],
+        raw: null,
+        resolved: false
+      };
+    }
+  } else {
+    if (total === 0) {
+      throw new Error(`没有找到名称包含 "${raw}" 的连接器应用。\n        查看全部：wb platforms`);
+    }
+    if (total > 1) {
+      const rows = records.map((r, i) => [
+        String(i + 1),
+        String(r.platformName || ''),
+        String(r.platformId || ''),
+        String(r.platformType),
+        String(r.enabled)
+      ]);
+      out.write(`名称 "${raw}" 命中 ${total} 个连接器，请指定其中一个：\n\n`);
+      out.write(renderTable(['#', 'platformName', 'platformId', 'type', 'enabled'], rows) + '\n\n');
+      throw new Error('请用 --platform <platformId> 指定具体连接器（或给更精确的名称）');
+    }
+    hit = records[0];
+  }
+
+  const hostList = Array.isArray(hit.hostBOList) ? hit.hostBOList : [];
+  const first = hostList.find((h) => h && h.platformHostId) || hostList[0] || null;
+
+  return {
+    platformId: String(hit.platformId || ''),
+    platformName: String(hit.platformName || ''),
+    platformHostId: first ? String(first.platformHostId || '') : '',
+    host: first ? String(first.host || '') : '',
+    hostBOList: hostList,
+    raw: hit,
+    resolved: true
+  };
+}
+
+/**
+ * 查询应用连接器（platform）列表。
+ * - platformName 为模糊查询，大小写不敏感
+ * - 全量取数用 pageSize=10000（实际连接器数量不可能超过此值）
+ */
+async function commandPlatforms(cfg, argv) {
+  const opts = parseArgs(argv);
+
+  const cred = loadCredentials();
+  if (!cred || !cred.tokenValue) {
+    throw new Error('未登录或授权已失效，请先执行 auth login');
+  }
+
+  const { total, records, current, size, raw } = await fetchPlatforms(cfg, cred, {
+    name: opts.name,
+    page: opts.page,
+    size: opts.size
+  });
+
+  if (opts.json) {
+    process.stdout.write(JSON.stringify(raw, null, 2) + '\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  const keyword = opts.name ? `"${opts.name}"` : '（全部）';
+  process.stdout.write(`查询条件: platformName=${keyword}  pageNum=${current} pageSize=${size}\n`);
+  process.stdout.write(`共 ${total} 个连接器，本次返回 ${records.length} 条\n\n`);
+
+  if (!records.length) {
+    process.stdout.write('（无匹配结果）\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  const header = ['#', 'platformName', 'platformId', 'enabled', 'auth', 'type', 'groupName'];
+  const rows = records.map((r, i) => [
+    String(i + 1),
+    String(r.platformName || ''),
+    String(r.platformId || ''),
+    String(r.enabled),
+    String(r.authStatus),
+    String(r.platformType),
+    String(r.groupName || '')
+  ]);
+
+  const widths = header.map((h, ci) => Math.max(dispWidth(h), ...rows.map((row) => dispWidth(row[ci]))));
+
+  process.stdout.write(header.map((h, i) => pad(h, widths[i])).join('  ') + '\n');
+  process.stdout.write(widths.map((w) => '-'.repeat(w)).join('  ') + '\n');
+  for (const row of rows) {
+    process.stdout.write(row.map((c, i) => pad(c, widths[i])).join('  ') + '\n');
+  }
+
+  process.stdout.write(`\n提示：加 --json 可输出完整字段（含 apiHostPort、remark、createdAt 等）\n`);
+  process.exitCode = 0;
+}
+
+module.exports = { commandPlatforms, fetchPlatforms, resolvePlatformRecord, MAX_PAGE_SIZE };

package/src/commands/request.js

@@ -0,0 +1,55 @@
+'use strict';
+
+const fs = require('node:fs');
+const { loadCredentials } = require('../config');
+const { authedRequest } = require('../api');
+
+/**
+ * 通用带权请求：自动注入 Authorization: <tokenValue>
+ * 用法:
+ *   wb request GET  /sys/api/v1/user/list
+ *   wb request POST /sys/api/v1/xxx --data '{"a":1}'
+ *   wb request POST /sys/api/v1/xxx --data-file ./body.json
+ */
+async function commandRequest(cfg, argv) {
+  const args = argv.slice();
+  const method = (args[0] || 'GET').toUpperCase();
+  const pathname = args[1];
+  if (!pathname) {
+    throw new Error('用法: wb request <METHOD> <PATH> [--data <json>] [--data-file <file>] [--header k:v]');
+  }
+
+  const cred = loadCredentials();
+  if (!cred || !cred.tokenValue) {
+    throw new Error('未登录或授权已失效，请先执行 auth login');
+  }
+
+  let body;
+  const extraHeaders = {};
+
+  for (let i = 2; i < args.length; i += 1) {
+    const flag = args[i];
+    if (flag === '--data') {
+      body = args[i + 1];
+      i += 1;
+    } else if (flag === '--data-file') {
+      body = fs.readFileSync(args[i + 1], 'utf8');
+      i += 1;
+    } else if (flag === '--header') {
+      const raw = args[i + 1] || '';
+      const idx = raw.indexOf(':');
+      if (idx > 0) extraHeaders[raw.slice(0, idx).trim()] = raw.slice(idx + 1).trim();
+      i += 1;
+    }
+  }
+
+  const res = await authedRequest(cfg, cred, method, pathname, body, extraHeaders);
+  const out = res.json !== null ? JSON.stringify(res.json, null, 2) : res.text;
+  process.stdout.write(out + '\n');
+
+  if (res.status >= 400) {
+    process.exitCode = 1;
+  }
+}
+
+module.exports = { commandRequest };

package/src/commands/session.js

@@ -0,0 +1,119 @@
+'use strict';
+
+const { loadCredentials, clearCredentials, credMatchesBaseUrl } = require('../config');
+
+function maskToken(token) {
+  if (!token) return '';
+  if (token.length <= 8) return '****';
+  return token.slice(0, 4) + '****' + token.slice(-4);
+}
+
+/**
+ * 认证状态检测。契约（WorkBuddy 依此调度 auth）：
+ * - exit 0 表示已认证，非 0 表示未认证
+ * - 无副作用、只读本地持久化状态、10 秒内返回
+ * - --json 输出 {"connected":true|false,...}，供 cli.json 的 statusMatch 用 JSON 正则匹配；
+ *   相比文本匹配，它不会因文案改动而失效
+ */
+function authStatus(cfg, asJson) {
+  const cred = loadCredentials();
+  const hasCred = Boolean(cred && cred.tokenValue);
+  const currentBase = String(cfg.baseUrl || '').trim();
+  const connected = Boolean(hasCred && currentBase && credMatchesBaseUrl(cred, cfg));
+
+  if (connected) {
+    if (asJson) {
+      process.stdout.write(
+        JSON.stringify({
+          connected: true,
+          user: cred.nickName || cred.userName || 'unknown',
+          userName: cred.userName || '',
+          baseUrl: cred.baseUrl || cfg.baseUrl,
+          savedAt: cred.savedAt || ''
+        }) + '\n'
+      );
+    } else {
+      process.stdout.write('Logged in as ' + (cred.nickName || cred.userName || 'unknown') + '\n');
+    }
+    process.exitCode = 0;
+    return;
+  }
+
+  // 未连接时区分三种原因，便于给出不同的修复指引
+  let reason = 'no-credentials';
+  if (hasCred) reason = currentBase ? 'base-url-changed' : 'no-base-url';
+
+  if (reason === 'base-url-changed') {
+    process.stderr.write(
+      `平台地址已变更（凭证签发于 ${cred.baseUrl || '(空)'}，当前 ${currentBase}），需重新登录\n`
+    );
+  } else if (reason === 'no-base-url') {
+    process.stderr.write(
+      `平台地址未配置（凭证签发于 ${cred.baseUrl || '(空)'}），需重新登录并在登录页填写平台地址\n`
+    );
+  }
+
+  if (asJson) {
+    process.stdout.write(
+      JSON.stringify({
+        connected: false,
+        reason,
+        baseUrl: currentBase
+      }) + '\n'
+    );
+  } else {
+    process.stdout.write('Not logged in\n');
+  }
+  process.exitCode = 1;
+}
+
+/**
+ * 登出。必须幂等：未登录时也返回 0。
+ */
+function authLogout() {
+  const existed = Boolean(loadCredentials());
+  clearCredentials();
+  process.stdout.write(existed ? 'Logged out\n' : 'Already logged out\n');
+  process.exitCode = 0;
+}
+
+function whoami(cfg, asJson) {
+  const cred = loadCredentials();
+  if (!cred || !cred.tokenValue) {
+    process.stderr.write('Not logged in. 请先执行 wb auth login\n');
+    process.exitCode = 1;
+    return;
+  }
+  if (!credMatchesBaseUrl(cred, cfg)) {
+    process.stderr.write(
+      `平台地址已变更（凭证签发于 ${cred.baseUrl}，当前 ${cfg.baseUrl}），需重新登录后才有有效授权\n`
+    );
+  }
+
+  const view = {
+    userName: cred.userName || '',
+    nickName: cred.nickName || '',
+    userId: cred.userId || '',
+    deptId: cred.deptId || '',
+    deptCode: cred.deptCode || '',
+    roles: cred.roles || [],
+    tenant: cred.tenant || null,
+    baseUrl: cred.baseUrl || '',
+    tokenName: cred.tokenName || 'Authorization',
+    tokenValue: maskToken(cred.tokenValue),
+    savedAt: cred.savedAt || ''
+  };
+
+  if (asJson) {
+    process.stdout.write(JSON.stringify(view, null, 2) + '\n');
+  } else {
+    process.stdout.write(`用户: ${view.nickName} (${view.userName})\n`);
+    process.stdout.write(`用户ID: ${view.userId}\n`);
+    process.stdout.write(`角色: ${(view.roles || []).join(', ') || '-'}\n`);
+    process.stdout.write(`Token: ${view.tokenValue}\n`);
+    process.stdout.write(`登录时间: ${view.savedAt}\n`);
+  }
+  process.exitCode = 0;
+}
+
+module.exports = { authStatus, authLogout, whoami, maskToken };