fix(backend): 安全默认值、异常语义、代码生成注入面与定时任务内置处理器

本批为 t10 → t13 → t15 三轮实现 + 一轮复核驳回整改的最终形态（pytest 83 passed / ruff clean，
已部署并线上验证）。

异常语义
- CustomException 默认状态码 500 → 400（约 433 处裸调用不再被计为服务端故障），
  且「包装底层异常」的 130 处显式恢复 500；get_or_404 → 404；响应体结构不变

代码生成注入面（复核 blocker F1，二次修复）
- column_type 不再做字符串拼接：改为常量白名单派生（类型名 ∈ DB_TO_SQLALCHEMY ∪ {Boolean}，
  长度仅取数字/正则捕获），彻底移除 split("(")[1]
- 列类型加形状白名单；字符串/注释/文档字符串用 \uXXXX，标识符过 safe_ident（含 Python/JS 关键字），
  .vue 文本与静态属性改 HTML 实体
- 落盘闸门由 ast.parse 升级为 assert_python_structure（语法 + 顶层语句白名单 + 与哨兵骨架逐节点比对）
  与 assert_text_structure（.vue/.ts/.toml 行结构）；U+2028/2029 与 C1 控制符纳入转义

安全默认值
- 生产 CORS 不再回落 ["*"]（未配置即拒绝跨域，可选 CORS_STRICT_STARTUP 直接启动失败）
- OAUTH_ALLOWED_HOSTS 不再默认 "*"；新增 ALLOW_LOCALHOST_HOSTS 控制 Host 校验范围
- ALLOWED_HOSTS 收窄为按配置派生；健康检查暴露 code_exec_enabled / cors_origins_configured

定时任务
- SCHEDULER_ALLOW_CODE_EXEC 默认 False；新增 builtin:<模块名>[.<函数名>] 内置处理器路线（不经 exec）
- 判定收敛到 describe_schedulability；列表返回 schedulable / unschedulable_reason；
  启动 reconcile 与状态查询对「已启用但不可调度」打 WARN（去重、恢复后清除）
- 加固：内置处理器必须在本模块内定义或经 HANDLERS 声明，拒绝模块内导入的外部对象（复核 R1）
- 顺带修复：_WARNED_UNSCHEDULABLE 的 set.pop TypeError、job.next_run_time 缺失导致的列表 500

测试：新增 tests/test_generator_template_safety.py、test_security_defaults.py、
test_scheduler_schedulability.py（含恶意载荷、闸门红绿、静态护栏）

backend/app/modules/task/cronjob/node/schema.py

@@ -17,7 +17,14 @@ class NodeCreateSchema(BaseModel):
     """
 
     name: str = Field(..., max_length=64, description="任务名称")
-    func: str | None = Field(default=None, description="代码块")
+    func: str | None = Field(
+        default=None,
+        description=(
+            "任务函数：两种写法——① 内置函数型 `builtin:<模块名>[.<函数名>]`（白名单解析后直接调用，不经 exec，"
+            "不受 SCHEDULER_ALLOW_CODE_EXEC 限制）；② 原始代码块（需定义 handler(*args, **kwargs)，等同服务器代码执行权限，"
+            "仅在 SCHEDULER_ALLOW_CODE_EXEC=true 时允许）"
+        ),
+    )
     args: str | None = Field(default=None, description="位置参数")
     kwargs: str | None = Field(default=None, description="关键字参数")
     coalesce: bool | None = Field(default=False, description="是否合并运行:是否在多个运行时间到期时仅运行作业一次")
@@ -102,6 +109,11 @@ class NodeOutSchema(NodeCreateSchema, BaseSchema, UserBySchema):
     next_run_time: str | None = Field(default=None, description="下次运行时间")
     last_run_time: str | None = Field(default=None, description="最近一次运行时间")
     last_run_status: int | None = Field(default=None, description="最近一次运行状态(2:成功 3:失败)")
+    schedulable: bool | None = Field(
+        default=None,
+        description="当前是否可调度；false 表示「已启用也不会执行」（如代码块被禁用、内置处理器不存在、未配置函数）",
+    )
+    unschedulable_reason: str | None = Field(default=None, description="不可调度原因（含修复建议）")
 
     model_config = ConfigDict(from_attributes=True)
 

backend/app/modules/task/cronjob/node/service.py

@@ -11,7 +11,6 @@ from croniter import croniter
 from sqlalchemy import false, select
 from sqlalchemy.ext.asyncio import AsyncSession
 
-from app.config.setting import settings
 from app.core.ap_scheduler import SchedulerUtil, scheduler
 from app.core.base_schema import AuthSchema, PageResultSchema
 from app.core.exceptions import CustomException
@@ -179,7 +178,17 @@ class NodeService:
             node_id = str(item.id) if item.id is not None else ""
             job = jobs.get(node_id)
             if job:
-                item.next_run_time = str(job.next_run_time) if job.next_run_time else None
+                item.next_run_time = str(job.next_run_time) if getattr(job, "next_run_time", None) else None
+
+            # 可调度状态（t15）：区分「已启用且可执行」与「已启用但当前不会执行」，
+            # 并把后者以 WARN 打出（带节点标识），避免升级/开关调整后的静默失效
+            schedulable, reason = SchedulerUtil.describe_schedulability(item.func)
+            item.schedulable = schedulable
+            item.unschedulable_reason = None if schedulable else reason
+            if not schedulable and item.status == 0:
+                _warn_unschedulable_node(node_id=node_id, name=item.name, reason=reason)
+            elif schedulable:
+                _clear_unschedulable_warning(node_id)
             stmt = (
                 select(JobModel)
                 .where(JobModel.job_id == node_id, JobModel.is_deleted == false())
@@ -192,6 +201,41 @@ class NodeService:
                 item.last_run_status = row.status
 
 
+# 「已启用但不可调度」的告警去重：同一节点 + 同一原因只告警一次，
+# 避免列表接口被反复调用时刷屏；节点恢复可调度时清除记录（见 _enrich_runtime）。
+_WARNED_UNSCHEDULABLE: dict[str, str] = {}
+
+
+def _warn_unschedulable_node(*, node_id: str, name: str | None, reason: str | None) -> None:
+    """对「已启用但当前不可调度」的节点打一次 WARN（带节点标识与原因）。
+
+    参数:
+    - node_id (str): 节点 ID（调度器 job id）。
+    - name (str | None): 节点名称。
+    - reason (str | None): 不可调度原因。
+
+    返回:
+    - None
+    """
+    text = reason or ""
+    if _WARNED_UNSCHEDULABLE.get(node_id) == text:
+        return
+    _WARNED_UNSCHEDULABLE[node_id] = text
+    logger.warning(f"节点任务不可调度（已启用但不会执行）: id={node_id} name={name!r} 原因={reason}")
+
+
+def _clear_unschedulable_warning(node_id: str) -> None:
+    """节点恢复可调度后清除其告警去重记录（下次再失效仍会告警）。
+
+    参数:
+    - node_id (str): 节点 ID。
+
+    返回:
+    - None
+    """
+    _WARNED_UNSCHEDULABLE.pop(node_id, None)
+
+
 # ── NodeModel 封装的调度操作（模块级函数，供 service / 启动自愈复用）────
 
 
@@ -281,8 +325,11 @@ def _add_job_with_trigger(
     code_block = job_info.func
     if not code_block or not code_block.strip():
         raise ValueError("任务代码块不能为空")
-    if not settings.SCHEDULER_ALLOW_CODE_EXEC:
-        raise CustomException(msg="服务已禁用定时任务代码执行（SCHEDULER_ALLOW_CODE_EXEC=False），无法注册代码块任务")
+    # 可调度性判定（单一事实来源）：builtin: 引用走白名单、不经 exec，因此**开关关闭时也允许注册**；
+    # 只有"原始代码块"才会被 SCHEDULER_ALLOW_CODE_EXEC=False 拦住，并在提示里给出 builtin 替代写法。
+    schedulable, reason = SchedulerUtil.describe_schedulability(code_block)
+    if not schedulable:
+        raise CustomException(msg=reason)
 
     jobstore = job_info.jobstore or "default"
     executor = job_info.executor or "threadpool"
@@ -368,8 +415,10 @@ def run_node_once(node: NodeModel) -> str:
     """
     if not node.func or not node.func.strip():
         raise ValueError("任务代码块不能为空")
-    if not settings.SCHEDULER_ALLOW_CODE_EXEC:
-        raise CustomException(msg="服务已禁用定时任务代码执行（SCHEDULER_ALLOW_CODE_EXEC=False），无法执行代码块任务")
+    # 手动执行同样按可调度性判定：builtin 引用可直接执行；原始代码块在开关关闭时给出替代写法
+    schedulable, reason = SchedulerUtil.describe_schedulability(node.func)
+    if not schedulable:
+        raise CustomException(msg=reason)
     temp_job_id = f"{node.id}{_MANUAL_JOB_PREFIX}{datetime.now():%Y%m%d%H%M%S}"
     trigger = DateTrigger(run_date=datetime.now() + timedelta(seconds=0.1), timezone="Asia/Shanghai")
     _add_job_with_trigger(node, trigger, job_id_override=temp_job_id, name_suffix=" - 手动执行")