codex-hygiene
Codex 桌面环境审计与调优 Skill——审计 Codex Desktop 的 context/tool surfaces，清理冗余配置、优化 token 使用
评分明细
适用场景
这是什么
codex-hygiene 是一个 Codex Desktop 环境审计与调优 Skill——通过只读 SQLite 查询分析你的 Codex 上下文使用效率、工具暴露面和 token 消耗，找出浪费的配置并给出可逆的优化建议。让你在 Codex 中写代码更快、更省 token。
适合人群：Codex Desktop 用户、AI 编码 Agent 重度使用者、需要控制 token 成本的开发者。前提是已安装 Codex Desktop。
快速上手
1. 安装
在 Codex Desktop 中安装 Skill：
# 方法一：直接安装
codex skill install sunflower-of-parchman/codex-hygiene
# 方法二：手动克隆
git clone https://github.com/sunflower-of-parchman/codex-hygiene.git
2. 运行审计
在 Codex 对话中输入：
/codex-hygiene audit
Skill 会读取 Codex 的 SQLite 遥测数据，分析上下文使用情况。
3. 查看报告
审计完成后输出报告，包含：
- Context 使用效率：哪些文件/项目占用了最多上下文
- Tool surfaces 分析：哪些工具暴露面过大
- Token 消耗排名：最浪费 token 的配置
- 优化建议：一键可逆的优化步骤
核心功能
- Context 审计：分析 Codex 上下文使用效率
- Tool surfaces 调优：优化工具暴露面
- Token 使用分析：找出浪费 token 的配置
- 清理建议：一键优化建议，可逆操作
- MCP 协议：Agent 可直接调用
常见踩坑
-
只读操作：codex-hygiene 只做只读 SQLite 查询，不会修改任何配置。所有优化建议需要你手动执行。
-
遥测数据范围：分析基于 Codex 的 SQLite 遥测数据库，如果遥测被禁用则无法审计。
-
优化建议可逆：所有建议的优化步骤都是可逆的——不会删除日志、缓存或项目文件。
-
首次审计慢：首次审计需要扫描全部遥测数据，可能耗时 30-60 秒。后续增量审计很快。
-
版本兼容性：仅支持 Codex Desktop 最新版本。旧版本可能遥测数据格式不兼容。
常见问题 FAQ
Q1: 会删除我的代码或配置吗？
A: 不会。codex-hygiene 只做只读分析，输出优化建议。所有操作需要你手动确认执行。
Q2: 能节省多少 token？
A: 取决于你的 Codex 配置复杂度。典型用户可节省 15-30% 的上下文浪费，重度用户可能更多。
Q3: 支持其他 AI 编码工具吗？
A: 当前仅支持 Codex Desktop。Cursor、Claude Code 等工具需要对应的 Skill 版本。
Q4: 多久运行一次？
A: 建议每周运行一次，或在安装新 MCP 插件/工具后运行。高频使用场景可每天运行。
Q5: 开源吗？
A: MIT 开源，完全免费。可以自行修改和扩展。
参考链接
📊 评分与标签
评分说明
总分 8.0/10 · P_优选
📊 可观测社区指标（数据核验日期：2026-07-09）
- GitHub: sunflower-of-parchman/codex-hygiene ★192, 🔱6
- 语言: Shell
- 创建: 2026-07-07 | 最近更新: 2026-07-08
- 许可证: MIT
- Open Issues: 0
- Topics: codex, codex-skill, developer-tools, mcp, token-usage
- 来源: GitHub
📦 可安装性 2.0/2.5
- Codex 原生 Skill——直接在 Codex Desktop 中安装使用
- 来源：GitHub
- 读权限 SQLite 查询——不需要修改系统配置
- Shell 脚本实现——依赖关系简单
- 竞品对比 ContextRot：codex-hygiene 专注 Codex vs ContextRot 通用上下文分析
- 竞品对比 TokenDiet：codex-hygiene 是 Skill 直接集成 vs TokenDiet 独立工具需额外配置
🎯 实用性 2.0/2.5
- Codex 用户刚需——token 成本控制是高频痛点
- 来源：GitHub
- 上下文审计——分析 Codex 上下文使用效率，找出浪费
- Tool surfaces 调优——优化工具暴露面，减少无关上下文
- Token 使用分析——精确定位浪费 token 的配置
- 清理建议——一键优化建议，可逆操作
- 竞品对比 手工配置检查：codex-hygiene 自动化 vs 手工耗时易出错
- 竞品对比 ContextRot：codex-hygiene Codex 专项优化 vs ContextRot 通用分析
📖 文档质量 1.5/2.0
- Shell 脚本清晰可读——代码即文档
- 来源：GitHub
- README 说明用途和使用方法
- 竞品对比 ContextRot：ContextRot 文档更完善
- 竞品对比 TokenDiet：TokenDiet 文档更详细
👥 社区活跃 1.0/1.5
- 192 Stars，社区关注度较高
- 0 Open Issues——代码质量好或社区初期
- 2026-07-07 创建，仅 2 天
- 竞品对比 ContextRot：类似阶段
- 竞品对比 TokenDiet：TokenDiet 社区更大
🔗 兼容性 1.0/1.5
- 仅支持 Codex Desktop——平台限制
- MCP 协议——Agent 可直接调用
- 竞品对比 ContextRot：支持多平台 vs codex-hygiene 仅 Codex
- 竞品对比 TokenDiet：支持多 IDE vs codex-hygiene 仅 Codex
🏷️ 标签说明
- 开源免费: MIT 许可证。来源: GitHub
- Skill系统: Agent Skill，Codex 桌面环境审计。来源: GitHub
- 编程: 开发者工具，token 优化。来源: GitHub
- 海外: 开源项目。来源: GitHub
📋 来源与核验记录
- ✅ web_search 已验证: GitHub — 确认 192 Stars, MIT, Shell
- ⚠️ 未验证（新项目）: Codex 版本兼容性 — 仅 2 天项目，需持续观察