hikvision-cli 1.0.0

package/src/commands/vehicle.ts

@@ -0,0 +1,572 @@
+/**
+ * 车辆管理命令
+ *
+ * 重要概念澄清（2026-05-23）：
+ * - 车辆群组：停车场功能，用于车辆出入控制
+ * - 车辆分类：系统预置分类（固定车、临时车等）+ 自定义群组
+ *
+ * 注意：车辆群组仅用于停车场管理，与人员通行无关
+ */
+
+import { Command } from 'commander';
+import { config } from '../utils/config';
+import { success, error, formatOutput, formatBatchResult } from '../utils/output';
+import { createHikvisionClient } from '../services/hikvisionClient';
+import { validateJsonFile } from '../utils/validation';
+
+export const vehicleCommands = new Command()
+  .name('vehicle')
+  .description('车辆管理');
+
+// ========== 车辆 CRUD ==========
+
+// 添加/更新车辆
+vehicleCommands
+  .command('add')
+  .description('添加或更新车辆')
+  .option('-pl, --plate-no <plateNo>', '车牌号')
+  .option('-pid, --person-id <personId>', '人员 ID')
+  .option('-pn, --person-name <personName>', '人员姓名')
+  .option('-o, --org <orgIndexCode>', '组织 ID')
+  .option('-on, --org-name <orgName>', '组织名称')
+  .option('-t, --type <type>', '车辆类型 (0:燃油, 1:新能源, 2:电动, 3:其他)', '0')
+  .option('-c, --color <color>', '车辆颜色')
+  .option('-m, --model <model>', '车辆型号')
+  .option('-g, --group-id <groupId>', '车辆群组编号')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      if (!options.plateNo) {
+        error('请指定车牌号 --plate-no 或 -pl');
+        return;
+      }
+      
+      // 如果指定了人员姓名，需要先查找人员 ID
+      let personId = options.personId;
+      if (!personId && options.personName) {
+        personId = await findPersonIdByName(client, options.personName, options.org, options.orgName);
+        if (!personId) {
+          error(`未找到名为 "${options.personName}" 的人员`);
+          return;
+        }
+      }
+      
+      const result = await client.vehicleService.saveOrUpdate({
+        plateNo: options.plateNo,
+        personId,
+        vehicleType: options.type as '0' | '1' | '2' | '3',
+        vehicleColor: options.color,
+        vehicleModel: options.model,
+        groupId: options.groupId,
+      });
+      
+      success('车辆添加/更新成功！');
+      console.log(formatOutput(result));
+    } catch (err: any) {
+      error(`添加/更新车辆失败: ${err.message || err}`);
+    }
+  });
+
+// 批量添加车辆
+vehicleCommands
+  .command('batch-add')
+  .description('批量添加车辆')
+  .option('-f, --file <file>', 'JSON 文件路径')
+  .action(async (options) => {
+    try {
+      if (!options.file) {
+        error('请指定 --file 参数');
+        return;
+      }
+
+      const fs = await import('fs');
+      // 验证 JSON 文件格式和内容
+      const validated = validateJsonFile(fs.readFileSync(options.file, 'utf-8'), {
+        requiredFields: ['vehicles'],
+        maxSize: 5 * 1024 * 1024, // 5MB
+      });
+      if (!validated.valid) {
+        error(validated.error || 'JSON 文件验证失败');
+        return;
+      }
+      const data = JSON.parse(validated.content);
+
+      const client = createHikvisionClient(config.get());
+      const result = await client.vehicleService.batchAdd(data.vehicles);
+      console.log(formatBatchResult(result));
+    } catch (err: any) {
+      error(`批量添加车辆失败: ${err.message || err}`);
+    }
+  });
+
+// 查询车辆列表
+vehicleCommands
+  .command('list')
+  .description('查询车辆列表')
+  .option('-p, --page <page>', '页码', '1')
+  .option('-s, --size <size>', '每页数量', '20')
+  .option('-pl, --plate-no <plateNo>', '车牌号搜索')
+  .option('-pid, --person-id <personId>', '人员 ID')
+  .option('-pn, --person-name <personName>', '人员姓名（模糊搜索）')
+  .option('-g, --group-id <groupId>', '车辆群组编号')
+  .option('-t, --type <type>', '车辆类型')
+  .option('-st, --status <status>', '状态 (0:正常, 1:禁用)')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      const result = await client.vehicleService.list({
+        pageNo: parseInt(options.page),
+        pageSize: parseInt(options.size),
+        plateNo: options.plateNo,
+        personId: options.personId,
+        groupId: options.groupId,
+        vehicleType: options.type as '0' | '1' | '2' | '3',
+        status: options.status as '0' | '1',
+      });
+      
+      console.log(formatOutput(result));
+    } catch (err: any) {
+      error(`查询车辆失败: ${err.message || err}`);
+    }
+  });
+
+// 修改车辆
+vehicleCommands
+  .command('update')
+  .description('修改车辆')
+  .option('-vid, --vehicle-id <vehicleId>', '车辆 ID')
+  .option('-pl, --plate-no <plateNo>', '车牌号（用于查找车辆）')
+  .option('-pid, --person-id <personId>', '人员 ID')
+  .option('-pn, --person-name <personName>', '人员姓名')
+  .option('-o, --org <orgIndexCode>', '组织 ID')
+  .option('-on, --org-name <orgName>', '组织名称')
+  .option('-t, --type <type>', '车辆类型 (0:燃油, 1:新能源, 2:电动, 3:其他)')
+  .option('-c, --color <color>', '车辆颜色')
+  .option('-m, --model <model>', '车辆型号')
+  .option('-g, --group-id <groupId>', '车辆群组编号')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      // 获取车辆 ID
+      let vehicleId = options.vehicleId;
+      if (!vehicleId && options.plateNo) {
+        const vehicle = await client.vehicleService.getByPlateNo(options.plateNo);
+        if (!vehicle || !vehicle.vehicleId) {
+          error(`未找到车牌号为 ${options.plateNo} 的车辆`);
+          return;
+        }
+        vehicleId = vehicle.vehicleId;
+      }
+      
+      if (!vehicleId) {
+        error('请提供 --vehicle-id 或 --plate-no');
+        return;
+      }
+      
+      // 如果指定了人员姓名，需要先查找人员 ID
+      let personId = options.personId;
+      if (!personId && options.personName) {
+        personId = await findPersonIdByName(client, options.personName, options.org, options.orgName);
+        if (!personId) {
+          error(`未找到名为 "${options.personName}" 的人员`);
+          return;
+        }
+      }
+      
+      const result = await client.vehicleService.update(vehicleId, {
+        plateNo: options.plateNo,
+        personId,
+        vehicleType: options.type as '0' | '1' | '2' | '3',
+        vehicleColor: options.color,
+        vehicleModel: options.model,
+        groupId: options.groupId,
+      } as any);
+      
+      success('车辆修改成功！');
+      console.log(formatOutput(result));
+    } catch (err: any) {
+      error(`修改车辆失败: ${err.message || err}`);
+    }
+  });
+
+// 删除车辆
+vehicleCommands
+  .command('delete')
+  .description('删除车辆')
+  .option('-vid, --vehicle-id <vehicleId>', '车辆 ID')
+  .option('-pl, --plate-no <plateNo>', '车牌号（用于查找车辆）')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      let vehicleId = options.vehicleId;
+      if (!vehicleId && options.plateNo) {
+        const vehicle = await client.vehicleService.getByPlateNo(options.plateNo);
+        if (!vehicle || !vehicle.vehicleId) {
+          error(`未找到车牌号为 ${options.plateNo} 的车辆`);
+          return;
+        }
+        vehicleId = vehicle.vehicleId;
+      }
+      
+      if (!vehicleId) {
+        error('请提供 --vehicle-id 或 --plate-no');
+        return;
+      }
+      
+      await client.vehicleService.delete(vehicleId);
+      success('车辆删除成功！');
+    } catch (err: any) {
+      error(`删除车辆失败: ${err.message || err}`);
+    }
+  });
+
+// ========== 车辆群组管理 ==========
+// API: /artemis/api/pms/v1/car/category/*
+/**
+ * 车辆群组管理命令
+ */
+const carGroupCommands = vehicleCommands
+  .command('car-group')
+  .description('车辆群组管理（停车场功能）');
+
+// 查询车辆群组列表
+carGroupCommands
+  .command('list')
+  .description('查询车辆群组列表（包括系统分类和自定义群组）')
+  .option('-t, --type <type>', '群组类型: all=全部, system=系统分类, custom=自定义群组', 'all')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      const groups = await client.vehicleService.listGroups();
+      
+      let filtered = groups;
+      if (options.type === 'system') {
+        filtered = groups.filter(g => g.type === 'system');
+      } else if (options.type === 'custom') {
+        filtered = groups.filter(g => g.type === 'custom');
+      }
+      
+      // 格式化输出
+      const data = filtered.map(g => ({
+        groupId: g.groupId,
+        groupName: g.groupName,
+        type: g.type === 'system' ? '系统分类' : '自定义群组',
+        description: g.description || '-',
+      }));
+      
+      console.log(formatOutput(data));
+    } catch (err: any) {
+      error(`查询车辆群组失败: ${err.message || err}`);
+    }
+  });
+
+// 添加车辆群组
+carGroupCommands
+  .command('add')
+  .description('添加车辆群组（自定义群组）')
+  .option('-n, --name <name>', '群组名称')
+  .option('-t, --type <type>', '群组类型 (0:内部, 1:外部)', '0')
+  .option('-d, --desc <desc>', '描述')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      if (!options.name) {
+        error('请提供群组名称 --name 或 -n');
+        return;
+      }
+      
+      const result = await client.vehicleService.addGroup({
+        groupName: options.name,
+        groupType: options.type as '0' | '1',
+        description: options.desc,
+      });
+      
+      success('车辆群组添加成功！');
+      console.log(formatOutput(result));
+    } catch (err: any) {
+      error(`添加车辆群组失败: ${err.message || err}`);
+    }
+  });
+
+// 更新车辆群组
+carGroupCommands
+  .command('update')
+  .description('更新车辆群组')
+  .option('-gid, --group-id <groupId>', '群组编号')
+  .option('-gn, --group-name <groupName>', '新群组名称')
+  .option('-d, --desc <desc>', '描述')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      if (!options.groupId) {
+        error('请提供群组编号 --group-id 或 -gid');
+        return;
+      }
+      
+      await client.vehicleService.updateGroup(options.groupId, {
+        groupName: options.groupName,
+        description: options.desc,
+      });
+      
+      success('车辆群组更新成功！');
+    } catch (err: any) {
+      error(`更新车辆群组失败: ${err.message || err}`);
+    }
+  });
+
+// 删除车辆群组
+carGroupCommands
+  .command('delete')
+  .description('删除车辆群组')
+  .option('-gid, --group-id <groupId>', '群组编号')
+  .option('-gn, --group-name <groupName>', '群组名称（自动查找）')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      let groupId = options.groupId;
+      if (!groupId && options.groupName) {
+        const groups = await client.vehicleService.listGroups();
+        const found = groups.find(g => g.groupName === options.groupName);
+        if (!found) {
+          error(`未找到名为 "${options.groupName}" 的群组`);
+          return;
+        }
+        groupId = found.groupId;
+        
+        // 检查是否为系统分类，不允许删除
+        if (found.type === 'system') {
+          error(`系统分类 "${options.groupName}" 不允许删除`);
+          return;
+        }
+      }
+      
+      if (!groupId) {
+        error('请提供群组编号 --group-id 或群组名称 --group-name');
+        return;
+      }
+      
+      await client.vehicleService.deleteGroup(groupId);
+      success('车辆群组删除成功！');
+    } catch (err: any) {
+      error(`删除车辆群组失败: ${err.message || err}`);
+    }
+  });
+
+// 绑定车辆到群组
+carGroupCommands
+  .command('bind')
+  .description('将车辆绑定到车辆群组（或从群组解绑）')
+  .option('-vid, --vehicle-ids <vehicleIds>', '车辆 ID 集合（逗号分隔）')
+  .option('-pl, --plate-no <plateNo>', '车牌号（单辆，用于自动查找车辆 ID）')
+  .option('-gid, --group-id <groupId>', '群组编号')
+  .option('-gn, --group-name <groupName>', '群组名称（自动查找群组编号）')
+  .option('-r, --region <regionIndexCode>', '区域编号', 'root00000000')
+  .option('-o, --operation <operation>', '操作: bind=绑定, unbind=解绑', 'bind')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      // 如果只提供了车牌号，需要先查找车辆 ID
+      let vehicleIds = options.vehicleIds;
+      if (!vehicleIds && options.plateNo) {
+        const vehicle = await client.vehicleService.getByPlateNo(options.plateNo);
+        if (!vehicle || !vehicle.vehicleId) {
+          error(`未找到车牌号为 ${options.plateNo} 的车辆`);
+          return;
+        }
+        vehicleIds = vehicle.vehicleId;
+      }
+      
+      if (!vehicleIds) {
+        error('请提供 --vehicle-ids 或 --plate-no');
+        return;
+      }
+      
+      // 如果提供了群组名称，需要查找群组编号
+      let groupId = options.groupId;
+      if (!groupId && options.groupName) {
+        const groups = await client.vehicleService.listGroups();
+        const found = groups.find(g => g.groupName === options.groupName);
+        if (!found) {
+          error(`未找到名为 "${options.groupName}" 的群组`);
+          return;
+        }
+        groupId = found.groupId;
+      }
+      
+      if (!groupId) {
+        error('请提供 --group-id 或 --group-name');
+        return;
+      }
+      
+      const operation = options.operation === 'bind' ? 1 : 2;
+      const results = await client.vehicleService.bindGroup(
+        vehicleIds,
+        groupId,
+        options.region,
+        operation
+      );
+      
+      if (operation === 1) {
+        success(`成功绑定 ${results.length} 辆车到群组`);
+      } else {
+        success(`成功从群组解绑 ${results.length} 辆车`);
+      }
+      console.log(formatOutput(results));
+    } catch (err: any) {
+      error(`车辆群组绑定/解绑失败: ${err.message || err}`);
+    }
+  });
+
+// ========== 停车场查询 ==========
+
+const parkingCommands = vehicleCommands
+  .command('parking')
+  .description('停车场基础信息查询');
+
+// 查询停车库列表
+parkingCommands
+  .command('lots')
+  .description('查询停车库列表')
+  .action(async () => {
+    try {
+      const client = createHikvisionClient(config.get());
+      const lots = await client.vehicleService.listParkingLots();
+      console.log(formatOutput(lots));
+    } catch (err: any) {
+      error(`查询停车库列表失败: ${err.message || err}`);
+    }
+  });
+
+// 查询出入口列表
+parkingCommands
+  .command('entrances')
+  .description('查询出入口列表')
+  .option('-pc, --park-codes <parkCodes>', '停车库编号（逗号分隔）')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      // 需要先获取停车库编号
+      let parkIndexCodes = options.parkCodes;
+      if (!parkIndexCodes) {
+        const lots = await client.vehicleService.listParkingLots();
+        if (lots.length > 0) {
+          parkIndexCodes = (lots as any[]).map(l => l.parkIndexCode).join(',');
+        }
+      }
+      
+      if (!parkIndexCodes) {
+        error('未找到停车库，请先配置停车库');
+        return;
+      }
+      
+      const entrances = await client.vehicleService.listEntrances(parkIndexCodes);
+      console.log(formatOutput(entrances));
+    } catch (err: any) {
+      error(`查询出入口列表失败: ${err.message || err}`);
+    }
+  });
+
+// 查询车道列表
+parkingCommands
+  .command('roadways')
+  .description('查询车道列表')
+  .option('-ec, --entrance-codes <entranceCodes>', '出入口编号（逗号分隔）')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      let entranceIndexCodes = options.entranceCodes;
+      if (!entranceIndexCodes) {
+        error('请提供出入口编号 --entrance-codes');
+        return;
+      }
+      
+      const roadways = await client.vehicleService.listRoadways(entranceIndexCodes);
+      console.log(formatOutput(roadways));
+    } catch (err: any) {
+      error(`查询车道列表失败: ${err.message || err}`);
+    }
+  });
+
+// ========== 数据同步 ==========
+
+// 增量同步车辆数据
+vehicleCommands
+  .command('sync')
+  .description('增量同步车辆数据')
+  .option('-s, --start <startTime>', '开始时间 (ISO8601格式)')
+  .option('-e, --end <endTime>', '结束时间 (ISO8601格式)')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      // 如果没有指定时间，使用默认时间范围（最近24小时）
+      let startTime = options.start;
+      let endTime = options.end;
+      
+      if (!startTime || !endTime) {
+        const now = new Date();
+        const yesterday = new Date(now.getTime() - 24 * 60 * 60 * 1000);
+        startTime = yesterday.toISOString();
+        endTime = now.toISOString();
+      }
+      
+      const result = await client.vehicleService.syncIncrement(startTime, endTime);
+      
+      console.log('增量同步完成！');
+      console.log(`新增: ${result.added.length} 条`);
+      console.log(`修改: ${result.modified.length} 条`);
+      console.log(`删除: ${result.deleted.length} 条`);
+      
+      if (result.added.length > 0) {
+        console.log('\n新增车辆:');
+        console.log(formatOutput(result.added));
+      }
+    } catch (err: any) {
+      error(`增量同步车辆数据失败: ${err.message || err}`);
+    }
+  });
+
+// ========== 辅助函数 ==========
+
+/**
+ * 根据人员姓名查找人员 ID
+ */
+async function findPersonIdByName(client: any, personName: string, orgIndexCode?: string, orgName?: string): Promise<string | undefined> {
+  try {
+    // 如果提供了组织名称，先查找组织编号
+    let targetOrgIndexCode = orgIndexCode;
+    if (!targetOrgIndexCode && orgName) {
+      const orgs = await client.personService.listOrganizations();
+      const found = orgs.find((o: any) => o.name === orgName || o.indexCode === orgName);
+      targetOrgIndexCode = found?.indexCode;
+    }
+    
+    // 搜索人员
+    const result = await client.personService.list({
+      personName,
+      regionIndexCode: targetOrgIndexCode,
+      pageNo: 1,
+      pageSize: 10,
+    });
+    
+    if (result.list && result.list.length > 0) {
+      // 精确匹配姓名
+      const exact = result.list.find((p: any) => p.personName === personName);
+      return exact?.personId || result.list[0]?.personId;
+    }
+    
+    return undefined;
+  } catch {
+    return undefined;
+  }
+}

package/src/index.ts

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * CLI 入口文件
+ */
+
+import { Command } from 'commander';
+import { config, ConfigManager } from './utils/config';
+import { success, error, info } from './utils/output';
+
+// 导入命令
+import { personCommands } from './commands/person';
+import { cardCommands } from './commands/card';
+import { vehicleCommands } from './commands/vehicle';
+import { groupCommands } from './commands/group';
+import { orgCommands } from './commands/org';
+import { syncCommands } from './commands/sync';
+import { systemCommands } from './commands/system';
+import { serviceCommands } from './commands/service';
+import { bindingCommands } from './commands/binding';
+
+const program = new Command();
+
+// 设置版本和描述
+program
+  .name('hikvision-cli')
+  .description('海康威视平台管理 CLI 工具')
+  .version('1.0.0');
+
+// 全局选项（注意：已移除 -k/-s 选项以防止密钥泄露到 shell 历史）
+program
+  .option('-h, --host <host>', '海康平台主机地址')
+  .option('-f, --format <format>', '输出格式 (table|json|yaml)', 'table')
+  .option('-v, --verbose', '详细输出');
+
+// 配置命令
+program
+  .command('config')
+  .description('管理 CLI 配置')
+  .command('show', { isDefault: true })
+  .description('显示当前配置（敏感信息已脱敏）')
+  .action(() => {
+    const cfg = config.get();
+    if (!cfg) {
+      console.log('⚠️ 未检测到配置');
+      return;
+    }
+    // 输出时脱敏敏感信息
+    console.log(JSON.stringify(config.maskSensitive(cfg), null, 2));
+  });
+
+program
+  .command('config set')
+  .description('设置配置项')
+  .argument('<key>', '配置键 (host|appKey|appSecret|outputFormat|pageSize|logLevel)')
+  .argument('<value>', '配置值')
+  .action((key, value) => {
+    config.update({ [key]: value });
+    success(`配置已更新: ${key} = ${value}`);
+  });
+
+program
+  .command('config reset')
+  .description('重置为默认配置')
+  .action(() => {
+    config.reset();
+    success('配置已重置为默认值');
+  });
+
+// 人员命令
+program.addCommand(personCommands);
+
+// 卡片命令
+program.addCommand(cardCommands);
+
+// 车辆命令
+program.addCommand(vehicleCommands);
+
+// 分组命令
+program.addCommand(groupCommands);
+
+// 组织命令
+program.addCommand(orgCommands);
+
+// 同步命令
+program.addCommand(syncCommands);
+
+// 系统命令
+program.addCommand(systemCommands);
+
+// 服务控制命令
+program.addCommand(serviceCommands);
+
+// 绑定管理命令
+program.addCommand(bindingCommands);
+
+// 全局前置检查：确保已配置
+function checkConfig(): void {
+  const command = process.argv[2];
+  if (command === 'config' || command === '--help' || command === '-h' || command === 'version' || command === '--version') {
+    return;
+  }
+  if (!config.isConfigured()) {
+    ConfigManager.promptConfig();
+    process.exit(1);
+  }
+}
+
+checkConfig();
+
+// 解析命令行
+program.parse();