FishPi TUI 终端客户端
基于 Textual 与 Rich 构建的现代摸鱼派 (FishPi) 终端图形界面(TUI)与命令行工具。
🌟 特色功能
- 💬 实时聊天室:
- 基于 WebSocket 实时收发消息
- 支持话题展示与修改 (
/topic) - 支持发送彩色弹幕 (
/barrage) - 支持抢红包 (
/rp <id> [手势]) - 支持消息撤回 (
/revoke <id>) - 消息历史回溯 (
/history [页码])
- 🌙 清风明月:微言动态时间线浏览与实时发布。
- 📰 社区文章:社区热榜/最新文章浏览与详情阅读。
- 🔔 通知中心:积分、系统、评论、@提及分类统计与一键标为已读。
- 👤 个人主页与设置:
- 积分、连续签到、在线时长与勋章展示
- 今日签到状态检测
- 实时活跃度统计与一键领取活跃度奖励
- Token 持久化配置(保存在
~/.config/fishpi/config.json)
🚀 启动方式
1. 作为独立包安装使用(推荐)
# 从 PyPI 安装独立 CLI 客户端
pip install fishpi-cli
# 启动 TUI 界面
fishpi.py
2. 作为主包可选依赖使用
# 安装带有 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. 本地开发与源码运行
python3 cli/main.py
# 或
python3 -m cli.fishpi_cli.main
⌨️ 快捷键说明
| 按键 | 功能 |
|---|---|
M |
打开 ☰ 快捷菜单 (支持弹窗操作与跳转) |
1 |
切换到 💬 聊天室 |
2 |
切换到 🌙 清风明月 |
3 |
切换到 📰 社区文章 |
4 |
切换到 🔔 通知中心 |
5 |
切换到 👤 个人中心 |
R |
刷新当前页面数据 |
D |
切换暗色 / 亮色主题 |
Q |
退出程序 |
🛠️ 命令行快捷指令
除了交互式 TUI 之外,fishpi.py 命令行还支持无头(Headless)快捷执行:
# 登录或配置 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 "大家好!"
Metadata
Release files for fishpi-cli 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fishpi_cli-0.3.0.tar.gz | 27.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fishpi_cli-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 58.8 kB
Release files / fishpi_cli-0.3.0.tar.gz
| Download URL | fishpi_cli-0.3.0.tar.gz |
|---|---|
| Size | 27.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e318a59c2fa56106b4021b7c9018c8903aa22b4b6d094e7dad26e5c0385bc5fa
|
|
BLAKE2b-256 checksum How to use checksums |
eb8875ec6065cc55cecc6a977ca0ae93ca15906b062f2c90486750195105421f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / fishpi_cli-0.3.0-py3-none-any.whl
| Download URL | fishpi_cli-0.3.0-py3-none-any.whl |
|---|---|
| Size | 31.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cf87d7120a470d044597c760fce9998d8fbb570038ca0a9baa711984e543cd67
|
|
BLAKE2b-256 checksum How to use checksums |
b2cd7eef3fad7d711fa9d5304369cd1397effb8a10532b5e2d36a55b24777bf0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|