meeglesdk 0.1.8 → 0.2.0

package/dist/service/config/resource.d.ts

@@ -3,7 +3,7 @@
  * 100% 参考 Meego API 文档
  */
 import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
-import type { ResourceQueryRequest, ResourceWorkItemDetail, ResourceCreateRequest, ResourceCreateResponse, ResourceUpdateRequest, ResourceCreateInstanceRequest, ResourceCreateInstanceResponseData, ResourceSearchParamsRequest, ResourceSearchParamsResponse } from '../../types/config.js';
+import type { ResourceQueryRequest, ResourceWorkItemDetail, ResourceCreateRequest, ResourceCreateResponse, ResourceUpdateRequest, ResourceCreateInstanceRequest, ResourceCreateInstanceResponseData, ResourceSearchParamsRequest, ResourceSearchParamsResponse, ResourceId } from '../../types/config.js';
 /** API 路径常量 */
 export declare const API_PATHS: {
     CREATE_RESOURCE_WORK_ITEM: string;
@@ -45,7 +45,7 @@ export declare class ConfigResourceService extends BaseService {
      * @param options 请求选项
      * @returns 查询结果
      */
-    searchByParams(request: ResourceSearchParamsRequest, options?: ServiceRequestOptions<ResourceSearchParamsResponse>): Promise<ResourceSearchParamsResponse>;
+    searchByParams(request: ResourceSearchParamsRequest, options?: ServiceRequestOptions<ResourceWorkItemDetail>): Promise<ResourceSearchParamsResponse>;
     /**
      * 通过资源创建实例
      *
@@ -54,5 +54,5 @@ export declare class ConfigResourceService extends BaseService {
      * @param request 创建请求
      * @param options 请求选项
      */
-    createInstanceFromResource(projectKey: string, workItemId: number, request: ResourceCreateInstanceRequest, options?: ServiceRequestOptions<ResourceCreateInstanceResponseData>): Promise<ResourceCreateInstanceResponseData>;
+    createInstanceFromResource(projectKey: string, workItemId: ResourceId, request: ResourceCreateInstanceRequest, options?: ServiceRequestOptions<ResourceCreateInstanceResponseData>): Promise<ResourceCreateInstanceResponseData>;
 }

package/dist/service/config/resource.js

@@ -51,7 +51,11 @@ export class ConfigResourceService extends BaseService {
      * @returns 查询结果
      */
     async searchByParams(request, options) {
-        return this.post(API_PATHS.SEARCH_RESOURCE_PARAMS, request, options);
+        const result = await this.postCursorPaginated(API_PATHS.SEARCH_RESOURCE_PARAMS, request, options, 'data');
+        return {
+            data: result.data,
+            pagination: result.pagination,
+        };
     }
     /**
      * 通过资源创建实例

package/dist/service/config/role.d.ts

@@ -31,8 +31,9 @@ export declare class ConfigRoleService extends BaseService {
      * @param workItemTypeKey 工作项类型 key
      * @param request 创建请求
      * @param options 请求选项
+     * @returns 角色 ID
      */
-    create(projectKey: string, workItemTypeKey: string, request: CreateFlowRoleRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    create(projectKey: string, workItemTypeKey: string, request: CreateFlowRoleRequest, options?: ServiceRequestOptions<string>): Promise<string>;
     /**
      * 更新流程角色
      *

package/dist/service/config/role.js

@@ -39,9 +39,10 @@ export class ConfigRoleService extends BaseService {
      * @param workItemTypeKey 工作项类型 key
      * @param request 创建请求
      * @param options 请求选项
+     * @returns 角色 ID
      */
     async create(projectKey, workItemTypeKey, request, options) {
-        await this.post(API_PATHS.CREATE_ROLE, request, {
+        return this.post(API_PATHS.CREATE_ROLE, request, {
             ...options,
             pathParams: {
                 project_key: projectKey,

package/dist/service/measure/index.d.ts

@@ -21,5 +21,13 @@ export declare class MeasureService extends BaseService {
      * @param options 请求选项（建议设置 timeout >= 60000）
      */
     getChartData(projectKey: string, chartId: string, options?: ServiceRequestOptions<MeasureChartData>): Promise<MeasureChartData>;
+    /**
+     * 获取度量图表详情
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param chartId 图表 ID
+     * @param options 请求选项（建议设置 timeout >= 60000）
+     */
+    getChartDetail(projectKey: string, chartId: string, options?: ServiceRequestOptions<MeasureChartData>): Promise<MeasureChartData>;
 }
 export { API_PATHS } from './query.js';

package/dist/service/measure/index.js

@@ -31,5 +31,15 @@ export class MeasureService extends BaseService {
             },
         });
     }
+    /**
+     * 获取度量图表详情
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param chartId 图表 ID
+     * @param options 请求选项（建议设置 timeout >= 60000）
+     */
+    async getChartDetail(projectKey, chartId, options) {
+        return this.getChartData(projectKey, chartId, options);
+    }
 }
 export { API_PATHS } from './query.js';

package/dist/service/measure/query.d.ts

@@ -3,7 +3,7 @@
  * 100% 参考 Meego API 文档
  */
 import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
-import type { MeasureChartsByViewRequest, MeasureChartsByViewData, MeasureChartSummary } from '../../types/measure.js';
+import type { MeasureChartsByViewRequest, MeasureChartsByViewPageOptions, MeasureChartsByViewData, MeasureChartSummary } from '../../types/measure.js';
 /** API 路径 */
 export declare const API_PATHS: {
     /** 获取度量图表明细数据 */
@@ -29,6 +29,16 @@ export declare class MeasureChartsByViewBuilder {
  * 度量查询服务
  */
 export declare class MeasureQueryService extends BaseService {
+    /**
+     * 归一化视图图表查询参数
+     *
+     * @param requestOrProjectKey 查询请求或空间 ID
+     * @param viewIdOrOptions 视图 ID 或请求选项
+     * @param pageOptions 分页参数
+     * @param options 请求选项
+     * @returns 查询请求与请求选项
+     */
+    private normalizeChartsByViewArgs;
     /**
      * 查询视图下图表列表
      *
@@ -37,6 +47,16 @@ export declare class MeasureQueryService extends BaseService {
      * @returns 图表列表与分页信息
      */
     listChartsByView(request: MeasureChartsByViewRequest, options?: ServiceRequestOptions<MeasureChartsByViewData | null>): Promise<MeasureChartsByViewData>;
+    /**
+     * 查询视图下图表列表
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param viewId 视图 ID
+     * @param pageOptions 分页参数
+     * @param options 请求选项
+     * @returns 图表列表与分页信息
+     */
+    listChartsByView(projectKey: string, viewId: string, pageOptions?: MeasureChartsByViewPageOptions, options?: ServiceRequestOptions<MeasureChartsByViewData | null>): Promise<MeasureChartsByViewData>;
     /**
      * 获取图表摘要列表
      *
@@ -45,6 +65,16 @@ export declare class MeasureQueryService extends BaseService {
      * @returns 图表摘要列表
      */
     getChartSummariesByView(request: MeasureChartsByViewRequest, options?: ServiceRequestOptions<MeasureChartsByViewData | null>): Promise<MeasureChartSummary[]>;
+    /**
+     * 获取图表摘要列表
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param viewId 视图 ID
+     * @param pageOptions 分页参数
+     * @param options 请求选项
+     * @returns 图表摘要列表
+     */
+    getChartSummariesByView(projectKey: string, viewId: string, pageOptions?: MeasureChartsByViewPageOptions, options?: ServiceRequestOptions<MeasureChartsByViewData | null>): Promise<MeasureChartSummary[]>;
     /**
      * 构建视图图表查询
      *

package/dist/service/measure/query.js

@@ -43,34 +43,49 @@ export class MeasureChartsByViewBuilder {
  */
 export class MeasureQueryService extends BaseService {
     /**
-     * 查询视图下图表列表
+     * 归一化视图图表查询参数
      *
-     * @param request 查询请求
+     * @param requestOrProjectKey 查询请求或空间 ID
+     * @param viewIdOrOptions 视图 ID 或请求选项
+     * @param pageOptions 分页参数
      * @param options 请求选项
-     * @returns 图表列表与分页信息
+     * @returns 查询请求与请求选项
      */
-    async listChartsByView(request, options) {
-        const result = await this.post(API_PATHS.CHARTS_BY_VIEW, request, options);
+    normalizeChartsByViewArgs(requestOrProjectKey, viewIdOrOptions, pageOptions, options) {
+        if (typeof requestOrProjectKey !== 'string') {
+            return {
+                request: requestOrProjectKey,
+                options: viewIdOrOptions,
+            };
+        }
+        return {
+            request: {
+                project_key: requestOrProjectKey,
+                view_id: viewIdOrOptions,
+                page_num: pageOptions?.pageNum,
+                page_size: pageOptions?.pageSize,
+            },
+            options,
+        };
+    }
+    async listChartsByView(requestOrProjectKey, viewIdOrOptions, pageOptions, options) {
+        const normalized = this.normalizeChartsByViewArgs(requestOrProjectKey, viewIdOrOptions, pageOptions, options);
+        const result = await this.post(API_PATHS.CHARTS_BY_VIEW, normalized.request, normalized.options);
         const chartList = Array.isArray(result?.chart_list) ? result.chart_list : [];
         const chartPage = result?.chart_page ?? {
             total: chartList.length,
-            page_num: request.page_num ?? 1,
-            page_size: request.page_size ?? 50,
+            page_num: normalized.request.page_num ?? 1,
+            page_size: normalized.request.page_size ?? 50,
         };
         return {
             chart_list: chartList,
             chart_page: chartPage,
         };
     }
-    /**
-     * 获取图表摘要列表
-     *
-     * @param request 查询请求
-     * @param options 请求选项
-     * @returns 图表摘要列表
-     */
-    async getChartSummariesByView(request, options) {
-        const result = await this.listChartsByView(request, options);
+    async getChartSummariesByView(requestOrProjectKey, viewIdOrOptions, pageOptions, options) {
+        const result = typeof requestOrProjectKey === 'string'
+            ? await this.listChartsByView(requestOrProjectKey, viewIdOrOptions, pageOptions, options)
+            : await this.listChartsByView(requestOrProjectKey, viewIdOrOptions);
         return result.chart_list ?? [];
     }
     /**

package/dist/service/view/query.d.ts

@@ -5,7 +5,7 @@
 import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
 import type { PaginatedResult, PaginatedObjectResult } from '../../types/common.js';
 import type { WorkItem } from '../../types/workitem.js';
-import type { ViewConfListRequest, ViewConfInfo, FixViewInfo, FixViewQueryParams, PanoramicViewQueryParams } from '../../types/view.js';
+import type { ViewConfListRequest, ViewConfInfo, FixViewInfo, FixViewQueryParams, PanoramicViewQueryParams, SearchViewByTitleRequest } from '../../types/view.js';
 /** API 路径 */
 export declare const API_PATHS: {
     /** 获取视图列表及配置信息 */
@@ -28,6 +28,15 @@ export declare class ViewQueryService extends BaseService {
      * @returns 分页的视图配置列表
      */
     listConfigs(projectKey: string, request: ViewConfListRequest, options?: ServiceRequestOptions<ViewConfInfo>): Promise<PaginatedResult<ViewConfInfo>>;
+    /**
+     * 按标题模糊查询视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 分页的视图配置列表
+     */
+    searchByTitle(projectKey: string, request: SearchViewByTitleRequest, options?: ServiceRequestOptions<ViewConfInfo>): Promise<PaginatedResult<ViewConfInfo>>;
     /**
      * 获取固定视图下工作项列表
      *

package/dist/service/view/query.js

@@ -33,6 +33,21 @@ export class ViewQueryService extends BaseService {
             },
         });
     }
+    /**
+     * 按标题模糊查询视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 分页的视图配置列表
+     */
+    async searchByTitle(projectKey, request, options) {
+        const { title, ...rest } = request;
+        return this.listConfigs(projectKey, {
+            ...rest,
+            view_name: title,
+        }, options);
+    }
     /**
      * 获取固定视图下工作项列表
      *

package/dist/service/workitem/attachment.d.ts

@@ -32,17 +32,17 @@ export declare class AttachmentService extends BaseService {
      * @param projectKey 空间 ID 或域名
      * @param request 上传请求
      * @param options 请求选项
-     * @returns 附件链接 URL 数组
+     * @returns 附件链接 URL
      *
      * @example
      * ```typescript
-     * const urls = await client.workItem.attachment.uploadFile('my-project', {
+     * const url = await client.workItem.attachment.uploadFile('my-project', {
      *   file: new Blob([...]),
      * });
-     * console.log(urls[0]); // https://project.feishu.cn/goapi/v1/tos/file/...
+     * console.log(url); // https://project.feishu.cn/goapi/v1/tos/file/...
      * ```
      */
-    uploadFile(projectKey: string, request: UploadFileRequest, options?: UploadRequestOptions<string[]>): Promise<string[]>;
+    uploadFile(projectKey: string, request: UploadFileRequest, options?: UploadRequestOptions<string>): Promise<string>;
     /**
      * 添加附件到工作项
      *
@@ -59,20 +59,20 @@ export declare class AttachmentService extends BaseService {
      * @example
      * ```typescript
      * // 普通附件上传
-     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', '643711xxxx', {
      *   file: new Blob([...]),
      *   field_key: 'field_xxx',
      * });
      *
      * // 复合字段中上传附件
-     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', '643711xxxx', {
      *   file: new Blob([...]),
      *   field_key: 'compound_field_xxx',
      *   index: '0',
      * });
      * ```
      */
-    uploadAttachment(projectKey: string, workItemTypeKey: string, workItemId: number, request: UploadAttachmentRequest, options?: UploadRequestOptions<void>): Promise<void>;
+    uploadAttachment(projectKey: string, workItemTypeKey: string, workItemId: number | string, request: UploadAttachmentRequest, options?: UploadRequestOptions<void>): Promise<void>;
     /**
      * 下载附件
      *
@@ -88,7 +88,7 @@ export declare class AttachmentService extends BaseService {
      * @example
      * ```typescript
      * // 下载附件
-     * const data = await client.workItem.attachment.downloadAttachment('my-project', 'story', 123456, {
+     * const data = await client.workItem.attachment.downloadAttachment('my-project', 'story', '643711xxxx', {
      *   uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx',
      * });
      *
@@ -100,7 +100,7 @@ export declare class AttachmentService extends BaseService {
      * const blob = new Blob([data]);
      * ```
      */
-    downloadAttachment(projectKey: string, workItemTypeKey: string, workItemId: number, request: DownloadAttachmentRequest, options?: DownloadOptions): Promise<ArrayBuffer>;
+    downloadAttachment(projectKey: string, workItemTypeKey: string, workItemId: number | string, request: DownloadAttachmentRequest, options?: DownloadOptions): Promise<ArrayBuffer>;
     /**
      * 下载附件（流式）
      *
@@ -111,7 +111,7 @@ export declare class AttachmentService extends BaseService {
      * const stream = await client.workItem.attachment.downloadAttachmentStream(
      *   'my-project',
      *   'story',
-     *   123456,
+     *   '643711xxxx',
      *   { uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx' },
      *   {
      *     onProgress: (p) => console.log(p.progress),
@@ -119,7 +119,7 @@ export declare class AttachmentService extends BaseService {
      * );
      * ```
      */
-    downloadAttachmentStream(projectKey: string, workItemTypeKey: string, workItemId: number, request: DownloadAttachmentRequest, options?: DownloadOptions): Promise<ReadableStream<Uint8Array>>;
+    downloadAttachmentStream(projectKey: string, workItemTypeKey: string, workItemId: number | string, request: DownloadAttachmentRequest, options?: DownloadOptions): Promise<ReadableStream<Uint8Array>>;
     /**
      * 删除附件
      *
@@ -132,7 +132,7 @@ export declare class AttachmentService extends BaseService {
      * ```typescript
      * await client.workItem.attachment.deleteAttachment({
      *   project_key: 'my-project',
-     *   work_item_id: 123456,
+     *   work_item_id: '643711xxxx',
      *   field_key: 'field_xxx',
      *   uuids: ['uuid1', 'uuid2'],
      * });

package/dist/service/workitem/attachment.js

@@ -38,14 +38,14 @@ export class AttachmentService extends BaseService {
      * @param projectKey 空间 ID 或域名
      * @param request 上传请求
      * @param options 请求选项
-     * @returns 附件链接 URL 数组
+     * @returns 附件链接 URL
      *
      * @example
      * ```typescript
-     * const urls = await client.workItem.attachment.uploadFile('my-project', {
+     * const url = await client.workItem.attachment.uploadFile('my-project', {
      *   file: new Blob([...]),
      * });
-     * console.log(urls[0]); // https://project.feishu.cn/goapi/v1/tos/file/...
+     * console.log(url); // https://project.feishu.cn/goapi/v1/tos/file/...
      * ```
      */
     async uploadFile(projectKey, request, options) {
@@ -82,13 +82,13 @@ export class AttachmentService extends BaseService {
      * @example
      * ```typescript
      * // 普通附件上传
-     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', '643711xxxx', {
      *   file: new Blob([...]),
      *   field_key: 'field_xxx',
      * });
      *
      * // 复合字段中上传附件
-     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', '643711xxxx', {
      *   file: new Blob([...]),
      *   field_key: 'compound_field_xxx',
      *   index: '0',
@@ -142,7 +142,7 @@ export class AttachmentService extends BaseService {
      * @example
      * ```typescript
      * // 下载附件
-     * const data = await client.workItem.attachment.downloadAttachment('my-project', 'story', 123456, {
+     * const data = await client.workItem.attachment.downloadAttachment('my-project', 'story', '643711xxxx', {
      *   uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx',
      * });
      *
@@ -182,7 +182,7 @@ export class AttachmentService extends BaseService {
      * const stream = await client.workItem.attachment.downloadAttachmentStream(
      *   'my-project',
      *   'story',
-     *   123456,
+     *   '643711xxxx',
      *   { uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx' },
      *   {
      *     onProgress: (p) => console.log(p.progress),
@@ -220,7 +220,7 @@ export class AttachmentService extends BaseService {
      * ```typescript
      * await client.workItem.attachment.deleteAttachment({
      *   project_key: 'my-project',
-     *   work_item_id: 123456,
+     *   work_item_id: '643711xxxx',
      *   field_key: 'field_xxx',
      *   uuids: ['uuid1', 'uuid2'],
      * });

package/dist/service/workitem/comment.d.ts

@@ -39,13 +39,13 @@ export declare class CommentService extends BaseService {
      * @example
      * ```typescript
      * // 添加纯文本评论
-     * const commentId = await client.workItem.comment.create('my-project', 'story', 123456, {
+     * const commentId = await client.workItem.comment.create('my-project', 'story', '623714xxxx', {
      *   content: '这是一条测试评论',
      * });
      * console.log(commentId); // "7587846609728458752"
      *
      * // 添加富文本评论
-     * const commentId = await client.workItem.comment.create('my-project', 'story', 123456, {
+     * const commentId = await client.workItem.comment.create('my-project', 'story', '623714xxxx', {
      *   rich_text: [
      *     {
      *       type: 'paragraph',
@@ -57,7 +57,7 @@ export declare class CommentService extends BaseService {
      * });
      * ```
      */
-    create(projectKey: string, workItemTypeKey: string, workItemId: number, request: CreateCommentRequest, options?: ServiceRequestOptions<string>): Promise<string>;
+    create(projectKey: string, workItemTypeKey: string, workItemId: number | string, request: CreateCommentRequest, options?: ServiceRequestOptions<string>): Promise<string>;
     /**
      * 查询评论列表
      *
@@ -73,18 +73,18 @@ export declare class CommentService extends BaseService {
      * @example
      * ```typescript
      * // 获取所有评论
-     * const result = await client.workItem.comment.list('my-project', 'story', 123456);
+     * const result = await client.workItem.comment.list('my-project', 'story', '621541xxxx');
      * console.log(result.pagination.total); // 评论总数
      * console.log(result.data); // 评论列表
      *
      * // 分页获取评论
-     * const result = await client.workItem.comment.list('my-project', 'story', 123456, {
+     * const result = await client.workItem.comment.list('my-project', 'story', '621541xxxx', {
      *   page_size: 20,
      *   page_num: 1,
      * });
      * ```
      */
-    list(projectKey: string, workItemTypeKey: string, workItemId: number, query?: ListCommentsQuery, options?: ServiceRequestOptions<Comment>): Promise<PaginatedResult<Comment>>;
+    list(projectKey: string, workItemTypeKey: string, workItemId: number | string, query?: ListCommentsQuery, options?: ServiceRequestOptions<Comment>): Promise<PaginatedResult<Comment>>;
     /**
      * 更新评论
      *
@@ -100,12 +100,12 @@ export declare class CommentService extends BaseService {
      * @example
      * ```typescript
      * // 更新为纯文本评论
-     * await client.workItem.comment.update('my-project', 'story', 123456, '7587846609728458752', {
+     * await client.workItem.comment.update('my-project', 'story', '621541xxxx', '7587846609728458752', {
      *   content: '更新后的评论内容',
      * });
      *
      * // 更新为富文本评论
-     * await client.workItem.comment.update('my-project', 'story', 123456, commentId, {
+     * await client.workItem.comment.update('my-project', 'story', '621541xxxx', commentId, {
      *   rich_text: [
      *     {
      *       type: 'paragraph',
@@ -117,7 +117,7 @@ export declare class CommentService extends BaseService {
      * });
      * ```
      */
-    update(projectKey: string, workItemTypeKey: string, workItemId: number, commentId: string, request: UpdateCommentRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    update(projectKey: string, workItemTypeKey: string, workItemId: number | string, commentId: string, request: UpdateCommentRequest, options?: ServiceRequestOptions<void>): Promise<void>;
     /**
      * 删除评论
      *
@@ -131,8 +131,8 @@ export declare class CommentService extends BaseService {
      *
      * @example
      * ```typescript
-     * await client.workItem.comment.remove('my-project', 'story', 123456, '7587846609728458752');
+     * await client.workItem.comment.remove('my-project', 'story', '621541xxxx', '7587846609728458752');
      * ```
      */
-    remove(projectKey: string, workItemTypeKey: string, workItemId: number, commentId: string, options?: ServiceRequestOptions<void>): Promise<void>;
+    remove(projectKey: string, workItemTypeKey: string, workItemId: number | string, commentId: string, options?: ServiceRequestOptions<void>): Promise<void>;
 }

package/dist/service/workitem/comment.js

@@ -37,13 +37,13 @@ export class CommentService extends BaseService {
      * @example
      * ```typescript
      * // 添加纯文本评论
-     * const commentId = await client.workItem.comment.create('my-project', 'story', 123456, {
+     * const commentId = await client.workItem.comment.create('my-project', 'story', '623714xxxx', {
      *   content: '这是一条测试评论',
      * });
      * console.log(commentId); // "7587846609728458752"
      *
      * // 添加富文本评论
-     * const commentId = await client.workItem.comment.create('my-project', 'story', 123456, {
+     * const commentId = await client.workItem.comment.create('my-project', 'story', '623714xxxx', {
      *   rich_text: [
      *     {
      *       type: 'paragraph',
@@ -81,12 +81,12 @@ export class CommentService extends BaseService {
      * @example
      * ```typescript
      * // 获取所有评论
-     * const result = await client.workItem.comment.list('my-project', 'story', 123456);
+     * const result = await client.workItem.comment.list('my-project', 'story', '621541xxxx');
      * console.log(result.pagination.total); // 评论总数
      * console.log(result.data); // 评论列表
      *
      * // 分页获取评论
-     * const result = await client.workItem.comment.list('my-project', 'story', 123456, {
+     * const result = await client.workItem.comment.list('my-project', 'story', '621541xxxx', {
      *   page_size: 20,
      *   page_num: 1,
      * });
@@ -119,12 +119,12 @@ export class CommentService extends BaseService {
      * @example
      * ```typescript
      * // 更新为纯文本评论
-     * await client.workItem.comment.update('my-project', 'story', 123456, '7587846609728458752', {
+     * await client.workItem.comment.update('my-project', 'story', '621541xxxx', '7587846609728458752', {
      *   content: '更新后的评论内容',
      * });
      *
      * // 更新为富文本评论
-     * await client.workItem.comment.update('my-project', 'story', 123456, commentId, {
+     * await client.workItem.comment.update('my-project', 'story', '621541xxxx', commentId, {
      *   rich_text: [
      *     {
      *       type: 'paragraph',
@@ -161,7 +161,7 @@ export class CommentService extends BaseService {
      *
      * @example
      * ```typescript
-     * await client.workItem.comment.remove('my-project', 'story', 123456, '7587846609728458752');
+     * await client.workItem.comment.remove('my-project', 'story', '621541xxxx', '7587846609728458752');
      * ```
      */
     async remove(projectKey, workItemTypeKey, workItemId, commentId, options) {

package/dist/service/workitem/search.d.ts

@@ -149,7 +149,7 @@ export declare class SearchService extends BaseService {
      * @param workItemId 工作项 ID
      * @param request 搜索请求
      * @param options 请求选项
-     * @returns 分页的关联工作项列表（最多 2000 条）
+     * @returns 分页的关联工作项列表（查询结果超过 5000 条会报错）
      *
      * @example
      * ```typescript
@@ -224,12 +224,8 @@ export declare class SearchService extends BaseService {
      * @example
      * ```typescript
      * const result = await client.workItem.search.universalSearch({
-     *   data_sources: [
-     *     {
-     *       project_key: 'project_key',
-     *       work_item_type_keys: 'story',
-     *     },
-     *   ],
+     *   project_key: 'project_key',
+     *   work_item_type_key: 'story',
      *   search_group: {
      *     conjunction: 'AND',
      *     search_params: [

package/dist/service/workitem/search.js

@@ -166,7 +166,7 @@ export class SearchService extends BaseService {
      * @param workItemId 工作项 ID
      * @param request 搜索请求
      * @param options 请求选项
-     * @returns 分页的关联工作项列表（最多 2000 条）
+     * @returns 分页的关联工作项列表（查询结果超过 5000 条会报错）
      *
      * @example
      * ```typescript
@@ -253,12 +253,8 @@ export class SearchService extends BaseService {
      * @example
      * ```typescript
      * const result = await client.workItem.search.universalSearch({
-     *   data_sources: [
-     *     {
-     *       project_key: 'project_key',
-     *       work_item_type_keys: 'story',
-     *     },
-     *   ],
+     *   project_key: 'project_key',
+     *   work_item_type_key: 'story',
      *   search_group: {
      *     conjunction: 'AND',
      *     search_params: [
@@ -277,6 +273,10 @@ export class SearchService extends BaseService {
      * ```
      */
     async universalSearch(request, options) {
-        return this.postCursorPaginated(API_PATHS.UNIVERSAL_SEARCH, request, options, 'data');
+        const result = await this.postCursorPaginated(API_PATHS.UNIVERSAL_SEARCH, request, options, 'datas');
+        return {
+            datas: result.data,
+            pagination: result.pagination,
+        };
     }
 }