node-cnb 1.4.0 → 1.6.0

package/src/client.d.ts

@@ -1,5 +1,7 @@
 import {
+  DtoCreateGroupReq,
   DtoUsersResultForSelf,
+  HttpUpdateUserInfoPayload,
   DtoOrganizationAccess,
   DtoRepos4User,
   DtoRepos4UserBase,
@@ -7,42 +9,72 @@ import {
   DtoUserFollowResult,
   DtoOrganizationUnion,
   DtoWorkspaceDeleteResult,
+  DtoWorkspaceDeleteReq,
   DtoWorkspaceListResult,
+  DtoUpdateGroupAvatarReq,
   DtoListInheritMembers,
   DtoUsersWithAccessLevelInSlug,
   DtoMemberAccessLevelInSlugUnion,
   DtoMemberAccessLevel,
+  DtoUpdateMembersRequest,
+  DtoCreateRepoReq,
   DtoOrganizationSettingWithParent,
+  DtoGroupSettingReq,
   DtoUploadAssetsResponse,
+  DtoUploadRequestParams,
   DtoBuildLogsResult,
   DtoBuildResult,
+  DtoStartBuildReq,
   DtoBuildStatusResult,
   DtoForks,
+  DtoForkReq,
   ApiBranch,
+  OpenapiCreateBranchForm,
   ApiBranchDetail,
   WebCommitAnnotationInBatch,
+  WebGetCommitAnnotationsInBatchForm,
   WebCommitAnnotation,
+  OpenapiPutCommitAnnotationsForm,
   ApiCommitAsset,
+  OpenapiPostCommitAssetUploadUrlForm,
   ApiCommitStatus,
   ApiCommit,
   ApiCompareResponse,
   ApiContent,
   OpenapiHeadRef,
   WebTagAnnotation,
+  OpenapiPutTagAnnotationsForm,
   ApiTag,
   ApiIssue,
+  ApiPostIssueForm,
   ApiIssueDetail,
+  ApiPatchIssueForm,
   ApiIssueComment,
+  ApiPostIssueCommentForm,
+  ApiPatchIssueCommentForm,
   ApiLabel,
+  ApiPostLabelForm,
+  ApiPatchLabelForm,
   DtoOutsideCollaboratorInRepo,
   ApiPullRequest,
+  ApiPullCreationForm,
   ApiPull,
+  ApiPatchPullRequest,
   ApiPullRequestComment,
+  ApiPullCommentCreationForm,
+  ApiPostPullLabelsForm,
+  ApiPutPullLabelsForm,
   ApiMergePullResponse,
+  ApiMergePullRequest,
+  ApiPullReviewCreationForm,
   ApiRelease,
+  OpenapiPostReleaseForm,
+  OpenapiPatchReleaseForm,
+  OpenapiPostReleaseAssetUploadUrlForm,
   ApiReleaseAsset,
   ApiBranchProtection,
   ApiPipelineSettings,
+  WebPipelineSettings,
   ApiPullRequestSettings,
   ApiPushLimitSettings,
   DtoRepoStarUsers,
@@ -51,32 +83,80 @@ import {
 
 export interface Client {
   groups: {
-    post: (params: { request: any }) => Promise<any>;
+    /***
+     * 创建新组织
+     *
+     * 访问令牌调用此接口需包含以下权限
+     * group-manage:rw
+     *
+     * /groups
+     */
+    post: (params: { request: DtoCreateGroupReq }) => Promise<any>;
   };
 
   user: {
+    /***
+     * 获取指定用户的详情信息
+     *
+     * 访问令牌调用此接口需包含以下权限
+     * account-profile:r
+     *
+     * /user
+     */
     get: (params: {}) => Promise<DtoUsersResultForSelf>;
 
-    post: (params: { request: any }) => Promise<any>;
+    /***
+     * 更新指定用户的详情信息, 可更新内容为: 昵称, 个人签名, 微信公众号名称, 微信公众号二维码链接, 个人网站, 个人地址, 公司名称
+     *
+     * 访问令牌调用此接口需包含以下权限
+     * account-profile:rw
+     *
+     * /user
+     */
+    post: (params: { request: HttpUpdateUserInfoPayload }) => Promise<any>;
 
     autocompleteSource: {
+      /***
+       * 查询当前用户用户拥有指定权限的所有资源列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /user/autocomplete_source
+       */
       list: (params: {
-        source_type?: string;
+        source_type?: "Group" | "Repo";
         page?: number;
         page_size?: number;
         search?: string;
-        access?: string;
+        access?: "Reporter" | "Developer" | "Master" | "Owner";
       }) => Promise<string[]>;
     };
 
     groups: {
+      /***
+       * 获取当前用户拥有权限的顶层组织列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /user/groups
+       */
       list: (params: {
         page?: number;
         page_size?: number;
         search?: string;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master" | "Owner";
       }) => Promise<DtoOrganizationAccess[]>;
 
+      /***
+       * 查询当前用户在指定组织下拥有指定权限的子组织列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /user/groups/{group}
+       */
       listByGroup: (params: {
         group: string;
         page?: number;
@@ -86,36 +166,76 @@ export interface Client {
     };
 
     repos: {
+      /***
+       * 获取当前用户拥有指定权限及其以上权限的仓库
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /user/repos
+       */
       list: (params: {
         page?: number;
         page_size?: number;
         search?: string;
-        filter_type?: string;
-        role?: string;
-        order_by?: string;
+        filter_type?: "private" | "public" | "encrypted";
+        role?: "Reporter" | "Developer" | "Master" | "Owner";
+        order_by?: "created_at" | "last_updated_at" | "stars";
         desc?: boolean;
       }) => Promise<DtoRepos4User[]>;
     };
 
     staredRepos: {
+      /***
+       * 获取当前用户 star 的仓库列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /user/stared-repos
+       */
       list: (params: {
         page?: number;
         page_size?: number;
         search?: string;
         desc?: boolean;
-        order_by?: string;
+        order_by?: "created_at" | "last_updated_at" | "stars";
       }) => Promise<DtoRepos4UserBase[]>;
     };
   };
 
   users: {
+    /***
+     * 获取指定用户的详情信息
+     *
+     * 访问令牌调用此接口需包含以下权限
+     * account-profile:r
+     *
+     * /users/{username}
+     */
     get: (params: { username: string }) => Promise<DtoUsersResult>;
 
     avatar: {
+      /***
+       * 获取指定用户的用户头像
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-profile:r
+       *
+       * /users/{username}/avatar/{size}
+       */
       get: (params: { username: string; size: string }) => Promise<any>;
     };
 
     followers: {
+      /***
+       * 获取指定用户的粉丝列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /users/{username}/followers
+       */
       list: (params: {
         username: string;
         page?: number;
@@ -124,6 +244,14 @@ export interface Client {
     };
 
     following: {
+      /***
+       * 获取指定用户的关注人列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /users/{username}/following
+       */
       list: (params: {
         username: string;
         page?: number;
@@ -132,50 +260,100 @@ export interface Client {
     };
 
     groups: {
+      /***
+       * 获取指定用户拥有权限的顶层组织列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /users/{username}/groups
+       */
       get: (params: {
         username: string;
         search?: string;
         page?: number;
         page_size?: number;
         desc?: boolean;
-        order_by?: string;
+        order_by?: "join_time" | "created_at";
       }) => Promise<DtoOrganizationUnion>;
     };
 
     pinnedRepos: {
+      /***
+       * 获取指定用户的用户仓库墙
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /users/{username}/pinned-repos
+       */
       list: (params: { username: string }) => Promise<DtoRepos4User[]>;
     };
 
     repos: {
+      /***
+       * 获取指定用户有指定以上权限并且客人态可见的仓库
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /users/{username}/repos
+       */
       list: (params: {
         username: string;
         search?: string;
-        role?: string;
+        role?: "Reporter" | "Developer" | "Master" | "Owner";
         page?: number;
         page_size?: number;
         desc?: boolean;
-        order_by?: string;
+        order_by?: "created_at" | "last_updated_at" | "stars";
       }) => Promise<DtoRepos4User[]>;
     };
 
     staredRepos: {
+      /***
+       * 获取指定用户的 star 仓库列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /users/{username}/stared-repos
+       */
       list: (params: {
         username: string;
         search?: string;
         page?: number;
         page_size?: number;
         desc?: boolean;
-        order_by?: string;
+        order_by?: "created_at" | "last_updated_at" | "stars";
       }) => Promise<DtoRepos4User[]>;
     };
   };
 
   workspace: {
     delete: {
-      post: (params: { request: any }) => Promise<DtoWorkspaceDeleteResult>;
+      /***
+       * 删除我的云原生开发环境
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:rw
+       *
+       * /workspace/delete
+       */
+      post: (params: {
+        request: DtoWorkspaceDeleteReq;
+      }) => Promise<DtoWorkspaceDeleteResult>;
     };
 
     list: {
+      /***
+       * 获取我的云原生开发环境列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * account-engage:r
+       *
+       * /workspace/list
+       */
       get: (params: {
         branch?: string;
         end?: string;
@@ -189,104 +367,257 @@ export interface Client {
   };
 
   group: {
+    /***
+     * 获取指定组织信息
+     *
+     * 访问令牌调用此接口需包含以下权限
+     * group-resource:r
+     *
+     * /{group}
+     */
     get: (params: { group: string }) => Promise<DtoOrganizationAccess>;
 
     avatar: {
-      put: (params: { group: string; request: any }) => Promise<any>;
+      /***
+       * 更新组织头像 URL 地址
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:rw
+       *
+       * /{group}/-/avatar
+       */
+      put: (params: {
+        group: string;
+        request: DtoUpdateGroupAvatarReq;
+      }) => Promise<any>;
     };
 
     inheritMembers: {
+      /***
+       * 获取指定组织或仓库内的继承成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:r
+       *
+       * /{group}/-/inherit-members
+       */
       list: (params: {
         group: string;
         search?: string;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master" | "Owner";
         page?: number;
         page_size?: number;
       }) => Promise<DtoListInheritMembers[]>;
     };
 
     listMembers: {
+      /***
+       * 获取指定组织或仓库内的有效成员列表，包含继承成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:r
+       *
+       * /{group}/-/list-members
+       */
       list: (params: {
         group: string;
         page?: number;
         page_size?: number;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master" | "Owner";
         search?: string;
         names?: string;
-        order_by?: string;
+        order_by?: "created_at" | "stars" | "follower";
         desc?: boolean;
       }) => Promise<DtoUsersWithAccessLevelInSlug[]>;
     };
 
     logos: {
+      /***
+       * 确认上传的logo
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:rw
+       *
+       * /{group}/-/logos
+       */
       put: (params: { group: string; token: string }) => Promise<any>;
 
+      /***
+       * 发起一个获取 logo 的请求，返回内容或者 302 到某个地址
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-resource:r
+       *
+       * /{group}/-/logos/{size}
+       */
       get: (params: { group: string; size?: string }) => Promise<any>;
     };
 
     members: {
+      /***
+       * 获取指定组织或仓库内的所有直接成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:r
+       *
+       * /{group}/-/members
+       */
       list: (params: {
         group: string;
         page?: number;
         page_size?: number;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master" | "Owner";
         search?: string;
       }) => Promise<DtoUsersWithAccessLevelInSlug[]>;
 
       accessLevel: {
+        /***
+         * 获取指定组织或仓库内, 访问成员在当前层级内的权限信息
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * group-manage:r
+         *
+         * /{group}/-/members/access-level
+         */
         get: (params: {
           group: string;
           include_inherit?: boolean;
         }) => Promise<DtoMemberAccessLevelInSlugUnion>;
 
+        /***
+         * 获取指定组织或仓库内指定成员的权限信息, 结果按组织层级来展示, 包含上层组织的权限继承信息
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * group-manage:r
+         *
+         * /{group}/-/members/{username}/access-level
+         */
         list: (params: {
           group: string;
           username: string;
         }) => Promise<DtoMemberAccessLevel[]>;
       };
 
+      /***
+       * 删除指定组织或仓库的直接成员, 包含两种场景: 1. 作为直接成员的用户自己退出 2. 由管理者移除指定的直接成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:rw
+       *
+       * /{group}/-/members/{username}
+       */
       delete: (params: { group: string; username: string }) => Promise<any>;
 
+      /***
+       * 更新指定组织或仓库内的直接成员权限信息
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:rw
+       *
+       * /{group}/-/members/{username}
+       */
       put: (params: {
         group: string;
         username: string;
-        request: any;
+        request: DtoUpdateMembersRequest;
       }) => Promise<any>;
     };
 
     pinnedRepos: {
+      /***
+       * 获取指定组织的仓库墙列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:r
+       *
+       * /{group}/-/pinned-repos
+       */
       list: (params: { group: string }) => Promise<DtoRepos4UserBase[]>;
 
+      /***
+       * 更新指定组织仓库墙
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:rw
+       *
+       * /{group}/-/pinned-repos
+       */
       put: (params: {
         group: string;
-        request: any;
+        request: string[];
       }) => Promise<DtoRepos4UserBase[]>;
     };
 
     repos: {
+      /***
+       * 查询组织下访问用户有权限查看到仓库
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-resource:r
+       *
+       * /{group}/-/repos
+       */
       list: (params: {
         group: string;
         page?: number;
         page_size?: number;
-        filter_type?: string;
-        order_by?: string;
+        filter_type?: "private" | "public" | "encrypted";
+        order_by?: "created_at" | "last_updated_at" | "stars";
         desc?: boolean;
-        descendant?: string;
+        descendant?: "all" | "sub" | "grand";
         search?: string;
       }) => Promise<DtoRepos4UserBase[]>;
 
-      post: (params: { group: string; request: any }) => Promise<any>;
+      /***
+       * 创建仓库
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-resource:rw
+       *
+       * /{group}/-/repos
+       */
+      post: (params: {
+        group: string;
+        request: DtoCreateRepoReq;
+      }) => Promise<any>;
     };
 
     settings: {
+      /***
+       * 获取指定组织的配置详情
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:r
+       *
+       * /{group}/-/settings
+       */
       get: (params: {
         group: string;
       }) => Promise<DtoOrganizationSettingWithParent>;
 
-      put: (params: { group: string; request: any }) => Promise<any>;
+      /***
+       * 更新指定组织的配置, 可更新内容为: 是否对外隐藏组织成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-manage:rw
+       *
+       * /{group}/-/settings
+       */
+      put: (params: {
+        group: string;
+        request: DtoGroupSettingReq;
+      }) => Promise<any>;
     };
 
     subGroups: {
+      /***
+       * 获取指定组织下的子组织列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-resource:r
+       *
+       * /{group}/-/sub-groups
+       */
       list: (params: {
         group: string;
         search?: string;
@@ -297,9 +628,17 @@ export interface Client {
 
     upload: {
       logos: {
+        /***
+         * 发起一个上传 logo 的请求，返回上传 cos 的 url 和 form 内容
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * group-manage:rw
+         *
+         * /{group}/-/upload/logos
+         */
         post: (params: {
           group: string;
-          request: any;
+          request: DtoUploadRequestParams;
         }) => Promise<DtoUploadAssetsResponse>;
       };
     };
@@ -309,9 +648,17 @@ export interface Client {
     packages: {
       name: {
         tag: {
+          /***
+           * Delete the specific tag
+           *
+           * 访问令牌调用此接口需包含以下权限
+           * repo-registry-delete:rw
+           *
+           * /{registry}/-/packages/{type}/{name}/-/tag/{tag}
+           */
           delete: (params: {
             registry: string;
-            type: string;
+            type: "docker" | "helm";
             name: string;
             tag: string;
           }) => Promise<any>;
@@ -321,10 +668,26 @@ export interface Client {
   };
 
   repo: {
+    /***
+     * 获取指定仓库信息
+     *
+     * 访问令牌调用此接口需包含以下权限
+     * repo-basic-info:r
+     *
+     * /{repo}
+     */
     get: (params: { repo: string }) => Promise<DtoRepos4User>;
 
     build: {
       logs: {
+        /***
+         * 查询流水线构建列表
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-cnb-trigger:r
+         *
+         * /{repo}/-/build/logs
+         */
         get: (params: {
           repo: string;
           createTime?: string;
@@ -343,13 +706,29 @@ export interface Client {
       };
 
       start: {
+        /***
+         * 开始一个构建
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-cnb-trigger:rw
+         *
+         * /{repo}/-/build/start
+         */
         post: (params: {
           repo: string;
-          request: any;
+          request: DtoStartBuildReq;
         }) => Promise<DtoBuildResult[]>;
       };
 
       status: {
+        /***
+         * 查询流水线构建状态
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-cnb-trigger:r
+         *
+         * /{repo}/-/build/status/{sn}
+         */
         get: (params: {
           repo: string;
           sn: string;
@@ -357,6 +736,14 @@ export interface Client {
       };
 
       stop: {
+        /***
+         * 停止一个构建
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-cnb-trigger:rw
+         *
+         * /{repo}/-/build/stop/{sn}
+         */
         post: (params: {
           repo: string;
           sn: string;
@@ -366,11 +753,27 @@ export interface Client {
 
     commitAssets: {
       download: {
+        /***
+         * 发起一个获取 commits 附件的请求，返回内容或者 302 到某个地址
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-contents:r
+         *
+         * /{repo}/-/commit-assets/download/{fileName}
+         */
         get: (params: { repo: string; fileName: string }) => Promise<any>;
       };
     };
 
     files: {
+      /***
+       * 发起一个获取 files 的请求，返回内容或者 302 到某个地址
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-contents:r
+       *
+       * /{repo}/-/files/{userIdKey}/{randomUUID}/{fileName}
+       */
       get: (params: {
         repo: string;
         userIdKey: string;
@@ -378,6 +781,14 @@ export interface Client {
         fileName: string;
       }) => Promise<any>;
 
+      /***
+       * 发起一个确认 files 的请求，上传的图片要调用此接口才能生效
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-contents:rw
+       *
+       * /{repo}/-/files/{userIdKey}/{randomUUID}/{fileName}
+       */
       put: (params: {
         repo: string;
         userIdKey: string;
@@ -388,30 +799,78 @@ export interface Client {
     };
 
     forks: {
+      /***
+       * 获取指定仓库的 fork 列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-base-info:r
+       *
+       * /{repo}/-/forks
+       */
       list: (params: {
         repo: string;
         page: number;
         page_size: number;
       }) => Promise<DtoForks[]>;
 
-      post: (params: { repo: string; request: any }) => Promise<any>;
+      /***
+       * fork 仓库
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * group-resource:rw
+       *
+       * /{repo}/-/forks
+       */
+      post: (params: { repo: string; request: DtoForkReq }) => Promise<any>;
     };
 
     git: {
       branches: {
+        /***
+         * 查询分支列表
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/branches
+         */
         list: (params: {
           repo: string;
           page?: number;
           page_size?: number;
         }) => Promise<ApiBranch[]>;
 
+        /***
+         * 创建新分支
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/branches
+         */
         post: (params: {
           repo: string;
-          create_branch_form: any;
+          create_branch_form: OpenapiCreateBranchForm;
         }) => Promise<any>;
 
+        /***
+         * 删除指定分支
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/branches/{branch}
+         */
         delete: (params: { repo: string; branch: string }) => Promise<any>;
 
+        /***
+         * 查询指定分支
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/branches/{branch}
+         */
         get: (params: {
           repo: string;
           branch?: string;
@@ -419,24 +878,56 @@ export interface Client {
       };
 
       commitAnnotationsInBatch: {
+        /***
+         * 查询指定 commit 的元数据
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/commit-annotations-in-batch
+         */
         post: (params: {
           repo: string;
-          get_commit_annotations_form: any;
+          get_commit_annotations_form: WebGetCommitAnnotationsInBatchForm;
         }) => Promise<WebCommitAnnotationInBatch[]>;
       };
 
       commitAnnotations: {
+        /***
+         * 查询指定 commit 的元数据
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/commit-annotations/{sha}
+         */
         list: (params: {
           repo: string;
           sha: string;
         }) => Promise<WebCommitAnnotation[]>;
 
+        /***
+         * 设定指定 commit 的元数据
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/commit-annotations/{sha}
+         */
         put: (params: {
           repo: string;
           sha: string;
-          put_commit_annotations_form: any;
+          put_commit_annotations_form: OpenapiPutCommitAnnotationsForm;
         }) => Promise<any>;
 
+        /***
+         * 删除指定 commit 的元数据
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/commit-annotations/{sha}/{key}
+         */
         delete: (params: {
           repo: string;
           sha: string;
@@ -445,12 +936,28 @@ export interface Client {
       };
 
       commitAssets: {
+        /***
+         * 查询指定 commit 的附件
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/commit-assets/{sha1}
+         */
         list: (params: {
           repo: string;
           sha1: string;
         }) => Promise<ApiCommitAsset[]>;
 
         assetUploadConfirmation: {
+          /***
+           * 确认 Commit asset 上传完成
+           *
+           * 访问令牌调用此接口需包含以下权限
+           * repo-code:rw
+           *
+           * /{repo}/-/git/commit-assets/{sha1}/asset-upload-confirmation/{token}/{asset_path}
+           */
           post: (params: {
             repo: string;
             sha1: number;
@@ -460,13 +967,29 @@ export interface Client {
         };
 
         assetUploadUrl: {
+          /***
+           * 新增一个 Commit asset
+           *
+           * 访问令牌调用此接口需包含以下权限
+           * repo-code:rw
+           *
+           * /{repo}/-/git/commit-assets/{sha1}/asset-upload-url
+           */
           post: (params: {
             repo: string;
             sha1: number;
-            create_commit_asset_upload_url_form: any;
+            create_commit_asset_upload_url_form: OpenapiPostCommitAssetUploadUrlForm;
           }) => Promise<any>;
         };
 
+        /***
+         * 删除指定 commit 的附件
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/commit-assets/{sha1}/{asset_id}
+         */
         delete: (params: {
           repo: string;
           sha1: string;
@@ -475,6 +998,14 @@ export interface Client {
       };
 
       commitStatuses: {
+        /***
+         * 查询指定 commit 的 check statuses
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/commit-statuses/{commitish}
+         */
         list: (params: {
           repo: string;
           sha: string;
@@ -482,6 +1013,14 @@ export interface Client {
       };
 
       commits: {
+        /***
+         * 查询 commit 列表
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/commits
+         */
         list: (params: {
           repo: string;
           sha?: string;
@@ -493,10 +1032,26 @@ export interface Client {
           page_size?: number;
         }) => Promise<ApiCommit[]>;
 
+        /***
+         * 查询指定 commit
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/commits/{ref}
+         */
         get: (params: { repo: string; ref: string }) => Promise<ApiCommit>;
       };
 
       compare: {
+        /***
+         * 对比 base...head
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/compare/{base_head}
+         */
         get: (params: {
           repo: string;
           base_head: string;
@@ -504,6 +1059,14 @@ export interface Client {
       };
 
       contents: {
+        /***
+         * 查询仓库文件列表或文件
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/contents/{file_path}
+         */
         get: (params: {
           repo: string;
           file_path: string;
@@ -512,47 +1075,119 @@ export interface Client {
       };
 
       head: {
+        /***
+         * 获取仓库默认分支
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/head
+         */
         get: (params: { repo: string }) => Promise<OpenapiHeadRef>;
       };
 
       tagAnnotations: {
+        /***
+         * 删除指定 tag 的元数据
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/tag-annotations/{tag_with_key}
+         */
         delete: (params: {
           repo: string;
           tag_with_key: string;
         }) => Promise<any>;
 
+        /***
+         * 查询指定 tag 的元数据
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/tag-annotations/{tag}
+         */
         list: (params: {
           repo: string;
           tag: string;
         }) => Promise<WebTagAnnotation[]>;
 
+        /***
+         * 设定指定 tag 的元数据
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/tag-annotations/{tag}
+         */
         put: (params: {
           repo: string;
           tag: string;
-          put_tag_annotations_form: any;
+          put_tag_annotations_form: OpenapiPutTagAnnotationsForm;
         }) => Promise<any>;
       };
 
       tags: {
+        /***
+         * 查询标签列表
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/tags
+         */
         list: (params: {
           repo: string;
           page?: number;
           page_size?: number;
         }) => Promise<ApiTag[]>;
 
+        /***
+         * 删除指定标签
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/git/tags/{tag}
+         */
         delete: (params: { repo: string; tag: string }) => Promise<any>;
 
+        /***
+         * 查询指定 Tag
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/git/tags/{tag}
+         */
         get: (params: { repo: string; tag: string }) => Promise<ApiTag>;
       };
     };
 
     imgs: {
+      /***
+       * 发起一个获取 imgs 的请求，返回内容或者 302 到某个地址
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-contents:r
+       *
+       * /{repo}/-/imgs/{userIdKey}/{fileName}
+       */
       get: (params: {
         repo: string;
         userIdKey: string;
         fileName: string;
       }) => Promise<any>;
 
+      /***
+       * 发起一个确认 imgs 的请求，上传的图片要调用此接口才能生效
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-contents:rw
+       *
+       * /{repo}/-/imgs/{userIdKey}/{fileName}
+       */
       put: (params: {
         repo: string;
         userIdKey: string;
@@ -562,16 +1197,32 @@ export interface Client {
     };
 
     inheritMembers: {
+      /***
+       * 获取指定组织或仓库内的继承成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:r
+       *
+       * /{repo}/-/inherit-members
+       */
       list: (params: {
         repo: string;
         search?: string;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master" | "Owner";
         page?: number;
         page_size?: number;
       }) => Promise<DtoListInheritMembers[]>;
     };
 
     issues: {
+      /***
+       * 查询仓库的 Issues
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-notes:r
+       *
+       * /{repo}/-/issues
+       */
       list: (params: {
         repo: string;
         page?: number;
@@ -587,15 +1238,42 @@ export interface Client {
         order_by?: string;
       }) => Promise<ApiIssue[]>;
 
-      post: (params: { repo: string; post_issue_form: any }) => Promise<any>;
+      /***
+       * 创建一个 Issue
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-notes:rw
+       *
+       * /{repo}/-/issues
+       */
+      post: (params: {
+        repo: string;
+        post_issue_form: ApiPostIssueForm;
+      }) => Promise<any>;
 
+      /***
+       * 更新一个 Issue
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-notes:rw
+       *
+       * /{repo}/-/issues/{number}
+       */
       patch: (params: {
         repo: string;
         number: number;
-        patch_issue_form: any;
+        patch_issue_form: ApiPatchIssueForm;
       }) => Promise<ApiIssueDetail>;
 
       comments: {
+        /***
+         * 查询仓库的 Issue 评论列表
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:r
+         *
+         * /{repo}/-/issues/{number}/comments
+         */
         list: (params: {
           repo: string;
           number: number;
@@ -603,29 +1281,69 @@ export interface Client {
           page_size?: number;
         }) => Promise<ApiIssueComment[]>;
 
+        /***
+         * 创建一个 Issue Comment
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/issues/{number}/comments
+         */
         post: (params: {
           repo: string;
           number: number;
-          post_issue_comment_form: any;
+          post_issue_comment_form: ApiPostIssueCommentForm;
         }) => Promise<any>;
 
+        /***
+         * 获取一个 Issue Comment
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:r
+         *
+         * /{repo}/-/issues/{number}/comments/{comment_id}
+         */
         get: (params: {
           repo: string;
           number: number;
           comment_id: number;
         }) => Promise<ApiIssueComment>;
 
+        /***
+         * 修改一个 Issue Comment
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/issues/{number}/comments/{comment_id}
+         */
         patch: (params: {
           repo: string;
           number: number;
           comment_id: number;
-          patch_issue_comment_form: any;
+          patch_issue_comment_form: ApiPatchIssueCommentForm;
         }) => Promise<ApiIssueComment>;
       };
 
       labels: {
+        /***
+         * 清空 Issue 标签
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/issues/{number}/labels
+         */
         delete: (params: { repo: string; number: number }) => Promise<any>;
 
+        /***
+         * 删除 Issue 标签
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/issues/{number}/labels/{name}
+         */
         deleteByName: (params: {
           repo: string;
           number: number;
@@ -635,6 +1353,14 @@ export interface Client {
     };
 
     labels: {
+      /***
+       * 查询仓库的标签(label) 列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-notes:r
+       *
+       * /{repo}/-/labels
+       */
       list: (params: {
         repo: string;
         page?: number;
@@ -642,79 +1368,186 @@ export interface Client {
         keyword?: string;
       }) => Promise<ApiLabel[]>;
 
-      post: (params: { repo: string; post_label_form: any }) => Promise<any>;
+      /***
+       * 创建一个 标签
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-notes:rw
+       *
+       * /{repo}/-/labels
+       */
+      post: (params: {
+        repo: string;
+        post_label_form: ApiPostLabelForm;
+      }) => Promise<any>;
 
+      /***
+       * 删除指定的仓库标签 label
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-notes:rw
+       *
+       * /{repo}/-/labels/{name}
+       */
       delete: (params: { repo: string; name: string }) => Promise<any>;
 
+      /***
+       * 更新标签信息
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-notes:rw
+       *
+       * /{repo}/-/labels/{name}
+       */
       patch: (params: {
         repo: string;
         name: string;
-        patch_label_form: any;
+        patch_label_form: ApiPatchLabelForm;
       }) => Promise<ApiLabel>;
     };
 
     listMembers: {
+      /***
+       * 获取指定组织或仓库内的有效成员列表，包含继承成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:r
+       *
+       * /{repo}/-/list-members
+       */
       list: (params: {
         repo: string;
         page?: number;
         page_size?: number;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master" | "Owner";
         search?: string;
         names?: string;
-        order_by?: string;
+        order_by?: "created_at" | "stars" | "follower";
         desc?: boolean;
       }) => Promise<DtoUsersWithAccessLevelInSlug[]>;
     };
 
     members: {
+      /***
+       * 获取指定组织或仓库内的所有直接成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:r
+       *
+       * /{repo}/-/members
+       */
       list: (params: {
         repo: string;
         page?: number;
         page_size?: number;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master" | "Owner";
         search?: string;
       }) => Promise<DtoUsersWithAccessLevelInSlug[]>;
 
       accessLevel: {
+        /***
+         * 获取指定组织或仓库内, 访问成员在当前层级内的权限信息
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:r
+         *
+         * /{repo}/-/members/access-level
+         */
         get: (params: {
           repo: string;
           include_inherit?: boolean;
         }) => Promise<DtoMemberAccessLevelInSlugUnion>;
 
+        /***
+         * 获取指定组织或仓库内指定成员的权限信息, 结果按组织层级来展示, 包含上层组织的权限继承信息
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:r
+         *
+         * /{repo}/-/members/{username}/access-level
+         */
         list: (params: {
           repo: string;
           username: string;
         }) => Promise<DtoMemberAccessLevel[]>;
       };
 
+      /***
+       * 删除指定组织或仓库的直接成员, 包含两种场景: 1. 作为直接成员的用户自己退出 2. 由管理者移除指定的直接成员
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:rw
+       *
+       * /{repo}/-/members/{username}
+       */
       delete: (params: { repo: string; username: string }) => Promise<any>;
 
+      /***
+       * 更新指定组织或仓库内的直接成员权限信息
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:rw
+       *
+       * /{repo}/-/members/{username}
+       */
       put: (params: {
         repo: string;
         username: string;
-        request: any;
+        request: DtoUpdateMembersRequest;
       }) => Promise<any>;
     };
 
     outsideCollaborators: {
+      /***
+       * 获取指定仓库内的外部贡献者
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:r
+       *
+       * /{repo}/-/outside-collaborators
+       */
       list: (params: {
         repo: string;
         page?: number;
         page_size?: number;
-        role?: string;
+        role?: "Guest" | "Reporter" | "Developer" | "Master";
         search?: string;
       }) => Promise<DtoOutsideCollaboratorInRepo[]>;
 
+      /***
+       * 删除指定仓库的外部贡献者, 包含两种场景: 1. 作为外部贡献者的用户自己退出仓库 2. 由仓库管理者移除指定的外部贡献者
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:rw
+       *
+       * /{repo}/-/outside-collaborators/{username}
+       */
       delete: (params: { repo: string; username: string }) => Promise<any>;
 
+      /***
+       * 更新指定仓库的外部贡献者权限信息
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-manage:rw
+       *
+       * /{repo}/-/outside-collaborators/{username}
+       */
       put: (params: {
         repo: string;
         username: string;
-        role: string;
+        role: "Guest" | "Reporter" | "Developer";
       }) => Promise<any>;
     };
 
     pulls: {
+      /***
+       * [openapi] 查询 Pull 列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-pr:r
+       *
+       * /{repo}/-/pulls
+       */
       list: (params: {
         repo: string;
         page?: number;
@@ -725,33 +1558,92 @@ export interface Client {
         assignees?: string;
       }) => Promise<ApiPullRequest[]>;
 
-      post: (params: { repo: string; post_pull_form: any }) => Promise<any>;
+      /***
+       * [openapi] 新增一个 Pull
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-pr:rw
+       *
+       * /{repo}/-/pulls
+       */
+      post: (params: {
+        repo: string;
+        post_pull_form: ApiPullCreationForm;
+      }) => Promise<any>;
 
+      /***
+       * [openapi] 查询指定 Pull
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-pr:r
+       *
+       * /{repo}/-/pulls/{number}
+       */
       get: (params: { repo: string; number: number }) => Promise<ApiPull>;
 
+      /***
+       * [openapi] 更新一个 Pull Request
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-pr:rw
+       *
+       * /{repo}/-/pulls/{number}
+       */
       patch: (params: {
         repo: string;
         number: number;
-        update_pull_request_form: any;
+        update_pull_request_form: ApiPatchPullRequest;
       }) => Promise<ApiPull>;
 
       comments: {
+        /***
+         * [openapi] 查询 Pull Comments 列表
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:r
+         *
+         * /{repo}/-/pulls/{number}/comments
+         */
         list: (params: {
           repo: string;
           page?: number;
           page_size?: number;
         }) => Promise<ApiPullRequestComment[]>;
 
+        /***
+         * [openapi] 新增一个 Pull Comment
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/pulls/{number}/comments
+         */
         post: (params: {
           repo: string;
           number: number;
-          post_pull_comment_form: any;
+          post_pull_comment_form: ApiPullCommentCreationForm;
         }) => Promise<any>;
       };
 
       labels: {
+        /***
+         * 清空 Pull 标签
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/pulls/{number}/labels
+         */
         delete: (params: { repo: string; number: number }) => Promise<any>;
 
+        /***
+         * 查询 Pull 的标签(label) 列表
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:r
+         *
+         * /{repo}/-/pulls/{number}/labels
+         */
         list: (params: {
           repo: string;
           number: number;
@@ -759,18 +1651,42 @@ export interface Client {
           page_size?: number;
         }) => Promise<ApiLabel[]>;
 
+        /***
+         * 新增 Pull 标签
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/pulls/{number}/labels
+         */
         post: (params: {
           repo: string;
           number: number;
-          post_pull_labels_form: any;
+          post_pull_labels_form: ApiPostPullLabelsForm;
         }) => Promise<ApiLabel>;
 
+        /***
+         * 设置 Pull 标签
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/pulls/{number}/labels
+         */
         put: (params: {
           repo: string;
           number: number;
-          put_pull_labels_form: any;
+          put_pull_labels_form: ApiPutPullLabelsForm;
         }) => Promise<ApiLabel>;
 
+        /***
+         * 删除 Pull 标签
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/pulls/{number}/labels/{name}
+         */
         deleteByName: (params: {
           repo: string;
           number: number;
@@ -779,56 +1695,136 @@ export interface Client {
       };
 
       merge: {
+        /***
+         * [openapi] 合并一个 Pull Request
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-pr:rw
+         *
+         * /{repo}/-/pulls/{number}/merge
+         */
         put: (params: {
           repo: string;
           number: number;
-          merge_pull_request_form: any;
+          merge_pull_request_form: ApiMergePullRequest;
         }) => Promise<ApiMergePullResponse>;
       };
 
       reviews: {
+        /***
+         * [openapi] 新增一个 Pull Review
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-notes:rw
+         *
+         * /{repo}/-/pulls/{number}/reviews
+         */
         post: (params: {
           repo: string;
           number: number;
-          post_pull_review_form: any;
+          post_pull_review_form: ApiPullReviewCreationForm;
         }) => Promise<any>;
       };
     };
 
     releases: {
+      /***
+       * [openapi] 查询 release 列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-code:r
+       *
+       * /{repo}/-/releases
+       */
       list: (params: {
         repo: string;
         page?: number;
         page_size?: number;
       }) => Promise<ApiRelease[]>;
 
+      /***
+       * [openapi] 新增一个 Release
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-code:rw
+       *
+       * /{repo}/-/releases
+       */
       post: (params: {
         repo: string;
-        create_release_form: any;
+        create_release_form: OpenapiPostReleaseForm;
       }) => Promise<any>;
 
       download: {
+        /***
+         * 发起一个获取 release 附件的请求，返回内容或者 302 到某个地址
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-contents:r
+         *
+         * /{repo}/-/releases/download/{fileName}
+         */
         get: (params: { repo: string; fileName: string }) => Promise<any>;
       };
 
       tags: {
+        /***
+         * [openapi] 通过 tag 查询指定 release
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/releases/tags/{tag}
+         */
         get: (params: { repo: string; tag: string }) => Promise<ApiRelease>;
       };
 
+      /***
+       * [openapi] 删除指定的 release
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-code:rw
+       *
+       * /{repo}/-/releases/{release_id}
+       */
       delete: (params: { repo: string; release_id: number }) => Promise<any>;
 
+      /***
+       * [openapi] 根据 id	查询指定 release
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-code:r
+       *
+       * /{repo}/-/releases/{release_id}
+       */
       get: (params: {
         repo: string;
         release_id: number;
       }) => Promise<ApiRelease>;
 
+      /***
+       * [openapi] 更新 release
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-code:rw
+       *
+       * /{repo}/-/releases/{release_id}
+       */
       patch: (params: {
         repo: string;
         release_id: number;
-        patch_release_form: any;
+        patch_release_form: OpenapiPatchReleaseForm;
       }) => Promise<any>;
 
       assetUploadConfirmation: {
+        /***
+         * [openapi] 确认 Release asset 上传完成
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/releases/{release_id}/asset-upload-confirmation/{token}/{asset_path}
+         */
         post: (params: {
           repo: string;
           release_id: number;
@@ -838,20 +1834,44 @@ export interface Client {
       };
 
       assetUploadUrl: {
+        /***
+         * [openapi] 新增一个 Release asset
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/releases/{release_id}/asset-upload-url
+         */
         post: (params: {
           repo: string;
           release_id: number;
-          create_release_asset_upload_url_form: any;
+          create_release_asset_upload_url_form: OpenapiPostReleaseAssetUploadUrlForm;
         }) => Promise<any>;
       };
 
       assets: {
+        /***
+         * [openapi] 删除指定的 release asset
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:rw
+         *
+         * /{repo}/-/releases/{release_id}/assets/{asset_id}
+         */
         delete: (params: {
           repo: string;
           release_id: number;
           asset_id: number;
         }) => Promise<any>;
 
+        /***
+         * [openapi] 查询指定的 release asset
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-code:r
+         *
+         * /{repo}/-/releases/{release_id}/assets/{asset_id}
+         */
         get: (params: {
           repo: string;
           release_id: number;
@@ -862,56 +1882,169 @@ export interface Client {
 
     settings: {
       branchProtections: {
+        /***
+         * 查询仓库保护分支规则列表(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:r
+         *
+         * /{repo}/-/settings/branch-protections
+         */
         list: (params: { repo: string }) => Promise<ApiBranchProtection[]>;
 
+        /***
+         * 新增仓库保护分支规则(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:rw
+         *
+         * /{repo}/-/settings/branch-protections
+         */
         post: (params: {
           repo: string;
-          branch_protection_form: any;
+          branch_protection_form: ApiBranchProtection;
         }) => Promise<any>;
 
+        /***
+         * 删除仓库保护分支规则(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:rw
+         *
+         * /{repo}/-/settings/branch-protections/{id}
+         */
         delete: (params: { repo: string; id: string }) => Promise<any>;
 
+        /***
+         * 查询仓库保护分支规则(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:r
+         *
+         * /{repo}/-/settings/branch-protections/{id}
+         */
         get: (params: {
           repo: string;
           id: string;
         }) => Promise<ApiBranchProtection>;
 
+        /***
+         * 更新仓库保护分支规则(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:rw
+         *
+         * /{repo}/-/settings/branch-protections/{id}
+         */
         patch: (params: {
           repo: string;
           id: string;
-          branch_protection_form: any;
+          branch_protection_form: ApiBranchProtection;
         }) => Promise<any>;
       };
 
       cloudNativeBuild: {
+        /***
+         * 查询仓库云原生构建设置(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:r
+         *
+         * /{repo}/-/settings/cloud-native-build
+         */
         get: (params: { repo: string }) => Promise<ApiPipelineSettings>;
 
-        put: (params: { repo: string; pipeline_form: any }) => Promise<any>;
+        /***
+         * 更新仓库云原生构建设置(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:rw
+         *
+         * /{repo}/-/settings/cloud-native-build
+         */
+        put: (params: {
+          repo: string;
+          pipeline_form: WebPipelineSettings;
+        }) => Promise<any>;
       };
 
       pullRequest: {
+        /***
+         * 查询仓库合并请求设置(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:r
+         *
+         * /{repo}/-/settings/pull-request
+         */
         get: (params: { repo: string }) => Promise<ApiPullRequestSettings>;
 
-        put: (params: { repo: string; pull_request_form: any }) => Promise<any>;
+        /***
+         * 设置仓库推送设置(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:rw
+         *
+         * /{repo}/-/settings/pull-request
+         */
+        put: (params: {
+          repo: string;
+          pull_request_form: ApiPullRequestSettings;
+        }) => Promise<any>;
       };
 
       pushLimit: {
+        /***
+         * 查询仓库推送设置(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:r
+         *
+         * /{repo}/-/settings/push-limit
+         */
         get: (params: { repo: string }) => Promise<ApiPushLimitSettings>;
 
-        put: (params: { repo: string; push_limit_form: any }) => Promise<any>;
+        /***
+         * 设置仓库推送设置(openapi)
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-manage:rw
+         *
+         * /{repo}/-/settings/push-limit
+         */
+        put: (params: {
+          repo: string;
+          push_limit_form: ApiPushLimitSettings;
+        }) => Promise<any>;
       };
     };
 
     stars: {
+      /***
+       * 获取指定仓库的star用户列表
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-basic-info:r
+       *
+       * /{repo}/-/stars
+       */
       get: (params: {
         repo: string;
-        filter_type: string;
+        filter_type: "all" | "followed";
         page: number;
         page_size: number;
       }) => Promise<DtoRepoStarUsers>;
     };
 
     topActivityUsers: {
+      /***
+       * 获取 top 贡献用户
+       *
+       * 访问令牌调用此接口需包含以下权限
+       * repo-base-info:r
+       *
+       * /{repo}/-/top-activity-users
+       */
       list: (params: {
         repo: string;
         top?: number;
@@ -920,30 +2053,62 @@ export interface Client {
 
     upload: {
       files: {
+        /***
+         * 发起一个上传 files（issue，pr 及其评论中文档，压缩包等）的请求，返回上传 cos 的 url 和 form 内容
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-contents:rw
+         *
+         * /{repo}/-/upload/files
+         */
         post: (params: {
           repo: string;
-          request: any;
+          request: DtoUploadRequestParams;
         }) => Promise<DtoUploadAssetsResponse>;
       };
 
       imgs: {
+        /***
+         * 发起一个上传 imgs 的请求，返回上传 cos 的 url 和 form 内容
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-contents:rw
+         *
+         * /{repo}/-/upload/imgs
+         */
         post: (params: {
           repo: string;
-          request: any;
+          request: DtoUploadRequestParams;
         }) => Promise<DtoUploadAssetsResponse>;
       };
 
       releases: {
+        /***
+         * 发起一个上传 release 附件的请求，返回上传 cos 的 url 和 form 内容
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-contents:rw
+         *
+         * /{repo}/-/upload/releases/{tagName}
+         */
         post: (params: {
           repo: string;
           tagName: string;
-          request: any;
+          request: DtoUploadRequestParams;
         }) => Promise<DtoUploadAssetsResponse>;
       };
     };
 
     workspace: {
       detail: {
+        /***
+         * 根据流水线sn查询云原生开发访问地址
+         *
+         * 访问令牌调用此接口需包含以下权限
+         * repo-cnb-detail:r
+         *
+         * /{repo}/-/workspace/detail/{sn}
+         */
         get: (params: {
           repo: string;
           sn: string;