@satorijs/adapter-lark 3.11.9 → 3.12.0

package/src/types/apaas.ts

@@ -16,6 +16,7 @@ export namespace Apaas {
     userTask: UserTask.Methods
     approvalTask: ApprovalTask.Methods
     approvalInstance: ApprovalInstance.Methods
+    workspace: Workspace.Methods
   }
 
   export namespace App {
@@ -731,6 +732,175 @@ export namespace Apaas {
       opinion: string
     }
   }
+
+  export namespace Workspace {
+    export interface Methods {
+      table: Table.Methods
+      view: View.Methods
+      /**
+       * 执行SQL
+       * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace/sql_commands
+       */
+      sqlCommands(workspace_id: string, body: SqlCommandsRequest): Promise<SqlCommandsResponse>
+    }
+
+    export interface SqlCommandsRequest {
+      /** 要执行的 SQL 语句 */
+      sql: string
+    }
+
+    export interface SqlCommandsResponse {
+      /** 如果是 SELECT 命令，返回的是查询结果的 JSON 序列化字符串。如果是其他无返回的命令，如 DELETE 等，result 为空。 */
+      result: string
+    }
+
+    export namespace Table {
+      export interface Methods {
+        /**
+         * 查询数据表数据记录
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_get
+         */
+        recordsGet(workspace_id: string, table_name: string, query?: RecordsGetQuery): Promise<RecordsGetResponse>
+        /**
+         * 向数据表中添加或更新记录
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_post
+         */
+        recordsPost(workspace_id: string, table_name: string, body: RecordsPostRequest, query?: RecordsPostQuery): Promise<RecordsPostResponse>
+        /**
+         * 按条件更新数据表中的记录
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_patch
+         */
+        recordsPatch(workspace_id: string, table_name: string, body: RecordsPatchRequest, query?: RecordsPatchQuery): Promise<RecordsPatchResponse>
+        /**
+         * 批量更新数据表中的记录
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_batch_update
+         */
+        recordsBatchUpdate(workspace_id: string, table_name: string, body: RecordsBatchUpdateRequest): Promise<RecordsBatchUpdateResponse>
+        /**
+         * 删除数据表中的记录
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-table/records_delete
+         */
+        recordsDelete(workspace_id: string, table_name: string, query?: RecordsDeleteQuery): Promise<void>
+      }
+
+      export interface RecordsGetQuery extends Pagination {
+        /**
+         * 返回的列，默认为 *，即返回所有列。
+         * 遵循 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#vertical-filtering
+         */
+        select?: string
+        /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+        filter?: string
+        /**
+         * 排序条件，如果没指定 asc/desc，默认为 asc，null 值可排在最前或最后。
+         * 尊许 PostgREST 语法，详情可查看
+         * https://docs.postgrest.org/en/v13/references/api/tables_views.html#ordering
+         */
+        order?: string
+      }
+
+      export interface RecordsGetResponse {
+        /** 是否还有更多项 */
+        has_more: boolean
+        /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+        page_token: string
+        /** 符合条件的记录总数 */
+        total: number
+        /** 数据记录列表，格式为数组序列化后的 JSONString */
+        items: string
+      }
+
+      export interface RecordsPostRequest {
+        /** 要插入的数据记录列表，单次支持最多 500 条 */
+        records: string
+      }
+
+      export interface RecordsPostQuery {
+        /** UPSERT 时使用，指定列，多列英文逗号拼接 */
+        columns?: string
+        /**
+         * UPSERT 时使用，指定使用哪一个或多个具有唯一约束的字段作为冲突判断依据，默认为表主键。
+         * 假设 user_products 表有一个由 user_id 和 product_id 组成的复合唯一约束。
+         */
+        on_conflict?: string
+      }
+
+      export interface RecordsPostResponse {
+        /** 按照记录顺序创建或更新的记录 ID 列表 */
+        record_ids: Lark.Uuid[]
+      }
+
+      export interface RecordsPatchRequest {
+        /** 要更新的数据记录信息 */
+        record: string
+      }
+
+      export interface RecordsPatchQuery {
+        /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+        filter: string
+      }
+
+      export interface RecordsPatchResponse {
+        /** 更新的记录唯一ID列表 */
+        record_ids: Lark.Uuid[]
+      }
+
+      export interface RecordsBatchUpdateRequest {
+        /** 要更新的数据记录列表，单次支持最多 500条，每行 record 都必须包含主键 _id，且不同行要更新的字段需保持一致 */
+        records: string
+      }
+
+      export interface RecordsBatchUpdateResponse {
+        /** 更新的记录唯一ID列表 */
+        record_ids: Lark.Uuid[]
+      }
+
+      export interface RecordsDeleteQuery {
+        /**
+         * 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering
+         * 此处用法和查询数据记录一致
+         */
+        filter: string
+      }
+    }
+
+    export namespace View {
+      export interface Methods {
+        /**
+         * 查询视图数据记录
+         * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/apaas-v1/workspace-view/views_get
+         */
+        viewsGet(workspace_id: string, view_name: string, query?: ViewsGetQuery): Promise<ViewsGetResponse>
+      }
+
+      export interface ViewsGetQuery extends Pagination {
+        /**
+         * 返回的列，默认为 *，即返回所有列。
+         * 遵循 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#vertical-filtering
+         */
+        select?: string
+        /** 筛选条件，尊许 PostgREST 语法，详情可查看 https://docs.postgrest.org/en/v13/references/api/tables_views.html#horizontal-filtering */
+        filter?: string
+        /**
+         * 排序条件，如果没指定 asc/desc，默认为 asc，null 值可排在最前或最后。
+         * 尊许 PostgREST 语法，详情可查看
+         * https://docs.postgrest.org/en/v13/references/api/tables_views.html#ordering
+         */
+        order?: string
+      }
+
+      export interface ViewsGetResponse {
+        /** 是否还有更多项 */
+        has_more: boolean
+        /** 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token */
+        page_token: string
+        /** 符合条件的记录总数 */
+        total: number
+        /** 数据记录列表，格式为数组序列化后的 JSONString */
+        items: string
+      }
+    }
+  }
 }
 
 Internal.define({
@@ -843,4 +1013,19 @@ Internal.define({
   '/apaas/v1/user_tasks/{task_id}/chat_group': {
     POST: 'apaas.userTask.chatGroup',
   },
+  '/apaas/v1/workspaces/{workspace_id}/tables/{table_name}/records': {
+    GET: 'apaas.workspace.table.recordsGet',
+    POST: 'apaas.workspace.table.recordsPost',
+    PATCH: 'apaas.workspace.table.recordsPatch',
+    DELETE: 'apaas.workspace.table.recordsDelete',
+  },
+  '/apaas/v1/workspaces/{workspace_id}/tables/{table_name}/records_batch_update': {
+    PATCH: 'apaas.workspace.table.recordsBatchUpdate',
+  },
+  '/apaas/v1/workspaces/{workspace_id}/views/{view_name}/records': {
+    GET: 'apaas.workspace.view.viewsGet',
+  },
+  '/apaas/v1/workspaces/{workspace_id}/sql_commands': {
+    POST: 'apaas.workspace.sqlCommands',
+  },
 })

package/src/types/application.ts

@@ -479,7 +479,12 @@ export namespace Application {
       date: string
       /** 活跃周期的统计类型 */
       cycle_type: DepartmentOverviewRequestCycleType
-      /** 查询的部门id，获取方法可参考[部门ID概述](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)-  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户） 以及多级子部门的使用数据。-  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。- 若不填写则返回整个租户的数据 */
+      /**
+       * 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)
+       * -  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户） 以及多级子部门的使用数据。
+       * -  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。
+       * - 若不填写则返回整个租户的数据
+       */
       department_id?: string
       /** 是否需要查询部门下多层子部门的数据。未设置或为0时，仅查询department_id对应的部门。设置为n时，查询department_id及其n级子部门的数据。仅在department_id参数传递时有效，最大值为4。 */
       recursion?: number
@@ -508,7 +513,11 @@ export namespace Application {
       date: string
       /** 枚举值：day，week，month；week指自然周，返回当前日期所在周的数据；不满一周则从周一到当前日期算。month指自然月，返回当前日期所在月的数据。 */
       cycle_type: MessagePushOverviewRequestCycleType
-      /** 需要查询的部门id，获取方法可参考[部门ID概述](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)-  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； -  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。返回当前部门的使用数据； 若不填写，则返回当前租户的使用数据 */
+      /**
+       * 需要查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)
+       * -  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）；
+       * -  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。返回当前部门的使用数据； 若不填写，则返回当前租户的使用数据
+       */
       department_id?: string
     }
 
@@ -536,7 +545,11 @@ export namespace Application {
       date: string
       /** 活跃周期的统计类型 */
       cycle_type: OverviewRequestCycleType
-      /** 查询的部门id，获取方法可参考[部门ID概述](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)-  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； -  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。 */
+      /**
+       * 查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)
+       * -  若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）；
+       * -  若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。
+       */
       department_id?: string
       /** 能力类型，按能力类型进行筛选，返回对应能力的活跃数据 */
       ability: 'app' | 'mp' | 'h5' | 'bot'
@@ -607,7 +620,10 @@ export namespace Application {
     export interface ListQuery extends Pagination {
       /** 查询的起始日期，格式为yyyy-mm-dd。不填则默认为当前日期减去180天。 */
       from_date?: string
-      /** 查询的结束日期，格式为yyyy-mm-dd。不填默认为当前日期。只能查询 180 天内的数据。 */
+      /**
+       * 查询的结束日期，格式为yyyy-mm-dd。不填默认为当前日期。
+       * 只能查询 180 天内的数据。
+       */
       to_date?: string
       /** 反馈类型，不填写则表示查询所有反馈类型。 */
       feedback_type?: ListQueryFeedbackType

package/src/types/approval.ts

@@ -129,11 +129,6 @@ export namespace Approval {
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/get
        */
       get(instance_id: string, query?: GetQuery): Promise<GetResponse>
-      /**
-       * 批量获取审批实例 ID
-       * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/list
-       */
-      list(query?: ListQuery): Paginated<string, 'instance_code_list'>
       /**
        * 退回审批任务
        * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/specified_rollback
@@ -314,15 +309,6 @@ export namespace Approval {
       instance_code: string
     }
 
-    export interface ListQuery extends Pagination {
-      /** 审批定义唯一标识 */
-      approval_code: string
-      /** 审批实例创建时间区间（毫秒） */
-      start_time: string
-      /** 审批实例创建时间区间（毫秒） */
-      end_time: string
-    }
-
     export interface SpecifiedRollbackRequest {
       /** 用户ID */
       user_id: string
@@ -924,7 +910,6 @@ Internal.define({
   },
   '/approval/v4/instances': {
     POST: 'approval.instance.create',
-    GET: { name: 'approval.instance.list', pagination: { argIndex: 0, itemsKey: 'instance_code_list' } },
   },
   '/approval/v4/instances/cancel': {
     POST: 'approval.instance.cancel',

package/src/types/attendance.ts

@@ -221,7 +221,7 @@ export namespace Attendance {
     export interface BatchCreateRequest {
       /** 班表信息列表 */
       user_daily_shifts: Lark.UserDailyShift[]
-      /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
+      /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
       operator_id?: string
     }
 
@@ -318,7 +318,7 @@ export namespace Attendance {
     export interface CreateRequest {
       /** 6921319402260496386 */
       group: Lark.Group
-      /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
+      /** 操作人uid，如果您未操作[考勤管理后台“API 接入”流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)，则此字段为必填字段 */
       operator_id?: string
     }
 
@@ -659,9 +659,15 @@ export namespace Attendance {
       stats_type: 'daily' | 'month'
       /** 开始时间 */
       start_date: number
-      /** 结束时间（时间间隔不超过 40 天） */
+      /**
+       * 结束时间
+       * （时间间隔不超过 40 天）
+       */
       end_date: number
-      /** 查询的用户 ID 列表（用户数量不超过 200） */
+      /**
+       * 查询的用户 ID 列表
+       * （用户数量不超过 200）
+       */
       user_ids?: string[]
       /** 是否需要历史数据 */
       need_history?: boolean
@@ -764,7 +770,7 @@ export namespace Attendance {
     }
 
     export interface ProcessRequest {
-      /** 审批实例 ID，获取方式：1）[获取审批通过数据](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query) 2）[写入审批结果](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create) 3）[通知补卡审批发起（补卡情况下）](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create) */
+      /** 审批实例 ID，获取方式：1）[获取审批通过数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query) 2）[写入审批结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create) 3）[通知补卡审批发起（补卡情况下）](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create) */
       approval_id: string
       /** 审批类型，leave：请假，out：外出，overtime：加班，trip：出差，remedy：补卡 */
       approval_type: string

package/src/types/authen.ts

@@ -105,7 +105,10 @@ export namespace Authen {
       export interface CreateRequest {
         /** 授权类型，**固定值**： */
         grant_type: string
-        /** 刷新 `user_access_token` 需要的凭证<br>获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** */
+        /**
+         * 刷新 `user_access_token` 需要的凭证
+         * 获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`**
+         */
         refresh_token: string
       }
 
@@ -196,7 +199,10 @@ export namespace Authen {
     export interface CreateRequest {
       /** 授权类型，**固定值**： */
       grant_type: string
-      /** 刷新 `user_access_token` 需要的凭证<br>获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** */
+      /**
+       * 刷新 `user_access_token` 需要的凭证
+       * 获取user_access_token`接口和本接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`**
+       */
       refresh_token: string
     }
 

package/src/types/bitable.ts

@@ -454,15 +454,36 @@ export namespace Bitable {
         }
 
         export interface ListQuery extends Pagination {
-          /** 视图 id注意：如 filter 或 sort 有值，view_id 会被忽略。 */
+          /**
+           * 视图 id
+           * 注意：如 filter 或 sort 有值，view_id 会被忽略。
+           */
           view_id?: string
-          /** 筛选参数注意：1.筛选记录的表达式不超过2000个字符。2.不支持对“人员”以及“关联字段”的属性进行过滤筛选，如人员的 OpenID。3.仅支持字段在页面展示字符值进行筛选。详细请参考[记录筛选开发指南](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/filter) */
+          /**
+           * 筛选参数
+           * 注意：
+           * 1.筛选记录的表达式不超过2000个字符。
+           * 2.不支持对“人员”以及“关联字段”的属性进行过滤筛选，如人员的 OpenID。
+           * 3.仅支持字段在页面展示字符值进行筛选。
+           * 详细请参考[记录筛选开发指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/filter)
+           */
           filter?: string
-          /** 排序参数注意：1.表达式需要不超过1000字符。2.不支持对带“公式”和“关联字段”的表的使用。3.使用引号将字段名称和顺序逆序连接起来。 */
+          /**
+           * 排序参数
+           * 注意：
+           * 1.表达式需要不超过1000字符。
+           * 2.不支持对带“公式”和“关联字段”的表的使用。
+           * 3.使用引号将字段名称和顺序逆序连接起来。
+           */
           sort?: string
           /** 字段名称 */
           field_names?: string
-          /** 控制多行文本字段数据的返回格式，true 表示以数组形式返回。注意：1.多行文本中如果有超链接部分，则会返回链接的 URL。2.目前可以返回多行文本中 URL 类型为多维表格链接、飞书 doc、飞书 sheet的URL类型以及@人员的数据结构。 */
+          /**
+           * 控制多行文本字段数据的返回格式，true 表示以数组形式返回。
+           * 注意：
+           * 1.多行文本中如果有超链接部分，则会返回链接的 URL。
+           * 2.目前可以返回多行文本中 URL 类型为多维表格链接、飞书 doc、飞书 sheet的URL类型以及@人员的数据结构。
+           */
           text_field_as_array?: boolean
           /** 此次调用中使用的用户ID的类型 */
           user_id_type?: 'user_id' | 'union_id' | 'open_id'

package/src/types/board.ts

@@ -44,6 +44,11 @@ export namespace Board {
 
     export namespace Node {
       export interface Methods {
+        /**
+         * 解析画板语法
+         * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard-node/create_plantuml
+         */
+        createPlantuml(whiteboard_id: string, body: CreatePlantumlRequest): Promise<CreatePlantumlResponse>
         /**
          * 创建节点
          * @see https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/board-v1/whiteboard-node/create
@@ -56,6 +61,20 @@ export namespace Board {
         list(whiteboard_id: string): Promise<ListResponse>
       }
 
+      export interface CreatePlantumlRequest {
+        /** plant uml 代码 */
+        plant_uml_code: string
+        style_type?: Lark.StyleType
+        /** 语法类型 */
+        syntax_type?: Lark.SyntaxType
+        diagram_type?: Lark.DiagramType
+      }
+
+      export interface CreatePlantumlResponse {
+        /** 创建生成的plant uml节点id */
+        node_id?: string
+      }
+
       export interface CreateRequest {
         /** 子节点数据 */
         nodes?: Lark.WhiteboardNode[]
@@ -93,6 +112,9 @@ Internal.define({
   '/board/v1/whiteboards/{whiteboard_id}/download_as_image': {
     GET: { name: 'board.whiteboard.downloadAsImage', type: 'binary' },
   },
+  '/board/v1/whiteboards/{whiteboard_id}/nodes/plantuml': {
+    POST: 'board.whiteboard.node.createPlantuml',
+  },
   '/board/v1/whiteboards/{whiteboard_id}/nodes': {
     POST: 'board.whiteboard.node.create',
     GET: 'board.whiteboard.node.list',

package/src/types/calendar.ts

@@ -228,7 +228,7 @@ export namespace Calendar {
       time_min: string
       /** 查询时段结束时间，需要url编码 */
       time_max: string
-      /** 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](/ssl:ttdoc/home/user-identity-introduction/introduction) */
+      /** 用户user_id，输入时与 room_id 二选一。参见[用户相关的 ID 概念](https://open.feishu.cn/document/home/user-identity-introduction/introduction) */
       user_id?: string
       /** 会议室room_id，输入时与 user_id 二选一 */
       room_id?: string
@@ -631,7 +631,10 @@ export namespace Calendar {
       }
 
       export interface CreateRequest {
-        /** 新增参与人列表；<br>- 单次请求会议室的数量限制为100。 */
+        /**
+         * 新增参与人列表；
+         * - 单次请求会议室的数量限制为100。
+         */
         attendees?: Lark.CalendarEventAttendee[]
         /** 是否给参与人发送bot通知 默认为true */
         need_notification?: boolean
@@ -654,7 +657,7 @@ export namespace Calendar {
       }
 
       export interface BatchDeleteRequest {
-        /** 要移除的参与人 ID 列表。参见[参与人ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) */
+        /** 要移除的参与人 ID 列表。参见[参与人ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event-attendee/introduction#4998889c) */
         attendee_ids?: string[]
         /** 需要删除的参与人类型实体ID，作为attendee_ids字段的补充。 */
         delete_ids?: Lark.CalendarEventAttendeeId[]
@@ -720,7 +723,11 @@ export namespace Calendar {
       end_time: string
       /** 休假日程标题，可自定义例如："请假中(全天) / 1-Day Time Off"，"请假中(半天) / 0.5-Day Time Off"，"长期休假中 / Leave of Absence"，"请假中" */
       title?: string
-      /** 休假日程描述，可自定义,例如："若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked." */
+      /**
+       * 休假日程描述，可自定义,例如：
+       * "若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。
+       * If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked."
+       */
       description?: string
     }
 
@@ -742,7 +749,11 @@ export namespace Calendar {
       end_time: string
       /** 休假日程标题，可自定义例如："请假中(全天) / 1-Day Time Off"，"请假中(半天) / 0.5-Day Time Off"，"长期休假中 / Leave of Absence"，"请假中" */
       title?: string
-      /** 休假日程描述，可自定义,例如："若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked." */
+      /**
+       * 休假日程描述，可自定义,例如：
+       * "若拒绝或删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。
+       * If the event is rejected or deleted, corresponding "On Leave" tag in Feishu will disappear, while the leave request in the time off system will not be revoked."
+       */
       description?: string
     }
   }

package/src/types/contact.ts

@@ -181,7 +181,10 @@ export namespace Contact {
     export interface CreateQuery {
       /** 此次调用中使用的用户ID的类型 */
       user_id_type?: 'user_id' | 'union_id' | 'open_id'
-      /** 此次调用中使用的部门ID的类型。不同 ID 的说明参见[部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+      /**
+       * 此次调用中使用的部门ID的类型。
+       * 不同 ID 的说明参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+       */
       department_id_type?: 'department_id' | 'open_department_id'
       /** 用于幂等判断是否为同一请求，避免重复创建。字符串类型，自行生成。 */
       client_token?: string
@@ -279,7 +282,10 @@ export namespace Contact {
     export interface GetQuery {
       /** 此次调用中使用的用户ID的类型 */
       user_id_type?: 'user_id' | 'union_id' | 'open_id'
-      /** 此次调用中使用的部门ID的类型不同 ID 的说明 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+      /**
+       * 此次调用中使用的部门ID的类型
+       * 不同 ID 的说明 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+       */
       department_id_type?: 'department_id' | 'open_department_id'
     }
 
@@ -304,16 +310,32 @@ export namespace Contact {
     export interface FindByDepartmentQuery extends Pagination {
       /** 此次调用中使用的用户ID的类型 */
       user_id_type?: 'user_id' | 'union_id' | 'open_id'
-      /** 此次调用中使用的部门ID的类型部门ID类型的区别参见[部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+      /**
+       * 此次调用中使用的部门ID的类型
+       * 部门ID类型的区别参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+       */
       department_id_type?: 'department_id' | 'open_department_id'
-      /** 填写该字段表示获取该部门下用户，必填。根部门的部门ID为0。ID值与查询参数中的department_id_type 对应。不同 ID 的说明与department_id的获取方式参见 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+      /**
+       * 填写该字段表示获取该部门下用户，必填。根部门的部门ID为0。
+       * ID值与查询参数中的department_id_type 对应。
+       * 不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+       */
       department_id: string
     }
 
     export interface BatchGetIdRequest {
-      /** 要查询的用户邮箱，最多 50 条。注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。本接口返回的用户ID数量为emails数量与mobiles数量的和。 */
+      /**
+       * 要查询的用户邮箱，最多 50 条。
+       * 注意，emails与mobiles相互独立，每条用户邮箱返回对应的用户ID。
+       * 本接口返回的用户ID数量为emails数量与mobiles数量的和。
+       */
       emails?: string[]
-      /** 要查询的用户手机号，最多 50 条。注意1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。2.  非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。 */
+      /**
+       * 要查询的用户手机号，最多 50 条。
+       * 注意
+       * 1. emails与mobiles相互独立，每条用户手机号返回对应的用户ID。
+       * 2.  非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码。
+       */
       mobiles?: string[]
       /** 查询结果包含离职员工，可查询离职用户的ID */
       include_resigned?: boolean
@@ -495,7 +517,12 @@ export namespace Contact {
       description?: string
       /** 用户组的类型。默认为1表示普通用户组 */
       type?: CreateRequestType
-      /** 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。自定义group_id数据校验规则：最大长度：64 字符校验规则：数字、大小写字母的组合，不能包含空格 */
+      /**
+       * 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。
+       * 自定义group_id数据校验规则：
+       * 最大长度：64 字符
+       * 校验规则：数字、大小写字母的组合，不能包含空格
+       */
       group_id?: string
     }
 
@@ -514,7 +541,10 @@ export namespace Contact {
     export interface PatchRequest {
       /** 用户组的名字，企业内唯一，最大长度：100 字符 */
       name?: string
-      /** 用户组描述信息最大长度：500 字 */
+      /**
+       * 用户组描述信息
+       * 最大长度：500 字
+       */
       description?: string
     }
 
@@ -614,7 +644,11 @@ export namespace Contact {
       }
 
       export interface SimplelistQuery extends Pagination {
-        /** 欲获取成员ID类型。当member_type=user时候，member_id_type表示user_id_type，枚举值open_id, union_id和user_id。当member_type=department时候，member_id_type表示department_id_type，枚举值open_id和department_id。 */
+        /**
+         * 欲获取成员ID类型。
+         * 当member_type=user时候，member_id_type表示user_id_type，枚举值open_id, union_id和user_id。
+         * 当member_type=department时候，member_id_type表示department_id_type，枚举值open_id和department_id。
+         */
         member_id_type?: 'open_id' | 'union_id' | 'user_id' | 'department_id'
         /** 欲获取的用户组成员类型。 */
         member_type?: 'user' | 'department'
@@ -820,7 +854,10 @@ export namespace Contact {
     export interface CreateQuery {
       /** 此次调用中使用的用户ID的类型 */
       user_id_type?: 'user_id' | 'union_id' | 'open_id'
-      /** 此次调用中使用的部门ID的类型不同 ID 的说明参见[部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+      /**
+       * 此次调用中使用的部门ID的类型
+       * 不同 ID 的说明参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+       */
       department_id_type?: 'department_id' | 'open_department_id'
       /** 用于幂等判断是否为同一请求，避免重复创建。字符串类型，自行生成。 */
       client_token?: string
@@ -915,7 +952,10 @@ export namespace Contact {
     export interface GetQuery {
       /** 此次调用中使用的用户ID的类型 */
       user_id_type?: 'user_id' | 'union_id' | 'open_id'
-      /** 此次调用中使用的部门ID的类型不同 ID 的说明 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+      /**
+       * 此次调用中使用的部门ID的类型
+       * 不同 ID 的说明 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+       */
       department_id_type?: 'department_id' | 'open_department_id'
     }
 
@@ -940,7 +980,10 @@ export namespace Contact {
     export interface ChildrenQuery extends Pagination {
       /** 此次调用中使用的用户ID的类型 */
       user_id_type?: 'user_id' | 'union_id' | 'open_id'
-      /** 此次调用中使用的部门ID的类型不同 ID 的说明与department_id的获取方式参见 [部门ID说明](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0) */
+      /**
+       * 此次调用中使用的部门ID的类型
+       * 不同 ID 的说明与department_id的获取方式参见 [部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)
+       */
       department_id_type?: 'department_id' | 'open_department_id'
       /** 是否递归获取子部门 */
       fetch_child?: boolean