使用说明
🔍 Daedalus——自主AI环境调试器
你的AI开发环境的医生。
代达罗斯是一个 Copilot CLI代理 它自主地探测你的整个人工智能开发过程
环境——IDE、操作系统、硬件(CPU/RAM/GPU/磁盘)、所有配置的MCP服务器、网络
AI API的延迟以及模型自身的能力——然后生成一个漂亮的、,
独立的 report.html 具有健康评分、分类问题列表和可粘贴副本
修复命令。
包含什么
| 文件 | 目的 |
|---|---|
agents/debugger-agent.agent.md |
顶级代理注册(Copilot CLI) |
agents/debugger-agent/daedalus.agent.md |
完整的代理定义+执行协议 |
agents/debugger-agent/SKILL.md |
技能触发切入点(传统同胞) |
agents/debugger-agent/README.md |
带有架构文档的代理级自述文件 |
install.ps1 |
Windows安装程序(PowerShell) |
install.sh |
macOS/Linux安装程序(Bash) |
LICENSE |
MIT许可证 |
先决条件
| 要求 | 详细信息 |
|---|---|
| GitHub Copilot | 主动订阅(个人、企业或实体) |
| Copilot命令行界面 | 已安装并验证(copilot-cli) |
| 集成开发环境 | VS Code、Cursor或带有Copilot扩展名的Windsurf |
| 操作系统 | Windows 10+、macOS 12+或Ubuntu 20.04+ |
| Node.js (可选) | 18+(仅在使用MCP服务器配套时需要) |
快速安装
1.克隆
git clone https://github.com/SufficientDaikon/daedalus-debugger.git
cd daedalus-debugger
2.运行安装程序
Windows(PowerShell):
.\install.ps1
macOS/Linux:
chmod +x install.sh
./install.sh
3.重新启动IDE
关闭并重新打开VS Code/Coursor/Windsurf,以便提取代理。
快速开始
打开IDE的Copilot聊天面板,键入:
@debugger-agent Run a full diagnostic and give me report.html
代达罗斯在所有7个阶段中自主运行,并放弃了一个自给自足的
report.html 在您的工作目录中。在任何浏览器中打开它。
运作原理
代达罗斯执行了一个 7相诊断管路 --完全自主,无提示:
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ Phase 0 │ │ Phase 1 │ │ Phase 2 │ │ Phase 3 │
│ Orient │─▶│ Hardware │─▶│ MCP │─▶│ Network │
│ │ │ Baseline │ │ Audit │ │ Probe │
└──────────┘ └──────────┘ └──────────┘ └──────────┘
│
┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ Phase 6 │ │ Phase 5 │ │ Phase 4 │◀──────┘
│ Report │◀─│ Issues │◀─│ Model │
│ .html │ │ + Score │ │ Bench │
└──────────┘ └──────────┘ └──────────┘
| 阶段 | 名称 | 发生了什么 |
|---|---|---|
| 0 | 东方 | 检测IDE、模型、操作系统、shell、Node/Python、MCP配置路径 |
| 1 | 硬件 | 基准测试CPU、RAM、GPU(VRAM+临时)、磁盘I/O |
| 2 | MCP审计 | 测试每个配置的MCP服务器——连接+所有工具 |
| 3 | 网络 | 测量对Anthropic、OpenAI、Google、GitHub API的延迟 |
| 4 | 模型工作台 | 自我基准测试延迟、工具使用、JSON输出、代码生成 |
| 5 | 问题扫描 | 按严重程度对问题进行分类,计算健康评分(0-100) |
| 6 | 报告 | 写自包含 report.html 有修复和路线图 |
健康评分
健康评分是根据分类问题计算的:
score = 100 - (CRITICAL × 20) - (HIGH × 10) - (MEDIUM × 5) - (LOW × 1)
score = clamp(score, 0, 100)
| 严重性 | 处罚 | 上限 | 示例 |
|---|---|---|---|
| 关键的 | −20 | −60 | MCP服务器无法访问,型号离线 |
| 高 | −10 | −30 | GPU驱动程序过时,RAM使用率高 |
| 中等 | −5 | −10 | neneneba API延迟>300ms,缺少分机 |
| 低 | −1 | −5 | 配置欠佳,效率较低 |
| 信息 | 0 | -- | 观察结果(不是问题) |
| 分数范围 | 标签 | 含义 |
|---|---|---|
| 90–100 | 健康的 | 所有系统标称 |
| 75–89 | 好 | 仅涉及小问题 |
| 60–74 | 退化 | 某些功能受损 |
| 40–59 | 受损的 | 多个重要问题 |
| 20–39 | 关键的 | 核心功能已损坏 |
| 0–19 | 下 | 环境无功能 |
提示示例
入门指南
@debugger-agent Run a full diagnostic and give me report.html
@debugger-agent Pre-flight check before I start a coding session
@debugger-agent Is my environment healthy enough to run the SDD pipeline?
共同
@debugger-agent My github MCP server stopped working. Debug it.
@debugger-agent Network feels slow — check API latencies.
@debugger-agent My GPU benchmark is slow. Find the bottleneck.
高级
@debugger-agent Run diagnostics and export the session to ./session-today.json
@debugger-agent Compare today's environment with last week's at ./session-old.json
@debugger-agent Full diagnostic. Fail if health_score < 60.
@debugger-agent Stress test all MCP servers — I want per-tool latency breakdowns.
什么是Copilot CLI代理?
A. Copilot CLI代理 是一个markdown文件,定义了一个专门的AI角色
GitHub副本。当你打字时 @agent-name 在“副驾驶聊天”面板中,加载副驾驶
该代理的指令和工具,为其提供了一个集中的功能集。
代达罗斯就是这样一个代理人。它有:
- 系统提示 定义其诊断行为(
daedalus.agent.md) - 工具访问 到PowerShell、文件系统、grep、glob,以及可选的MCP服务器
- 交接 对于其他代理(例如。,
@spec-writer健康诊断后) - 约束条件 (无破坏性命令,30秒压力测试帽,始终生成报告)
代理文件位于 ~/.copilot/agents/ 并由以下人员自动发现
Copilot CLI和兼容的IDE。
定制
更改报告输出路径
默认情况下,Daedalus会写入 report.html 在您当前的工作目录中。说吧
在哪里写:
@debugger-agent Run diagnostics. Output to ~/Desktop/env-report.html
跳过特定阶段
@debugger-agent Run diagnostics but skip GPU benchmarks (I don't have a GPU).
设置健康阈值
@debugger-agent Full diagnostic. Only show issues if health_score < 80.
专注于单一组件
@debugger-agent Only test my MCP servers — skip everything else.
@debugger-agent Benchmark my GPU and nothing else.
故障排除
选择器中未显示代理
- 验证文件是否在正确的位置:
~/.copilot/agents/debugger-agent.agent.md ~/.copilot/agents/debugger-agent/daedalus.agent.md ~/.copilot/agents/debugger-agent/SKILL.md - 完全重新启动IDE(而不仅仅是重新加载窗口)。
- 检查Copilot CLI是否已安装并经过身份验证:
copilot --version
MCP工具不可用
代达罗斯工程 有或没有 其配套的MCP服务器。当MCP工具 不可用,它会自动回退到PowerShell命令:
| MCP工具 | 回退 |
|---|---|
debug_detect_environment |
powershell 环境变量检查 |
debug_probe_hardware |
WMI查询/ nvidia-smi |
debug_test_all_mcp_servers |
每台服务器手动测试 |
debug_probe_network |
Test-NetConnection |
debug_run_stress_test |
内联PowerShell基准测试 |
debug_generate_report |
使用创建HTML create 工具 |
未生成报告
代达罗斯旨在 总是 即使有部分数据,也要生成报告。如果没有 报告出现:
- 检查您的工作目录
report.html - 在Copilot聊天输出中查找错误消息
- 请重试:
@debugger-agent Run diagnostics. Force report generation even if phases fail.
OMNISKILL的一部分
代达罗斯是 全能技能 通用人工智能代理和技能框架——48项技能、8个捆绑包、7个代理和5个管道 它适用于Claude Code、Copilot CLI、Cursor、Windsurf和Antigravity。
安装完整框架:
git clone https://github.com/SufficientDaikon/omniskill.git
cd omniskill
python scripts/install.py --platform copilot-cli