Loongphy b462207447 feat(cn): expose upstream display_name as model id, drop key mapping tables
The CN model picker used to translate Qoder's internal keys (qfmodel,
qmodel_latest, ...) into hardcoded "friendly" ids (qwen3.6-flash, ...) via a
manual mapping table, with the display label hardcoded alongside. Both
sides rotted independently of upstream: when Qoder upgraded qfmodel to
Qwen3.8-Flash the label stayed "Qwen 3.6 Flash", and new keys (qmodel_38max,
q37fmodel) had no entry so their raw key leaked into the picker as the id.

The catalog API already returns every key with its display_name, so the
mapping table duplicates data the server provides and can only ever be stale.

Rework: use the upstream display_name (whitespace-stripped) directly as the
pi-visible Model.id, and read the request-time upstream key back from the
cached model config at send time. No key<->friendlyId table is needed.

- cosy.ts: remove qoderCNFriendlyModels, getQoderCNDirectModel,
  getQoderCNFriendlyModelInfo, toQoderCNFriendlyModel, prettifyQoderCNModelName.
  Add toQoderCNModelId(display) = display with whitespace stripped.
- models.ts: updateQoderModelsCache now sets CN model id =
  toQoderCNModelId(display_name); the original key is still stored in configs
  (keyed by both key and id) and read back via getCachedModelConfig. Simplify
  the CN fallback in getCachedModelConfig (drop the stale reasoning set).
  staticCnModels ids/names rewritten to the display_name form.
- stream.ts: the upstream key comes from modelConfig.key (the cached entry)
  instead of a reverse-lookup table; falls back to model.id for the
  international site, which already uses the key as id.
- index.ts: modelsForProvider no longer re-maps CN models through a friendly
  transform — the cached/static ids are already the display name.

Trade-off: a renamed/upgraded model changes its id, so a previously saved
default model may no longer resolve after an upstream rename and the user
reselects. This is expected: users should learn about new models. This is
accepted.

Tests updated for the new contract; e2e against the live CN catalog confirms
id=Qwen3.8-Flash resolves to send key=qfmodel with no mapping table.
2026-08-28 08:16:36 +08:00

pi-provider-qoder

A pi provider extension that connects pi to the Qoder API, exposing Qoder Global and Qoder China models through provider surfaces.

Features

  • Two provider entries:
    • qoder — Global / international Qoder.
    • qoder-cn — Qoder China, forced to CN endpoints and independent of QODER_REGION.
  • Interactive Login: Global Qoder supports browser device-code flow or Personal Access Token (PAT) login.
  • Qoder CN PAT Login: China edition uses a separate PAT login entry (/login qoder-cn) and CN token exchange endpoints.
  • WAF Bypass: Built-in WAF obfuscation and body encoding (Encode=1).
  • COSY Signing: Full COSY signature header generation (RSA/AES-CBC/MD5).
  • Dynamic Model Catalog: Dynamically fetches model limits, effort configurations, and options from the /algo/api/v2/model/list endpoint.
  • Reasoning/Thinking Support: Real-time extraction of thinking process from API reasoning or HTML-like <think> tags.

Quick start

Install the provider:

pi install npm:pi-provider-qoder

Or install it globally with npm:

npm install -g pi-provider-qoder

Then log in from pi.

Global / international edition:

/login qoder

China edition:

/login qoder-cn

Personal Access Token (PAT)

A Qoder PAT (pt-...) cannot authenticate API calls directly — the provider exchanges it for a short-lived job token (mirroring the official qodercli / qoderclicn flow) and resolves your account identity automatically.

Global Qoder:

  • Run /login qoder and choose Use API Key (PAT), then paste the token.
  • Or set QODER_PERSONAL_ACCESS_TOKEN (or QODER_PAT) before starting pi.
  • QODER_API_KEY is also accepted; when set, pi automatically exchanges it and logs the provider in during startup.

Qoder China:

  • Run /login qoder-cn, then paste the CN PAT.
  • Or set QODERCN_PERSONAL_ACCESS_TOKEN (or QODERCN_PAT) before starting pi.
  • QODERCN_API_KEY is also accepted and triggers the same automatic startup login.

The exchanged job token is short-lived; the provider transparently re-exchanges the stored PAT when it expires.

Region environment variables

The provider also understands these optional variables:

export QODER_REGION=cn       # or QODER_BACKEND=cn / QODER_MODE=cn

Setting a CN PAT without a global PAT also auto-selects CN mode for the qoder entry, but the recommended explicit China entry is still /login qoder-cn and --provider qoder-cn.

Endpoints

Global:

  • PAT exchange: https://openapi.qoder.sh/api/v1/jobToken/exchange
  • User info: https://openapi.qoder.sh/api/v1/userinfo
  • Usage: https://openapi.qoder.sh/api/v2/quota/usage
  • Model / chat gateway: https://api3.qoder.sh/algo/api/v2/...

China:

  • PAT exchange: https://openapi.qoder.com.cn/api/v1/jobToken/exchange
  • User info: https://openapi.qoder.com.cn/api/v1/userinfo
  • Usage: https://openapi.qoder.com.cn/api/v2/quota/usage
  • Model / chat gateway: https://gateway.qoder.com.cn/algo/api/v2/...

Models

Global qoder

Exposes the backing model keys returned by Qoder, including:

  • Tier Models: auto, ultimate, performance, efficient, lite
  • Frontier Models:
    • qmodel (Qwen3.7 Plus)
    • cmodel (Cantus)
    • qmodel_preview (Qwen3.8 Max Preview)
    • qmodel_latest (Qwen3.7 Max)
    • dmodel (DeepSeek V4 Pro)
    • dfmodel (DeepSeek V4 Flash)
    • gm51model (GLM 5.2)
    • kmodel (Kimi K2.7 Code)
    • kmodel_latest (Kimi K3)
    • mmodel (MiniMax M3)

China qoder-cn

The China provider exposes friendly model IDs and maps them back to Qoder CN's internal keys at request time:

Friendly ID Qoder CN key Context Images Reasoning
auto auto 180K ✅ ✅
qwen3.7-max qmodel_latest 1M ✅ ✅
qwen3.7-plus qmodel 1M ❌ ✅
qwen3.6-flash q36fmodel 1M ❌ ✅
deepseek-v4-pro dmodel 1M ❌ ✅
deepseek-v4-flash dfmodel 1M ❌ ❌
glm-5.2 gm51model 200K ✅ ✅
kimi-k2.6 kmodel 256K ✅ ✅
minimax-m2.7 mmodel 200K ❌ ❌

Compatibility aliases are also accepted for request mapping, such as qwen3.6-plus → qmodel, glm-5.1 → gm51model, and minimax-m3 → mmodel.

Usage

Once logged in, select any Qoder model in pi:

/model qwen3.7-plus

Or start directly:

pi --provider qoder-cn --model qwen3.7-plus

Global example:

pi --provider qoder --model auto

Architecture

src/
├── index.ts            # Extension registration
├── cosy.ts             # COSY signature, machine ID, region/endpoints, CN model aliases
├── login.ts            # OAuth device flow + PAT login sequence
├── pat.ts              # PAT → job-token exchange + identity resolution
├── models.ts           # Model definitions and dynamic config cache
├── oauth.ts            # PAT / OAuth callback orchestrator
├── stream.ts           # Main streaming response handler
├── transform.ts        # Message conversions (OpenAI schema mapping)
├── thinking-parser.ts  # Fallback <think> tag parser
└── qoder-encoding.ts   # WAF bypass body encoder

License

MIT

S
Description
No description provided
Readme
387 KiB
Languages
TypeScript 100%