Skip to main content

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)

Source distribution for fishpi-cli 0.3.0
File Size Uploaded
fishpi_cli-0.3.0.tar.gz 27.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fishpi-cli 0.3.0
File Interpreter ABI Platform
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}

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page