@petercatai/whisker-client 0.1.202512041323 → 0.1.202512231541

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 {
@@ -828,6 +831,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 +1048,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 +1310,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 +1320,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 +1396,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 +1406,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 +1545,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 {
     /**
@@ -2437,6 +2535,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 */
@@ -3294,6 +3400,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 +3655,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 */
@@ -3713,7 +3842,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 +3885,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 +4076,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 +4094,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 +4103,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 +4130,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 +4142,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 +4154,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 +4163,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 +4172,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
@@ -4039,7 +4186,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     retrieval: {
         /**
-         * @description 获取所有召回配置的 JSON Schema，用于前端动态渲染表单。 返回格式： { "deep_retrieval": { ... schema ... }, "region_retrieval": { ... schema ... }, ... }
+         * @description 获取所有召回配置的 JSON Schema，用于前端动态渲染表单。 返回格式： { "deep_retrieval": { ... schema ... }, "region_retrieval": { ... schema ... }, "web_search": { ... schema ... }, ... }
          *
          * @tags retrieval
          * @name GetRetrievalConfigSchemas
@@ -4186,7 +4333,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 +4351,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 +4360,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 +4369,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 +4378,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 +4398,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 +4407,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

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
@@ -425,7 +446,7 @@ class Api extends HttpClient {
         };
         this.retrieval = {
             /**
-             * @description 获取所有召回配置的 JSON Schema，用于前端动态渲染表单。 返回格式： { "deep_retrieval": { ... schema ... }, "region_retrieval": { ... schema ... }, ... }
+             * @description 获取所有召回配置的 JSON Schema，用于前端动态渲染表单。 返回格式： { "deep_retrieval": { ... schema ... }, "region_retrieval": { ... schema ... }, "web_search": { ... schema ... }, ... }
              *
              * @tags retrieval
              * @name GetRetrievalConfigSchemas
@@ -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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@petercatai/whisker-client",
-    "version": "0.1.202512041323",
+    "version": "0.1.202512231541",
     "description": "Generated API client (Production)",
     "main": "dist/api.js",
     "types": "dist/api.d.ts",
@@ -16,7 +16,7 @@
         "tag": "latest"
     },
     "devDependencies": {
-        "@types/node": "^24.10.1",
+        "@types/node": "^25.0.3",
         "axios": "^1.13.2",
         "typescript": "^5.9.3"
     }