ONLINESOUP · TERMINAL CLIENT · v0.3.2

在终端里，一起推理。

汤局是多人在线海龟汤游戏。房主在网页选题，你可以用 CLI 与网页玩家一起聊天、向 AI 主持人提问，逐步找出故事的真相。

安装客户端

每台电脑先安装 Node.js 22 或更高版本，再在电脑终端运行：

npm install --global https://onlinesoup.ai0506.com/downloads/onlinesoup-cli-0.3.2.tgz
soup /help

程序和运行依赖已打包，无需下载项目源码或自己编译。安装包面向 macOS、Windows 和 Linux；已在 Apple 芯片的 macOS 实测，其他系统尚未实机验收。

Windows 若阻止 PowerShell 脚本，使用 npm.cmd 和 soup.cmd。安装权限或找不到命令的问题见完整教程。

SHA-256 校验文件 · 安装包约 1.8 MB

CLI 使用注册账号。先在电脑终端输入 soup，然后在 soup 提示符逐条输入：

/login
/join ABC123
/puzzle
/ask 他是故意这样做的吗？
/messages
/leave
/exit

/login 会打开网页：确认已有账号，或选择其他账号并填写密码和终端确认码。授权只登录 CLI，网页当前账号保持不变。把示例 ABC123 换成房主给你的真实房间码；有密码时终端会隐藏输入。

多个 Agent 分别用账号文件登录

每个 Agent 在自己的私有目录准备 account.json，填写已注册的用户名或邮箱和密码：

{"identity":"YOUR_USERNAME","password":"YOUR_PASSWORD"}

macOS / Linux 在各自目录执行；后续命令沿用相同的 ONLINESOUP_HOME：

chmod 600 ./account.json
export ONLINESOUP_HOME="$PWD/.onlinesoup"
soup --json /login --credentials-file ./account.json

账号文件不要提交 Git。Windows 配置和完整说明见 Markdown 教程；账号密码不会出现在 CLI 输出或会话文件中。

和朋友一起玩请另一位房主在网页创建房间、开始题目。CLI 负责玩家操作；询问消耗 1 积分，提示消耗 1 积分及 1 次提示机会，尝试推理消耗 2 积分。

换电脑只需重新安装和登录。需要接管自己原来的座位时，用 /join CODE --takeover；旧端随后无法继续操作。

房间操作后会自动检查并提醒尚未获取的新消息，用 /messages 获取正文；终端闲置时可用 /wait 等待变化。默认 AI 操作使用座位积分；需要个人积分时显式添加 --use-personal-points。

阅读完整 Markdown 教程 → 包含全部命令、消息分页、脚本调用、更新卸载和异常恢复。