如何启动并浏览 ECC 桌面仪表盘（ecc_dashboard.py）？

如何启动并浏览 ECC 桌面仪表盘ecc_dashboard.py【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECCECC 仓库根目录自带一个基于 Tkinter 的桌面仪表盘 ecc_dashboard.py它把仓库里的agents/、skills/、commands/、rules/四个目录解析成五个可搜索、可筛选的选项卡方便你在图形界面里浏览 ECC 的组件。这篇文章说明如何启动这个仪表盘、逐个选项卡能做什么以及在缺少 Tkinter 时如何处理。启动前的准备1. 必须从完整克隆的仓库中运行根据 docs/TROUBLESHOOTING.md 的说明桌面仪表盘必须在 ECC 仓库的完整克隆中启动不能从 Claude Code 插件安装目录里运行——插件安装不带package.json因此npm run dashboard这类脚本不可用。git clone https://github.com/affaan-m/ECC.git cd ECC2. 确认 Python 3 可用直接运行脚本的方式需要python3命令可用。3. 确认 Tkinter 可用GUI 依赖 Tkinter而很多 Python 安装默认不带它。脚本启动时若检测到 Tkinter 缺失会在终端打印一条错误并给出各平台的安装命令。这些命令会安装系统级 Python 包Debian/Ubuntu 和 Fedora 的方式需要管理员权限sudo/dnf系统权限macOS 的 brew 方式不需要 sudoDebian/Ubuntu:sudo apt-get install python3-tkFedora:sudo dnf install python3-tkintermacOS (Homebrew):brew install python-tkWindows: 重新运行 python.org 安装程序并勾选 tcl/tk and IDLE各平台命令与脚本内部的错误提示一致见 docs/TROUBLESHOOTING.md 的 ECC Dashboard Does Not Start 一节。启动仪表盘在仓库根目录执行以下任一命令npm run dashboard # 或 python3 ./ecc_dashboard.pynpm run dashboard在 package.json 中的定义就是python3 ./ecc_dashboard.py两条路径等价。启动成功后的判断依据来自脚本代码窗口标题为 ECC Dashboard - Everything Claude Code启动时会被最大化最小尺寸为 800×600界面顶部有五个选项卡Agents、Skills、Commands、Rules、Settings每个选项卡名称后带计数例如Agents (50)窗口底部状态栏显示Ready | Agents: N | Skills: N | Commands: N。仪表盘读取的数据脚本把自身所在目录即仓库根目录作为项目路径启动时扫描选项卡数据来源解析内容Agentsagents/*.md每个文件的 YAML frontmatter 中的name和descriptionSkillsskills/skill/SKILL.md首个非空行作为描述并按技能名推断分类Commandscommands/*.md首个#标题行作为描述Rulesrules/语言/*.md目录名作为语言标签common归为 Common需要注意如果这些目录不存在或为空脚本会回退到内置的默认示例列表见 ecc_dashboard.py 中各load_*函数的 fallback 分支。此时状态栏的计数反映的是默认列表而不是仓库实际内容——如果你看到的计数与agents/、skills/等目录里的文件数对不上先检查自己是否在正确的克隆目录中运行。逐个选项卡浏览Agents 选项卡顶部搜索框按名称或用途实时过滤右侧Count标签同步显示过滤后的数量。点击列表中的某个 Agent右侧 Details 面板显示 Purpose、When to Use以及使用方式说明Use the /name command or invoke via agent delegation。Skills 选项卡支持搜索框 Category 下拉框双重过滤下拉框默认All其余选项是脚本从已加载技能中动态收集出的分类。点击某个技能可看到分类、描述和该技能目录的完整路径。Commands 选项卡列出所有斜杠命令显示为/命令名和描述。页面内提示这些命令在 Claude Code 中通过输入/command_name使用。Rules 选项卡提供 Language 下拉框可按语言过滤规则列表页面说明这些规则在 Claude Code 中会被自动应用。Settings 选项卡包含三组设置和一组快捷操作Project Path文本框默认填入仓库路径旁边有Browse...按钮可以改选目录AppearanceLight/Dark 主题切换字体家族和字号下拉框选择后立即生效Font可选的字体家族和字号Quick ActionsOpen Project in Terminal在文本框中的项目路径下打开一个系统终端。具体启动哪个终端由平台决定——Windows 用cmd.exemacOS 用 TerminalLinux 用x-terminal-emulator实现见 scripts/lib/ecc_dashboard_runtime.pyOpen README/Open AGENTS.md用默认浏览器打开对应文件。该操作被限制在项目目录内路径解析出项目目录之外会弹出 Access denied 错误Refresh Data按 Project Path 文本框中的路径重新加载全部四个列表刷新选项卡名称上的计数和状态栏完成后弹出 Data refreshed successfully! 对话框。如果你手动修改过 ECC 仓库里的组件文件可以用它重新载入。启动失败与替代路径文档记载的故障现象与处理见 docs/TROUBLESHOOTING.md现象npm run dashboard或python3 ecc_dashboard.py失败常见报错是ModuleNotFoundError: No module named tkinter。处理按上文 启动前的准备 中对应平台的命令安装 Tkinter然后重新运行npm run dashboard。替代路径如果不想装 Tkinter可以用浏览器版仪表盘它只需要 Nodenpm run dashboard:web命令会打印一个 localhost URL在浏览器中打开即可。限制说明两条启动命令都必须运行在完整克隆的仓库里插件安装目录中没有package.json脚本桌面版是 Tkinter 应用没有图形界面的纯终端环境无法使用此时可改用npm run dashboard:webOpen Project in Terminal依赖系统已安装对应终端程序如 Linux 的x-terminal-emulator命令。延伸阅读README 中 Dashboard GUI 一节给出了功能清单选项卡、主题切换、字体自定义、搜索过滤docs/TROUBLESHOOTING.md 收录了更多仪表盘相关故障条目。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考