/** * @description 应用程序的统一错误定义 * 每个定义都包含 code (错误码)、message (错误信息) 和给用户的 suggestion (建议) * 这种结构使错误处理更具声明性且保持一致 */ export declare const ErrorDefinitions: { readonly LLM: { readonly BAD_REQUEST: { readonly code: "LLM.BAD_REQUEST"; readonly message: "LLM API 请求因格式错误而失败"; readonly suggestion: "请检查您的请求参数，确保它们符合 API 的要求并已正确格式化"; }; readonly INVALID_API_KEY: { readonly code: "LLM.INVALID_API_KEY"; readonly message: "提供了无效的 LLM API 密钥"; readonly suggestion: "请仔细检查您的 API 密钥，确保其在插件配置中已正确设置。如果您使用的是云服务，请确保您有权访问指定的模型"; }; readonly RATE_LIMIT_EXCEEDED: { readonly code: "LLM.RATE_LIMIT_EXCEEDED"; readonly message: "LLM API 的请求频率超限"; readonly suggestion: "请稍等片刻再发起请求。如果您使用的是云服务，请考虑升级您的套餐或将请求分散在更长的时间段内"; }; readonly PROVIDER_ERROR: { readonly code: "LLM.PROVIDER_ERROR"; readonly message: "LLM 服务提供商内部发生错误"; readonly suggestion: "请检查服务商的文档以确保其设置正确。如果问题仍然存在，请考虑报告此问题"; }; readonly REQUEST_FAILED: { readonly code: "LLM.REQUEST_FAILED"; readonly message: (details: string) => string; readonly suggestion: "请检查您的网络、API 密钥以及模型提供商的状态页面。这可能是由于频率限制、密钥无效或暂时的服务中断所致"; }; readonly OUTPUT_PARSING_FAILED: { readonly code: "LLM.OUTPUT_PARSING_FAILED"; readonly message: "解析 LLM 响应失败，输出不是有效的 JSON 格式"; readonly suggestion: "这通常是暂时的模型问题，请重试。如果问题持续存在，可能是模型不稳定或系统提示词需要调整以确保生成有效的 JSON"; }; readonly OUTPUT_EMPTY_CONTENT: { readonly code: "LLM.OUTPUT_EMPTY_CONTENT"; readonly message: "LLM 响应为空"; readonly suggestion: "这可能是上游API故障导致，建议联系API提供商检查服务状态"; }; readonly TIMEOUT: { readonly code: "LLM.TIMEOUT"; readonly message: (duration: number) => string; readonly suggestion: "模型响应时间过长。这可能是模型服务提供商的临时问题。如果此问题频繁发生，您可以尝试在模型设置中调高‘总超时’时间"; }; }; readonly CONFIG: { readonly MISSING: { readonly code: "CONFIG.MISSING"; readonly message: (service: string, component: string) => string; readonly suggestion: (component: string) => string; }; readonly MISSING_MODEL_GROUP: { readonly code: "CONFIG.MISSING_MODEL_GROUP"; readonly message: "未给 '聊天 (Chat)' 任务类型配置任何模型组"; readonly suggestion: "代理需要一个聊天模型才能运作。请前往“模型服务”设置，并为 '聊天' 任务类型至少配置一个模型"; }; readonly INVALID: { readonly code: "CONFIG.INVALID"; readonly message: (details: string) => string; readonly suggestion: "请检查插件配置并更正指定的字段。有关有效值，请参阅文档"; }; readonly PROVIDER_INIT_FAILED: { readonly code: "CONFIG.PROVIDER_INIT_FAILED"; readonly message: (providerId: string) => string; readonly suggestion: "请确保提供商的配置（如 API 密钥和基础 URL）正确无误，并检查日志中是否有相关的错误信息"; }; }; readonly TASK: { readonly EXECUTION_FAILED: { readonly code: "TASK.EXECUTION_FAILED"; readonly message: "执行计划任务时发生错误"; readonly suggestion: "这表明代理的处理周期内存在内部错误。请检查详细日志以获取更多信息"; }; }; readonly WILLINGNESS: { readonly CALCULATION_FAILED: { readonly code: "WILLINGNESS.CALCULATION_FAILED"; readonly message: "意愿计算失败"; readonly suggestion: "在决定是否回复时发生内部错误。请检查日志以获取更多详情"; }; }; readonly SYSTEM: { readonly UNKNOWN: { readonly code: "SYSTEM.UNKNOWN"; readonly message: "发生未知错误"; readonly suggestion: "捕获到意外错误。请检查日志并考虑报告此问题"; }; }; readonly MODEL: { readonly UNAVAILABLE: { readonly code: "MODEL.UNAVAILABLE"; readonly message: (modelId: string) => string; readonly suggestion: "请验证模型 ID 是否正确，以及对应的提供商是否已启用并正确配置"; }; readonly GROUP_INIT_FAILED: { readonly code: "MODEL.GROUP_INIT_FAILED"; readonly message: (groupName: string) => string; readonly suggestion: "请检查模型组的配置。确保所列模型存在、其提供商已启用，并且它们具备所需的能力（例如 '聊天'）"; }; readonly ALL_FAILED_IN_GROUP: { readonly code: "MODEL.ALL_FAILED_IN_GROUP"; readonly message: (groupName: string) => string; readonly suggestion: "这表明存在普遍性问题。请检查错误报告中的 'cause' 以了解单个模型的失败原因。这可能是网络问题或影响组内所有模型的问题"; }; readonly RETRY_EXHAUSTED: { readonly code: "MODEL.RETRY_EXHAUSTED"; readonly message: (modelId: string) => string; readonly suggestion: "该模型反复失败。请检查错误日志以找出根本原因（例如，网络问题、持续的 API 错误）"; }; readonly NO_SUITABLE_MODEL: { readonly code: "MODEL.NO_SUITABLE_MODEL"; readonly message: (groupName: string) => string; readonly suggestion: "请检查模型组的配置。确保所列模型存在、其提供商已启用，并且它们具备所需的能力（例如 '聊天'）"; }; }; readonly NETWORK: { readonly REQUEST_FAILED: { readonly code: "NETWORK.REQUEST_FAILED"; readonly message: "网络请求失败"; readonly suggestion: "请检查您服务器的互联网连接和 DNS 设置。如果您正在使用代理，请确保其配置正确且正在运行"; }; }; readonly MEMORY: { readonly PROVIDER_ERROR: { readonly code: "MEMORY.PROVIDER_ERROR"; readonly message: "记忆提供商发生错误"; readonly suggestion: "请检查记忆提供商的配置并确保其设置正确。如果问题仍然存在，请考虑报告此问题"; }; readonly SEARCH_FAILED: { readonly code: "MEMORY.SEARCH_FAILED"; readonly message: "搜索记忆失败"; readonly suggestion: "这可能是由于内部错误。请检查日志以获取更多详情。如果问题仍然存在，请考虑报告此问题"; }; readonly EMBEDDING_FAILED: { readonly code: "MEMORY.EMBEDDING_FAILED"; readonly message: "为记忆生成嵌入向量失败"; readonly suggestion: "这可能是由于内部错误。请检查日志以获取更多详情。如果问题仍然存在，请考虑报告此问题"; }; }; }; /** * 应用程序的统一错误码。 * 使用常量对象而非枚举，以获得更好的灵活性和 Tree-shaking 效果。 * 格式: 领域.类别或详情 */ export declare const ErrorCodes: { readonly SERVICE: { readonly UNAVAILABLE: "SERVICE.UNAVAILABLE"; readonly INITIALIZATION_FAILURE: "SERVICE.INITIALIZATION_FAILURE"; readonly START_FAILURE: "SERVICE.START_FAILURE"; readonly STOP_FAILURE: "SERVICE.STOP_FAILURE"; }; readonly SYSTEM: { readonly UNKNOWN: "SYSTEM.UNKNOWN"; readonly DATABASE_ERROR: "SYSTEM.DATABASE_ERROR"; readonly NETWORK_ERROR: "SYSTEM.NETWORK_ERROR"; readonly SERVICE_UNAVAILABLE: "SYSTEM.SERVICE_UNAVAILABLE"; }; readonly CONFIG: { readonly MISSING: "CONFIG.MISSING"; readonly INVALID: "CONFIG.INVALID"; }; readonly VALIDATION: { readonly INVALID_INPUT: "VALIDATION.INVALID_INPUT"; readonly IS_NULL_OR_UNDEFINED: "VALIDATION.IS_NULL_OR_UNDEFINED"; }; readonly RESOURCE: { readonly NOT_FOUND: "RESOURCE.NOT_FOUND"; readonly CONFLICT: "RESOURCE.CONFLICT"; readonly EXHAUSTED: "RESOURCE.EXHAUSTED"; readonly STORAGE_FAILURE: "RESOURCE.STORAGE_FAILURE"; readonly LIMIT_EXCEEDED: "RESOURCE.LIMIT_EXCEEDED"; }; readonly AUTH: { readonly PERMISSION_DENIED: "AUTH.PERMISSION_DENIED"; readonly AUTHENTICATION_FAILED: "AUTH.AUTHENTICATION_FAILED"; }; readonly LLM: { readonly REQUEST_FAILED: "LLM.REQUEST_FAILED"; readonly TIMEOUT: "LLM.TIMEOUT"; readonly ADAPTER_ERROR: "LLM.ADAPTER_ERROR"; readonly RETRY_EXHAUSTED: "LLM.RETRY_EXHAUSTED"; readonly OUTPUT_PARSING_FAILED: "LLM.OUTPUT_PARSING_FAILED"; readonly MODEL_NOT_FOUND: "LLM.MODEL_NOT_FOUND"; }; readonly NETWORK: { readonly DOWNLOAD_FAILED: "NETWORK.DOWNLOAD_FAILED"; }; readonly MEMORY: { readonly PROVIDER_ERROR: "MEMORY.PROVIDER_ERROR"; }; readonly TOOL: { readonly NOT_FOUND: "TOOL.NOT_FOUND"; readonly EXECUTION_ERROR: "TOOL.EXECUTION_ERROR"; readonly TIMEOUT: "TOOL.TIMEOUT"; }; readonly OPERATION: { readonly LOCK_TIMEOUT: "OPERATION.LOCK_TIMEOUT"; readonly CIRCUIT_BREAKER_OPEN: "OPERATION.CIRCUIT_BREAKER_OPEN"; readonly SERVICE_SHUTTING_DOWN: "OPERATION.SERVICE_SHUTTING_DOWN"; readonly RETRY_EXHAUSTED: "OPERATION.RETRY_EXHAUSTED"; }; };