Metadata-Version: 2.4
Name: fishpi-cli
Version: 0.3.0
Summary: Terminal TUI and command-line interface for FishPi (摸鱼派)
Author-email: "Hancel.Lin" <imlinhanchao@foxmail.com>
License-Expression: MIT
Keywords: fishpi,tui,cli,terminal,chatroom
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: fishpi>=0.3.0
Requires-Dist: textual>=0.70.0
Requires-Dist: rich>=13.0.0

# FishPi TUI 终端客户端

基于 [Textual](https://textual.textualize.io/) 与 [Rich](https://github.com/Textualize/rich) 构建的现代摸鱼派 (FishPi) 终端图形界面（TUI）与命令行工具。

---

## 🌟 特色功能

- 💬 **实时聊天室**：
  - 基于 WebSocket 实时收发消息
  - 支持话题展示与修改 (`/topic`)
  - 支持发送彩色弹幕 (`/barrage`)
  - 支持抢红包 (`/rp <id> [手势]`)
  - 支持消息撤回 (`/revoke <id>`)
  - 消息历史回溯 (`/history [页码]`)
- 🌙 **清风明月**：微言动态时间线浏览与实时发布。
- 📰 **社区文章**：社区热榜/最新文章浏览与详情阅读。
- 🔔 **通知中心**：积分、系统、评论、@提及分类统计与一键标为已读。
- 👤 **个人主页与设置**：
  - 积分、连续签到、在线时长与勋章展示
  - 今日签到状态检测
  - 实时活跃度统计与一键领取活跃度奖励
  - Token 持久化配置（保存在 `~/.config/fishpi/config.json`）

---

## 🚀 启动方式

### 1. 作为独立包安装使用（推荐）
```bash
# 从 PyPI 安装独立 CLI 客户端
pip install fishpi-cli

# 启动 TUI 界面
fishpi.py
```

### 2. 作为主包可选依赖使用
```bash
# 安装带有 TUI 依赖的 fishpi SDK
pip install "fishpi[tui]"

# 免安装直接运行 (uvx 或 pipx)
uvx --from "fishpi-cli" fishpi.py
pipx run --spec "fishpi-cli" fishpi.py

# 启动 TUI 界面
fishpi.py
```

### 3. 本地开发与源码运行
```bash
python3 cli/main.py
# 或
python3 -m cli.fishpi_cli.main
```

---

## ⌨️ 快捷键说明

| 按键 | 功能 |
| :--- | :--- |
| `M` | 打开 **☰ 快捷菜单** (支持弹窗操作与跳转) |
| `1` | 切换到 **💬 聊天室** |
| `2` | 切换到 **🌙 清风明月** |
| `3` | 切换到 **📰 社区文章** |
| `4` | 切换到 **🔔 通知中心** |
| `5` | 切换到 **👤 个人中心** |
| `R` | 刷新当前页面数据 |
| `D` | 切换暗色 / 亮色主题 |
| `Q` | 退出程序 |

---

## 🛠️ 命令行快捷指令

除了交互式 TUI 之外，`fishpi.py` 命令行还支持无头（Headless）快捷执行：

```bash
# 登录或配置 API Token
fishpi.py login
fishpi.py login -t "your-api-token"

# 查询当前账号或指定用户信息
fishpi.py user
fishpi.py user imlinhanchao

# 检查签到与活跃度状态（并自动尝试领取活跃奖励）
fishpi.py checkin

# 查看未读通知数量
fishpi.py notice

# 快捷发送一条清风明月
fishpi.py breezemoon "今天天气真好，摸鱼中..."

# 快捷发送一条聊天室消息
fishpi.py chatroom "大家好！"
```
