{"_id":"@cmd233/my-claude-hud","name":"@cmd233/my-claude-hud","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@cmd233/my-claude-hud","version":"1.0.0","description":"Claude Code 实时状态栏 HUD - 显示上下文使用量、活跃工具、Agent、Todo 进度等","main":"dist/index.js","bin":{"cmd233-claude-hud":"dist/index.js"},"scripts":{"build":"node -e \"require('fs').rmSync('dist',{ recursive: true, force: true })\" && tsc","dev":"tsc --watch","postinstall":"node scripts/postinstall.js","test":"jest","test:coverage":"jest --coverage","prepublishOnly":"npm run build"},"keywords":["claude-code","claude","statusline","hud","cli-plugin","developer-tools","anthropic"],"repository":{"type":"git","url":"git+https://github.com/JackCmd233/my-claude-hud.git"},"author":{"name":"cmd233"},"license":"MIT","bugs":{"url":"https://github.com/JackCmd233/my-claude-hud/issues"},"homepage":"https://github.com/JackCmd233/my-claude-hud#readme","devDependencies":{"@types/jest":"^29.5.0","@types/node":"^20.0.0","jest":"^29.5.0","ts-jest":"^29.1.0","typescript":"^5.0.0"},"gitHead":"eacaf8bf6e20cee64a245f215404192f0b9a1a78","_id":"@cmd233/my-claude-hud@1.0.0","_nodeVersion":"24.13.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-G73VEFD1r+QgOottXATzkoSwcagi5QAqXeGitgoowX++8TIeIqfthcDuo1GmWAzIFk4RpeiModffT8UVHQSg+A==","shasum":"c96d80be8659da871412cd7b128d37068607be0c","tarball":"https://registry.npmjs.org/@cmd233/my-claude-hud/-/my-claude-hud-1.0.0.tgz","fileCount":41,"unpackedSize":263716,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICmvp4WG+4FHX7RJAA3vEKhqM48UIG2lmg+iyNBNwkdiAiA1Lk/bTWxJePurwdjKCT+V4U797Go3pJIzF37A5o9Bpw=="}]},"_npmUser":{"name":"cmd233","email":"cmdegr@gmail.com"},"directories":{},"maintainers":[{"name":"cmd233","email":"cmdegr@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/my-claude-hud_1.0.0_1772962187677_0.20681229794093903"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-08T09:29:47.573Z","1.0.0":"2026-03-08T09:29:47.827Z","modified":"2026-03-08T09:29:48.037Z"},"maintainers":[{"name":"cmd233","email":"cmdegr@gmail.com"}],"description":"Claude Code 实时状态栏 HUD - 显示上下文使用量、活跃工具、Agent、Todo 进度等","homepage":"https://github.com/JackCmd233/my-claude-hud#readme","keywords":["claude-code","claude","statusline","hud","cli-plugin","developer-tools","anthropic"],"repository":{"type":"git","url":"git+https://github.com/JackCmd233/my-claude-hud.git"},"author":{"name":"cmd233"},"bugs":{"url":"https://github.com/JackCmd233/my-claude-hud/issues"},"license":"MIT","readme":"# My Claude HUD\r\n\r\n> Claude Code 实时状态栏 HUD - 显示上下文使用量、活跃工具、运行中的 Agent、待办进度等。\r\n\r\n[**English**](./README.en.md) | 中文\r\n\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n[![GitHub stars](https://img.star-history.com/svg?repos=JackCmd233/my-claude-hud&type=Date)](https://star-history.com/#JackCmd233/my-claude-hud&Date)\n[![Release](https://img.shields.io/github/v/release/JackCmd233/my-claude-hud)](https://github.com/JackCmd233/my-claude-hud/releases)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blue)](https://github.com/anthropics/claude-code)\r\n\r\n---\r\n\r\n## 🙏 致谢\r\n\r\n本项目灵感来源于 **[Jarrod Watts](https://github.com/jarrodwatts)** 的 **[claude-hud](https://github.com/jarrodwatts/claude-hud)** 项目。\r\n\r\n> **感谢 Jarrod Watts** 创建了原始的 claude-hud 并与社区分享！你的工作为这个增强版本提供了基础和灵感。\r\n\r\n虽然原始项目作为概念参考，但**本仓库的所有代码均从零编写**，以实现等效功能并添加以下增强：\r\n\r\n- 🇨🇳 **中文语言支持**（默认）\r\n- 🧠 **项目记忆系统**（跨会话行为追踪）\r\n- 🔍 **语义化工具统计**（读取/编辑/执行/检查/通信）\r\n- 📂 **目录级工具聚合**\r\n- 🎯 **智能内容展示**（基于会话状态动态调整）\r\n- 🐤 **金丝雀测试**（AI 上下文状态监控）\r\n- 🎨 **5 种颜色主题**（default, nord, dracula, monokai, solarized）\r\n- 📊 **会话统计和成本估算**\r\n\r\n两个项目均采用 **MIT 许可证**发布。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n- 📊 **上下文使用量** - 实时 Token 使用量显示，带颜色编码进度条\r\n- 🔧 **活跃工具** - 显示当前运行和已完成的工具\r\n- 🤖 **Agent 追踪** - 监控运行中的 Agent 及其状态\r\n- ✅ **待办进度** - 显示待办事项完成状态\r\n- 🌿 **Git 状态** - 分支、未提交状态、领先/落后、文件统计\r\n- ⏱️ **会话时长** - 追踪已工作时长\r\n- 📈 **API 使用量** - 5 小时和 7 天使用量窗口及重置时间\r\n- 🎯 **配置统计** - 显示 CLAUDE.md、rules、MCPs 和 hooks 数量\r\n- ⚡ **速度追踪** - 输出 Token 速度（tokens/秒）\r\n\r\n### 增强功能\r\n- 🧠 **项目记忆** - 跨会话项目行为追踪（热门文件、活跃目录、会话统计）\r\n- 🔍 **语义化工具统计** - 按类别分组工具（读取/编辑/执行/检查/通信）\r\n- 📂 **目录聚合** - 按目录聚合查看工具使用情况\r\n- 🎯 **智能显示** - 内容根据会话状态调整（正常/忙碌/警告/严重）\r\n- 🐤 **金丝雀测试** - 自动检测 AI 上下文状态\r\n- 💰 **成本估算** - 根据 Token 使用量计算 API 成本\r\n- ⏱️ **工具执行时间** - 显示每个工具的执行时长\r\n- 🔔 **告警系统** - 上下文和 API 限制警告\r\n- 📊 **上下文预测** - 预测剩余消息/时间\r\n- 🎨 **颜色主题** - 5 种内置主题\r\n- 📁 **项目特定配置** - 每个项目可覆盖全局设置\r\n- 📈 **会话统计** - 跨会话使用量追踪\r\n- 🔧 **快捷操作** - 常用操作的命令行工具\r\n- 🗂️ **智能工具分组** - 相似工具分组显示更清晰\r\n- 🌐 **多语言支持** - 中文/英文显示语言（默认：中文）\r\n- 🌍 **自定义翻译** - 可创建任何语言的翻译文件\r\n\r\n---\r\n\r\n## 安装\r\n\r\n选择你喜欢的安装方式：\r\n\r\n### 方式 1: 从 GitHub 克隆（推荐）\r\n\r\n```bash\r\ncd ~/.claude/plugins\r\ngit clone https://github.com/JackCmd233/my-claude-hud.git\ncd my-claude-hud\r\nnpm install\r\nnpm run build\r\n```\r\n\r\n### 方式 2: 下载发布包\r\n\r\n```bash\r\n# 下载并解压最新发布版本\r\ncd ~/.claude/plugins\r\ncurl -LO https://github.com/JackCmd233/my-claude-hud/releases/latest/download/my-claude-hud.tar.gz\ntar -xzf my-claude-hud.tar.gz\r\nrm my-claude-hud.tar.gz\r\ncd my-claude-hud\r\nnpm install\r\n```\r\n\r\n### 方式 3: 手动下载\r\n\r\n1. 访问 [Releases](https://github.com/JackCmd233/my-claude-hud/releases)\n2. 下载最新的 `my-claude-hud.tar.gz`\r\n3. 解压到 `~/.claude/plugins/my-claude-hud/`\r\n4. 在插件目录运行 `npm install`\r\n\r\n### 方式 4: 一键安装脚本（macOS/Linux）\r\n\r\n```bash\r\ncurl -sSL https://raw.githubusercontent.com/JackCmd233/my-claude-hud/master/scripts/install.sh | bash\n```\r\n\r\n---\r\n\r\n## 配置\r\n\r\n在 `~/.claude/settings.json` 中添加：\r\n\r\n```json\r\n{\r\n  \"statusLine\": {\r\n    \"type\": \"command\",\r\n    \"command\": \"node ~/.claude/plugins/my-claude-hud/dist/index.js\"\r\n  }\r\n}\r\n```\r\n\r\n### 配置选项\r\n\r\n创建 `~/.claude/plugins/my-claude-hud/config.json`：\r\n\r\n```json\r\n{\r\n  \"lineLayout\": \"expanded\",\r\n  \"showSeparators\": false,\r\n  \"pathLevels\": 1,\r\n  \"gitStatus\": {\r\n    \"enabled\": true,\r\n    \"showDirty\": true,\r\n    \"showAheadBehind\": false,\r\n    \"showFileStats\": false\r\n  },\r\n  \"display\": {\r\n    \"showModel\": true,\r\n    \"showContextBar\": true,\r\n    \"contextValue\": \"percent\",\r\n    \"showConfigCounts\": true,\r\n    \"showDuration\": true,\r\n    \"showSpeed\": false,\r\n    \"showTokenBreakdown\": true,\r\n    \"showUsage\": true,\r\n    \"usageBarEnabled\": true,\r\n    \"showTools\": true,\r\n    \"showAgents\": true,\r\n    \"showTodos\": true,\r\n    \"showCost\": false,\r\n    \"autocompactBuffer\": \"enabled\",\r\n    \"usageThreshold\": 0,\r\n    \"sevenDayThreshold\": 80,\r\n    \"environmentThreshold\": 0,\r\n    \"displayLanguage\": \"zh\",\r\n    \"toolDetailLevel\": \"compact\",\r\n    \"showMemoryInsights\": true,\r\n    \"memoryInsightsPosition\": \"after\",\r\n    \"smartDisplay\": true\r\n  },\r\n  \"alerts\": {\r\n    \"enabled\": true,\r\n    \"contextWarning\": 80,\r\n    \"contextCritical\": 95,\r\n    \"apiLimitWarning\": 90\r\n  },\r\n  \"theme\": {\r\n    \"colorTheme\": \"default\"\r\n  },\r\n  \"memory\": {\r\n    \"enabled\": true,\r\n    \"maxProjects\": 100,\r\n    \"maxFilesPerProject\": 500,\r\n    \"trackingEnabled\": true\r\n  }\r\n}\r\n```\r\n\r\n### 项目特定配置\r\n\r\n在项目根目录创建 `.claude-hud.json` 以覆盖全局设置：\r\n\r\n```json\r\n{\r\n  \"lineLayout\": \"compact\",\r\n  \"theme\": {\r\n    \"colorTheme\": \"nord\"\r\n  },\r\n  \"alerts\": {\r\n    \"contextWarning\": 75\r\n  }\r\n}\r\n```\r\n\r\n### 自定义翻译\r\n\r\n你可以创建自己的翻译文件来定制或翻译 HUD。\r\n\r\n1. 复制示例翻译文件：\r\n```bash\r\ncp ~/.claude/plugins/my-claude-hud/examples/config.translations.example.json ~/.claude/plugins/my-claude-hud/config.translations.json\r\n```\r\n\r\n2. 编辑翻译文件：\r\n\r\n```json\r\n{\r\n  \"version\": \"1.0.0\",\r\n  \"tools\": {\r\n    \"Read\": \"读取\",\r\n    \"Write\": \"写入\",\r\n    \"Edit\": \"编辑\"\r\n  },\r\n  \"agentTypes\": {\r\n    \"general-purpose\": \"通用助手\"\r\n  },\r\n  \"status\": {\r\n    \"All todos complete\": \"所有任务已完成\"\r\n  },\r\n  \"toolGroups\": {\r\n    \"File ops\": \"文件操作\"\r\n  }\r\n}\r\n```\r\n\r\n3. 在配置中添加翻译文件路径：\r\n\r\n```json\r\n{\r\n  \"i18n\": {\r\n    \"customTranslationFile\": \"./config.translations.json\"\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## 颜色主题\r\n\r\n可用主题：\r\n- `default` - 标准终端颜色\r\n- `nord` - 北极蓝灰主题\r\n- `dracula` - 高对比度暗色主题\r\n- `monokai` - 经典暗色主题\r\n- `solarized` - Solarized Dark\r\n\r\n---\r\n\r\n## 快捷操作\r\n\r\n```bash\r\n# 切换布局模式\r\nnode ~/.claude/plugins/my-claude-hud/dist/index.js --action=toggle-layout\r\n\r\n# 显示统计信息\r\nnode ~/.claude/plugins/my-claude-hud/dist/index.js --action=stats\r\n\r\n# 清除所有缓存\r\nnode ~/.claude/plugins/my-claude-hud/dist/index.js --action=clear-cache\r\n\r\n# 清除项目记忆\r\nnode ~/.claude/plugins/my-claude-hud/dist/index.js --action=clear-memory\r\n\r\n# 金丝雀测试\r\nnode ~/.claude/plugins/my-claude-hud/dist/index.js --action=canary-create\r\nnode ~/.claude/plugins/my-claude-hud/dist/index.js --action=canary-check\r\n\r\n# 显示帮助\r\nnode ~/.claude/plugins/my-claude-hud/dist/index.js --action=help\r\n```\r\n\r\n---\r\n\r\n## 布局模式\r\n\r\n### Expanded（默认）\r\n多行显示，会话信息、工具、Agent 和待办事项分开展示。\r\n\r\n### Compact\r\n单行显示，所有信息在一行中。\r\n\r\n---\r\n\r\n## 开发\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\nnpm run dev  # 监听模式\r\nnpm test     # 运行测试\r\n```\r\n\r\n---\r\n\r\n## 文档\r\n\r\n### 📚 项目文档\r\n- [CLAUDE.md](./CLAUDE.md) - 项目开发指南\r\n- [CONTRIBUTING.md](./CONTRIBUTING.md) - 贡献指南\r\n- [CHANGELOG.md](./CHANGELOG.md) - 版本更新记录\r\n- [ROADMAP.md](./ROADMAP.md) - 项目路线图\r\n\r\n### 📖 功能文档\r\n- [核心功能](./docs/FEATURES.md) - 已实现功能列表\r\n- [增强功能](./docs/ENHANCEMENTS.md) - 详细增强功能文档\r\n- [FAQ](./docs/FAQ.md) - 常见问题解答 ⭐\r\n- [截图指南](./docs/SCREENSHOTS.md) - 截图和演示指南\r\n\r\n### 🔧 配置指南\r\n- [自定义翻译](./docs/TRANSLATIONS.md) - 如何创建自定义翻译文件\r\n- [金丝雀测试](./docs/CANARY_TEST.md) - AI 上下文状态监控指南\r\n- [实现计划](./docs/implementation-plan.md) - 开发进度\r\n\r\n---\r\n\r\n## 与原版对比\r\n\r\n| 功能 | 原 claude-hud | My Claude HUD |\r\n|---------|-------------------|---------------|\r\n| 上下文使用量 | ✅ | ✅ |\r\n| 活跃工具 | ✅ | ✅ |\r\n| Agent 追踪 | ✅ | ✅ |\r\n| 待办进度 | ✅ | ✅ |\r\n| Git 状态 | ✅ | ✅ |\r\n| API 使用量 | ✅ | ✅ |\r\n| 中文语言 | ❌ | ✅（默认） |\r\n| 项目记忆 | ❌ | ✅ |\r\n| 语义化工具统计 | ❌ | ✅ |\r\n| 目录聚合 | ❌ | ✅ |\r\n| 智能显示 | ❌ | ✅ |\r\n| 金丝雀测试 | ❌ | ✅ |\r\n| 颜色主题 | ✅ | ✅（5 种） |\r\n| 成本估算 | ✅ | ✅ |\r\n| 会话统计 | ✅ | ✅ |\r\n\r\n---\r\n\r\n## 许可证\r\n\r\nMIT License\n\r\n本项目灵感来源于 [Jarrod Watts](https://github.com/jarrodwatts) 的 [claude-hud](https://github.com/jarrodwatts/claude-hud)（MIT License）。所有代码均从零编写，以实现等效功能并添加额外增强。\r\n\r\n详见 [LICENSE](./LICENSE)。\r\n\r\n---\r\n\r\n## 链接\r\n\r\n- **GitHub**: [https://github.com/JackCmd233/my-claude-hud](https://github.com/JackCmd233/my-claude-hud)\n- **原始项目**: [https://github.com/jarrodwatts/claude-hud](https://github.com/jarrodwatts/claude-hud)\n- **维护者**: [JackCmd233](https://github.com/JackCmd233)\n- **原作者**: [Jarrod Watts](https://github.com/jarrodwatts)\n","readmeFilename":"README.md","_rev":"1-0ab7fa6c6fe3cb9ae98f21e45351921e"}