s1cli — Stage1st 论坛 CLI
安装
CODEBLOCK0
安装后用 python3 -m s1cli --help 确认（某些环境 PATH 里没有 s1cli 直接命令，但 python3 -m s1cli 始终有效）。
依赖：SOCKS 代理支持
若环境配置了 SOCKS 代理，登录时会报错：
CODEBLOCK1
修复方法（注意 zsh 下方括号需要加引号）：
CODEBLOCK2
⚠️ zsh 中不能写 pip3 install httpx[socks]（方括号会被 shell 解释），必须加引号。
命令速查
CODEBLOCK3
--json 输出解析说明
INLINECODE4 模式下，stdout 第一行是进度提示文字（非 JSON），从第二行起才是 JSON 数组。
不能直接 json.load(sys.stdin)，需跳过第一行：
CODEBLOCK4
使用流程
- 1. 首次使用：运行
login 保存会话（7 天有效，到期后重新登录） - 找版块 ID：先
list 列出所有版块，记下目标版块的数字 ID - 浏览帖子：
list <forum_id> 查看帖列，找到目标 INLINECODE9 - 查看 / 互动：
thread <thread_id> 阅读内容，reply 回帖
注意事项
- - 版块参数：
list 和 thread 用数字 ID；post/search 的 -f 用版块名（中文也可） - 发帖/回帖：需要已登录；内容支持普通文本和 BBCode
- 频率限制：工具内置随机 0.5-2s 延迟，批量操作不要在脚本中绕过
- 会话文件：
~/.config/s1cli/session.toml（7 天过期）
常见问题
| 错误 | 原因 | 解法 |
|---|
| INLINECODE18 | PATH 未包含脚本目录 | 改用 INLINECODE19 |
| INLINECODE20 |
缺少 SOCKS 依赖 |
pip3 install "httpx[socks]" socksio |
|
zsh: no matches found: httpx[socks] | zsh 吞掉方括号 | 必须加引号：
"httpx[socks]" |
|
JSONDecodeError: Expecting value | 直接解析含进度文字的 stdout | 跳过第一行再解析，见上方示例 |
| 登录失败 | 账号密码错误或网络问题 | 确认能访问 bbs.saraba1st.com |
| 找不到版块 | 版块名/ID 不对 | 先
python3 -m s1cli list 查 ID |
更多详情见 references/commands.md。
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
# 列出版块帖子（用 ID）
python3 -m s1cli list -p 2 # 第 2 页
python3 -m s1cli list --json # JSON 输出（见下方解析说明）
查看帖子
python3 -m s1cli thread
python3 -m s1cli thread -p 2 # 第 2 页
发帖 / 回帖
python3 -m s1cli post -f -t 标题 -c 内容
python3 -m s1cli reply -c 回复内容
搜索
python3 -m s1cli search 关键词
python3 -m s1cli search 关键词 -f
个人功能
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, , --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]:>7} | {t[title][:55]} — {t[author]})
使用流程
- 1. 首次使用：运行 login 保存会话（7 天有效，到期后重新登录）
- 找版块 ID：先 list 列出所有版块，记下目标版块的数字 ID
- 浏览帖子：list id> 查看帖列，找到目标 threadid
- 查看 / 互动：thread 阅读内容，reply 回帖
注意事项
- - 版块参数：list 和 thread 用数字 ID；post/search 的 -f 用版块名（中文也可）
- 发帖/回帖：需要已登录；内容支持普通文本和 BBCode
- 频率限制：工具内置随机 0.5-2s 延迟，批量操作不要在脚本中绕过
- 会话文件：~/.config/s1cli/session.toml（7 天过期）
常见问题
| 错误 | 原因 | 解法 |
|---|
| s1cli: command not found | PATH 未包含脚本目录 | 改用 python3 -m s1cli |
| socksio package is not installed |
缺少 SOCKS 依赖 | pip3 install httpx[socks] socksio |
| zsh: no matches found: httpx[socks] | zsh 吞掉方括号 | 必须加引号：httpx[socks] |
| JSONDecodeError: Expecting value | 直接解析含进度文字的 stdout | 跳过第一行再解析，见上方示例 |
| 登录失败 | 账号密码错误或网络问题 | 确认能访问 bbs.saraba1st.com |
| 找不到版块 | 版块名/ID 不对 | 先 python3 -m s1cli list 查 ID |
更多详情见 references/commands.md。
