# 睿思 CLI（RiOS CLI）

连接 **睿思智能模型网关**（`https://mlm.rios.com.ai`）的终端 AI 编程助手。在本地项目中读写代码、执行命令、调用 MCP 与 Skills，模型推理经睿思云平台统一调度与计费。

> **运行时**：需要 [Bun](https://bun.sh) **≥ 1.2** 与 Node.js ≥ 18。

---

## 一行安装

```bash
npm install -g rios-cli
```

或使用睿思控制台提供的安装脚本（自动检测并安装 Bun）：

```bash
curl -fsSL https://cloud.rios.com.ai/install-rios-cli.sh | bash
```

验证：

```bash
rios --version
```

---

## 快速开始

### 1. 登录睿思云（推荐）

```bash
rios
```

在交互界面输入 `/login`，浏览器打开 [睿思控制台](https://cloud.rios.com.ai/index.html) 完成 OAuth。登录后会话与凭证保存在 `~/.rios-code`。

### 2. 或使用 API Key

在控制台 [TokenHub](https://cloud.rios.com.ai/tokenhub.html) 创建 `sk_rios_*` 密钥（需有效会员订阅），然后：

```bash
export RIOS_API_KEY=sk_rios_你的密钥
export RIOS_BASE_URL=https://mlm.rios.com.ai
rios
```

也可复制模板为本地配置：

```bash
cp .env.rios.example .env   # 仅源码开发时需要
```

### 3. 常用命令

```bash
rios                    # 交互 TUI
rios -p "解释这段代码"    # 无头单次输出（脚本 / CI）
rios --help
rios /model             # 选择网关可用模型
```

---

## 环境变量

| 变量 | 必填 | 说明 |
|------|------|------|
| `RIOS_API_KEY` | 二选一 | 睿思 API Key（`sk_rios_*`），映射为推理鉴权 |
| `RIOS_AUTH_TOKEN` | 可选 | Bearer Token |
| `RIOS_BASE_URL` | 否 | 网关地址，默认 `https://mlm.rios.com.ai` |
| `RIOS_OAUTH_API_BASE` | 否 | OAuth 后端根地址；若 `cloud` 仅为静态站，需指向 rios-api |
| `RIOS_OAUTH_USE_CLOUD_CALLBACK` | 否 | 设为 `1` 时浏览器登录后手动粘贴回调 URL |

`preload.ts` 会将 `RIOS_*` 映射到 CLI 内部推理配置。未设置 `CLAUDE_CONFIG_DIR` 时，状态目录默认为 **`~/.rios-code`**（与第三方工具配置隔离）。

---

## 功能

- Ink 终端交互界面
- `--print` 无头模式
- MCP 服务器、插件、Skills
- `/login` 睿思云 OAuth
- `/model` 拉取网关模型列表并与 Key 白名单对齐
- Recovery 降级模式：`CLAUDE_CODE_FORCE_RECOVERY_CLI=1 rios`

---

## 从源码开发

```bash
git clone https://github.com/Finwhale-LLC/RiOS2026.git
cd RiOS2026/rios-cli
bun install
cp .env.rios.example .env
./bin/rios
```

---

## 更新与卸载

```bash
npm update -g rios-cli
# 或
npm uninstall -g rios-cli
```

配置与会话数据在 `~/.rios-code`，卸载 npm 包不会自动删除。

---

## 项目结构

```
bin/rios                 # 入口
preload.ts               # 环境映射与版本信息
bunfig.toml              # Bun preload 配置
.env.rios.example        # 环境变量模板
src/
├── entrypoints/cli.tsx  # CLI 主入口
├── main.tsx             # TUI 主逻辑
├── commands/            # 斜杠命令
├── tools/               # Agent 工具
├── services/            # API、OAuth、MCP
└── components/          # UI 组件
```

---

## 相关链接

- 睿思控制台：https://cloud.rios.com.ai
- 模型网关：https://mlm.rios.com.ai
- CLI 安装页：https://cloud.rios.com.ai/cli.html

---

**© RiOS Foundation**
