pi-provider-qoder-cn 0.2.9 → 0.2.17

package/README.md

@@ -4,8 +4,11 @@ A [pi](https://shittycodingagent.ai/) provider extension for **Qoder CN** (`qode
 with a quota command and enterprise (VPC) endpoint support.
 
 This is a focused fork of [`pi-provider-qoder`](https://github.com/simonsmh/pi-provider-qoder)
-(MIT). It registers **only** the CN provider, so it can be installed alongside the
-upstream package without a provider-id collision.
+(MIT). It registers **both** providers — `qoder-cn` (Domestic) and `qoder`
+(Global) — each with its own credentials, model catalog, quota and check-in
+commands. Because the ids overlap with the upstream package, installing both at
+once double-registers them; pi resolves that field-by-field in `settings.json`
+load order (last wins), so keep this package listed last or uninstall upstream.
 
 ```bash
 pi install npm:pi-provider-qoder-cn
@@ -16,24 +19,20 @@ pi install npm:pi-provider-qoder-cn
 | Feature | Upstream | This fork |
 |---|---|---|
 | Qoder CN provider (`qoder-cn`) | ✅ | ✅ |
-| Qoder Global provider (`qoder`) | ✅ | ➖ not registered (see below) |
-| `/qoder-cn.usage` quota command | ❌ | ✅ |
+| Qoder Global provider (`qoder`) | ✅ | ✅ (Browser OAuth + PAT with self-healing refresh) |
+| `/qoder-cn.usage` & `/qoder.usage` quota commands | ❌ | ✅ |
+| `/qoder-cn.claim` & `/qoder.claim` daily check-in (100 Credits) | ❌ | ✅ |
+| Seamless token refresh (deviceToken/refresh for drt- & PAT exchange) | ❌ (broken 403) | ✅ |
 | Enterprise (VPC) selection during `/login qoder-cn` | ❌ | ✅ |
 | Current CN model catalog (`qwen3.8-max` / `qwen3.8-flash`, …) | ❌ | ✅ |
 | Stable CN model ids for `enabledModels` | ❌ | ✅ |
 
-> **Why CN only?** Both packages would register a provider named `qoder-cn`, and
-> pi identifies providers by id. Registering only `qoder-cn` here means this
-> package and the upstream one can coexist. If both are installed, whichever is
-> listed last in `settings.json` wins for `qoder-cn` — so put this package last
-> to get the friendly ids and the quota command. Note that the upstream package
-> registers the global `qoder` provider too, but it only appears in
-> `--list-models` once global credentials exist.
->
-> If you migrated from the upstream package, also remove the old local extension
-> directory if you have one, since a directory at
-> `~/.pi/agent/extensions/pi-provider-qoder/` registers `qoder-cn` as well.
-> Check with `pi list` and inspect `~/.pi/agent/extensions/`.
+Both `qoder` (Global) and `qoder-cn` (Domestic) providers are registered.
+- To use Global: run `/login qoder` and use `/model qoder/<id>`. Commands: `/qoder.usage`, `/qoder.claim`.
+- To use CN: run `/login qoder-cn` and use `/model qoder-cn/<id>`. Commands: `/qoder-cn.usage`, `/qoder-cn.claim`.
+
+> Check with `pi list` and inspect `~/.pi/agent/extensions/`: a leftover
+> `pi-provider-qoder` extension directory registers the same provider ids.
 >
 > **Migrating from the upstream package:** model ids change from
 > `Qwen3.8-Flash` to `qwen3.8-flash`. Update `enabledModels` entries in
@@ -46,12 +45,41 @@ pi install npm:pi-provider-qoder-cn
 pi install npm:pi-provider-qoder-cn
 ```
 
-Then authenticate once:
+### Daily check-in on Global: zero desktop dependency
+
+`/qoder.claim` works out of the box on Windows: this package vendors the
+official Qoder device-attestation component (`bin/runtime-info.exe` +
+`bin/sgsdk.dll`, ~7.8 MB, sha256-pinned in `bin/manifest.json`) because the
+global gateway hides claim campaigns from requests without device attestation.
+The component is invoked offline with your account id; its output is cached in
+memory for 30 minutes.
+
+- Override the component: set `QODER_UMID_EXE` to any `runtime-info.exe`
+  (e.g. a fresher copy from a newer desktop install — the same variable works
+  for the CN provider with environment code 0).
+- Non-Windows hosts: the vendored binary is win32-x64 only; install the Qoder
+  desktop app for your platform and the resolver picks its component from the
+  standard install paths automatically.
+- The component is © Qoder and redistributed verbatim; it is not executed
+  during `npm install`, only on demand by the claim/usage commands.
+
+Then authenticate once — CN:
 
 ```text
 /login qoder-cn
 ```
 
+Global (either browser OAuth — the login dialog opens `qoder.com/device/selectAccounts`
+and the extension polls for the token — or a PAT):
+
+```text
+/login qoder
+```
+
+```bash
+export QODER_PERSONAL_ACCESS_TOKEN="<your global PAT>"   # or QODER_API_KEY / QODER_PAT
+```
+
 CN supports a Personal Access Token rather than browser OAuth. Create one at
 <https://qoder.com.cn/account/integrations> and paste it when prompted, or export
 it before starting pi:
@@ -101,12 +129,41 @@ Notes:
   not reserve space for one it does not have.
 - Colour is suppressed automatically for a `NO_COLOR` environment, a dumb
   terminal, and any non-TTY output that is not the interactive UI.
+- The gauge and the `%` column are derived from `used / total`, so they always
+  agree with the numbers on the same row. The API's own `percentage` field is a
+  0-1 fraction (94% arrives as `0.94`) and is only used — scaled by 100 — when a
+  bucket comes back without numbers.
 - `Expires never` means the API reported the year-9999 sentinel, i.e. the
   allowance has no expiry date.
 - `Note  plan quota is prorated` appears after a mid-cycle plan change.
 - The command uses the same stored token as chat requests, refreshing it first,
   so it reports the same quota the model is actually billed against.
 
+### `/qoder-cn.claim`
+
+Daily check-in command to claim the 100 free Credits reward on Qoder CN personal
+accounts without having to open the desktop GUI. The event refreshes daily at
+**10:00 UTC+8 (Beijing time)** and grants Add-on Credits valid for 30 days.
+
+```text
+/qoder-cn.claim
+```
+
+If already claimed today, it reports the status idempotently without throwing:
+
+```text
+ℹ️ 今日 100 Credits 已经领取过，无需重复操作
+- 活动名称：每天领 100 Credits
+- 额度说明：100 Credits（全模型通用资源包，30 天有效）
+- 下次刷新：明日 10:00 UTC+8（距刷新约 22小时10分钟）
+```
+
+Append `json` for the untouched API response:
+
+```text
+/qoder-cn.claim json
+```
+
 ### Enterprise (VPC) endpoint support
 
 Enterprises on a private (VPC) deployment can select their endpoint directly

package/bin/manifest.json

@@ -0,0 +1,17 @@
+{
+  "note": "Vendored verbatim from the Qoder desktop app (resources/umid) so /qoder.claim and /qoder.usage work without a desktop install. Override with QODER_UMID_EXE. Copyright © Qoder — all rights reserved by Qoder/Alibaba.",
+  "vendoredAt": "2026-10-03",
+  "target": "win32-x64",
+  "files": [
+    {
+      "name": "runtime-info.exe",
+      "size": 480752,
+      "sha256": "e670a041fd0a451c51535ff1b042996737362a30aabd91a583ed92ca4c56e40b"
+    },
+    {
+      "name": "sgsdk.dll",
+      "size": 7358960,
+      "sha256": "37edce6dbdf087abb85cff7687c371268bb13f3eb22517826d665e083e109326"
+    }
+  ]
+}