SuperAPI AI 工具集

nano-doctor

部署与运维

查看项目

更新于 10-15 21:49

技能介绍

用途:诊断本地 nanostack 安装,执行十项检查,涵盖依赖、安装完整性、用户级主目录、遥测配置、pre-V5 检测路径与 Worker 可达性。输出按类别、检查项和一行明细呈现。它是诊断技能而非“全自动修复”技能。

主要能力:先运行健康检查脚本 ~/.claude/skills/nanostack/bin/nano-doctor.sh,再总结用户需采取的操作。支持参数:--json(机器可读,信封含 fix_available、fix_command、session_profile);--offline(跳过 Worker 可达性,适合隔离环境或 CI);--fix(修复机械性问题:对 ~/.nanostack/ 执行 chmod 700、对 sender 执行 chmod +x、向本地 .claude/settings.json 添加缺失的 Bash 与 Write/Edit/MultiEdit 的 PreToolUse hooks,改前备份为 .claude/settings.json.YYYYMMDD-HHMMSS.bak,不动已有权限条目)。

输出解读:每项一行,状态为 ok、warn、FAIL。退出码 0 全部通过、1 仅警告仍可用、2 严重需修复。host 类别报告各 agent CLI(Claude Code、Cursor、Codex、OpenCode、Gemini)保护级别,对照 adapters/<host>.json 声明与本安装;声明 enforced 但本地 hook 缺失会提示漂移并指向 --fix;声明 instructions_only 则通过但注明为引导式。

使用方式:若警告涉及 home 权限、sender_executable、bash_guard 或 write_guard,可重跑 --fix;其他警告或失败需告知用户自行决定,不要自动修依赖或改权限列表。若 skill_dir 检查失败,提示重装:npx create-nanostack(会保留现有 ~/.nanostack/)。

适用场景:按 session_profile 分引导式或专业式输出;引导式不念内部类别名,按纯语言契约转译结果。限制:不要未报告就运行 --fix,默认只读;warn 不等于 fail;结果为干净时只说 healthy 即可。