# Turing Code 1.0.2 安装说明

当前版本：`1.0.2`

下载入口：

- 主入口：`https://turing.tap365.org/v1.0.2/`
- 腾讯镜像：`https://tap365.cn/turing/v1.0.2/`

## 支持平台

当前正式支持：

- Linux x64
- macOS x64
- Windows x64

当前未支持：

- macOS arm64 / M1

## 安装方式一：npm 全局安装

适合已经装好 Node.js 18+ 与 npm 的机器。

### 主入口

```bash
npm install -g --foreground-scripts https://turing.tap365.org/v1.0.2/turing-code-1.0.2.tgz
```

### 腾讯镜像

```bash
npm install -g --foreground-scripts https://tap365.cn/turing/v1.0.2/turing-code-1.0.2.tgz
```

安装完成后建议先跑：

```bash
turing --version
turing -p "只回复 ok"
```

## 安装方式二：bash 一键安装

适合 Linux x64 / macOS x64 用户直接下载独立二进制，不依赖 npm。

### 主入口

```bash
curl -fsSL https://turing.tap365.org/v1.0.2/install.sh | bash
```

### 腾讯镜像

```bash
curl -fsSL https://tap365.cn/turing/v1.0.2/install.sh | bash
```

脚本默认会：

1. 下载当前平台对应二进制
2. 写入 `~/.local/share/turing/current/`
3. 在 `~/.local/bin/` 创建以下命令入口：
   - `turing`
   - `turingopenai`
   - `turinggrok`
   - `turinggemini`
   - `turingclaude`
   - `turingp`
4. 保留用户自己的 Key，不会把你的私钥写死到脚本里

如果你要改安装位置，可这样执行：

```bash
curl -fsSL https://turing.tap365.org/v1.0.2/install.sh | bash -s -- --install-dir "$HOME/.local/share/turing" --bin-dir "$HOME/.local/bin"
```

安装完成后建议先跑：

```bash
turing --version
turingopenai --version
turinggrok --version
```

## 安装后会得到哪些命令

- `turing`：默认主入口
- `turingopenai`：固定 OpenAI-compatible / Responses 路线
- `turinggrok`：固定 Grok 路线
- `turinggemini`：固定 Gemini 路线
- `turingclaude`：固定 Anthropic 原生路线
- `turingp`：偏判断、取舍、文稿方向

## 如何配置 Key

### 推荐方式：环境变量

```bash
export OPENAI_API_KEY="你的 openai key"
export GROK_API_KEY="你的 grok key"
export GEMINI_API_KEY="你的 gemini key"
export ANTHROPIC_AUTH_TOKEN="你的 claude key"
```

### 也可写入 `~/.claude/settings.json`

```json
{
  "env": {
    "OPENAI_API_KEY": "你的 openai key",
    "GROK_API_KEY": "你的 grok key",
    "GEMINI_API_KEY": "你的 gemini key",
    "ANTHROPIC_AUTH_TOKEN": "你的 claude key"
  }
}
```

默认情况下不需要手工填写 Base URL。当前发布包已经内置 provider registry，命令会自动走对应上游入口。

## 常用 smoke 命令

```bash
turing --version
turing -p "只回复 ok"
turingopenai -p "只回复 ok"
turinggrok -p "只回复 ok"
turinggemini -p "只回复 ok"
turingclaude -p "只回复 ok"
turingp -p "只回复 ok"
```

## 常见问题

### 1）为什么安装后还要自己配 Key？

安装包不会内置你的真实凭证。CLI 负责统一入口，不会替你保存私有密钥。

### 2）提示 `turing: command not found` 怎么办？

- npm 安装方式：确认 npm 全局 bin 已加入 PATH
- bash 安装方式：确认 `~/.local/bin` 已加入 PATH

可加入：

```bash
export PATH="$HOME/.local/bin:$PATH"
```

### 3）为什么 M1 还不能装？

不是文案保守，而是当前正式发布矩阵里确实还没有 darwin-arm64 产物，所以不能冒充支持。

### 4）`turingopenai` 或 `turinggrok` 报鉴权错误怎么办？

先检查你是否真的设置了对应 Key：

- `turingopenai`：优先看 `OPENAI_API_KEY`
- `turinggrok`：优先看 `GROK_API_KEY`
- `turinggemini`：优先看 `GEMINI_API_KEY`
- `turingclaude`：优先看 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_API_KEY`

## 当前真实边界说明

- 主域名安装链路已真实打通：`https://turing.tap365.org/v1.0.2/`
- `turing --version` 已真实返回 `1.0.2 (Turing Code)`
- `turinggrok` 文本链路已实测通过，但前提是显式提供可用的 `GROK_API_KEY`
- `turingopenai` 是否可用，取决于你当前提供的 `OPENAI_API_KEY` 是否真实可用