🦦 Otter

Otter (ot) 是一个基于 Mihomo
核心的极简主义 Clash TUI
客户端。它专为速度和可组合性而设计，提供流畅的命令行体验和交互式界面。

✨ 特性

- 轻量级: 基于 Bun 和 Ink 构建，启动迅速。
- Mihomo 核心: 使用高性能的 Mihomo (Clash Meta) 作为底层核心。
- 交互式 TUI: 提供美观的终端用户界面，支持键盘导航。
- 订阅管理: 支持多种订阅格式（Clash YAML, Base64, VMess/SS/Trojan 链接）。
- 系统集成: 一键开启/关闭 macOS 系统代理，支持 Shell 代理注入。
- 实时监控: 实时查看流量速度、内存占用和节点状态。

📦 安装

$3

确保你已经安装了 Bun。

``bash
bun add -g @meanc/otter
`

$3

`bash


克隆仓库

git clone https://github.com/yourusername/otter.git
cd otter

安装依赖

bun install

链接到全局 (可选)

bun link
`

🚀 使用指南

$3

- ot up / ot start: 启动 Clash 核心（后台静默运行）。
- ot down / ot stop: 停止 Clash 核心。
- ot status: 查看核心运行状态、版本、内存占用、实时流量及订阅信息。
- ot log: 实时查看内核日志。

$3

- ot sub add [name]: 添加订阅源。支持自动解析 Base64 和节点链接。
- ot sub rm : 删除订阅源。
- ot sub update : 更新指定订阅源。
- ot sub use : 切换当前使用的订阅源。
- ot sub ls: 列出所有订阅源。

$3

- ot ls: 列出所有代理组及当前选中的节点。
- ot use [node_name]: 切换节点。支持模糊搜索。
- ot use -p : 通过序号切换 Proxy 组节点。
- ot use -g : 通过序号切换 GLOBAL 组节点。
- ot test: 测试当前节点的延迟。
- ot best: 自动测试并切换到延迟最低的节点。

$3

- ot on: 开启 macOS 系统代理。
- ot off: 关闭 macOS 系统代理。
- ot shell: 输出当前 Shell 的代理环境变量命令（可直接 eval $(ot shell)）。
- ot mode [rule|global|direct]: 查看或切换代理模式（规则/全局/直连）。

$3

- ot ui: 进入全屏交互式界面。

TUI 快捷键:

- ↑/↓: 上下移动光标。
- ←/→ 或 Tab: 在代理组列表和节点列表之间切换。
- Enter: 选中节点或展开组。
- s: 快速开启/关闭系统代理。
- m: 切换代理模式 (Rule/Global/Direct)。
- q: 退出 TUI。

🛠️ 开发

本地运行：

`bash
bun run index.ts
``

📝 许可证

GPL-3.0 License