环境诊断工具

跨平台（Windows / macOS / Linux）环境诊断工具，一次运行即可检查网络、权限和开发环境。

使用方法

运行内置的 Python 脚本，它会自动处理平台检测和所有诊断逻辑，免去逐条执行 shell 命令的麻烦，并内置了超时处理、错误处理和格式化输出。

python <skill-path>/scripts/diagnose.py [模块]

可选模块：

• all（默认）— 运行全部诊断
• network — 仅网络连通性和代理检测
• permission — 仅管理员/sudo/权限检测
• env — 仅开发工具和运行环境版本检测

脚本会自动识别操作系统并适配对应命令。所有网络探测均有 3-5 秒超时，不会卡住。

参数对照表

运行后

脚本输出结构化的带 emoji 标注的结果，直接展示给用户即可——格式已经排版好了。如果用户追问（比如"怎么装 Node？""怎么配代理？"），根据诊断结果和检测到的操作系统来回答。

重要约束

• 只读模式：绝不安装、升级或修改任何东西，只做检测和报告。
• 不编排子 agent：直接运行脚本，不要为单项检查启动子 agent。
• 超时安全：脚本内置超时机制；万一某项检查卡住，5 秒后自动跳过。