Files
AstrBot/astrbot/core/utils/config_number.py
LIghtJUNction bbcdc502a5 feat(dashboard): clarify frontend/backend behavior with better messages
- Track _webui_fallback flag to distinguish "frontend disabled" vs "frontend enabled but files missing"
- Improve messages:
  - "前端未内置或未初始化,回退到仅启动后端" when fallback occurs
  - "前端已禁用" when user explicitly disabled
  - "正在启动 API Server" instead of "WebUI 已分离"
  - "前端未启用,请访问在线面板" for HTTP responses when frontend disabled
2026-03-23 17:43:30 +08:00

65 lines
1.7 KiB
Python

from astrbot.core import logger
def coerce_int_config(
value: object,
*,
default: int,
min_value: int | None = None,
field_name: str | None = None,
source: str = "config",
warn: bool = True,
) -> int:
label = f"'{field_name}'" if field_name else "value"
if isinstance(value, bool):
if warn:
logger.warning(
"%s %s should be numeric, got boolean. Fallback to %s.",
source,
label,
default,
)
parsed = default
elif isinstance(value, int):
parsed = value
elif isinstance(value, str):
try:
parsed = int(value.strip())
except ValueError:
if warn:
logger.warning(
"%s %s value '%s' is not numeric. Fallback to %s.",
source,
label,
value,
default,
)
parsed = default
else:
try:
parsed = int(value)
except (TypeError, ValueError):
if warn:
logger.warning(
"%s %s has unsupported type %s. Fallback to %s.",
source,
label,
type(value).__name__,
default,
)
parsed = default
if min_value is not None and parsed < min_value:
if warn:
logger.warning(
"%s %s=%s is below minimum %s. Fallback to %s.",
source,
label,
parsed,
min_value,
min_value,
)
parsed = min_value
return parsed