@cpzxrobot/sdk 1.2.12 → 1.2.14

package/device_gateway.ts

@@ -7,6 +7,59 @@ import type {
   DeviceV2,
   Factory,
 } from ".";
+
+class DeviceFault {
+  category: string;
+  time: Date;
+  resolved: boolean;
+  repeated?: number;
+  value?: any;
+  message?: string;
+
+  constructor(params: {
+    category: string;
+    time: Date;
+    resolved: boolean;
+    repeated?: number;
+    value?: any;
+    message?: string;
+  });
+  constructor(values: string[], columns: string[]);
+  constructor(paramsOrValues: any, columns?: string[]) {
+    if (Array.isArray(paramsOrValues)) {
+      // 处理values和columns的构造函数
+      const values = paramsOrValues;
+      const params: any = {};
+      for (let i = 0; i < columns!.length; i++) {
+        const column = columns![i];
+        const value = values[i];
+        
+        if (column === 'category') params.category = value;
+        else if (column === 'time') params.time = new Date(value);
+        else if (column === 'resolved') params.resolved = value === 'true';
+        else if (column === 'repeated') params.repeated = parseInt(value);
+        else if (column === 'value') params.value = value;
+        else if (column === 'message') params.message = value;
+      }
+      
+      this.category = params.category;
+      this.time = params.time;
+      this.resolved = params.resolved;
+      this.repeated = params.repeated;
+      this.value = params.value;
+      this.message = params.message;
+    } else {
+      // 处理原始对象参数的构造函数
+      const params = paramsOrValues;
+      this.category = params.category;
+      this.time = params.time;
+      this.resolved = params.resolved;
+      this.repeated = params.repeated;
+      this.value = params.value;
+      this.message = params.message;
+    }
+  }
+}
 import { FeedTowerGateway } from "./device_types/feedtower";
 import { ElectricMeterGateway } from "./device_types/electricmeter";
 import { NormalGateway } from "./device_types/normal_type";
@@ -55,7 +108,7 @@ export class DeviceGateway extends Object {
         workshopId?: number;
         factoryId?: number;
         companyId?: number;
-      },params:any= undefined) => {
+      }, params: any = undefined) => {
         let axios = await this.context.ready;
         var url = `/api/v2/device/list`;
         if (params) {
@@ -76,7 +129,7 @@ export class DeviceGateway extends Object {
         });
       },
 
-      preview: async (type:String, sn:any) => {
+      preview: async (type: String, sn: any) => {
         let axios = await this.context.ready;
 
         return axios.get(`/api/v2/device/iotValue/${type}/${sn}`).then((res) => {
@@ -215,11 +268,55 @@ export class DeviceGateway extends Object {
     return this.normalFilter.getData(id, args);
   }
 
-  async validate(serialNumbers: string[],type: string = "pywl") {
+  async validate(serialNumbers: string[], type: string = "pywl") {
     let axios = await this.context.ready;
     return axios.post(`/api/v2/device/validateSerialNumber`, {
       serialNumbers,
       type,
     });
   }
+
+  async faults(deviceId: number, startTime: Date, endTime: Date): Promise<DeviceFault[]> {
+    let axios = await this.context.ready;
+    const startTimeRfc3339 = startTime.toISOString();
+    const endTimeRfc3339 = endTime.toISOString();
+
+    const response = await axios.get(
+      `/api/v1/device/${deviceId}/faults?start=${startTimeRfc3339}&stop=${endTimeRfc3339}`
+    );
+
+    const json = response.data;
+    var faultsData = json.faults as string;
+
+// #group,false,false,true,true,false,false,true,true,true,true,true,true
+// #datatype,string,long,dateTime:RFC3339,dateTime:RFC3339,dateTime:RFC3339,boolean,string,string,string,string,string,string
+// #default,last,,,,,,,,,,,
+// ,result,table,_start,_stop,_time,_value,DeviceId,_field,_measurement,category,field,status
+// ,,0,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:27:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,bool_value,DeviceStatus,离线报警,online,fault
+// ,,0,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:30:00Z,true,004a05c1-7b5b-471c-ab68-f583039ddcfe,bool_value,DeviceStatus,离线报警,online,fault
+// ,,1,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:27:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,repeated,DeviceStatus,离线报警,online,fault
+// ,,1,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:30:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,repeated,DeviceStatus,离线报警,online,fault
+// ,,2,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:27:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,resolved,DeviceStatus,离线报警,online,fault
+// ,,2,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:30:00Z,true,004a05c1-7b5b-471c-ab68-f583039ddcfe,resolved,DeviceStatus,离线报警,online,fault
+
+    faultsData = faultsData.replace(/\r/g, "");
+    var arr = faultsData.split("\n");
+    var inAnnotation = false;
+    var columns: string[] = [];
+    var faults: DeviceFault[] = [];
+    for (var i = 0; i < arr.length; i++) {
+      var values = arr[i].split(",");
+      if (arr[i].startsWith("#")) {
+      } else if (arr[i] != "") {
+        if (inAnnotation) {
+          inAnnotation = false;
+          columns = values;
+        } else {
+          faults.push(new DeviceFault(values, columns));
+        }
+      }
+    }
+    return faults;
+
+  }
 }

package/device_types/readme.md

@@ -1,3 +1,4 @@
 # 分类型的设备获取类
 
 ## 最简易模型参考[这里](./normal.ts)
+

package/dist/device_gateway.js

@@ -2,6 +2,47 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeviceGateway = void 0;
 const device_type_gateway_1 = require("./device_type_gateway");
+class DeviceFault {
+    constructor(paramsOrValues, columns) {
+        if (Array.isArray(paramsOrValues)) {
+            // 处理values和columns的构造函数
+            const values = paramsOrValues;
+            const params = {};
+            for (let i = 0; i < columns.length; i++) {
+                const column = columns[i];
+                const value = values[i];
+                if (column === 'category')
+                    params.category = value;
+                else if (column === 'time')
+                    params.time = new Date(value);
+                else if (column === 'resolved')
+                    params.resolved = value === 'true';
+                else if (column === 'repeated')
+                    params.repeated = parseInt(value);
+                else if (column === 'value')
+                    params.value = value;
+                else if (column === 'message')
+                    params.message = value;
+            }
+            this.category = params.category;
+            this.time = params.time;
+            this.resolved = params.resolved;
+            this.repeated = params.repeated;
+            this.value = params.value;
+            this.message = params.message;
+        }
+        else {
+            // 处理原始对象参数的构造函数
+            const params = paramsOrValues;
+            this.category = params.category;
+            this.time = params.time;
+            this.resolved = params.resolved;
+            this.repeated = params.repeated;
+            this.value = params.value;
+            this.message = params.message;
+        }
+    }
+}
 const feedtower_1 = require("./device_types/feedtower");
 const electricmeter_1 = require("./device_types/electricmeter");
 const normal_type_1 = require("./device_types/normal_type");
@@ -154,5 +195,43 @@ class DeviceGateway extends Object {
             type,
         });
     }
+    async faults(deviceId, startTime, endTime) {
+        let axios = await this.context.ready;
+        const startTimeRfc3339 = startTime.toISOString();
+        const endTimeRfc3339 = endTime.toISOString();
+        const response = await axios.get(`/api/v1/device/${deviceId}/faults?start=${startTimeRfc3339}&stop=${endTimeRfc3339}`);
+        const json = response.data;
+        var faultsData = json.faults;
+        // #group,false,false,true,true,false,false,true,true,true,true,true,true
+        // #datatype,string,long,dateTime:RFC3339,dateTime:RFC3339,dateTime:RFC3339,boolean,string,string,string,string,string,string
+        // #default,last,,,,,,,,,,,
+        // ,result,table,_start,_stop,_time,_value,DeviceId,_field,_measurement,category,field,status
+        // ,,0,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:27:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,bool_value,DeviceStatus,离线报警,online,fault
+        // ,,0,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:30:00Z,true,004a05c1-7b5b-471c-ab68-f583039ddcfe,bool_value,DeviceStatus,离线报警,online,fault
+        // ,,1,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:27:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,repeated,DeviceStatus,离线报警,online,fault
+        // ,,1,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:30:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,repeated,DeviceStatus,离线报警,online,fault
+        // ,,2,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:27:00Z,false,004a05c1-7b5b-471c-ab68-f583039ddcfe,resolved,DeviceStatus,离线报警,online,fault
+        // ,,2,2025-04-20T22:07:43.623582865Z,2025-04-21T04:07:43.623582865Z,2025-04-21T00:30:00Z,true,004a05c1-7b5b-471c-ab68-f583039ddcfe,resolved,DeviceStatus,离线报警,online,fault
+        faultsData = faultsData.replace(/\r/g, "");
+        var arr = faultsData.split("\n");
+        var inAnnotation = false;
+        var columns = [];
+        var faults = [];
+        for (var i = 0; i < arr.length; i++) {
+            var values = arr[i].split(",");
+            if (arr[i].startsWith("#")) {
+            }
+            else if (arr[i] != "") {
+                if (inAnnotation) {
+                    inAnnotation = false;
+                    columns = values;
+                }
+                else {
+                    faults.push(new DeviceFault(values, columns));
+                }
+            }
+        }
+        return faults;
+    }
 }
 exports.DeviceGateway = DeviceGateway;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cpzxrobot/sdk",
-  "version": "1.2.12",
+  "version": "1.2.14",
   "description": "提供给上海正芯数智APP第三方H5应用使用的SDK",
   "main": "dist/index.js",
   "scripts": {

package/readme.md

@@ -1,22 +1,618 @@
-# 正芯数智SDK
+# 正芯数智SDK 文档
 
+## 目录
+- [概述](#概述)
+- [快速开始](#快速开始)
+  - [安装](#安装)
+  - [初始化](#初始化)
+  - [开发环境配置](#开发环境配置)
+- [核心功能模块](#核心功能模块)
+- [接口参考](#接口参考)
+  - [工厂管理](#工厂管理)
+  - [设备管理](#设备管理)
+  - [摄像头管理](#摄像头管理)
+  - [保温灯管理](#保温灯管理)
+  - [用户管理](#用户管理)
+  - [项目管理](#项目管理)
+  - [合同管理](#合同管理)
+  - [日志管理](#日志管理)
+- [附录](#附录)
+  - [通用参数说明](#通用参数说明)
+  - [错误处理](#错误处理)
+  - [常见错误码](#常见错误码)
+
+## 概述
 这是提供给上海正芯数智APP第三方H5应用使用的SDK模块，包含相关物联网设备的获取方式和接口功能
 
-## 1、使用方式
+## 快速开始
+### 安装
+```bash
+npm i @cpzxrobot/sdk
+```
+
+### 初始化
+```javascript
+import cpzxrobot from "@cpzxrobot/sdk"
 
+cpzxrobot({
+  devAuth: "从上海正芯获得的开发临时token",
+  appCode: "上海正芯分配的App Code",
+  selectedFarm: {
+    code: "xxxx",
+    company_code: "xxxx",
+    id: 123456,
+    name: "自定义用户测试的工厂，请从后台根据业务选择合适的工厂",
+  },
+  selectedUnit: {
+    id: 123456,
+    name: "自定义用户测试的单元，请从后台根据业务选择合适的单元",
+    workshopName: 'A栋'
+  },
+});
 ```
-npm i @cpzxrobot/sdk
+
+### 开发环境配置
+如果出现CORS问题，请配置代理：
+```javascript
+// vite.config.js
+server: {
+  proxy: {
+    "/api": {
+      target: "https://www.cpzxrobot.com/",
+      changeOrigin: true,
+    },
+  },
+}
 ```
 
-## 2、开发指南
+## 核心功能模块
+1. 工厂管理
+2. 设备管理
+3. 摄像头管理
+4. 料塔管理
+5. 保温灯管理
+6. 用户管理
+7. 项目管理
+8. 合同管理
+9. 客户管理
+10. 公司管理
+11. 车辆管理
+12. 新闻管理
+13. 日志管理
 
-### 2.1、引入包
+## 接口参考
+### 工厂管理
+#### 获取工厂信息
+```javascript
+cpzxrobot().factory.workshops(factory_id)
+```
+参数：
+- factory_id: 工厂id
 
+#### 获取工厂单元
+```javascript
+cpzxrobot().factory.units(factory_id)
 ```
-import cpzxrobot from "@cpzxrobot/sdk"
+参数：
+- factory_id: 工厂id
+
+### 设备管理
+#### 设备基础接口
+```javascript
+// 获取设备列表
+cpzxrobot().device.list()
+
+// 获取单个设备数据  
+cpzxrobot().device.data(deviceId)
+
+// 验证设备有效性
+cpzxrobot().device.validate(serialNumbers)
+
+// 获取设备报警阈值
+cpzxrobot().device.thresholdConfig.list()
+
+// 获取设备报警列表
+
+## faults函数说明
+
+获取设备故障记录
+
+### 参数
+- `deviceId`: number - 设备ID
+- `startTime`: Date - 开始时间
+- `endTime`: Date - 结束时间
+
+### 返回值
+Promise<DeviceFault[]> - 按时间排序的故障记录数组
+
+### 使用示例
+```typescript
+const faults = await cpzxrobot().device.faults(
+  123, 
+  new Date('2023-01-01'),
+  new Date('2023-01-31')
+);
+
+faults.forEach(fault => {
+  console.log(`时间: ${fault.time}, 类别: ${fault.category}`);
+});
 ```
 
-### 2.2、配置开发信息
+### DeviceFault接口
+```typescript
+interface DeviceFault {
+  category: string; // 故障类别
+  time: Date;      // 发生时间
+  resolved: boolean; // 是否已解决
+  repeated?: number; // 重复次数(可选)
+  value?: any;      // 故障值(可选)
+  message?: string;  // 故障消息(可选)
+}
+```
+
+#### 料塔设备接口
+```javascript 
+// 获取料塔列表
+cpzxrobot().device.feedTower.list()
+cpzxrobot().device.feedTower.v2.list()
+
+// 料塔清零
+cpzxrobot().device.feedTower.v2.adzero(towerId)
+
+// 获取料塔统计
+cpzxrobot().device.feedTower.stat(towerId)
+
+// 料塔报警参数
+cpzxrobot().device.feedTower.setAlarmParam(params)
+cpzxrobot().device.feedTower.getAlarmParam(towerId)
+cpzxrobot().device.feedTower.updateAlarmParam(params)
+```
+
+#### 设备管理V2接口
+```javascript
+// 设备增删改查
+cpzxrobot().device.v2.add(deviceInfo)
+cpzxrobot().device.v2.update(deviceInfo) 
+cpzxrobot().device.v2.list(params)
+cpzxrobot().device.v2.delete(deviceId)
+```
+
+#### 设备故障记录
+```javascript
+// 获取设备故障记录
+cpzxrobot().device.faults(deviceId, startTime, endTime)
+```
+
+### 摄像头管理
+#### 摄像头搜索
+```javascript
+// 按单元搜索
+cpzxrobot().camera.search({unit_id: unitId})
+
+// 按工厂搜索 
+cpzxrobot().camera.search({factory_id: factoryId})
+
+// 按车间搜索
+cpzxrobot().camera.search({workshop_id: workshopId})
+```
+
+#### 摄像头控制
+```javascript
+// 控制摄像头移动
+cpzxrobot().camera.control({
+  cameraId: string,
+  direction: 'left'|'right'|'up'|'down',
+  start: boolean, // 开始移动
+  stop: boolean   // 停止移动
+})
+
+// 默认3秒自动停止
+cpzxrobot().camera.control({
+  cameraId: string,
+  direction: 'left'|'right'|'up'|'down' 
+})
+```
+
+#### 摄像头状态获取
+```javascript
+// 获取摄像头实时画面
+cpzxrobot().camera.liveView(cameraId)
+
+// 获取摄像头信息
+cpzxrobot().camera.info(cameraId)
+
+// 获取摄像头历史记录
+cpzxrobot().camera.history(cameraId, startTime, endTime)
+```
+
+### 保温灯管理
+#### 保温灯配置管理
+```javascript
+// 添加保温灯配置
+cpzxrobot().pigfarm.heatlamp.add(unitId, {
+  name: string,
+  dayAge: number,
+  temperature: number
+})
+
+// 获取保温灯列表
+cpzxrobot().pigfarm.heatlamp.list(unitId)
+
+// 获取保温灯详情
+cpzxrobot().pigfarm.heatlamp.get(heatlampId)
+
+// 更新保温灯配置
+cpzxrobot().pigfarm.heatlamp.update({
+  id: number,
+  name?: string,
+  dayAge?: number,
+  temperature?: number
+})
+```
+
+#### 保温灯状态控制
+```javascript
+// 设置保温灯工作日龄
+cpzxrobot().pigfarm.heatlamp.set(heatlampId, {
+  action: "dayage",
+  argc: number // 天数
+})
+
+// 开关保温灯
+cpzxrobot().pigfarm.heatlamp.switch(heatlampId, {
+  action: "on"|"off"
+})
+
+// 按单元批量控制
+cpzxrobot().pigfarm.heatlamp.switchByUnit(unitId, {
+  action: "on"|"off"
+})
+
+// 获取任务状态
+cpzxrobot().pigfarm.heatlamp.taskStatus(taskId)
+```
+
+#### 保温灯模板管理
+```javascript
+// 添加保温灯模板
+cpzxrobot().pigfarm.heatlamp.template.add({
+  name: string,
+  stages: Array<{
+    dayAge: number,
+    temperature: number
+  }>
+})
+
+// 获取模板列表
+cpzxrobot().pigfarm.heatlamp.template.list()
+```
+
+#### 单元统计信息
+```javascript
+// 获取单元统计信息
+cpzxrobot().pigfarm.unitStat(unitId)
+
+// 获取单元阈值配置
+cpzxrobot().unit.thresholdConfig.get(unitId)
+
+// 绑定单元阈值配置
+cpzxrobot().unit.thresholdConfig.bind(unitId, config)
+```
+
+### 用户管理
+#### 用户基础操作
+```javascript
+// 添加用户
+cpzxrobot().user.add({
+  name: string,
+  mobile: string,
+  roleId: number,
+  factoryId: number
+})
+
+// 更新用户信息
+cpzxrobot().user.update(userId, {
+  name?: string,
+  mobile?: string,
+  roleId?: number
+})
+
+// 获取用户列表
+cpzxrobot().user.list({
+  factoryId: number,
+  page?: number,
+  size?: number
+})
+
+// 获取用户详情
+cpzxrobot().user.info(userId)
+
+// 按角色获取用户
+cpzxrobot().user.listByRole({
+  companyId: number,
+  roleId: number
+})
+```
+
+#### 用户审批流程
+```javascript
+// 获取审批列表
+cpzxrobot().user.approval.list({
+  userId: number,
+  status: 'pending'|'approved'|'rejected'
+})
+
+// 获取审批数量
+cpzxrobot().user.approval.count({
+  userId: number,
+  status: 'pending'|'approved'|'rejected'
+})
+
+// 提交审批
+cpzxrobot().user.approval.submit({
+  userId: number,
+  type: string,
+  content: string
+})
+```
+
+#### 用户考勤管理
+```javascript
+// 添加签到记录
+cpzxrobot().user.checkin.add({
+  userId: number,
+  address: string
+})
+
+// 获取签到记录
+cpzxrobot().user.checkin.list({
+  userId: number,
+  date: string // YYYY-MM-DD
+})
+```
+
+#### 用户工作报告
+```javascript
+// 获取工作报告列表
+cpzxrobot().user.workReport.list(userId)
+
+// 添加工作报告
+cpzxrobot().user.workReport.add({
+  userId: number,
+  content: string
+})
+
+// 更新工作报告
+cpzxrobot().user.workReport.update(reportId, {
+  content: string
+})
+```
+
+#### 用户统计分析
+```javascript
+// 全国用户统计
+cpzxrobot().user.stat.china()
+
+// 按地区统计
+cpzxrobot().user.listByProvince(province)
+cpzxrobot().user.listByCity(city)
+
+// 部门关系查询
+cpzxrobot().user.position.leader() // 获取领导信息
+cpzxrobot().user.position.team()   // 获取下属团队
+```
+
+### 项目管理
+#### 项目基础信息
+```javascript
+// 获取项目列表
+cpzxrobot().project.list({
+  factoryId: number,
+  page?: number,
+  size?: number
+})
+
+// 获取项目详情
+cpzxrobot().project.get(projectId)
+
+// 全国项目统计
+cpzxrobot().project.stat.china()
+
+// 按地区统计
+cpzxrobot().project.listByProvince(province)
+```
+
+#### 项目反馈管理
+```javascript
+// 获取反馈列表
+cpzxrobot().project.feedback.list(projectId)
+
+// 添加项目反馈
+cpzxrobot().project.feedback.add({
+  projectId: number,
+  content: string
+})
+
+// 回复项目反馈
+cpzxrobot().project.feedback.reply({
+  feedbackId: number,
+  content: string
+})
+```
+
+#### 项目询盘管理
+```javascript
+// 获取询盘列表
+cpzxrobot().project.inquiry.list(projectId)
+
+// 添加询盘
+cpzxrobot().project.inquiry.add({
+  projectId: number,
+  content: string
+})
+
+// 询盘审批
+cpzxrobot().project.inquiry.approval({
+  inquiryId: number,
+  opinion: string
+})
+
+// 导出询盘
+cpzxrobot().project.inquiry.export({
+  projectId: number,
+  fileName?: string
+})
+```
+
+#### 项目资源管理
+```javascript
+// 获取项目文档
+cpzxrobot().project.document.list(projectId)
+
+// 获取物料到货
+cpzxrobot().project.material.list(projectId)
+
+// 获取施工队信息
+cpzxrobot().project.constructionTeam.list(projectId)
+
+// 获取考勤记录
+cpzxrobot().project.attendance.list(projectId)
+```
+
+#### 项目关联产品
+```javascript
+// 获取产品列表
+cpzxrobot().product.list({
+  factoryId: number,
+  page?: number,
+  size?: number
+})
+
+// 产品报价管理
+cpzxrobot().product.price.list(productId)
+cpzxrobot().product.price.add({
+  productId: number,
+  price: number,
+  currency: string
+})
+```
+
+### 合同管理
+#### 合同基础操作
+```javascript
+// 获取合同列表
+cpzxrobot().contract.list({
+  factoryId: number,
+  page?: number,
+  size?: number
+})
+
+// 获取合同详情
+cpzxrobot().contract.get(contractId)
+
+// 添加合同
+cpzxrobot().contract.add({
+  projectId: number,
+  contractType: number,
+  amount: number,
+  startDate: string, // YYYY-MM-DD
+  endDate: string,   // YYYY-MM-DD
+  content: string
+})
+
+// 导出合同
+cpzxrobot().contract.export({
+  contractId: number,
+  fileName?: string
+})
+```
+
+#### 合同审批流程
+```javascript
+// 提交合同审批
+cpzxrobot().contract.approval({
+  contractId: number,
+  opinion: string
+})
+
+// 重新提交审批
+cpzxrobot().contract.restart({
+  contractId: number,
+  reason: string
+})
+
+// 获取合同类型列表
+cpzxrobot().contract.types(factoryId)
+```
+
+#### 合同关联信息
+```javascript
+// 获取客户列表
+cpzxrobot().customer.list({
+  factoryId: number,
+  page?: number,
+  size?: number
+})
+
+// 获取客户详情
+cpzxrobot().customer.get(customerId)
+
+// 添加客户
+cpzxrobot().customer.add({
+  name: string,
+  type: number,
+  contact: string,
+  mobile: string,
+  factoryId: number
+})
+
+// 客户拜访记录
+cpzxrobot().customer.visit.add({
+  customerId: number,
+  content: string
+})
+
+// 获取客户拜访列表
+cpzxrobot().customer.visit.list({
+  customerId: number,
+  page?: number
+})
+```
+
+#### 公司管理
+```javascript
+// 获取公司列表
+cpzxrobot().company.list({
+  page?: number,
+  size?: number
+})
+
+// 公司营收统计
+cpzxrobot().company.revenue.list({
+  year?: number,
+  month?: number
+})
+
+// 公司排名
+cpzxrobot().company.rank.byRevenue()
+cpzxrobot().company.rank.byProfit()
+cpzxrobot().company.rank.byOrder()
+```
+
+#### 车辆管理
+```javascript
+// 全国车辆统计
+cpzxrobot().car.stat.china()
+
+// 按地区统计
+cpzxrobot().car.listByProvince(province)
+cpzxrobot().car.listByCity(city)
+cpzxrobot().car.listByDistrict(district)
+
+// 获取车辆运单
+cpzxrobot().car.orders(factoryId)
+cpzxrobot().car.ordersByFactory(factoryId)
+```
 ```
 cpzxrobot({
   devAuth: "从上海正芯获得的开发临时token",
@@ -326,7 +922,7 @@ heatlamp 属性提供了一组方法，用于管理猪场的热灯配置。它
 
 1. **获取任务列表**
    ```typescript
-   cpzxrobot().task.list(unitId: number)
+   cpzxrobot().robot.task.list(unitId: number)
    ```
    - 描述：获取指定单元的巡检任务列表
    - 参数：`unitId` - 单元ID
@@ -335,7 +931,7 @@ heatlamp 属性提供了一组方法，用于管理猪场的热灯配置。它
 
 2. **新增任务**
    ```typescript
-   cpzxrobot().task.add(data: any)
+   cpzxrobot().robot.task.add(data: any)
    ```
    - 描述：添加新的巡检任务
    - 参数：`data` - 包含任务信息的对象
@@ -344,7 +940,7 @@ heatlamp 属性提供了一组方法，用于管理猪场的热灯配置。它
 
 3. **修改任务**
    ```typescript
-   cpzxrobot().task.update(data: any)
+   cpzxrobot().robot.task.update(data: any)
    ```
    - 描述：更新现有的巡检任务
    - 参数：`data` - 包含更新信息的对象
@@ -353,7 +949,7 @@ heatlamp 属性提供了一组方法，用于管理猪场的热灯配置。它
 
 4. **删除任务**
    ```typescript
-   cpzxrobot().task.delete(id: number)
+   cpzxrobot().robot.task.delete(id: number)
    ```
    - 描述：删除指定的巡检任务
    - 参数：`id` - 任务ID
@@ -362,7 +958,7 @@ heatlamp 属性提供了一组方法，用于管理猪场的热灯配置。它
 
 5. **下发任务**
    ```typescript
-   cpzxrobot().task.dispatch(taskId: number)
+   cpzxrobot().robot.task.dispatch(taskId: number)
    ```
    - 描述：下发指定的巡检任务
    - 参数：`taskId` - 任务ID
@@ -373,7 +969,7 @@ heatlamp 属性提供了一组方法，用于管理猪场的热灯配置。它
 
 1. **获取巡检结果**
    ```typescript
-   cpzxrobot().record.list(taskId: number)
+   cpzxrobot().robot.record.list(taskId: number)
    ```
    - 描述：获取指定巡检任务的结果列表
    - 参数：`taskId` - 任务ID
@@ -382,3 +978,119 @@ heatlamp 属性提供了一组方法，用于管理猪场的热灯配置。它
 
 注意：对于POST请求的接口，body参数统一使用 `any` 类型，具体参数结构需要根据实际API要求进行定义。
 
+
+
+## 日志管理
+### 操作日志
+```javascript
+// 查询操作日志
+cpzxrobot().logs.operations({
+  userId?: number,
+  module?: string,
+  action?: string,
+  startTime?: string, // YYYY-MM-DD
+  endTime?: string,   // YYYY-MM-DD
+  page?: number,
+  size?: number
+})
+
+// 获取设备操作日志
+cpzxrobot().device.logs({
+  deviceId: number,
+  startTime?: string,
+  endTime?: string
+})
+```
+
+### 报警日志
+```javascript
+// 添加报警信息
+cpzxrobot().news.alarm.add({
+  deviceId: number,
+  type: string,
+  level: 'info'|'warning'|'error',
+  message: string
+})
+
+// 获取报警列表
+cpzxrobot().news.alarm.list({
+  deviceId?: number,
+  type?: string,
+  resolved?: boolean,
+  startTime?: string,
+  endTime?: string,
+  page?: number,
+  size?: number
+})
+
+// 标记报警为已处理
+cpzxrobot().news.alarm.resolve(alarmId)
+```
+
+### 系统日志
+```javascript
+// 获取系统运行日志
+cpzxrobot().logs.system({
+  level?: 'info'|'warning'|'error',
+  startTime?: string,
+  endTime?: string,
+  page?: number,
+  size?: number
+})
+
+// 获取API调用日志
+cpzxrobot().logs.api({
+  path?: string,
+  statusCode?: number,
+  startTime?: string,
+  endTime?: string
+})
+
+// 获取登录日志
+cpzxrobot().logs.login({
+  userId?: number,
+  success?: boolean,
+  startTime?: string,
+  endTime?: string
+})
+```
+
+### 巡检任务日志
+```javascript
+// 获取巡检任务日志
+cpzxrobot().robot.task.logs({
+  taskId?: number,
+  unitId?: number,
+  status?: 'pending'|'in_progress'|'completed'|'failed',
+  startTime?: string,
+  endTime?: string
+})
+
+// 获取巡检记录详情
+cpzxrobot().robot.record.details(recordId)
+```
+
+## 附录
+### 通用参数说明
+- 所有列表查询接口都支持以下分页参数:
+  - page: 页码(从1开始)
+  - size: 每页数量(默认10)
+- 时间范围参数格式: YYYY-MM-DD
+- 所有ID参数均为数字类型
+
+### 错误处理
+所有接口调用错误都会返回统一格式:
+```javascript
+{
+  code: number,    // 错误码
+  message: string, // 错误信息
+  details?: any    // 错误详情(可选)
+}
+```
+
+### 常见错误码
+- 400: 参数错误
+- 401: 未授权
+- 403: 权限不足
+- 404: 资源不存在
+- 500: 服务器错误