系统维护 / 功能门错误码（178*）

段位：178001 - 178099；V1 暴露 3 个（178004、178008、178009）；其余码仅在管理端 / 同步等非 V1 集成路径触发，不在本参考之列
通用约定（HTTP status / code=1 兜底 / 响应结构）见 README
178004、178008、178009 均不绑定单一端点：178004 在维护窗口期覆盖除白名单外的全部 V1 端点；178008 在部署授权档位不含所访问能力时，覆盖该档位未开放的能力端点（如检索类）；178009 在服务启动窗口内覆盖全部 V1 端点。

178004 MAINTENANCE_MODE_ACTIVE

HTTP status：200
含义：系统处于维护态，服务暂不可用
典型触发条件：平台管理方进入系统维护窗口期间调用任意 V1 端点。以下白名单端点在维护期间仍正常可用、不返回此码：鉴权令牌签发（/v1/auth/token）、公开分享访问（/public/*）、健康检查
处理建议：msg 携带维护原因文案，可向最终用户透出「系统维护中」提示并暂停重试；维护态由人工恢复、无固定时长，响应不携带 Retry-After，建议以分钟级间隔轮询或订阅运维方的维护窗口通知，待恢复后继续调用。请勿将此码当作请求参数错误或权限错误处理——请求本身有效，待维护结束后原样重发即可
示例响应：

json

{ "code": 178004, "msg": "系统维护中：版本升级，预计 30 分钟", "data": null }

178008 LICENSE_FEATURE_NOT_LICENSED

HTTP status：403
含义：当前部署的授权档位不包含所访问功能所需的能力
典型触发条件：部署授权为基础档位时调用检索增强类端点（全文检索 /v1/search/*、语义检索与签发 /v1/rag/* 等）。授权档位分级：基础档含文档管理能力；进阶档在此之上增加检索能力；完整档包含全部能力。访问当前档位未开放的能力端点即返回此码。授权状态在运行期变化（如授权到期后自动重载失效）时即时生效，无需等待重连
处理建议：这是部署级能力边界、非单次请求的参数或权限问题，重试不会改变结果。请按 HTTP 403 与本 code 分流：向最终用户提示该功能在当前部署下未开放，并据部署实际授权档位隐藏或禁用相应入口。若需开通对应能力，请联系部署方调整授权档位
示例响应：

json

{ "code": 178008, "msg": "当前授权版本不包含该功能所需能力", "data": null }

178009 SERVICE_NOT_READY

HTTP status：503
含义：服务尚在启动窗口内、部署能力集未就绪，请求暂不可受理
典型触发条件：实例刚启动、能力集尚未装配完成时调用任意 V1 端点（含登录能力集下发、菜单下发）。此为短暂启动窗口，装配完成后自动恢复
处理建议：这是可自愈的临时状态、非授权问题——请按 HTTP 503 与本 code 分流，稍后以秒级间隔重试即可，无需改动请求。请勿与 178008（需升级授权、重试无效）混淆：178009 稍后重试即恢复，178008 需调整部署授权档位
示例响应：

json

{ "code": 178009, "msg": "服务正在启动，请稍后重试", "data": null }