mcpField
C
codex-usage-dashboard

codex-usage-dashboard

github.com/luyh7Agent 工作流879 次安装1 天前更新
代码仓库

关于 codex-usage-dashboard

codex-usage-dashboard 是用于启动 Codex 使用情况仪表板的技能。它先验证并按需安装匹配的本地运行时,再启动或复用本机服务;也支持无浏览器启动、停止和快照导出。

主要功能

  1. 01验证并按需安装匹配的运行时
  2. 02启动或复用本机 Rust 服务
  3. 03打开本地仪表板页面
  4. 04支持无浏览器启动与显式停止
  5. 05导出本地设备快照

适用场景

  1. 01启动 Codex 使用情况仪表板
  2. 02在无浏览器环境中启动服务
  3. 03停止已启动的服务
  4. 04导出本地设备快照

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/luyh7/codex-usage-dashboard --skill codex-usage-dashboard

安装后在 Claude Code 中输入/codex-usage-dashboard确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

native.json
agents/
openai.yaml
scripts/
install_runtime.mjs

详细介绍

无论用户的项目目录是什么,都要相对于此 SKILL.md 解析路径。

  1. 在此技能目录中运行 node scripts/install_runtime.mjs --ensure。 这会根据 native.json 及其清单验证已安装的二进制文件,并在缺失、过时或仍使用经典界面时下载匹配的版本。技能更新后也要运行此检查;仅有现成的可执行文件并不能证明它与此技能匹配。此检查需要 Node 18+;下载还需要互联网连接。如果失败,请报告安装程序错误以及仓库 README 中的源码构建说明;不要启动旧版运行时,也不要声称仪表板已启动。
  2. 运行检查输出的、已验证的原生可执行文件: Linux/macOS 上为 runtime/codex-usage-dashboard,Windows 上为 runtime/codex-usage-dashboard.exe。其默认操作会在端口 8765 上启动或复用 Rust 服务,并在 http://127.0.0.1:8765/ 打开仪表板。
  3. 返回成功启动器输出的 URL。如果无法打开浏览器,请向用户提供该链接。若端口已被占用且并非由本程序管理,则视为错误;不要终止占用该端口的进程,并报告启动器给出的说明。

用户要求无头启动时使用 --no-browser;用户明确要求停止时使用 --stop;用户要求导出本地设备快照时使用 --export-snapshot PATH。包含空格的路径必须作为一个参数传递。直接启动原生程序无需 Python、Node 或 Rust 工具链。

评论

支持 Markdown