@petercatai/whisker-client 0.1.202512041544 → 0.1.202512291542-dev

package/dist/api.d.ts

@@ -113,7 +113,9 @@ export declare enum IKnowledgeTypeEnum {
     Perl = "perl",
     Haskell = "haskell",
     Elixir = "elixir",
-    Powershell = "powershell"
+    Powershell = "powershell",
+    NodePackage = "node_package",
+    NodePackageElement = "node_package_element"
 }
 /**
  * KnowledgeSourceEnum
@@ -127,7 +129,8 @@ export declare enum IKnowledgeSourceEnum {
     CloudStorageImage = "cloud_storage_image",
     Yuque = "yuque",
     YuquePersonalDoc = "yuque_personal_doc",
-    YuquePersonalNote = "yuque_personal_note"
+    YuquePersonalNote = "yuque_personal_note",
+    HituNodePackage = "hitu_node_package"
 }
 /** Action */
 export declare enum IAction {
@@ -314,6 +317,129 @@ export interface IActiveStatusUpdate {
     /** Status */
     status: boolean;
 }
+/**
+ * AdminTaskRestartRequest
+ * 管理员任务重启请求
+ */
+export interface IAdminTaskRestartRequest {
+    /**
+     * Start Time
+     * 开始时间 (UTC)
+     * @format date-time
+     */
+    start_time: string;
+    /**
+     * End Time
+     * 结束时间 (UTC)
+     * @format date-time
+     */
+    end_time: string;
+    /**
+     * Status List
+     * 任务状态列表，如 ['failed', 'canceled']
+     */
+    status_list: ITaskStatus[];
+    /**
+     * Tenant Id
+     * 租户ID（可选）
+     */
+    tenant_id?: string | null;
+    /**
+     * Space Id
+     * 空间ID（可选）
+     */
+    space_id?: string | null;
+    /**
+     * Task Type
+     * 任务类型（可选）
+     */
+    task_type?: string | null;
+    /**
+     * Dry Run
+     * 是否仅预览，不实际重启
+     * @default false
+     */
+    dry_run?: boolean;
+}
+/**
+ * AdminTaskRestartResponse
+ * 管理员任务重启响应
+ */
+export interface IAdminTaskRestartResponse {
+    /**
+     * Total Matched
+     * 匹配的任务总数
+     */
+    total_matched: number;
+    /**
+     * Restarted Count
+     * 成功重启的任务数
+     */
+    restarted_count: number;
+    /**
+     * Task Ids
+     * 重启的任务ID列表
+     */
+    task_ids?: string[];
+}
+/**
+ * AdminUpdateSpaceRequest
+ * 管理员更新空间信息请求
+ */
+export interface IAdminUpdateSpaceRequest {
+    /**
+     * Space Name
+     * 空间名称
+     */
+    space_name?: string | null;
+    /**
+     * Description
+     * 空间描述
+     */
+    description?: string | null;
+    /**
+     * Metadata
+     * 元数据
+     */
+    metadata?: Record<string, any> | null;
+}
+/**
+ * AdminUpdateTenantRequest
+ * 管理员更新租户信息请求
+ */
+export interface IAdminUpdateTenantRequest {
+    /**
+     * Tenant Name
+     * 租户名称
+     */
+    tenant_name?: string | null;
+    /**
+     * Email
+     * 邮箱
+     */
+    email?: string | null;
+    /**
+     * Is Active
+     * 是否激活
+     */
+    is_active?: boolean | null;
+    /**
+     * Metadata
+     * 元数据
+     */
+    metadata?: Record<string, any> | null;
+}
+/**
+ * AdminUpdateTenantSecretKeyRequest
+ * 管理员更新租户密钥请求
+ */
+export interface IAdminUpdateTenantSecretKeyRequest {
+    /**
+     * Secret Key
+     * 新密钥，格式必须为 sk-xxxx（至少10个字符）
+     */
+    secret_key: string;
+}
 /**
  * ArtifactIndex
  * whisker_artifact_index 模型
@@ -828,6 +954,21 @@ export interface IEnableStatusUpdate {
     /** Status */
     status: boolean;
 }
+/** FilterFieldsUpdate */
+export interface IFilterFieldsUpdate {
+    /** Knowledge Id */
+    knowledge_id: string;
+    /** F1 */
+    f1?: string | null;
+    /** F2 */
+    f2?: string | null;
+    /** F3 */
+    f3?: string | null;
+    /** F4 */
+    f4?: string | null;
+    /** F5 */
+    f5?: string | null;
+}
 /** FilterGroup */
 export interface IFilterGroup {
     operator: IOperator;
@@ -1030,6 +1171,62 @@ export interface IHTTPValidationError {
     /** Detail */
     detail?: IValidationError[];
 }
+/** HituNodePackageCreate */
+export interface IHituNodePackageCreate {
+    /**
+     * Space Id
+     * the space of knowledge, example: petercat bot id, github repo name
+     */
+    space_id: string;
+    /**
+     * Knowledge Type
+     * type of knowledge resource
+     * @default "node_package"
+     */
+    knowledge_type?: "node_package";
+    /**
+     * Knowledge Name
+     * name of the knowledge resource
+     * @maxLength 255
+     */
+    knowledge_name: string;
+    /**
+     * Metadata
+     * additional metadata, user can update it
+     * @default {}
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Source Type
+     * source type
+     * @default "hitu_node_package"
+     */
+    source_type?: "hitu_node_package";
+    /**
+     * Embedding Model Name
+     * name of the embedding model. you can set any other model if target embedding service registered
+     */
+    embedding_model_name: string;
+    /**
+     * File Sha
+     * SHA of the file
+     */
+    file_sha?: string | null;
+    /**
+     * File Size
+     * size of the file
+     */
+    file_size?: number | null;
+    /**
+     * Parent Id
+     * parent id of the knowledge
+     */
+    parent_id?: string | null;
+    /** source config of the knowledge */
+    source_config: INodePackageSourceConfig;
+    /** split config of the knowledge */
+    split_config: INodePackageParseConfig;
+}
 /** Image */
 export interface IImage {
     /** Url */
@@ -1236,7 +1433,7 @@ export interface IKnowledgeInput {
      * Source Config
      * source config of the knowledge
      */
-    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig;
+    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig;
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
@@ -1246,7 +1443,7 @@ export interface IKnowledgeInput {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IBaseCharSplitConfig | IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig;
+    split_config: IBaseCharSplitConfig | IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig;
     /**
      * File Sha
      * SHA of the file
@@ -1322,7 +1519,7 @@ export interface IKnowledgeOutput {
      * Source Config
      * source config of the knowledge
      */
-    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig;
+    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig;
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
@@ -1332,7 +1529,7 @@ export interface IKnowledgeOutput {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IBaseCharSplitConfig | IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig;
+    split_config: IBaseCharSplitConfig | IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig;
     /**
      * File Sha
      * SHA of the file
@@ -1471,6 +1668,30 @@ export interface IMarkdownSplitConfig {
      */
     extract_header_first?: boolean | null;
 }
+/** NodePackageParseConfig */
+export interface INodePackageParseConfig {
+    /**
+     * Type
+     * @default "node_package"
+     */
+    type?: "node_package";
+}
+/**
+ * NodePackageSourceConfig
+ * Node package source config
+ */
+export interface INodePackageSourceConfig {
+    /**
+     * Package Name
+     * the hitu package id
+     */
+    package_name: string;
+    /**
+     * Package Version
+     * the hitu package version
+     */
+    package_version: string;
+}
 /** OpenIdSourceConfig */
 export interface IOpenIdSourceConfig {
     /**
@@ -2192,6 +2413,14 @@ export interface IResponseModelAPIKey {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[AdminTaskRestartResponse] */
+export interface IResponseModelAdminTaskRestartResponse {
+    /** Success */
+    success: boolean;
+    data?: IAdminTaskRestartResponse | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[Any] */
 export interface IResponseModelAny {
     /** Success */
@@ -2413,6 +2642,14 @@ export interface IResponseModelSpaceResponse {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[Space] */
+export interface IResponseModelSpace {
+    /** Success */
+    success: boolean;
+    data?: ISpaceOutput | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[StatusStatisticsPageResponse[Task]] */
 export interface IResponseModelStatusStatisticsPageResponseTask {
     /** Success */
@@ -2437,6 +2674,14 @@ export interface IResponseModelTask {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[TenantNameCheckResponse] */
+export interface IResponseModelTenantNameCheckResponse {
+    /** Success */
+    success: boolean;
+    data?: ITenantNameCheckResponse | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[Tenant] */
 export interface IResponseModelTenant {
     /** Success */
@@ -2785,6 +3030,88 @@ export interface IS3SourceConfig {
      */
     auth_info?: string | null;
 }
+/** Space */
+export interface ISpaceInput {
+    /**
+     * Gmt Create
+     * creation time
+     */
+    gmt_create?: string | null;
+    /**
+     * Gmt Modified
+     * update time
+     */
+    gmt_modified?: string | null;
+    /**
+     * Space Name
+     * name of the space resource
+     * @maxLength 64
+     */
+    space_name: string;
+    /**
+     * Space Id
+     * space id
+     */
+    space_id?: string;
+    /**
+     * Description
+     * descrition of the space
+     * @maxLength 255
+     */
+    description: string;
+    /**
+     * Metadata
+     * metadata of the space resource
+     * @default {}
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Tenant Id
+     * tenant id
+     */
+    tenant_id: string;
+}
+/** Space */
+export interface ISpaceOutput {
+    /**
+     * Gmt Create
+     * creation time
+     */
+    gmt_create?: string | null;
+    /**
+     * Gmt Modified
+     * update time
+     */
+    gmt_modified?: string | null;
+    /**
+     * Space Name
+     * name of the space resource
+     * @maxLength 64
+     */
+    space_name: string;
+    /**
+     * Space Id
+     * space id
+     */
+    space_id?: string;
+    /**
+     * Description
+     * descrition of the space
+     * @maxLength 255
+     */
+    description: string;
+    /**
+     * Metadata
+     * metadata of the space resource
+     * @default {}
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Tenant Id
+     * tenant id
+     */
+    tenant_id: string;
+}
 /**
  * SpaceCreate
  * SpaceCreate model for creating space resources.
@@ -3294,6 +3621,13 @@ export interface ITaggingCreate {
      */
     object_id: string;
 }
+/** TagsUpdate */
+export interface ITagsUpdate {
+    /** Knowledge Id */
+    knowledge_id: string;
+    /** Tags */
+    tags: string[];
+}
 /** Task */
 export interface ITaskInput {
     /**
@@ -3542,6 +3876,22 @@ export interface ITenantLogQuery {
     /** End Time */
     end_time?: string | null;
 }
+/** TenantNameCheckRequest */
+export interface ITenantNameCheckRequest {
+    /**
+     * Tenant Name
+     * @minLength 1
+     * @maxLength 100
+     */
+    tenant_name: string;
+}
+/** TenantNameCheckResponse */
+export interface ITenantNameCheckResponse {
+    /** Available */
+    available: boolean;
+    /** Message */
+    message: string;
+}
 /** TenantUpdate */
 export interface ITenantUpdate {
     /** Tenant Name */
@@ -3620,9 +3970,8 @@ export interface ITextSourceConfig {
      * Text content, length range 1-30000 characters
      * @minLength 1
      * @maxLength 30000
-     * @default ""
      */
-    text?: string;
+    text: string;
 }
 /**
  * TextSplitConfig
@@ -3713,7 +4062,7 @@ export interface IYuqueCreate {
      * type of knowledge resource
      * @default "yuquedoc"
      */
-    knowledge_type?: "yuquedoc";
+    knowledge_type?: "yuquedoc" | "yuque_book";
     /**
      * Knowledge Name
      * name of the knowledge resource
@@ -3756,7 +4105,7 @@ export interface IYuqueCreate {
      * Source Config
      * source config of the knowledge
      */
-    source_config: IYuqueSourceConfig | IOpenUrlSourceConfig | IOpenIdSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig;
+    source_config: IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig;
     /**
      * Split Config
      * split config of the knowledge
@@ -3947,16 +4296,16 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     knowledge: {
         /**
-         * @description 添加知识 使用DDD架构创建新的知识，禁止重复的file_sha条目。 通过TaskCoordinationService统一协调知识创建和任务执行，确保事务一致性。
+         * @description 批量添加知识 支持批量创建知识条目，自动处理重复检测和增量更新： - 根据 space_id + knowledge_name + knowledge_type 判断知识唯一性 - 若知识不存在则新增；若存在但 file_sha 不同则删除旧版本后重新添加 - 若知识已存在且内容相同则跳过，返回空列表 创建成功后自动触发异步处理任务（如向量化入库）。 Args: body: 知识创建请求列表，支持多种来源类型（文件、URL、语雀等） Returns: 成功创建的知识列表，已存在且未变更的知识不会返回
          *
          * @tags knowledge
          * @name AddKnowledge
          * @summary Add Knowledge
          * @request POST:/api/knowledge/add
          */
-        addKnowledge: (data: (ITextCreate | IImageCreate | IJSONCreate | IMarkdownCreate | IPDFCreate | IGithubRepoCreate | IQACreate | IYuqueCreate)[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
+        addKnowledge: (data: (ITextCreate | IImageCreate | IJSONCreate | IMarkdownCreate | IPDFCreate | IGithubRepoCreate | IQACreate | IYuqueCreate | IHituNodePackageCreate)[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
         /**
-         * @description 更新知识 使用DDD架构更新知识信息，支持元数据和状态更新。
+         * @description 更新知识（全量更新） 更新知识的完整信息，支持以下字段变更： - 元数据(metadata)变更：同步更新对应 chunk 的 metadata - 启用状态(enabled)变更：同步更新对应 chunk 的启用状态 - 嵌入模型/分片配置/来源配置变更：自动触发重新入库任务 注意：knowledge_type、source_type 等核心字段不可变更。 Args: knowledge: 完整的知识对象，需包含 knowledge_id Returns: 更新后的知识对象（auth_info 字段已脱敏）
          *
          * @tags knowledge
          * @name UpdateKnowledge
@@ -3965,7 +4314,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateKnowledge: (data: IKnowledgeInput, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
         /**
-         * @description 更新知识启用状态 使用DDD架构更新知识的启用状态。
+         * @description 更新知识启用状态 单独更新知识的启用/禁用状态，同步更新向量数据库中对应 chunk 的启用状态。 禁用后的知识在召回时将被过滤。 Args: body.knowledge_id: 知识ID body.status: True 启用，False 禁用
          *
          * @tags knowledge
          * @name UpdateKnowledgeEnableStatus
@@ -3974,7 +4323,25 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateKnowledgeEnableStatus: (data: IEnableStatusUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * @description 获取知识列表 使用DDD架构的KnowledgeService进行分页查询，支持条件过滤和排序。
+         * @description 更新知识标签 更新知识的标签列表，同步更新向量数据库中对应 chunk 的 tags 字段。 标签可用于召回时的过滤条件。 Args: body.knowledge_id: 知识ID body.tags: 新的标签列表，将完全替换原有标签 Returns: 更新后的知识对象（auth_info 字段已脱敏）
+         *
+         * @tags knowledge
+         * @name UpdateKnowledgeTags
+         * @summary Update Knowledge Tags
+         * @request POST:/api/knowledge/update/tags
+         */
+        updateKnowledgeTags: (data: ITagsUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
+        /**
+         * @description 更新知识自定义过滤字段 更新知识的自定义过滤字段（f1-f5），同步更新向量数据库中对应 chunk 的字段。 这些字段可用于召回时的精确过滤条件。 Args: body.knowledge_id: 知识ID body.f1-f5: 自定义过滤字段，None 表示保持原值不变，至少需提供一个非空字段 Returns: 更新后的知识对象（auth_info 字段已脱敏）
+         *
+         * @tags knowledge
+         * @name UpdateKnowledgeFilterFields
+         * @summary Update Knowledge Filter Fields
+         * @request POST:/api/knowledge/update/filter_fields
+         */
+        updateKnowledgeFilterFields: (data: IFilterFieldsUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
+        /**
+         * @description 分页查询知识列表 支持灵活的查询条件： - eq_conditions: 等值查询条件，如 {"space_id": "xxx", "enabled": true} - advanced_filter: 高级过滤条件，支持 AND/OR 组合及多种比较操作符 - order_by/order_direction: 排序字段和方向 Args: body: 分页查询参数，包含 page、page_size 和过滤条件 Returns: 分页结果，包含 items、total、page、page_size、total_pages
          *
          * @tags knowledge
          * @name GetKnowledgeList
@@ -3983,7 +4350,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getKnowledgeList: (data: IPageQueryParamsKnowledge, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseKnowledge, void | IHTTPValidationError>>;
         /**
-         * @description 根据ID获取知识详情 使用DDD架构获取知识详细信息。
+         * @description 获取知识详情 根据知识ID获取完整的知识信息，包含元数据、配置等所有字段。 Args: knowledge_id: 知识ID Returns: 知识详情（auth_info 字段已脱敏） Raises: 404: 知识不存在
          *
          * @tags knowledge
          * @name GetKnowledgeById
@@ -3995,7 +4362,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             knowledge_id: string;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
         /**
-         * @description 删除知识 包括级联删除相关的任务和向量数据。
+         * @description 删除知识 级联删除知识及其关联数据： - 删除 MySQL 中的知识记录和相关任务 - 删除向量数据库中的所有 chunk 数据 - 清除所属 Space 的总结时间标记（下次总结时将进行全量总结） Args: knowledge_id: 要删除的知识ID Raises: 404: 知识不存在
          *
          * @tags knowledge
          * @name DeleteKnowledge
@@ -4007,7 +4374,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             knowledge_id: string;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取可用的嵌入模型列表 返回系统中所有已注册的嵌入模型及其元数据信息， 用于创建知识时选择合适的向量化模型。 Returns: 模型列表，每项包含 name（模型标识）和 metadata（模型元数据）
          *
          * @tags knowledge
          * @name GetEmbeddingModelsList
@@ -4016,7 +4383,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getEmbeddingModelsList: (params?: RequestParams) => Promise<HttpResponse<any, void | IHTTPValidationError>>;
         /**
-         * @description 根据wohu知识库ID(space_id)和素材ID列表(knowledge_name)批量查询知识 支持最多114个素材ID的批量查询 素材ID对应knowledge_name字段 Args: body.space_id: wohu知识库ID body.knowledge_names: 素材ID列表(knowledge_name) Returns: 符合条件的知识列表
+         * @description 根据名称批量查询知识 在指定 Space 下，根据知识名称列表批量查询知识详情。 适用于已知知识名称需要获取完整信息的场景。 Args: body.space_id: 空间ID body.knowledge_names: 知识名称列表 Returns: 符合条件的知识列表（auth_info 字段已脱敏）
          *
          * @tags knowledge
          * @name BatchQueryKnowledgeByNames
@@ -4025,7 +4392,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         batchQueryKnowledgeByNames: (data: IBatchQueryRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
         /**
-         * @description 根据知识ID获取知识原文内容 通过对应的Loader加载知识的原始内容。 不同类型的知识会返回不同类型的内容（文本、图片等）。 Args: knowledge_id: 知识ID Returns: 知识原文内容列表（可能包含Text、Image或Blob类型）
+         * @description 获取知识原文内容 加载知识的原始内容，根据知识来源类型采用不同策略： - GitHub 类型：从已入库的 chunk 中合并还原原文 - 其他类型：通过对应的 Loader 重新加载原始内容 Args: knowledge_id: 知识ID Returns: 原文内容列表，可能包含 Text（文本）、Image（图片）或 Blob（二进制）类型 Raises: 404: 知识不存在 400: 未注册对应类型的 Loader
          *
          * @tags knowledge
          * @name GetKnowledgeOriginalContent
@@ -4086,7 +4453,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     task: {
         /**
-         * @description 重启任务 使用DDD架构的TaskCoordinationService进行任务重启并执行。 重试规则： 1. FAILED 或 CANCELED 状态的任务可以重试 2. 创建时间超过30分钟且未成功的任务可以重试
+         * @description 重试任务 满足下面任意一条规则： 1. FAILED 或 CANCELED 状态的任务可以重试 2. 创建时间超过30分钟且未成功的任务可以重试
          *
          * @tags task
          * @name RestartTask
@@ -4095,7 +4462,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         restartTask: (data: ITaskRestartRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelListTask, void | IHTTPValidationError>>;
         /**
-         * @description 取消任务 使用DDD架构的TaskService进行任务取消。
+         * @description 将任务标记为取消
          *
          * @tags task
          * @name CancelTask
@@ -4104,7 +4471,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         cancelTask: (data: ITaskRestartRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelListTask, void | IHTTPValidationError>>;
         /**
-         * @description 获取任务列表 使用DDD架构的TaskService进行分页查询。
+         * @description 获取任务列表
          *
          * @tags task
          * @name GetTaskList
@@ -4113,7 +4480,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTaskList: (data: IPageQueryParamsTask, params?: RequestParams) => Promise<HttpResponse<IResponseModelStatusStatisticsPageResponseTask, void | IHTTPValidationError>>;
         /**
-         * @description 获取任务详情 使用DDD架构的TaskService获取任务详情。
+         * @description 获取任务详情
          *
          * @tags task
          * @name GetTaskDetail
@@ -4125,7 +4492,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             task_id: string;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelTask, void | IHTTPValidationError>>;
         /**
-         * @description 删除任务 使用DDD架构的TaskService进行任务删除。
+         * @description 删除任务，从数据库中移除任务记录
          *
          * @tags task
          * @name DeleteTaskById
@@ -4186,7 +4553,16 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     tenant: {
         /**
-         * @description 创建租户
+         * @description 检查租户名称是否可用 用于前端表单实时校验租户名称的唯一性。 此接口无需认证，但有基于 IP 的访问频率限制。 Args: params.tenant_name: 要检查的租户名称 Returns: available: True 表示名称可用，False 表示已被占用 message: 检查结果说明 Raises: 429: 请求过于频繁
+         *
+         * @tags tenant
+         * @name CheckTenantName
+         * @summary Check Tenant Name
+         * @request POST:/api/tenant/check-name
+         */
+        checkTenantName: (data: ITenantNameCheckRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenantNameCheckResponse, void | IHTTPValidationError>>;
+        /**
+         * @description 创建租户 创建新租户并自动生成认证密钥（secret_key）： - tenant_id 和 secret_key 由系统自动生成 - secret_key 仅在创建时返回一次，后续无法再次获取，请妥善保存 - 创建成功后会发送通知邮件到指定邮箱 Args: params.tenant_name: 租户名称，必须唯一 params.email: 联系邮箱，用于接收通知 params.metadata: 自定义元数据（可选） Returns: 创建的租户信息，包含 secret_key（仅此一次） Raises: 400: 租户名称已存在
          *
          * @tags tenant
          * @name CreateTenant
@@ -4195,7 +4571,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         createTenant: (data: ITenantCreate, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
         /**
-         * @description 根据ID查询租户
+         * @description 根据ID查询租户 获取指定租户的详细信息。需要当前租户具有 READ 或 UPDATE 权限。 Args: id: 租户ID Returns: 租户详细信息（secret_key 字段已脱敏） Raises: 404: 租户不存在
          *
          * @tags tenant
          * @name GetTenantById
@@ -4204,7 +4580,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTenantById: (id: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
         /**
-         * @description 删除租户
+         * @description 删除租户 永久删除指定租户。此操作不可逆。 注意：当前版本不会检查关联数据（空间、知识等），请确保租户下无重要数据。 Args: id: 要删除的租户ID Raises: 404: 租户不存在
          *
          * @tags tenant
          * @name DeleteTenantById
@@ -4213,7 +4589,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deleteTenantById: (id: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelObject, void | IHTTPValidationError>>;
         /**
-         * @description 更新租户
+         * @description 更新当前租户信息 部分更新当前认证租户的信息，仅提供的字段会被更新： - tenant_name: 更新名称时会检查是否与其他租户冲突 - email: 更新联系邮箱 - metadata: 更新自定义元数据（完全替换） Args: params: 更新参数，所有字段均为可选 Returns: 更新后的租户信息 Raises: 400: 租户名称已被占用
          *
          * @tags tenant
          * @name UpdateTenant
@@ -4222,7 +4598,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateTenant: (data: ITenantUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
         /**
-         * @description 获取租户列表
+         * @description 分页获取租户列表 获取系统中所有租户的分页列表。 Args: page: 页码，从 1 开始，默认 1 page_size: 每页数量，默认 10 Returns: 分页结果，包含 items、total、page、page_size、total_pages
          *
          * @tags tenant
          * @name GetTenantList
@@ -4242,7 +4618,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             page_size?: number;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseTenant, void | IHTTPValidationError>>;
         /**
-         * @description 获取当前租户信息 直接返回认证系统中的租户信息。 get_tenant_with_permissions 已经包含了完整的认证和权限检查。
+         * @description 获取当前租户信息 通过请求头中的认证信息（secret_key）获取当前租户的详细信息。 无需传入任何参数，系统自动从认证上下文中识别租户身份。 Returns: 当前认证租户的详细信息（secret_key 字段已脱敏）
          *
          * @tags tenant
          * @name GetTenant
@@ -4251,7 +4627,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTenant: (params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
         /**
-         * @description 绑定 Wohu 相关信息 在租户 metadata 中添加 _wohu_product_space_id 字段
+         * @description 绑定 Wohu 产品空间信息 将 Wohu 产品空间ID绑定到当前租户，存储在 metadata._wohu_product_space_id 字段。 用于关联 Wohu 平台的产品空间与本系统租户。 Args: params.wohu_product_space_id: Wohu 产品空间ID Returns: 更新后的租户信息 Raises: 404: 租户不存在
          *
          * @tags tenant
          * @name BindWohuInfo
@@ -4540,6 +4916,44 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         proxyYuqueGetDoc: (docId: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelAny, void | IHTTPValidationError>>;
     };
+    admin: {
+        /**
+         * @description 管理员批量重启任务 根据时间范围、状态、租户、空间等条件筛选并重启任务。 满足下面任意一条规则的任务可以重启： 1. FAILED 或 CANCELED 状态的任务可以重试 2. 创建时间超过30分钟且未成功的任务可以重试
+         *
+         * @tags admin
+         * @name AdminRestartTasks
+         * @summary Admin Restart Tasks
+         * @request POST:/api/admin/task/restart
+         */
+        adminRestartTasks: (data: IAdminTaskRestartRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelAdminTaskRestartResponse, void | IHTTPValidationError>>;
+        /**
+         * @description 管理员更新租户信息 支持更新 tenant_name、email、is_active、metadata。 所有字段均为可选，只传入需要更新的字段即可。
+         *
+         * @tags admin
+         * @name AdminUpdateTenant
+         * @summary Admin Update Tenant
+         * @request PUT:/api/admin/tenant/{tenant_id}
+         */
+        adminUpdateTenant: (tenantId: string, data: IAdminUpdateTenantRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
+        /**
+         * @description 管理员更新租户密钥 secret_key 必须符合 sk-xxxx 格式，且长度大于10个字符。 密钥将自动加密后存储。
+         *
+         * @tags admin
+         * @name AdminUpdateTenantSecretKey
+         * @summary Admin Update Tenant Secret Key
+         * @request PUT:/api/admin/tenant/{tenant_id}/secret-key
+         */
+        adminUpdateTenantSecretKey: (tenantId: string, data: IAdminUpdateTenantSecretKeyRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
+        /**
+         * @description 管理员更新空间信息 支持更新 space_name、description、metadata。 所有字段均为可选，只传入需要更新的字段即可。
+         *
+         * @tags admin
+         * @name AdminUpdateSpace
+         * @summary Admin Update Space
+         * @request PUT:/api/admin/tenant/{tenant_id}/space/{space_id}
+         */
+        adminUpdateSpace: (tenantId: string, spaceId: string, data: IAdminUpdateSpaceRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelSpace, void | IHTTPValidationError>>;
+    };
     healthChecker: {
         /**
          * No description

package/dist/api.js

@@ -145,6 +145,8 @@ var IKnowledgeTypeEnum;
     IKnowledgeTypeEnum["Haskell"] = "haskell";
     IKnowledgeTypeEnum["Elixir"] = "elixir";
     IKnowledgeTypeEnum["Powershell"] = "powershell";
+    IKnowledgeTypeEnum["NodePackage"] = "node_package";
+    IKnowledgeTypeEnum["NodePackageElement"] = "node_package_element";
 })(IKnowledgeTypeEnum || (exports.IKnowledgeTypeEnum = IKnowledgeTypeEnum = {}));
 /**
  * KnowledgeSourceEnum
@@ -160,6 +162,7 @@ var IKnowledgeSourceEnum;
     IKnowledgeSourceEnum["Yuque"] = "yuque";
     IKnowledgeSourceEnum["YuquePersonalDoc"] = "yuque_personal_doc";
     IKnowledgeSourceEnum["YuquePersonalNote"] = "yuque_personal_note";
+    IKnowledgeSourceEnum["HituNodePackage"] = "hitu_node_package";
 })(IKnowledgeSourceEnum || (exports.IKnowledgeSourceEnum = IKnowledgeSourceEnum = {}));
 /** Action */
 var IAction;
@@ -342,7 +345,7 @@ class Api extends HttpClient {
         };
         this.knowledge = {
             /**
-             * @description 添加知识 使用DDD架构创建新的知识，禁止重复的file_sha条目。 通过TaskCoordinationService统一协调知识创建和任务执行，确保事务一致性。
+             * @description 批量添加知识 支持批量创建知识条目，自动处理重复检测和增量更新： - 根据 space_id + knowledge_name + knowledge_type 判断知识唯一性 - 若知识不存在则新增；若存在但 file_sha 不同则删除旧版本后重新添加 - 若知识已存在且内容相同则跳过，返回空列表 创建成功后自动触发异步处理任务（如向量化入库）。 Args: body: 知识创建请求列表，支持多种来源类型（文件、URL、语雀等） Returns: 成功创建的知识列表，已存在且未变更的知识不会返回
              *
              * @tags knowledge
              * @name AddKnowledge
@@ -351,7 +354,7 @@ class Api extends HttpClient {
              */
             addKnowledge: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/add`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 更新知识 使用DDD架构更新知识信息，支持元数据和状态更新。
+             * @description 更新知识（全量更新） 更新知识的完整信息，支持以下字段变更： - 元数据(metadata)变更：同步更新对应 chunk 的 metadata - 启用状态(enabled)变更：同步更新对应 chunk 的启用状态 - 嵌入模型/分片配置/来源配置变更：自动触发重新入库任务 注意：knowledge_type、source_type 等核心字段不可变更。 Args: knowledge: 完整的知识对象，需包含 knowledge_id Returns: 更新后的知识对象（auth_info 字段已脱敏）
              *
              * @tags knowledge
              * @name UpdateKnowledge
@@ -360,7 +363,7 @@ class Api extends HttpClient {
              */
             updateKnowledge: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/update`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 更新知识启用状态 使用DDD架构更新知识的启用状态。
+             * @description 更新知识启用状态 单独更新知识的启用/禁用状态，同步更新向量数据库中对应 chunk 的启用状态。 禁用后的知识在召回时将被过滤。 Args: body.knowledge_id: 知识ID body.status: True 启用，False 禁用
              *
              * @tags knowledge
              * @name UpdateKnowledgeEnableStatus
@@ -369,7 +372,25 @@ class Api extends HttpClient {
              */
             updateKnowledgeEnableStatus: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/update/enabled`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 获取知识列表 使用DDD架构的KnowledgeService进行分页查询，支持条件过滤和排序。
+             * @description 更新知识标签 更新知识的标签列表，同步更新向量数据库中对应 chunk 的 tags 字段。 标签可用于召回时的过滤条件。 Args: body.knowledge_id: 知识ID body.tags: 新的标签列表，将完全替换原有标签 Returns: 更新后的知识对象（auth_info 字段已脱敏）
+             *
+             * @tags knowledge
+             * @name UpdateKnowledgeTags
+             * @summary Update Knowledge Tags
+             * @request POST:/api/knowledge/update/tags
+             */
+            updateKnowledgeTags: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/update/tags`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 更新知识自定义过滤字段 更新知识的自定义过滤字段（f1-f5），同步更新向量数据库中对应 chunk 的字段。 这些字段可用于召回时的精确过滤条件。 Args: body.knowledge_id: 知识ID body.f1-f5: 自定义过滤字段，None 表示保持原值不变，至少需提供一个非空字段 Returns: 更新后的知识对象（auth_info 字段已脱敏）
+             *
+             * @tags knowledge
+             * @name UpdateKnowledgeFilterFields
+             * @summary Update Knowledge Filter Fields
+             * @request POST:/api/knowledge/update/filter_fields
+             */
+            updateKnowledgeFilterFields: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/update/filter_fields`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 分页查询知识列表 支持灵活的查询条件： - eq_conditions: 等值查询条件，如 {"space_id": "xxx", "enabled": true} - advanced_filter: 高级过滤条件，支持 AND/OR 组合及多种比较操作符 - order_by/order_direction: 排序字段和方向 Args: body: 分页查询参数，包含 page、page_size 和过滤条件 Returns: 分页结果，包含 items、total、page、page_size、total_pages
              *
              * @tags knowledge
              * @name GetKnowledgeList
@@ -378,7 +399,7 @@ class Api extends HttpClient {
              */
             getKnowledgeList: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/list`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 根据ID获取知识详情 使用DDD架构获取知识详细信息。
+             * @description 获取知识详情 根据知识ID获取完整的知识信息，包含元数据、配置等所有字段。 Args: knowledge_id: 知识ID Returns: 知识详情（auth_info 字段已脱敏） Raises: 404: 知识不存在
              *
              * @tags knowledge
              * @name GetKnowledgeById
@@ -387,7 +408,7 @@ class Api extends HttpClient {
              */
             getKnowledgeById: (query, params = {}) => this.request(Object.assign({ path: `/api/knowledge/detail`, method: "GET", query: query, format: "json" }, params)),
             /**
-             * @description 删除知识 包括级联删除相关的任务和向量数据。
+             * @description 删除知识 级联删除知识及其关联数据： - 删除 MySQL 中的知识记录和相关任务 - 删除向量数据库中的所有 chunk 数据 - 清除所属 Space 的总结时间标记（下次总结时将进行全量总结） Args: knowledge_id: 要删除的知识ID Raises: 404: 知识不存在
              *
              * @tags knowledge
              * @name DeleteKnowledge
@@ -396,7 +417,7 @@ class Api extends HttpClient {
              */
             deleteKnowledge: (query, params = {}) => this.request(Object.assign({ path: `/api/knowledge/delete`, method: "DELETE", query: query, format: "json" }, params)),
             /**
-             * No description
+             * @description 获取可用的嵌入模型列表 返回系统中所有已注册的嵌入模型及其元数据信息， 用于创建知识时选择合适的向量化模型。 Returns: 模型列表，每项包含 name（模型标识）和 metadata（模型元数据）
              *
              * @tags knowledge
              * @name GetEmbeddingModelsList
@@ -405,7 +426,7 @@ class Api extends HttpClient {
              */
             getEmbeddingModelsList: (params = {}) => this.request(Object.assign({ path: `/api/knowledge/embedding/models`, method: "GET", format: "json" }, params)),
             /**
-             * @description 根据wohu知识库ID(space_id)和素材ID列表(knowledge_name)批量查询知识 支持最多114个素材ID的批量查询 素材ID对应knowledge_name字段 Args: body.space_id: wohu知识库ID body.knowledge_names: 素材ID列表(knowledge_name) Returns: 符合条件的知识列表
+             * @description 根据名称批量查询知识 在指定 Space 下，根据知识名称列表批量查询知识详情。 适用于已知知识名称需要获取完整信息的场景。 Args: body.space_id: 空间ID body.knowledge_names: 知识名称列表 Returns: 符合条件的知识列表（auth_info 字段已脱敏）
              *
              * @tags knowledge
              * @name BatchQueryKnowledgeByNames
@@ -414,7 +435,7 @@ class Api extends HttpClient {
              */
             batchQueryKnowledgeByNames: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/batch_query_by_names`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 根据知识ID获取知识原文内容 通过对应的Loader加载知识的原始内容。 不同类型的知识会返回不同类型的内容（文本、图片等）。 Args: knowledge_id: 知识ID Returns: 知识原文内容列表（可能包含Text、Image或Blob类型）
+             * @description 获取知识原文内容 加载知识的原始内容，根据知识来源类型采用不同策略： - GitHub 类型：从已入库的 chunk 中合并还原原文 - 其他类型：通过对应的 Loader 重新加载原始内容 Args: knowledge_id: 知识ID Returns: 原文内容列表，可能包含 Text（文本）、Image（图片）或 Blob（二进制）类型 Raises: 404: 知识不存在 400: 未注册对应类型的 Loader
              *
              * @tags knowledge
              * @name GetKnowledgeOriginalContent
@@ -472,7 +493,7 @@ class Api extends HttpClient {
         };
         this.task = {
             /**
-             * @description 重启任务 使用DDD架构的TaskCoordinationService进行任务重启并执行。 重试规则： 1. FAILED 或 CANCELED 状态的任务可以重试 2. 创建时间超过30分钟且未成功的任务可以重试
+             * @description 重试任务 满足下面任意一条规则： 1. FAILED 或 CANCELED 状态的任务可以重试 2. 创建时间超过30分钟且未成功的任务可以重试
              *
              * @tags task
              * @name RestartTask
@@ -481,7 +502,7 @@ class Api extends HttpClient {
              */
             restartTask: (data, params = {}) => this.request(Object.assign({ path: `/api/task/restart`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 取消任务 使用DDD架构的TaskService进行任务取消。
+             * @description 将任务标记为取消
              *
              * @tags task
              * @name CancelTask
@@ -490,7 +511,7 @@ class Api extends HttpClient {
              */
             cancelTask: (data, params = {}) => this.request(Object.assign({ path: `/api/task/cancel`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 获取任务列表 使用DDD架构的TaskService进行分页查询。
+             * @description 获取任务列表
              *
              * @tags task
              * @name GetTaskList
@@ -499,7 +520,7 @@ class Api extends HttpClient {
              */
             getTaskList: (data, params = {}) => this.request(Object.assign({ path: `/api/task/list`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 获取任务详情 使用DDD架构的TaskService获取任务详情。
+             * @description 获取任务详情
              *
              * @tags task
              * @name GetTaskDetail
@@ -508,7 +529,7 @@ class Api extends HttpClient {
              */
             getTaskDetail: (query, params = {}) => this.request(Object.assign({ path: `/api/task/detail`, method: "GET", query: query, format: "json" }, params)),
             /**
-             * @description 删除任务 使用DDD架构的TaskService进行任务删除。
+             * @description 删除任务，从数据库中移除任务记录
              *
              * @tags task
              * @name DeleteTaskById
@@ -566,7 +587,16 @@ class Api extends HttpClient {
         };
         this.tenant = {
             /**
-             * @description 创建租户
+             * @description 检查租户名称是否可用 用于前端表单实时校验租户名称的唯一性。 此接口无需认证，但有基于 IP 的访问频率限制。 Args: params.tenant_name: 要检查的租户名称 Returns: available: True 表示名称可用，False 表示已被占用 message: 检查结果说明 Raises: 429: 请求过于频繁
+             *
+             * @tags tenant
+             * @name CheckTenantName
+             * @summary Check Tenant Name
+             * @request POST:/api/tenant/check-name
+             */
+            checkTenantName: (data, params = {}) => this.request(Object.assign({ path: `/api/tenant/check-name`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 创建租户 创建新租户并自动生成认证密钥（secret_key）： - tenant_id 和 secret_key 由系统自动生成 - secret_key 仅在创建时返回一次，后续无法再次获取，请妥善保存 - 创建成功后会发送通知邮件到指定邮箱 Args: params.tenant_name: 租户名称，必须唯一 params.email: 联系邮箱，用于接收通知 params.metadata: 自定义元数据（可选） Returns: 创建的租户信息，包含 secret_key（仅此一次） Raises: 400: 租户名称已存在
              *
              * @tags tenant
              * @name CreateTenant
@@ -575,7 +605,7 @@ class Api extends HttpClient {
              */
             createTenant: (data, params = {}) => this.request(Object.assign({ path: `/api/tenant/create`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 根据ID查询租户
+             * @description 根据ID查询租户 获取指定租户的详细信息。需要当前租户具有 READ 或 UPDATE 权限。 Args: id: 租户ID Returns: 租户详细信息（secret_key 字段已脱敏） Raises: 404: 租户不存在
              *
              * @tags tenant
              * @name GetTenantById
@@ -584,7 +614,7 @@ class Api extends HttpClient {
              */
             getTenantById: (id, params = {}) => this.request(Object.assign({ path: `/api/tenant/id/${id}`, method: "GET", format: "json" }, params)),
             /**
-             * @description 删除租户
+             * @description 删除租户 永久删除指定租户。此操作不可逆。 注意：当前版本不会检查关联数据（空间、知识等），请确保租户下无重要数据。 Args: id: 要删除的租户ID Raises: 404: 租户不存在
              *
              * @tags tenant
              * @name DeleteTenantById
@@ -593,7 +623,7 @@ class Api extends HttpClient {
              */
             deleteTenantById: (id, params = {}) => this.request(Object.assign({ path: `/api/tenant/${id}`, method: "DELETE", format: "json" }, params)),
             /**
-             * @description 更新租户
+             * @description 更新当前租户信息 部分更新当前认证租户的信息，仅提供的字段会被更新： - tenant_name: 更新名称时会检查是否与其他租户冲突 - email: 更新联系邮箱 - metadata: 更新自定义元数据（完全替换） Args: params: 更新参数，所有字段均为可选 Returns: 更新后的租户信息 Raises: 400: 租户名称已被占用
              *
              * @tags tenant
              * @name UpdateTenant
@@ -602,7 +632,7 @@ class Api extends HttpClient {
              */
             updateTenant: (data, params = {}) => this.request(Object.assign({ path: `/api/tenant/update`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 获取租户列表
+             * @description 分页获取租户列表 获取系统中所有租户的分页列表。 Args: page: 页码，从 1 开始，默认 1 page_size: 每页数量，默认 10 Returns: 分页结果，包含 items、total、page、page_size、total_pages
              *
              * @tags tenant
              * @name GetTenantList
@@ -611,7 +641,7 @@ class Api extends HttpClient {
              */
             getTenantList: (query, params = {}) => this.request(Object.assign({ path: `/api/tenant/list`, method: "GET", query: query, format: "json" }, params)),
             /**
-             * @description 获取当前租户信息 直接返回认证系统中的租户信息。 get_tenant_with_permissions 已经包含了完整的认证和权限检查。
+             * @description 获取当前租户信息 通过请求头中的认证信息（secret_key）获取当前租户的详细信息。 无需传入任何参数，系统自动从认证上下文中识别租户身份。 Returns: 当前认证租户的详细信息（secret_key 字段已脱敏）
              *
              * @tags tenant
              * @name GetTenant
@@ -620,7 +650,7 @@ class Api extends HttpClient {
              */
             getTenant: (params = {}) => this.request(Object.assign({ path: `/api/tenant/me`, method: "GET", format: "json" }, params)),
             /**
-             * @description 绑定 Wohu 相关信息 在租户 metadata 中添加 _wohu_product_space_id 字段
+             * @description 绑定 Wohu 产品空间信息 将 Wohu 产品空间ID绑定到当前租户，存储在 metadata._wohu_product_space_id 字段。 用于关联 Wohu 平台的产品空间与本系统租户。 Args: params.wohu_product_space_id: Wohu 产品空间ID Returns: 更新后的租户信息 Raises: 404: 租户不存在
              *
              * @tags tenant
              * @name BindWohuInfo
@@ -909,6 +939,44 @@ class Api extends HttpClient {
              */
             proxyYuqueGetDoc: (docId, params = {}) => this.request(Object.assign({ path: `/api/yuque/repos/docs/${docId}`, method: "GET", format: "json" }, params)),
         };
+        this.admin = {
+            /**
+             * @description 管理员批量重启任务 根据时间范围、状态、租户、空间等条件筛选并重启任务。 满足下面任意一条规则的任务可以重启： 1. FAILED 或 CANCELED 状态的任务可以重试 2. 创建时间超过30分钟且未成功的任务可以重试
+             *
+             * @tags admin
+             * @name AdminRestartTasks
+             * @summary Admin Restart Tasks
+             * @request POST:/api/admin/task/restart
+             */
+            adminRestartTasks: (data, params = {}) => this.request(Object.assign({ path: `/api/admin/task/restart`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 管理员更新租户信息 支持更新 tenant_name、email、is_active、metadata。 所有字段均为可选，只传入需要更新的字段即可。
+             *
+             * @tags admin
+             * @name AdminUpdateTenant
+             * @summary Admin Update Tenant
+             * @request PUT:/api/admin/tenant/{tenant_id}
+             */
+            adminUpdateTenant: (tenantId, data, params = {}) => this.request(Object.assign({ path: `/api/admin/tenant/${tenantId}`, method: "PUT", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 管理员更新租户密钥 secret_key 必须符合 sk-xxxx 格式，且长度大于10个字符。 密钥将自动加密后存储。
+             *
+             * @tags admin
+             * @name AdminUpdateTenantSecretKey
+             * @summary Admin Update Tenant Secret Key
+             * @request PUT:/api/admin/tenant/{tenant_id}/secret-key
+             */
+            adminUpdateTenantSecretKey: (tenantId, data, params = {}) => this.request(Object.assign({ path: `/api/admin/tenant/${tenantId}/secret-key`, method: "PUT", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 管理员更新空间信息 支持更新 space_name、description、metadata。 所有字段均为可选，只传入需要更新的字段即可。
+             *
+             * @tags admin
+             * @name AdminUpdateSpace
+             * @summary Admin Update Space
+             * @request PUT:/api/admin/tenant/{tenant_id}/space/{space_id}
+             */
+            adminUpdateSpace: (tenantId, spaceId, data, params = {}) => this.request(Object.assign({ path: `/api/admin/tenant/${tenantId}/space/${spaceId}`, method: "PUT", body: data, type: ContentType.Json, format: "json" }, params)),
+        };
         this.healthChecker = {
             /**
              * No description

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@petercatai/whisker-client",
-    "version": "0.1.202512041544",
-    "description": "Generated API client (Production)",
+    "version": "0.1.202512291542-dev",
+    "description": "Generated API client (Productuon)",
     "main": "dist/api.js",
     "types": "dist/api.d.ts",
     "files": [
@@ -13,10 +13,10 @@
     },
     "publishConfig": {
         "access": "public",
-        "tag": "latest"
+        "tag": "dev"
     },
     "devDependencies": {
-        "@types/node": "^24.10.1",
+        "@types/node": "^25.0.3",
         "axios": "^1.13.2",
         "typescript": "^5.9.3"
     }