sermo 0.3.2__tar.gz → 0.5.0__tar.gz

{sermo-0.3.2 → sermo-0.5.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: sermo
-Version: 0.3.2
-Summary: Command-line Sermo client
+Version: 0.5.0
+Summary: Command-line client for Sermo 言浪
 Author: Sermo
 Project-URL: Homepage, https://sermo.jyonn.space
 Keywords: sermo,chat,cli
@@ -18,16 +18,17 @@ Classifier: Topic :: Communications :: Chat
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 
-# sermo
+# Sermo 言浪 CLI
 
-Sermo 的命令行客户端。它直接接入 `sermo-backend` API，适合在终端里快速查看会话、发送文字消息和检查好友信息。
+Sermo 言浪的命令行客户端。它直接接入 `sermo-backend` API，适合在终端里快速查看会话、发送文字消息和检查好友信息。
 
 当前版本覆盖日常终端使用：
 
 - 支持进入空间并保存登录状态。
 - 支持查看当前账户、空间成员、聊天列表、好友列表、好友申请。
 - 支持查看聊天记录、发送文字消息、持续刷新新消息、监听全局新消息。
-- 支持 `sermo tui` 打开终端聊天界面，会话列表、消息流和输入框集中展示。
+- 默认提供不清屏的局部窗口选择器，会话、好友、成员和申请列表只展示光标附近 5 项。
+- 保留 `sermo tui` 全屏终端聊天界面，会话列表、消息流和输入框集中展示。
 - 支持好友申请处理、好友邀请链接、私聊打开、群聊创建和成员管理。
 - 支持账号资料、联系方式绑定、通知偏好、空间创建和管理员基础操作。
 - 图片、视频、语音、文件等多媒体消息在终端中展示为 `[图片]`、`[视频]`、`[语音]`、`[文件]`；也支持上传发送图片、视频和语音文件。
@@ -92,6 +93,20 @@ sermo me
 sermo chats
 ```
 
+终端中会显示光标附近 5 个会话。使用 `↑/↓` 选择、`Enter` 打开、`Esc` 返回；也支持 `j/k` 和 `Ctrl+N/Ctrl+P`。
+
+直接输出完整列表，适合管道和脚本：
+
+```bash
+sermo chats --list
+```
+
+调整局部窗口行数：
+
+```bash
+sermo chats --window 7
+```
+
 打开 TUI：
 
 ```bash
@@ -100,11 +115,14 @@ sermo tui
 
 在 TUI 里：
 
-- `↑/↓` 切换会话。
-- 直接输入文字，按 `Enter` 发送。
-- `F5` 手动刷新。
-- `Ctrl+U` 清空输入。
-- `Esc` 或 `F10` 退出；输入框为空时也可以按 `q` 退出。
+- `Tab/Shift+Tab` 在会话、消息和输入框之间切换焦点。
+- 会话焦点下使用 `↑/↓` 或 `j/k` 切换会话。
+- 消息焦点下使用 `↑/↓` 滚动，`PageUp/PageDown` 翻页，滑到顶部自动加载历史。
+- 查看历史时不会强制跳到底部；标题会提示新消息数量，`End` 回到最新消息。
+- 输入框支持左右移动、`Home/End`、退格与 Delete，并按会话保存草稿。
+- 发送消息会立即展示“发送中”；失败后保留消息，在消息焦点按 `r` 重试。
+- `Enter` 发送，`F5` 手动刷新，`Ctrl+U` 清空输入。
+- `Esc` 或 `F10` 退出。
 
 打开聊天：
 
@@ -136,6 +154,17 @@ sermo chat 1 --follow
 sermo friends
 ```
 
+好友、空间成员、好友申请和群聊邀请使用同一套局部窗口交互：
+
+```bash
+sermo friends
+sermo users
+sermo requests
+sermo group invites
+```
+
+这些命令也都支持 `--list` 和 `--window`。
+
 查看好友申请：
 
 ```bash

{sermo-0.3.2 → sermo-0.5.0}/README.md

@@ -1,13 +1,14 @@
-# sermo
+# Sermo 言浪 CLI
 
-Sermo 的命令行客户端。它直接接入 `sermo-backend` API，适合在终端里快速查看会话、发送文字消息和检查好友信息。
+Sermo 言浪的命令行客户端。它直接接入 `sermo-backend` API，适合在终端里快速查看会话、发送文字消息和检查好友信息。
 
 当前版本覆盖日常终端使用：
 
 - 支持进入空间并保存登录状态。
 - 支持查看当前账户、空间成员、聊天列表、好友列表、好友申请。
 - 支持查看聊天记录、发送文字消息、持续刷新新消息、监听全局新消息。
-- 支持 `sermo tui` 打开终端聊天界面，会话列表、消息流和输入框集中展示。
+- 默认提供不清屏的局部窗口选择器，会话、好友、成员和申请列表只展示光标附近 5 项。
+- 保留 `sermo tui` 全屏终端聊天界面，会话列表、消息流和输入框集中展示。
 - 支持好友申请处理、好友邀请链接、私聊打开、群聊创建和成员管理。
 - 支持账号资料、联系方式绑定、通知偏好、空间创建和管理员基础操作。
 - 图片、视频、语音、文件等多媒体消息在终端中展示为 `[图片]`、`[视频]`、`[语音]`、`[文件]`；也支持上传发送图片、视频和语音文件。
@@ -72,6 +73,20 @@ sermo me
 sermo chats
 ```
 
+终端中会显示光标附近 5 个会话。使用 `↑/↓` 选择、`Enter` 打开、`Esc` 返回；也支持 `j/k` 和 `Ctrl+N/Ctrl+P`。
+
+直接输出完整列表，适合管道和脚本：
+
+```bash
+sermo chats --list
+```
+
+调整局部窗口行数：
+
+```bash
+sermo chats --window 7
+```
+
 打开 TUI：
 
 ```bash
@@ -80,11 +95,14 @@ sermo tui
 
 在 TUI 里：
 
-- `↑/↓` 切换会话。
-- 直接输入文字，按 `Enter` 发送。
-- `F5` 手动刷新。
-- `Ctrl+U` 清空输入。
-- `Esc` 或 `F10` 退出；输入框为空时也可以按 `q` 退出。
+- `Tab/Shift+Tab` 在会话、消息和输入框之间切换焦点。
+- 会话焦点下使用 `↑/↓` 或 `j/k` 切换会话。
+- 消息焦点下使用 `↑/↓` 滚动，`PageUp/PageDown` 翻页，滑到顶部自动加载历史。
+- 查看历史时不会强制跳到底部；标题会提示新消息数量，`End` 回到最新消息。
+- 输入框支持左右移动、`Home/End`、退格与 Delete，并按会话保存草稿。
+- 发送消息会立即展示“发送中”；失败后保留消息，在消息焦点按 `r` 重试。
+- `Enter` 发送，`F5` 手动刷新，`Ctrl+U` 清空输入。
+- `Esc` 或 `F10` 退出。
 
 打开聊天：
 
@@ -116,6 +134,17 @@ sermo chat 1 --follow
 sermo friends
 ```
 
+好友、空间成员、好友申请和群聊邀请使用同一套局部窗口交互：
+
+```bash
+sermo friends
+sermo users
+sermo requests
+sermo group invites
+```
+
+这些命令也都支持 `--list` 和 `--window`。
+
 查看好友申请：
 
 ```bash

{sermo-0.3.2 → sermo-0.5.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sermo"
-version = "0.3.2"
-description = "Command-line Sermo client"
+version = "0.5.0"
+description = "Command-line client for Sermo 言浪"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = []

{sermo-0.3.2 → sermo-0.5.0}/sermo.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: sermo
-Version: 0.3.2
-Summary: Command-line Sermo client
+Version: 0.5.0
+Summary: Command-line client for Sermo 言浪
 Author: Sermo
 Project-URL: Homepage, https://sermo.jyonn.space
 Keywords: sermo,chat,cli
@@ -18,16 +18,17 @@ Classifier: Topic :: Communications :: Chat
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 
-# sermo
+# Sermo 言浪 CLI
 
-Sermo 的命令行客户端。它直接接入 `sermo-backend` API，适合在终端里快速查看会话、发送文字消息和检查好友信息。
+Sermo 言浪的命令行客户端。它直接接入 `sermo-backend` API，适合在终端里快速查看会话、发送文字消息和检查好友信息。
 
 当前版本覆盖日常终端使用：
 
 - 支持进入空间并保存登录状态。
 - 支持查看当前账户、空间成员、聊天列表、好友列表、好友申请。
 - 支持查看聊天记录、发送文字消息、持续刷新新消息、监听全局新消息。
-- 支持 `sermo tui` 打开终端聊天界面，会话列表、消息流和输入框集中展示。
+- 默认提供不清屏的局部窗口选择器，会话、好友、成员和申请列表只展示光标附近 5 项。
+- 保留 `sermo tui` 全屏终端聊天界面，会话列表、消息流和输入框集中展示。
 - 支持好友申请处理、好友邀请链接、私聊打开、群聊创建和成员管理。
 - 支持账号资料、联系方式绑定、通知偏好、空间创建和管理员基础操作。
 - 图片、视频、语音、文件等多媒体消息在终端中展示为 `[图片]`、`[视频]`、`[语音]`、`[文件]`；也支持上传发送图片、视频和语音文件。
@@ -92,6 +93,20 @@ sermo me
 sermo chats
 ```
 
+终端中会显示光标附近 5 个会话。使用 `↑/↓` 选择、`Enter` 打开、`Esc` 返回；也支持 `j/k` 和 `Ctrl+N/Ctrl+P`。
+
+直接输出完整列表，适合管道和脚本：
+
+```bash
+sermo chats --list
+```
+
+调整局部窗口行数：
+
+```bash
+sermo chats --window 7
+```
+
 打开 TUI：
 
 ```bash
@@ -100,11 +115,14 @@ sermo tui
 
 在 TUI 里：
 
-- `↑/↓` 切换会话。
-- 直接输入文字，按 `Enter` 发送。
-- `F5` 手动刷新。
-- `Ctrl+U` 清空输入。
-- `Esc` 或 `F10` 退出；输入框为空时也可以按 `q` 退出。
+- `Tab/Shift+Tab` 在会话、消息和输入框之间切换焦点。
+- 会话焦点下使用 `↑/↓` 或 `j/k` 切换会话。
+- 消息焦点下使用 `↑/↓` 滚动，`PageUp/PageDown` 翻页，滑到顶部自动加载历史。
+- 查看历史时不会强制跳到底部；标题会提示新消息数量，`End` 回到最新消息。
+- 输入框支持左右移动、`Home/End`、退格与 Delete，并按会话保存草稿。
+- 发送消息会立即展示“发送中”；失败后保留消息，在消息焦点按 `r` 重试。
+- `Enter` 发送，`F5` 手动刷新，`Ctrl+U` 清空输入。
+- `Esc` 或 `F10` 退出。
 
 打开聊天：
 
@@ -136,6 +154,17 @@ sermo chat 1 --follow
 sermo friends
 ```
 
+好友、空间成员、好友申请和群聊邀请使用同一套局部窗口交互：
+
+```bash
+sermo friends
+sermo users
+sermo requests
+sermo group invites
+```
+
+这些命令也都支持 `--list` 和 `--window`。
+
 查看好友申请：
 
 ```bash

{sermo-0.3.2 → sermo-0.5.0}/sermo.egg-info/SOURCES.txt

@@ -10,5 +10,8 @@ sermo_cli/__main__.py
 sermo_cli/api.py
 sermo_cli/cli.py
 sermo_cli/formatting.py
+sermo_cli/interactive.py
 sermo_cli/store.py
-sermo_cli/tui.py
+sermo_cli/tui.py
+tests/test_interactive.py
+tests/test_tui.py

{sermo-0.3.2 → sermo-0.5.0}/sermo_cli/__init__.py

@@ -1,3 +1,3 @@
 """Command-line client for Sermo."""
 
-__version__ = "0.2.0"
+__version__ = "0.5.0"

{sermo-0.3.2 → sermo-0.5.0}/sermo_cli/cli.py

@@ -10,6 +10,7 @@ from typing import Any
 
 from .api import ApiClient, SermoApiError
 from .formatting import chat_title, format_time, message_text, print_header, style, user_name
+from .interactive import choose
 from .store import SessionStore
 
 
@@ -151,6 +152,30 @@ def command_chats(args: argparse.Namespace) -> int:
     if not chats:
         print("暂无会话。")
         return 0
+    if sys.stdin.isatty() and not args.list:
+        def render_chat_choice(chat: dict[str, Any]) -> str:
+            unread = f" · {chat.get('unread_count')} 条新消息" if chat.get("unread_count") else ""
+            preview = message_text(chat.get("last_message") or {}) if chat.get("last_message") else "暂无消息"
+            return f"{chat_title(chat, self_user_id)}{unread}  {preview}"
+
+        selected = choose(
+            chats,
+            render_chat_choice,
+            title="选择会话",
+            window_size=args.window,
+        )
+        if selected is None:
+            return 0
+        print(style.muted(f"进入 {chat_title(selected, self_user_id)}"))
+        return command_chat(argparse.Namespace(**{
+            **vars(args),
+            "chat_id": int(selected["chat_id"]),
+            "limit": args.limit,
+            "before": None,
+            "follow": False,
+            "interval": 5.0,
+            "no_mark_read": False,
+        }))
     print_header("聊天")
     for chat in chats:
         last = chat.get("last_message")
@@ -268,11 +293,43 @@ def command_send(args: argparse.Namespace) -> int:
 
 def command_friends(args: argparse.Namespace) -> int:
     client = build_client(args)
-    require_session(client)
+    session = require_session(client)
     friends = client.friends()
     if not friends:
         print("暂无好友。")
         return 0
+    if sys.stdin.isatty() and not args.list:
+        selected = choose(
+            friends,
+            lambda friend: f"{user_name(friend)}  {'在线' if friend.get('is_alive') else '离线'}",
+            title="选择好友",
+            window_size=args.window,
+        )
+        if selected is None:
+            return 0
+        action = choose(
+            ("chat", "profile", "back"),
+            lambda item: {"chat": "发消息", "profile": "查看资料", "back": "返回"}[item],
+            title=user_name(selected),
+            window_size=3,
+        )
+        if action == "chat":
+            chat = client.direct_chat(int(selected["user_id"]))
+            return command_chat(argparse.Namespace(**{
+                **vars(args),
+                "chat_id": int(chat["chat_id"]),
+                "limit": 30,
+                "before": None,
+                "follow": False,
+                "interval": 5.0,
+                "no_mark_read": False,
+            }))
+        if action == "profile":
+            print_header(user_name(selected), "好友")
+            print(f"用户 ID: {selected.get('user_id')}")
+            print(f"状态: {'在线' if selected.get('is_alive') else '离线'}")
+            print(f"认证: {'已认证' if selected.get('verified') else '未认证'}")
+        return 0
     print_header("好友")
     for friend in friends:
         online = style.green("在线") if friend.get("is_alive") else style.muted("离线")
@@ -286,6 +343,44 @@ def command_requests(args: argparse.Namespace) -> int:
     payload = client.friend_requests()
     incoming = payload.get("incoming") or []
     outgoing = payload.get("outgoing") or []
+    if sys.stdin.isatty() and not args.list and (incoming or outgoing):
+        rows = [("incoming", item) for item in incoming] + [("outgoing", item) for item in outgoing]
+        selected = choose(
+            rows,
+            lambda row: (
+                f"{'收到' if row[0] == 'incoming' else '发出'} · "
+                f"{user_name(row[1].get('from_user') if row[0] == 'incoming' else row[1].get('to_user'))}"
+            ),
+            title="好友申请",
+            window_size=args.window,
+        )
+        if selected is None:
+            return 0
+        direction, item = selected
+        user = item.get("from_user") if direction == "incoming" else item.get("to_user")
+        user_id = int((user or {}).get("user_id"))
+        actions = ("accept", "ignore", "back") if direction == "incoming" else ("withdraw", "back")
+        action = choose(
+            actions,
+            lambda value: {
+                "accept": "接受申请",
+                "ignore": "忽略申请",
+                "withdraw": "撤回申请",
+                "back": "返回",
+            }[value],
+            title=user_name(user),
+            window_size=3,
+        )
+        if action == "accept":
+            client.respond_friend_request(user_id, True)
+            print("已接受好友申请。")
+        elif action == "ignore":
+            client.respond_friend_request(user_id, False)
+            print("已忽略好友申请。")
+        elif action == "withdraw":
+            client.remove_friend(user_id)
+            print("已撤回好友申请。")
+        return 0
     print_header("好友申请")
     print(style.bold("收到的"))
     if incoming:
@@ -309,6 +404,46 @@ def command_users(args: argparse.Namespace) -> int:
     if not users:
         print("没有找到用户。")
         return 0
+    if sys.stdin.isatty() and not args.list:
+        selected = choose(
+            users,
+            lambda user: f"{user_name(user)}  {'在线' if user.get('is_alive') else '离线'}  {'已认证' if user.get('verified') else '未认证'}",
+            title="选择空间成员",
+            window_size=args.window,
+        )
+        if selected is None:
+            return 0
+        action = choose(
+            ("chat", "friend", "profile", "back"),
+            lambda value: {
+                "chat": "发起私聊",
+                "friend": "发送好友申请",
+                "profile": "查看资料",
+                "back": "返回",
+            }[value],
+            title=user_name(selected),
+            window_size=4,
+        )
+        if action == "chat":
+            chat = client.direct_chat(int(selected["user_id"]))
+            return command_chat(argparse.Namespace(**{
+                **vars(args),
+                "chat_id": int(chat["chat_id"]),
+                "limit": 30,
+                "before": None,
+                "follow": False,
+                "interval": 5.0,
+                "no_mark_read": False,
+            }))
+        if action == "friend":
+            client.create_friend_request(int(selected["user_id"]))
+            print("好友申请已发送。")
+        elif action == "profile":
+            print_header(user_name(selected), "空间成员")
+            print(f"用户 ID: {selected.get('user_id')}")
+            print(f"状态: {'在线' if selected.get('is_alive') else '离线'}")
+            print(f"认证: {'已认证' if selected.get('verified') else '未认证'}")
+        return 0
     print_header("空间成员")
     for user in users:
         online = style.green("在线") if user.get("is_alive") else style.muted("离线")
@@ -486,6 +621,27 @@ def command_group_invites(args: argparse.Namespace) -> int:
     if not invites:
         print("暂无群聊邀请。")
         return 0
+    if sys.stdin.isatty() and not args.list:
+        selected = choose(
+            invites,
+            lambda item: chat_title(item.get("chat") if isinstance(item, dict) and item.get("chat") else item),
+            title="群聊邀请",
+            window_size=args.window,
+        )
+        if selected is None:
+            return 0
+        chat = selected.get("chat") if isinstance(selected, dict) else None
+        chat_id = selected.get("chat_id") or (chat or {}).get("chat_id")
+        action = choose(
+            ("accept", "reject", "back"),
+            lambda value: {"accept": "接受邀请", "reject": "拒绝邀请", "back": "返回"}[value],
+            title=chat_title(chat or selected),
+            window_size=3,
+        )
+        if action in {"accept", "reject"}:
+            client.respond_group_invite(int(chat_id), action == "accept")
+            print("已接受群聊邀请。" if action == "accept" else "已拒绝群聊邀请。")
+        return 0
     print_header("群聊邀请")
     for item in invites:
         chat = item.get("chat") if isinstance(item, dict) else None
@@ -770,7 +926,7 @@ def command_admin_logout(args: argparse.Namespace) -> int:
 
 
 def build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(prog="sermo", description="Sermo 命令行客户端")
+    parser = argparse.ArgumentParser(prog="sermo", description="Sermo 言浪命令行客户端")
     parser.add_argument("--api", help="Sermo API 地址，默认读取 SERMO_API_BASE 或 https://api.sermo.jyonn.space")
     subparsers = parser.add_subparsers(dest="command", required=True)
 
@@ -788,6 +944,9 @@ def build_parser() -> argparse.ArgumentParser:
     me.set_defaults(func=command_me)
 
     chats = subparsers.add_parser("chats", help="查看聊天列表")
+    chats.add_argument("--list", action="store_true", help="直接输出完整列表，不进入选择器")
+    chats.add_argument("--window", type=int, default=5, help="选择器可见行数")
+    chats.add_argument("-n", "--limit", type=int, default=30, help="进入会话后加载的消息数")
     chats.set_defaults(func=command_chats)
 
     chat = subparsers.add_parser("chat", help="打开聊天并发送文字")
@@ -810,9 +969,13 @@ def build_parser() -> argparse.ArgumentParser:
     send.set_defaults(func=command_send)
 
     friends = subparsers.add_parser("friends", help="查看好友")
+    friends.add_argument("--list", action="store_true", help="直接输出完整列表")
+    friends.add_argument("--window", type=int, default=5, help="选择器可见行数")
     friends.set_defaults(func=command_friends)
 
     requests = subparsers.add_parser("requests", help="查看好友申请")
+    requests.add_argument("--list", action="store_true", help="直接输出完整列表")
+    requests.add_argument("--window", type=int, default=5, help="选择器可见行数")
     requests.set_defaults(func=command_requests)
 
     users = subparsers.add_parser("users", help="搜索/查看空间成员")
@@ -820,6 +983,8 @@ def build_parser() -> argparse.ArgumentParser:
     users.add_argument("--online", action="store_true", help="只看在线成员")
     users.add_argument("--limit", type=int, default=50)
     users.add_argument("--offset", type=int, default=0)
+    users.add_argument("--list", action="store_true", help="直接输出完整列表")
+    users.add_argument("--window", type=int, default=5, help="选择器可见行数")
     users.set_defaults(func=command_users)
 
     direct = subparsers.add_parser("direct", help="打开一个私聊")
@@ -892,6 +1057,8 @@ def build_parser() -> argparse.ArgumentParser:
     group_delete.add_argument("-y", "--yes", action="store_true")
     group_delete.set_defaults(func=command_group_delete)
     group_invites = group_sub.add_parser("invites", help="查看群聊邀请")
+    group_invites.add_argument("--list", action="store_true", help="直接输出完整列表")
+    group_invites.add_argument("--window", type=int, default=5, help="选择器可见行数")
     group_invites.set_defaults(func=command_group_invites)
     group_accept = group_sub.add_parser("accept", help="接受群聊邀请")
     group_accept.add_argument("chat_id", type=int)