novel-check:LLM 连通性自检

SkillAI & models

LLM connectivity self-check: makes one minimal real call to the default model and each role model, reporting one by one whether each provider/model is actually usable. Triggers: "check if the LLM works", "test model connectivity", "confirm the config before writing", "why does every call fail". Use

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the novel-check:LLM 连通性自检 skill

What this skill tells your AI

The instructions your AI receives, as published by xiaoyangy/novel-studio in skills/novel-check/SKILL.md and read by ahel’s review.

加载配置,为默认模型与各角色模型(coordinator / architect / writer / editor)做一次最小真实 Generate 往返,逐一报告是否可用。创作前先跑它,把「配置看起来对、但一调用就崩」的问题前置。

前置条件

  • 已完成首次配置(见 skills/README.md)。

执行

# 自检当前配置的所有模型目标(按 provider/model 去重,每个只 ping 一次)
novel-studio --check

# 调长单次超时(默认 30s)
novel-studio --check --timeout 60s

# 只验证某个备用 provider(不改配置),确认它能用作 fallback
novel-studio --check --provider minimax --model MiniMax-M3

参数

参数默认说明
--timeout <dur>30s单次连通性调用的超时
--provider <name>只测指定 provider(配置里 providers 的 key 名),需配 --model
--model <model>配合 --provider 指定要测的模型名

输出与退出码

  • 逐目标:✓ provider/model [角色(主/兜底)] 耗时✗ ... 错误原因(主模型与配置的兜底都会测)
  • 按角色汇总:✓ 主可用 / ⚠ 主挂但走兜底 / ✗ 主与兜底都挂
  • 退出码:每个具名角色都至少有一条可用路径 → 0(含"降级可用",即主挂走兜底); 某具名角色主与兜底全挂 → 非 0,并提示常见原因(代理未启动 / api_key 失效 / base_url 写错)

配了 roles.<role>.fallbacks 兜底时,自检会一并验证兜底是否真的可用, 让你在主 provider 挂掉时确认"还能不能降级创作"。

典型失败

  • connection refused → 该 provider 的 base_url 指向的服务(如本地代理)没启动
  • 401 / invalid api keyapi_key 失效或写错
  • 模型返回空响应 → 连接通但模型名 / 代理路由有问题

Signals

GitHub stars
109
Forks
18
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
novel-check
Source
github.com/xiaoyangy/novel-studio