返回词卡客户端浏览器下载 PDF

SUWENLIN / TROUBLESHOOTING

素问邻排障手册

依据当前客户端和服务器源码整理。可能原因是排查假设，不代表已确认的本次根因；确认原因须结合任务状态、故障代码和服务商记录。

版本 14fa27857f64 · 354 个故障代号 · 15 个分类 · 所有搜索均在本页进行

开始排查前
  1. 记录故障代号、任务编号、北京时间、失败阶段与客户端类型；不要提供密码、API Key、授权 Token、含凭证的链接或聊天原文。
  2. 先核对原任务、原作品、原邮件的现有状态。HTTP 成功响应、平台发布确认和发件服务受理是不同的结果。
  3. 明确被拒绝的模型请求会释放对应本站预留额度；已成功的其他图片按真实结果结算。服务商套餐与本站额度分别核对。
  4. 超时、断线、HTTP 5xx 或返回格式异常可能已有服务端执行结果。结果待核实时只读取状态，请管理员核对计费、平台或邮件记录，不重复提交。
  5. 责任分为管理员、服务商、操作人。以客户端显示的通知状态和管理台投递记录为准；发件服务已接收不代表邮件已送达或故障已修复。服务商联系人：rey.mao@planto-ai.com。
  6. 方案执行后按“验证恢复”核查；只有明确允许重试时，才手动创建新任务。未保存编辑先备份，勿把清缓存或重装当作通用修复。

SWL-API-001模型调用权限不足管理员
故障代号
SWL-API-001
技术键
AccessDenied
故障含义
本版把 AccessDenied 映射到 provider_permission_denied。当前API账号没有调用所选接口或模型的权限。
可能原因
  1. 可能：当前API账号未获得所选模型权限。
  2. 可能：模型尚未在该账号开通。
  3. 可能：配置的接口与该账号允许的服务不一致。
先做检查
  1. 核对原任务所用模型、通道与接口协议
  2. 管理员核对模型开通及账号调用权限
解决方案
  1. 管理员开通正确模型或改为账号已获授权的配置
  2. 不通过切换陌生地址绕过权限拒绝
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:25

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-002模型API账号验证失败管理员
故障代号
SWL-API-002
技术键
AuthenticationError
故障含义
本版把 AuthenticationError 映射到 provider_auth_failed。模型服务没有接受当前API账号的身份验证。
可能原因
  1. 可能：对应通道的Key填写错误、已撤销或已失效。
  2. 可能：Key与所选服务商接口或账号不匹配。
  3. 可能：认证协议与通道配置不匹配。
先做检查
  1. 核对失败子任务对应通道，不只看默认模型设置
  2. 管理员在受控设置中核对Key状态、接口协议及账号，不展示完整Key
解决方案
  1. 管理员更新正确通道的有效Key与协议
  2. 保留原失败任务和原费用记录，确认配置后再允许新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:25；server/enterprise-models.cjs:41；server/enterprise-models.cjs:31

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-003内容未通过模型安全检查操作人
故障代号
SWL-API-003
技术键
ContentRejected
故障含义
本版把 ContentRejected 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:27；server/enterprise-models.cjs:28；server/enterprise-models.cjs:38

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-004内容未通过模型安全检查操作人
故障代号
SWL-API-004
技术键
InputImageSensitiveContentDetected
故障含义
本版把 InputImageSensitiveContentDetected 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:28

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-005内容未通过模型安全检查操作人
故障代号
SWL-API-005
技术键
InputTextSensitiveContentDetected
故障含义
本版把 InputTextSensitiveContentDetected 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:27

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-006模型API账号验证失败管理员
故障代号
SWL-API-006
技术键
InvalidAPIKey
故障含义
本版把 InvalidAPIKey 映射到 provider_auth_failed。模型服务没有接受当前API账号的身份验证。
可能原因
  1. 可能：对应通道的Key填写错误、已撤销或已失效。
  2. 可能：Key与所选服务商接口或账号不匹配。
  3. 可能：认证协议与通道配置不匹配。
先做检查
  1. 核对失败子任务对应通道，不只看默认模型设置
  2. 管理员在受控设置中核对Key状态、接口协议及账号，不展示完整Key
解决方案
  1. 管理员更新正确通道的有效Key与协议
  2. 保留原失败任务和原费用记录，确认配置后再允许新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:25

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-007模型API账号验证失败管理员
故障代号
SWL-API-007
技术键
InvalidApiKey
故障含义
本版把 InvalidApiKey 映射到 provider_auth_failed。模型服务没有接受当前API账号的身份验证。
可能原因
  1. 可能：对应通道的Key填写错误、已撤销或已失效。
  2. 可能：Key与所选服务商接口或账号不匹配。
  3. 可能：认证协议与通道配置不匹配。
先做检查
  1. 核对失败子任务对应通道，不只看默认模型设置
  2. 管理员在受控设置中核对Key状态、接口协议及账号，不展示完整Key
解决方案
  1. 管理员更新正确通道的有效Key与协议
  2. 保留原失败任务和原费用记录，确认配置后再允许新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:25

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-008模型请求参数不受支持管理员
故障代号
SWL-API-008
技术键
InvalidParameter
故障含义
本版把 InvalidParameter 映射到 provider_invalid_request。模型服务明确拒绝了本次请求参数。
可能原因
  1. 可能：请求包含当前模型不支持的参数。
  2. 可能：接口协议与请求结构不匹配。
  3. 可能：参数范围或输出模式不被当前模型接受。
先做检查
  1. 核对原任务的安全参数结构，不拷贝提示词或凭证
  2. 对照本版normalizeRequest与当前模型协议检查参数
解决方案
  1. 管理员移除不支持参数或修正协议适配
  2. 优先修复请求构造，避免反复发送相同无效请求
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:27；server/enterprise-models.cjs:29；server/enterprise-models.cjs:37

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-009服务商订阅不可用管理员
故障代号
SWL-API-009
技术键
InvalidSubscription
故障含义
本版把 InvalidSubscription 映射到 provider_subscription_invalid。当前API账号的服务商套餐无效、已到期或不满足当前接口要求；本站额度不能替代服务商套餐。
可能原因
  1. 可能：服务商套餐已到期或未生效。
  2. 可能：当前账号的套餐不支持使用的套餐接口。
先做检查
  1. 核对该API账号的订阅有效期与实际接口要求
  2. 区分本站月额度与服务商套餐
解决方案
  1. 管理员在服务商处恢复适用订阅，或配置拥有有效订阅的账号
  2. 不要通过增加本站额度解决服务商订阅问题
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:41；server/enterprise-models.cjs:30

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-010模型配置不可用管理员
故障代号
SWL-API-010
技术键
ModelNotEnabled
故障含义
本版把 ModelNotEnabled 映射到 provider_model_unavailable。模型服务报告所选模型不存在、尚未开通或不受当前接口支持。
可能原因
  1. 可能：模型名称拼写或版本不正确。
  2. 可能：该账号尚未开通所选模型。
  3. 可能：当前接口不支持该模型。
先做检查
  1. 核对保存任务中的模型标识及当前设置
  2. 区分模型404与服务地址路径错误
解决方案
  1. 管理员修正模型名称并选择匹配协议/接口
  2. 已保存任务不自动混用其他模型，是否新创作另行确认
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26；server/enterprise-models.cjs:35

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-011模型配置不可用管理员
故障代号
SWL-API-011
技术键
ModelNotFound
故障含义
本版把 ModelNotFound 映射到 provider_model_unavailable。模型服务报告所选模型不存在、尚未开通或不受当前接口支持。
可能原因
  1. 可能：模型名称拼写或版本不正确。
  2. 可能：该账号尚未开通所选模型。
  3. 可能：当前接口不支持该模型。
先做检查
  1. 核对保存任务中的模型标识及当前设置
  2. 区分模型404与服务地址路径错误
解决方案
  1. 管理员修正模型名称并选择匹配协议/接口
  2. 已保存任务不自动混用其他模型，是否新创作另行确认
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-012模型配置不可用管理员
故障代号
SWL-API-012
技术键
ModelNotSupported
故障含义
本版把 ModelNotSupported 映射到 provider_model_unavailable。模型服务报告所选模型不存在、尚未开通或不受当前接口支持。
可能原因
  1. 可能：模型名称拼写或版本不正确。
  2. 可能：该账号尚未开通所选模型。
  3. 可能：当前接口不支持该模型。
先做检查
  1. 核对保存任务中的模型标识及当前设置
  2. 区分模型404与服务地址路径错误
解决方案
  1. 管理员修正模型名称并选择匹配协议/接口
  2. 已保存任务不自动混用其他模型，是否新创作另行确认
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-013模型配置不可用管理员
故障代号
SWL-API-013
技术键
OperationDenied.ModelNotEnabled
故障含义
本版把 OperationDenied.ModelNotEnabled 映射到 provider_model_unavailable。模型服务报告所选模型不存在、尚未开通或不受当前接口支持。
可能原因
  1. 可能：模型名称拼写或版本不正确。
  2. 可能：该账号尚未开通所选模型。
  3. 可能：当前接口不支持该模型。
先做检查
  1. 核对保存任务中的模型标识及当前设置
  2. 区分模型404与服务地址路径错误
解决方案
  1. 管理员修正模型名称并选择匹配协议/接口
  2. 已保存任务不自动混用其他模型，是否新创作另行确认
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:37；server/enterprise-models.cjs:36

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-014服务商余额不足管理员
故障代号
SWL-API-014
技术键
OperationDenied.ServiceOverdue
故障含义
本版把 OperationDenied.ServiceOverdue 映射到 provider_balance_overdue。模型服务明确返回API账号余额不足或欠费。
可能原因
  1. 可能：服务商账户余额不足。
  2. 可能：服务商账户存在欠费或停用结算状态。
先做检查
  1. 核对失败通道对应的服务商账务状态
  2. 确认错误码为明确欠费拒绝，而非本站quota_exceeded
解决方案
  1. 管理员补足服务商余额或处理欠费
  2. 账务恢复后再确认是否需要新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:33；server/enterprise-models.cjs:41；server/enterprise-models.cjs:32

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-015内容未通过模型安全检查操作人
故障代号
SWL-API-015
技术键
OutputImageSensitiveContentDetected
故障含义
本版把 OutputImageSensitiveContentDetected 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:28

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-016内容未通过模型安全检查操作人
故障代号
SWL-API-016
技术键
OutputTextSensitiveContentDetected
故障含义
本版把 OutputTextSensitiveContentDetected 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:28

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-017模型调用权限不足管理员
故障代号
SWL-API-017
技术键
PermissionDenied
故障含义
本版把 PermissionDenied 映射到 provider_permission_denied。当前API账号没有调用所选接口或模型的权限。
可能原因
  1. 可能：当前API账号未获得所选模型权限。
  2. 可能：模型尚未在该账号开通。
  3. 可能：配置的接口与该账号允许的服务不一致。
先做检查
  1. 核对原任务所用模型、通道与接口协议
  2. 管理员核对模型开通及账号调用权限
解决方案
  1. 管理员开通正确模型或改为账号已获授权的配置
  2. 不通过切换陌生地址绕过权限拒绝
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26；server/enterprise-models.cjs:29；server/enterprise-models.cjs:34

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-018服务商套餐额度已用完管理员
故障代号
SWL-API-018
技术键
QuotaExceeded.AgentPlanQuotaExceeded
故障含义
本版把 QuotaExceeded.AgentPlanQuotaExceeded 映射到 provider_plan_quota_exhausted。模型服务商明确返回当前API账号的套餐额度已耗尽。
可能原因
  1. 可能：该API账号当前套餐周期的可用量已用尽。
  2. 可能：使用了额度不同的其他API账号。
先做检查
  1. 核对原任务实际API通道的套餐用量与周期
  2. 不要把本站剩余调用单位当作服务商套餐余量
解决方案
  1. 管理员补充对应服务商套餐额度，或配置有可用额度的账号
  2. 保留原任务费用状态，不改ID反复试探
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:34；server/enterprise-models.cjs:41；server/enterprise-models.cjs:33

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-019内容未通过模型安全检查操作人
故障代号
SWL-API-019
技术键
SensitiveContentDetected
故障含义
本版把 SensitiveContentDetected 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:28

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-020模型配置不可用管理员
故障代号
SWL-API-020
技术键
UnsupportedModel
故障含义
本版把 UnsupportedModel 映射到 provider_model_unavailable。模型服务报告所选模型不存在、尚未开通或不受当前接口支持。
可能原因
  1. 可能：模型名称拼写或版本不正确。
  2. 可能：该账号尚未开通所选模型。
  3. 可能：当前接口不支持该模型。
先做检查
  1. 核对保存任务中的模型标识及当前设置
  2. 区分模型404与服务地址路径错误
解决方案
  1. 管理员修正模型名称并选择匹配协议/接口
  2. 已保存任务不自动混用其他模型，是否新创作另行确认
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-024服务商订阅不可用管理员
故障代号
SWL-API-024
技术键
agentplan_required
故障含义
当前API账号的服务商套餐无效、已到期或不满足当前接口要求；本站额度不能替代服务商套餐。
可能原因
  1. 可能触发条件（源码固定说明）：聊天分析须配置现有火山方舟 AgentPlan 文字模型。
先做检查
  1. 对照原任务安全故障码和HTTP状态核对服务商拒绝类型
  2. 管理员核对对应API通道及模型权限，区分本站额度、服务商订阅和余额
  3. 对照当前分支核对：聊天分析须配置现有火山方舟 AgentPlan 文字模型。
解决方案
  1. 请管理员在服务商处核对并续费有效套餐，或配置有权使用该接口的API账号。
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/chat-insights.cjs:320；server/insights-services.cjs:52

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-025模型API账号验证失败管理员
故障代号
SWL-API-025
技术键
authentication_error
故障含义
本版把 authentication_error 映射到 provider_auth_failed。模型服务没有接受当前API账号的身份验证。
可能原因
  1. 可能：对应通道的Key填写错误、已撤销或已失效。
  2. 可能：Key与所选服务商接口或账号不匹配。
  3. 可能：认证协议与通道配置不匹配。
先做检查
  1. 核对失败子任务对应通道，不只看默认模型设置
  2. 管理员在受控设置中核对Key状态、接口协议及账号，不展示完整Key
解决方案
  1. 管理员更新正确通道的有效Key与协议
  2. 保留原失败任务和原费用记录，确认配置后再允许新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:25

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-029内容未通过模型安全检查操作人
故障代号
SWL-API-029
技术键
content_filter
故障含义
本版把 content_filter 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:27

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-030内容未通过模型安全检查操作人
故障代号
SWL-API-030
技术键
content_filter_error
故障含义
本版把 content_filter_error 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:27

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-031内容未通过模型安全检查操作人
故障代号
SWL-API-031
技术键
content_policy_violation
故障含义
本版把 content_policy_violation 映射到 provider_content_rejected。模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
操作人
代码依据
server/enterprise-models.cjs:27

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-043模型API账号验证失败管理员
故障代号
SWL-API-043
技术键
invalid_api_key
故障含义
本版把 invalid_api_key 映射到 provider_auth_failed。模型服务没有接受当前API账号的身份验证。
可能原因
  1. 可能：对应通道的Key填写错误、已撤销或已失效。
  2. 可能：Key与所选服务商接口或账号不匹配。
  3. 可能：认证协议与通道配置不匹配。
先做检查
  1. 核对失败子任务对应通道，不只看默认模型设置
  2. 管理员在受控设置中核对Key状态、接口协议及账号，不展示完整Key
解决方案
  1. 管理员更新正确通道的有效Key与协议
  2. 保留原失败任务和原费用记录，确认配置后再允许新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:25

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-044模型请求参数不受支持管理员
故障代号
SWL-API-044
技术键
invalid_request_error
故障含义
本版把 invalid_request_error 映射到 provider_invalid_request。模型服务明确拒绝了本次请求参数。
可能原因
  1. 可能：请求包含当前模型不支持的参数。
  2. 可能：接口协议与请求结构不匹配。
  3. 可能：参数范围或输出模式不被当前模型接受。
先做检查
  1. 核对原任务的安全参数结构，不拷贝提示词或凭证
  2. 对照本版normalizeRequest与当前模型协议检查参数
解决方案
  1. 管理员移除不支持参数或修正协议适配
  2. 优先修复请求构造，避免反复发送相同无效请求
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-054模型返回格式不可用管理员
故障代号
SWL-VAL-054
技术键
invalid_upstream_json
故障含义
本版把 invalid_upstream_json 映射到 provider_invalid_response。模型服务的响应无法解析或未包含业务所需的可用结果；是否已完成和计费仍待核实。
可能原因
  1. 可能：成功响应不是可解析JSON。
  2. 可能：返回JSON缺少当前协议所需choices、content、output或图片data。
  3. 可能：返回了error包而不是可用业务结果。
先做检查
  1. 核对安全的解析类别与HTTP状态
  2. 检查对应协议所要求的输出结构；不要把原始响应含敏感信息复制到工单
解决方案
  1. 管理员检查协议适配；服务商核对响应结构
  2. 优先找回原服务商结果，费用未核实前不重复调用
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:231；server/enterprise-models.cjs:232；server/enterprise-security.cjs:54

具体原因需结合原任务核实。

SWL-API-049模型配置不可用管理员
故障代号
SWL-API-049
技术键
model_not_found
故障含义
本版把 model_not_found 映射到 provider_model_unavailable。模型服务报告所选模型不存在、尚未开通或不受当前接口支持。
可能原因
  1. 可能：模型名称拼写或版本不正确。
  2. 可能：该账号尚未开通所选模型。
  3. 可能：当前接口不支持该模型。
先做检查
  1. 核对保存任务中的模型标识及当前设置
  2. 区分模型404与服务地址路径错误
解决方案
  1. 管理员修正模型名称并选择匹配协议/接口
  2. 已保存任务不自动混用其他模型，是否新创作另行确认
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-056模型调用权限不足管理员
故障代号
SWL-API-056
技术键
permission_error
故障含义
本版把 permission_error 映射到 provider_permission_denied。当前API账号没有调用所选接口或模型的权限。
可能原因
  1. 可能：当前API账号未获得所选模型权限。
  2. 可能：模型尚未在该账号开通。
  3. 可能：配置的接口与该账号允许的服务不一致。
先做检查
  1. 核对原任务所用模型、通道与接口协议
  2. 管理员核对模型开通及账号调用权限
解决方案
  1. 管理员开通正确模型或改为账号已获授权的配置
  2. 不通过切换陌生地址绕过权限拒绝
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。 服务商代码仅在本版HTTP分类分支中使用；普通429仍遵守既有有界重试，订阅、认证、欠费及套餐耗尽按明确拒绝处理。
处理责任
管理员
代码依据
server/enterprise-models.cjs:26

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-058模型API账号验证失败管理员
故障代号
SWL-API-058
技术键
provider_auth_failed
故障含义
模型服务没有接受当前API账号的身份验证。
可能原因
  1. 可能：对应通道的Key填写错误、已撤销或已失效。
  2. 可能：Key与所选服务商接口或账号不匹配。
  3. 可能：认证协议与通道配置不匹配。
先做检查
  1. 核对失败子任务对应通道，不只看默认模型设置
  2. 管理员在受控设置中核对Key状态、接口协议及账号，不展示完整Key
解决方案
  1. 管理员更新正确通道的有效Key与协议
  2. 保留原失败任务和原费用记录，确认配置后再允许新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:32；server/enterprise-models.cjs:45

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-059服务商余额不足管理员
故障代号
SWL-API-059
技术键
provider_balance_overdue
故障含义
模型服务明确返回API账号余额不足或欠费。
可能原因
  1. 可能：服务商账户余额不足。
  2. 可能：服务商账户存在欠费或停用结算状态。
先做检查
  1. 核对失败通道对应的服务商账务状态
  2. 确认错误码为明确欠费拒绝，而非本站quota_exceeded
解决方案
  1. 管理员补足服务商余额或处理欠费
  2. 账务恢复后再确认是否需要新创作
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:33

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-060模型或API配置未通过校验管理员
故障代号
SWL-API-060
技术键
provider_configuration_invalid
故障含义
当前模型或API账号配置未通过服务器校验。
可能原因
  1. 可能：加密的API配置无法读取。
  2. 可能：配置缺失或与当前运行环境不一致。
先做检查
  1. 核对通道是否已启用且模型、接口、Key配置完整
  2. 服务商检查配置解密环境，切勿删除既有加密密钥
解决方案
  1. 管理员通过正式设置入口修正配置
  2. 服务商恢复原加密环境，不直接改写数据库凭证
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:231

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-061模型服务地址或网络不可用管理员
故障代号
SWL-API-061
技术键
provider_connection_failed
故障含义
模型服务地址未通过连接或域名解析验证。
可能原因
  1. 可能：模型域名无法解析。
  2. 可能：配置地址不能通过公网HTTPS验证。
  3. 可能：服务器DNS或网络不通。
先做检查
  1. 核对API地址的协议、域名和公网解析结果
  2. 确认本次是否尚未进入模型传输阶段
解决方案
  1. 管理员修正API地址；服务商修复DNS或网络
  2. 确认原请求未发出后再继续原处理
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:231

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-062模型连接中断，结果待核实服务商
故障代号
SWL-API-062
技术键
provider_connection_interrupted
故障含义
模型请求发出后连接中断；服务商是否已经完成或计费尚未确认。
可能原因
  1. 可能：请求发出后网络连接中断。
  2. 可能：远端在返回完整响应前关闭连接。
先做检查
  1. 核对原调用是否已发出及usage_ledger状态
  2. 管理员核对原服务商请求记录
解决方案
  1. 恢复网络后只读取原任务
  2. 费用与结果核实前保留unknown，不自动补买
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/enterprise-models.cjs:231

具体原因需结合原任务核实。

SWL-API-063内容未通过模型安全检查操作人
故障代号
SWL-API-063
技术键
provider_content_rejected
故障含义
模型服务明确拒绝了本次输入或输出内容。
可能原因
  1. 可能：输入主题、参考内容或图片触发服务商内容检查。
  2. 可能：模型输出触发服务商内容检查。
先做检查
  1. 确认安全映射码表示内容拒绝
  2. 仅核对必要主题和素材，不把原始私人资料放入工单
解决方案
  1. 操作人修改相关主题、参考资料或绘图内容
  2. 确认适用后再发起新的创作，不把安全拒绝当作余额不足
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
操作人
代码依据
server/enterprise-models.cjs:39

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-064模型请求参数不受支持管理员
故障代号
SWL-API-064
技术键
provider_invalid_request
故障含义
模型服务明确拒绝了本次请求参数。
可能原因
  1. 可能：请求包含当前模型不支持的参数。
  2. 可能：接口协议与请求结构不匹配。
  3. 可能：参数范围或输出模式不被当前模型接受。
先做检查
  1. 核对原任务的安全参数结构，不拷贝提示词或凭证
  2. 对照本版normalizeRequest与当前模型协议检查参数
解决方案
  1. 管理员移除不支持参数或修正协议适配
  2. 优先修复请求构造，避免反复发送相同无效请求
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:38

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-065模型返回格式不可用管理员
故障代号
SWL-API-065
技术键
provider_invalid_response
故障含义
模型服务的响应无法解析或未包含业务所需的可用结果；是否已完成和计费仍待核实。
可能原因
  1. 可能：成功响应不是可解析JSON。
  2. 可能：返回JSON缺少当前协议所需choices、content、output或图片data。
  3. 可能：返回了error包而不是可用业务结果。
先做检查
  1. 核对安全的解析类别与HTTP状态
  2. 检查对应协议所要求的输出结构；不要把原始响应含敏感信息复制到工单
解决方案
  1. 管理员检查协议适配；服务商核对响应结构
  2. 优先找回原服务商结果，费用未核实前不重复调用
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
server/enterprise-models.cjs:227；server/enterprise-models.cjs:231

具体原因需结合原任务核实。

SWL-API-066模型配置不可用管理员
故障代号
SWL-API-066
技术键
provider_model_unavailable
故障含义
模型服务报告所选模型不存在、尚未开通或不受当前接口支持。
可能原因
  1. 可能：模型名称拼写或版本不正确。
  2. 可能：该账号尚未开通所选模型。
  3. 可能：当前接口不支持该模型。
先做检查
  1. 核对保存任务中的模型标识及当前设置
  2. 区分模型404与服务地址路径错误
解决方案
  1. 管理员修正模型名称并选择匹配协议/接口
  2. 已保存任务不自动混用其他模型，是否新创作另行确认
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:36；server/enterprise-models.cjs:37；server/enterprise-models.cjs:47

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-067模型调用权限不足管理员
故障代号
SWL-API-067
技术键
provider_permission_denied
故障含义
当前API账号没有调用所选接口或模型的权限。
可能原因
  1. 可能：当前API账号未获得所选模型权限。
  2. 可能：模型尚未在该账号开通。
  3. 可能：配置的接口与该账号允许的服务不一致。
先做检查
  1. 核对原任务所用模型、通道与接口协议
  2. 管理员核对模型开通及账号调用权限
解决方案
  1. 管理员开通正确模型或改为账号已获授权的配置
  2. 不通过切换陌生地址绕过权限拒绝
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:35；server/enterprise-models.cjs:46

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-068服务商套餐额度已用完管理员
故障代号
SWL-API-068
技术键
provider_plan_quota_exhausted
故障含义
模型服务商明确返回当前API账号的套餐额度已耗尽。
可能原因
  1. 可能：该API账号当前套餐周期的可用量已用尽。
  2. 可能：使用了额度不同的其他API账号。
先做检查
  1. 核对原任务实际API通道的套餐用量与周期
  2. 不要把本站剩余调用单位当作服务商套餐余量
解决方案
  1. 管理员补充对应服务商套餐额度，或配置有可用额度的账号
  2. 保留原任务费用状态，不改ID反复试探
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:34

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-069模型API账号持续限流管理员
故障代号
SWL-API-069
技术键
provider_rate_limited
故障含义
模型服务持续返回限流，本次允许的自动重试已经用完。
可能原因
  1. 可能：原API通道同时请求数过多。
  2. 可能：单位时间请求频率超过允许范围。
  3. 可能：服务商暂时限制该账号请求。
先做检查
  1. 核对该通道并发、RPM与Retry-After记录
  2. 确认原任务最多三次重试已经结束
解决方案
  1. 管理员降低对应通道并发或RPM
  2. 等待限流恢复，不用新任务编号绕过限制
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
源码对明确HTTP 429使用原任务和原预留额度最多重试三次；次数用完后停止。不要改任务编号绕过限流。
处理责任
管理员
代码依据
server/enterprise-models.cjs:48

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-070模型服务拒绝请求管理员
故障代号
SWL-API-070
技术键
provider_request_rejected
故障含义
模型服务返回了请求拒绝响应；更具体的原因未能确认。
可能原因
  1. 可能：模型服务返回了请求拒绝响应；更具体的原因未能确认。
先做检查
  1. 对照原任务安全故障码和HTTP状态核对服务商拒绝类型
  2. 管理员核对对应API通道及模型权限，区分本站额度、服务商订阅和余额
解决方案
  1. 请管理员按原任务编号核对服务商请求记录、账号权限、接口配置和请求参数。
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:50

具体原因需结合原任务核实。

SWL-API-071服务商订阅不可用管理员
故障代号
SWL-API-071
技术键
provider_subscription_invalid
故障含义
当前API账号的服务商套餐无效、已到期或不满足当前接口要求；本站额度不能替代服务商套餐。
可能原因
  1. 可能：服务商套餐已到期或未生效。
  2. 可能：当前账号的套餐不支持使用的套餐接口。
先做检查
  1. 核对该API账号的订阅有效期与实际接口要求
  2. 区分本站月额度与服务商套餐
解决方案
  1. 管理员在服务商处恢复适用订阅，或配置拥有有效订阅的账号
  2. 不要通过增加本站额度解决服务商订阅问题
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/enterprise-models.cjs:31

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-072模型响应超时，结果待核实服务商
故障代号
SWL-API-072
技术键
provider_timeout
故障含义
等待模型服务的时间超过了限制；超时不能确认服务商是否已经完成或计费。
可能原因
  1. 可能：服务商响应超过本版等待期限。
  2. 可能：请求已发出后服务商继续处理，但本站未及时收到结果。
  3. 可能：连接前域名解析等待超过期限。
先做检查
  1. 核对模型任务结算状态，区分未发出请求与已发出待核实
  2. 查看原任务是否已有服务商完成记录
解决方案
  1. 服务商检查等待期限和网络；管理员核实服务商原请求
  2. 不以超时为由直接重新发出付费请求
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/enterprise-models.cjs:231

具体原因需结合原任务核实。

SWL-API-073模型服务异常，结果待核实服务商
故障代号
SWL-API-073
技术键
provider_upstream_unavailable
故障含义
模型服务返回服务器异常；服务商是否已经完成或计费尚未确认。
可能原因
  1. 可能：服务商返回HTTP 5xx。
  2. 可能：服务商或其网关暂时不能完成响应。
先做检查
  1. 保留安全HTTP状态和原任务编号
  2. 核对服务商是否接受、完成或计费；5xx不证明没有计费
解决方案
  1. 管理员协调服务商核对原请求记录
  2. 只刷新原任务，结果未确认前不重新购买
验证恢复
  1. 原任务状态与费用核实一致
  2. 后续获准操作不再出现同一服务商拒绝；原unknown任务没有被重复购买
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
服务商
代码依据
server/enterprise-models.cjs:227

具体原因需结合原任务核实。

SWL-STORE-001目标文件已存在服务商
故障代号
SWL-STORE-001
技术键
EEXIST
故障含义
文件系统报告目标已存在；本版多处把它作为幂等或并发写入的可处理情况，并继续校验已有文件。
可能原因
  1. 可能：相同内容文件已由另一次请求写入
  2. 可能：加密密钥文件已经初始化
  3. 可能：缩略图目标已经存在
先做检查
  1. 根据来源位置区分初始化、资源写入和缩略图流程
  2. 核对已有文件类型及校验摘要；不要查看或更换密钥内容
解决方案
  1. 合法且摘要一致时保留原文件
  2. 类型或摘要不一致时由服务商调查冲突，保护原数据
验证恢复
  1. 原文件仍有效；内容摘要匹配；既有凭证继续可解密
重试规则
通常无需人工重试；不可删除既有加密密钥来消除此码。
处理责任
服务商
代码依据
server/enterprise-security.cjs:27；server/enterprise-works.cjs:50；server/media-retention.cjs:69

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STORE-002待处理文件不存在服务商
故障代号
SWL-STORE-002
技术键
ENOENT
故障含义
文件系统报告目标不存在；清理代码对已经不存在的文件按已清理处理。
可能原因
  1. 可能：文件已由另一个清理过程移除
  2. 可能：源文件本来就不在该位置
先做检查
  1. 确认来源是否为删除临时文件或孤立文件的清理分支
  2. 若为作品读取异常，核对是否另有image_missing等公开码
解决方案
  1. 清理分支无额外失败时无需恢复被删除的临时或孤立文件
  2. 引用中的作品原图缺失时从备份或本机副本核查恢复
验证恢复
  1. 清理待办列表不再保留不存在的文件；正在引用的原图不受影响
重试规则
不要为已清理文件重复生成；读取故障应按原图缺失流程处理。
处理责任
服务商
代码依据
server/media-retention.cjs:73；server/publication-storage.cjs:50

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STORE-003服务器磁盘空间不足服务商
故障代号
SWL-STORE-003
技术键
disk_space_low
故障含义
服务器可用磁盘低于保存作品所需的空间。
可能原因
  1. 可能：服务器可用磁盘低于保留空间要求。
  2. 可能：待保存图片需要的空间超过当前可用量。
先做检查
  1. 查看可用字节、配置保留量与待保存图片规模
  2. 核对保留策略和真正可清理的孤立文件
解决方案
  1. 服务商扩容或通过既有保留策略回收允许清理的文件
  2. 确认空间恢复后处理原素材，不删除活跃作品或密钥
验证恢复
  1. 存储检查恢复，原作品图片仍可读取
  2. 符合条件的维护能继续，没有误删活跃引用
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/storage.cjs:12；web/app.mjs:331

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STORE-004服务器图片存储额度不足服务商
故障代号
SWL-STORE-004
技术键
image_quota_exceeded
故障含义
服务器保存图片的容量已达到配置上限。
可能原因
  1. 可能：已有图片与待上传图片合计超过团队存储额度。
  2. 可能：保留期清理没有及时释放允许回收的图片。
先做检查
  1. 查看团队图片总量、待写入字节和配额
  2. 核对是否存在清理待办及活跃引用
解决方案
  1. 管理员调整图片配额或让服务商修复既有保留清理
  2. 保留仍被作品引用和未结算任务所需媒体
验证恢复
  1. 存储检查恢复，原作品图片仍可读取
  2. 符合条件的维护能继续，没有误删活跃引用
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/storage.cjs:11；web/app.mjs:331

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STORE-005云端原始图片已归档操作人
故障代号
SWL-STORE-005
技术键
media_archived
故障含义
当前操作需要的云端原始图片已按保留策略归档或清理。
可能原因
  1. 可能触发条件（源码固定说明）：原图已按24小时保存规则清理，当前仅保留缩略图。
先做检查
  1. 查看服务器可用磁盘、存储额度和失败计数
  2. 核对文件是否仍有作品引用，保留未结算任务和安全故障上下文
  3. 对照当前分支核对：原图已按24小时保存规则清理，当前仅保留缩略图。
解决方案
  1. 使用本机已有图片恢复；没有副本时由管理员确认后另行创作，原任务不会自动重买。
验证恢复
  1. 存储检查恢复，原作品图片仍可读取
  2. 符合条件的维护能继续，没有误删活跃引用
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
操作人
代码依据
server/cloud-cards.cjs:469；server/enterprise-works.cjs:59

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-063请求内容类型校验未通过操作人
故障代号
SWL-VAL-063
技术键
unsupported_media_type
故障含义
源码以此代码拒绝以下输入或状态：请求Content-Type不是application/json。
可能原因
  1. 可能：请求Content-Type不是application/json。
先做检查
  1. 定位当前字段或参数：请求内容类型。
  2. 逐项核对：请求Content-Type不是application/json。
  3. 该代码的固定校验说明：请求格式须为 application/json。
解决方案
  1. 将Content-Type设为application/json，并提交有效JSON。
验证恢复
  1. 请求内容类型通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:33

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-001iOS导航被取消（通常不显示故障）操作人
故障代号
SWL-CLIENT-001
技术键
NSURLErrorCancelled
故障含义
iOS客户端明确忽略NSURLErrorCancelled，不因这种导航取消而显示离线提示。
可能原因
  1. 可能：刷新或新导航取消了前一个网页加载
  2. 可能：系统取消了原导航
先做检查
  1. 确认后续导航是否成功；本码并不证明服务器处理失败
解决方案
  1. 后续页面正常时无需修复；持续无法加载时按网络故障核对
验证恢复
  1. 后续页面正常加载，未把正常取消误报为离线
重试规则
仅对网页加载进行刷新；不据此重复提交生成或发布。
处理责任
操作人
代码依据
mobile/ios/SuwenlinCards/CloudViewController.swift:117；mobile/ios/SuwenlinCards/CloudViewController.swift:120

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-001已有任务正在处理操作人
故障代号
SWL-JOB-001
技术键
account_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：此账号有生成、分析或发布任务正在执行，请等待任务结束后再删除。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此账号有生成、分析或发布任务正在执行，请等待任务结束后再删除。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/app.cjs:155

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-001账号绑定或资料已变化管理员
故障代号
SWL-STATE-001
技术键
account_changed
故障含义
当前操作保存的账号或绑定版本不再是最新状态。
可能原因
  1. 可能触发条件（源码固定说明）：账号状态已更新，请重新登录。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：账号状态已更新，请重新登录。
解决方案
  1. 重新读取账号与绑定；请管理员确认当前主理人身份后继续，勿使用旧授权。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/app.cjs:131

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-021账号绑定或资料已变化管理员
故障代号
SWL-API-021
技术键
account_deleted
故障含义
当前操作保存的账号或绑定版本不再是最新状态。
可能原因
  1. 可能触发条件（源码固定说明）：此账号已经删除。
  2. 可能触发条件（源码固定说明）：账号已删除，不能修改或重新启用。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此账号已经删除。
  4. 对照当前分支核对：账号已删除，不能修改或重新启用。
解决方案
  1. 重新读取账号与绑定；请管理员确认当前主理人身份后继续，勿使用旧授权。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:148；server/app.cjs:169

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-001账号或设备权限受限管理员
故障代号
SWL-AUTH-001
技术键
account_disabled
故障含义
当前账号或设备不满足此操作的权限要求。
可能原因
  1. 可能：当前账号或设备不满足此操作的权限要求。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
解决方案
  1. 请管理员检查账号启用状态、角色和设备授权，恢复后继续处理原任务。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/enterprise-works.cjs:36

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-022发布账号或内容不匹配操作人
故障代号
SWL-API-022
技术键
account_mismatch
故障含义
当前发布账号、清单或内容与原作品授权信息不一致。
可能原因
  1. 可能触发条件（源码固定说明）：平台账号标签不一致。
  2. 可能触发条件（源码固定说明）：当前平台账号会话与登记版本不一致。
  3. 可能触发条件（源码固定说明）：当前平台账号标签与批准版本不一致。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：平台账号标签不一致。
  4. 对照当前分支核对：当前平台账号会话与登记版本不一致。
  5. 对照当前分支核对：当前平台账号标签与批准版本不一致。
解决方案
  1. 核对原作品的发布账号和已审核内容，使用匹配的账号及版本；不要绕过检查。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise-works.cjs:43；server/enterprise-works.cjs:81；server/enterprise-works.cjs:84

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-002已有任务正在处理操作人
故障代号
SWL-AUTH-002
技术键
authentication_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：鉴权服务繁忙，请稍后重试。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：鉴权服务繁忙，请稍后重试。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:151

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-003账号绑定或资料已变化管理员
故障代号
SWL-AUTH-003
技术键
binding_changed
故障含义
当前操作保存的账号或绑定版本不再是最新状态。
可能原因
  1. 可能触发条件（源码固定说明）：此账号的小程序主理人 ID 已更新，请刷新后重试。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此账号的小程序主理人 ID 已更新，请刷新后重试。
解决方案
  1. 重新读取账号与绑定；请管理员确认当前主理人身份后继续，勿使用旧授权。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:124

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-005小程序授权不可用操作人
故障代号
SWL-AUTH-005
技术键
data_authorization_required
故障含义
小程序授权未通过验证、已过期、已使用，或已因设置变化而失效。
可能原因
  1. 可能触发条件（源码固定说明）：此主理人的数据授权不可用或已到期，请从小程序重新进入以刷新授权。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此主理人的数据授权不可用或已到期，请从小程序重新进入以刷新授权。
解决方案
  1. 返回小程序获取新的授权后重新进入；持续失败时请管理员核对签名与验证配置。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:264；web/app.mjs:539；web/app.mjs:547

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-005账号或设备权限受限管理员
故障代号
SWL-CLIENT-005
技术键
device_disabled
故障含义
当前账号或设备不满足此操作的权限要求。
可能原因
  1. 可能触发条件（源码固定说明）：此设备已禁用。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此设备已禁用。
解决方案
  1. 请管理员检查账号启用状态、角色和设备授权，恢复后继续处理原任务。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/enterprise-works.cjs:68

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-006设备编号已由其他账号使用操作人
故障代号
SWL-CLIENT-006
技术键
device_exists
故障含义
注册设备时发现该设备编号已有其他归属，不能用当前账号覆盖。
可能原因
  1. 可能：重用了其他账号已经登记的设备编号
  2. 可能：复制了其他设备的本地登记信息
先做检查
  1. 读取本人已登记设备列表
  2. 管理员核对原设备归属，不把其他成员设备转为本人
解决方案
  1. 使用本人实际登记的设备；真正新设备由客户端生成新的登记编号
验证恢复
  1. 本人设备归属正确，原设备没有被覆盖
重试规则
先核对设备归属；不通过重复注册绕过归属检查。
处理责任
操作人
代码依据
server/enterprise-works.cjs:68

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-007账号或设备权限受限管理员
故障代号
SWL-CLIENT-007
技术键
device_forbidden
故障含义
当前账号或设备不满足此操作的权限要求。
可能原因
  1. 可能触发条件（源码固定说明）：请使用本人已登记且启用的设备。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：请使用本人已登记且启用的设备。
解决方案
  1. 请管理员检查账号启用状态、角色和设备授权，恢复后继续处理原任务。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/enterprise-works.cjs:85

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-007重复绑定校验未通过操作人
故障代号
SWL-AUTH-007
技术键
duplicate_binding
故障含义
源码以此代码拒绝以下输入或状态：同一绑定列表重复使用了主理人或团队账号。
可能原因
  1. 可能：同一绑定列表重复使用了主理人或团队账号。
先做检查
  1. 定位当前字段或参数：重复绑定。
  2. 逐项核对：同一绑定列表重复使用了主理人或团队账号。
  3. 该代码的固定校验说明：账号和主理人编号均须唯一。
解决方案
  1. 删除绑定列表中的重复账号或主理人条目，保留唯一对应关系。
验证恢复
  1. 重复绑定通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:82

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-012绑定对象校验未通过操作人
故障代号
SWL-AUTH-012
技术键
invalid_binding_user
故障含义
源码以此代码拒绝以下输入或状态：试图绑定的对象不是已启用的主理人账号。
可能原因
  1. 可能：试图绑定的对象不是已启用的主理人账号。
先做检查
  1. 定位当前字段或参数：绑定对象。
  2. 逐项核对：试图绑定的对象不是已启用的主理人账号。
  3. 该代码的固定校验说明：仅可绑定已启用的主理人账号。
  4. 该代码的固定校验说明：仅可修改已启用的主理人账号绑定。
解决方案
  1. 先启用正确的operator主理人账号，再进行绑定。
验证恢复
  1. 绑定对象通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:91；server/miniapp-auth.cjs:122

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-013主理人绑定列表校验未通过操作人
故障代号
SWL-AUTH-013
技术键
invalid_bindings
故障含义
源码以此代码拒绝以下输入或状态：主理人绑定列表不是允许的数组或超过长度限制。
可能原因
  1. 可能：主理人绑定列表不是允许的数组或超过长度限制。
先做检查
  1. 定位当前字段或参数：主理人绑定列表。
  2. 逐项核对：主理人绑定列表不是允许的数组或超过长度限制。
  3. 该代码的固定校验说明：主理人绑定列表格式无效或过长。
解决方案
  1. 提交长度合规的绑定数组，并逐项填入启用中的账号和正确来源ID。
验证恢复
  1. 主理人绑定列表通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:80

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-014账号验证未通过操作人
故障代号
SWL-AUTH-014
技术键
invalid_credentials
故障含义
输入的账号或密码没有通过验证。
可能原因
  1. 可能：用户名或密码不正确。
  2. 可能：账号已经停用。
  3. 可能：登录过程中账号状态发生变化。
先做检查
  1. 核对使用的登录入口和当前账号名
  2. 管理员核对账号启用状态；不要索取用户明文密码
解决方案
  1. 操作人重新输入正确凭证；忘记密码时由管理员按流程重设
  2. 停用账号由管理员核实后处理
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:114；server/app.cjs:117

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-015账号验证未通过操作人
故障代号
SWL-AUTH-015
技术键
invalid_password
故障含义
输入的账号或密码没有通过验证。
可能原因
  1. 可能触发条件（源码固定说明）：当前密码不正确。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：当前密码不正确。
解决方案
  1. 核对账号和密码；忘记密码或账号被停用时联系管理员处理。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:129

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-031主理人来源编号校验未通过操作人
故障代号
SWL-VAL-031
技术键
invalid_principal
故障含义
源码以此代码拒绝以下输入或状态：给管理员填写了主理人ID，或主理人来源编号包含非法字符。
可能原因
  1. 可能：给管理员填写了主理人ID，或主理人来源编号包含非法字符。
先做检查
  1. 定位当前字段或参数：主理人来源编号。
  2. 逐项核对：给管理员填写了主理人ID，或主理人来源编号包含非法字符。
  3. 该代码的固定校验说明：管理员账号不使用小程序主理人 ID。
  4. 该代码的固定校验说明：主理人编号仅支持字母、数字和 . _ : @ -，不允许空白或改写来源编号。
解决方案
  1. 管理员清空主理人ID；主理人使用来源提供的原编号并去除非法空白。
验证恢复
  1. 主理人来源编号通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:136；server/miniapp-auth.cjs:18

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-032来源主理人元数据校验未通过服务商
故障代号
SWL-VAL-032
技术键
invalid_principal_metadata
故障含义
源码以此代码拒绝以下输入或状态：来源主理人ID格式无效、重复，或每页超过200人。
可能原因
  1. 可能：来源主理人ID格式无效、重复，或每页超过200人。
先做检查
  1. 定位当前字段或参数：来源主理人元数据。
  2. 逐项核对：来源主理人ID格式无效、重复，或每页超过200人。
  3. 该代码的固定校验说明：采集源的主理人 ID 格式无效。
  4. 该代码的固定校验说明：每页最多提供 200 位主理人。
  5. 该代码的固定校验说明：主理人元数据 ID 不可重复。
解决方案
  1. 来源服务方修正主理人ID、删除重复项并把每页主理人数控制在200以内。
验证恢复
  1. 来源主理人元数据通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
服务商
代码依据
server/principal-accounts.cjs:5；server/principal-accounts.cjs:26；server/principal-accounts.cjs:28

具体原因需结合原任务核实。

SWL-STATE-008不能停用最后一个启用的管理员操作人
故障代号
SWL-STATE-008
技术键
last_admin
故障含义
账号变更将导致没有启用的管理员，服务器拒绝该操作。
可能原因
  1. 可能：目标是最后一个仍启用的管理员账号
先做检查
  1. 核对启用中管理员数量和本次变更目标
解决方案
  1. 先确保另一个可信管理员已启用，再按权限流程变更目标账号
验证恢复
  1. 至少一个有效管理员始终保留，管理入口仍可登录
重试规则
不会自动重复该变更；确认管理员接替后再操作。
处理责任
操作人
代码依据
server/app.cjs:169

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-017账号或设备权限受限管理员
故障代号
SWL-AUTH-017
技术键
login_forbidden
故障含义
当前账号或设备不满足此操作的权限要求。
可能原因
  1. 可能触发条件（源码固定说明）：账号不具备登录权限。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：账号不具备登录权限。
解决方案
  1. 请管理员检查账号启用状态、角色和设备授权，恢复后继续处理原任务。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:57

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-018小程序授权不可用操作人
故障代号
SWL-AUTH-018
技术键
miniapp_grant_expired
故障含义
小程序授权未通过验证、已过期、已使用，或已因设置变化而失效。
可能原因
  1. 可能触发条件（源码固定说明）：小程序鉴权凭证已过期或时间无效。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：小程序鉴权凭证已过期或时间无效。
解决方案
  1. 返回小程序获取新的授权后重新进入；持续失败时请管理员核对签名与验证配置。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:170

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-019小程序授权尚未配置管理员
故障代号
SWL-AUTH-019
技术键
miniapp_not_configured
故障含义
服务器尚未完成小程序登录或验证配置。
可能原因
  1. 可能触发条件（源码固定说明）：小程序后台鉴权尚未配置，请联系管理员。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：小程序后台鉴权尚未配置，请联系管理员。
解决方案
  1. 请管理员配置小程序验证服务和主理人账号绑定；有账号密码时可使用正式账号登录。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:149

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-020登录状态已失效操作人
故障代号
SWL-AUTH-020
技术键
miniapp_session_required
故障含义
当前请求没有有效的登录授权。
可能原因
  1. 可能触发条件（源码固定说明）：请通过小程序后台重新鉴权登录。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：请通过小程序后台重新鉴权登录。
解决方案
  1. 重新登录；从小程序进入的账号请重新打开小程序授权入口，再读取原任务状态。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:64

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-021小程序授权不可用操作人
故障代号
SWL-AUTH-021
技术键
miniapp_settings_changed
故障含义
小程序授权未通过验证、已过期、已使用，或已因设置变化而失效。
可能原因
  1. 可能触发条件（源码固定说明）：鉴权设置已更新，请重新登录。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：鉴权设置已更新，请重新登录。
解决方案
  1. 返回小程序获取新的授权后重新进入；持续失败时请管理员核对签名与验证配置。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:175

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-022小程序服务响应未完成服务商
故障代号
SWL-AUTH-022
技术键
miniapp_unavailable
故障含义
小程序账号服务未返回当前操作需要的可用结果。
可能原因
  1. 可能触发条件（源码固定说明）：小程序鉴权服务暂不可用，请稍后重试。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：小程序鉴权服务暂不可用，请稍后重试。
解决方案
  1. 请管理员核对小程序服务状态、接口和返回数据；先检查原同步结果，再决定是否重新同步。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/miniapp-auth.cjs:163

具体原因需结合原任务核实。

SWL-AUTH-023小程序授权不可用操作人
故障代号
SWL-AUTH-023
技术键
miniapp_verification_failed
故障含义
小程序授权未通过验证、已过期、已使用，或已因设置变化而失效。
可能原因
  1. 可能：一次性凭证未通过验证。
  2. 可能：验证服务返回的身份或时效信息不符合本版要求。
  3. 可能：鉴权配置与小程序签发方式不匹配。
先做检查
  1. 管理员核对当前验证提供方式、有效期和绑定身份
  2. 不把完整签名凭证或令牌放入排障记录
解决方案
  1. 操作人从小程序取得新授权
  2. 管理员修正验证配置和身份绑定后重新进入
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:166；server/miniapp-auth.cjs:167

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-042主理人账号绑定需要处理管理员
故障代号
SWL-SYNC-042
技术键
principal_account_id_collision
故障含义
当前主理人与团队账号的绑定缺失，或与已有账号发生冲突。
可能原因
  1. 可能触发条件（源码固定说明）：此小程序主理人 ID 已有账号，请同步或管理原账号。
  2. 可能触发条件（源码固定说明）：小程序主理人 ID 与已有账号编号冲突，请管理员核实；不会关联或覆盖已有账号。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此小程序主理人 ID 已有账号，请同步或管理原账号。
  4. 对照当前分支核对：小程序主理人 ID 与已有账号编号冲突，请管理员核实；不会关联或覆盖已有账号。
解决方案
  1. 请管理员核对小程序主理人ID和现有账号绑定，保留原账号，避免覆盖其他账号。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:137；server/principal-accounts.cjs:17

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-043主理人账号数量达到上限管理员
故障代号
SWL-SYNC-043
技术键
principal_account_limit
故障含义
当前同步的主理人账号数量达到系统允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：主理人账号数量达到本版上限，请管理员处理。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：主理人账号数量达到本版上限，请管理员处理。
解决方案
  1. 请管理员检查账号数量和同步范围，必要时由服务商处理容量。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/principal-accounts.cjs:34；server/principal-accounts.cjs:46

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-025主理人账号绑定需要处理管理员
故障代号
SWL-AUTH-025
技术键
principal_already_bound
故障含义
当前主理人与团队账号的绑定缺失，或与已有账号发生冲突。
可能原因
  1. 可能触发条件（源码固定说明）：此小程序主理人 ID 已关联已删除账号，不可重新分配。
  2. 可能触发条件（源码固定说明）：此小程序主理人 ID 已关联其他账号，请先核实。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此小程序主理人 ID 已关联已删除账号，不可重新分配。
  4. 对照当前分支核对：此小程序主理人 ID 已关联其他账号，请先核实。
解决方案
  1. 请管理员核对小程序主理人ID和现有账号绑定，保留原账号，避免覆盖其他账号。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:92；server/miniapp-auth.cjs:127

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-026账号绑定或资料已变化管理员
故障代号
SWL-AUTH-026
技术键
principal_binding_changed
故障含义
当前操作保存的账号或绑定版本不再是最新状态。
可能原因
  1. 可能触发条件（源码固定说明）：主理人绑定发生变化，请重新采集。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：主理人绑定发生变化，请重新采集。
解决方案
  1. 重新读取账号与绑定；请管理员确认当前主理人身份后继续，勿使用旧授权。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/principal-accounts.cjs:51

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-027主理人账号绑定需要处理管理员
故障代号
SWL-AUTH-027
技术键
principal_binding_forbidden
故障含义
当前主理人与团队账号的绑定缺失，或与已有账号发生冲突。
可能原因
  1. 可能触发条件（源码固定说明）：主理人 ID 不可绑定管理员。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：主理人 ID 不可绑定管理员。
解决方案
  1. 请管理员核对小程序主理人ID和现有账号绑定，保留原账号，避免覆盖其他账号。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/principal-accounts.cjs:49

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-044来源身份信息不能改写管理员
故障代号
SWL-SYNC-044
技术键
principal_id_immutable
故障含义
当前字段来自原始身份或创建记录，不允许通过编辑覆盖。
可能原因
  1. 可能触发条件（源码固定说明）：小程序来源 ID 是此账号的固定唯一编号，不能变更或转给其他账号。
  2. 可能触发条件（源码固定说明）：小程序来源 ID 是此账号的固定唯一编号，不能修改；登录名可由管理员单独调整。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：小程序来源 ID 是此账号的固定唯一编号，不能变更或转给其他账号。
  4. 对照当前分支核对：小程序来源 ID 是此账号的固定唯一编号，不能修改；登录名可由管理员单独调整。
解决方案
  1. 保留来源身份与创建信息；请管理员使用允许修改的显示名称或账号设置。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:89；server/miniapp-auth.cjs:125

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-028主理人账号绑定需要处理管理员
故障代号
SWL-AUTH-028
技术键
principal_not_bound
故障含义
当前主理人与团队账号的绑定缺失，或与已有账号发生冲突。
可能原因
  1. 可能触发条件（源码固定说明）：此主理人尚未绑定启用的词卡账号，请联系管理员。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：此主理人尚未绑定启用的词卡账号，请联系管理员。
解决方案
  1. 请管理员核对小程序主理人ID和现有账号绑定，保留原账号，避免覆盖其他账号。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:177；web/app.mjs:543

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-045已有任务正在处理操作人
故障代号
SWL-SYNC-045
技术键
principal_provision_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：主理人账号正在同步，请稍后再试。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：主理人账号正在同步，请稍后再试。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/principal-accounts.cjs:29

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-046小程序服务响应未完成服务商
故障代号
SWL-SYNC-046
技术键
principal_service_closed
故障含义
小程序账号服务未返回当前操作需要的可用结果。
可能原因
  1. 可能触发条件（源码固定说明）：账号同步服务正在停止。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：账号同步服务正在停止。
解决方案
  1. 请管理员核对小程序服务状态、接口和返回数据；先检查原同步结果，再决定是否重新同步。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/principal-accounts.cjs:25；server/principal-accounts.cjs:39

具体原因需结合原任务核实。

SWL-SYNC-047主理人账号绑定需要处理管理员
故障代号
SWL-SYNC-047
技术键
principal_username_collision
故障含义
当前主理人与团队账号的绑定缺失，或与已有账号发生冲突。
可能原因
  1. 可能触发条件（源码固定说明）：自动账号名称已被占用，请管理员先配置主理人绑定。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：自动账号名称已被占用，请管理员先配置主理人绑定。
解决方案
  1. 请管理员核对小程序主理人ID和现有账号绑定，保留原账号，避免覆盖其他账号。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/principal-accounts.cjs:22

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-029登录状态已失效操作人
故障代号
SWL-AUTH-029
技术键
session_changed
故障含义
本版把 session_changed 映射到 session_expired。当前请求没有有效的登录授权。
可能原因
  1. 可能：会话超过有效期。
  2. 可能：原会话被注销或撤销。
  3. 可能：账号状态或小程序授权版本变化。
先做检查
  1. 读取当前会话状态
  2. 核对是否切换了账号或重新打开旧授权链接
解决方案
  1. 从正式入口重新登录；小程序账号重新授权
  2. 登录后读取原任务，保留本地未保存内容
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
web/session-keepalive.js:25

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-030登录状态已失效操作人
故障代号
SWL-AUTH-030
技术键
session_expired
故障含义
当前请求没有有效的登录授权。
可能原因
  1. 可能：会话超过有效期。
  2. 可能：原会话被注销或撤销。
  3. 可能：账号状态或小程序授权版本变化。
先做检查
  1. 读取当前会话状态
  2. 核对是否切换了账号或重新打开旧授权链接
解决方案
  1. 从正式入口重新登录；小程序账号重新授权
  2. 登录后读取原任务，保留本地未保存内容
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:56；server/enterprise-models.cjs:142；server/fault-alerts.cjs:29；server/miniapp-auth.cjs:59；server/web/assets/app.js:142

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-032登录状态已失效操作人
故障代号
SWL-AUTH-032
技术键
unauthorized
故障含义
当前请求没有有效的登录授权。
可能原因
  1. 可能触发条件（源码固定说明）：请先登录团队账号。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：请先登录团队账号。
解决方案
  1. 重新登录；从小程序进入的账号请重新打开小程序授权入口，再读取原任务状态。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:56；server/fault-alerts.cjs:29；server/web/assets/app.js:142；web/app.mjs:185；web/app.mjs:963

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-052主理人账号绑定需要处理管理员
故障代号
SWL-SYNC-052
技术键
unbound_principal
故障含义
当前主理人与团队账号的绑定缺失，或与已有账号发生冲突。
可能原因
  1. 可能触发条件（源码固定说明）：采集页包含未绑定或已停用的主理人；本页未入库。
先做检查
  1. 核对当前登录账号、启用状态、角色和授权有效期
  2. 管理员检查绑定版本；不共享密码、完整Key或签名授权链接
  3. 对照当前分支核对：采集页包含未绑定或已停用的主理人；本页未入库。
解决方案
  1. 请管理员核对小程序主理人ID和现有账号绑定，保留原账号，避免覆盖其他账号。
验证恢复
  1. 原账号重新进入后可读取本人会话和原任务
  2. 绑定归属正确，其他账号的数据没有被混入
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:179；server/chat-insights.cjs:284；server/chat-insights.cjs:52

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-013登录用户名已存在操作人
故障代号
SWL-STATE-013
技术键
username_exists
故障含义
创建或修改登录用户名时触发了唯一性冲突。
可能原因
  1. 可能：用户名已经被其他账号使用
  2. 可能：创建请求与已有账号重复
先做检查
  1. 读取已有账号并区分新建与修改
  2. 核对是否应管理原账号，而不是新建同名账号
解决方案
  1. 使用未占用的登录名，或继续管理已有账号
  2. 不要为解决登录名冲突改写来源主理人ID
验证恢复
  1. 目标账号登录名唯一，原主理人绑定仍保持不变
重试规则
先读取已有账号；不反复提交相同用户名。
处理责任
操作人
代码依据
server/app.cjs:30；server/app.cjs:137；server/app.cjs:169

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-033密码长度校验未通过操作人
故障代号
SWL-AUTH-033
技术键
weak_password
故障含义
源码以此代码拒绝以下输入或状态：密码不足6个字符或UTF-8字节数超过1024。
可能原因
  1. 可能：密码不足6个字符或UTF-8字节数超过1024。
先做检查
  1. 定位当前字段或参数：密码长度。
  2. 逐项核对：密码不足6个字符或UTF-8字节数超过1024。
  3. 该代码的固定校验说明：密码至少 6 个字符，最多 1024 字节。
解决方案
  1. 设置至少6个字符且UTF-8编码不超过1024字节的新密码。
验证恢复
  1. 密码长度通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:23

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-023操作原因尚未确认服务商
故障代号
SWL-API-023
技术键
action_failed
故障含义
系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
可能原因
  1. 可能：系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
先做检查
  1. 先读取已有任务、作品、发布或投递记录
  2. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 先读取原任务或作品状态，保留任务编号并联系管理员或服务商；不要重复提交生成或发布。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
web/app.mjs:120

具体原因需结合原任务核实。

SWL-API-036身份验证未通过操作人
故障代号
SWL-API-036
技术键
http_401
故障含义
服务器返回HTTP 401，但没有提供可确认的具体原因。
可能原因
  1. 可能：服务器返回HTTP 401，但没有提供可确认的具体原因。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先读取已有任务、作品、发布或投递记录
  3. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 重新登录并读取原任务状态；仍失败时请管理员核对账号与授权。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/fault-alerts.cjs:29

具体原因需结合原任务核实。

SWL-API-037服务器拒绝访问管理员
故障代号
SWL-API-037
技术键
http_403
故障含义
服务器返回HTTP 403，但没有提供可确认的具体权限原因。
可能原因
  1. 可能：服务器返回HTTP 403，但没有提供可确认的具体权限原因。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先读取已有任务、作品、发布或投递记录
  3. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 请管理员核对当前账号、资源权限和正式访问入口。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/fault-alerts.cjs:29

具体原因需结合原任务核实。

SWL-API-038目标暂未找到操作人
故障代号
SWL-API-038
技术键
http_404
故障含义
服务器返回HTTP 404，当前无法确认目标不存在还是当前入口不正确。
可能原因
  1. 可能：服务器返回HTTP 404，当前无法确认目标不存在还是当前入口不正确。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先读取已有任务、作品、发布或投递记录
  3. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 刷新原列表并核对账号与正式入口；仍缺失时请管理员检查原记录。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/fault-alerts.cjs:29

具体原因需结合原任务核实。

SWL-API-039当前操作存在冲突管理员
故障代号
SWL-API-039
技术键
http_409
故障含义
服务器返回HTTP 409，但冲突的具体原因尚未确认。
可能原因
  1. 可能：服务器返回HTTP 409，但冲突的具体原因尚未确认。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先读取已有任务、作品、发布或投递记录
  3. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 先读取原任务或记录并保留未保存内容；请管理员核对后再操作，勿重复生成或发布。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/fault-alerts.cjs:29

具体原因需结合原任务核实。

SWL-API-040当前请求受到限制管理员
故障代号
SWL-API-040
技术键
http_429
故障含义
服务器返回HTTP 429，具体是频率还是额度限制尚未确认。
可能原因
  1. 可能：服务器返回HTTP 429，具体是频率还是额度限制尚未确认。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先读取已有任务、作品、发布或投递记录
  3. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 等候后读取原任务状态；请管理员检查本站额度与服务商限流，勿重复提交。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
管理员
代码依据
server/fault-alerts.cjs:29

具体原因需结合原任务核实。

SWL-API-041服务器处理未完成服务商
故障代号
SWL-API-041
技术键
http_500
故障含义
服务器返回异常，但没有提供可确认的具体故障原因。
可能原因
  1. 可能：服务器返回异常，但没有提供可确认的具体故障原因。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先读取已有任务、作品、发布或投递记录
  3. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 读取原任务或记录，保留任务编号并联系管理员或服务商；勿重复生成或发布。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-API-042操作原因尚未确认服务商
故障代号
SWL-API-042
技术键
internal_error
故障含义
系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
可能原因
  1. 可能：系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
先做检查
  1. 先读取已有任务、作品、发布或投递记录
  2. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 先读取原任务或作品状态，保留任务编号并联系管理员或服务商；不要重复提交生成或发布。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/app.cjs:228；server/app.cjs:230；server/enterprise.cjs:39

具体原因需结合原任务核实。

SWL-VAL-045服务器返回格式无法解析服务商
故障代号
SWL-VAL-045
技术键
invalid_server_response
故障含义
客户端收到无法解析的服务器响应，操作结果尚未确认。
可能原因
  1. 可能：服务器或网关返回非JSON页面。
  2. 可能：响应内容被截断。
  3. 可能：接口返回格式不符合客户端解析约定。
先做检查
  1. 核对HTTP状态、时间和原任务编号
  2. 服务商检查对应接口或网关响应类型，避免暴露原始响应
解决方案
  1. 服务商修复响应格式或网关错误页
  2. 用户先读取原任务及发布记录，避免重复提交
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/enterprise.cjs:85；server/web/assets/app.js:141；server/web/assets/app.js:239；server/web/assets/app.js:800；web/app.mjs:92

具体原因需结合原任务核实。

SWL-API-051模型调用结果尚未确认管理员
故障代号
SWL-API-051
技术键
model_result_unknown
故障含义
已有模型请求的完成结果或计费状态尚未确认，任务已停止继续购买。
可能原因
  1. 可能触发条件（源码固定说明）：已有图片调用结果待核实，不会再次购买图片。
先做检查
  1. 先读取已有任务、作品、发布或投递记录
  2. 保留安全错误码、时间和任务编号，由服务商核对请求链路
  3. 对照当前分支核对：已有图片调用结果待核实，不会再次购买图片。
解决方案
  1. 仅刷新原任务状态，请管理员核对服务商请求记录和费用；不要重复生成。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
server/cloud-cards.cjs:159；server/cloud-cards.cjs:279；server/cloud-cards.cjs:423；server/cloud-cards.cjs:440；server/cloud-cards.cjs:443

具体原因需结合原任务核实。

SWL-API-052分析模型结果尚未确认管理员
故障代号
SWL-API-052
技术键
model_unknown
故障含义
本版把 model_unknown 映射到 analysis_unknown。分析的模型请求结果尚未确认，已停止自动重试。
可能原因
  1. 可能：适配器或服务商返回了此兼容错误码，进入源码中的固定映射分支
  2. 可能：分析的模型请求结果尚未确认，已停止自动重试。
先做检查
  1. 先读取已有任务、作品、发布或投递记录
  2. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 由管理员核对原模型任务与费用；仅刷新已有状态，不要重复分析。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
server/chat-insights.cjs:320

具体原因需结合原任务核实。

SWL-API-075服务器响应不完整服务商
故障代号
SWL-API-075
技术键
response_invalid
故障含义
客户端收到的响应缺少继续操作所需的信息；服务器是否已经完成处理尚未确认。
可能原因
  1. 可能：客户端收到的响应缺少继续操作所需的信息；服务器是否已经完成处理尚未确认。
先做检查
  1. 先读取已有任务、作品、发布或投递记录
  2. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 刷新原任务、作品或发布记录核对结果；仍不完整时联系服务商，勿重复提交。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
web/app.mjs:389；web/app.mjs:484；web/app.mjs:743；web/app.mjs:794；web/app.mjs:831

具体原因需结合原任务核实。

SWL-API-078提交结果尚未确认管理员
故障代号
SWL-API-078
技术键
submission_unconfirmed
故障含义
客户端尚未确认本次提交是否已经保存，原请求可能已经处理。
可能原因
  1. 可能：客户端尚未确认本次提交是否已经保存，原请求可能已经处理。
先做检查
  1. 先读取已有任务、作品、发布或投递记录
  2. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 读取原任务、作品或发布记录，请管理员核对原请求；不要重复生成或发布。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
web/app.mjs:765；web/app.mjs:887

具体原因需结合原任务核实。

SWL-API-080操作原因尚未确认服务商
故障代号
SWL-API-080
技术键
unknown_error
故障含义
系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
可能原因
  1. 可能：系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
先做检查
  1. 先读取已有任务、作品、发布或投递记录
  2. 保留安全错误码、时间和任务编号，由服务商核对请求链路
解决方案
  1. 先读取原任务或作品状态，保留任务编号并联系管理员或服务商；不要重复提交生成或发布。
验证恢复
  1. 原请求是否处理已有明确结论
  2. 页面可正常读取状态；没有重复生成、发布或发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；web/app.mjs:101；web/app.mjs:103；web/app.mjs:105；web/app.mjs:109

具体原因需结合原任务核实。

SWL-VAL-060请求字段白名单校验未通过操作人
故障代号
SWL-VAL-060
技术键
unknown_field
故障含义
源码以此代码拒绝以下输入或状态：请求中含接口白名单以外的字段。
可能原因
  1. 可能：请求中含接口白名单以外的字段。
先做检查
  1. 定位当前字段或参数：请求字段白名单。
  2. 逐项核对：请求中含接口白名单以外的字段。
  3. 该代码的固定校验说明：请求含有不支持的字段。
解决方案
  1. 仅保留该接口白名单允许的字段，不把其他接口参数直接混入。
验证恢复
  1. 请求字段白名单通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:20

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-NET-001采集地址解析超过时限服务商
故障代号
SWL-NET-001
技术键
address_timeout
故障含义
采集前验证服务地址的域名解析或公网地址检查超过了配置时限。
可能原因
  1. 可能：DNS查询没有在时限内返回
  2. 可能：服务器网络或DNS服务响应迟缓
先做检查
  1. 核对该次采集是否停在地址验证阶段、是否尚未到达来源传输
  2. 检查服务器DNS响应和来源域名解析，不提交或展示鉴权令牌
解决方案
  1. 恢复服务器DNS或网络；保留原采集断点后再处理原采集任务
验证恢复
  1. 地址验证能在时限内完成；断点没有被失败的查询推进
重试规则
地址验证失败不会自动购买模型调用；先修复连接，再从原断点采集。
处理责任
服务商
代码依据
server/chat-insights.cjs:138

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-001分析结果未通过结构检查管理员
故障代号
SWL-SYNC-001
技术键
analysis_invalid
故障含义
模型分析结果没有满足结构检查要求，原始统计已保留。
可能原因
  1. 可能触发条件（源码固定说明）：模型输出未通过结构检查，已保留原始统计且不会重复扣费。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：模型输出未通过结构检查，已保留原始统计且不会重复扣费。
解决方案
  1. 请管理员检查原模型结果及分析结构规则；优先使用原统计恢复，不要重复购买模型调用。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:307；server/chat-insights.cjs:309；server/chat-insights.cjs:320；server/chat-insights.cjs:52

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-002分析任务不能直接继续管理员
故障代号
SWL-SYNC-002
技术键
analysis_not_resumable
故障含义
当前分析任务状态或保存的账号绑定已经不满足继续条件。
可能原因
  1. 可能触发条件（源码固定说明）：仅模型未配置或额度不足的阻塞任务可继续；未知结果不可自动重发。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：仅模型未配置或额度不足的阻塞任务可继续；未知结果不可自动重发。
解决方案
  1. 请管理员核对原任务、当前绑定与统计版本；结果不明时先核实，勿盲目重复分析。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:327

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-003分析任务不能直接继续管理员
故障代号
SWL-SYNC-003
技术键
analysis_stale
故障含义
当前分析任务状态或保存的账号绑定已经不满足继续条件。
可能原因
  1. 可能触发条件（源码固定说明）：绑定或统计已经变化，请重新完成采集以生成当前分析。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：绑定或统计已经变化，请重新完成采集以生成当前分析。
解决方案
  1. 请管理员核对原任务、当前绑定与统计版本；结果不明时先核实，勿盲目重复分析。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:328

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-004分析前置条件未满足管理员
故障代号
SWL-SYNC-004
技术键
analysis_unavailable
故障含义
分析前的模型配置、账号状态或调用额度条件没有满足；具体项目需要管理员核对。
可能原因
  1. 可能触发条件（源码固定说明）：模型未配置或额度不足；已保留统计，可在配置后继续。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：模型未配置或额度不足；已保留统计，可在配置后继续。
解决方案
  1. 请管理员检查账号、模型配置和额度，原统计会保留；确认后再继续原分析任务。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:316；server/chat-insights.cjs:320；server/chat-insights.cjs:52

具体原因需结合原任务核实。

SWL-SYNC-005分析模型结果尚未确认管理员
故障代号
SWL-SYNC-005
技术键
analysis_unknown
故障含义
分析的模型请求结果尚未确认，已停止自动重试。
可能原因
  1. 可能触发条件（源码固定说明）：模型调用结果尚未确认，已停止自动重试；请核对模型任务。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：模型调用结果尚未确认，已停止自动重试；请核对模型任务。
解决方案
  1. 由管理员核对原模型任务与费用；仅刷新已有状态，不要重复分析。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:320；server/chat-insights.cjs:52

具体原因需结合原任务核实。

SWL-SYNC-006服务正在停止或维护服务商
故障代号
SWL-SYNC-006
技术键
builtin_closed
故障含义
当前服务正在停止，无法继续接受这项处理。
可能原因
  1. 可能触发条件（源码固定说明）：素材采集服务已停止。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：素材采集服务已停止。
解决方案
  1. 等待服务恢复并读取原任务状态；请服务商确认已有任务，勿重复购买模型调用。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
服务商
代码依据
server/builtin-materials.cjs:193；server/builtin-materials.cjs:205；server/builtin-materials.cjs:216

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-007资料服务暂未提供可用结果服务商
故障代号
SWL-SYNC-007
技术键
builtin_unavailable
故障含义
资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：内置素材服务暂不可用。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：内置素材服务暂不可用。
解决方案
  1. 请管理员核对资料服务和原采集任务状态；创作时可在确认后手动提供参考资料。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/material-search.cjs:40

具体原因需结合原任务核实。

SWL-SYNC-008来源数据没有通过校验服务商
故障代号
SWL-SYNC-008
技术键
ilinkai_cursor_changed
故障含义
来源返回的数据结构、分页游标或统计完整性没有通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：采集中的历史列表发生变化，已保留断点；请管理员核对后重试。
  2. 可能触发条件（源码固定说明）：已采集消息的顺序或内容发生变化，未跳过未核验的数据，断点已保留。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：采集中的历史列表发生变化，已保留断点；请管理员核对后重试。
  4. 对照当前分支核对：已采集消息的顺序或内容发生变化，未跳过未核验的数据，断点已保留。
解决方案
  1. 请管理员与来源服务商核对接口结构、分页和统计；保留原游标及同步记录，不要跳过缺失数据。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:192

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-009聊天资料接口不存在服务商
故障代号
SWL-SYNC-009
技术键
ilinkai_endpoint_not_found
故障含义
上游文档指定的聊天接口返回HTTP 404，未采集或分析聊天，原断点已保留。
可能原因
  1. 可能触发条件（源码固定说明）：文档聊天接口返回 404，请上游确认路径；没有采集或分析聊天，断点已保留。
  2. 可能触发条件（源码固定说明）：聊天接口返回 404，原有采集断点已保留。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：文档聊天接口返回 404，请上游确认路径；没有采集或分析聊天，断点已保留。
  4. 对照当前分支核对：聊天接口返回 404，原有采集断点已保留。
解决方案
  1. 请管理员协调资料服务商确认正式接口路径；确认前不要更换未经验证的路径。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:158

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-010来源数据没有通过校验服务商
故障代号
SWL-SYNC-010
技术键
ilinkai_incomplete_response
故障含义
来源返回的数据结构、分页游标或统计完整性没有通过检查。
可能原因
  1. 可能：上游count与实际列表条数不一致。
  2. 可能：上游分页方式尚未明确或没有返回完整页面。
先做检查
  1. 比较响应总数、实际条数与分页约定
  2. 核对是否有未返回的聊天记录
解决方案
  1. 来源服务方明确并修正完整分页
  2. 保留原断点，禁止把不完整数据标记采集完成
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:30

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-011来源数据没有通过校验服务商
故障代号
SWL-SYNC-011
技术键
ilinkai_invalid_cursor
故障含义
来源返回的数据结构、分页游标或统计完整性没有通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：采集断点格式无效，请管理员核对，未修改原有断点。
  2. 可能触发条件（源码固定说明）：聊天采集断点无效或不属于当前主理人，未修改原有断点。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：采集断点格式无效，请管理员核对，未修改原有断点。
  4. 对照当前分支核对：聊天采集断点无效或不属于当前主理人，未修改原有断点。
解决方案
  1. 请管理员与来源服务商核对接口结构、分页和统计；保留原游标及同步记录，不要跳过缺失数据。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:39

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-012来源数据没有通过校验服务商
故障代号
SWL-SYNC-012
技术键
ilinkai_invalid_response
故障含义
来源返回的数据结构、分页游标或统计完整性没有通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：聊天接口未返回有效且受限的 JSON，未保存原始响应。
  2. 可能触发条件（源码固定说明）：聊天接口字段无效；没有提交本页或修改原有断点。
  3. 可能触发条件（源码固定说明）：采集游标格式无效，未修改原有断点。
  4. 可能触发条件（源码固定说明）：聊天接口没有返回有效且受限的 JSON，未保存原始响应。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：聊天接口未返回有效且受限的 JSON，未保存原始响应。
  4. 对照当前分支核对：聊天接口字段无效；没有提交本页或修改原有断点。
  5. 对照当前分支核对：采集游标格式无效，未修改原有断点。
  6. 对照当前分支核对：聊天接口没有返回有效且受限的 JSON，未保存原始响应。
解决方案
  1. 请管理员与来源服务商核对接口结构、分页和统计；保留原游标及同步记录，不要跳过缺失数据。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:16；server/ilinkai-chat-source.cjs:79；server/ilinkai-chat-source.cjs:81

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-013资料或同步来源尚未配置管理员
故障代号
SWL-SYNC-013
技术键
ilinkai_invalid_source
故障含义
当前资料来源、授权方式或凭证验证配置不满足采集要求。
可能原因
  1. 可能触发条件（源码固定说明）：聊天来源须使用文档中的固定 HTTPS 接口地址。
  2. 可能触发条件（源码固定说明）：聊天来源须使用已确认的固定 HTTPS 接口地址。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：聊天来源须使用文档中的固定 HTTPS 接口地址。
  4. 对照当前分支核对：聊天来源须使用已确认的固定 HTTPS 接口地址。
解决方案
  1. 请管理员检查来源地址、授权方式、凭证提供方和启用状态。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/ilinkai-chat-source.cjs:12；server/ilinkai-chat-source.cjs:13

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-009资料或同步来源尚未配置管理员
故障代号
SWL-AUTH-009
技术键
ilinkai_invalid_source_auth
故障含义
当前资料来源、授权方式或凭证验证配置不满足采集要求。
可能原因
  1. 可能触发条件（源码固定说明）：聊天采集授权方式无效。
  2. 可能触发条件（源码固定说明）：聊天采集鉴权模式无效。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：聊天采集授权方式无效。
  4. 对照当前分支核对：聊天采集鉴权模式无效。
解决方案
  1. 请管理员检查来源地址、授权方式、凭证提供方和启用状态。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:106

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-014来源数据归属不匹配管理员
故障代号
SWL-SYNC-014
技术键
ilinkai_ownership_mismatch
故障含义
来源返回的数据归属与当前主理人绑定不一致。
可能原因
  1. 可能：会话归属与已授权主理人不一致。
  2. 可能：消息发送方或父会话身份不能匹配当前授权范围。
先做检查
  1. 核对当前绑定主理人、会话归属及消息身份
  2. 确认返回数据没有跨越其他主理人授权
解决方案
  1. 管理员与来源服务商修正归属映射
  2. 保留原断点；修复前不继续采集或分析
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:183；server/ilinkai-chat-source.cjs:187

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-010资料来源授权未通过管理员
故障代号
SWL-AUTH-010
技术键
ilinkai_principal_authorization_required
故障含义
当前资料来源的授权没有通过身份、时效或配置版本校验。
可能原因
  1. 可能触发条件（源码固定说明）：暂无有效的主理人数据授权，请主理人从小程序重新进入工作台。
  2. 可能触发条件（源码固定说明）：尚无启用且持有效数据令牌的主理人，请从小程序进入重新授权。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：暂无有效的主理人数据授权，请主理人从小程序重新进入工作台。
  4. 对照当前分支核对：尚无启用且持有效数据令牌的主理人，请从小程序进入重新授权。
解决方案
  1. 请管理员更新来源授权并验证权限；主理人专属授权需要从原入口重新授权。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:128

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-015来源数据归属不匹配管理员
故障代号
SWL-SYNC-015
技术键
ilinkai_principal_not_bound
故障含义
来源返回的数据归属与当前主理人绑定不一致。
可能原因
  1. 可能触发条件（源码固定说明）：鉴权包主理人尚未关联启用的账号，未请求其他成员聊天。
  2. 可能触发条件（源码固定说明）：当前主理人绑定已停用或移除，未提交本页聊天。
  3. 可能触发条件（源码固定说明）：鉴权包主理人尚未关联启用的账号，未请求其他成员的聊天。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：鉴权包主理人尚未关联启用的账号，未请求其他成员聊天。
  4. 对照当前分支核对：当前主理人绑定已停用或移除，未提交本页聊天。
  5. 对照当前分支核对：鉴权包主理人尚未关联启用的账号，未请求其他成员的聊天。
解决方案
  1. 请管理员与来源服务商核对主理人ID及归属映射；修复前停止同步，不要跳过归属检查。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:131；server/ilinkai-chat-source.cjs:133

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-016主理人授权范围不符合要求管理员
故障代号
SWL-SYNC-016
技术键
ilinkai_principal_scope_invalid
故障含义
提供的主理人授权范围无效或超过允许数量，采集没有继续。
可能原因
  1. 可能触发条件（源码固定说明）：主理人授权范围无效，未请求聊天数据。
  2. 可能触发条件（源码固定说明）：启用的主理人绑定列表无效，未请求聊天接口。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：主理人授权范围无效，未请求聊天数据。
  4. 对照当前分支核对：启用的主理人绑定列表无效，未请求聊天接口。
解决方案
  1. 请管理员核对授权主理人列表和数量，修复后处理原采集任务。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:78；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:116；server/ilinkai-chat-source.cjs:121

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-017主理人授权范围不符合要求管理员
故障代号
SWL-SYNC-017
技术键
ilinkai_principal_scope_limit
故障含义
提供的主理人授权范围无效或超过允许数量，采集没有继续。
可能原因
  1. 可能触发条件（源码固定说明）：本轮主理人授权数量超过上限，已停止采集。
  2. 可能触发条件（源码固定说明）：启用的主理人超过单个采集源的 200 人上限，未请求聊天接口。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：本轮主理人授权数量超过上限，已停止采集。
  4. 对照当前分支核对：启用的主理人超过单个采集源的 200 人上限，未请求聊天接口。
解决方案
  1. 请管理员核对授权主理人列表和数量，修复后处理原采集任务。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:122

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-018资料来源授权已过期管理员
故障代号
SWL-SYNC-018
技术键
ilinkai_principal_token_expired
故障含义
原资料来源授权已经超过有效期。
可能原因
  1. 可能触发条件（源码固定说明）：此主理人数据授权已过期，请从小程序重新进入工作台。
  2. 可能触发条件（源码固定说明）：当前主理人的数据令牌已过期，请从小程序重新授权。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：此主理人数据授权已过期，请从小程序重新进入工作台。
  4. 对照当前分支核对：当前主理人的数据令牌已过期，请从小程序重新授权。
解决方案
  1. 请从小程序重新获取有效授权，由管理员验证后继续原采集；不会自动重试分析。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:143

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-019资料来源授权未通过管理员
故障代号
SWL-SYNC-019
技术键
ilinkai_principal_token_invalid
故障含义
当前资料来源的授权没有通过身份、时效或配置版本校验。
可能原因
  1. 可能触发条件（源码固定说明）：主理人凭证或身份校验未通过，未提交本页采集结果。
  2. 可能触发条件（源码固定说明）：主理人数据令牌身份无效，未请求聊天接口。
  3. 可能触发条件（源码固定说明）：主理人数据令牌身份或格式无效，未请求聊天接口。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：主理人凭证或身份校验未通过，未提交本页采集结果。
  4. 对照当前分支核对：主理人数据令牌身份无效，未请求聊天接口。
  5. 对照当前分支核对：主理人数据令牌身份或格式无效，未请求聊天接口。
解决方案
  1. 请管理员更新来源授权并验证权限；主理人专属授权需要从原入口重新授权。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:141；server/ilinkai-chat-source.cjs:142

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-020资料或同步来源尚未配置管理员
故障代号
SWL-SYNC-020
技术键
ilinkai_principal_token_provider_unavailable
故障含义
当前资料来源、授权方式或凭证验证配置不满足采集要求。
可能原因
  1. 可能触发条件（源码固定说明）：主理人数据授权服务尚未接入，未请求聊天数据。
  2. 可能触发条件（源码固定说明）：主理人数据令牌尚未接入，未请求聊天接口。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：主理人数据授权服务尚未接入，未请求聊天数据。
  4. 对照当前分支核对：主理人数据令牌尚未接入，未请求聊天接口。
解决方案
  1. 请管理员检查来源地址、授权方式、凭证提供方和启用状态。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
明确拒绝后先修复对应API账号或内容；原任务不会自动改用其他账号或重新购买。后续新创作由操作人确认。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:136

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-021资料来源授权未通过管理员
故障代号
SWL-SYNC-021
技术键
ilinkai_principal_token_unavailable
故障含义
当前资料来源的授权没有通过身份、时效或配置版本校验。
可能原因
  1. 可能触发条件（源码固定说明）：此主理人数据授权已失效，请从小程序重新进入工作台。
  2. 可能触发条件（源码固定说明）：当前主理人的数据令牌不可用，请从小程序重新授权。
  3. 可能触发条件（源码固定说明）：当前主理人尚未提供有效数据令牌，请从小程序重新授权。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：此主理人数据授权已失效，请从小程序重新进入工作台。
  4. 对照当前分支核对：当前主理人的数据令牌不可用，请从小程序重新授权。
  5. 对照当前分支核对：当前主理人尚未提供有效数据令牌，请从小程序重新授权。
解决方案
  1. 请管理员更新来源授权并验证权限；主理人专属授权需要从原入口重新授权。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:139；server/ilinkai-chat-source.cjs:140

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-022来源数据没有通过校验服务商
故障代号
SWL-SYNC-022
技术键
ilinkai_schema_unconfirmed
故障含义
来源返回的数据结构、分页游标或统计完整性没有通过检查。
可能原因
  1. 可能：上游JSON包结构与文档契约不一致。
  2. 可能：返回记录缺少确定的归属或分页字段。
先做检查
  1. 核对文档约定的包结构、归属与分页
  2. 确认未把未知JSON当作空列表成功
解决方案
  1. 管理员与来源方先确认契约，再修正适配或上游返回
  2. 确认前保留断点且不分析聊天
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:29

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-023服务正在停止或维护服务商
故障代号
SWL-SYNC-023
技术键
ilinkai_source_closed
故障含义
当前服务正在停止，无法继续接受这项处理。
可能原因
  1. 可能触发条件（源码固定说明）：聊天采集服务正在停止。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：聊天采集服务正在停止。
解决方案
  1. 等待服务恢复并读取原任务状态；请服务商确认已有任务，勿重复购买模型调用。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
服务商
代码依据
server/ilinkai-chat-source.cjs:104；server/ilinkai-chat-source.cjs:157；server/ilinkai-chat-source.cjs:213

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-024资料服务暂未提供可用结果服务商
故障代号
SWL-SYNC-024
技术键
ilinkai_source_failed
故障含义
资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：聊天接口暂不可用，原有采集断点已保留。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：聊天接口暂不可用，原有采集断点已保留。
解决方案
  1. 请管理员核对资料服务和原采集任务状态；创作时可在确认后手动提供参考资料。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:160

具体原因需结合原任务核实。

SWL-SYNC-025聊天资料接口读取超时服务商
故障代号
SWL-SYNC-025
技术键
ilinkai_source_timeout
故障含义
资料接口读取超过允许时间，已保留原采集断点。
可能原因
  1. 可能触发条件（源码固定说明）：聊天接口读取超时，原有断点已保留。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：聊天接口读取超时，原有断点已保留。
解决方案
  1. 请管理员协调资料服务商检查响应时间；先读取原采集状态，不要重复发起分析。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:188；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:69；server/ilinkai-chat-source.cjs:110

具体原因需结合原任务核实。

SWL-SYNC-026资料来源授权已过期管理员
故障代号
SWL-SYNC-026
技术键
ilinkai_source_token_expired
故障含义
原资料来源授权已经超过有效期。
可能原因
  1. 可能触发条件（源码固定说明）：接口诊断令牌已过期，请重新提供有效鉴权包；不会自动重试分析。
  2. 可能触发条件（源码固定说明）：已保存的接口诊断令牌已过期，请重新提供有效鉴权包。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：接口诊断令牌已过期，请重新提供有效鉴权包；不会自动重试分析。
  4. 对照当前分支核对：已保存的接口诊断令牌已过期，请重新提供有效鉴权包。
解决方案
  1. 请从小程序重新获取有效授权，由管理员验证后继续原采集；不会自动重试分析。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:93

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-027资料来源授权未通过管理员
故障代号
SWL-SYNC-027
技术键
ilinkai_source_token_invalid
故障含义
当前资料来源的授权没有通过身份、时效或配置版本校验。
可能原因
  1. 可能触发条件（源码固定说明）：接口诊断令牌未通过小程序签名或时效校验，请重新提供鉴权包。
  2. 可能触发条件（源码固定说明）：接口诊断令牌未通过小程序签名或时效校验。
  3. 可能触发条件（源码固定说明）：接口诊断令牌未通过身份校验。
  4. 可能触发条件（源码固定说明）：接口诊断令牌未通过时效或配置校验。
  5. 可能触发条件（源码固定说明）：接口诊断令牌格式无效。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：接口诊断令牌未通过小程序签名或时效校验，请重新提供鉴权包。
  4. 对照当前分支核对：接口诊断令牌未通过小程序签名或时效校验。
  5. 对照当前分支核对：接口诊断令牌未通过身份校验。
  6. 对照当前分支核对：接口诊断令牌未通过时效或配置校验。
  7. 对照当前分支核对：接口诊断令牌格式无效。
解决方案
  1. 请管理员更新来源授权并验证权限；主理人专属授权需要从原入口重新授权。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:158；server/chat-insights.cjs:159；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:96

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-028资料或同步来源尚未配置管理员
故障代号
SWL-SYNC-028
技术键
ilinkai_source_token_missing
故障含义
当前资料来源、授权方式或凭证验证配置不满足采集要求。
可能原因
  1. 可能触发条件（源码固定说明）：尚未保存聊天接口诊断令牌，接口令牌待上游确认。
  2. 可能触发条件（源码固定说明）：尚未保存聊天接口诊断令牌。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：尚未保存聊天接口诊断令牌，接口令牌待上游确认。
  4. 对照当前分支核对：尚未保存聊天接口诊断令牌。
解决方案
  1. 请管理员检查来源地址、授权方式、凭证提供方和启用状态。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:91

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-011资料服务拒绝了主理人授权管理员
故障代号
SWL-AUTH-011
技术键
ilinkai_source_unauthorized
故障含义
上游资料服务没有接受此主理人的授权，本页采集结果没有提交。
可能原因
  1. 可能：上游拒绝了该主理人的Bearer授权。
  2. 可能：对应数据授权已不被上游接受。
先做检查
  1. 核对原主理人的数据授权有效性与绑定
  2. 确认401/403来自来源接口而非本站登录接口
解决方案
  1. 主理人从小程序重新取得授权
  2. 管理员协调来源方恢复正确数据权限，保留原断点
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:159

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-029资料来源授权未通过管理员
故障代号
SWL-SYNC-029
技术键
ilinkai_source_verification_changed
故障含义
当前资料来源的授权没有通过身份、时效或配置版本校验。
可能原因
  1. 可能触发条件（源码固定说明）：鉴权配置或主理人身份已变化，请重新校验并保存接口令牌。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：鉴权配置或主理人身份已变化，请重新校验并保存接口令牌。
解决方案
  1. 请管理员更新来源授权并验证权限；主理人专属授权需要从原入口重新授权。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:100

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-030资料或同步来源尚未配置管理员
故障代号
SWL-SYNC-030
技术键
ilinkai_source_verifier_unavailable
故障含义
当前资料来源、授权方式或凭证验证配置不满足采集要求。
可能原因
  1. 可能触发条件（源码固定说明）：小程序签名校验尚未接入，不能使用此接口令牌。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：小程序签名校验尚未接入，不能使用此接口令牌。
解决方案
  1. 请管理员检查来源地址、授权方式、凭证提供方和启用状态。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:76；server/chat-insights.cjs:155；server/chat-insights.cjs:52；server/ilinkai-chat-source.cjs:92

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-031已有任务正在处理操作人
故障代号
SWL-SYNC-031
技术键
insights_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：采集进行中，请完成后再修改接口。
  2. 可能触发条件（源码固定说明）：已有采集任务运行中。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：采集进行中，请完成后再修改接口。
  4. 对照当前分支核对：已有采集任务运行中。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/chat-insights.cjs:166；server/chat-insights.cjs:204

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-032资料服务暂未提供可用结果服务商
故障代号
SWL-SYNC-032
技术键
insights_invalid_response
故障含义
资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
可能原因
  1. 可能：资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 核对原采集任务、主理人绑定与授权范围
  3. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
解决方案
  1. 请管理员核对资料服务和原采集任务状态；创作时可在确认后手动提供参考资料。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-SYNC-033模型返回内容不符合要求管理员
故障代号
SWL-SYNC-033
技术键
insights_model_failed
故障含义
已收到的模型内容没有通过当前业务需要的结构或内容校验。
可能原因
  1. 可能触发条件（源码固定说明）：模型任务失败或结果已过期，请管理员检查任务记录。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：模型任务失败或结果已过期，请管理员检查任务记录。
解决方案
  1. 请管理员检查原任务保存的结果和输出规则；结果已保留时优先修复，不要自动重复调用模型。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/insights-services.cjs:66

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-034分析模型结果尚未确认管理员
故障代号
SWL-SYNC-034
技术键
insights_model_unknown
故障含义
本版把 insights_model_unknown 映射到 analysis_unknown。分析的模型请求结果尚未确认，已停止自动重试。
可能原因
  1. 可能触发条件（源码固定说明）：模型任务结果尚未确认。
  2. 可能触发条件（源码固定说明）：模型调用结果不明，请管理员核实，不会自动重发。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：模型任务结果尚未确认。
  4. 对照当前分支核对：模型调用结果不明，请管理员核实，不会自动重发。
解决方案
  1. 由管理员核对原模型任务与费用；仅刷新已有状态，不要重复分析。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
server/insights-services.cjs:61；server/insights-services.cjs:65

具体原因需结合原任务核实。

SWL-SYNC-035资料服务暂未提供可用结果服务商
故障代号
SWL-SYNC-035
技术键
insights_unavailable
故障含义
资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
可能原因
  1. 可能：资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 核对原采集任务、主理人绑定与授权范围
  3. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
解决方案
  1. 请管理员核对资料服务和原采集任务状态；创作时可在确认后手动提供参考资料。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-SYNC-036模型返回内容不符合要求管理员
故障代号
SWL-SYNC-036
技术键
invalid_insights_output
故障含义
已收到的模型内容没有通过当前业务需要的结构或内容校验。
可能原因
  1. 可能触发条件（源码固定说明）：模型分析未通过结构校验，已保留本次任务，不会重新付费调用。
  2. 可能触发条件（源码固定说明）：模型选题方向格式无效。
  3. 可能触发条件（源码固定说明）：模型返回了统计中不存在的话题或过多检索词。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：模型分析未通过结构校验，已保留本次任务，不会重新付费调用。
  4. 对照当前分支核对：模型选题方向格式无效。
  5. 对照当前分支核对：模型返回了统计中不存在的话题或过多检索词。
解决方案
  1. 请管理员检查原任务保存的结果和输出规则；结果已保留时优先修复，不要自动重复调用模型。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/insights-services.cjs:34；server/insights-services.cjs:37；server/insights-services.cjs:41

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-037资料检索模式校验未通过操作人
故障代号
SWL-SYNC-037
技术键
invalid_material_mode
故障含义
源码以此代码拒绝以下输入或状态：资料检索方式不是该接口允许的模式。
可能原因
  1. 可能：资料检索方式不是该接口允许的模式。
先做检查
  1. 定位当前字段或参数：资料检索模式。
  2. 逐项核对：资料检索方式不是该接口允许的模式。
  3. 该代码的固定校验说明：素材检索方式无效。
解决方案
  1. 使用当前资料检索接口允许的模式，不提交自定义未知模式。
验证恢复
  1. 资料检索模式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/material-search.cjs:34

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-016聊天授权方式校验未通过管理员
故障代号
SWL-AUTH-016
技术键
invalid_source_auth_mode
故障含义
源码以此代码拒绝以下输入或状态：聊天来源授权方式不是jwt或principal_tokens。
可能原因
  1. 可能：聊天来源授权方式不是jwt或principal_tokens。
先做检查
  1. 定位当前字段或参数：聊天授权方式。
  2. 逐项核对：聊天来源授权方式不是jwt或principal_tokens。
  3. 该代码的固定校验说明：聊天采集授权方式无效。
解决方案
  1. 将来源授权方式设为jwt或principal_tokens，并配置对应授权提供方。
验证恢复
  1. 聊天授权方式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
管理员
代码依据
server/chat-insights.cjs:144

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-046采集页格式未通过检查服务商
故障代号
SWL-VAL-046
技术键
invalid_source_page
故障含义
资料接口返回的本页格式无效，本页没有入库，采集游标没有前进。
可能原因
  1. 可能：messages不是数组或超过每页上限。
  2. 可能：role不在user/assistant中。
  3. 可能：createdAt无效或越过采集时间边界。
  4. 可能：分页字段、游标或主理人元数据不符合契约。
  5. 可能：同一消息标识的内容发生冲突。
先做检查
  1. 来源方对照本版页结构逐字段核对，保留原游标
  2. 确认失败页未入库且原始计数和归属一致
解决方案
  1. 来源服务方修正该页字段、角色、时间和分页约定
  2. 管理员从原断点重新读取，不跳过失败页或购买分析
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:174；server/chat-insights.cjs:175；server/chat-insights.cjs:197；server/chat-insights.cjs:228

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-047聊天来源类型校验未通过管理员
故障代号
SWL-VAL-047
技术键
invalid_source_type
故障含义
源码以此代码拒绝以下输入或状态：聊天来源类型不是standard或ilinkai。
可能原因
  1. 可能：聊天来源类型不是standard或ilinkai。
先做检查
  1. 定位当前字段或参数：聊天来源类型。
  2. 逐项核对：聊天来源类型不是standard或ilinkai。
  3. 该代码的固定校验说明：聊天来源类型无效。
解决方案
  1. 将来源类型设为standard或ilinkai，并同时核对对应接口地址。
验证恢复
  1. 聊天来源类型通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
管理员
代码依据
server/chat-insights.cjs:143

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-038已有任务正在处理操作人
故障代号
SWL-SYNC-038
技术键
material_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：素材检索繁忙，请稍后再试。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：素材检索繁忙，请稍后再试。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/material-search.cjs:41

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-039服务正在停止或维护服务商
故障代号
SWL-SYNC-039
技术键
material_closed
故障含义
当前服务正在停止，无法继续接受这项处理。
可能原因
  1. 可能触发条件（源码固定说明）：素材服务正在停止。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：素材服务正在停止。
解决方案
  1. 等待服务恢复并读取原任务状态；请服务商确认已有任务，勿重复购买模型调用。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
服务商
代码依据
server/material-search.cjs:48

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-040资料服务暂未提供可用结果服务商
故障代号
SWL-SYNC-040
技术键
material_invalid_response
故障含义
资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：内置素材未返回有效来源，未发起模型调用。
  2. 可能触发条件（源码固定说明）：内置资料来源地址无效。
  3. 可能触发条件（源码固定说明）：内置资料来源格式无效。
  4. 可能触发条件（源码固定说明）：素材接口未返回有效结果，请管理员检查接口格式。
  5. 可能触发条件（源码固定说明）：资料来源地址无效。
  6. 可能触发条件（源码固定说明）：资料来源须为公网 HTTPS 链接。
  7. 可能触发条件（源码固定说明）：资料时间格式无效。
  8. 可能触发条件（源码固定说明）：素材接口返回了敏感配置，已阻止展示。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：内置素材未返回有效来源，未发起模型调用。
  4. 对照当前分支核对：内置资料来源地址无效。
  5. 对照当前分支核对：内置资料来源格式无效。
  6. 对照当前分支核对：素材接口未返回有效结果，请管理员检查接口格式。
  7. 对照当前分支核对：资料来源地址无效。
  8. 对照当前分支核对：资料来源须为公网 HTTPS 链接。
解决方案
  1. 请管理员核对资料服务和原采集任务状态；创作时可在确认后手动提供参考资料。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
server/cloud-cards.cjs:292；server/cloud-cards.cjs:295；server/cloud-cards.cjs:296；server/material-search.cjs:57；server/material-search.cjs:63

具体原因需结合原任务核实。

SWL-SYNC-041资料服务暂未提供可用结果服务商
故障代号
SWL-SYNC-041
技术键
material_unavailable
故障含义
资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：素材接口连接失败或超时，请稍后重试。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：素材接口连接失败或超时，请稍后重试。
解决方案
  1. 请管理员核对资料服务和原采集任务状态；创作时可在确认后手动提供参考资料。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/material-search.cjs:76

具体原因需结合原任务核实。

SWL-SYNC-048资料接口约定尚未确认管理员
故障代号
SWL-SYNC-048
技术键
source_contract_unconfirmed
故障含义
当前资料来源的接口结构与归属约定尚未完成确认。
可能原因
  1. 可能：当前资料来源的接口结构与归属约定尚未完成确认。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
解决方案
  1. 请管理员与资料服务方确认来源接口、数据结构和主理人归属后再启用采集。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
web/app.mjs:540

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-049资料服务暂未提供可用结果服务商
故障代号
SWL-SYNC-049
技术键
source_failed
故障含义
资料或洞察服务没有返回当前操作需要的有效结果；具体服务原因尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：采集接口暂不可用；已提交的分页游标会保留。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：采集接口暂不可用；已提交的分页游标会保留。
解决方案
  1. 请管理员核对资料服务和原采集任务状态；创作时可在确认后手动提供参考资料。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:188；server/chat-insights.cjs:196；server/chat-insights.cjs:284；server/chat-insights.cjs:52

具体原因需结合原任务核实。

SWL-SYNC-050本轮采集达到上限管理员
故障代号
SWL-SYNC-050
技术键
source_limit
故障含义
本轮采集达到允许的页数或条数上限，已保留完成分页及断点。
可能原因
  1. 可能触发条件（源码固定说明）：本次达到采集上限，游标已保留，下次从断点继续。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：本次达到采集上限，游标已保留，下次从断点继续。
解决方案
  1. 等候下一轮从保存断点继续；如持续达到上限，请管理员核对采集范围。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:282；server/chat-insights.cjs:52

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-SYNC-051资料或同步来源尚未配置管理员
故障代号
SWL-SYNC-051
技术键
source_not_configured
故障含义
当前资料来源、授权方式或凭证验证配置不满足采集要求。
可能原因
  1. 可能触发条件（源码固定说明）：采集地址尚未配置。
  2. 可能触发条件（源码固定说明）：管理员尚未配置指定的素材接口，请使用默认内置采集与搜索。
先做检查
  1. 核对原采集任务、主理人绑定与授权范围
  2. 检查分页游标、原始计数和安全结构校验结果；不提交原始访客聊天或授权令牌
  3. 对照当前分支核对：采集地址尚未配置。
  4. 对照当前分支核对：管理员尚未配置指定的素材接口，请使用默认内置采集与搜索。
解决方案
  1. 请管理员检查来源地址、授权方式、凭证提供方和启用状态。
验证恢复
  1. 归属和分页校验通过，失败页面没有被跳过
  2. 原统计/断点得到保留，分析没有重复计费
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:203；server/chat-insights.cjs:52；server/material-search.cjs:39；web/app.mjs:543

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-001没有此操作权限管理员
故障代号
SWL-VAL-001
技术键
admin_delete_forbidden
故障含义
服务器拒绝了当前账号对这项资源的操作权限。
可能原因
  1. 可能触发条件（源码固定说明）：仅可删除主理人账号，管理员账号不能删除。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：仅可删除主理人账号，管理员账号不能删除。
解决方案
  1. 使用有权限的账号，或请管理员核对权限；不要尝试操作其他人的资源。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:147

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-026已有记录与本次提交冲突管理员
故障代号
SWL-API-026
技术键
canonical_record
故障含义
服务器已有同一标识或作品关联的其他内容记录。
可能原因
  1. 可能触发条件（源码固定说明）：企业发布记录由作品发布流程维护，请在作品中登记链接。
  2. 可能触发条件（源码固定说明）：此编号已用于作品，发布记录由作品发布流程维护。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：企业发布记录由作品发布流程维护，请在作品中登记链接。
  4. 对照当前分支核对：此编号已用于作品，发布记录由作品发布流程维护。
解决方案
  1. 先读取已有记录，由管理员核对需要保留的版本；不要覆盖或重复发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:206；server/app.cjs:207

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-027没有配置可用模型API账号管理员
故障代号
SWL-API-027
技术键
channel_key_required
故障含义
当前操作没有找到已启用且配置完整的对应模型API账号。
可能原因
  1. 可能触发条件（源码固定说明）：新账号启用前请填写API Key。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：新账号启用前请填写API Key。
解决方案
  1. 请管理员配置并启用对应文字或图片API账号，填写有效Key、接口和模型名称。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/model-channels.cjs:45

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-002无法自动复制操作人
故障代号
SWL-CLIENT-002
技术键
clipboard_unavailable
故障含义
设备没有允许本次自动写入剪贴板。
可能原因
  1. 可能：设备没有允许本次自动写入剪贴板。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 手动长按或选中页面显示的安全文字进行复制。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
web/app.mjs:943

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-028操作原因尚未确认服务商
故障代号
SWL-API-028
技术键
cloud_failed
故障含义
系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
可能原因
  1. 可能：系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 先读取原任务或作品状态，保留任务编号并联系管理员或服务商；不要重复提交生成或发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/cloud-cards.cjs:159；server/cloud-cards.cjs:444；server/cloud-cards.cjs:445；server/cloud-cards.cjs:446

具体原因需结合原任务核实。

SWL-JOB-004服务正在停止或维护服务商
故障代号
SWL-JOB-004
技术键
cloud_inactive
故障含义
当前服务正在停止，无法继续接受这项处理。
可能原因
  1. 可能触发条件（源码固定说明）：词卡制作任务已结束。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：词卡制作任务已结束。
解决方案
  1. 等待服务恢复并读取原任务状态；请服务商确认已有任务，勿重复购买模型调用。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
服务商
代码依据
server/enterprise-models.cjs:164

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-003需要使用对应工作台操作人
故障代号
SWL-CLIENT-003
技术键
cloud_required
故障含义
当前操作不允许从此客户端入口执行。
可能原因
  1. 可能触发条件（源码固定说明）：云端词卡须由服务器生成，不能通过桌面同步创建。
  2. 可能触发条件（源码固定说明）：云端词卡须在词卡工作台修改并由服务器重新渲染。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：云端词卡须由服务器生成，不能通过桌面同步创建。
  4. 对照当前分支核对：云端词卡须在词卡工作台修改并由服务器重新渲染。
解决方案
  1. 进入页面指定的云端或桌面工作台继续处理原作品。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise-works.cjs:60；server/enterprise-works.cjs:62

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-004操作确认内容校验未通过操作人
故障代号
SWL-PUB-004
技术键
confirmation_mismatch
故障含义
源码以此代码拒绝以下输入或状态：删除或危险操作的确认内容与目标不一致。
可能原因
  1. 可能：删除或危险操作的确认内容与目标不一致。
先做检查
  1. 定位当前字段或参数：操作确认内容。
  2. 逐项核对：删除或危险操作的确认内容与目标不一致。
  3. 该代码的固定校验说明：确认登录名不一致，请输入该账号当前的登录名。
  4. 该代码的固定校验说明：登录名不一致，请核对后再删除。
解决方案
  1. 重新核对目标账号/记录，并按页面要求填写匹配的操作确认内容。
验证恢复
  1. 操作确认内容通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:149；server/web/assets/app.js:542

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-005公开发布确认校验未通过操作人
故障代号
SWL-PUB-005
技术键
confirmation_required
故障含义
源码以此代码拒绝以下输入或状态：尚未明确确认笔记已经实际公开发布。
可能原因
  1. 可能：尚未明确确认笔记已经实际公开发布。
先做检查
  1. 定位当前字段或参数：公开发布确认。
  2. 逐项核对：尚未明确确认笔记已经实际公开发布。
  3. 该代码的固定校验说明：请先核实本次笔记已公开发布，再登记链接。
  4. 该代码的固定校验说明：公开发布确认须为布尔值。
  5. 该代码的固定校验说明：请先核实本次笔记已公开发布。
解决方案
  1. 先在平台核实笔记已公开，再由操作人明确确认并登记原记录。
验证恢复
  1. 公开发布确认通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:191；server/enterprise-works.cjs:111；server/enterprise-works.cjs:118

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-NET-002连接未完成操作人
故障代号
SWL-NET-002
技术键
connection_failed
故障含义
客户端没有收到完整的服务器响应；具体网络原因和服务器是否已处理请求尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：无法连接团队服务器，请检查网络后重试。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：无法连接团队服务器，请检查网络后重试。
解决方案
  1. 检查网络后读取现有任务或作品状态；提交结果未确认前不要重复生成或发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise.cjs:85；server/web/assets/app.js:141；server/web/assets/app.js:247；web/app.mjs:184

具体原因需结合原任务核实。

SWL-API-032账号或设备权限受限管理员
故障代号
SWL-API-032
技术键
creator_inactive
故障含义
本版把 creator_inactive 映射到 creator_required。当前账号或设备不满足此操作的权限要求。
可能原因
  1. 可能：适配器或服务商返回了此兼容错误码，进入源码中的固定映射分支
  2. 可能：当前账号或设备不满足此操作的权限要求。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 请管理员检查账号启用状态、角色和设备授权，恢复后继续处理原任务。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:320

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-033账号或设备权限受限管理员
故障代号
SWL-API-033
技术键
creator_required
故障含义
当前账号或设备不满足此操作的权限要求。
可能原因
  1. 可能触发条件（源码固定说明）：账号已停用或不再具有创作权限。
  2. 可能触发条件（源码固定说明）：此操作仅启用的管理员或操作员可用。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：账号已停用或不再具有创作权限。
  4. 对照当前分支核对：此操作仅启用的管理员或操作员可用。
解决方案
  1. 请管理员检查账号启用状态、角色和设备授权，恢复后继续处理原任务。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/cloud-cards.cjs:150；server/enterprise-security.cjs:11

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-004页面验证未通过操作人
故障代号
SWL-AUTH-004
技术键
csrf_denied
故障含义
页面来源或页面验证信息不符合服务器要求。
可能原因
  1. 可能触发条件（源码固定说明）：页面验证已失效，请刷新重试。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：页面验证已失效，请刷新重试。
解决方案
  1. 从正式入口刷新并重新登录；仍然失败时请管理员核对站点来源配置。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:58

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-034来源数据没有通过校验服务商
故障代号
SWL-API-034
技术键
cursor_loop
故障含义
来源返回的数据结构、分页游标或统计完整性没有通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：采集接口返回重复分页游标，已停止以防循环。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：采集接口返回重复分页游标，已停止以防循环。
解决方案
  1. 请管理员与来源服务商核对接口结构、分页和统计；保留原游标及同步记录，不要跳过缺失数据。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:232；server/chat-insights.cjs:284；server/chat-insights.cjs:52

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-006没有此操作权限管理员
故障代号
SWL-AUTH-006
技术键
data_grant_forbidden
故障含义
服务器拒绝了当前账号对这项资源的操作权限。
可能原因
  1. 可能触发条件（源码固定说明）：仅本人或管理员可查看此主理人的数据授权。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：仅本人或管理员可查看此主理人的数据授权。
解决方案
  1. 使用有权限的账号，或请管理员核对权限；不要尝试操作其他人的资源。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:241

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-004需要使用对应工作台操作人
故障代号
SWL-CLIENT-004
技术键
desktop_required
故障含义
当前操作不允许从此客户端入口执行。
可能原因
  1. 可能触发条件（源码固定说明）：作品由桌面程序同步，请回到桌面程序创建、上传或修改。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：作品由桌面程序同步，请回到桌面程序创建、上传或修改。
解决方案
  1. 进入页面指定的云端或桌面工作台继续处理原作品。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise.cjs:70

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-035作品当前不可直接修改操作人
故障代号
SWL-API-035
技术键
direct_card_text_locked
故障含义
作品处于已执行、锁定或模型直出文字不可单独修改的状态。
可能原因
  1. 可能触发条件（源码固定说明）：图中文字已直接生成在成品中；此处只能修改发布标题、正文和账号标签。修改图中文字请创建新词卡，不会自动重新生图或扣费。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：图中文字已直接生成在成品中；此处只能修改发布标题、正文和账号标签。修改图中文字请创建新词卡，不会自动重新生图或扣费。
解决方案
  1. 先查看当前作品状态；需要修改时使用允许的编辑入口或另建新作品，不要覆盖已执行记录。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/cloud-cards.cjs:489

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-008没有此操作权限管理员
故障代号
SWL-AUTH-008
技术键
forbidden
故障含义
服务器拒绝了当前账号对这项资源的操作权限。
可能原因
  1. 可能触发条件（源码固定说明）：此操作仅管理员可用。
  2. 可能触发条件（源码固定说明）：只能查看本人的聊天分析。
  3. 可能触发条件（源码固定说明）：仅管理员可核实模型费用。
  4. 可能触发条件（源码固定说明）：只能创建本人的作品。
  5. 可能触发条件（源码固定说明）：只有管理员可以审核。
  6. 可能触发条件（源码固定说明）：只有管理员可以管理设备。
  7. 可能触发条件（源码固定说明）：仅作品本人可以执行发布。
  8. 可能触发条件（源码固定说明）：仅管理员可核实发布结果。
  9. 可能触发条件（源码固定说明）：此操作仅启用的管理员可用。
  10. 可能触发条件（源码固定说明）：只有操作员本人可以提交作品。
  11. 可能触发条件（源码固定说明）：审核通知仅管理员可管理。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：此操作仅管理员可用。
  4. 对照当前分支核对：只能查看本人的聊天分析。
  5. 对照当前分支核对：仅管理员可核实模型费用。
  6. 对照当前分支核对：只能创建本人的作品。
  7. 对照当前分支核对：只有管理员可以审核。
  8. 对照当前分支核对：只有管理员可以管理设备。
解决方案
  1. 使用有权限的账号，或请管理员核对权限；不要尝试操作其他人的资源。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:70；server/chat-insights.cjs:339；server/chat-insights.cjs:341；server/enterprise-models.cjs:268；server/enterprise-works.cjs:49

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-005来源身份信息不能改写管理员
故障代号
SWL-STATE-005
技术键
immutable_created_at
故障含义
当前字段来自原始身份或创建记录，不允许通过编辑覆盖。
可能原因
  1. 可能触发条件（源码固定说明）：同一记录的创建时间不能修改。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：同一记录的创建时间不能修改。
解决方案
  1. 保留来源身份与创建信息；请管理员使用允许修改的显示名称或账号设置。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:211

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-006作品资料尚未完整操作人
故障代号
SWL-PUB-006
技术键
incomplete_work
故障含义
作品缺少发布账号标签或要求的图片等必要资料。
可能原因
  1. 可能触发条件（源码固定说明）：提交审核前请指定平台账号标签并上传成品图片。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：提交审核前请指定平台账号标签并上传成品图片。
解决方案
  1. 补齐发布账号标签和四张有效图片，保存后再提交审核或准备发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise-works.cjs:64

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-002品牌参考图校验未通过服务商
故障代号
SWL-VAL-002
技术键
invalid_brand_reference
故障含义
源码以此代码拒绝以下输入或状态：品牌参考不是服务器提供的Seedream PNG数据。
可能原因
  1. 可能：品牌参考不是服务器提供的Seedream PNG数据。
先做检查
  1. 定位当前字段或参数：品牌参考图。
  2. 逐项核对：品牌参考不是服务器提供的Seedream PNG数据。
  3. 该代码的固定校验说明：品牌参考须为服务器提供的Seedream PNG图片。
解决方案
  1. 使用服务器保存的Seedream PNG品牌参考，不从客户端提交任意远程参考地址。
验证恢复
  1. 品牌参考图通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
服务商
代码依据
server/enterprise-models.cjs:117

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-003四页词卡结构与文字校验未通过管理员
故障代号
SWL-VAL-003
技术键
invalid_cards
故障含义
源码以此代码拒绝以下输入或状态：词卡不是四页、每页不是三列，或标题/列文字不符合中文长度及标点限制。
可能原因
  1. 可能：词卡不是四页、每页不是三列，或标题/列文字不符合中文长度及标点限制。
先做检查
  1. 定位当前字段或参数：四页词卡结构与文字。
  2. 逐项核对：词卡不是四页、每页不是三列，或标题/列文字不符合中文长度及标点限制。
  3. 该代码的固定校验说明：词卡须恰好四页。
  4. 该代码的固定校验说明：词卡标题须为一至八个中文。
  5. 该代码的固定校验说明：每页词卡须恰好三列。
  6. 该代码的固定校验说明：每列须为一至八个无标点中文。
解决方案
  1. 调整为恰好四页、每页三列；标题和每列均为一至八个无标点中文。
验证恢复
  1. 四页词卡结构与文字通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
管理员
代码依据
server/cloud-cards.cjs:32；server/cloud-cards.cjs:36；server/cloud-cards.cjs:37；server/cloud-cards.cjs:40

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-004模型API通道列表校验未通过管理员
故障代号
SWL-VAL-004
技术键
invalid_channels
故障含义
源码以此代码拒绝以下输入或状态：通道列表缺少默认通道、超过数量上限、ID重复，或改动了既有通道类型。
可能原因
  1. 可能：通道列表缺少默认通道、超过数量上限、ID重复，或改动了既有通道类型。
先做检查
  1. 定位当前字段或参数：模型API通道列表。
  2. 逐项核对：通道列表缺少默认通道、超过数量上限、ID重复，或改动了既有通道类型。
  3. 该代码的固定校验说明：须保留两个默认账号，最多配置32个API通道。
  4. 该代码的固定校验说明：通道ID无效或重复。
  5. 该代码的固定校验说明：已有通道类型不能改变。
  6. 该代码的固定校验说明：默认账号沿用模型设置中的地址和Key。
  7. 该代码的固定校验说明：默认账号可以停用，不能移除。
解决方案
  1. 保留两个默认通道；总数不超过32，通道ID唯一，不改变既有通道类型。
验证恢复
  1. 模型API通道列表通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
管理员
代码依据
server/model-channels.cjs:34；server/model-channels.cjs:38；server/model-channels.cjs:40；server/model-channels.cjs:46；server/model-channels.cjs:49

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-005日期校验未通过操作人
故障代号
SWL-VAL-005
技术键
invalid_date
故障含义
源码以此代码拒绝以下输入或状态：日期不是有效的YYYY-MM-DD。
可能原因
  1. 可能：日期不是有效的YYYY-MM-DD。
先做检查
  1. 定位当前字段或参数：日期。
  2. 逐项核对：日期不是有效的YYYY-MM-DD。
  3. 该代码的固定校验说明：日期须为 YYYY-MM-DD。
解决方案
  1. 填写真实有效的YYYY-MM-DD日期。
验证恢复
  1. 日期通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/chat-insights.cjs:338

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-006审核或费用核实决定校验未通过操作人
故障代号
SWL-VAL-006
技术键
invalid_decision
故障含义
源码以此代码拒绝以下输入或状态：费用核实或作品审核决定不在对应接口允许的枚举内。
可能原因
  1. 可能：费用核实或作品审核决定不在对应接口允许的枚举内。
先做检查
  1. 定位当前字段或参数：审核或费用核实决定。
  2. 逐项核对：费用核实或作品审核决定不在对应接口允许的枚举内。
  3. 该代码的固定校验说明：费用核实结果无效。
  4. 该代码的固定校验说明：审核决定无效。
解决方案
  1. 使用当前审核或费用核实接口允许的决定值，不复用其他流程枚举。
验证恢复
  1. 审核或费用核实决定通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:268；server/enterprise-works.cjs:65

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-007生成图片未通过检查服务商
故障代号
SWL-VAL-007
技术键
invalid_direct_card_dimensions
故障含义
图片格式、编码、尺寸或成品数量未满足当前词卡要求。
可能原因
  1. 可能触发条件（源码固定说明）：成品词卡须为接近3:4且不低于1080×1440的完整图片；已保留模型结果，不会裁切或自动重新生图。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：成品词卡须为接近3:4且不低于1080×1440的完整图片；已保留模型结果，不会裁切或自动重新生图。
解决方案
  1. 请服务商检查原任务已保存图片及校验信息；不要为同一任务重复购买图片。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/cloud-cards.cjs:111

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-008生成图片未通过检查服务商
故障代号
SWL-VAL-008
技术键
invalid_direct_card_format
故障含义
图片格式、编码、尺寸或成品数量未满足当前词卡要求。
可能原因
  1. 可能触发条件（源码固定说明）：直出成品须为PNG；模型结果已保留，不会转换、裁切或自动重新生图。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：直出成品须为PNG；模型结果已保留，不会转换、裁切或自动重新生图。
解决方案
  1. 请服务商检查原任务已保存图片及校验信息；不要为同一任务重复购买图片。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/cloud-cards.cjs:108

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-009生成图片未通过检查服务商
故障代号
SWL-VAL-009
技术键
invalid_direct_cards
故障含义
图片格式、编码、尺寸或成品数量未满足当前词卡要求。
可能原因
  1. 可能触发条件（源码固定说明）：成品词卡须恰好四张。
  2. 可能触发条件（源码固定说明）：每次须返回一张成品词卡；结果已保留，不会自动重新生图。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：成品词卡须恰好四张。
  4. 对照当前分支核对：每次须返回一张成品词卡；结果已保留，不会自动重新生图。
解决方案
  1. 请服务商检查原任务已保存图片及校验信息；不要为同一任务重复购买图片。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/cloud-cards.cjs:116；server/cloud-cards.cjs:406

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-011通知开关校验未通过操作人
故障代号
SWL-VAL-011
技术键
invalid_enabled
故障含义
源码以此代码拒绝以下输入或状态：通知开关不是布尔值。
可能原因
  1. 可能：通知开关不是布尔值。
先做检查
  1. 定位当前字段或参数：通知开关。
  2. 逐项核对：通知开关不是布尔值。
  3. 该代码的固定校验说明：通知开关须为布尔值。
解决方案
  1. 把通知enabled设置为JSON布尔值true或false。
验证恢复
  1. 通知开关通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/fault-alerts.cjs:65；server/review-notifications.cjs:37

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-012必填字段、格式或范围未通过校验操作人
故障代号
SWL-VAL-012
技术键
invalid_field
故障含义
通用字段校验器拒绝了当前字段；仅凭该码不能确定具体字段。
可能原因
  1. 可能：必填字段为空
  2. 可能：字符串类型、控制字符或长度不符合要求
  3. 可能：数字不是允许范围内的整数
先做检查
  1. 查看页面固定字段提示，定位字段名称与约束
  2. 核对当前接口对该字段的类型、长度、允许字符或范围
解决方案
  1. 补齐指定必填项，或把对应字段改为允许的类型和范围
  2. 涉及密码、Key或授权令牌时只在正式受控入口修改
验证恢复
  1. 指定字段通过页面和服务端校验，保存值与预期一致
重试规则
修正指定字段后继续原操作；请求结果未确认时先读原状态。
处理责任
操作人
代码依据
server/app.cjs:21；server/enterprise-security.cjs:13；server/enterprise.cjs:78；server/enterprise.cjs:79；web/app.mjs:519

具体原因需结合原任务核实。

SWL-VAL-013任务或资源UUID校验未通过操作人
故障代号
SWL-VAL-013
技术键
invalid_id
故障含义
源码以此代码拒绝以下输入或状态：资源或任务编号不是有效UUID。
可能原因
  1. 可能：资源或任务编号不是有效UUID。
先做检查
  1. 定位当前字段或参数：任务或资源UUID。
  2. 逐项核对：资源或任务编号不是有效UUID。
  3. 该代码的固定校验说明：编号须为 UUID。
解决方案
  1. 由客户端为新资源生成有效UUID；恢复旧请求时使用原UUID。
验证恢复
  1. 任务或资源UUID通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-security.cjs:15

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-014平台账号会话摘要校验未通过操作人
故障代号
SWL-VAL-014
技术键
invalid_identity
故障含义
源码以此代码拒绝以下输入或状态：平台账号会话摘要不合校验要求。
可能原因
  1. 可能：平台账号会话摘要不合校验要求。
先做检查
  1. 定位当前字段或参数：平台账号会话摘要。
  2. 逐项核对：平台账号会话摘要不合校验要求。
  3. 该代码的固定校验说明：平台账号会话摘要无效。
解决方案
  1. 回到已登记的原设备重新读取平台账号会话摘要，不手工伪造摘要。
验证恢复
  1. 平台账号会话摘要通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-works.cjs:42

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-015发件邮箱ID校验未通过操作人
故障代号
SWL-VAL-015
技术键
invalid_inbox
故障含义
源码以此代码拒绝以下输入或状态：发件邮箱ID包含不允许的字符或格式无效。
可能原因
  1. 可能：发件邮箱ID包含不允许的字符或格式无效。
先做检查
  1. 定位当前字段或参数：发件邮箱ID。
  2. 逐项核对：发件邮箱ID包含不允许的字符或格式无效。
  3. 该代码的固定校验说明：AgentMail 发件邮箱 ID 格式无效。
解决方案
  1. 在发件设置中填写符合格式的发件邮箱ID；服务器托管发件通道使用对应托管入口。
验证恢复
  1. 发件邮箱ID通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/review-notifications.cjs:38

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-016JSON请求体校验未通过操作人
故障代号
SWL-VAL-016
技术键
invalid_json
故障含义
源码以此代码拒绝以下输入或状态：请求体不是可解析的JSON。
可能原因
  1. 可能：请求体不是可解析的JSON。
先做检查
  1. 定位当前字段或参数：JSON请求体。
  2. 逐项核对：请求体不是可解析的JSON。
  3. 该代码的固定校验说明：JSON 请求无法解析。
解决方案
  1. 使用JSON序列化提交完整请求体，修正引号、逗号和截断内容。
验证恢复
  1. JSON请求体通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:36

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-017邮件API Key格式校验未通过管理员
故障代号
SWL-VAL-017
技术键
invalid_key
故障含义
源码以此代码拒绝以下输入或状态：邮件API Key包含空白或换行。
可能原因
  1. 可能：邮件API Key包含空白或换行。
先做检查
  1. 定位当前字段或参数：邮件API Key格式。
  2. 逐项核对：邮件API Key包含空白或换行。
  3. 该代码的固定校验说明：AgentMail API Key 不可含空格或换行。
解决方案
  1. 通过受控设置入口重新填写Key，去除空白和换行；不要把Key放入工单。
验证恢复
  1. 邮件API Key格式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
管理员
代码依据
server/review-notifications.cjs:41

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-018模型任务类型校验未通过操作人
故障代号
SWL-VAL-018
技术键
invalid_kind
故障含义
源码以此代码拒绝以下输入或状态：模型任务类型不是text或image。
可能原因
  1. 可能：模型任务类型不是text或image。
先做检查
  1. 定位当前字段或参数：模型任务类型。
  2. 逐项核对：模型任务类型不是text或image。
  3. 该代码的固定校验说明：模型任务类型无效。
解决方案
  1. 将模型任务kind设为text或image。
验证恢复
  1. 模型任务类型通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:134

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-019发布内容摘要校验未通过操作人
故障代号
SWL-VAL-019
技术键
invalid_manifest
故障含义
源码以此代码拒绝以下输入或状态：本地发布内容摘要不是SHA-256格式。
可能原因
  1. 可能：本地发布内容摘要不是SHA-256格式。
先做检查
  1. 定位当前字段或参数：发布内容摘要。
  2. 逐项核对：本地发布内容摘要不是SHA-256格式。
  3. 该代码的固定校验说明：本地发布内容摘要须为 SHA-256。
解决方案
  1. 使用当前已审核内容重新计算SHA-256摘要，保持清单与原作品一致。
验证恢复
  1. 发布内容摘要通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-works.cjs:40

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-020成员编号校验未通过操作人
故障代号
SWL-VAL-020
技术键
invalid_member_id
故障含义
源码以此代码拒绝以下输入或状态：成员编号长度、允许字符或URL路径解码不合要求。
可能原因
  1. 可能：成员编号长度、允许字符或URL路径解码不合要求。
先做检查
  1. 定位当前字段或参数：成员编号。
  2. 逐项核对：成员编号长度、允许字符或URL路径解码不合要求。
  3. 该代码的固定校验说明：主理人 ID 路径格式无效。
  4. 该代码的固定校验说明：成员编号须为 1 至 160 位字母、数字或 . _ : @ -，并以字母或数字开头。
解决方案
  1. 保留来源成员编号，只使用允许字符并核对路径编码；不要擅自转换大小写或改写来源身份。
验证恢复
  1. 成员编号通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:72；server/enterprise-security.cjs:18；server/enterprise.cjs:93

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-021登录模式校验未通过操作人
故障代号
SWL-VAL-021
技术键
invalid_mode
故障含义
源码以此代码拒绝以下输入或状态：登录方式不是当前接口支持的模式。
可能原因
  1. 可能：登录方式不是当前接口支持的模式。
先做检查
  1. 定位当前字段或参数：登录模式。
  2. 逐项核对：登录方式不是当前接口支持的模式。
  3. 该代码的固定校验说明：登录方式无效。
解决方案
  1. 使用页面支持的登录模式，不混用cookie与其他模式参数。
验证恢复
  1. 登录模式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:112；server/miniapp-auth.cjs:145

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-022模型返回内容不符合要求管理员
故障代号
SWL-VAL-022
技术键
invalid_model_output
故障含义
已收到的模型内容没有通过当前业务需要的结构或内容校验。
可能原因
  1. 可能触发条件（源码固定说明）：文字模型没有返回有效的四页词卡数据；本次结果已保留，不会自动重新调用。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：文字模型没有返回有效的四页词卡数据；本次结果已保留，不会自动重新调用。
解决方案
  1. 请管理员检查原任务保存的结果和输出规则；结果已保留时优先修复，不要自动重复调用模型。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/cloud-cards.cjs:54

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-023月份校验未通过操作人
故障代号
SWL-VAL-023
技术键
invalid_month
故障含义
源码以此代码拒绝以下输入或状态：月份不是YYYY-MM。
可能原因
  1. 可能：月份不是YYYY-MM。
先做检查
  1. 定位当前字段或参数：月份。
  2. 逐项核对：月份不是YYYY-MM。
  3. 该代码的固定校验说明：月份格式须为 YYYY-MM。
解决方案
  1. 填写YYYY-MM月份并核对月份范围。
验证恢复
  1. 月份通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:256

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-024文字回复数量校验未通过操作人
故障代号
SWL-VAL-024
技术键
invalid_number
故障含义
源码以此代码拒绝以下输入或状态：文字任务一次请求的回复数量不等于1。
可能原因
  1. 可能：文字任务一次请求的回复数量不等于1。
先做检查
  1. 定位当前字段或参数：文字回复数量。
  2. 逐项核对：文字任务一次请求的回复数量不等于1。
  3. 该代码的固定校验说明：文字任务仅支持一次一个回复。
解决方案
  1. 将文字任务回复数量n改为1。
验证恢复
  1. 文字回复数量通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:126；server/enterprise-security.cjs:22

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-025作品归属成员校验未通过操作人
故障代号
SWL-VAL-025
技术键
invalid_owner
故障含义
源码以此代码拒绝以下输入或状态：作品被分配给未启用或不存在的成员。
可能原因
  1. 可能：作品被分配给未启用或不存在的成员。
先做检查
  1. 定位当前字段或参数：作品归属成员。
  2. 逐项核对：作品被分配给未启用或不存在的成员。
  3. 该代码的固定校验说明：作品须分配给启用中的成员。
解决方案
  1. 选择已经启用、实际有权接收该作品的成员。
验证恢复
  1. 作品归属成员通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-works.cjs:49

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-026分页参数校验未通过操作人
故障代号
SWL-VAL-026
技术键
invalid_pagination
故障含义
源码以此代码拒绝以下输入或状态：分页页码或每页条数超出该接口允许的范围。
可能原因
  1. 可能：分页页码或每页条数超出该接口允许的范围。
先做检查
  1. 定位当前字段或参数：分页参数。
  2. 逐项核对：分页页码或每页条数超出该接口允许的范围。
  3. 该代码的固定校验说明：分页参数无效。
  4. 该代码的固定校验说明：每页可读取 1 至 100 条记录。
解决方案
  1. 把页码和每页条数改为接口允许的整数范围；记录列表每页为1至100条。
验证恢复
  1. 分页参数通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:174

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-027文件路径校验未通过操作人
故障代号
SWL-VAL-027
技术键
invalid_path
故障含义
源码以此代码拒绝以下输入或状态：文件路径越界或不符合允许的路径规则。
可能原因
  1. 可能：文件路径越界或不符合允许的路径规则。
先做检查
  1. 定位当前字段或参数：文件路径。
  2. 逐项核对：文件路径越界或不符合允许的路径规则。
  3. 该代码的固定校验说明：文件路径无效。
解决方案
  1. 使用应用生成的合法相对资源路径，不提交越界路径或路径分隔符变体。
验证恢复
  1. 文件路径通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise.cjs:150

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-028审核权限校验未通过操作人
故障代号
SWL-VAL-028
技术键
invalid_permission
故障含义
源码以此代码拒绝以下输入或状态：审核权限不是布尔值，或试图把管理员设为免审。
可能原因
  1. 可能：审核权限不是布尔值，或试图把管理员设为免审。
先做检查
  1. 定位当前字段或参数：审核权限。
  2. 逐项核对：审核权限不是布尔值，或试图把管理员设为免审。
  3. 该代码的固定校验说明：审核权限须为布尔值。
  4. 该代码的固定校验说明：管理员的云端作品须由其他管理员审核，不能设为免审。
  5. 该代码的固定校验说明：管理员的云端作品不能设为免审。
解决方案
  1. 将审核开关设为布尔值；管理员账号保留由其他管理员审核的要求。
验证恢复
  1. 审核权限通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:136；server/app.cjs:167；server/app.cjs:169

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-029发布平台校验未通过操作人
故障代号
SWL-VAL-029
技术键
invalid_platform
故障含义
源码以此代码拒绝以下输入或状态：请求的平台不是当前支持的小红书。
可能原因
  1. 可能：请求的平台不是当前支持的小红书。
先做检查
  1. 定位当前字段或参数：发布平台。
  2. 逐项核对：请求的平台不是当前支持的小红书。
  3. 该代码的固定校验说明：暂仅支持小红书发布记录。
解决方案
  1. 将platform改为当前支持的小红书平台值。
验证恢复
  1. 发布平台通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:208

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-030平台作品链接校验未通过操作人
故障代号
SWL-VAL-030
技术键
invalid_platform_url
故障含义
源码以此代码拒绝以下输入或状态：链接不是被允许的小红书笔记HTTPS链接，或填了账号主页。
可能原因
  1. 可能：链接不是被允许的小红书笔记HTTPS链接，或填了账号主页。
先做检查
  1. 定位当前字段或参数：平台作品链接。
  2. 逐项核对：链接不是被允许的小红书笔记HTTPS链接，或填了账号主页。
  3. 该代码的固定校验说明：请填写有效的小红书笔记 HTTPS 链接，不能使用账号主页或其他网站。
解决方案
  1. 从实际公开的笔记页面复制正式HTTPS作品链接，不使用账号主页或其他网站地址。
验证恢复
  1. 平台作品链接通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/publication-storage.cjs:15；web/app.mjs:430

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-033排版项目结构校验未通过操作人
故障代号
SWL-VAL-033
技术键
invalid_project
故障含义
源码以此代码拒绝以下输入或状态：排版项目不是允许大小和复杂度的JSON对象，或资源数量/名称/引用方式无效。
可能原因
  1. 可能：排版项目不是允许大小和复杂度的JSON对象，或资源数量/名称/引用方式无效。
先做检查
  1. 定位当前字段或参数：排版项目结构。
  2. 逐项核对：排版项目不是允许大小和复杂度的JSON对象，或资源数量/名称/引用方式无效。
  3. 该代码的固定校验说明：排版项目须为不超过 8 MB 的 JSON 对象。
  4. 该代码的固定校验说明：排版项目结构过于复杂。
  5. 该代码的固定校验说明：项目资源最多 20 项。
  6. 该代码的固定校验说明：资源名称不能含路径。
  7. 该代码的固定校验说明：资源引用不能混用内嵌数据。
解决方案
  1. 缩减排版JSON至8MB以内，限制结构复杂度和资源数量；资源名不含路径，不混用资源引用与内嵌数据。
验证恢复
  1. 排版项目结构通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-works.cjs:11；server/enterprise-works.cjs:14；server/enterprise-works.cjs:23

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-034模型接口协议校验未通过管理员
故障代号
SWL-VAL-034
技术键
invalid_protocol
故障含义
源码以此代码拒绝以下输入或状态：文字或图片模型协议不在对应支持列表内。
可能原因
  1. 可能：文字或图片模型协议不在对应支持列表内。
先做检查
  1. 定位当前字段或参数：模型接口协议。
  2. 逐项核对：文字或图片模型协议不在对应支持列表内。
  3. 该代码的固定校验说明：模型协议无效。
解决方案
  1. 管理员为文字选择当前支持的协议；图片使用本版支持的OpenAI兼容协议。
验证恢复
  1. 模型接口协议通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
管理员
代码依据
server/enterprise-models.cjs:74

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-035鉴权提供方式校验未通过操作人
故障代号
SWL-VAL-035
技术键
invalid_provider
故障含义
源码以此代码拒绝以下输入或状态：鉴权提供方式不是支持的枚举值。
可能原因
  1. 可能：鉴权提供方式不是支持的枚举值。
先做检查
  1. 定位当前字段或参数：鉴权提供方式。
  2. 逐项核对：鉴权提供方式不是支持的枚举值。
  3. 该代码的固定校验说明：鉴权方式无效。
解决方案
  1. 管理员从支持的鉴权提供方式中重新选择并填写对应配置。
验证恢复
  1. 鉴权提供方式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:71

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-037模型推理强度校验未通过操作人
故障代号
SWL-VAL-037
技术键
invalid_reasoning
故障含义
源码以此代码拒绝以下输入或状态：推理强度不是本版允许的枚举值。
可能原因
  1. 可能：推理强度不是本版允许的枚举值。
先做检查
  1. 定位当前字段或参数：模型推理强度。
  2. 逐项核对：推理强度不是本版允许的枚举值。
  3. 该代码的固定校验说明：推理强度无效。
解决方案
  1. 将reasoning_effort改为本版允许的值之一。
验证恢复
  1. 模型推理强度通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:122

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-038推荐参数校验未通过操作人
故障代号
SWL-VAL-038
技术键
invalid_recommendation_query
故障含义
源码以此代码拒绝以下输入或状态：推荐请求含有未支持的参数。
可能原因
  1. 可能：推荐请求含有未支持的参数。
先做检查
  1. 定位当前字段或参数：推荐参数。
  2. 逐项核对：推荐请求含有未支持的参数。
  3. 该代码的固定校验说明：推荐参数无效。
解决方案
  1. 移除推荐接口不支持的参数，使用页面提供的推荐条件。
验证恢复
  1. 推荐参数通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/topic-recommendations.cjs:39；server/topic-recommendations.cjs:41

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-039请求结构或修改内容不符合接口要求操作人
故障代号
SWL-VAL-039
技术键
invalid_request
故障含义
当前接口拒绝了请求对象、字段白名单、必要来源或待修改内容。
可能原因
  1. 可能：请求不是JSON对象
  2. 可能：包含当前接口不支持的字段
  3. 可能：应提供的请求来源或修改内容缺失
  4. 可能：开关字段类型不正确
先做检查
  1. 对照该接口的object白名单和本次固定说明
  2. 区分请求体解析错误invalid_json与结构错误invalid_request
解决方案
  1. 使用页面当前接口生成完整JSON对象，只保留允许字段
  2. 补齐需要变更的内容或正式请求来源，不重复发送同一无效包
验证恢复
  1. 请求通过结构校验；保存后的变更仅包含原意中的字段
重试规则
修正请求结构后仅提交必要的原操作；有不明提交结果先读状态。
处理责任
操作人
代码依据
server/app.cjs:20；server/app.cjs:88；server/app.cjs:166；server/chat-insights.cjs:164；server/enterprise-security.cjs:12

具体原因需结合原任务核实。

SWL-VAL-040发布或核实结果校验未通过操作人
故障代号
SWL-VAL-040
技术键
invalid_result
故障含义
源码以此代码拒绝以下输入或状态：发布或人工核实结果不是该接口允许的状态。
可能原因
  1. 可能：发布或人工核实结果不是该接口允许的状态。
先做检查
  1. 定位当前字段或参数：发布或核实结果。
  2. 逐项核对：发布或人工核实结果不是该接口允许的状态。
  3. 该代码的固定校验说明：发布结果无效。
  4. 该代码的固定校验说明：核实结果无效。
解决方案
  1. 按原发布记录当前允许的结果状态提交核实，不跳过状态检查。
验证恢复
  1. 发布或核实结果通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-works.cjs:102；server/enterprise-works.cjs:112

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-041审核入口链接校验未通过操作人
故障代号
SWL-VAL-041
技术键
invalid_review_url
故障含义
源码以此代码拒绝以下输入或状态：审核入口不是公网HTTPS首页，或含账号、查询、路径、自定义端口。
可能原因
  1. 可能：审核入口不是公网HTTPS首页，或含账号、查询、路径、自定义端口。
先做检查
  1. 定位当前字段或参数：审核入口链接。
  2. 逐项核对：审核入口不是公网HTTPS首页，或含账号、查询、路径、自定义端口。
  3. 该代码的固定校验说明：审核后台地址须为公网 HTTPS 首页地址。
  4. 该代码的固定校验说明：审核后台地址须为公网 HTTPS 首页地址，不可含账号、查询或路径。
解决方案
  1. 管理员填写正式公网HTTPS首页地址，删除账号信息、查询参数、附加路径和自定义端口。
验证恢复
  1. 审核入口链接通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/review-notifications.cjs:16；server/review-notifications.cjs:17

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-042账号角色校验未通过操作人
故障代号
SWL-VAL-042
技术键
invalid_role
故障含义
源码以此代码拒绝以下输入或状态：角色不是admin或operator。
可能原因
  1. 可能：角色不是admin或operator。
先做检查
  1. 定位当前字段或参数：账号角色。
  2. 逐项核对：角色不是admin或operator。
  3. 该代码的固定校验说明：角色须为 admin 或 operator。
解决方案
  1. 仅提交admin或operator角色；由有权限的管理员修改。
验证恢复
  1. 账号角色通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:136

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-043定时时间校验未通过操作人
故障代号
SWL-VAL-043
技术键
invalid_schedule
故障含义
源码以此代码拒绝以下输入或状态：定时时间缺少时区或时间无效。
可能原因
  1. 可能：定时时间缺少时区或时间无效。
先做检查
  1. 定位当前字段或参数：定时时间。
  2. 逐项核对：定时时间缺少时区或时间无效。
  3. 该代码的固定校验说明：定时时间须包含时区。
解决方案
  1. 补全定时发布时间及明确时区，保存后重新核对批准版本。
验证恢复
  1. 定时时间通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-works.cjs:57

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-044签名或鉴权密钥格式校验未通过管理员
故障代号
SWL-VAL-044
技术键
invalid_secret
故障含义
源码以此代码拒绝以下输入或状态：签名或鉴权密钥的长度及可打印字符不符合对应入口要求。
可能原因
  1. 可能：签名或鉴权密钥的长度及可打印字符不符合对应入口要求。
先做检查
  1. 定位当前字段或参数：签名或鉴权密钥格式。
  2. 逐项核对：签名或鉴权密钥的长度及可打印字符不符合对应入口要求。
  3. 该代码的固定校验说明：签名密钥须为至少 8 位的可打印字符，不能含空白。
  4. 该代码的固定校验说明：鉴权密钥须为至少 16 位的可打印字符。
解决方案
  1. 按当前入口要求设置足够长度的可打印签名/鉴权密钥，去除空白。
验证恢复
  1. 签名或鉴权密钥格式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
管理员
代码依据
server/miniapp-auth.cjs:75；server/miniapp-auth.cjs:76

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-048状态枚举校验未通过操作人
故障代号
SWL-VAL-048
技术键
invalid_status
故障含义
源码以此代码拒绝以下输入或状态：账号、设备或发布状态不是该接口允许的枚举值。
可能原因
  1. 可能：账号、设备或发布状态不是该接口允许的枚举值。
先做检查
  1. 定位当前字段或参数：状态枚举。
  2. 逐项核对：账号、设备或发布状态不是该接口允许的枚举值。
  3. 该代码的固定校验说明：账号状态无效。
  4. 该代码的固定校验说明：发布状态无效。
  5. 该代码的固定校验说明：设备状态无效。
解决方案
  1. 重新读取当前资源状态，并提交该接口允许的状态值。
验证恢复
  1. 状态枚举通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:167；server/app.cjs:177；server/app.cjs:208；server/enterprise-works.cjs:69

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-049模型思考参数校验未通过操作人
故障代号
SWL-VAL-049
技术键
invalid_thinking
故障含义
源码以此代码拒绝以下输入或状态：思考模式或预算不是本版允许的值。
可能原因
  1. 可能：思考模式或预算不是本版允许的值。
先做检查
  1. 定位当前字段或参数：模型思考参数。
  2. 逐项核对：思考模式或预算不是本版允许的值。
  3. 该代码的固定校验说明：思考模式无效。
解决方案
  1. 修正thinking.type和整数预算，使其符合当前接口白名单。
验证恢复
  1. 模型思考参数通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:123

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-050小程序一次性凭证校验未通过操作人
故障代号
SWL-VAL-050
技术键
invalid_ticket
故障含义
源码以此代码拒绝以下输入或状态：小程序一次性凭证的类型、长度或格式不符合要求。
可能原因
  1. 可能：小程序一次性凭证的类型、长度或格式不符合要求。
先做检查
  1. 定位当前字段或参数：小程序一次性凭证。
  2. 逐项核对：小程序一次性凭证的类型、长度或格式不符合要求。
  3. 该代码的固定校验说明：小程序鉴权凭证格式无效。
  4. 该代码的固定校验说明：授权链接格式无效，请从小程序重新打开。
解决方案
  1. 从小程序重新取得完整有效的一次性凭证，并仅在正式授权入口使用。
验证恢复
  1. 小程序一次性凭证通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:147；server/web/assets/app.js:796

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-051带时区日期时间校验未通过操作人
故障代号
SWL-VAL-051
技术键
invalid_timestamp
故障含义
源码以此代码拒绝以下输入或状态：日期时间不是带时区的有效ISO时间。
可能原因
  1. 可能：日期时间不是带时区的有效ISO时间。
先做检查
  1. 定位当前字段或参数：带时区日期时间。
  2. 逐项核对：日期时间不是带时区的有效ISO时间。
解决方案
  1. 填写含明确时区的有效ISO日期时间。
验证恢复
  1. 带时区日期时间通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:24

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-052诊断令牌格式校验未通过操作人
故障代号
SWL-VAL-052
技术键
invalid_token
故障含义
源码以此代码拒绝以下输入或状态：诊断接口令牌包含空白或格式不合要求。
可能原因
  1. 可能：诊断接口令牌包含空白或格式不合要求。
先做检查
  1. 定位当前字段或参数：诊断令牌格式。
  2. 逐项核对：诊断接口令牌包含空白或格式不合要求。
  3. 该代码的固定校验说明：接口令牌不可含空白。
解决方案
  1. 重新取得有效诊断授权包，去除复制时引入的空白；不要手工改变签名内容。
验证恢复
  1. 诊断令牌格式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/chat-insights.cjs:148

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-053模型服务地址或网络不可用管理员
故障代号
SWL-VAL-053
技术键
invalid_upstream
故障含义
模型服务地址未通过连接或域名解析验证。
可能原因
  1. 可能触发条件（源码固定说明）：模型地址须为公网 HTTPS 地址。
  2. 可能触发条件（源码固定说明）：模型地址须为公网 HTTPS 地址，不可含认证、查询或自定义端口。
  3. 可能触发条件（源码固定说明）：模型服务器域名无法解析。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：模型地址须为公网 HTTPS 地址。
  4. 对照当前分支核对：模型地址须为公网 HTTPS 地址，不可含认证、查询或自定义端口。
  5. 对照当前分支核对：模型服务器域名无法解析。
解决方案
  1. 请管理员核对API接口地址和服务器DNS网络；先确认原任务没有发出请求，再处理配置。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/enterprise-models.cjs:231；server/enterprise-models.cjs:232；server/enterprise-security.cjs:37；server/enterprise-security.cjs:38；server/enterprise-security.cjs:40

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-055登录用户名校验未通过操作人
故障代号
SWL-VAL-055
技术键
invalid_username
故障含义
源码以此代码拒绝以下输入或状态：用户名不是3至40位、首字符不是字母，或包含允许集合之外的字符。
可能原因
  1. 可能：用户名不是3至40位、首字符不是字母，或包含允许集合之外的字符。
先做检查
  1. 定位当前字段或参数：登录用户名。
  2. 逐项核对：用户名不是3至40位、首字符不是字母，或包含允许集合之外的字符。
  3. 该代码的固定校验说明：用户名须为 3 至 40 位，以字母开头，使用字母、数字、点、下划线或短横线。
解决方案
  1. 将用户名改为3至40位，以字母开头，仅用字母、数字、点、下划线或短横线。
验证恢复
  1. 登录用户名通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:22

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-007原任务已有处理结果操作人
故障代号
SWL-STATE-007
技术键
job_finished
故障含义
原任务已经被领取、完成或进入不能重复执行的状态。
可能原因
  1. 可能触发条件（源码固定说明）：任务已结束，不能中止；请刷新状态。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：任务已结束，不能中止；请刷新状态。
解决方案
  1. 读取原任务和发布记录；核对已有结果，不要重复领取、生成或发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/cloud-cards.cjs:199

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-045小程序授权不可用操作人
故障代号
SWL-API-045
技术键
jwt_verification_failed
故障含义
小程序授权未通过验证、已过期、已使用，或已因设置变化而失效。
可能原因
  1. 可能触发条件（源码固定说明）：小程序鉴权未通过或已过期，请重新获取登录链接。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：小程序鉴权未通过或已过期，请重新获取登录链接。
解决方案
  1. 返回小程序获取新的授权后重新进入；持续失败时请管理员核对签名与验证配置。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:190；server/web/assets/app.js:806；web/app.mjs:992；web/app.mjs:997

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-008页面填写校验提示操作人
故障代号
SWL-CLIENT-008
技术键
local_validation
故障含义
管理端页面在发送请求前生成的固定本地校验提示；具体缺失项由当前表单提示指出。
可能原因
  1. 可能：必填字段尚未填写
  2. 可能：两次填写不一致
  3. 可能：当前操作还缺少必要确认
先做检查
  1. 查看当前表单就地显示的原因；无需提供密码、Key或完整授权令牌
  2. 确认操作是否尚未发送到服务器
解决方案
  1. 按表单固定提示修正填写或补齐确认
验证恢复
  1. 本地提示消失；需要提交时只提交一次，并读取响应
重试规则
修正输入后继续原操作；提交结果不明时先读状态。
处理责任
操作人
代码依据
server/web/assets/app.js:184

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-046发布账号或内容不匹配操作人
故障代号
SWL-API-046
技术键
manifest_mismatch
故障含义
当前发布账号、清单或内容与原作品授权信息不一致。
可能原因
  1. 可能触发条件（源码固定说明）：本地发布内容与免审登记摘要不一致。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：本地发布内容与免审登记摘要不一致。
解决方案
  1. 核对原作品的发布账号和已审核内容，使用匹配的账号及版本；不要绕过检查。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise-works.cjs:80

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-009手册下载未完成操作人
故障代号
SWL-CLIENT-009
技术键
manual_download_failed
故障含义
客户端没有完成手册文件的下载；具体连接或文件原因尚未确认。
可能原因
  1. 可能：客户端没有完成手册文件的下载；具体连接或文件原因尚未确认。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 检查网络后重新下载同一份手册；持续失败时请管理员核对手册文件。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise.cjs:85；server/web/assets/app.js:141；web/app.mjs:184；web/app.mjs:674

具体原因需结合原任务核实。

SWL-VAL-056Responses输入校验未通过操作人
故障代号
SWL-VAL-056
技术键
missing_input
故障含义
源码以此代码拒绝以下输入或状态：Responses协议请求未提供input。
可能原因
  1. 可能：Responses协议请求未提供input。
先做检查
  1. 定位当前字段或参数：Responses输入。
  2. 逐项核对：Responses协议请求未提供input。
  3. 该代码的固定校验说明：缺少模型输入。
解决方案
  1. 为Responses请求填写有效input。
验证恢复
  1. Responses输入通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:125

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-057聊天消息数组校验未通过操作人
故障代号
SWL-VAL-057
技术键
missing_messages
故障含义
源码以此代码拒绝以下输入或状态：聊天协议未提供有效的非空messages数组。
可能原因
  1. 可能：聊天协议未提供有效的非空messages数组。
先做检查
  1. 定位当前字段或参数：聊天消息数组。
  2. 逐项核对：聊天协议未提供有效的非空messages数组。
  3. 该代码的固定校验说明：消息列表无效。
解决方案
  1. 为聊天请求填写非空、数量合规的messages数组。
验证恢复
  1. 聊天消息数组通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:126

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-058定时必要资料校验未通过操作人
故障代号
SWL-VAL-058
技术键
missing_schedule
故障含义
源码以此代码拒绝以下输入或状态：已定时或批准的定时版本没有保存定时时间。
可能原因
  1. 可能：已定时或批准的定时版本没有保存定时时间。
先做检查
  1. 定位当前字段或参数：定时必要资料。
  2. 逐项核对：已定时或批准的定时版本没有保存定时时间。
  3. 该代码的固定校验说明：已定时记录须提供定时时间。
  4. 该代码的固定校验说明：批准版本未包含定时时间。
解决方案
  1. 为需要定时的当前版本保存定时时间，再按当前审核流程操作。
验证恢复
  1. 定时必要资料通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:210；server/enterprise-works.cjs:104；server/enterprise-works.cjs:113

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-047操作原因尚未确认服务商
故障代号
SWL-API-047
技术键
model_failed
故障含义
系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
可能原因
  1. 可能：系统没有提供可以确认具体原因的诊断，不能据此判断请求是否已经处理。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 先读取原任务或作品状态，保留任务编号并联系管理员或服务商；不要重复提交生成或发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/cloud-cards.cjs:159；server/cloud-cards.cjs:281；server/enterprise-models.cjs:104；server/enterprise-models.cjs:186

具体原因需结合原任务核实。

SWL-API-048没有配置可用模型API账号管理员
故障代号
SWL-API-048
技术键
model_not_configured
故障含义
当前操作没有找到已启用且配置完整的对应模型API账号。
可能原因
  1. 可能触发条件（源码固定说明）：请管理员配置可用的
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：请管理员配置可用的
解决方案
  1. 请管理员配置并启用对应文字或图片API账号，填写有效Key、接口和模型名称。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:320；server/cloud-cards.cjs:230；server/model-channels.cjs:22

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-050模型结果缓存已过保留期操作人
故障代号
SWL-API-050
技术键
model_result_expired
故障含义
原模型结果的云端缓存已超过保留期，不能从同一任务再次下载。
可能原因
  1. 可能触发条件（源码固定说明）：图片调用结果已过期，不会重新调用或重复扣费。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：图片调用结果已过期，不会重新调用或重复扣费。
解决方案
  1. 使用本机已有结果恢复；没有副本时请管理员核对原任务后决定是否另行创作，原任务不会自动重买。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
操作人
代码依据
server/cloud-cards.cjs:281；server/enterprise-models.cjs:159

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-053目标记录未找到操作人
故障代号
SWL-API-053
技术键
not_found
故障含义
当前请求的记录或接口不存在，或当前账号无法读取。
可能原因
  1. 可能触发条件（源码固定说明）：发布记录不存在。
  2. 可能触发条件（源码固定说明）：分析任务不存在。
  3. 可能触发条件（源码固定说明）：主理人不存在。
  4. 可能触发条件（源码固定说明）：生成任务不存在。
  5. 可能触发条件（源码固定说明）：云端词卡不存在。
  6. 可能触发条件（源码固定说明）：模型任务不存在。
  7. 可能触发条件（源码固定说明）：本人的云端词卡不存在。
  8. 可能触发条件（源码固定说明）：发布领取记录不存在。
  9. 可能触发条件（源码固定说明）：通知记录不存在。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：发布记录不存在。
  4. 对照当前分支核对：分析任务不存在。
  5. 对照当前分支核对：主理人不存在。
  6. 对照当前分支核对：生成任务不存在。
  7. 对照当前分支核对：云端词卡不存在。
  8. 对照当前分支核对：模型任务不存在。
解决方案
  1. 从正式入口刷新列表并确认账号；若应当存在，请管理员核对原记录。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:73；server/app.cjs:91；server/app.cjs:145；server/app.cjs:166；server/app.cjs:183

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-054账号或设备权限受限管理员
故障代号
SWL-API-054
技术键
operator_required
故障含义
当前账号或设备不满足此操作的权限要求。
可能原因
  1. 可能触发条件（源码固定说明）：此接口仅操作员可用；管理员请使用云端创作工作台。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：此接口仅操作员可用；管理员请使用云端创作工作台。
解决方案
  1. 请管理员检查账号启用状态、角色和设备授权，恢复后继续处理原任务。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/enterprise-security.cjs:10

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-024页面验证未通过操作人
故障代号
SWL-AUTH-024
技术键
origin_denied
故障含义
页面来源或页面验证信息不符合服务器要求。
可能原因
  1. 可能触发条件（源码固定说明）：不接受此来源的写请求。
  2. 可能触发条件（源码固定说明）：不接受此来源的请求。
  3. 可能触发条件（源码固定说明）：网页登录须来自指定后台地址。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：不接受此来源的写请求。
  4. 对照当前分支核对：不接受此来源的请求。
  5. 对照当前分支核对：网页登录须来自指定后台地址。
解决方案
  1. 从正式入口刷新并重新登录；仍然失败时请管理员核对站点来源配置。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:58；server/app.cjs:86；server/app.cjs:96；server/app.cjs:104；server/app.cjs:112

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-055图片或请求大小不符合要求操作人
故障代号
SWL-API-055
技术键
payload_too_large
故障含义
提交的图片数量、格式或大小超过了当前接口允许的范围。
可能原因
  1. 可能触发条件（源码固定说明）：请求体超过大小限制。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：请求体超过大小限制。
解决方案
  1. 按页面要求调整图片数量、格式和体积后提交；不要重复发送相同超限内容。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:34；server/app.cjs:35

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-CLIENT-010平台应用未能打开操作人
故障代号
SWL-CLIENT-010
技术键
platform_launch_failed
故障含义
设备没有完成打开外部平台应用的操作。
可能原因
  1. 可能：设备没有完成打开外部平台应用的操作。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 使用手机系统浏览器或手动打开平台应用，先核对原发布记录，避免重复发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
web/app.mjs:918

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-057模型服务地址不允许访问管理员
故障代号
SWL-API-057
技术键
private_upstream
故障含义
配置的模型地址指向不允许访问的私网、回环或保留地址。
可能原因
  1. 可能触发条件（源码固定说明）：禁止访问私网、回环或保留地址。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：禁止访问私网、回环或保留地址。
解决方案
  1. 请管理员配置允许访问的公网HTTPS模型服务地址。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/enterprise-security.cjs:41

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-NET-005连接未完成操作人
故障代号
SWL-NET-005
技术键
request_aborted
故障含义
客户端没有收到完整的服务器响应；具体网络原因和服务器是否已处理请求尚未确认。
可能原因
  1. 可能：客户端没有收到完整的服务器响应；具体网络原因和服务器是否已处理请求尚未确认。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 检查网络后读取现有任务或作品状态；提交结果未确认前不要重复生成或发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:37

具体原因需结合原任务核实。

SWL-NET-006等待服务器响应超时操作人
故障代号
SWL-NET-006
技术键
request_timeout
故障含义
客户端等待服务器响应超过了限制；服务器是否已处理请求尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：请求超时。请先刷新确认操作结果，再决定是否重试。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：请求超时。请先刷新确认操作结果，再决定是否重试。
解决方案
  1. 检查网络后读取原任务或记录；结果未确认前不要重复生成或发布。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
操作人
代码依据
server/enterprise.cjs:85；server/web/assets/app.js:141；server/web/assets/app.js:246；web/app.mjs:184

具体原因需结合原任务核实。

SWL-VAL-059没有此操作权限管理员
故障代号
SWL-VAL-059
技术键
self_delete_forbidden
故障含义
服务器拒绝了当前账号对这项资源的操作权限。
可能原因
  1. 可能触发条件（源码固定说明）：不能删除当前登录账号。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：不能删除当前登录账号。
解决方案
  1. 使用有权限的账号，或请管理员核对权限；不要尝试操作其他人的资源。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:146

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-MAIL-013发件账号状态发生变化管理员
故障代号
SWL-MAIL-013
技术键
sender_managed
故障含义
发件账号由其他入口管理，或与原通知保存的发件配置不一致。
可能原因
  1. 可能：发件账号由其他入口管理，或与原通知保存的发件配置不一致。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 请管理员到对应邮件服务配置入口核对原发件账号与投递记录。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/review-notifications.cjs:35

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-076通知或记录版本已变化操作人
故障代号
SWL-API-076
技术键
stale_record
故障含义
作品或记录已更新，当前操作基于旧版本。
可能原因
  1. 可能触发条件（源码固定说明）：服务器已有更新记录，请先读取最新版本。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：服务器已有更新记录，请先读取最新版本。
解决方案
  1. 重新读取当前作品或记录，核对新版本后再操作，勿发送旧版通知。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/app.cjs:220

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-077异步接口流式参数校验未通过操作人
故障代号
SWL-API-077
技术键
stream_not_supported
故障含义
源码以此代码拒绝以下输入或状态：把stream设为true，但异步任务接口不接受流式响应。
可能原因
  1. 可能：把stream设为true，但异步任务接口不接受流式响应。
先做检查
  1. 定位当前字段或参数：异步接口流式参数。
  2. 逐项核对：把stream设为true，但异步任务接口不接受流式响应。
  3. 该代码的固定校验说明：异步任务不接受流式响应。
解决方案
  1. 关闭stream流式参数，使用原异步任务接口读取结果。
验证恢复
  1. 异步接口流式参数通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:120

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-079没有配置可用模型API账号管理员
故障代号
SWL-API-079
技术键
text_not_configured
故障含义
本版把 text_not_configured 映射到 model_not_configured。当前操作没有找到已启用且配置完整的对应模型API账号。
可能原因
  1. 可能：适配器或服务商返回了此兼容错误码，进入源码中的固定映射分支
  2. 可能：当前操作没有找到已启用且配置完整的对应模型API账号。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
解决方案
  1. 请管理员配置并启用对应文字或图片API账号，填写有效Key、接口和模型名称。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:320

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-AUTH-031小程序授权不可用操作人
故障代号
SWL-AUTH-031
技术键
ticket_consumed
故障含义
小程序授权未通过验证、已过期、已使用，或已因设置变化而失效。
可能原因
  1. 可能触发条件（源码固定说明）：此鉴权凭证已使用，请从小程序重新获取。
先做检查
  1. 按当前字段的格式、允许值及长度要求逐项核对
  2. 必要时对照源码标出的接口和当前资源状态；不要粘贴敏感凭证到排障记录
  3. 对照当前分支核对：此鉴权凭证已使用，请从小程序重新获取。
解决方案
  1. 返回小程序获取新的授权后重新进入；持续失败时请管理员核对签名与验证配置。
验证恢复
  1. 本地及服务端校验通过
  2. 保存后的字段、版本和归属与预期一致
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/miniapp-auth.cjs:150；server/miniapp-auth.cjs:180

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-API-081排版项目安全校验校验未通过操作人
故障代号
SWL-API-081
技术键
unsafe_project
故障含义
源码以此代码拒绝以下输入或状态：排版项目包含不允许的地址、路径或内容。
可能原因
  1. 可能：排版项目包含不允许的地址、路径或内容。
先做检查
  1. 定位当前字段或参数：排版项目安全校验。
  2. 逐项核对：排版项目包含不允许的地址、路径或内容。
  3. 该代码的固定校验说明：排版项目不可包含 HTML、脚本、网络地址或文件路径。
  4. 该代码的固定校验说明：排版项目含有不安全字段。
解决方案
  1. 移除项目中的不允许地址、路径或主动内容，使用应用支持的资源引用。
验证恢复
  1. 排版项目安全校验通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-works.cjs:21；server/enterprise-works.cjs:18

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-061顺序批量图片参数校验未通过操作人
故障代号
SWL-VAL-061
技术键
unsupported_batch
故障含义
源码以此代码拒绝以下输入或状态：使用了尚未支持的顺序批量图片参数。
可能原因
  1. 可能：使用了尚未支持的顺序批量图片参数。
先做检查
  1. 定位当前字段或参数：顺序批量图片参数。
  2. 逐项核对：使用了尚未支持的顺序批量图片参数。
  3. 该代码的固定校验说明：请逐张创建绘图任务，顺序批量生成暂不支持。
  4. 该代码的固定校验说明：顺序批量生成暂不支持。
解决方案
  1. 移除不受支持的顺序批量参数，使用服务端已有四页任务流程。
验证恢复
  1. 顺序批量图片参数通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:124

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-062请求体压缩编码校验未通过操作人
故障代号
SWL-VAL-062
技术键
unsupported_encoding
故障含义
源码以此代码拒绝以下输入或状态：请求体使用了不接受的压缩编码。
可能原因
  1. 可能：请求体使用了不接受的压缩编码。
先做检查
  1. 定位当前字段或参数：请求体压缩编码。
  2. 逐项核对：请求体使用了不接受的压缩编码。
  3. 该代码的固定校验说明：不接受压缩请求体。
解决方案
  1. 发送未压缩或identity编码的请求体。
验证恢复
  1. 请求体压缩编码通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:32

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-001原任务已有处理结果操作人
故障代号
SWL-PUB-001
技术键
already_claimed
故障含义
原任务已经被领取、完成或进入不能重复执行的状态。
可能原因
  1. 可能触发条件（源码固定说明）：作品已经领取发布，不可重复执行。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：作品已经领取发布，不可重复执行。
解决方案
  1. 读取原任务和发布记录；核对已有结果，不要重复领取、生成或发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise-works.cjs:86

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-002当前版本尚未通过审核操作人
故障代号
SWL-PUB-002
技术键
approval_required
故障含义
这份作品的当前版本尚未满足审核通过条件。
可能原因
  1. 可能触发条件（源码固定说明）：请先取得当前版本的管理员审核批准。
  2. 可能触发条件（源码固定说明）：此账号当前需要审核，请重新提交审核后发布。
  3. 可能触发条件（源码固定说明）：请先取得当前作品版本的审核批准。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：请先取得当前版本的管理员审核批准。
  4. 对照当前分支核对：此账号当前需要审核，请重新提交审核后发布。
  5. 对照当前分支核对：请先取得当前作品版本的审核批准。
解决方案
  1. 创作者先完成资料并提交审核，由管理员审核当前版本；修改后需要重新审核。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/cloud-cards.cjs:563；server/enterprise-works.cjs:36；server/enterprise-works.cjs:83

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-003原任务已有处理结果操作人
故障代号
SWL-PUB-003
技术键
claim_complete
故障含义
原任务已经被领取、完成或进入不能重复执行的状态。
可能原因
  1. 可能触发条件（源码固定说明）：该发布结果已锁定，不能重复或覆盖上报。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：该发布结果已锁定，不能重复或覆盖上报。
解决方案
  1. 读取原任务和发布记录；核对已有结果，不要重复领取、生成或发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise-works.cjs:105

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-003作品当前不可直接修改操作人
故障代号
SWL-STATE-003
技术键
direct_work_immutable
故障含义
作品处于已执行、锁定或模型直出文字不可单独修改的状态。
可能原因
  1. 可能触发条件（源码固定说明）：免审发布内容保留在本机，修改后请创建新作品。
  2. 可能触发条件（源码固定说明）：免审作品不能原位转换审核，请使用本机内容重新提交审核。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：免审发布内容保留在本机，修改后请创建新作品。
  4. 对照当前分支核对：免审作品不能原位转换审核，请使用本机内容重新提交审核。
解决方案
  1. 先查看当前作品状态；需要修改时使用允许的编辑入口或另建新作品，不要覆盖已执行记录。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise-works.cjs:62；server/enterprise-works.cjs:64

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-007发布记录UUID校验未通过操作人
故障代号
SWL-PUB-007
技术键
invalid_record_id
故障含义
源码以此代码拒绝以下输入或状态：发布记录编号不是有效UUID。
可能原因
  1. 可能：发布记录编号不是有效UUID。
先做检查
  1. 定位当前字段或参数：发布记录UUID。
  2. 逐项核对：发布记录编号不是有效UUID。
  3. 该代码的固定校验说明：记录编号须为 UUID。
解决方案
  1. 从原发布记录读取正确UUID，不把平台链接或账号ID填作记录编号。
验证恢复
  1. 发布记录UUID通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:205

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-008记录更新时间校验未通过操作人
故障代号
SWL-PUB-008
技术键
invalid_record_time
故障含义
源码以此代码拒绝以下输入或状态：更新时间早于创建时间，或超过当前时间五分钟。
可能原因
  1. 可能：更新时间早于创建时间，或超过当前时间五分钟。
先做检查
  1. 定位当前字段或参数：记录更新时间。
  2. 逐项核对：更新时间早于创建时间，或超过当前时间五分钟。
  3. 该代码的固定校验说明：更新时间不能早于创建时间，也不能超出当前时间 5 分钟。
解决方案
  1. 校正设备时间，使更新时间不早于创建时间且不超前服务器时间五分钟。
验证恢复
  1. 记录更新时间通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:210

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-009分享信息已失效或不完整操作人
故障代号
SWL-PUB-009
技术键
invalid_share
故障含义
当前分享权限、链接有效期或分享响应没有满足使用条件。
可能原因
  1. 可能触发条件（源码固定说明）：请先为当前版本准备小红书。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：请先为当前版本准备小红书。
解决方案
  1. 重新读取作品和当前审核状态，再从作品页面准备有效分享；勿使用旧链接确认发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/cloud-cards.cjs:577；web/app.mjs:912

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-NET-003连接未完成操作人
故障代号
SWL-NET-003
技术键
network_error
故障含义
客户端没有收到完整的服务器响应；具体网络原因和服务器是否已处理请求尚未确认。
可能原因
  1. 可能：设备与服务器之间连接失败。
  2. 可能：请求返回前连接中断。
  3. 可能：服务器或网关没有返回完整响应。
先做检查
  1. 检查设备联网及正式站点是否可访问
  2. 读取原任务或记录，判断提交是否已经生效
解决方案
  1. 恢复设备网络或由服务商修复服务链路
  2. 提交结果不明时先刷新已有状态，不重复操作
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise.cjs:85；server/web/assets/app.js:141；web/app.mjs:89；web/app.mjs:184

具体原因需结合原任务核实。

SWL-NET-004设备尚未联网操作人
故障代号
SWL-NET-004
技术键
network_offline
故障含义
设备当前处于离线状态，无法联系服务器。
可能原因
  1. 可能：设备当前处于离线状态，无法联系服务器。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
解决方案
  1. 连接可用网络后刷新现有任务状态；已经提交的生成任务不要重复提交。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/enterprise.cjs:85；server/web/assets/app.js:141；web/app.mjs:83；web/app.mjs:184；web/app.mjs:674

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-009已有记录与本次提交冲突管理员
故障代号
SWL-STATE-009
技术键
publication_conflict
故障含义
服务器已有同一标识或作品关联的其他内容记录。
可能原因
  1. 可能触发条件（源码固定说明）：发布登记状态需要核实，请联系管理员。
  2. 可能触发条件（源码固定说明）：作品已有其他发布流程，请先核对现有记录。
  3. 可能触发条件（源码固定说明）：发布记录编号已占用，请联系管理员核实。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：发布登记状态需要核实，请联系管理员。
  4. 对照当前分支核对：作品已有其他发布流程，请先核对现有记录。
  5. 对照当前分支核对：发布记录编号已占用，请联系管理员核实。
解决方案
  1. 先读取已有记录，由管理员核对需要保留的版本；不要覆盖或重复发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/cloud-cards.cjs:589；server/cloud-cards.cjs:593；server/cloud-cards.cjs:595

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-010提交结果尚未确认管理员
故障代号
SWL-PUB-010
技术键
publish_sync_unconfirmed
故障含义
客户端尚未确认本次提交是否已经保存，原请求可能已经处理。
可能原因
  1. 可能：客户端尚未确认本次提交是否已经保存，原请求可能已经处理。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
解决方案
  1. 读取原任务、作品或发布记录，请管理员核对原请求；不要重复生成或发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
web/app.mjs:936

具体原因需结合原任务核实。

SWL-PUB-011已确认的发布链接不能覆盖管理员
故障代号
SWL-PUB-011
技术键
published_link_locked
故障含义
这条记录已关联确认后的平台发布结果。
可能原因
  1. 可能触发条件（源码固定说明）：已登记的发布链接不能覆盖。
  2. 可能触发条件（源码固定说明）：已确认发布的记录不能覆盖为其他结果或链接。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：已登记的发布链接不能覆盖。
  4. 对照当前分支核对：已确认发布的记录不能覆盖为其他结果或链接。
解决方案
  1. 保留原发布记录；链接确需修正时请管理员核实实际平台结果后处理。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:195；server/app.cjs:219；server/enterprise-works.cjs:121

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-011已有记录与本次提交冲突管理员
故障代号
SWL-STATE-011
技术键
record_conflict
故障含义
服务器已有同一标识或作品关联的其他内容记录。
可能原因
  1. 可能触发条件（源码固定说明）：发布记录归属冲突。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：发布记录归属冲突。
解决方案
  1. 先读取已有记录，由管理员核对需要保留的版本；不要覆盖或重复发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/publication-storage.cjs:81

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-012没有此操作权限管理员
故障代号
SWL-PUB-012
技术键
record_owner
故障含义
服务器拒绝了当前账号对这项资源的操作权限。
可能原因
  1. 可能触发条件（源码固定说明）：只能同步自己创建的发布记录。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：只能同步自己创建的发布记录。
解决方案
  1. 使用有权限的账号，或请管理员核对权限；不要尝试操作其他人的资源。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/app.cjs:205

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-013分享信息已失效或不完整操作人
故障代号
SWL-PUB-013
技术键
share_expired
故障含义
当前分享权限、链接有效期或分享响应没有满足使用条件。
可能原因
  1. 可能触发条件（源码固定说明）：本次分享已失效，请重新准备小红书。
  2. 可能触发条件（源码固定说明）：图片分享已过期或不可用。
  3. 可能触发条件（源码固定说明）：图片分享已失效。
  4. 可能触发条件（源码固定说明）：图片分享版本已失效。
  5. 可能触发条件（源码固定说明）：图片分享权限已失效。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：本次分享已失效，请重新准备小红书。
  4. 对照当前分支核对：图片分享已过期或不可用。
  5. 对照当前分支核对：图片分享已失效。
  6. 对照当前分支核对：图片分享版本已失效。
  7. 对照当前分支核对：图片分享权限已失效。
解决方案
  1. 重新读取作品和当前审核状态，再从作品页面准备有效分享；勿使用旧链接确认发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/cloud-cards.cjs:585；server/cloud-cards.cjs:611；server/cloud-cards.cjs:612；server/cloud-cards.cjs:614；server/cloud-cards.cjs:615

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-014分享信息已失效或不完整操作人
故障代号
SWL-PUB-014
技术键
share_invalid_response
故障含义
当前分享权限、链接有效期或分享响应没有满足使用条件。
可能原因
  1. 可能：当前分享权限、链接有效期或分享响应没有满足使用条件。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
解决方案
  1. 重新读取作品和当前审核状态，再从作品页面准备有效分享；勿使用旧链接确认发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
操作人
代码依据
web/app.mjs:906

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-015已有记录与本次提交冲突管理员
故障代号
SWL-STATE-015
技术键
work_conflict
故障含义
服务器已有同一标识或作品关联的其他内容记录。
可能原因
  1. 可能触发条件（源码固定说明）：同一免审作品编号对应的内容已发生变化，请使用新的作品编号。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：同一免审作品编号对应的内容已发生变化，请使用新的作品编号。
解决方案
  1. 先读取已有记录，由管理员核对需要保留的版本；不要覆盖或重复发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/enterprise-works.cjs:45

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-016已有记录与本次提交冲突管理员
故障代号
SWL-STATE-016
技术键
work_exists
故障含义
服务器已有同一标识或作品关联的其他内容记录。
可能原因
  1. 可能触发条件（源码固定说明）：此编号已用于另一作品。
  2. 可能触发条件（源码固定说明）：作品编号冲突。
  3. 可能触发条件（源码固定说明）：此编号已用于发布记录，请创建新的作品编号。
  4. 可能触发条件（源码固定说明）：作品编号已存在或已用于发布记录。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：此编号已用于另一作品。
  4. 对照当前分支核对：作品编号冲突。
  5. 对照当前分支核对：此编号已用于发布记录，请创建新的作品编号。
  6. 对照当前分支核对：作品编号已存在或已用于发布记录。
解决方案
  1. 先读取已有记录，由管理员核对需要保留的版本；不要覆盖或重复发布。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/cloud-cards.cjs:247；server/cloud-cards.cjs:433；server/enterprise-works.cjs:46；server/enterprise-works.cjs:60

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-PUB-015作品当前不可直接修改操作人
故障代号
SWL-PUB-015
技术键
work_locked
故障含义
作品处于已执行、锁定或模型直出文字不可单独修改的状态。
可能原因
  1. 可能触发条件（源码固定说明）：作品当前状态不能编辑。
  2. 可能触发条件（源码固定说明）：排队期间作品状态已变更，不能编辑。
  3. 可能触发条件（源码固定说明）：此作品当前不能交给小红书编辑页。
  4. 可能触发条件（源码固定说明）：已执行或结果不明的作品不可原位修改，请创建新作品。
先做检查
  1. 读取原作品的当前版本、审核状态和关联发布记录
  2. 核对发布账号标签、图片清单和平台实际结果
  3. 对照当前分支核对：作品当前状态不能编辑。
  4. 对照当前分支核对：排队期间作品状态已变更，不能编辑。
  5. 对照当前分支核对：此作品当前不能交给小红书编辑页。
  6. 对照当前分支核对：已执行或结果不明的作品不可原位修改，请创建新作品。
解决方案
  1. 先查看当前作品状态；需要修改时使用允许的编辑入口或另建新作品，不要覆盖已执行记录。
验证恢复
  1. 当前作品版本与审核、发布记录一致
  2. 平台结果已核实，没有重复发布同一内容
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
操作人
代码依据
server/cloud-cards.cjs:485；server/cloud-cards.cjs:507；server/cloud-cards.cjs:559；server/enterprise-works.cjs:62

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-001已有记录与本次提交冲突管理员
故障代号
SWL-IMG-001
技术键
asset_conflict
故障含义
服务器已有同一标识或作品关联的其他内容记录。
可能原因
  1. 可能触发条件（源码固定说明）：同一资源编号对应不同图片。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：同一资源编号对应不同图片。
解决方案
  1. 先读取已有记录，由管理员核对需要保留的版本；不要覆盖或重复发布。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/enterprise-works.cjs:53

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-002原图片不可用服务商
故障代号
SWL-IMG-002
技术键
asset_not_found
故障含义
服务器没有找到当前操作所需的原图片或背景素材。
可能原因
  1. 可能触发条件（源码固定说明）：项目资源不存在或无权访问。
  2. 可能触发条件（源码固定说明）：项目资源不存在。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：项目资源不存在或无权访问。
  4. 对照当前分支核对：项目资源不存在。
解决方案
  1. 请管理员与服务商核对原文件和保留状态；有本机副本时优先从副本恢复。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/enterprise-works.cjs:51；server/enterprise-works.cjs:53

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-003原图片不可用服务商
故障代号
SWL-IMG-003
技术键
background_missing
故障含义
服务器没有找到当前操作所需的原图片或背景素材。
可能原因
  1. 可能触发条件（源码固定说明）：此作品的云端背景不完整。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：此作品的云端背景不完整。
解决方案
  1. 请管理员与服务商核对原文件和保留状态；有本机副本时优先从副本恢复。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/cloud-cards.cjs:496

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-004图片下载未完成服务商
故障代号
SWL-IMG-004
技术键
image_download_failed
故障含义
模型返回图片的下载地址或下载过程未通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：背景图片暂不可下载，未发起新的模型调用。
  2. 可能触发条件（源码固定说明）：背景图片下载中断。
  3. 可能触发条件（源码固定说明）：背景图片下载失败，未发起新的模型调用。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：背景图片暂不可下载，未发起新的模型调用。
  4. 对照当前分支核对：背景图片下载中断。
  5. 对照当前分支核对：背景图片下载失败，未发起新的模型调用。
解决方案
  1. 请服务商检查原任务的图片获取记录；优先恢复已生成图片，不要重新调用图片模型。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/cloud-cards.cjs:74；server/cloud-cards.cjs:77；server/cloud-cards.cjs:81

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-005图片暂时无法显示操作人
故障代号
SWL-IMG-005
技术键
image_load_failed
故障含义
客户端未能显示这张图片；具体是连接、权限还是文件问题尚未确认。
可能原因
  1. 可能：客户端未能显示这张图片；具体是连接、权限还是文件问题尚未确认。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
解决方案
  1. 检查网络并重新读取作品；仍无法显示时请管理员核对原图片，勿重复生成。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
操作人
代码依据
server/enterprise.cjs:85；server/web/assets/app.js:141；web/app.mjs:184；web/app.mjs:604；web/app.mjs:700

具体原因需结合原任务核实。

SWL-IMG-006原图片不可用服务商
故障代号
SWL-IMG-006
技术键
image_missing
故障含义
服务器没有找到当前操作所需的原图片或背景素材。
可能原因
  1. 可能触发条件（源码固定说明）：图片文件暂不可用。
  2. 可能触发条件（源码固定说明）：图片暂不可用。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：图片文件暂不可用。
  4. 对照当前分支核对：图片暂不可用。
解决方案
  1. 请管理员与服务商核对原文件和保留状态；有本机副本时优先从副本恢复。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/app.cjs:184；server/enterprise-works.cjs:109；server/enterprise.cjs:143

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-007原任务的图片模型已变化管理员
故障代号
SWL-IMG-007
技术键
image_model_changed
故障含义
原任务保存的图片模型与当前模型配置不一致，已停止继续购买图片。
可能原因
  1. 可能触发条件（源码固定说明）：图片模型设置已变化，直出词卡任务已停止；不会改用其他模型或自动重新调用。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：图片模型设置已变化，直出词卡任务已停止；不会改用其他模型或自动重新调用。
解决方案
  1. 请管理员核对原任务和模型配置；原任务不会自动改用其他模型。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
管理员
代码依据
server/cloud-cards.cjs:270；server/enterprise-models.cjs:170

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-008图片或请求大小不符合要求操作人
故障代号
SWL-IMG-008
技术键
image_too_large
故障含义
提交的图片数量、格式或大小超过了当前接口允许的范围。
可能原因
  1. 可能触发条件（源码固定说明）：生成图片超过单张十二 MB 限制。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：生成图片超过单张十二 MB 限制。
解决方案
  1. 按页面要求调整图片数量、格式和体积后提交；不要重复发送相同超限内容。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
操作人
代码依据
server/cloud-cards.cjs:353

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-009图片下载未完成服务商
故障代号
SWL-IMG-009
技术键
image_unavailable
故障含义
模型返回图片的下载地址或下载过程未通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：背景图片域名暂不可用，未发起新的模型调用。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：背景图片域名暂不可用，未发起新的模型调用。
解决方案
  1. 请服务商检查原任务的图片获取记录；优先恢复已生成图片，不要重新调用图片模型。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/cloud-cards.cjs:70

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-010通知或记录版本已变化操作人
故障代号
SWL-IMG-010
技术键
image_updated
故障含义
作品或记录已更新，当前操作基于旧版本。
可能原因
  1. 可能触发条件（源码固定说明）：图片已更新，请重新打开作品。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：图片已更新，请重新打开作品。
解决方案
  1. 重新读取当前作品或记录，核对新版本后再操作，勿发送旧版通知。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
操作人
代码依据
server/enterprise.cjs:43

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-011生成图片未通过检查服务商
故障代号
SWL-IMG-011
技术键
invalid_background
故障含义
图片格式、编码、尺寸或成品数量未满足当前词卡要求。
可能原因
  1. 可能触发条件（源码固定说明）：图片模型未返回 PNG、JPEG 或 WebP 图片。
  2. 可能触发条件（源码固定说明）：图片模型返回的图片编码无效。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：图片模型未返回 PNG、JPEG 或 WebP 图片。
  4. 对照当前分支核对：图片模型返回的图片编码无效。
解决方案
  1. 请服务商检查原任务已保存图片及校验信息；不要为同一任务重复购买图片。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/cloud-cards.cjs:62；server/cloud-cards.cjs:409

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-012词卡背景模式校验未通过操作人
故障代号
SWL-IMG-012
技术键
invalid_background_mode
故障含义
源码以此代码拒绝以下输入或状态：背景模式不是AI生成或纯色纸底之一。
可能原因
  1. 可能：背景模式不是AI生成或纯色纸底之一。
先做检查
  1. 定位当前字段或参数：词卡背景模式。
  2. 逐项核对：背景模式不是AI生成或纯色纸底之一。
  3. 该代码的固定校验说明：请选择 AI 背景或纯色纸底。
解决方案
  1. 在页面选择AI背景或纯色纸底之一。
验证恢复
  1. 词卡背景模式通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/cloud-cards.cjs:222

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-013图片文件或编码没有通过检查操作人
故障代号
SWL-IMG-013
技术键
invalid_image
故障含义
图片校验器拒绝文件、Base64编码、格式结构、静态图限制、尺寸或解码体积。
可能原因
  1. 可能：文件损坏、截断、扩展名与真实格式不符
  2. 可能：Base64不规范或包含多余数据
  3. 可能：图片过大，或使用动画PNG/WebP
先做检查
  1. 核对服务器返回的安全校验说明与图片实际格式
  2. 检查单图、合计大小、尺寸及像素限制；本版还检查PNG块CRC和解码数据
  3. 使用静态PNG/JPEG/WebP，避免只改扩展名
解决方案
  1. 从可信原图重新导出受支持的静态图片并压缩
  2. 若是模型已付费结果，由服务商优先恢复原结果
验证恢复
  1. 同一文件通过服务端decodeImages；图片能够完整显示且尺寸符合业务要求
重试规则
可修复后重新上传同一张图片；不要为上传校验失败自动重新购买图片。
处理责任
操作人
代码依据
server/images.cjs:6；server/images.cjs:7；server/images.cjs:11；server/images.cjs:15；server/images.cjs:17

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-014四页图片批次校验未通过操作人
故障代号
SWL-IMG-014
技术键
invalid_image_group
故障含义
源码以此代码拒绝以下输入或状态：图片批次超过四张或不属于同一词卡。
可能原因
  1. 可能：图片批次超过四张或不属于同一词卡。
先做检查
  1. 定位当前字段或参数：四页图片批次。
  2. 逐项核对：图片批次超过四张或不属于同一词卡。
  3. 该代码的固定校验说明：同一词卡每次最多制作四张图片。
  4. 该代码的固定校验说明：图片请求必须属于同一词卡。
解决方案
  1. 同一批次仅提交同一词卡的一至四个图片请求。
验证恢复
  1. 四页图片批次通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/enterprise-models.cjs:155；server/enterprise-models.cjs:166

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-015图片下载未完成服务商
故障代号
SWL-IMG-015
技术键
invalid_image_url
故障含义
模型返回图片的下载地址或下载过程未通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：图片模型返回的下载地址无效。
  2. 可能触发条件（源码固定说明）：图片下载须使用公开 HTTPS 地址。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：图片模型返回的下载地址无效。
  4. 对照当前分支核对：图片下载须使用公开 HTTPS 地址。
解决方案
  1. 请服务商检查原任务的图片获取记录；优先恢复已生成图片，不要重新调用图片模型。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/cloud-cards.cjs:65；server/cloud-cards.cjs:66

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-016图片或请求大小不符合要求操作人
故障代号
SWL-IMG-016
技术键
invalid_images
故障含义
提交的图片数量、格式或大小超过了当前接口允许的范围。
可能原因
  1. 可能触发条件（源码固定说明）：成品图片最多 20 张。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：成品图片最多 20 张。
解决方案
  1. 按页面要求调整图片数量、格式和体积后提交；不要重复发送相同超限内容。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
操作人
代码依据
server/enterprise-works.cjs:55

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-017成品质量检查未通过服务商
故障代号
SWL-IMG-017
技术键
invalid_render_receipt
故障含义
渲染结果或质量凭据没有通过服务器成品校验。
可能原因
  1. 可能：渲染结果或质量凭据没有通过服务器成品校验。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 核对原图片格式、尺寸和已保存的渲染材料
  3. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
解决方案
  1. 请服务商检查原任务的成品图片及质量凭据，修复后使用原素材恢复。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
docs/troubleshooting/faults.json:1

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-018图片下载未完成服务商
故障代号
SWL-IMG-018
技术键
private_image_url
故障含义
模型返回图片的下载地址或下载过程未通过检查。
可能原因
  1. 可能触发条件（源码固定说明）：背景图片不能来自内网或保留地址。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：背景图片不能来自内网或保留地址。
解决方案
  1. 请服务商检查原任务的图片获取记录；优先恢复已生成图片，不要重新调用图片模型。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/cloud-cards.cjs:71

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-019已有任务正在处理操作人
故障代号
SWL-IMG-019
技术键
render_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：此作品正在服务器重新排版，请等待完成。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：此作品正在服务器重新排版，请等待完成。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/cloud-cards.cjs:486

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-020词卡渲染未完成服务商
故障代号
SWL-IMG-020
技术键
render_failed
故障含义
服务器渲染执行或成品质量检查没有成功完成。
可能原因
  1. 可能：渲染子进程以非零状态退出。
  2. 可能：receipt.json缺失或不是有效JSON。
  3. 可能：ok或qualityPassed不是true。
  4. 可能：成品或背景数量不是四张。
先做检查
  1. 服务商核对原render日志与质量凭据
  2. 检查渲染输入、字体、背景和输出文件是否完整
解决方案
  1. 修复导致子进程失败的运行环境或素材
  2. 使用原背景和文字重新排版，不重新购买模型
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/cloud-cards.cjs:345；server/cloud-cards.cjs:347

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-021成品质量检查未通过服务商
故障代号
SWL-IMG-021
技术键
render_quality_failed
故障含义
渲染结果或质量凭据没有通过服务器成品校验。
可能原因
  1. 可能：渲染结果或质量凭据没有通过服务器成品校验。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 核对原图片格式、尺寸和已保存的渲染材料
  3. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
解决方案
  1. 请服务商检查原任务的成品图片及质量凭据，修复后使用原素材恢复。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
docs/troubleshooting/faults.json:1

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-022词卡排版队列已满操作人
故障代号
SWL-IMG-022
技术键
render_queue_full
故障含义
非生成类排版保存请求到达时，排版队列已经达到本版16项上限；付费生成有保留队列位置。
可能原因
  1. 可能：同时等待排版的编辑保存达到队列上限
先做检查
  1. 查看当前作品是否已有排版请求
  2. 核对服务器排版队列及渲染进程是否持续前进
解决方案
  1. 等待现有排版完成后保存同一作品
  2. 队列长时间不动时由服务商检查渲染进程
验证恢复
  1. 保存能被队列接收；作品版本没有被旧请求覆盖
重试规则
仅等待后重试排版保存；不要重新调用文字或图片模型。
处理责任
操作人
代码依据
server/cloud-cards.cjs:306

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-023作品需要完成排版操作人
故障代号
SWL-IMG-023
技术键
render_required
故障含义
当前版本尚未保存通过校验的成品图片。
可能原因
  1. 可能触发条件（源码固定说明）：词卡尚未完成服务器四页渲染。
  2. 可能触发条件（源码固定说明）：词卡成品图片尚未准备完整。
先做检查
  1. 核对原图片格式、尺寸和已保存的渲染材料
  2. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
  3. 对照当前分支核对：词卡尚未完成服务器四页渲染。
  4. 对照当前分支核对：词卡成品图片尚未准备完整。
解决方案
  1. 先完成当前作品的排版保存；失败时请服务商从已保存素材恢复。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
操作人
代码依据
server/cloud-cards.cjs:534；server/cloud-cards.cjs:536；server/cloud-cards.cjs:537；server/cloud-cards.cjs:550

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-024词卡渲染超时服务商
故障代号
SWL-IMG-024
技术键
render_timeout
故障含义
词卡排版渲染超过了服务器允许的时间。
可能原因
  1. 可能：词卡排版渲染超过了服务器允许的时间。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 核对原图片格式、尺寸和已保存的渲染材料
  3. 服务商检查原任务质量凭据、渲染程序、字体及文件可读性
解决方案
  1. 请服务商检查原渲染任务和资源占用，确认原任务状态后从已保存素材恢复。
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
服务商
代码依据
docs/troubleshooting/faults.json:1

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-IMG-025词卡渲染环境不可用服务商
故障代号
SWL-IMG-025
技术键
renderer_unavailable
故障含义
服务器未能启动词卡渲染程序。
可能原因
  1. 可能：渲染程序无法启动。
  2. 可能：运行程序、依赖或执行权限不满足要求。
先做检查
  1. 检查原子进程启动错误、运行路径和渲染依赖
  2. 核对字体与浏览器/渲染运行环境是否可用
解决方案
  1. 服务商修复启动环境和权限
  2. 保留原任务输入，从已保存素材恢复
验证恢复
  1. 已有素材能生成四张通过质量检查的成品
  2. 原图仍可读取；没有因显示或排版问题重复购买图片
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/cloud-cards.cjs:346

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-MAIL-001邮件发送配置尚未完成管理员
故障代号
SWL-MAIL-001
技术键
blocked_not_configured
故障含义
发件授权、收件人、审核入口或投递开关尚未满足发送条件。
可能原因
  1. 可能：发件授权、收件人、审核入口或投递开关尚未满足发送条件。
先做检查
  1. 先检查原通知和服务商投递记录，区分failed与unknown
  2. 核对发件授权、收件人、投递开关和通知所对应的作品版本
解决方案
  1. 请管理员在邮件与通知设置中完成配置并验证，完成后再处理原通知或报告。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:372；server/chat-insights.cjs:378；server/chat-insights.cjs:379；server/chat-insights.cjs:380；server/web/assets/app.js:178

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-010邮箱地址校验未通过操作人
故障代号
SWL-VAL-010
技术键
invalid_email
故障含义
源码以此代码拒绝以下输入或状态：邮箱语法、长度或本地部分不符合校验要求。
可能原因
  1. 可能：邮箱语法、长度或本地部分不符合校验要求。
先做检查
  1. 定位当前字段或参数：邮箱地址。
  2. 逐项核对：邮箱语法、长度或本地部分不符合校验要求。
解决方案
  1. 重新填写单个有效邮箱地址，去除首尾空白并检查邮箱本地部分和域名。
验证恢复
  1. 邮箱地址通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/review-notifications.cjs:11

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-MAIL-002邮件投递未成功管理员
故障代号
SWL-MAIL-002
技术键
mail_auth_failed
故障含义
邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
可能原因
  1. 可能：邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先检查原通知和服务商投递记录，区分failed与unknown
  3. 核对发件授权、收件人、投递开关和通知所对应的作品版本
解决方案
  1. 请管理员检查发件授权、收件人及服务商额度和投递记录，再决定是否重发。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-MAIL-003邮件投递未成功管理员
故障代号
SWL-MAIL-003
技术键
mail_failed
故障含义
邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
可能原因
  1. 可能：邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先检查原通知和服务商投递记录，区分failed与unknown
  3. 核对发件授权、收件人、投递开关和通知所对应的作品版本
解决方案
  1. 请管理员检查发件授权、收件人及服务商额度和投递记录，再决定是否重发。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-MAIL-004邮件投递未成功管理员
故障代号
SWL-MAIL-004
技术键
mail_quota_exceeded
故障含义
邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
可能原因
  1. 可能：邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先检查原通知和服务商投递记录，区分failed与unknown
  3. 核对发件授权、收件人、投递开关和通知所对应的作品版本
解决方案
  1. 请管理员检查发件授权、收件人及服务商额度和投递记录，再决定是否重发。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-MAIL-005邮件结果需要核实管理员
故障代号
SWL-MAIL-005
技术键
mail_unknown
故障含义
邮件可能已提交，当前结果或可重发条件尚未确认。
可能原因
  1. 可能：邮件可能已提交，当前结果或可重发条件尚未确认。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先检查原通知和服务商投递记录，区分failed与unknown
  3. 核对发件授权、收件人、投递开关和通知所对应的作品版本
解决方案
  1. 先核对收件箱与服务商投递记录；由管理员确认未投递后再处理，避免重复发信。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-MAIL-006已有任务正在处理操作人
故障代号
SWL-MAIL-006
技术键
notification_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：正在发送通知，请稍后再试。
先做检查
  1. 先检查原通知和服务商投递记录，区分failed与unknown
  2. 核对发件授权、收件人、投递开关和通知所对应的作品版本
  3. 对照当前分支核对：正在发送通知，请稍后再试。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
操作人
代码依据
server/review-notifications.cjs:104

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-MAIL-007邮件投递未成功管理员
故障代号
SWL-MAIL-007
技术键
notification_failed
故障含义
邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
可能原因
  1. 可能：发件服务明确未接受请求。
  2. 可能：发件授权或服务商发送额度存在问题。
  3. 可能：通知处理过程本身发生异常。
先做检查
  1. 读取原投递记录和安全结果状态
  2. 核对发件提供方、授权与额度；区分明确拒绝和结果不明
解决方案
  1. 管理员修复被拒绝的发件配置或额度
  2. 核实原信未被接受后，再按系统允许入口处理补发
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
server/chat-insights.cjs:397；server/enterprise.cjs:37；server/enterprise.cjs:39；server/review-notifications.cjs:56；server/review-notifications.cjs:58

具体原因需结合原任务核实。

SWL-MAIL-008邮件发送配置尚未完成管理员
故障代号
SWL-MAIL-008
技术键
notification_not_configured
故障含义
发件授权、收件人、审核入口或投递开关尚未满足发送条件。
可能原因
  1. 可能：发件授权、收件人或审核入口缺失。
  2. 可能：邮件投递开关未启用。
  3. 可能：服务器托管的QQ发件账号尚未授权。
先做检查
  1. 查看当前实际邮件提供方与配置完成状态
  2. 分别核对发件授权、默认收件人、审核入口和投递开关
解决方案
  1. 管理员在对应邮件入口完成发件授权和必要设置
  2. 保存后验证配置；原通知按允许状态处理
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
server/review-notifications.cjs:43；server/review-notifications.cjs:100；server/review-notifications.cjs:104；server/web/assets/app.js:180

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-MAIL-009邮件结果需要核实管理员
故障代号
SWL-MAIL-009
技术键
notification_not_retryable
故障含义
邮件可能已提交，当前结果或可重发条件尚未确认。
可能原因
  1. 可能触发条件（源码固定说明）：此通知不需要补发或正在发送。
先做检查
  1. 先检查原通知和服务商投递记录，区分failed与unknown
  2. 核对发件授权、收件人、投递开关和通知所对应的作品版本
  3. 对照当前分支核对：此通知不需要补发或正在发送。
解决方案
  1. 先核对收件箱与服务商投递记录；由管理员确认未投递后再处理，避免重复发信。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
server/review-notifications.cjs:101

具体原因需结合原任务核实。

SWL-MAIL-010邮件投递未成功管理员
故障代号
SWL-MAIL-010
技术键
notification_rejected
故障含义
邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
可能原因
  1. 可能：邮件服务明确报告本次投递失败；具体配置或服务商拒绝原因需要管理员核对。
先做检查
  1. 本次静态扫描只找到共享目录定义，未发现其他已识别的字面量引用；动态映射仍可能使用此码，不能据此判断它不会出现。
  2. 先检查原通知和服务商投递记录，区分failed与unknown
  3. 核对发件授权、收件人、投递开关和通知所对应的作品版本
解决方案
  1. 请管理员检查发件授权、收件人及服务商额度和投递记录，再决定是否重发。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
docs/troubleshooting/faults.json:1

具体原因需结合原任务核实。

SWL-MAIL-011发件账号状态发生变化管理员
故障代号
SWL-MAIL-011
技术键
notification_sender_changed
故障含义
发件账号由其他入口管理，或与原通知保存的发件配置不一致。
可能原因
  1. 可能触发条件（源码固定说明）：发件通道或邮箱已变更，请先核对原投递记录。
先做检查
  1. 先检查原通知和服务商投递记录，区分failed与unknown
  2. 核对发件授权、收件人、投递开关和通知所对应的作品版本
  3. 对照当前分支核对：发件通道或邮箱已变更，请先核对原投递记录。
解决方案
  1. 请管理员到对应邮件服务配置入口核对原发件账号与投递记录。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
管理员
代码依据
server/review-notifications.cjs:101

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-MAIL-012邮件结果需要核实管理员
故障代号
SWL-MAIL-012
技术键
notification_unknown
故障含义
邮件可能已提交，当前结果或可重发条件尚未确认。
可能原因
  1. 可能：请求可能已被邮件服务接受，但响应未确认。
  2. 可能：服务中断时原邮件仍在sending状态。
先做检查
  1. 先核对收件箱及原服务商投递记录
  2. 核对原发件提供方和幂等键关联记录
解决方案
  1. 由管理员确认原投递结果；QQ结果不明不补发
  2. 不能确认时保持unknown，不把刷新变成发送
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
结果未确认：只刷新原任务或记录，先由对应负责人核对处理和费用；不得自动重复生成、发布或发信。
处理责任
管理员
代码依据
server/chat-insights.cjs:397；server/enterprise.cjs:39；server/review-notifications.cjs:56；server/web/assets/app.js:180

具体原因需结合原任务核实。

SWL-MAIL-014通知或记录版本已变化操作人
故障代号
SWL-MAIL-014
技术键
stale_notification
故障含义
作品或记录已更新，当前操作基于旧版本。
可能原因
  1. 可能触发条件（源码固定说明）：作品已修改或已完成审核，请勿补发旧通知。
先做检查
  1. 先检查原通知和服务商投递记录，区分failed与unknown
  2. 核对发件授权、收件人、投递开关和通知所对应的作品版本
  3. 对照当前分支核对：作品已修改或已完成审核，请勿补发旧通知。
解决方案
  1. 重新读取当前作品或记录，核对新版本后再操作，勿发送旧版通知。
验证恢复
  1. 服务商接受记录与原通知状态一致
  2. 收件箱是否实际收到另行核对；未确认前没有重复发信
重试规则
先核对原投递状态；unknown不得盲目补发，特别是QQ结果不明已禁止补发。修复配置后由管理员按允许状态处理。
处理责任
操作人
代码依据
server/review-notifications.cjs:101

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-001报告PDF尚未准备好服务商
故障代号
SWL-RPT-001
技术键
blocked_pdf
故障含义
报告PDF生成、文件路径或结果校验未满足投递要求。
可能原因
  1. 可能：报告PDF生成、文件路径或结果校验未满足投递要求。
先做检查
  1. 核对原报告状态、PDF准备结果和邮件投递状态
  2. 服务商检查PDF运行环境、文件大小、头尾校验及目录边界
解决方案
  1. 请服务商检查原报告、PDF渲染环境和保存文件；报告可用前不要发送缺失附件的邮件。
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:383；server/web/assets/app.js:178；server/web/assets/app.js:180

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-002周报数据结构校验未通过服务商
故障代号
SWL-RPT-002
技术键
invalid_report
故障含义
源码以此代码拒绝以下输入或状态：周报主题、日期、账号列表或整体数据结构没有通过校验。
可能原因
  1. 可能：周报主题、日期、账号列表或整体数据结构没有通过校验。
先做检查
  1. 定位当前字段或参数：周报数据结构。
  2. 逐项核对：周报主题、日期、账号列表或整体数据结构没有通过校验。
  3. 该代码的固定校验说明：周报主题数据格式无效。
  4. 该代码的固定校验说明：周报数据格式无效。
  5. 该代码的固定校验说明：周报日期格式无效。
  6. 该代码的固定校验说明：周报账号列表格式无效或超过上限。
解决方案
  1. 修正报告日期、主题计数与主理人数组；修复后先生成并校验原报告PDF。
验证恢复
  1. 周报数据结构通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
服务商
代码依据
server/report-pdf.cjs:14；server/report-pdf.cjs:16；server/report-pdf.cjs:18；server/report-pdf.cjs:19

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-003报告PDF尚未准备好服务商
故障代号
SWL-RPT-003
技术键
report_path_invalid
故障含义
报告PDF生成、文件路径或结果校验未满足投递要求。
可能原因
  1. 可能触发条件（源码固定说明）：周报文件路径无效。
  2. 可能触发条件（源码固定说明）：周报目录无效。
先做检查
  1. 核对原报告状态、PDF准备结果和邮件投递状态
  2. 服务商检查PDF运行环境、文件大小、头尾校验及目录边界
  3. 对照当前分支核对：周报文件路径无效。
  4. 对照当前分支核对：周报目录无效。
解决方案
  1. 请服务商检查原报告、PDF渲染环境和保存文件；报告可用前不要发送缺失附件的邮件。
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/report-pdf.cjs:30；server/report-pdf.cjs:78；server/report-pdf.cjs:79

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-004已有任务正在处理操作人
故障代号
SWL-RPT-004
技术键
report_pdf_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：已有周报 PDF 正在生成，请稍后重试。
先做检查
  1. 核对原报告状态、PDF准备结果和邮件投递状态
  2. 服务商检查PDF运行环境、文件大小、头尾校验及目录边界
  3. 对照当前分支核对：已有周报 PDF 正在生成，请稍后重试。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/report-pdf.cjs:80

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-005报告PDF尚未准备好服务商
故障代号
SWL-RPT-005
技术键
report_pdf_invalid
故障含义
报告PDF生成、文件路径或结果校验未满足投递要求。
可能原因
  1. 可能：输出不是合法PDF或缺少文件头/EOF。
  2. 可能：PDF太小、超过十MB或不是普通文件。
  3. 可能：真实路径或符号链接检查未通过。
先做检查
  1. 核对原报告PDF大小、头尾和真实路径
  2. 确认文件不是转换中尚未写完的临时产物
解决方案
  1. 服务商修复报告渲染和文件保存流程
  2. 先让原PDF通过验证，再处理原报告投递
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/report-pdf.cjs:32；server/report-pdf.cjs:34

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-006报告PDF尚未准备好服务商
故障代号
SWL-RPT-006
技术键
report_pdf_unavailable
故障含义
报告PDF生成、文件路径或结果校验未满足投递要求。
可能原因
  1. 可能：报告PDF生成、文件路径或结果校验未满足投递要求。
先做检查
  1. 核对原报告状态、PDF准备结果和邮件投递状态
  2. 服务商检查PDF运行环境、文件大小、头尾校验及目录边界
解决方案
  1. 请服务商检查原报告、PDF渲染环境和保存文件；报告可用前不要发送缺失附件的邮件。
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/insights-services.cjs:79

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-007报告PDF尚未准备好服务商
故障代号
SWL-RPT-007
技术键
report_render_failed
故障含义
报告PDF生成、文件路径或结果校验未满足投递要求。
可能原因
  1. 可能：报告渲染子进程非零退出。
  2. 可能：原报告内容触发渲染错误。
先做检查
  1. 查看原报告渲染日志与输入结构
  2. 核对输出文件是否缺失或校验失败
解决方案
  1. 服务商修复报告内容或渲染环境
  2. 成功生成并验证原PDF后再继续投递
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/report-pdf.cjs:56；server/web/assets/app.js:180

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-008报告处理未完成服务商
故障代号
SWL-RPT-008
技术键
report_render_interrupted
故障含义
报告处理被中断，或报告内容、大小不符合要求。
可能原因
  1. 可能触发条件（源码固定说明）：周报 PDF 渲染超时或已停止。
先做检查
  1. 核对原报告状态、PDF准备结果和邮件投递状态
  2. 服务商检查PDF运行环境、文件大小、头尾校验及目录边界
  3. 对照当前分支核对：周报 PDF 渲染超时或已停止。
解决方案
  1. 请管理员与服务商核对报告任务和已有结果，修复内容或运行环境后处理原报告。
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/report-pdf.cjs:51；server/report-pdf.cjs:65

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-009报告处理未完成服务商
故障代号
SWL-RPT-009
技术键
report_renderer_closed
故障含义
报告处理被中断，或报告内容、大小不符合要求。
可能原因
  1. 可能触发条件（源码固定说明）：服务器正在停止。
  2. 可能触发条件（源码固定说明）：周报 PDF 服务正在停止。
先做检查
  1. 核对原报告状态、PDF准备结果和邮件投递状态
  2. 服务商检查PDF运行环境、文件大小、头尾校验及目录边界
  3. 对照当前分支核对：服务器正在停止。
  4. 对照当前分支核对：周报 PDF 服务正在停止。
解决方案
  1. 请管理员与服务商核对报告任务和已有结果，修复内容或运行环境后处理原报告。
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/report-pdf.cjs:48；server/report-pdf.cjs:67；server/report-pdf.cjs:74

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-010报告PDF尚未准备好服务商
故障代号
SWL-RPT-010
技术键
report_renderer_unavailable
故障含义
报告PDF生成、文件路径或结果校验未满足投递要求。
可能原因
  1. 可能：报告渲染子进程启动失败。
  2. 可能：Python或PDF渲染依赖不可用。
  3. 可能：执行权限或程序路径异常。
先做检查
  1. 检查报告渲染程序和依赖是否可运行
  2. 核对原报告任务日志及执行权限
解决方案
  1. 服务商恢复PDF运行环境
  2. 重新准备原报告的PDF，不重复发送邮件
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
优先使用已保存图片和素材修复或重新排版；不因下载、显示、编码或排版失败自动重新购买模型。
处理责任
服务商
代码依据
server/report-pdf.cjs:55

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-RPT-011报告处理未完成服务商
故障代号
SWL-RPT-011
技术键
report_too_large
故障含义
报告处理被中断，或报告内容、大小不符合要求。
可能原因
  1. 可能触发条件（源码固定说明）：周报数据超过二 MB 限制。
先做检查
  1. 核对原报告状态、PDF准备结果和邮件投递状态
  2. 服务商检查PDF运行环境、文件大小、头尾校验及目录边界
  3. 对照当前分支核对：周报数据超过二 MB 限制。
解决方案
  1. 请管理员与服务商核对报告任务和已有结果，修复内容或运行环境后处理原报告。
验证恢复
  1. 原PDF能完整打开且对应正确报告周期
  2. 报告投递状态与原记录一致，没有缺失附件或重复发送
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/report-pdf.cjs:17

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-002已有更新需要先读取操作人
故障代号
SWL-STATE-002
技术键
channel_settings_changed
故障含义
当前资料已被其他操作更新，本次提交基于旧版本。
可能原因
  1. 可能触发条件（源码固定说明）：调度设置已更新，请刷新后重试。
先做检查
  1. 读取原任务/作品并比对保存的版本和请求内容
  2. 保留未保存文字；核对是否只是同一次提交的网络恢复
  3. 对照当前分支核对：调度设置已更新，请刷新后重试。
解决方案
  1. 先保留未保存文字，再重新读取最新版本并核对后提交；设置由管理员处理。
验证恢复
  1. 原编号对应唯一内容，版本检查通过
  2. 重新读取已有结果不会新增模型购买或发布记录
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
操作人
代码依据
server/model-channels.cjs:31；server/model-channels.cjs:50

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-004同一提交编号对应不同内容操作人
故障代号
SWL-STATE-004
技术键
idempotency_conflict
故障含义
这次请求重复使用了已有提交编号，但请求内容与原提交不同。
可能原因
  1. 可能触发条件（源码固定说明）：同一任务编号不能用于不同内容。
  2. 可能触发条件（源码固定说明）：相同任务编号对应不同请求。
  3. 可能触发条件（源码固定说明）：图片请求与已保存的词卡任务不一致。
先做检查
  1. 读取原任务/作品并比对保存的版本和请求内容
  2. 保留未保存文字；核对是否只是同一次提交的网络恢复
  3. 对照当前分支核对：同一任务编号不能用于不同内容。
  4. 对照当前分支核对：相同任务编号对应不同请求。
  5. 对照当前分支核对：图片请求与已保存的词卡任务不一致。
解决方案
  1. 先读取原任务或记录；网络中断时保持原编号与原内容，真正的新内容应由客户端创建新编号。
验证恢复
  1. 原编号对应唯一内容，版本检查通过
  2. 重新读取已有结果不会新增模型购买或发布记录
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
操作人
代码依据
server/cloud-cards.cjs:226；server/enterprise-models.cjs:138；server/enterprise-models.cjs:169

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-010通知或记录版本已变化操作人
故障代号
SWL-STATE-010
技术键
record_changed
故障含义
作品或记录已更新，当前操作基于旧版本。
可能原因
  1. 可能触发条件（源码固定说明）：记录已更新，请重新读取。
先做检查
  1. 读取原任务/作品并比对保存的版本和请求内容
  2. 保留未保存文字；核对是否只是同一次提交的网络恢复
  3. 对照当前分支核对：记录已更新，请重新读取。
解决方案
  1. 重新读取当前作品或记录，核对新版本后再操作，勿发送旧版通知。
验证恢复
  1. 原编号对应唯一内容，版本检查通过
  2. 重新读取已有结果不会新增模型购买或发布记录
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
操作人
代码依据
server/app.cjs:222

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-012已有更新需要先读取操作人
故障代号
SWL-STATE-012
技术键
settings_changed
故障含义
当前资料已被其他操作更新，本次提交基于旧版本。
可能原因
  1. 可能触发条件（源码固定说明）：聊天采集设置已更新，请刷新后重试。
  2. 可能触发条件（源码固定说明）：设置已更新，请重新读取。
  3. 可能触发条件（源码固定说明）：鉴权配置已更新，请刷新后重试。
先做检查
  1. 读取原任务/作品并比对保存的版本和请求内容
  2. 保留未保存文字；核对是否只是同一次提交的网络恢复
  3. 对照当前分支核对：聊天采集设置已更新，请刷新后重试。
  4. 对照当前分支核对：设置已更新，请重新读取。
  5. 对照当前分支核对：鉴权配置已更新，请刷新后重试。
解决方案
  1. 先保留未保存文字，再重新读取最新版本并核对后提交；设置由管理员处理。
验证恢复
  1. 原编号对应唯一内容，版本检查通过
  2. 重新读取已有结果不会新增模型购买或发布记录
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
操作人
代码依据
server/chat-insights.cjs:167；server/enterprise-models.cjs:80；server/miniapp-auth.cjs:86

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-STATE-014已有更新需要先读取操作人
故障代号
SWL-STATE-014
技术键
version_conflict
故障含义
当前资料已被其他操作更新，本次提交基于旧版本。
可能原因
  1. 可能触发条件（源码固定说明）：相同更新时间对应不同内容，请使用更新的 updatedAt。
  2. 可能触发条件（源码固定说明）：作品已更新，请刷新后重试。
  3. 可能触发条件（源码固定说明）：排队期间作品已更新，请刷新重试。
  4. 可能触发条件（源码固定说明）：渲染期间作品已更新，请刷新重试。
先做检查
  1. 读取原任务/作品并比对保存的版本和请求内容
  2. 保留未保存文字；核对是否只是同一次提交的网络恢复
  3. 对照当前分支核对：相同更新时间对应不同内容，请使用更新的 updatedAt。
  4. 对照当前分支核对：作品已更新，请刷新后重试。
  5. 对照当前分支核对：排队期间作品已更新，请刷新重试。
  6. 对照当前分支核对：渲染期间作品已更新，请刷新重试。
解决方案
  1. 先保留未保存文字，再重新读取最新版本并核对后提交；设置由管理员处理。
验证恢复
  1. 原编号对应唯一内容，版本检查通过
  2. 重新读取已有结果不会新增模型购买或发布记录
重试规则
先读取原记录与版本；同一操作保持原编号和内容。仅真正的新内容才创建新编号。
处理责任
操作人
代码依据
server/app.cjs:221；server/cloud-cards.cjs:484；server/cloud-cards.cjs:506；server/cloud-cards.cjs:513；server/cloud-cards.cjs:525

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-002服务正在停止或维护服务商
故障代号
SWL-JOB-002
技术键
closed
故障含义
当前服务正在停止，无法继续接受这项处理。
可能原因
  1. 可能触发条件（源码固定说明）：服务正在停止。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
  3. 对照当前分支核对：服务正在停止。
解决方案
  1. 等待服务恢复并读取原任务状态；请服务商确认已有任务，勿重复购买模型调用。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
服务商
代码依据
desktop/main.cjs:223；server/chat-insights.cjs:202

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-003创作已被中止操作人
故障代号
SWL-JOB-003
技术键
cloud_cancelled
故障含义
服务端收到中止请求或中止信号，当前创作流程停止。
可能原因
  1. 可能：操作人中止了创作
  2. 可能：排队渲染收到任务中止信号
先做检查
  1. 读取原云端任务和子模型任务状态
  2. 区分尚未发出请求与已发出但费用待核实的调用
解决方案
  1. 确认确实需要中止；保留原任务编号
  2. 已发出的模型调用由管理员核对费用
验证恢复
  1. 原云端任务保持cancelled；排队请求未继续发出；已发出的费用状态有记录
重试规则
中止不会撤销服务商已发生的计费；不要为核实原任务反复生成。
处理责任
操作人
代码依据
server/cloud-cards.cjs:189；server/fault-alerts.cjs:29

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-005已有任务正在处理操作人
故障代号
SWL-JOB-005
技术键
cloud_job_running
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：您已有一个服务器生成任务，请等待完成。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
  3. 对照当前分支核对：您已有一个服务器生成任务，请等待完成。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/cloud-cards.cjs:246

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-006原任务因服务中断而停止服务商
故障代号
SWL-JOB-006
技术键
interrupted
故障含义
服务重启或停止中断了原任务，已经完成的采集分页会保留。
可能原因
  1. 可能触发条件（源码固定说明）：服务器重启或停止，已保留完成分页；模型或邮件未知结果不会自动重试。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
  3. 对照当前分支核对：服务器重启或停止，已保留完成分页；模型或邮件未知结果不会自动重试。
解决方案
  1. 请服务商核对原任务状态；模型和邮件结果不明时先核实，勿自动重复调用或发信。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
服务商
代码依据
server/chat-insights.cjs:58；server/chat-insights.cjs:95；server/chat-insights.cjs:96；server/chat-insights.cjs:111；server/chat-insights.cjs:121

具体原因需结合原任务核实。

SWL-STATE-006当前状态不允许这项操作操作人
故障代号
SWL-STATE-006
技术键
invalid_state
故障含义
资源当前状态不满足该接口允许的状态转换；不同审核、费用核实与发布入口使用同一码。
可能原因
  1. 可能：作品尚未处于可提交或可审核状态
  2. 可能：费用记录并非尚未结算unknown
  3. 可能：发布记录不在允许人工确认的状态
  4. 可能：免审记录不具备直接批准所需审核内容
先做检查
  1. 读取当前作品、模型费用或发布记录状态
  2. 对照来源分支的固定状态说明，确认当前入口允许哪些转换
解决方案
  1. 使用当前状态允许的页面操作；审核与核实由有权限的管理员处理
  2. 不直接改数据库状态或覆盖已执行结果
验证恢复
  1. 状态转换与原记录一致；没有重复审核、计费或发布
重试规则
先读取现状，不盲目重复同一状态变更。
处理责任
操作人
代码依据
server/app.cjs:194；server/enterprise-models.cjs:268；server/enterprise-works.cjs:64；server/enterprise-works.cjs:65；server/enterprise-works.cjs:114

具体原因需结合原任务核实。

SWL-API-074已有任务正在处理操作人
故障代号
SWL-API-074
技术键
rate_limited
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能：当前账号或服务正在处理任务，或请求频率超过允许范围。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/app.cjs:52

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-007已有任务正在处理操作人
故障代号
SWL-JOB-007
技术键
server_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：登录服务繁忙，请稍后重试。
  2. 可能触发条件（源码固定说明）：记录同步繁忙，请稍后重试。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
  3. 对照当前分支核对：登录服务繁忙，请稍后重试。
  4. 对照当前分支核对：记录同步繁忙，请稍后重试。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/app.cjs:53；server/app.cjs:201

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-008已有任务正在处理操作人
故障代号
SWL-JOB-008
技术键
upload_busy
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：正在处理另一张图片，请稍后重试。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
  3. 对照当前分支核对：正在处理另一张图片，请稍后重试。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/enterprise.cjs:142

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-009已有任务正在处理操作人
故障代号
SWL-JOB-009
技术键
user_job_running
故障含义
当前账号或服务正在处理任务，或请求频率超过允许范围。
可能原因
  1. 可能触发条件（源码固定说明）：每人同一时间只能执行一个模型任务；同一词卡的四张图片可并行制作。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
  3. 对照当前分支核对：每人同一时间只能执行一个模型任务；同一词卡的四张图片可并行制作。
解决方案
  1. 等待已有任务完成并刷新状态；不要重复提交生成、发布或邮件。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
操作人
代码依据
server/chat-insights.cjs:320；server/enterprise-models.cjs:144

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-JOB-010服务正在停止或维护服务商
故障代号
SWL-JOB-010
技术键
worker_closing
故障含义
当前服务正在停止，无法继续接受这项处理。
可能原因
  1. 可能触发条件（源码固定说明）：服务器正在停止，请稍后保存。
  2. 可能触发条件（源码固定说明）：服务器正在停止，请稍后重试。
先做检查
  1. 读取原任务状态、队列位置及当前并发
  2. 区分正在处理、维护停止、频率限制和终态任务
  3. 对照当前分支核对：服务器正在停止，请稍后保存。
  4. 对照当前分支核对：服务器正在停止，请稍后重试。
解决方案
  1. 等待服务恢复并读取原任务状态；请服务商确认已有任务，勿重复购买模型调用。
验证恢复
  1. 原任务状态持续前进或达到明确终态
  2. 没有通过重复提交绕过原任务的幂等和并发限制
重试规则
等待原任务或限制恢复后读取状态；不要重复提交生成、发布或发信。
处理责任
服务商
代码依据
server/cloud-cards.cjs:214；server/cloud-cards.cjs:275；server/cloud-cards.cjs:301；server/cloud-cards.cjs:347；server/cloud-cards.cjs:437

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-OPS-001终态任务目录清理未完成服务商
故障代号
SWL-OPS-001
技术键
cloud_media_cleanup_failed
故障含义
终态云端任务目录的检查、删除或状态压缩没有成功完成。
可能原因
  1. 可能：终态目录包含无法安全处理的文件或链接
  2. 可能：任务目录删除受占用或权限限制
  3. 可能：任务状态压缩或数据库更新失败
先做检查
  1. 核对该任务是否已终态及子模型费用是否已结算
  2. 检查任务目录权限、链接与文件占用；不读取或复制原始提示词
解决方案
  1. 清除文件占用或修复权限后由既有清理流程继续
  2. 保留尚未核实的模型任务及被引用图片
验证恢复
  1. 符合条件的目录被清理；未结算调用与作品引用仍保留
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/media-retention.cjs:157

具体原因需结合原任务核实。

SWL-OPS-002洞察定时调度未完成服务商
故障代号
SWL-OPS-002
技术键
insights_tick_failed
故障含义
洞察定时调度发生异常，需核对当前采集、分析和报告分别处于什么状态。
可能原因
  1. 可能：调度轮次内的采集、分析或报告处理抛出异常
  2. 可能：计划任务所需数据库或外部依赖暂时不可用
先做检查
  1. 查看采集、分析、报告各自原任务状态及最新安全故障码
  2. 核对下一次计划时间和是否已有正在运行任务
解决方案
  1. 服务商排查调度异常；按具体子任务原因分别修复
验证恢复
  1. 下一轮计划可运行，未重复购买分析或重复发报告
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/chat-insights.cjs:424

具体原因需结合原任务核实。

SWL-OPS-003发信临时目录清理失败服务商
故障代号
SWL-OPS-003
技术键
mail_cleanup_failed
故障含义
发信流程结束后的临时附件目录未能删除。
可能原因
  1. 可能：发信附件仍被进程占用
  2. 可能：临时目录访问或删除权限异常
先做检查
  1. 核对邮件投递记录而非重新发信
  2. 检查仅该发信临时目录的权限与文件占用
解决方案
  1. 由服务商解除临时文件占用并按目录边界安全清理
验证恢复
  1. 临时目录释放；原邮件没有因清理失败而重复发送
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/mail-provider.cjs:96

具体原因需结合原任务核实。

SWL-OPS-004作品缩略归档失败服务商
故障代号
SWL-OPS-004
技术键
media_archive_failed
故障含义
作品生成缩略图或归档事务未完成；原媒体仍受保护。
可能原因
  1. 可能：缩略图转换程序失败
  2. 可能：原图不能解码或生成的缩略图未通过格式、大小、尺寸校验
  3. 可能：归档事务或后续孤立文件回收失败
先做检查
  1. 检查缩略转换环境、原图格式和校验结果
  2. 核对作品在归档期间是否被修改
解决方案
  1. 修复转换环境或不可读素材；由既有归档流程再次检查
  2. 不要删除仍被作品引用的原图
验证恢复
  1. 作品有有效缩略图后才切换归档状态；活跃引用不丢失
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/media-retention.cjs:101

具体原因需结合原任务核实。

SWL-OPS-005媒体定时清理运行失败服务商
故障代号
SWL-OPS-005
技术键
media_cleanup_failed
故障含义
媒体归档与清理的定时任务没有正常完成。
可能原因
  1. 可能：定时归档或终态目录清理抛出未处理异常
  2. 可能：数据库或存储访问在整轮维护期间失败
先做检查
  1. 查看最近一次归档/目录清理结果和失败计数
  2. 检查存储可用空间、目录权限及转换进程
解决方案
  1. 服务商修复环境后让既有定时任务继续
验证恢复
  1. 后续清理结果正常，正在引用的媒体及未结算任务受保护
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/media-retention.cjs:178

具体原因需结合原任务核实。

SWL-OPS-006缩略图临时文件清理失败服务商
故障代号
SWL-OPS-006
技术键
media_thumbnail_temp_cleanup_failed
故障含义
缩略图转换完成后的临时文件未能删除；已不存在的文件不算此错误。
可能原因
  1. 可能：转换程序仍占用临时缩略图
  2. 可能：临时文件删除遇到除不存在以外的文件系统错误
先做检查
  1. 检查临时缩略图是否被转换进程占用
  2. 核对目录权限和磁盘状态
解决方案
  1. 解除临时文件占用后安全清理；保留最终缩略图与原图
验证恢复
  1. 临时文件删除且最终缩略图仍通过校验
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/media-retention.cjs:73

具体原因需结合原任务核实。

SWL-OPS-007模型结果缓存清理失败服务商
故障代号
SWL-OPS-007
技术键
model_cleanup_failed
故障含义
模型结果保留期清理或通道运行数据清理没有完成。
可能原因
  1. 可能：结果到期清理事务失败
  2. 可能：通道开始记录或冷却记录清理失败
  3. 可能：数据库暂时不可写
先做检查
  1. 检查保留期清理结果、数据库可写性与通道清理记录
  2. 确认未结算unknown任务未被清理
解决方案
  1. 修复数据库或运行环境后由既有维护定时器重试
  2. 保留未核实费用和云端安全故障上下文
验证恢复
  1. 到期已结算缓存清理成功；未结算unknown记录仍可核实
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/enterprise-models.cjs:250

具体原因需结合原任务核实。

SWL-OPS-008发布租期到期结算失败服务商
故障代号
SWL-OPS-008
技术键
publish_expiry_failed
故障含义
至少一个到期发布租约未能转为待人工核实状态，其他租约继续处理。
可能原因
  1. 可能：到期租约更新事务失败
  2. 可能：关联作品或发布记录同步失败
先做检查
  1. 核对原发布租约的到期时间、作品状态及平台实际结果
  2. 检查数据库写入和关联发布记录
解决方案
  1. 服务商修复事务失败；管理员核实平台后处理原发布记录
验证恢复
  1. 原租约与作品状态一致；已经发布的内容未被重复执行
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/enterprise-works.cjs:73

具体原因需结合原任务核实。

SWL-STORE-006磁盘告警任务未完成服务商
故障代号
SWL-STORE-006
技术键
storage_alert_failed
故障含义
定时磁盘告警检查或处理抛出异常。
可能原因
  1. 可能：磁盘空间采样失败
  2. 可能：告警记录或投递处理发生异常
先做检查
  1. 核对磁盘采样、告警阈值与告警投递记录
  2. 区分磁盘空间不足与告警发信失败；不能据此推断磁盘已恢复
解决方案
  1. 服务商修复采样或记录异常；管理员核对发信配置
验证恢复
  1. 磁盘检查恢复；告警的sent/failed/unknown状态有一致记录
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/storage-alerts.cjs:67

具体原因需结合原任务核实。

SWL-OPS-009作品存储维护失败服务商
故障代号
SWL-OPS-009
技术键
storage_cleanup_failed
故障含义
作品存储维护入口执行失败，既有维护定时器会再次尝试。
可能原因
  1. 可能：存储维护扫描或回收入口抛出异常
  2. 可能：数据库或图片目录暂时不可访问
先做检查
  1. 检查数据库和图片目录状态及清理失败计数
  2. 确认删除候选均没有活跃引用
解决方案
  1. 修复存储访问问题，继续原清理流程
验证恢复
  1. 后续维护正常，作品引用图片仍可读取
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/enterprise-works.cjs:124

具体原因需结合原任务核实。

SWL-OPS-010部分孤立图片尚未删除服务商
故障代号
SWL-OPS-010
技术键
storage_cleanup_pending
故障含义
清理已识别的孤立媒体时，部分文件删除失败，仍保留在待清理集合。
可能原因
  1. 可能：已确认孤立图片受到占用或删除权限限制
  2. 可能：删除候选文件遇到除不存在以外的文件系统错误
先做检查
  1. 核对待清理失败计数、文件占用与目录权限
  2. 确认对象确实没有作品或资源引用
解决方案
  1. 解除占用或修复权限；由原清理流程重试候选文件
验证恢复
  1. 待清理集合减少；被引用文件没有被删除
重试规则
先核查原维护结果；既有后台清理可按源码周期重试，不得把维护失败当作重新生成、发布或发信的理由。
处理责任
服务商
代码依据
server/publication-storage.cjs:52

具体原因需结合原任务核实。

SWL-QUOTA-001本站调用额度不足管理员
故障代号
SWL-QUOTA-001
技术键
insufficient_quota
故障含义
本版把 insufficient_quota 映射到 quota_exceeded。当前账号周期内的本站可用调用额度不足。
可能原因
  1. 可能：适配器或服务商返回了此兼容错误码，进入源码中的固定映射分支
  2. 可能：当前账号周期内的本站可用调用额度不足。
先做检查
  1. 查看当前账号周期内completed、reserved和unknown占用
  2. 区分本站额度与服务商套餐额度
解决方案
  1. 查看本站用量与待核实占用；请管理员调整本站额度，或等待新周期。
验证恢复
  1. 可用本站额度足够；已核实的占用状态正确
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:320

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-VAL-036本站月调用额度校验未通过操作人
故障代号
SWL-VAL-036
技术键
invalid_quota
故障含义
源码以此代码拒绝以下输入或状态：月调用额度不是0至1000000之间的整数。
可能原因
  1. 可能：月调用额度不是0至1000000之间的整数。
先做检查
  1. 定位当前字段或参数：本站月调用额度。
  2. 逐项核对：月调用额度不是0至1000000之间的整数。
  3. 该代码的固定校验说明：月调用额度须为 0 至 1000000 的整数。
解决方案
  1. 将月调用额度改为0至1000000之间的整数。
验证恢复
  1. 本站月调用额度通过当前页面及接口校验。
  2. 读取保存后的当前版本，确认值、归属及状态符合本次操作目的。
重试规则
先修正上述字段或状态，再继续必要的原操作；校验错误不应触发新的模型购买、重复发布或重复发信。
处理责任
操作人
代码依据
server/app.cjs:136；server/app.cjs:166

本条说明代码触发条件；“可能原因”仍需逐项确认。

SWL-QUOTA-002本站调用额度不足管理员
故障代号
SWL-QUOTA-002
技术键
quota_exceeded
故障含义
当前账号周期内的本站可用调用额度不足。
可能原因
  1. 可能触发条件（源码固定说明）：当前账号周期的调用额度不足。
先做检查
  1. 查看当前账号周期内completed、reserved和unknown占用
  2. 区分本站额度与服务商套餐额度
  3. 对照当前分支核对：当前账号周期的调用额度不足。
解决方案
  1. 查看本站用量与待核实占用；请管理员调整本站额度，或等待新周期。
验证恢复
  1. 可用本站额度足够；已核实的占用状态正确
重试规则
修正明确原因并读取最新状态后再继续原操作；提交结果不明时先核对，不重复生成或发布。
处理责任
管理员
代码依据
server/chat-insights.cjs:320；server/enterprise-models.cjs:145

本条说明代码触发条件；“可能原因”仍需逐项确认。

动态技术码与手册边界

本版覆盖扫描范围内的全部静态故障代号与客户端目录代码。动态生成的字段、上游 API 新增码和未留存原始诊断的历史记录，不能保证预先穷举；使用所属故障族或待核实条目处理。

  1. Electron certificate-error；Windows桌面客户端证书校验错误事件：客户端拒绝该不安全连接，不枚举所有底层系统值。服务商检查正式站点证书与连接配置；操作人不要绕过验证或重复提交业务请求。；desktop/main.cjs；227
  2. Android WebResourceError.*；Android网页加载错误族：具体系统错误值并未在本版逐个列举。操作人先检查网络并刷新原页面，服务商核对正式服务；不要据此重复提交生成或发布。；mobile/android/src/com/suwenlin/cards/cloud/MainActivity.java；122
  3. Android SslError.*；Android安全连接校验错误族：客户端会取消不安全连接。操作人确认正式入口和网络，由服务商检查证书与连接配置；不得绕过证书验证或重复提交业务请求。；mobile/android/src/com/suwenlin/cards/cloud/MainActivity.java；125
  4. NSError / NSURLError*；iOS导航错误族：导航取消会被忽略，其他失败显示连接提示。操作人检查网络和原页面，服务商核对正式服务；网页失败不等于业务提交未处理，勿重复生成或发布。；mobile/ios/SuwenlinCards/CloudViewController.swift；116
  5. NSError / NSURLError*；iOS导航错误族：导航取消会被忽略，其他失败显示连接提示。操作人检查网络和原页面，服务商核对正式服务；网页失败不等于业务提交未处理，勿重复生成或发布。；mobile/ios/SuwenlinCards/CloudViewController.swift；119
  6. CONSTRAINT*；数据库约束错误族：可能涉及用户名等唯一性约束。管理员先核对已有账号或记录，服务商核查具体约束；不要重复新建或覆盖原记录。；server/app.cjs；30
  7. ilinkai_*；聊天来源错误族：可能涉及授权、身份归属、分页或数据结构。管理员协调来源方核对原授权与断点；保留失败页面，不跳过数据或重复购买分析。；server/chat-insights.cjs；284
  8. provider_*；模型服务安全分类错误族：后缀由本版分类器或后续适配器提供，不能假定所有后缀已列完。管理员按原任务安全分类核对账号、模型与费用；结果不明只读原状态，不重复购买。；server/cloud-cards.cjs；159
  9. provider_*；模型服务安全分类错误族：后缀由本版分类器或后续适配器提供，不能假定所有后缀已列完。管理员按原任务安全分类核对账号、模型与费用；结果不明只读原状态，不重复购买。；server/cloud-cards.cjs；280
  10. provider_*；模型服务安全分类错误族：后缀由本版分类器或后续适配器提供，不能假定所有后缀已列完。管理员按原任务安全分类核对账号、模型与费用；结果不明只读原状态，不重复购买。；server/cloud-cards.cjs；443
  11. InvalidParameter.*；服务商参数错误族：不同后缀被映射为固定的参数不兼容分类。管理员核对原模型协议及允许参数；不复制任意原始服务商消息，不重复发送相同无效请求。；server/enterprise-models.cjs；29
  12. AccessDenied.*；服务商权限错误族：不同后缀被映射为固定的调用权限分类。管理员核对该API账号的模型开通状态与权限；不要通过陌生地址或重复任务绕过拒绝。；server/enterprise-models.cjs；29
  13. notification_{dynamic}；邮件测试按实际发送结果拼接错误码。管理员先核对原投递记录与收件箱；结果不明不得盲目补发，不能把状态刷新变成再次发信。；server/review-notifications.cjs；105

源码位置用于管理员和服务商定位，不是操作人需执行的命令。系统未启动或完全断网时不能即时发信；联网后客户端补报，最终以管理台投递记录为准。