hikvision-cli 1.0.0

package/src/commands/service.ts

@@ -0,0 +1,174 @@
+/**
+ * 服务控制命令
+ */
+
+import { Command } from 'commander';
+import { success, error, info } from '../utils/output';
+
+// Manager 服务地址（可通过环境变量覆盖）
+const MANAGER_HOST = process.env.MANAGER_HOST || 'http://localhost:3001';
+const API_KEY = process.env.MANAGER_API_KEY || '';
+
+// 安全警告：检测到使用 HTTP 连接非本地地址时警告
+function validateManagerHost(): void {
+  if (!MANAGER_HOST.startsWith('https://') && !MANAGER_HOST.includes('localhost') && !MANAGER_HOST.includes('127.0.0.1')) {
+    console.warn('⚠️ 安全警告：Manager 服务使用非安全连接 (HTTP)，敏感信息可能被盗用');
+  }
+}
+
+validateManagerHost();
+
+
+interface ServiceStatus {
+  isRunning: boolean;
+  pid: number | null;
+  port: number;
+}
+
+interface ApiResponse {
+  success: boolean;
+  message?: string;
+  data?: ServiceStatus;
+  pid?: number;
+}
+
+// 发送请求到 Manager
+async function managerRequest(path: string, method: string = 'GET'): Promise<ApiResponse> {
+  const url = `${MANAGER_HOST}${path}`;
+  const headers: Record<string, string> = {};
+  
+  // 添加 API Key 认证
+  if (API_KEY) {
+    headers['X-Api-Key'] = API_KEY;
+  }
+  
+  try {
+    const res = await fetch(url, { method, headers });
+    const data = await res.json();
+    return data as ApiResponse;
+  } catch (err: any) {
+    throw new Error(`无法连接 Manager 服务 (${MANAGER_HOST}): ${err.message}`);
+  }
+}
+
+// 格式化运行时间
+function formatUptime(seconds: number): string {
+  if (!seconds) return '-';
+  const h = Math.floor(seconds / 3600);
+  const m = Math.floor((seconds % 3600) / 60);
+  const s = Math.floor(seconds % 60);
+  return `${h}h ${m}m ${s}s`;
+}
+
+export const serviceCommands = new Command()
+  .name('service')
+  .description('API Server 服务控制');
+
+// 查询服务状态
+serviceCommands
+  .command('status')
+  .description('查询 API Server 服务状态')
+  .action(async () => {
+    try {
+      info('正在查询服务状态...');
+      const data = await managerRequest('/api/manager/status');
+      
+      if (!data.success) {
+        error(data.message || '查询失败');
+        return;
+      }
+      
+      const { isRunning, pid, port } = data.data || {};
+      
+      if (isRunning) {
+        console.log('🟢 API Server 服务状态: 运行中');
+        console.log(`   PID:   ${pid || '-'}`);
+        console.log(`   端口:  ${port || 3000}`);
+      } else {
+        console.log('🔴 API Server 服务状态: 已停止');
+      }
+    } catch (err: any) {
+      error(err.message);
+    }
+  });
+
+// 启动服务
+serviceCommands
+  .command('start')
+  .description('启动 API Server 服务')
+  .action(async () => {
+    try {
+      info('正在启动服务...');
+      const data = await managerRequest('/api/manager/start', 'POST');
+      
+      if (data.success) {
+        success(data.message || '服务已启动');
+      } else {
+        error(data.message || '启动失败');
+      }
+    } catch (err: any) {
+      error(err.message);
+    }
+  });
+
+// 停止服务
+serviceCommands
+  .command('stop')
+  .description('停止 API Server 服务')
+  .action(async () => {
+    try {
+      info('正在停止服务...');
+      const data = await managerRequest('/api/manager/stop', 'POST');
+      
+      if (data.success) {
+        success(data.message || '服务已停止');
+      } else {
+        error(data.message || '停止失败');
+      }
+    } catch (err: any) {
+      error(err.message);
+    }
+  });
+
+// 重启服务
+serviceCommands
+  .command('restart')
+  .description('重启 API Server 服务')
+  .action(async () => {
+    try {
+      info('正在重启服务...');
+      const data = await managerRequest('/api/manager/restart', 'POST');
+      
+      if (data.success) {
+        success(data.message || '服务已重启');
+      } else {
+        error(data.message || '重启失败');
+      }
+    } catch (err: any) {
+      error(err.message);
+    }
+  });
+
+// 查看 Manager 状态
+serviceCommands
+  .command('info')
+  .description('查看 Manager 服务信息')
+  .action(async () => {
+    try {
+      info('正在查询 Manager 状态...');
+      const data = await managerRequest('/api/manager/status');
+      
+      if (!data.success) {
+        error(data.message || '查询失败');
+        return;
+      }
+      
+      console.log('📋 Manager 服务信息:');
+      console.log(`   地址:    ${MANAGER_HOST}`);
+      console.log(`   状态:    ${data.data?.isRunning ? '运行中' : '已停止'}`);
+      console.log(`   API Server PID: ${data.data?.pid || '-'}`);
+      console.log(`   API Server 端口: ${data.data?.port || 3000}`);
+    } catch (err: any) {
+      error(err.message);
+    }
+  });

package/src/commands/sync.ts

@@ -0,0 +1,156 @@
+/**
+ * 数据同步命令
+ */
+
+import { Command } from 'commander';
+import { config } from '../utils/config';
+import { success, error, formatOutput } from '../utils/output';
+import { createHikvisionClient } from '../services/hikvisionClient';
+
+export const syncCommands = new Command()
+  .command('sync')
+  .description('数据同步');
+
+// 同步人员数据
+syncCommands
+  .command('persons')
+  .description('同步人员数据（增量）')
+  .option('-s, --start <startTime>', '开始时间 (YYYY-MM-DD HH:mm:ss)')
+  .option('-e, --end <endTime>', '结束时间 (YYYY-MM-DD HH:mm:ss)', new Date().toISOString().slice(0, 19))
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      const result = await client.personService.syncIncrement(
+        options.start || new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString().slice(0, 19),
+        options.end
+      );
+      
+      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));
+      }
+      if (result.modified.length > 0) {
+        console.log('\n修改人员:');
+        console.log(formatOutput(result.modified));
+      }
+    } catch (err: any) {
+      error(`同步人员数据失败: ${err.message || err}`);
+    }
+  });
+
+// 同步卡片数据
+syncCommands
+  .command('cards')
+  .description('同步卡片数据（增量）')
+  .option('-s, --start <startTime>', '开始时间 (YYYY-MM-DD HH:mm:ss)')
+  .option('-e, --end <endTime>', '结束时间 (YYYY-MM-DD HH:mm:ss)', new Date().toISOString().slice(0, 19))
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      const result = await client.cardService.syncIncrement(
+        options.start || new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString().slice(0, 19),
+        options.end
+      );
+      
+      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}`);
+    }
+  });
+
+// 同步车辆数据
+syncCommands
+  .command('vehicles')
+  .description('同步车辆数据（增量）')
+  .option('-s, --start <startTime>', '开始时间 (YYYY-MM-DD HH:mm:ss)')
+  .option('-e, --end <endTime>', '结束时间 (YYYY-MM-DD HH:mm:ss)', new Date().toISOString().slice(0, 19))
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      const result = await client.vehicleService.syncIncrement(
+        options.start || new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString().slice(0, 19),
+        options.end
+      );
+      
+      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}`);
+    }
+  });
+
+// 全量同步
+syncCommands
+  .command('full')
+  .description('全量同步所有数据')
+  .action(async () => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      console.log('🔄 开始全量同步...');
+      
+      // 同步人员
+      console.log('\n📋 同步人员...');
+      let page = 1;
+      let allPersons: any[] = [];
+      while (true) {
+        const result = await client.personService.list({ pageNo: page, pageSize: 100 });
+        allPersons = allPersons.concat(result.list);
+        if (result.list.length < 100) break;
+        page++;
+      }
+      console.log(`  ✅ 人员: ${allPersons.length} 条`);
+      
+      // 同步卡片
+      console.log('\n📇 同步卡片...');
+      page = 1;
+      let allCards: any[] = [];
+      while (true) {
+        const result = await client.cardService.list({ pageNo: page, pageSize: 100 });
+        allCards = allCards.concat(result.list);
+        if (result.list.length < 100) break;
+        page++;
+      }
+      console.log(`  ✅ 卡片: ${allCards.length} 条`);
+      
+      // 同步车辆
+      console.log('\n🚗 同步车辆...');
+      page = 1;
+      let allVehicles: any[] = [];
+      while (true) {
+        const result = await client.vehicleService.list({ pageNo: page, pageSize: 100 });
+        allVehicles = allVehicles.concat(result.list);
+        if (result.list.length < 100) break;
+        page++;
+      }
+      console.log(`  ✅ 车辆: ${allVehicles.length} 条`);
+      
+      console.log('\n✅ 全量同步完成！');
+      console.log(`总计: ${allPersons.length + allCards.length + allVehicles.length} 条记录`);
+    } catch (err: any) {
+      error(`全量同步失败: ${err.message || err}`);
+    }
+  });

package/src/commands/system.ts

@@ -0,0 +1,137 @@
+/**
+ * 系统管理命令
+ */
+
+import { Command } from 'commander';
+import { config } from '../utils/config';
+import { success, error, info, formatOutput } from '../utils/output';
+
+export const systemCommands = new Command()
+  .command('system')
+  .description('系统管理');
+
+// 测试连接
+systemCommands
+  .command('test')
+  .description('测试与海康平台连接')
+  .action(async () => {
+    try {
+      const cfg = config.get();
+      if (!cfg) {
+        error('未检测到配置，请先运行 `hikvision-cli config set` 进行配置');
+        return;
+      }
+      info(`正在连接海康平台: ${cfg.host}...`);
+      
+      // 这里可以调用一个简单的 API 测试连接
+      // 暂时用组织查询作为连接测试
+      const { createHikvisionClient } = await import('../services/hikvisionClient');
+      const client = createHikvisionClient(cfg);
+      
+      const orgs = await client.personService.getOrganizations();
+      
+      success(`连接成功！平台返回 ${orgs.length} 个组织`);
+    } catch (err: any) {
+      error(`连接失败: ${err.message || err}`);
+    }
+  });
+
+// 显示配置
+systemCommands
+  .command('config')
+  .description('显示当前配置（敏感信息已脱敏）')
+  .action(() => {
+    const cfg = config.get();
+    if (!cfg) {
+      info('⚠️ 未检测到配置，请运行 `hikvision-cli config set` 进行配置');
+      return;
+    }
+    console.log('📋 当前配置（敏感信息已脱敏）:');
+    console.log(formatOutput(config.maskSensitive(cfg)));
+  });
+
+// 显示帮助
+systemCommands
+  .command('help')
+  .description('显示帮助信息')
+  .action(() => {
+    console.log(`
+📖 Hikvision CLI 使用帮助
+
+🔧 基本用法:
+  hikvision-cli <command> [options]
+
+📋 可用命令:
+
+  person        人员管理
+    add         新增人员
+    list        查询人员列表
+    get         查询人员详情
+    update      修改人员
+    delete      删除人员
+    orgs        获取组织列表
+
+  card          卡片管理
+    bind        绑定卡片（将卡片与人员绑定）
+    list        查询卡片列表
+    unbind      退卡
+    loss        批量挂失
+    unloss      批量解挂
+
+  vehicle       车辆管理
+    add         添加/更新车辆
+    batch-add   批量添加车辆
+    list        查询车辆列表
+    get         查询车辆详情
+    delete      删除车辆
+    groups      查询车辆群组
+    add-group   添加车辆群组
+    delete-group 删除车辆群组
+
+  group         车辆群组管理
+    list        查询分组列表
+    add         添加分组
+    update      修改分组
+    delete      删除分组
+
+  org           组织管理
+    list        查询组织列表
+    get         查询组织详情
+    search      搜索组织
+
+  sync          数据同步
+    persons     同步人员数据
+    cards       同步卡片数据
+    vehicles    同步车辆数据
+    full        全量同步
+
+  system        系统管理
+    test        测试连接
+    config      显示配置
+    help        显示帮助
+
+💡 全局选项:
+  -h, --host <host>      海康平台主机地址
+  -k, --key <key>        App Key
+  -s, --secret <secret>  App Secret
+  -f, --format <format>  输出格式 (table|json|yaml)
+  -v, --verbose          详细输出
+
+📄 示例:
+  # 新增人员
+  hikvision-cli person add -n "张三" -p "13800138000" -o "root00000000"
+
+  # 查询人员列表
+  hikvision-cli person list -p 1 -s 20
+
+  # 批量开卡
+  hikvision-cli card issue -f cards.json
+
+  # 测试连接
+  hikvision-cli system test
+
+  # 全量同步
+  hikvision-cli sync full
+
+`);
+  });