@xixka/dsh-hub 0.2.3 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/lib/account-pool.d.ts +54 -1
- package/lib/account-pool.d.ts.map +1 -1
- package/lib/account-pool.js +173 -5
- package/lib/account-pool.js.map +1 -1
- package/lib/account-probe.d.ts +15 -1
- package/lib/account-probe.d.ts.map +1 -1
- package/lib/account-probe.js +27 -3
- package/lib/account-probe.js.map +1 -1
- package/lib/aggregate-adapter.d.ts +7 -0
- package/lib/aggregate-adapter.d.ts.map +1 -1
- package/lib/aggregate-adapter.js +70 -1
- package/lib/aggregate-adapter.js.map +1 -1
- package/lib/aggregate-expiry.d.ts +66 -0
- package/lib/aggregate-expiry.d.ts.map +1 -1
- package/lib/aggregate-expiry.js +142 -3
- package/lib/aggregate-expiry.js.map +1 -1
- package/lib/auto-checkin.d.ts +285 -26
- package/lib/auto-checkin.d.ts.map +1 -1
- package/lib/auto-checkin.js +701 -40
- package/lib/auto-checkin.js.map +1 -1
- package/lib/autoclaw-auth.d.ts +29 -6
- package/lib/autoclaw-auth.d.ts.map +1 -1
- package/lib/autoclaw-auth.js +32 -8
- package/lib/autoclaw-auth.js.map +1 -1
- package/lib/autoclaw-credits.d.ts +1 -1
- package/lib/autoclaw-credits.js +1 -1
- package/lib/autoclaw-oauth.d.ts +108 -9
- package/lib/autoclaw-oauth.d.ts.map +1 -1
- package/lib/autoclaw-oauth.js +393 -25
- package/lib/autoclaw-oauth.js.map +1 -1
- package/lib/autoclaw-product.d.ts +9 -4
- package/lib/autoclaw-product.d.ts.map +1 -1
- package/lib/autoclaw-product.js +9 -4
- package/lib/autoclaw-product.js.map +1 -1
- package/lib/baizhi-adapter.d.ts +182 -0
- package/lib/baizhi-adapter.d.ts.map +1 -0
- package/lib/baizhi-adapter.js +457 -0
- package/lib/baizhi-adapter.js.map +1 -0
- package/lib/baizhi-auth.d.ts +205 -0
- package/lib/baizhi-auth.d.ts.map +1 -0
- package/lib/baizhi-auth.js +387 -0
- package/lib/baizhi-auth.js.map +1 -0
- package/lib/baizhi-browser-login.d.ts +141 -0
- package/lib/baizhi-browser-login.d.ts.map +1 -0
- package/lib/baizhi-browser-login.js +216 -0
- package/lib/baizhi-browser-login.js.map +1 -0
- package/lib/baizhi-credits.d.ts +220 -0
- package/lib/baizhi-credits.d.ts.map +1 -0
- package/lib/baizhi-credits.js +507 -0
- package/lib/baizhi-credits.js.map +1 -0
- package/lib/baizhi-messages.d.ts +98 -0
- package/lib/baizhi-messages.d.ts.map +1 -0
- package/lib/baizhi-messages.js +154 -0
- package/lib/baizhi-messages.js.map +1 -0
- package/lib/baizhi-product.d.ts +126 -0
- package/lib/baizhi-product.d.ts.map +1 -0
- package/lib/baizhi-product.js +135 -0
- package/lib/baizhi-product.js.map +1 -0
- package/lib/baizhi-rpc.d.ts +103 -0
- package/lib/baizhi-rpc.d.ts.map +1 -0
- package/lib/baizhi-rpc.js +272 -0
- package/lib/baizhi-rpc.js.map +1 -0
- package/lib/baizhi.d.ts +191 -0
- package/lib/baizhi.d.ts.map +1 -0
- package/lib/baizhi.js +298 -0
- package/lib/baizhi.js.map +1 -0
- package/lib/balance-cache.d.ts +36 -0
- package/lib/balance-cache.d.ts.map +1 -1
- package/lib/balance-cache.js +23 -0
- package/lib/balance-cache.js.map +1 -1
- package/lib/buddy-adapter.d.ts +57 -0
- package/lib/buddy-adapter.d.ts.map +1 -1
- package/lib/buddy-adapter.js +70 -7
- package/lib/buddy-adapter.js.map +1 -1
- package/lib/buddy-balance-rank.d.ts +40 -3
- package/lib/buddy-balance-rank.d.ts.map +1 -1
- package/lib/buddy-balance-rank.js +24 -1
- package/lib/buddy-balance-rank.js.map +1 -1
- package/lib/buddy-growth.d.ts +135 -10
- package/lib/buddy-growth.d.ts.map +1 -1
- package/lib/buddy-growth.js +1430 -234
- package/lib/buddy-growth.js.map +1 -1
- package/lib/canonical-models.d.ts.map +1 -1
- package/lib/canonical-models.js +31 -3
- package/lib/canonical-models.js.map +1 -1
- package/lib/cap-pow.d.ts +82 -0
- package/lib/cap-pow.d.ts.map +1 -0
- package/lib/cap-pow.js +209 -0
- package/lib/cap-pow.js.map +1 -0
- package/lib/client/jet-hub.js +76 -31
- package/lib/cline-adapter.d.ts +6 -0
- package/lib/cline-adapter.d.ts.map +1 -1
- package/lib/cline-adapter.js +50 -5
- package/lib/cline-adapter.js.map +1 -1
- package/lib/cline-models-dev.d.ts +16 -0
- package/lib/cline-models-dev.d.ts.map +1 -1
- package/lib/cline-models-dev.js +49 -1
- package/lib/cline-models-dev.js.map +1 -1
- package/lib/credential-resolver.d.ts +27 -0
- package/lib/credential-resolver.d.ts.map +1 -1
- package/lib/credential-resolver.js +23 -0
- package/lib/credential-resolver.js.map +1 -1
- package/lib/credits.d.ts +18 -1
- package/lib/credits.d.ts.map +1 -1
- package/lib/credits.js.map +1 -1
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +528 -19
- package/lib/index.js.map +1 -1
- package/lib/jet-hub-rpc.d.ts +46 -0
- package/lib/jet-hub-rpc.d.ts.map +1 -1
- package/lib/jet-hub-rpc.js +1051 -37
- package/lib/jet-hub-rpc.js.map +1 -1
- package/lib/jet-hub-store.d.ts.map +1 -1
- package/lib/jet-hub-store.js +54 -1
- package/lib/jet-hub-store.js.map +1 -1
- package/lib/llm-adapter.d.ts +54 -1
- package/lib/llm-adapter.d.ts.map +1 -1
- package/lib/llm-adapter.js +72 -3
- package/lib/llm-adapter.js.map +1 -1
- package/lib/llm-register-compat.d.ts +57 -0
- package/lib/llm-register-compat.d.ts.map +1 -1
- package/lib/llm-register-compat.js +91 -7
- package/lib/llm-register-compat.js.map +1 -1
- package/lib/magicrew-auth.d.ts.map +1 -1
- package/lib/magicrew-auth.js +4 -1
- package/lib/magicrew-auth.js.map +1 -1
- package/lib/magicrew-checkin.d.ts +139 -0
- package/lib/magicrew-checkin.d.ts.map +1 -0
- package/lib/magicrew-checkin.js +536 -0
- package/lib/magicrew-checkin.js.map +1 -0
- package/lib/magicrew-credits.d.ts +24 -1
- package/lib/magicrew-credits.d.ts.map +1 -1
- package/lib/magicrew-credits.js +175 -33
- package/lib/magicrew-credits.js.map +1 -1
- package/lib/magicrew-number.d.ts +68 -0
- package/lib/magicrew-number.d.ts.map +1 -0
- package/lib/magicrew-number.js +89 -0
- package/lib/magicrew-number.js.map +1 -0
- package/lib/magicrew-product.d.ts +75 -3
- package/lib/magicrew-product.d.ts.map +1 -1
- package/lib/magicrew-product.js +100 -0
- package/lib/magicrew-product.js.map +1 -1
- package/lib/minimax-dedup.d.ts +1 -1
- package/lib/minimax-dedup.d.ts.map +1 -1
- package/lib/minimax-dedup.js +1 -1
- package/lib/minimax-dedup.js.map +1 -1
- package/lib/model-catalog.d.ts +13 -0
- package/lib/model-catalog.d.ts.map +1 -1
- package/lib/model-catalog.js +12 -1
- package/lib/model-catalog.js.map +1 -1
- package/lib/monkeycode-adapter.d.ts +164 -0
- package/lib/monkeycode-adapter.d.ts.map +1 -0
- package/lib/monkeycode-adapter.js +438 -0
- package/lib/monkeycode-adapter.js.map +1 -0
- package/lib/monkeycode-auth.d.ts +222 -0
- package/lib/monkeycode-auth.d.ts.map +1 -0
- package/lib/monkeycode-auth.js +371 -0
- package/lib/monkeycode-auth.js.map +1 -0
- package/lib/monkeycode-browser-login.d.ts +180 -0
- package/lib/monkeycode-browser-login.d.ts.map +1 -0
- package/lib/monkeycode-browser-login.js +270 -0
- package/lib/monkeycode-browser-login.js.map +1 -0
- package/lib/monkeycode-credits.d.ts +277 -0
- package/lib/monkeycode-credits.d.ts.map +1 -0
- package/lib/monkeycode-credits.js +673 -0
- package/lib/monkeycode-credits.js.map +1 -0
- package/lib/monkeycode-messages.d.ts +137 -0
- package/lib/monkeycode-messages.d.ts.map +1 -0
- package/lib/monkeycode-messages.js +207 -0
- package/lib/monkeycode-messages.js.map +1 -0
- package/lib/monkeycode-product.d.ts +178 -0
- package/lib/monkeycode-product.d.ts.map +1 -0
- package/lib/monkeycode-product.js +156 -0
- package/lib/monkeycode-product.js.map +1 -0
- package/lib/monkeycode-rpc.d.ts +61 -0
- package/lib/monkeycode-rpc.d.ts.map +1 -0
- package/lib/monkeycode-rpc.js +342 -0
- package/lib/monkeycode-rpc.js.map +1 -0
- package/lib/monkeycode.d.ts +189 -0
- package/lib/monkeycode.d.ts.map +1 -0
- package/lib/monkeycode.js +296 -0
- package/lib/monkeycode.js.map +1 -0
- package/lib/oauth.d.ts +23 -0
- package/lib/oauth.d.ts.map +1 -1
- package/lib/oauth.js +98 -13
- package/lib/oauth.js.map +1 -1
- package/lib/openai-gateway/models.d.ts +23 -0
- package/lib/openai-gateway/models.d.ts.map +1 -1
- package/lib/openai-gateway/models.js +48 -19
- package/lib/openai-gateway/models.js.map +1 -1
- package/lib/openai-gateway/server.d.ts.map +1 -1
- package/lib/openai-gateway/server.js +6 -3
- package/lib/openai-gateway/server.js.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.js +11 -0
- package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
- package/lib/opencode-proxy.d.ts +63 -0
- package/lib/opencode-proxy.d.ts.map +1 -1
- package/lib/opencode-proxy.js +80 -36
- package/lib/opencode-proxy.js.map +1 -1
- package/lib/permanent-lock-store.d.ts +7 -0
- package/lib/permanent-lock-store.d.ts.map +1 -1
- package/lib/permanent-lock-store.js +85 -10
- package/lib/permanent-lock-store.js.map +1 -1
- package/lib/provider-credits.d.ts.map +1 -1
- package/lib/provider-credits.js +167 -2
- package/lib/provider-credits.js.map +1 -1
- package/lib/provider-expiry.d.ts.map +1 -1
- package/lib/provider-expiry.js +67 -1
- package/lib/provider-expiry.js.map +1 -1
- package/lib/provider-onboarding.d.ts +10 -0
- package/lib/provider-onboarding.d.ts.map +1 -1
- package/lib/provider-onboarding.js +70 -0
- package/lib/provider-onboarding.js.map +1 -1
- package/lib/provider-registry.d.ts.map +1 -1
- package/lib/provider-registry.js +257 -16
- package/lib/provider-registry.js.map +1 -1
- package/lib/proxy-mask.d.ts.map +1 -1
- package/lib/proxy-mask.js +14 -1
- package/lib/proxy-mask.js.map +1 -1
- package/lib/qoder-adapter.d.ts +60 -2
- package/lib/qoder-adapter.d.ts.map +1 -1
- package/lib/qoder-adapter.js +215 -3
- package/lib/qoder-adapter.js.map +1 -1
- package/lib/qoder-credits.d.ts.map +1 -1
- package/lib/qoder-credits.js +34 -4
- package/lib/qoder-credits.js.map +1 -1
- package/lib/raccoon-adapter.d.ts +27 -0
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +38 -2
- package/lib/raccoon-adapter.js.map +1 -1
- package/lib/raccoon-product.d.ts.map +1 -1
- package/lib/raccoon-product.js +10 -4
- package/lib/raccoon-product.js.map +1 -1
- package/lib/refresh-scheduler.d.ts +14 -0
- package/lib/refresh-scheduler.d.ts.map +1 -1
- package/lib/refresh-scheduler.js +28 -2
- package/lib/refresh-scheduler.js.map +1 -1
- package/lib/session-cookie.d.ts +39 -0
- package/lib/session-cookie.d.ts.map +1 -0
- package/lib/session-cookie.js +69 -0
- package/lib/session-cookie.js.map +1 -0
- package/lib/types.d.ts +153 -5
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js.map +1 -1
- package/lib/usage-badge.d.ts +16 -1
- package/lib/usage-badge.d.ts.map +1 -1
- package/lib/usage-badge.js +47 -5
- package/lib/usage-badge.js.map +1 -1
- package/lib/zcode-upstream.d.ts +23 -5
- package/lib/zcode-upstream.d.ts.map +1 -1
- package/lib/zcode-upstream.js +27 -9
- package/lib/zcode-upstream.js.map +1 -1
- package/package.json +3 -1
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MonkeyCode 的**平台侧读数**:积分余额 / 每日额度 / 订阅档位 / 每日签到。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么这些读数走「平台 API + 网页会话」,而不是走推理用的 API Key
|
|
5
|
+
*
|
|
6
|
+
* MonkeyCode 有**两套完全不同的凭据**:
|
|
7
|
+
*
|
|
8
|
+
* | 用途 | 凭据 | 认证方式 |
|
|
9
|
+
* |---|---|---|
|
|
10
|
+
* | 推理(Anthropic Messages) | 白泽 `sk-…` / 网关 `oma_…` + `signing_secret` | `x-api-key` / HMAC 签名头 |
|
|
11
|
+
* | 余额 / 额度 / 签到 | 网页登录态 `monkeycode_ai_session==…` | **Cookie** |
|
|
12
|
+
*
|
|
13
|
+
* 平台的 `/api/v1/users/*` 系列**不接受 API Key**(实测带 `x-api-key` / `Authorization`
|
|
14
|
+
* 一律 401),只认网页 Cookie。这与 modelscope / codely 那种「同一个 Key 既能推理
|
|
15
|
+
* 又能读余额」的形态不同,故 `MonkeycodeCredential` 里额外有 `session_cookie`。
|
|
16
|
+
*
|
|
17
|
+
* ⚠️ 因此本模块的每个入口都**必须先判 `session_cookie` 是否配置**:
|
|
18
|
+
* 「没配会话」和「会话失效」是两件事,用户动作也不同(去补会话 vs 去重新登录)。
|
|
19
|
+
* 把前者报成后者会让人以为自己的 Cookie 坏了。**绝不抛错**,一律降级成
|
|
20
|
+
* 一句能行动的说明(`fetchBalanceDetailed` 的 `error` / `ClaimOutcome` 的 `failed`)。
|
|
21
|
+
*
|
|
22
|
+
* ⚠️ 「补会话」的主路径是「浏览器登录」,不是手工粘贴:该 cookie 是 **HttpOnly**,
|
|
23
|
+
* `document.cookie` 读不到(四审自查修正了本段原写的「去粘贴」)。
|
|
24
|
+
*
|
|
25
|
+
* ## 计费口径(为什么余额要除以 1000)
|
|
26
|
+
*
|
|
27
|
+
* 平台下发的 `balance` 单位是**千分之一积分**(网页前端也是 `/1000` 显示),
|
|
28
|
+
* 直接用会显示成「12500 积分」而实际是 12.5 —— 差三个数量级。换算只在本模块
|
|
29
|
+
* 做一次,`CreditBalance.total` 一律是**积分**(`unit: 'credit'`)。
|
|
30
|
+
*
|
|
31
|
+
* `daily_token_balance` / `daily_token_limit` 是**计费 token**(`unit: 'token'`),
|
|
32
|
+
* 与积分**不可互相折算** —— 计费 token 的折算规则见 `SPEC-monkeycode-provider.md`:
|
|
33
|
+
* `(input + cache_read + 10 × output) × 1.5`,额度耗尽后按 `1 积分 = 5000 计费 token`
|
|
34
|
+
* 转扣积分。⚠️ 但那是**上游的扣费规则**,本模块**不参与换算**,只如实回传两个读数
|
|
35
|
+
* ——前端按单位分组并列显示(`credits-format.js` 的 `normalizeUnit`),
|
|
36
|
+
* 跨量纲求和会让「12.5 积分 / 800 万 token」变成一个没有意义的数字。
|
|
37
|
+
*
|
|
38
|
+
* ## 每日签到:为什么要在本地解 PoW
|
|
39
|
+
*
|
|
40
|
+
* 签到接口要先过一道**人机验证**(captcha),但它不是图形码,而是
|
|
41
|
+
* 「挑战 → 本地求解 → 兑换」的 proof-of-work:
|
|
42
|
+
*
|
|
43
|
+
* POST /api/v1/public/captcha/challenge → { token, challenge: { c, s, d } }
|
|
44
|
+
* (本地求解 c 道题,约 0.1s)
|
|
45
|
+
* POST /api/v1/public/captcha/redeem → { token: '<8hex>:<15hex>', success }
|
|
46
|
+
* POST /api/v1/users/wallet/checkin { captcha_token: <上一步的 token> }
|
|
47
|
+
*
|
|
48
|
+
* 求解算法见 {@link solveChallenge}(与平台前端逐字节同构,`fnv1a32` 派生 PRNG +
|
|
49
|
+
* SHA-256 前缀碰撞)。⚠️ 这里是**纯计算**,没有任何规避行为:题目就是让你算的,
|
|
50
|
+
* 网页版也是浏览器里算。
|
|
51
|
+
*
|
|
52
|
+
* @module src/monkeycode-credits.ts
|
|
53
|
+
*/
|
|
54
|
+
import { prng, solveChallenge, solveChallengeYielding } from './cap-pow.js';
|
|
55
|
+
import type { CheckinStatus, ClaimOutcome, CreditBalance } from './credits.js';
|
|
56
|
+
import { type MonkeycodeProduct } from './monkeycode-product.js';
|
|
57
|
+
import type { MonkeycodeCredential } from './monkeycode.js';
|
|
58
|
+
import type { RpcCreditsBalanceExtra } from './types.js';
|
|
59
|
+
export { prng, solveChallenge, solveChallengeYielding };
|
|
60
|
+
/** 订阅档位。只认这三个值,其余一律当「档位未知」(不猜)。 */
|
|
61
|
+
export type MonkeycodePlan = 'basic' | 'pro' | 'ultra';
|
|
62
|
+
/**
|
|
63
|
+
* 平台请求的可注入依赖。
|
|
64
|
+
*
|
|
65
|
+
* ⚠️ `fetchImpl` 是给单测用的:本仓的红线是「单测不许发真网络」。
|
|
66
|
+
* 生产不传 ⇒ 用全局 `fetch`(与其余 provider 的 credits 模块同形)。
|
|
67
|
+
*/
|
|
68
|
+
export interface MonkeycodeCreditsDeps {
|
|
69
|
+
readonly fetchImpl?: typeof fetch;
|
|
70
|
+
/** 非致命问题(如订阅档位读取失败)的提示出口。 */
|
|
71
|
+
readonly warn?: (message: string) => void;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* 该失败是「会话还没生效」(401/403),而不是真的出错。
|
|
75
|
+
*
|
|
76
|
+
* ⚠️⚠️ 这个区分是**必需**的(2026-11-02 真机踩到):网页登录窗口一打开,
|
|
77
|
+
* `monkeycode_ai_session` **立刻**就存在(服务端下发的匿名会话),所以
|
|
78
|
+
* 「读到了 cookie」绝不等于「用户已经登进去」。拿它去换 Key 必然 401;
|
|
79
|
+
* 此时必须**继续等**用户真正登录,而不是当场判「会话已失效」。
|
|
80
|
+
*/
|
|
81
|
+
export declare function isMonkeycodeSessionExpiredError(message: string): boolean;
|
|
82
|
+
/**
|
|
83
|
+
* 用**网页登录态**换到的一对网关凭据。
|
|
84
|
+
*
|
|
85
|
+
* ⚠️ `signingSecret` 与 `apiKey` 是**两个独立的东西**(exe 内文档原文:
|
|
86
|
+
* 「顶层 api_key 是与模型无关的共享认证凭据,signing_secret 是独立的 Prompt
|
|
87
|
+
* 签名凭据」)—— 少了后者,每个网关请求都会 403 `invalid ohmyagent request`。
|
|
88
|
+
*/
|
|
89
|
+
export interface MonkeycodeIssuedKey {
|
|
90
|
+
/** 网关 API Key(`oma_…`,36 位)。 */
|
|
91
|
+
readonly apiKey: string;
|
|
92
|
+
/** 请求签名密钥(48 位)。 */
|
|
93
|
+
readonly signingSecret: string;
|
|
94
|
+
/**
|
|
95
|
+
* **这把 Key 的记录 id**(诊断用)。
|
|
96
|
+
*
|
|
97
|
+
* ⚠️ 它**不是**平台用户 id(每次兑换都变),**不得**写入凭据的 `user_id`。
|
|
98
|
+
* 稳定身份见 {@link MonkeycodeProfile.userId}。
|
|
99
|
+
*/
|
|
100
|
+
readonly keyId?: string;
|
|
101
|
+
/** 签发时间(**秒**,上游原样返回;毫秒换算由调用方按契约做)。 */
|
|
102
|
+
readonly createdAt?: number;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* 用网页会话 cookie 换一对网关凭据(浏览器登录的**最后一跳**)。
|
|
106
|
+
*
|
|
107
|
+
* 上游是 `POST /api/v1/users/ohmyagent/api-keys`(body `{}`,Cookie 认证):
|
|
108
|
+
* 成功回 `{ id, api_key, signing_secret, created_at }`,GET 同路径是 404。
|
|
109
|
+
*
|
|
110
|
+
* ⚠️⚠️ **返回里的 `id` 是「这把 API Key 的记录 id」,不是平台用户 id**
|
|
111
|
+
* (2026-11-03 真机取证:同一账号连续兑换两次得到 `2b37a3dd-…` 与 `0848857d-…`
|
|
112
|
+
* 两个不同 id,而 `GET /api/v1/users/status` 的 `data.user.id` 恒为
|
|
113
|
+
* `01a19fa3-…`)。把它当账号身份写入 `user_id` 会让「同一账号第二次浏览器登录
|
|
114
|
+
* 必然被判成新账号」(每登一次多一张卡 + 多签发一把 Key)。
|
|
115
|
+
* ⇒ 本函数只回 `keyId`(诊断用);稳定的 `user_id` 必须走
|
|
116
|
+
* {@link fetchMonkeycodeProfile}。
|
|
117
|
+
*
|
|
118
|
+
* ⚠️ **不抛错**:这与本模块其余入口同口径 —— 兑换失败只是「这次登录没拿到
|
|
119
|
+
* 网关凭据」,调用方可以退回到「只有会话、没有 key」的状态(额度与签到照样能用),
|
|
120
|
+
* 不该让整个账号创建失败。
|
|
121
|
+
*
|
|
122
|
+
* ⚠️ 兑换**每次都签发新的一对**(上游没有幂等键),所以只在登录流程里调一次,
|
|
123
|
+
* 不要在续期/刷新里反复调 —— 那会在用户账号下堆一长串 key。
|
|
124
|
+
*/
|
|
125
|
+
export declare function exchangeMonkeycodeSessionForKey(sessionCookie: string, deps?: MonkeycodeCreditsDeps, product?: MonkeycodeProduct): Promise<{
|
|
126
|
+
readonly ok: true;
|
|
127
|
+
readonly key: MonkeycodeIssuedKey;
|
|
128
|
+
} | {
|
|
129
|
+
readonly ok: false;
|
|
130
|
+
readonly error: string;
|
|
131
|
+
}>;
|
|
132
|
+
/** 平台用户资料(稳定身份 + 昵称 + 邀请链接所需的用户 id)。 */
|
|
133
|
+
export interface MonkeycodeProfile {
|
|
134
|
+
/** 平台用户 id(`data.user.id`,同一账号恒定)。 */
|
|
135
|
+
readonly userId?: string;
|
|
136
|
+
/** 昵称(`data.user.nickname`,作展现名用)。 */
|
|
137
|
+
readonly nickname?: string;
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* 读平台用户资料:`GET /api/v1/users/status` → `data.user.{id,nickname}`。
|
|
141
|
+
*
|
|
142
|
+
* ⚠️ 这是**稳定账号身份**的唯一来源(浏览器登录判重、邀请链接都靠它):
|
|
143
|
+
* 兑换接口回的 `id` 是「每签发一把 Key 就变」的记录 id(见
|
|
144
|
+
* {@link exchangeMonkeycodeSessionForKey} 的实测)。
|
|
145
|
+
*
|
|
146
|
+
* ⚠️ 失败**不抛错**:调用方拿到 `undefined` 时按「身份未知」处理(不做判重),
|
|
147
|
+
* 不能让一次辅助读数把已经成功的登录判死。
|
|
148
|
+
*/
|
|
149
|
+
export declare function fetchMonkeycodeProfile(sessionCookie: string, product?: MonkeycodeProduct, deps?: MonkeycodeCreditsDeps): Promise<MonkeycodeProfile | undefined>;
|
|
150
|
+
/**
|
|
151
|
+
* 生成**邀请链接**(上游口径:`https://<平台主机>/?ic=<平台用户 id>`)。
|
|
152
|
+
*
|
|
153
|
+
* 2026-11-03 从官网 bundle 逐字取证:`const g = \`https://monkeycode-ai.com/?ic=${user.id}\``
|
|
154
|
+
* —— 参数名是 `ic`,值是**平台用户 id**(不是邀请码、不是 Key id),
|
|
155
|
+
* 邀请记录接口是 `GET /api/v1/users/invitations?page=1&size=20`。
|
|
156
|
+
*
|
|
157
|
+
* ⚠️ 用户 id 缺失时返回 `undefined`,**绝不**拼一个空 `?ic=` 的链接
|
|
158
|
+
* (那会让用户把无效链接发给朋友,且看起来「生成成功」)。
|
|
159
|
+
*/
|
|
160
|
+
export declare function monkeycodeInviteLink(userId: string | undefined, product?: MonkeycodeProduct): string | undefined;
|
|
161
|
+
/** 钱包读数(已换算成积分 / 计费 token)。 */
|
|
162
|
+
export interface MonkeycodeWallet {
|
|
163
|
+
/** 积分余额(已从「千分之一积分」换算)。 */
|
|
164
|
+
readonly balance: number;
|
|
165
|
+
/** 当日额度剩余(计费 token);上游没给则为 `undefined`。 */
|
|
166
|
+
readonly dailyTokenBalance?: number;
|
|
167
|
+
/** 当日额度上限(计费 token);上游没给则为 `undefined`。 */
|
|
168
|
+
readonly dailyTokenLimit?: number;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* 读钱包:`GET /api/v1/users/wallet`。
|
|
172
|
+
*
|
|
173
|
+
* ⚠️ `balance` 缺失必须判**失败**,不得回落成 0 —— 本仓红线「绝不编造数字」,
|
|
174
|
+
* 而 0 的语义是「已用光」,会让用户白白去充值。
|
|
175
|
+
*/
|
|
176
|
+
export declare function fetchMonkeycodeWallet(credential: MonkeycodeCredential, product?: MonkeycodeProduct, deps?: MonkeycodeCreditsDeps): Promise<{
|
|
177
|
+
ok: true;
|
|
178
|
+
wallet: MonkeycodeWallet;
|
|
179
|
+
} | {
|
|
180
|
+
ok: false;
|
|
181
|
+
error: string;
|
|
182
|
+
}>;
|
|
183
|
+
/**
|
|
184
|
+
* 读订阅档位:`GET /api/v1/users/subscription`。
|
|
185
|
+
*
|
|
186
|
+
* ⚠️ 这是**辅助**读数:读不到只影响档位标签(`Basic` / `Pro` / `Ultra`),
|
|
187
|
+
* 不影响余额展示 ⇒ 失败一律 `undefined` + 一条 `warn`,绝不把整行变成错误。
|
|
188
|
+
*/
|
|
189
|
+
export declare function fetchMonkeycodePlan(credential: MonkeycodeCredential, product?: MonkeycodeProduct, deps?: MonkeycodeCreditsDeps): Promise<MonkeycodePlan | undefined>;
|
|
190
|
+
/**
|
|
191
|
+
* 把两个读数拼成 `CreditBalance`。
|
|
192
|
+
*
|
|
193
|
+
* ## 为什么分两个包(而不是加成一个 total)
|
|
194
|
+
*
|
|
195
|
+
* 积分(`credit`)与每日额度(`token`)**不可互相折算**,加起来的数字没有语义。
|
|
196
|
+
* 前端的 `normalizeUnit` 会按单位**分组并列**显示(与 ZCode 的 token 同型),
|
|
197
|
+
* 故这里如实给两个包;`total` 只汇总**积分**口径 —— 主行显示的就是用户真正
|
|
198
|
+
* 关心的「我还有多少积分」。
|
|
199
|
+
*
|
|
200
|
+
* ⚠️ 两个包的 `expiredTime` / `cycleEndTime` 必须写**空串**:
|
|
201
|
+
* 平台 wallet 报文只有标量余额,**没有任何到期时间或重置时刻字段**
|
|
202
|
+
*(每日额度是隐式的「次日 0 点重置」,但上游不下发时刻,编一个就是编造)。
|
|
203
|
+
*
|
|
204
|
+
* ⚠️ 2026-11-03 合并审计更正:这里原写「这也是 monkeycode **不进**
|
|
205
|
+
* `WIRED_EXPIRY_PROVIDERS` 的唯一理由」——**事实错误**。三家实际都**已接进**
|
|
206
|
+
* 聚合折算(`aggregate-expiry.ts` 的 `WIRED_EXPIRY_PROVIDERS` 含 `monkeycode`
|
|
207
|
+
* / `monkeycodeintl` / `baizhi`,折算原语是 `monkeycodeExpiry` / `baizhiExpiry`)。
|
|
208
|
+
* 空的到期字段只影响**面板展示**;折算层用的是「有 `active && remaining > 0`
|
|
209
|
+
* 的包 ⇒ `NEVER`,全空才 `UNUSABLE`」(`sharedPackageExpiry`),两者并不冲突。
|
|
210
|
+
*/
|
|
211
|
+
export declare function buildMonkeycodeBalance(wallet: MonkeycodeWallet, plan: MonkeycodePlan | undefined): CreditBalance;
|
|
212
|
+
/**
|
|
213
|
+
* `ProviderCredits.fetchBalanceDetailed` 的实现。
|
|
214
|
+
*
|
|
215
|
+
* ⚠️ **必须走 Detailed 而不是 `fetchBalance`**:`fetchBalance` 的 `null` 会被共享
|
|
216
|
+
* 骨架统一补一句写死的「余额查询失败」,于是「未配置会话」与「会话过期」这两种
|
|
217
|
+
* **用户动作完全不同**的原因都到不了 UI —— 用户只会看到一句没用的话。
|
|
218
|
+
*/
|
|
219
|
+
export declare function fetchMonkeycodeBalanceDetailed(credential: MonkeycodeCredential, product?: MonkeycodeProduct, deps?: MonkeycodeCreditsDeps): Promise<{
|
|
220
|
+
balance: CreditBalance | null;
|
|
221
|
+
error?: string;
|
|
222
|
+
extra?: RpcCreditsBalanceExtra;
|
|
223
|
+
}>;
|
|
224
|
+
/** PoW 挑战(平台下发的题面)。 */
|
|
225
|
+
export interface MonkeycodeChallenge {
|
|
226
|
+
/** 题目数(实测 50)。 */
|
|
227
|
+
readonly count: number;
|
|
228
|
+
/** 每题 salt 的十六进制长度(实测 32)。 */
|
|
229
|
+
readonly saltLength: number;
|
|
230
|
+
/** 每题 target 的十六进制长度(实测 3 ⇒ 期望 4096 次尝试/题)。 */
|
|
231
|
+
readonly targetLength: number;
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* 读签到状态:`GET /api/v1/users/wallet/checkin` → `{ checked_in: boolean }`。
|
|
235
|
+
*
|
|
236
|
+
* ⚠️ 上游只给**一个布尔**,没有连续天数、没有奖励金额、没有活动期。
|
|
237
|
+
* 契约要求那些字段存在,故一律如实填 0 / 空串并**在注释里说明**,
|
|
238
|
+
* 绝不为了「看起来完整」编造数值。`active` 恒 `true`:拿到响应就意味着签到可用。
|
|
239
|
+
*/
|
|
240
|
+
export declare function fetchMonkeycodeCheckinStatus(credential: MonkeycodeCredential, product?: MonkeycodeProduct, deps?: MonkeycodeCreditsDeps): Promise<CheckinStatus | null>;
|
|
241
|
+
/**
|
|
242
|
+
* 一键签到:`challenge → 本地求解 → redeem → checkin`。
|
|
243
|
+
*
|
|
244
|
+
* ## 幂等与预检
|
|
245
|
+
*
|
|
246
|
+
* 先 `GET /wallet/checkin` 判 `checked_in`:已签则直接回 `already-claimed`
|
|
247
|
+
* **不发任何写请求**。这一步既是幂等判据,也省掉一次 PoW 计算
|
|
248
|
+
*(50 道题约 0.2s,纯 CPU,但没必要白发)。
|
|
249
|
+
* ⇒ `provider-credits.ts` 里因此可以声明 `precheckStatus: false`:
|
|
250
|
+
* 预检已在本函数内部完成,外部再查一次就是**同一端点打两遍**。
|
|
251
|
+
*
|
|
252
|
+
* ## 奖励金额:优先读响应,其次用「签到前后余额差」
|
|
253
|
+
*
|
|
254
|
+
* ⚠️⚠️ 2026-11-03 真机实测(账号 `01a19fa3…`,国内站):上游签到接口只回
|
|
255
|
+
* `{ code: 0, data: { checked_in: true } }`,**不含奖励金额**;而网页文案写死
|
|
256
|
+
* 「已领取 100 积分」——那 100 是前端常量,不是接口字段。
|
|
257
|
+
*
|
|
258
|
+
* 原实现写死 `credit: 0` + `delayedMessage`,后果是签到成功的那次批量领取在
|
|
259
|
+
* 汇总行里显示成「MonkeyCode 无账号」(`formatClaimGains` 全零返回 null),
|
|
260
|
+
* 用户会以为**根本没签到**。现改为:
|
|
261
|
+
* 1. 响应里真有 `credit/reward/amount` ⇒ 直接用;
|
|
262
|
+
* 2. 否则读一次签到后钱包,与签到前余额求差 ⇒ 用**实测增量**(真机为 +100);
|
|
263
|
+
* 3. 两次读余额有一次失败 ⇒ 才回落 `0 + delayedMessage`(并已修客户端
|
|
264
|
+
* 不再把 0 渲染成「+0积分」/「无账号」)。
|
|
265
|
+
*
|
|
266
|
+
* ⚠️ 差值口径的边界:签到与读余额之间若有**并发的模型调用**,差值会被扣费
|
|
267
|
+
* 抵消。这只影响展示数字、不影响签到本身;拿不到正数时按第 3 条降级,绝不
|
|
268
|
+
* 编造一个「100」。
|
|
269
|
+
*
|
|
270
|
+
* ## 为什么每一步失败都单独给文案
|
|
271
|
+
*
|
|
272
|
+
* 用户点「一键签到」时最需要知道的是「卡在哪一步、要不要自己动手」:
|
|
273
|
+
* 题解不出来 ⇒ 上游改版(等修复);redeem 失败 ⇒ 验证过期(重试);
|
|
274
|
+
* checkin 失败 ⇒ 上游拒绝(看原文)。全部笼统成「签到失败」等于零线索。
|
|
275
|
+
*/
|
|
276
|
+
export declare function claimMonkeycodeDailyCheckin(credential: MonkeycodeCredential, product?: MonkeycodeProduct, deps?: MonkeycodeCreditsDeps): Promise<ClaimOutcome>;
|
|
277
|
+
//# sourceMappingURL=monkeycode-credits.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"monkeycode-credits.d.ts","sourceRoot":"","sources":["../src/monkeycode-credits.ts"],"names":[],"mappings":"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"}
|