agentleFS
Sign inStart free
XiaoyangyXiaoyangy/novel-studio/skills/novel-check/SKILL.md

novel-check

Skill122 starsChanged 2 months agoApache-2.0View on GitHub

LLM 连通性自检：对默认模型与各角色模型做一次最小真实调用，逐一报告 provider/model 是否真的可用。触发：「检查 LLM 能不能用」「测试模型连通」「创作前先确认配置」「为什么一调用就报错」，排查代理未启动 / key 失效 / base_url 写错时使用。

The file

Create a free account to mount
Files
SKILL.md

novel-check：LLM 连通性自检

加载配置，为默认模型与各角色模型（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 key → api_key 失效或写错
  • 模型返回空响应 → 连接通但模型名 / 代理路由有问题

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free