# @jischeng/pi-provider-qoder

[中文文档](./README.md)

A [Pi](https://pi.dev/) extension that connects Pi to Qoder AI (both Global and CN regions), exposing available models in Pi's model picker.

## Key Features

- **Dual-Region Support**: Full support for both Qoder Global (`qoder`) and Qoder China (`qoder-cn`).
- **Progressive Multi-Account**: Support for multiple accounts per region (`qoder`, `qoder-2`... and `qoder-cn`, `qoder-cn-2`...). Next account slot automatically becomes available after logging in.
- **Thinking & Reasoning Effort Forwarding**: Transparently forwards Pi reasoning levels (`low`/`medium`/`high`/`xhigh`/`max`/`off`) to Qoder upstream, dynamically showing supported thinking levels for each model.
- **128K Output & 1M Context**: Output token limit raised to 128K (131,072) and context window up to 1M tokens, preventing reasoning chain truncation and early compaction.
- **Dynamic Friendly Model IDs**: Uses upstream `display_name` (e.g. `Qwen3.8-Max`, `Lite`, `DeepSeek-V4-Pro`) without hardcoded stale key tables.
- **10605 Transient Queue Retry**: Automatically retries requests when Qoder servers return `10605` queue busy (up to 4 retries) with server-recommended backoff.
- **Model Price Factor Display**: Dynamically displays model price multipliers (e.g. `[0.5x]`) in model names.
- **Optimized Hot-Path Encoding & Zero-Copy Signatures**: Lookup-table Base64 body encoding and chunked MD5 hashing, eliminating memory spikes on large prompts.
- **Pi 0.84+ & OMP Compatibility**: Dynamic `qoder-api` registration and adaptive system prompt normalization.

## Installation

```bash
pi install npm:@jischeng/pi-provider-qoder
# or in OneMorePrompt:
omp install npm:@jischeng/pi-provider-qoder
```

## Login & Usage

### 1. Global (`qoder`)
- Login: `/login qoder` (Browser OAuth or PAT)
- PAT generation: https://qoder.com/account/integrations
- Environment variables: `QODER_API_KEY`, `QODER_PERSONAL_ACCESS_TOKEN`, `QODER_PAT` (use `_2`, `_3` for multiple accounts)

### 2. China (`qoder-cn`)
- Login: `/login qoder-cn` (PAT only)
- PAT generation: https://qoder.com.cn/account/integrations
- Environment variables: `QODERCN_API_KEY`, `QODERCN_PERSONAL_ACCESS_TOKEN`, `QODERCN_PAT` (use `_2`, `_3` for multiple accounts)

PAT tokens (`pt-...`) are automatically exchanged for short-lived job tokens at startup or login.

### CLI Launch

```bash
pi --provider qoder --model Lite
pi --provider qoder-cn --model Qwen3.7-Plus
```

In Pi session:

```text
/model Qwen3.8-Max
/model Lite
```

### Multiple Accounts

After authenticating account 1, the next slot appears automatically:

```text
/login qoder-2
/login qoder-cn-2
```

## Endpoints

| Endpoint | Global (`qoder`) | China (`qoder-cn`) |
| --- | --- | --- |
| PAT Exchange | `https://openapi.qoder.sh/api/v1/jobToken/exchange` | `https://openapi.qoder.com.cn/api/v1/jobToken/exchange` |
| User Info | `https://openapi.qoder.sh/api/v1/userinfo` | `https://openapi.qoder.com.cn/api/v1/userinfo` |
| Usage Quota | `https://openapi.qoder.sh/api/v2/quota/usage` | `https://openapi.qoder.com.cn/api/v2/quota/usage` |
| Chat Gateway | `https://api3.qoder.sh/` | `https://gateway.qoder.com.cn/` |

## License

MIT