Wenxing Neo Theme for Herdr ⚡

A Cyberpunk / Matrix-inspired workspace theme and telemetry dashboard for Herdr.

---

🌟 Highlights / 核心亮点

• Obsidian Dark & Matrix Emerald: 深黑底色（#1b1f23 / #1f2428）搭配荧光翠绿（#34d399 / #10b981），极具未来科技感。
• Real-time Telemetry Dashboard (右侧监控仪表盘):
  • 动态显示 Magpie 网关实时流量、请求数、消费金额与缓存命中率。
  • 活动大模型指示器（支持切换模型，如 Gemini 3.8 Flash、DeepSeek 等）。
  • Antigravity 剩余配额进度条（Gemini 5h/7d、Claude 5h/7d 独立监控）。
  • AI Agent 实时工作状态与心跳动画（working / blocked / done / idle）。
• Custom Top Tab Bar (my-terminals-bar): 专为 macOS 打造的极简集成式标签栏，整合 Traffic Lights 窗口控件与快捷操作按钮。
• Modular Cards (my-terminals-pane): 12px 圆角精致终端卡片设计，清晰展示工作目录、Git 分支与分屏切换。
• Claude Code Statusline 集成: 自带配色完美统一的终端状态栏脚本。

---

🚀 One-Line Installation / 一键安装

只需在终端中执行以下命令即可自动安装并激活主题：

curl -fsSL https://raw.githubusercontent.com/7Mrlan/herdr-theme/main/install.sh | bash

Or via Git Clone / 或者手动克隆安装：

git clone https://github.com/7Mrlan/herdr-theme.git
cd herdr-theme
./install.sh

---

⌨️ How to Use & Switch / 使用与切换

1. 自动切换：安装脚本会自动尝试调用 herdr-app 切换到 my-neo 布局。
2. 快捷键切换：在 Herdr 应用中，按下 Ctrl + Shift + L 即可在已安装的布局之间轮流切换。
3. 命令行切换：

   herdr-app do layout.switch '{"name":"my-neo"}'

---

📁 Repository Structure / 仓库结构

.
├── RECIPE.md                 # Herdr 官方布局规范与构建配方
├── preview.png               # 高清主题实机效果预览图
├── install.sh                # 一键安装脚本
├── uninstall.sh              # 一键卸载与还原脚本
├── statusline.js             # Claude Code 终端状态栏扩展
├── layouts/
│   └── my-neo.json           # 窗口布局结构定义
├── themes/
│   ├── wenxing.json          # 主题配色调色板
│   └── my-neo.json           # 备选终端配色方案
└── mods/
    ├── my-terminals-bar/     # 顶部窗口标签栏 Mod
    ├── my-terminals-pane/    # 终端面板卡片 Mod
    ├── neo/                  # 右侧综合遥测监控看板 Mod
    └── neo-status/           # 底部状态栏 Mod

---

🛠️ Requirements & Notes / 依赖与注意事项

1. 字体建议：推荐安装 Geist Mono 或 JetBrains Mono，以获得最佳对齐效果。
2. Magpie 联动：右侧仪表盘默认请求本地 Magpie 网关接口（http://127.0.0.1:3425）。若未运行 Magpie，面板会自动优雅降级，不会导致崩溃。
3. 自定义修改：
   • 右侧顶部的 WELCOME LANWENXING 可在 mods/neo/main.js 第 844 行直接修改为你的专属昵称。
   • 修改后保存，Herdr 会实时热重载更新！

---

🗑️ Uninstall / 卸载主题

如果你需要清理本主题并恢复 Herdr 默认布局：

cd herdr-theme
./uninstall.sh

---

📄 License

MIT License © 2026 Wenxing Lan (@7Mrlan)