SkillPulse 是一个 Windows-only 的 Codex App Skill 使用观察工具。它会在 Codex 窗口附近放一个很小的悬浮图标,点击后打开本地可视化面板,用来查看本机 Skill 的使用次数、趋势、链路、Skill 库和维护提示。

这个项目是一次 Codex vibe coding 的产物:需求、设计、调试、重构和发布文档主要通过用户与 Codex 的连续对话完成。它不是官方 Codex 功能,也不代表 OpenAI 官方立场。

Codex 的 Skill 会越来越多,但用户很难回答几个实际问题:

• 哪些 Skill 经常被用到?
• 哪些 Skill 已经很久没被调用,可能在吃灰?
• 哪些 Skill 名称重复、说明缺失,导致后续很难管理?
• 某些 Skill 是否经常一起出现,形成了稳定的工作链路?
• 自己写的 Skill 是否真的进入了日常工作流?

SkillPulse 的目标不是替代 Codex,而是给本机 Skill 生态做一个轻量的仪表盘。它只读取本机数据,不上传会话正文,适合个人观察、整理和改造自己的 Skill 工作流。

• 悬浮小图标:贴近 Codex App 使用,点击打开面板,右键可退出。
• 总览面板:显示今日、7 日、30 日调用量,最近调用和维护提醒。
• Skill 库:扫描本机可发现的 Skill,支持搜索、来源筛选、状态筛选和排序。
• 趋势视图:查看日趋势和时段热力图。
• 链路视图:根据同会话/相邻轮次推断 Skill 共现链路,支持网络筛选和拖拽。
• 维护视图:提示重复 Skill、缺说明 Skill、吃灰 Skill、体积偏大的 Skill。
• 中文备注:支持导出 Skill 翻译包,让用户把 JSON 交给 LLM 生成中文名称和说明后再导入。
• 本地导出:支持导出 CSV / JSON 报告。

以下截图由当前界面组件直接渲染,使用内置脱敏演示数据生成,不包含真实会话正文、浏览器地址栏、个人目录或本机日志。

SkillPulse 总览

SkillPulse Skill 库

SkillPulse 链路视图

当前版本扫描这些目录中存在 SKILL.md 的 Skill:

• %USERPROFILE%\.codex\skills
• %USERPROFILE%\.agents\skills
• %USERPROFILE%\.codex\plugins\cache

因此它不是只显示用户自己写的 Codex Skill,也会显示 Agent Skill 和插件缓存里的 Skill。没有落成 SKILL.md 文件、或在这些目录之外的 Skill 不会显示。

SkillPulse 会读取:

• %USERPROFILE%\.codex\sessions
• %USERPROFILE%\.codex\archived_sessions
• %USERPROFILE%\.codex\skills
• %USERPROFILE%\.agents\skills
• %USERPROFILE%\.codex\plugins\cache

SkillPulse 会写入:

• %APPDATA%\SkillPulse\settings.json
• %APPDATA%\SkillPulse\daily-snapshots.json
• %APPDATA%\SkillPulse\skill-notes.json
• %APPDATA%\SkillPulse\exports\*
• %APPDATA%\SkillPulse\icons\*

默认设计是不上传任何数据,也不展示完整会话正文。统计逻辑主要依赖本机会话索引和对 SKILL.md 读取记录的推断。

推荐直接使用 GitHub Release 中的安装包:

• SkillPulse_0.1.0_x64-setup.exe
• SkillPulse_0.1.0_x64_en-US.msi

安装或运行后,Codex 窗口顶部附近会出现 SkillPulse 小图标。点击图标打开面板。

需要 Windows、Node.js、Rust 和 Tauri 依赖环境。

npm install
npm run dev

构建发行版:

npm run build

检查:

npm run check
cargo check --manifest-path .\src-tauri\Cargo.toml

src/ React 前端
src-tauri/ Tauri / Rust 后端
docs/ 设计说明、发布说明、vibe coding 过程

这个工具优先服务于个人使用和实验。后续可能会继续做:

• 更安全的 Skill 启用/停用管理;
• 更好的链路网络交互;
• 更多 Agent 的 Skill 目录适配;
• 更完整的导出和周/月报;
• 更稳定的 Codex 窗口贴附逻辑。

也欢迎直接 fork 源码,把它交给自己的 Codex 改造成适合自己工作流的版本。

SkillPulse 是一个公开的 Codex vibe coding 案例。项目从"想要一个 Skill 使用小记/计数器"开始,经由多轮对话不断修正方向、界面、数据口径和交互细节。详细过程见 docs/vibe-coding-case.md。

更细的公开版交互记录见 docs/interaction-log.md。这份记录保留产品决策和返工过程,不公开本机私有会话正文、数据库和个人路径细节。

• YBsmorom:项目发起、需求定义、产品判断、测试反馈与发布。
• codex-gpt5.5:在 Codex 中参与 vibe coding,实现、调试、文档整理与打包发布。

MIT。见 LICENSE。