[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-jarrodwatts--claude-hud":3,"tool-jarrodwatts--claude-hud":64},[4,18,26,39,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,2,"2026-04-10T01:20:03",[13,14,15,16],"插件","Agent","图像","开发框架","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[13,16],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":10,"last_commit_at":32,"category_tags":33,"status":17},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85052,"2026-04-08T11:03:08",[15,34,35,13,14,36,37,16,38],"数据工具","视频","其他","语言模型","音频",{"id":40,"name":41,"github_repo":42,"description_zh":43,"stars":44,"difficulty_score":45,"last_commit_at":46,"category_tags":47,"status":17},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70918,3,"2026-04-09T23:08:27",[37,14,16,13],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":17},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",68319,"2026-04-09T23:08:01",[14,13],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":17},3074,"gpt4free","xtekky\u002Fgpt4free","gpt4free 是一个由社区驱动的开源项目，旨在聚合多种可访问的大型语言模型（LLM）和媒体生成接口，让用户能更灵活、便捷地使用前沿 AI 能力。它解决了直接调用各类模型时面临的接口分散、门槛高或成本昂贵等痛点，通过统一的标准将不同提供商的资源整合在一起。\n\n无论是希望快速集成 AI 功能的开发者、需要多模型对比测试的研究人员，还是想免费体验最新技术的普通用户，都能从中受益。gpt4free 提供了丰富的使用方式：既包含易于上手的 Python 和 JavaScript 客户端库，也支持部署本地图形界面（GUI），更提供了兼容 OpenAI 标准的 REST API，方便无缝替换现有应用后端。\n\n其技术亮点在于强大的多提供商支持架构，能够动态调度包括 Opus、Gemini、DeepSeek 等多种主流模型资源，并支持 Docker 一键部署及本地推理。项目秉持社区优先原则，在降低使用门槛的同时，也为贡献者提供了扩展新接口的便利框架，是探索和利用多样化 AI 资源的实用工具。",65970,"2026-04-04T01:02:03",[13,37,14],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":79,"owner_location":80,"owner_email":79,"owner_twitter":76,"owner_website":81,"owner_url":82,"languages":83,"stars":92,"forks":93,"last_commit_at":94,"license":95,"difficulty_score":10,"env_os":96,"env_gpu":97,"env_ram":97,"env_deps":98,"category_tags":103,"github_topics":104,"view_count":10,"oss_zip_url":79,"oss_zip_packed_at":79,"status":17,"created_at":112,"updated_at":113,"faqs":114,"releases":143},6066,"jarrodwatts\u002Fclaude-hud","claude-hud","A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress","claude-hud 是一款专为 Claude Code 设计的增强插件，旨在让用户在终端界面中实时掌握 AI 助手的运行状态。它直接在输入框下方显示一个动态状态栏，清晰呈现当前项目的路径、上下文窗口使用率、正在执行的工具操作（如读写文件）、子代理运行进度以及待办事项完成情况。\n\n对于频繁使用 Claude Code 进行复杂开发任务的用户而言，claude-hud 解决了“黑盒”操作的痛点：用户不再需要猜测 AI 是否卡死、上下文是否即将溢出，或具体正在后台执行什么任务。通过直观的进度条和实时日志，开发者可以精准监控资源消耗，及时调整策略，避免任务中断。\n\n这款工具特别适合软件开发者、工程师及技术研究人员使用，尤其是那些依赖 Claude Code 进行多步骤代码重构、调试或大型项目管理的用户。其技术亮点在于原生集成 Claude Code 的 statusline API，无需额外窗口或 tmux 支持，即可在任何终端中流畅运行；同时，它直接读取官方令牌数据而非估算值，并适配高达 100 万上下文的会话场景，确保信息准确可靠。配置灵活，支持自定义显示层级与语言，让每位用户都能打造最","claude-hud 是一款专为 Claude Code 设计的增强插件，旨在让用户在终端界面中实时掌握 AI 助手的运行状态。它直接在输入框下方显示一个动态状态栏，清晰呈现当前项目的路径、上下文窗口使用率、正在执行的工具操作（如读写文件）、子代理运行进度以及待办事项完成情况。\n\n对于频繁使用 Claude Code 进行复杂开发任务的用户而言，claude-hud 解决了“黑盒”操作的痛点：用户不再需要猜测 AI 是否卡死、上下文是否即将溢出，或具体正在后台执行什么任务。通过直观的进度条和实时日志，开发者可以精准监控资源消耗，及时调整策略，避免任务中断。\n\n这款工具特别适合软件开发者、工程师及技术研究人员使用，尤其是那些依赖 Claude Code 进行多步骤代码重构、调试或大型项目管理的用户。其技术亮点在于原生集成 Claude Code 的 statusline API，无需额外窗口或 tmux 支持，即可在任何终端中流畅运行；同时，它直接读取官方令牌数据而非估算值，并适配高达 100 万上下文的会话场景，确保信息准确可靠。配置灵活，支持自定义显示层级与语言，让每位用户都能打造最适合自己的监控面板。","# Claude HUD\n\nA Claude Code plugin that shows what's happening — context usage, active tools, running agents, and todo progress. Always visible below your input.\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fjarrodwatts\u002Fclaude-hud?v=2)](LICENSE)\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fjarrodwatts\u002Fclaude-hud)](https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\u002Fstargazers)\n\n![Claude HUD in action](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjarrodwatts_claude-hud_readme_5cf9c76202c2.png)\n\n## Install\n\nInside a Claude Code instance, run the following commands:\n\n**Step 1: Add the marketplace**\n```\n\u002Fplugin marketplace add jarrodwatts\u002Fclaude-hud\n```\n\n**Step 2: Install the plugin**\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>⚠️ Linux users: Click here first\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nOn Linux, `\u002Ftmp` is often a separate filesystem (tmpfs), which causes plugin installation to fail with:\n```\nEXDEV: cross-device link not permitted\n```\n\n**Fix**: Set TMPDIR before installing:\n```bash\nmkdir -p ~\u002F.cache\u002Ftmp && TMPDIR=~\u002F.cache\u002Ftmp claude\n```\n\nThen run the install command below in that session. This is a [Claude Code platform limitation](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code\u002Fissues\u002F14799).\n\n\u003C\u002Fdetails>\n\n```\n\u002Fplugin install claude-hud\n```\n\nAfter that, reload plugins:\n\n```\n\u002Freload-plugins\n```\n\n\n**Step 3: Configure the statusline**\n```\n\u002Fclaude-hud:setup\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>⚠️ Windows users: Click here if setup says no JavaScript runtime was found\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nOn Windows, Node.js LTS is the recommended runtime for Claude HUD. If setup says no JavaScript runtime was found, install Node.js for your shell first:\n```powershell\nwinget install OpenJS.NodeJS.LTS\n```\nThen restart your shell and run `\u002Fclaude-hud:setup` again.\n\n\u003C\u002Fdetails>\n\nDone! Restart Claude Code to load the new statusLine config, then the HUD will appear.\n\nOn Windows, make that a full Claude Code restart after setup writes the new `statusLine` config.\n\n---\n\n## What is Claude HUD?\n\nClaude HUD gives you better insights into what's happening in your Claude Code session.\n\n| What You See | Why It Matters |\n|--------------|----------------|\n| **Project path** | Know which project you're in (configurable 1-3 directory levels) |\n| **Context health** | Know exactly how full your context window is before it's too late |\n| **Tool activity** | Watch Claude read, edit, and search files as it happens |\n| **Agent tracking** | See which subagents are running and what they're doing |\n| **Todo progress** | Track task completion in real-time |\n\n## What You See\n\n### Default (2 lines)\n```\n[Opus] │ my-project git:(main*)\nContext █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m \u002F 5h)\n```\n- **Line 1** — Model, provider label when positively identified (for example `Bedrock`), project path, git branch\n- **Line 2** — Context bar (green → yellow → red) and usage rate limits\n\n### Optional lines (enable via `\u002Fclaude-hud:configure`)\n```\n◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2        ← Tools activity\n◐ explore [haiku]: Finding auth code (2m 15s)    ← Agent status\n▸ Fix authentication bug (2\u002F5)                   ← Todo progress\n```\n\n---\n\n## How It Works\n\nClaude HUD uses Claude Code's native **statusline API** — no separate window, no tmux required, works in any terminal.\n\n```\nClaude Code → stdin JSON → claude-hud → stdout → displayed in your terminal\n           ↘ transcript JSONL (tools, agents, todos)\n```\n\n**Key features:**\n- Native token data from Claude Code (not estimated)\n- Scales with Claude Code's reported context window size, including newer 1M-context sessions\n- Parses the transcript for tool\u002Fagent activity\n- Updates every ~300ms\n\n---\n\n## Configuration\n\nCustomize your HUD anytime:\n\n```\n\u002Fclaude-hud:configure\n```\n\nThe guided flow handles layout, language, and common display toggles. Advanced overrides such as\ncustom colors and thresholds are preserved there, but you set them by editing the config file directly:\n\n- **First time setup**: Choose a preset (Full\u002FEssential\u002FMinimal), pick a label language, then fine-tune individual elements\n- **Customize anytime**: Toggle items on\u002Foff, adjust git display style, switch layouts, or change label language\n- **Preview before saving**: See exactly how your HUD will look before committing changes\n\n### Presets\n\n| Preset | What's Shown |\n|--------|--------------|\n| **Full** | Everything enabled — tools, agents, todos, git, usage, duration |\n| **Essential** | Activity lines + git status, minimal info clutter |\n| **Minimal** | Core only — just model name and context bar |\n\nAfter choosing a preset, you can turn individual elements on or off.\n\n### Manual Configuration\n\nEdit `~\u002F.claude\u002Fplugins\u002Fclaude-hud\u002Fconfig.json` directly for advanced settings such as `colors.*`,\n`pathLevels`, and threshold overrides. Running `\u002Fclaude-hud:configure` preserves those manual settings while still letting you change `language`, layout, and the common guided toggles.\n\nChinese HUD labels are available as an explicit opt-in. English stays the default unless you choose `中文` in `\u002Fclaude-hud:configure` or set `language` in config.\n\n### Options\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `language` | `en` \\| `zh` | `en` | HUD label language. English is the default; set `zh` to enable Chinese labels. |\n| `lineLayout` | string | `expanded` | Layout: `expanded` (multi-line) or `compact` (single line) |\n| `pathLevels` | 1-3 | 1 | Directory levels to show in project path |\n| `elementOrder` | string[] | `[\"project\",\"context\",\"usage\",\"memory\",\"environment\",\"tools\",\"agents\",\"todos\"]` | Expanded-mode element order. Omit entries to hide them in expanded mode. |\n| `gitStatus.enabled` | boolean | true | Show git branch in HUD |\n| `gitStatus.showDirty` | boolean | true | Show `*` for uncommitted changes |\n| `gitStatus.showAheadBehind` | boolean | false | Show `↑N ↓N` for ahead\u002Fbehind remote |\n| `gitStatus.pushWarningThreshold` | number | 0 | Color the ahead count with the warning color at or above this unpushed-commit count (`0` disables it) |\n| `gitStatus.pushCriticalThreshold` | number | 0 | Color the ahead count with the critical color at or above this unpushed-commit count (`0` disables it) |\n| `gitStatus.showFileStats` | boolean | false | Show file change counts `!M +A ✘D ?U` |\n| `display.showModel` | boolean | true | Show model name `[Opus]` |\n| `display.showContextBar` | boolean | true | Show visual context bar `████░░░░░░` |\n| `display.contextValue` | `percent` \\| `tokens` \\| `remaining` \\| `both` | `percent` | Context display format (`45%`, `45k\u002F200k`, `55%` remaining, or `45% (45k\u002F200k)`) |\n| `display.showConfigCounts` | boolean | false | Show CLAUDE.md, rules, MCPs, hooks counts |\n| `display.showCost` | boolean | false | Show session cost using Claude Code's native `cost.total_cost_usd` when available, with a local estimate fallback for direct Anthropic sessions |\n| `display.showOutputStyle` | boolean | false | Show the active Claude Code `outputStyle` from settings files as `style: \u003Cname>` |\n| `display.showDuration` | boolean | false | Show session duration `⏱️ 5m` |\n| `display.showSpeed` | boolean | false | Show output token speed `out: 42.1 tok\u002Fs` |\n| `display.showUsage` | boolean | true | Show Claude subscriber usage limits when available |\n| `display.usageBarEnabled` | boolean | true | Display usage as visual bar instead of text |\n| `display.sevenDayThreshold` | 0-100 | 80 | Show 7-day usage when >= threshold (0 = always) |\n| `display.showTokenBreakdown` | boolean | true | Show token details at high context (85%+) |\n| `display.showTools` | boolean | false | Show tools activity line |\n| `display.showAgents` | boolean | false | Show agents activity line |\n| `display.showTodos` | boolean | false | Show todos progress line |\n| `display.showSessionName` | boolean | false | Show session slug or custom title from `\u002Frename` |\n| `display.showClaudeCodeVersion` | boolean | false | Show the installed Claude Code version, e.g. `CC v2.1.81` |\n| `display.showMemoryUsage` | boolean | false | Show an approximate system RAM usage line in expanded layout |\n| `colors.context` | color value | `green` | Base color for the context bar and context percentage |\n| `colors.usage` | color value | `brightBlue` | Base color for usage bars and percentages below warning thresholds |\n| `colors.warning` | color value | `yellow` | Warning color for context thresholds and usage warning text |\n| `colors.usageWarning` | color value | `brightMagenta` | Warning color for usage bars and percentages near their threshold |\n| `colors.critical` | color value | `red` | Critical color for limit-reached states and critical thresholds |\n| `colors.model` | color value | `cyan` | Color for the model badge such as `[Opus]` |\n| `colors.project` | color value | `yellow` | Color for the project path |\n| `colors.git` | color value | `magenta` | Color for git wrapper text such as `git:(` and `)` |\n| `colors.gitBranch` | color value | `cyan` | Color for the git branch and branch status text |\n| `colors.label` | color value | `dim` | Color for labels and secondary metadata such as `Context`, `Usage`, counts, and progress text |\n| `colors.custom` | color value | `208` | Color for the optional custom line |\n\nSupported color names: `dim`, `red`, `green`, `yellow`, `magenta`, `cyan`, `brightBlue`, `brightMagenta`. You can also use a 256-color number (`0-255`) or hex (`#rrggbb`).\n\n`display.showMemoryUsage` is fully opt-in and only renders in `expanded` layout. It reports approximate system RAM usage from the local machine, not precise memory pressure inside Claude Code or a specific process. The number may overstate actual pressure because reclaimable OS cache and buffers can still be counted as used memory.\n\n`display.showCost` is fully opt-in. ClaudeHUD prefers the native `cost.total_cost_usd` field that Claude Code provides on stdin when it is available. If that field is absent or invalid for a direct Anthropic session, ClaudeHUD falls back to the existing local transcript-based estimate so the cost line still works on older payloads. The native field is absent before the first API response in a session, so the cost display may stay hidden until then. ClaudeHUD also keeps the cost hidden for known routed providers such as Bedrock, because cloud-provider billed sessions may report `$0.00` or omit the field even though the session was not literally free.\n\n### Usage Limits\n\nUsage display is **enabled by default** when Claude Code provides subscriber `rate_limits` data on stdin. It shows your rate limit consumption on line 2 alongside the context bar.\n\nClaudeHUD intentionally trusts only the official statusline stdin payload for live usage. It does not read local OAuth credentials or poll undocumented usage endpoints in the background.\n\nFree\u002Fweekly-only accounts render the weekly window by itself instead of showing a ghost `5h: --` placeholder.\n\nThe 7-day percentage appears when above the `display.sevenDayThreshold` (default 80%):\n\n```\nContext █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m \u002F 5h) | ██████████ 85% (2d \u002F 7d)\n```\n\nTo disable, set `display.showUsage` to `false`.\n\n**Requirements:**\n- Claude Code must include subscriber `rate_limits` data on stdin for the current session\n- Not available for API-key-only users\n\n**Troubleshooting:** If usage doesn't appear:\n- Ensure you're logged in with a Claude subscriber account (not API key)\n- Check `display.showUsage` is not set to `false` in config\n- API users see no usage display (they have pay-per-token, not rate limits)\n- AWS Bedrock models display `Bedrock` and hide usage limits (usage is managed in AWS)\n- Claude Code may leave `rate_limits` empty until after the first model response in a session\n- Some Claude Code builds and subscription tiers may still omit `rate_limits`, even after the first response\n- When `rate_limits` is missing, ClaudeHUD will hide usage instead of falling back to credential scraping or undocumented API calls\n\n### Example Configuration\n\n```json\n{\n  \"language\": \"zh\",\n  \"lineLayout\": \"expanded\",\n  \"pathLevels\": 2,\n  \"elementOrder\": [\"project\", \"tools\", \"context\", \"usage\", \"memory\", \"environment\", \"agents\", \"todos\"],\n  \"gitStatus\": {\n    \"enabled\": true,\n    \"showDirty\": true,\n    \"showAheadBehind\": true,\n    \"showFileStats\": true\n  },\n  \"display\": {\n    \"showTools\": true,\n    \"showAgents\": true,\n    \"showTodos\": true,\n    \"showConfigCounts\": true,\n    \"showDuration\": true,\n    \"showMemoryUsage\": true\n  },\n  \"colors\": {\n    \"context\": \"cyan\",\n    \"usage\": \"cyan\",\n    \"warning\": \"yellow\",\n    \"usageWarning\": \"magenta\",\n    \"critical\": \"red\",\n    \"model\": \"cyan\",\n    \"project\": \"yellow\",\n    \"git\": \"magenta\",\n    \"gitBranch\": \"cyan\",\n    \"label\": \"dim\",\n    \"custom\": \"#FF6600\"\n  }\n}\n```\n\n### Display Examples\n\n**1 level (default):** `[Opus] │ my-project git:(main)`\n\n**2 levels:** `[Opus] │ apps\u002Fmy-project git:(main)`\n\n**3 levels:** `[Opus] │ dev\u002Fapps\u002Fmy-project git:(main)`\n\n**With dirty indicator:** `[Opus] │ my-project git:(main*)`\n\n**With ahead\u002Fbehind:** `[Opus] │ my-project git:(main ↑2 ↓1)`\n\n**With file stats:** `[Opus] │ my-project git:(main* !3 +1 ?2)`\n- `!` = modified files, `+` = added\u002Fstaged, `✘` = deleted, `?` = untracked\n- Counts of 0 are omitted for cleaner display\n\n### Troubleshooting\n\n**Config not applying?**\n- Check for JSON syntax errors: invalid JSON silently falls back to defaults\n- Ensure valid values: `pathLevels` must be 1, 2, or 3; `lineLayout` must be `expanded` or `compact`\n- Delete config and run `\u002Fclaude-hud:configure` to regenerate\n\n**Git status missing?**\n- Verify you're in a git repository\n- Check `gitStatus.enabled` is not `false` in config\n\n**Tool\u002Fagent\u002Ftodo lines missing?**\n- These are hidden by default — enable with `showTools`, `showAgents`, `showTodos` in config\n- They also only appear when there's activity to show\n\n**HUD not appearing after setup?**\n- Restart Claude Code so it picks up the new statusLine config\n- On macOS, fully quit Claude Code and run `claude` again in your terminal\n\n---\n\n## Requirements\n\n- Claude Code v1.0.80+\n- Node.js 18+ or Bun\n\n---\n\n## Development\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\ncd claude-hud\nnpm ci && npm run build\nnpm test\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n---\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjarrodwatts_claude-hud_readme_d6ad67457387.png)](https:\u002F\u002Fstar-history.com\u002F#jarrodwatts\u002Fclaude-hud&Date)\n","# 克劳德 HUD\n\n一个显示当前状态的 Claude Code 插件——包括上下文使用情况、活跃工具、运行中的代理以及待办事项进度。始终位于输入框下方可见。\n\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fjarrodwatts\u002Fclaude-hud?v=2)](LICENSE)\n[![星标数](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fjarrodwatts\u002Fclaude-hud)](https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\u002Fstargazers)\n\n![Claude HUD 运行示例](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjarrodwatts_claude-hud_readme_5cf9c76202c2.png)\n\n## 安装\n\n在 Claude Code 实例中，运行以下命令：\n\n**步骤 1：添加插件市场**\n```\n\u002Fplugin marketplace add jarrodwatts\u002Fclaude-hud\n```\n\n**步骤 2：安装插件**\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>⚠️ Linux 用户：请先点击此处\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n在 Linux 系统中，`\u002Ftmp` 通常是独立的文件系统（tmpfs），这会导致插件安装失败，并出现以下错误：\n```\nEXDEV: 跨设备链接不允许\n```\n\n**解决方法**：在安装前设置 TMPDIR：\n```bash\nmkdir -p ~\u002F.cache\u002Ftmp && TMPDIR=~\u002F.cache\u002Ftmp claude\n```\n\n然后在该会话中运行下面的安装命令。这是 [Claude Code 平台的一个限制](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code\u002Fissues\u002F14799)。\n\n\u003C\u002Fdetails>\n\n```\n\u002Fplugin install claude-hud\n```\n\n之后，重新加载插件：\n\n```\n\u002Freload-plugins\n```\n\n\n**步骤 3：配置状态栏**\n```\n\u002Fclaude-hud:setup\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>⚠️ Windows 用户：如果设置提示未找到 JavaScript 运行时，请点击此处\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n在 Windows 上，推荐使用 Node.js LTS 作为 Claude HUD 的运行时。如果设置提示未找到 JavaScript 运行时，请先为你的 Shell 安装 Node.js：\n```powershell\nwinget install OpenJS.NodeJS.LTS\n```\n然后重启 Shell，再次运行 `\u002Fclaude-hud:setup`。\n\n\u003C\u002Fdetails>\n\n完成！重启 Claude Code 以加载新的 statusLine 配置，HUD 就会显示出来。\n\n在 Windows 上，设置完成后需要完全重启 Claude Code，以便新 `statusLine` 配置生效。\n\n---\n\n## 什么是 Claude HUD？\n\nClaude HUD 可以让你更好地了解当前 Claude Code 会话中的动态。\n\n| 你看到的内容 | 为什么重要 |\n|--------------|------------|\n| **项目路径** | 知道你现在处于哪个项目中（可配置 1–3 层目录） |\n| **上下文健康状况** | 在为时已晚之前，准确了解你的上下文窗口已满多少 |\n| **工具活动** | 实时查看 Claude 如何读取、编辑和搜索文件 |\n| **代理跟踪** | 查看哪些子代理正在运行以及它们在做什么 |\n| **待办事项进度** | 实时跟踪任务完成情况 |\n\n## 显示内容\n\n### 默认（2 行）\n```\n[Opus] │ my-project git:(main*)\n上下文 █████░░░░░ 45% │ 使用量 ██░░░░░░░░ 25% (1h 30m \u002F 5h)\n```\n- **第 1 行** — 模型名称、识别出的服务提供商标签（例如 `Bedrock`）、项目路径、Git 分支\n- **第 2 行** — 上下文条形图（绿色 → 黄色 → 红色）以及使用率限制\n\n### 可选行（通过 `\u002Fclaude-hud:configure` 启用）\n```\n◐ 编辑：auth.ts | ✓ 读取 ×3 | ✓ Grep ×2        ← 工具活动\n◐ explore [haiku]: 寻找认证代码（2 分 15 秒）    ← 代理状态\n▸ 修复认证漏洞（2\u002F5）                   ← 待办进度\n```\n\n---\n\n## 工作原理\n\nClaude HUD 使用 Claude Code 原生的 **statusline API** — 不需要额外窗口，也不需要 tmux，在任何终端中均可正常工作。\n\n```\nClaude Code → stdin JSON → claude-hud → stdout → 在你的终端中显示\n           ↘ 转录日志 JSONL（工具、代理、待办事项）\n```\n\n**主要特点：**\n- 直接使用 Claude Code 提供的原生 token 数据（而非估算值）\n- 能够根据 Claude Code 报告的上下文窗口大小进行缩放，包括最新的 100 万 token 上下文会话\n- 解析转录日志以获取工具和代理活动信息\n- 每约 300 毫秒更新一次\n\n---\n\n## 配置\n\n随时自定义你的 HUD：\n\n```\n\u002Fclaude-hud:configure\n```\n\n引导式流程可以处理布局、语言以及常见显示选项的切换。高级覆盖设置，如自定义颜色和阈值，也会被保留，但你需要直接编辑配置文件来调整：\n\n- **首次设置**：选择预设（完整\u002F基础\u002F简约），挑选标签语言，然后微调各个元素\n- **随时自定义**：开启或关闭特定项目，调整 Git 显示样式，切换布局，或更改标签语言\n- **保存前预览**：在提交更改之前，精确查看 HUD 的最终外观\n\n### 预设\n\n| 预设 | 显示内容 |\n|--------|----------|\n| **完整** | 所有功能启用——工具、代理、待办事项、Git、使用情况、持续时间 |\n| **基础** | 活动行 + Git 状态，信息简洁 |\n| **简约** | 仅核心内容——模型名称和上下文条形图 |\n\n选择预设后，你可以单独开启或关闭某些元素。\n\n### 手动配置\n\n直接编辑 `~\u002F.claude\u002Fplugins\u002Fclaude-hud\u002Fconfig.json` 文件，以进行高级设置，例如 `colors.*`、`pathLevels` 和阈值覆盖。运行 `\u002Fclaude-hud:configure` 会保留这些手动设置，同时仍允许你更改语言、布局以及常见的引导式切换选项。\n\n中文 HUD 标签需明确选择启用。默认语言为英语，除非你在 `\u002Fclaude-hud:configure` 中选择“中文”，或在配置文件中设置 `language` 为“中文”。\n\n### 选项\n\n| 选项 | 类型 | 默认值 | 描述 |\n|--------|------|---------|-------------|\n| `language` | `en` \\| `zh` | `en` | HUD 标签的语言。默认为英语；设置为 `zh` 可启用中文标签。 |\n| `lineLayout` | string | `expanded` | 布局：`expanded`（多行）或 `compact`（单行） |\n| `pathLevels` | 1-3 | 1 | 在项目路径中显示的目录层级数 |\n| `elementOrder` | string[] | `[\"project\",\"context\",\"usage\",\"memory\",\"environment\",\"tools\",\"agents\",\"todos\"]` | 展开模式下的元素顺序。省略条目可在展开模式下将其隐藏。 |\n| `gitStatus.enabled` | boolean | true | 在 HUD 中显示 Git 分支 |\n| `gitStatus.showDirty` | boolean | true | 对未提交的更改显示 `*` |\n| `gitStatus.showAheadBehind` | boolean | false | 对与远程仓库相比的领先\u002F落后情况显示 `↑N ↓N` |\n| `gitStatus.pushWarningThreshold` | number | 0 | 当未推送的提交数量达到或超过此阈值时，将领先计数以警告颜色显示（`0` 表示禁用） |\n| `gitStatus.pushCriticalThreshold` | number | 0 | 当未推送的提交数量达到或超过此阈值时，将领先计数以严重颜色显示（`0` 表示禁用） |\n| `gitStatus.showFileStats` | boolean | false | 显示文件更改计数 `!M +A ✘D ?U` |\n| `display.showModel` | boolean | true | 显示模型名称 `[Opus]` |\n| `display.showContextBar` | boolean | true | 显示视觉上下文条 `████░░░░░░` |\n| `display.contextValue` | `percent` \\| `tokens` \\| `remaining` \\| `both` | `percent` | 上下文显示格式（`45%`、`45k\u002F200k`、剩余 `55%`，或 `45% (45k\u002F200k)`） |\n| `display.showConfigCounts` | boolean | false | 显示 CLAUDE.md、规则、MCPs、钩子的数量 |\n| `display.showCost` | boolean | false | 使用 Claude Code 的原生 `cost.total_cost_usd` 字段显示会话成本（如果可用），否则回退到本地估算值用于直接 Anthropic 会话 |\n| `display.showOutputStyle` | boolean | false | 将设置文件中的活动 Claude Code `outputStyle` 以 `style: \u003Cname>` 的形式显示 |\n| `display.showDuration` | boolean | false | 显示会话时长 `⏱️ 5m` |\n| `display.showSpeed` | boolean | false | 显示输出 token 速度 `out: 42.1 tok\u002Fs` |\n| `display.showUsage` | boolean | true | 在可用时显示 Claude 订阅者使用限制 |\n| `display.usageBarEnabled` | boolean | true | 以视觉条形图而非文本形式显示使用情况 |\n| `display.sevenDayThreshold` | 0-100 | 80 | 当使用量大于等于阈值时显示 7 天使用情况（`0` 表示始终显示） |\n| `display.showTokenBreakdown` | boolean | true | 在高上下文（85%以上）时显示 token 细节 |\n| `display.showTools` | boolean | false | 显示工具活动行 |\n| `display.showAgents` | boolean | false | 显示 agents 活动行 |\n| `display.showTodos` | boolean | false | 显示 todos 进度行 |\n| `display.showSessionName` | boolean | false | 显示会话 slug 或来自 `\u002Frename` 的自定义标题 |\n| `display.showClaudeCodeVersion` | boolean | false | 显示已安装的 Claude Code 版本，例如 `CC v2.1.81` |\n| `display.showMemoryUsage` | boolean | false | 在展开布局中显示近似的系统 RAM 使用情况一行 |\n| `colors.context` | 颜色值 | `green` | 上下文条和上下文百分比的基础颜色 |\n| `colors.usage` | 颜色值 | `brightBlue` | 使用条和低于警告阈值的百分比的基础颜色 |\n| `colors.warning` | 颜色值 | `yellow` | 上下文阈值和使用警告文字的警告颜色 |\n| `colors.usageWarning` | 颜色值 | `brightMagenta` | 接近使用阈值的使用条和百分比的警告颜色 |\n| `colors.critical` | 颜色值 | `red` | 达到限制状态和临界阈值的颜色 |\n| `colors.model` | 颜色值 | `cyan` | 用于模型徽章的颜色，如 `[Opus]` |\n| `colors.project` | 颜色值 | `yellow` | 用于项目路径的颜色 |\n| `colors.git` | 颜色值 | `magenta` | 用于 Git 包装文本的颜色，如 `git:(` 和 `)` |\n| `colors.gitBranch` | 颜色值 | `cyan` | 用于 Git 分支及分支状态文本的颜色 |\n| `colors.label` | 颜色值 | `dim` | 用于标签和次要元数据的颜色，如 `Context`、`Usage`、计数和进度文本 |\n| `colors.custom` | 颜色值 | `208` | 用于可选自定义行的颜色 |\n\n支持的颜色名称：`dim`、`red`、`green`、`yellow`、`magenta`、`cyan`、`brightBlue`、`brightMagenta`。您也可以使用 256 色编号（`0-255`）或十六进制（`#rrggbb`）。\n\n`display.showMemoryUsage` 完全由用户选择开启，且仅在 `expanded` 布局中渲染。它报告的是本地机器上的近似系统 RAM 使用情况，而不是 Claude Code 内部或特定进程中的精确内存压力。该数字可能会夸大实际压力，因为可回收的 OS 缓存和缓冲区仍可能被计入已使用内存。\n\n`display.showCost` 完全由用户选择开启。ClaudeHUD 更倾向于使用 Claude Code 在标准输入上提供的原生 `cost.total_cost_usd` 字段（如果可用）。如果该字段不存在或对于直接 Anthropic 会话无效，ClaudeHUD 会回退到现有的基于本地对话记录的估算值，以便成本行在旧版本负载中也能正常工作。原生字段在会话首次 API 响应之前是不存在的，因此成本显示可能会一直隐藏到那时。ClaudeHUD 还会针对已知的代理提供商（如 Bedrock）隐藏成本，因为云服务提供商计费的会话可能会显示 `$0.00` 或省略该字段，即使会话并非真正免费。\n\n### 使用限制\n\n当 Claude Code 在标准输入上提供订阅者 `rate_limits` 数据时，使用情况显示会 **默认启用**。它会在第 2 行与上下文条一起显示您的速率限制使用情况。\n\nClaudeHUD 故意只信任官方的状态行标准输入负载来获取实时使用情况，不会读取本地 OAuth 凭证或在后台轮询未公开的使用端点。\n\n仅限免费或每周使用的账户会单独显示每周窗口，而不会显示 `5h: --` 的占位符。\n\n当使用量超过 `display.sevenDayThreshold`（默认 80%）时，会显示 7 天百分比：\n\n```\nContext █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m \u002F 5h) | ██████████ 85% (2d \u002F 7d)\n```\n\n要禁用，请将 `display.showUsage` 设置为 `false`。\n\n**要求：**\n- Claude Code 必须在当前会话的标准输入中包含订阅者 `rate_limits` 数据\n- 不适用于仅使用 API 密钥的用户\n\n**故障排除：** 如果使用情况未显示：\n- 确保您已使用 Claude 订阅者账户登录（而非 API 密钥）\n- 检查配置中是否将 `display.showUsage` 设置为 `false`\n- API 用户不会看到使用情况显示（他们采用按 token 支付，而非速率限制）\n- AWS Bedrock 模型会显示 `Bedrock` 并隐藏使用限制（使用情况由 AWS 管理）\n- Claude Code 可能在会话首次模型响应之前仍将 `rate_limits` 留空\n- 某些 Claude Code 构建版本和订阅层级可能即使在首次响应后仍会省略 `rate_limits`\n- 当 `rate_limits` 不存在时，ClaudeHUD 会隐藏使用情况，而不会回退到凭据抓取或未公开的 API 调用\n\n### 配置示例\n\n```json\n{\n  \"language\": \"zh\",\n  \"lineLayout\": \"expanded\",\n  \"pathLevels\": 2,\n  \"elementOrder\": [\"project\", \"tools\", \"context\", \"usage\", \"memory\", \"environment\", \"agents\", \"todos\"],\n  \"gitStatus\": {\n    \"enabled\": true,\n    \"showDirty\": true,\n    \"showAheadBehind\": true,\n    \"showFileStats\": true\n  },\n  \"display\": {\n    \"showTools\": true,\n    \"showAgents\": true,\n    \"showTodos\": true,\n    \"showConfigCounts\": true,\n    \"showDuration\": true,\n    \"showMemoryUsage\": true\n  },\n  \"colors\": {\n    \"context\": \"cyan\",\n    \"usage\": \"cyan\",\n    \"warning\": \"yellow\",\n    \"usageWarning\": \"magenta\",\n    \"critical\": \"red\",\n    \"model\": \"cyan\",\n    \"project\": \"yellow\",\n    \"git\": \"magenta\",\n    \"gitBranch\": \"cyan\",\n    \"label\": \"dim\",\n    \"custom\": \"#FF6600\"\n  }\n}\n```\n\n### 显示示例\n\n**1 层（默认）：** `[Opus] │ my-project git:(main)`\n\n**2 层：** `[Opus] │ apps\u002Fmy-project git:(main)`\n\n**3 层：** `[Opus] │ dev\u002Fapps\u002Fmy-project git:(main)`\n\n**带脏状态指示符：** `[Opus] │ my-project git:(main*)`\n\n**带领先\u002F落后信息：** `[Opus] │ my-project git:(main ↑2 ↓1)`\n\n**带文件统计信息：** `[Opus] │ my-project git:(main* !3 +1 ?2)`\n- `!` = 已修改文件，`+` = 新增\u002F暂存文件，`✘` = 已删除文件，`?` = 未跟踪文件\n- 为保持显示整洁，计数为 0 的项将被省略\n\n### 故障排除\n\n**配置未生效？**\n- 检查 JSON 语法错误：无效的 JSON 会静默回退到默认设置\n- 确保使用有效值：`pathLevels` 必须为 1、2 或 3；`lineLayout` 必须为 `expanded` 或 `compact`\n- 删除配置并运行 `\u002Fclaude-hud:configure` 以重新生成配置\n\n**Git 状态缺失？**\n- 确认当前处于 Git 仓库中\n- 检查配置中的 `gitStatus.enabled` 是否未设置为 `false`\n\n**工具\u002F代理\u002F待办事项行缺失？**\n- 这些内容默认隐藏——可通过在配置中启用 `showTools`、`showAgents` 和 `showTodos` 来显示\n- 此外，只有当有相关活动时才会显示\n\n**设置后 HUD 仍未出现？**\n- 重启 Claude Code，以便其加载新的 statusLine 配置\n- 在 macOS 上，请完全退出 Claude Code，并在终端中重新运行 `claude`\n\n---\n\n## 需求\n\n- Claude Code v1.0.80+\n- Node.js 18+ 或 Bun\n\n---\n\n## 开发\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\ncd claude-hud\nnpm ci && npm run build\nnpm test\n```\n\n有关指南，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n---\n\n## 许可证\n\nMIT — 详情请参阅 [LICENSE](LICENSE)\n\n---\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjarrodwatts_claude-hud_readme_d6ad67457387.png)](https:\u002F\u002Fstar-history.com\u002F#jarrodwatts\u002Fclaude-hud&Date)","# Claude HUD 快速上手指南\n\nClaude HUD 是一款专为 **Claude Code** 设计的插件，能够在终端输入框下方实时显示上下文使用率、活跃工具、运行中的子代理（Agents）以及待办事项进度，让你对当前会话状态一目了然。\n\n## 环境准备\n\n在开始之前，请确保满足以下条件：\n\n*   **核心依赖**：已安装并配置好 **Claude Code**。\n*   **操作系统**：支持 Linux、macOS 和 Windows。\n*   **JavaScript 运行时（Windows 用户必读）**：\n    *   Windows 用户需要安装 **Node.js LTS** 以支持插件设置功能。\n    *   如果未安装，请在 PowerShell 中运行：\n        ```powershell\n        winget install OpenJS.NodeJS.LTS\n        ```\n    *   安装完成后重启终端。\n*   **Linux 用户注意**：\n    *   由于 `\u002Ftmp` 通常是独立文件系统，可能导致安装失败。建议在安装前设置临时目录：\n        ```bash\n        mkdir -p ~\u002F.cache\u002Ftmp && TMPDIR=~\u002F.cache\u002Ftmp claude\n        ```\n    *   请在执行上述命令后的新会话中进行安装操作。\n\n## 安装步骤\n\n请在 **Claude Code** 的交互界面中依次执行以下命令：\n\n**第一步：添加插件市场源**\n```\n\u002Fplugin marketplace add jarrodwatts\u002Fclaude-hud\n```\n\n**第二步：安装插件**\n```\n\u002Fplugin install claude-hud\n```\n\n**第三步：重载插件列表**\n```\n\u002Freload-plugins\n```\n\n**第四步：初始化配置**\n```\n\u002Fclaude-hud:setup\n```\n*   执行此命令后，跟随引导选择预设模式（Full\u002FEssential\u002FMinimal）及语言偏好。\n*   **重要**：配置完成后，请**完全重启 Claude Code**（退出并重新进入），以使新的状态栏配置生效。\n\n## 基本使用\n\n安装并重启后，Claude HUD 将自动在终端底部显示状态信息，无需额外命令。\n\n### 1. 默认显示效果\n启动后，你将看到类似以下的两行状态信息：\n```\n[Opus] │ my-project git:(main*)\nContext █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m \u002F 5h)\n```\n*   **第一行**：显示当前模型、项目路径及 Git 分支状态。\n*   **第二行**：可视化展示上下文窗口使用率（颜色随负载变红）及订阅用量限制。\n\n### 2. 开启更多功能（可选）\n默认仅显示核心信息。若需查看工具活动、Agent 状态或待办进度，可运行配置命令开启：\n```\n\u002Fclaude-hud:configure\n```\n在引导流程中，你可以：\n*   切换语言为 **中文** (`zh`)。\n*   启用 `Tools activity`（文件读写监控）、`Agent status`（子代理任务）或 `Todo progress`（任务进度）。\n*   调整布局为单行紧凑模式或多行详细模式。\n\n### 3. 高级自定义\n如需修改颜色阈值或隐藏特定元素，可直接编辑配置文件：\n`~\u002F.claude\u002Fplugins\u002Fclaude-hud\u002Fconfig.json`\n\n例如，强制启用中文标签：\n```json\n{\n  \"language\": \"zh\",\n  \"lineLayout\": \"expanded\",\n  \"display.showTools\": true,\n  \"display.showAgents\": true\n}\n```\n修改保存后，重启 Claude Code 即可生效。","资深后端工程师正在利用 Claude Code 重构一个遗留的认证模块，该任务涉及跨多个文件读取代码、运行子代理进行并发分析以及执行复杂的待办列表。\n\n### 没有 claude-hud 时\n- **上下文盲区**：无法直观看到上下文窗口已占用 90%，直到模型因超出限制而突然遗忘之前的指令或报错。\n- **过程黑盒**：不知道 AI 是在静默思考还是卡住了，频繁切换窗口去检查后台日志确认是否有文件读写操作。\n- **多代理迷失**：当启动多个子代理并行工作时，难以分辨哪个代理在处理什么任务，容易混淆进度。\n- **进度不可控**：缺乏实时的待办事项完成度反馈，只能靠人工回忆已完成的步骤来估算剩余工作量。\n\n### 使用 claude-hud 后\n- **风险可视**：终端底部实时显示\"Context █████░░░░░ 45%\"，在上下文耗尽前清晰预警，让开发者能主动精简对话或重置会话。\n- **动作透明**：直接看到\"◐ Edit: auth.ts | ✓ Read ×3\"的动态更新，明确知晓 AI 当前正在编辑哪个文件及执行了多少次搜索。\n- **代理追踪**：状态栏即时展示\"◐ explore [haiku]: Finding auth code\"，清晰区分主模型与各子代理的实时分工与耗时。\n- **进度量化**：待办列表显示\"▸ Fix authentication bug (2\u002F5)\"，让任务完成率一目了然，无需手动核对已完成项。\n\nclaude-hud 将原本不可见的 AI 内部推理过程转化为终端内的实时仪表盘，彻底消除了开发过程中的“盲猜”焦虑。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjarrodwatts_claude-hud_5cf9c762.png","jarrodwatts","Jarrod Watts","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fjarrodwatts_ac223812.jpg",null,"Sydney, Australia","https:\u002F\u002Fjarrodwatts.com","https:\u002F\u002Fgithub.com\u002Fjarrodwatts",[84,88],{"name":85,"color":86,"percentage":87},"JavaScript","#f1e05a",60,{"name":89,"color":90,"percentage":91},"TypeScript","#3178c6",40,17980,782,"2026-04-09T21:07:14","MIT","Linux, macOS, Windows","未说明",{"notes":99,"python":97,"dependencies":100},"该工具是 Claude Code 的插件，而非独立的 AI 模型，因此无需 GPU 或大量内存。Linux 用户若遇到安装错误需设置 TMPDIR 环境变量；Windows 用户若未检测到 JavaScript 运行时，需先安装 Node.js LTS 版本。",[101,102],"Claude Code","Node.js (Windows 用户必需)",[13],[105,106,107,108,109,110,111],"anthropic","claude","claude-code","cli","plugin","statusline","typescript","2026-03-27T02:49:30.150509","2026-04-10T10:30:16.124729",[115,120,125,130,135,139],{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},27480,"为什么 HUD 显示的使用量指示器出现警告符号（⚠）？","这通常意味着获取使用量数据的 API 调用失败。常见原因包括网络代理配置问题或认证错误。\n\n解决方案：\n1. 启用调试日志以查看具体错误代码：运行 `DEBUG=claude-hud claude`，观察输出中是否有 `[claude-hud:usage] API returned non-200 status` 等信息。\n2. 如果使用了代理，Node.js 默认不支持通过环境变量自动代理 HTTPS 请求。你需要升级 Node.js 到 v22.21.0+ 或 v24.5.0+，并在 `~\u002F.claude\u002Fsettings.json` 中添加以下配置：\n```json\n{\n  \"env\": {\n    \"HTTPS_PROXY\": \"你的代理地址\",\n    \"HTTP_PROXY\": \"你的代理地址\",\n    \"NO_PROXY\": \"localhost,127.0.0.1\",\n    \"NODE_USE_ENV_PROXY\": \"1\"\n  }\n}\n```\n3. 检查是否为 401（认证失败）或 403（权限不足）错误，并相应更新凭证。","https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\u002Fissues\u002F81",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},27481,"Windows 重启后 PowerShell 中的 HUD 消失且命令不可用，如何解决？","这是一个已知的上游问题，根源在于 Claude Code 的插件加载器在 Windows 重启后未能正确重新加载插件，而非 claude-hud 本身的 bug。\n\n症状：插件文件完整，但 `\u002Fclaude-hud:*` 命令消失，HUD 不渲染。\n\n临时解决方法：\n- 每次重启后，需要重新安装插件以恢复当前会话的功能。\n- 检查是否存在过期的 IDE 锁文件（`~\u002F.claude\u002Fide\u002F*.lock`），它们可能引用了无效的进程 ID，尝试清理这些文件。\n\n根本解决需等待上游 Claude Code 修复插件加载器问题（参考上游 issue: anthropics\u002Fclaude-code#36680）。","https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\u002Fissues\u002F196",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},27482,"如何在 HUD 中显示 Claude 的推理努力程度（Reasoning Effort）？","目前无法在 HUD 中可靠地显示实时的推理努力程度。\n\n原因：\n- Claude Code 官方提供的 `statusLine` 输入载荷中尚未包含当前的努力程度字段。\n- 虽然可以通过读取 `~\u002F.claude\u002Fsettings.json` 中的 `effortLevel` 获取默认配置值，但这无法反映会话中通过 `\u002Feffort` 命令动态修改的实际状态。\n- 解析转录文本的方式准确性差，不被推荐。\n\n维护者表示：除非上游在 `statusLine` 中直接暴露该字段，否则不会添加此功能，因为显示不准确的信息比不显示更糟糕。","https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\u002Fissues\u002F271",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},27483,"在使用代理的网络环境下，如何配置 claude-hud 以正常获取数据？","Node.js 的默认 `https` 模块不支持自动读取系统代理环境变量。若需通过代理访问 API，请按以下步骤配置：\n\n1. **升级 Node.js**：确保版本为 v22.21.0+ 或 v24.5.0+。\n2. **修改配置文件**：编辑 `~\u002F.claude\u002Fsettings.json`，在 `env` 块中添加代理设置并启用环境变量代理支持：\n```json\n{\n  \"env\": {\n    \"HTTPS_PROXY\": \"http:\u002F\u002Fyour-proxy-ip:port\",\n    \"HTTP_PROXY\": \"http:\u002F\u002Fyour-proxy-ip:port\",\n    \"NO_PROXY\": \"localhost,127.0.0.1,.local\",\n    \"NODE_USE_ENV_PROXY\": \"1\"\n  }\n}\n```\n3. **替代方案**：如果无法升级 Node.js，可以在启动命令中显式添加 `--use-env-proxy` 参数（如果使用的是自定义脚本调用 node）。\n\n此配置同样适用于解决“意外使用量显示”的问题。","https:\u002F\u002Fgithub.com\u002Fjarrodwatts\u002Fclaude-hud\u002Fissues\u002F123",{"id":136,"question_zh":137,"answer_zh":138,"source_url":119},27484,"如何排查 claude-hud 的具体错误原因？","可以通过开启调试模式来获取详细的运行时日志。\n\n操作步骤：\n在终端中运行以下命令启动 Claude Code：\n```bash\nDEBUG=claude-hud claude\n```\n\n观察输出日志，重点关注以下格式的行：\n- `[claude-hud:usage] Using credentials from macOS Keychain`：确认凭证来源。\n- `[claude-hud:usage] API returned non-200 status: \u003Ccode>`：查看具体的 HTTP 状态码（如 401, 403, 500 等），这将直接指示是认证问题、权限问题还是服务器错误。\n\n如果没有看到任何日志输出，请检查环境变量设置是否正确，或者尝试重新安装插件。",{"id":140,"question_zh":141,"answer_zh":142,"source_url":124},27485,"HUD 不显示是否一定是插件本身的问题？","不一定。很多时候 HUD 不显示是由于上游 Claude Code 的插件加载机制故障导致的，特别是在 Windows 系统重启后。\n\n判断方法：\n1. 检查插件目录（`.claude\u002Fplugins\u002Fclaude-hud\u002F`）文件是否完整。\n2. 尝试输入 `\u002F` 查看是否有 `claude-hud` 相关的命令提示。如果命令完全消失，说明插件未被加载，这是上游加载器的问题。\n3. 如果命令存在但界面渲染空白，才可能是 claude-hud 本身的渲染 bug。\n\n对于加载器问题，目前的唯一办法是重启后重新安装插件，或等待官方修复。",[144,149,154],{"id":145,"version":146,"summary_zh":147,"released_at":148},180630,"v0.0.12","### 新增\n- 显式选择启用中文（`zh`）HUD 标签，同时将英文保留为默认设置。\n- 在 `\u002Fclaude-hud:configure` 中提供引导式语言选择，用户无需手动编辑 JSON 即可选择英文或中文。\n- 通过 `display.showCost` 展示离线估算的会话成本，适用于已知的 Anthropic 模型系列，仅基于本地对话记录的 token 使用量计算。\n- 提供会话 token 总数、输出风格显示、Git push 次数阈值颜色区分、可配置的模型徽章格式，以及自定义模型覆盖功能。\n- 支持按文件及总行数展示 Git 文件差异，并在支持的情况下提供可点击的 OSC 8 文件链接。\n\n### 变更\n- 使用情况显示现仅依赖 Claude Code 官方 stdin 的 `rate_limits` 字段。移除了后台 OAuth 使用情况轮询、相关缓存\u002F锁行为，以及基于凭据推断的订阅计划标签。\n- 设置和配置流程现更好地支持简单入门：Windows 设置优先推荐 Node.js 使用指南；GitHub 星标提示中增加了 `gh` 兼容性说明；配置界面现将语言作为一级引导选项公开。\n- 插件检测、配置缓存以及基于对话记录的活动\u002F会话元数据处理更加稳健，并且测试覆盖更全面。\n\n### 修复\n- 稳定 Claude Code 版本缓存行为，使其不受解析后的二进制路径和文件修改时间影响，从而修复了 Node 20 CI 测试失败问题。\n- 停止仅根据环境变量猜测认证模式。\n- 在 `TodoWrite` 中保留任务 ID，检测以 `Agent` 记录的对话代理，并改进窄终端下的换行处理，包括对 OSC 超链接宽度的处理。\n- 改善 macOS 上的内存报告、配置缓存失效机制，以及在无法获取终端宽度时的回退渲染。\n- 清晰化官方使用数据的行为，并将 Bedrock 和未知定价的情况隐藏起来，避免显示误导性的估算值。","2026-04-04T06:56:07",{"id":150,"version":151,"summary_zh":152,"released_at":153},180631,"v0.0.10","### 新增\n- 可配置的 HUD 颜色覆盖，包括命名预设、256 色索引和十六进制值。\n- `display.customLine` 支持在 HUD 中显示简短的自定义文本。\n- 新增会话名称、组合上下文模式（`display.contextValue: \"both\"`）、Claude Code 版本以及展开布局中系统内存使用量近似值的可选显示开关。\n\n### 变更\n- 设置与插件检测现在更好地处理 `CLAUDE_CONFIG_DIR`、Windows 命令行引用规则，以及通过 Bun 的 `--env-file` 安装时未继承项目环境文件的情况。\n- 使用情况显示现在优先使用 Claude Code 标准输入中的 `rate_limits` 数据（如有），仍会在必要时回退到原有的 OAuth\u002F缓存路径，并以更清晰的方式展示仅限每周或免费用户的用量信息。\n- 上下文百分比和令牌数量显示现在会遵循 Claude Code 报告的上下文窗口大小，包括较新的 100 万上下文单位会话；同时提供一个较低的自动压缩估算值作为备用，该值与 `\u002Fcontext` 命令的结果更加一致。\n- 使用情况文本输出在同步过程中会保留上次成功的数值，适用时显示 7 天重置倒计时，并明确指出支持 Anthropic 流量路由的方式是使用标准代理环境变量。\n- 进度条和展开布局的输出现在能更流畅地适应较窄的终端宽度。\n\n### 修复\n- 在之前需要重启 Claude Code 才能显示 HUD 的会话中，设置过程变得更加可靠；安装后插件命令发现不再因未知技能错误而失败。\n- 使用情况处理在 OAuth 令牌刷新、代理隧道、显式 TLS 替换、零字节锁文件、过期缓存恢复以及可能导致重复 `429` 错误或同步失败的速率限制边缘情况下，都更具韧性。\n- 多账号设置及已安装多个版本插件的情况下，账户范围内的凭据查找和插件选择也更加可靠。\n- 展开布局的渲染现在能够正确保留速度、持续时间、额外标签以及仅限每周的用量输出。\n- 工具执行不再将终端滚动至顶部，且对话记录重新解析功能现在避免了在大型历史记录中重复缓存部分解析结果。","2026-03-23T02:38:12",{"id":155,"version":156,"summary_zh":157,"released_at":158},180632,"v0.0.9","## 变更\n- 通过 `CLAUDE_HUD_USAGE_TIMEOUT_MS` 添加使用量 API 超时覆盖（默认现为 15 秒）。\n\n## 修复\n- 设置说明现在会为 `win32 + bash` 环境生成 Shell 安全的 Windows 命令 (#121, #148)。\n- Bedrock 启动模型标签在缺少 `model.display_name` 时，会对已知模型 ID 进行规范化处理 (#137)。\n- 使用量 API 在代理和 OAuth 令牌刷新等边缘情况下的可靠性改进：\n  - 尊重 `HTTPS_PROXY`\u002F`ALL_PROXY`\u002F`HTTP_PROXY`，并支持 `NO_PROXY` 绕过。\n  - 当钥匙串中的令牌在没有 `subscriptionType` 元数据的情况下刷新时，仍能保留使用量和套餐显示。\n  - 减少在代理环境和高延迟环境中出现的误报 `timeout`\u002F`403` 使用量警告 (#146, #161, #162)。\n- 渲染输出现在保留普通空格而非不换行空格，以避免启动时状态栏垂直渲染问题 (#142)。","2026-03-05T07:40:58"]