s1cli

# s1cli — Stage1st 论坛 CLI

## 安装

```bash
# PyPI（如已发布）
pip3 install s1cli

# 或从源码
git clone https://github.com/Geoion/s1cli.git && cd s1cli && pip3 install -e .
```

安装后用 `python3 -m s1cli --help` 确认（某些环境 PATH 里没有 `s1cli` 直接命令，但 `python3 -m s1cli` 始终有效）。

### 依赖：SOCKS 代理支持

若环境配置了 SOCKS 代理，登录时会报错：

```
Using SOCKS proxy, but the 'socksio' package is not installed.
```

修复方法（注意 zsh 下方括号需要加引号）：

```bash
pip3 install "httpx[socks]" socksio
```

> ⚠️ zsh 中不能写 `pip3 install httpx[socks]`（方括号会被 shell 解释），必须加引号。

## 命令速查

```bash
# 登录 / 登出
python3 -m s1cli login           # 交互输入用户名密码
python3 -m s1cli login -u USER -p PASS
python3 -m s1cli logout

# 版块 & 帖子列表
python3 -m s1cli list            # 列出所有版块（含 ID）
python3 -m s1cli list <forum_id> # 列出版块帖子（用 ID）
python3 -m s1cli list <forum_id> -p 2   # 第 2 页
python3 -m s1cli list <forum_id> --json # JSON 输出（见下方解析说明）

# 查看帖子
python3 -m s1cli thread <thread_id>
python3 -m s1cli thread <thread_id> -p 2   # 第 2 页

# 发帖 / 回帖
python3 -m s1cli post -f <forum_name> -t "标题" -c "内容"
python3 -m s1cli reply <thread_id> -c "回复内容"

# 搜索
python3 -m s1cli search "关键词"
python3 -m s1cli search "关键词" -f <forum_name>

# 个人功能
python3 -m s1cli checkin         # 每日签到
python3 -m s1cli profile         # 个人信息

# 配置
python3 -m s1cli config show
python3 -m s1cli config set theme=dark
```

## --json 输出解析说明

`--json` 模式下，stdout 第一行是进度提示文字（非 JSON），从第二行起才是 JSON 数组。
**不能直接 `json.load(sys.stdin)`**，需跳过第一行：

```python
import subprocess, json

result = subprocess.run(
    ['python3', '-m', 's1cli', 'list', '<forum_id>', '--json'],
    capture_output=True, text=True
)
# 跳过第一行进度提示，剩余部分是完整 JSON
lines = result.stdout.split('\n', 1)
data = json.loads(lines[1])

for t in data:
    print(f"回{t['replies']:>5} 看{t['views...