Metadata-Version: 2.4
Name: sermo
Version: 0.1.0
Summary: Command-line Sermo client
Author: Sermo
Project-URL: Homepage, https://sermo.jyonn.space
Keywords: sermo,chat,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# sermo

Sermo 的命令行客户端。它直接接入 `sermo-backend` API，适合在终端里快速查看会话、发送文字消息和检查好友信息。

当前版本先聚焦文字体验：

- 支持进入空间并保存登录状态。
- 支持查看当前账户、聊天列表、好友列表、好友申请。
- 支持查看聊天记录、发送文字消息、持续刷新新消息。
- 图片、视频、语音、文件等多媒体消息暂不下载，统一展示为 `[图片]`、`[视频]`、`[语音]`、`[文件]`。
- 暂不展示头像。

## 安装

开发环境下可以直接运行：

```bash
python -m sermo_cli --help
```

也可以安装为本地命令：

```bash
pip install -e .
sermo --help
```

从 PyPI 安装：

```bash
pip install sermo
sermo --help
```

## API 地址

默认 API 地址是：

```text
https://api.sermo.jyonn.space
```

可以用环境变量或参数覆盖：

```bash
SERMO_API_BASE=http://localhost:8000 python -m sermo_cli chats
python -m sermo_cli --api http://localhost:8000 chats
```

## 常用命令

登录 / 进入空间：

```bash
sermo login --space yuanmeng --name 软糖大啾咪
```

如果昵称需要访问密码，CLI 会自动提示输入密码。

查看当前账户：

```bash
sermo me
```

查看聊天列表：

```bash
sermo chats
```

打开聊天：

```bash
sermo chat 1
```

在聊天界面里：

- 直接输入文字并回车即可发送。
- 输入 `/refresh` 刷新新消息。
- 输入 `/quit` 退出。

只发送一条消息：

```bash
sermo send 1 你好
```

持续刷新聊天：

```bash
sermo chat 1 --follow
```

查看好友：

```bash
sermo friends
```

查看好友申请：

```bash
sermo requests
```

退出：

```bash
sermo logout
```

## 登录状态

登录状态默认保存到：

```text
~/.sermo-cli/config.json
```

可以用 `SERMO_CLI_CONFIG` 指定其他路径，便于测试或多账号切换。
