creditdaddy 1.8.1 → 1.8.3

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.
@@ -0,0 +1,268 @@
1
+ /**
2
+ * Croli OAuth PKCE 回环登录——协议 1:1 对齐桌面端 croli-server.exe(Rust
3
+ * desktop_auth.rs,2026-11-20 二进制考古 + authorize 端点实测):
4
+ * client_id znV4SkcUsY1AektQ(Clerk OAuth application,no secret)
5
+ * issuer https://clerk.croli.net
6
+ * authorize {issuer}/oauth/authorize(302 → /oauth/authorize/continue,参数透传;
7
+ * redirect_uri = http://127.0.0.1:<随机端口>/callback,loopback 通配放行)
8
+ * token {issuer}/oauth/token(form-urlencoded;code 换票带 code_verifier,
9
+ * 刷新 grant_type=refresh_token + client_id——均无 client secret)
10
+ * scope profile email offline_access(offline_access 才发 refresh_token)
11
+ * userinfo {issuer}/oauth/userinfo(sidecar 登录后校验用,CD 侧可选)
12
+ *
13
+ * JWT 契约:iss=clerk.croli.net,sub=user_…,24h 短命 + refresh 轮换。
14
+ * 与 meooAuth 同款骨架:回环服务器收 code → token 换票 → 读身份 → 落账号。
15
+ * token 响应契约比 meoo 宽(Clerk 字段集不同):access_token/refresh_token/
16
+ * token_type=Bearer/expires_in 四项缺一即拒。
17
+ *
18
+ * 凭据只在本机会话内流转,日志不落 token。
19
+ */
20
+
21
+ import http from 'node:http';
22
+ import crypto from 'node:crypto';
23
+ import { fetchJsonRace } from './zcodeClient.js';
24
+ import { FETCH_TIMEOUT_MS } from './constants.js';
25
+ import { fetchCroliProfile } from './croliLocal.js';
26
+
27
+ export const CROLI_CLERK_ISSUER = 'https://clerk.croli.net';
28
+ export const CROLI_CLIENT_ID = 'znV4SkcUsY1AektQ';
29
+ export const CROLI_OAUTH_AUTHORIZE_URL = `${CROLI_CLERK_ISSUER}/oauth/authorize`;
30
+ export const CROLI_OAUTH_TOKEN_URL = `${CROLI_CLERK_ISSUER}/oauth/token`;
31
+ export const CROLI_OAUTH_SCOPE = 'profile email offline_access';
32
+ const CALLBACK_PATH = '/callback';
33
+
34
+ const LOGIN_TIMEOUT_MS = 5 * 60_000;
35
+
36
+ const sessions = new Map();
37
+
38
+ function gcSessions() {
39
+ const now = Date.now();
40
+ for (const [k, s] of sessions) if (s.expiresAt < now || s.done) sessions.delete(k);
41
+ }
42
+
43
+ const securityHeaders = (type) => ({
44
+ 'Content-Type': `${type || 'text/plain'}; charset=utf-8`,
45
+ 'Cache-Control': 'no-store',
46
+ 'X-Content-Type-Options': 'nosniff',
47
+ });
48
+
49
+ // 回调页:Croli 官方成功页口径(「登录成功 / 桌面会话已就绪,现在可以回到 Croli」)
50
+ const ICON_OK = '<svg width="72" height="72" viewBox="0 0 72 72" fill="none" xmlns="http://www.w3.org/2000/svg"><circle cx="36" cy="36" r="34" fill="#22c55e"/><path d="M22 37.5 31.5 47 50 27" stroke="#fff" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/></svg>';
51
+ const ICON_WARN = '<svg width="72" height="72" viewBox="0 0 72 72" fill="none" xmlns="http://www.w3.org/2000/svg"><circle cx="36" cy="36" r="34" fill="#f59e0b"/><path d="M36 20v22" stroke="#fff" stroke-width="5" stroke-linecap="round"/><circle cx="36" cy="50" r="3.5" fill="#fff"/></svg>';
52
+ const callbackHtml = (title, body, ok) => `<!doctype html><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${title}</title>`
53
+ + '<body style="margin:0;min-height:100vh;display:grid;place-items:center;background:#fafafa;font-family:system-ui,-apple-system,\'Segoe UI\',sans-serif">'
54
+ + '<div style="text-align:center;padding:36px 44px;background:#fff;border:1px solid #e5e7eb;border-radius:16px;box-shadow:0 8px 30px rgba(0,0,0,.06)">'
55
+ + (ok ? ICON_OK : ICON_WARN)
56
+ + `<p style="margin:18px 0 6px;font-size:17px;font-weight:600;color:#111827">${title}</p>`
57
+ + `<p style="margin:0;font-size:14px;color:#6b7280">${body}</p></div></body>`;
58
+
59
+ /** 回调监听:只绑 127.0.0.1 随机端口(sidecar 同款 loopback 通配) */
60
+ function startCallbackServer(session) {
61
+ const server = http.createServer((req, res) => {
62
+ const url = new URL(req.url || '/', 'http://127.0.0.1');
63
+ if (req.method !== 'GET' || url.pathname !== CALLBACK_PATH) {
64
+ res.writeHead(404, securityHeaders('text/plain'));
65
+ res.end('Not Found');
66
+ return;
67
+ }
68
+ if (session.error || session.result) {
69
+ res.writeHead(200, securityHeaders('text/plain'));
70
+ res.end('ok');
71
+ return;
72
+ }
73
+ const callbackState = url.searchParams.get('state') || '';
74
+ if (!callbackState || callbackState !== session.state) {
75
+ res.writeHead(400, securityHeaders('text/html'));
76
+ res.end(callbackHtml('授权请求校验失败', '请回到 CreditDaddy 重新发起登录。', false));
77
+ return;
78
+ }
79
+ const oauthError = url.searchParams.get('error');
80
+ if (oauthError) {
81
+ session.error = `授权被拒绝或失败(${url.searchParams.get('error_description') || oauthError})`;
82
+ finish(session);
83
+ res.writeHead(400, securityHeaders('text/html'));
84
+ res.end(callbackHtml('未完成授权', '你可以关闭此页面。', false));
85
+ return;
86
+ }
87
+ const code = url.searchParams.get('code') || '';
88
+ if (!code) {
89
+ res.writeHead(400, securityHeaders('text/html'));
90
+ res.end(callbackHtml('授权回调无效', '未收到授权码,请回到 CreditDaddy 重试。', false));
91
+ return;
92
+ }
93
+ session.result = { code };
94
+ finish(session);
95
+ res.writeHead(200, securityHeaders('text/html'));
96
+ res.end(callbackHtml('授权成功', '桌面会话已就绪,现在可以回到 CreditDaddy。', true));
97
+ });
98
+ return server;
99
+ }
100
+
101
+ function finish(session) {
102
+ session.settledAt = Date.now();
103
+ setTimeout(() => { try { session.server.close(); } catch {} }, 500).unref();
104
+ }
105
+
106
+ /** 随机回环端口(sidecar bindLoopback 同款 listen(0)) */
107
+ async function bindLoopback(server) {
108
+ await new Promise((resolve, reject) => {
109
+ const onErr = (e) => { server.off('listening', onOk); reject(e); };
110
+ const onOk = () => { server.off('error', onErr); resolve(); };
111
+ server.once('error', onErr);
112
+ server.once('listening', onOk);
113
+ server.listen(0, '127.0.0.1');
114
+ });
115
+ return server.address().port;
116
+ }
117
+
118
+ /** 发起一次 OAuth PKCE 授权登录 */
119
+ export async function startCroliLogin(_kind) {
120
+ gcSessions();
121
+ const state = crypto.randomBytes(32).toString('base64url');
122
+ const verifier = crypto.randomBytes(32).toString('base64url');
123
+ const challenge = crypto.createHash('sha256').update(verifier).digest('base64url');
124
+ const session = { verifier, state, result: null, error: null, settledAt: 0, deadline: Date.now() + LOGIN_TIMEOUT_MS };
125
+ session.server = startCallbackServer(session);
126
+ const port = await bindLoopback(session.server);
127
+ session.redirectUri = `http://127.0.0.1:${port}${CALLBACK_PATH}`;
128
+ const loginId = crypto.randomUUID();
129
+ sessions.set(loginId, session);
130
+ const url = CROLI_OAUTH_AUTHORIZE_URL + '?' + new URLSearchParams({
131
+ response_type: 'code',
132
+ client_id: CROLI_CLIENT_ID,
133
+ redirect_uri: session.redirectUri,
134
+ scope: CROLI_OAUTH_SCOPE,
135
+ state,
136
+ code_challenge: challenge,
137
+ code_challenge_method: 'S256',
138
+ }).toString();
139
+ return { url, expiresInMs: LOGIN_TIMEOUT_MS, intervalMs: 1500, data: { loginId } };
140
+ }
141
+
142
+ /** token 响应契约校验(Clerk 字段集:四项缺一即拒)。
143
+ * token_type 按 RFC 6749 大小写不敏感(实测 Clerk 返回小写 'bearer',
144
+ * 严格等 'Bearer' 会把完整成功的响应误判为格式无效——诊断片段实锤)。 */
145
+ function validateTokenResponse(result) {
146
+ const missing = [];
147
+ if (typeof result?.access_token !== 'string' || !result.access_token) missing.push('access_token');
148
+ if (typeof result?.refresh_token !== 'string' || !result.refresh_token) missing.push('refresh_token');
149
+ if (String(result?.token_type || '').toLowerCase() !== 'bearer') missing.push(`token_type=${JSON.stringify(result?.token_type ?? null)}`);
150
+ const exp = Number(result?.expires_in);
151
+ if (!Number.isFinite(exp) || exp <= 0) missing.push(`expires_in=${JSON.stringify(result?.expires_in ?? null)}`);
152
+ if (missing.length) {
153
+ const err = new Error(`Croli OAuth Token 响应缺字段/值异常:${missing.join(', ')}`);
154
+ err.oauth = true;
155
+ throw err;
156
+ }
157
+ }
158
+
159
+ /** OAuth 换票 / 刷新(form-urlencoded,无 secret——sidecar 同款) */
160
+ export async function croliTokenRequest(parameters, { fetchImpl } = {}) {
161
+ let res;
162
+ try {
163
+ res = await (fetchImpl || fetchJsonRace)(CROLI_OAUTH_TOKEN_URL, {
164
+ method: 'POST',
165
+ headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
166
+ body: new URLSearchParams(parameters).toString(),
167
+ timeoutMs: FETCH_TIMEOUT_MS,
168
+ });
169
+ } catch (e) {
170
+ throw new Error(`Croli OAuth 请求失败:${e?.cause?.code || e.message}`);
171
+ }
172
+ const rawText = await res.text().catch(() => '');
173
+ let result = {};
174
+ try { result = JSON.parse(rawText); } catch { /* 非 JSON(Cloudflare HTML / 空体)走下方诊断 */ }
175
+ if (!res.ok) {
176
+ throw new Error(`Croli OAuth 失败:${result.error_description || result.error || `HTTP ${res.status}`}`);
177
+ }
178
+ try {
179
+ validateTokenResponse(result);
180
+ } catch (e) {
181
+ // 响应 200 但字段缺失:把实际拿到什么(字段名集合 / 非 JSON 时片段)带出来——
182
+ // 「格式无效」四个字无法定位是 Cloudflare 拦截还是 Clerk 降级响应
183
+ const keys = Object.keys(result || {}).join(',');
184
+ const snippet = keys ? `字段[${keys}]` : String(rawText).replace(/\s+/g, ' ').slice(0, 120);
185
+ const err = new Error(`Croli OAuth Token 响应格式无效(HTTP ${res.status},实际收到:${snippet})`);
186
+ err.oauth = true;
187
+ throw err;
188
+ }
189
+ return result;
190
+ }
191
+
192
+ /** 刷新令牌(凭据续期共用;Clerk refresh 是轮换制——响应里的新 rt 替换旧值) */
193
+ export async function refreshCroliToken(refreshToken, { fetchImpl } = {}) {
194
+ return croliTokenRequest({
195
+ grant_type: 'refresh_token',
196
+ client_id: CROLI_CLIENT_ID,
197
+ refresh_token: refreshToken,
198
+ }, { fetchImpl });
199
+ }
200
+
201
+ /**
202
+ * 轮询登录结果(authDevice 骨架约定):
203
+ * {status:'pending'} | {status:'ok', input};终态失败抛错。
204
+ */
205
+ export async function pollCroliLogin(data) {
206
+ const session = sessions.get(data?.loginId);
207
+ if (!session) throw new Error('Croli 登录会话不存在或已超时,请重新发起');
208
+ if (session.error) {
209
+ sessions.delete(data.loginId);
210
+ throw new Error(session.error);
211
+ }
212
+ if (!session.result) {
213
+ if (Date.now() > session.deadline) {
214
+ sessions.delete(data.loginId);
215
+ try { session.server.close(); } catch {}
216
+ throw new Error('Croli 授权超时(5 分钟未完成),请重新发起');
217
+ }
218
+ return { status: 'pending' };
219
+ }
220
+
221
+ const params = session.result;
222
+ sessions.delete(data.loginId);
223
+ const tok = await croliTokenRequest({
224
+ grant_type: 'authorization_code',
225
+ code: params.code,
226
+ client_id: CROLI_CLIENT_ID,
227
+ redirect_uri: session.redirectUri,
228
+ code_verifier: session.verifier,
229
+ });
230
+
231
+ const accessToken = tok.access_token;
232
+ const refreshToken = tok.refresh_token;
233
+ const expiresAt = new Date(Date.now() + Number(tok.expires_in) * 1000).toISOString();
234
+
235
+ // 身份读补 uid/昵称:uid = Clerk JWT sub;命名用 userinfo 的 name/email
236
+ //(「Croli (师洋 余)」可辨识多号,失败回退 null 由 addAccount 侧兜底)
237
+ let uid = null, name = null, email = null, avatarUrl = null;
238
+ try {
239
+ const profile = await fetchCroliProfile(accessToken);
240
+ if (profile) {
241
+ uid = profile.sub || null;
242
+ email = profile.email || null;
243
+ avatarUrl = profile.picture || null;
244
+ const display = (profile.name || profile.email || '').trim();
245
+ if (display) name = `Croli (${display})`;
246
+ }
247
+ } catch { /* 身份读失败不阻断入库(addAccount verify 再补) */ }
248
+
249
+ return {
250
+ status: 'ok',
251
+ input: {
252
+ provider: 'croli',
253
+ token: accessToken,
254
+ refreshToken,
255
+ expiresAt,
256
+ uid,
257
+ name,
258
+ email,
259
+ source: 'browser',
260
+ meta: {
261
+ loginVia: 'oauth-authcode-pkce',
262
+ displayName: name ? name.slice('Croli ('.length, -1) : null,
263
+ avatarUrl,
264
+ scope: tok.scope || CROLI_OAUTH_SCOPE,
265
+ },
266
+ },
267
+ };
268
+ }
@@ -0,0 +1,276 @@
1
+ /**
2
+ * Croli(croli.net,Clerk 账号体系)每日签到 + 积分余额抓取。
3
+ *
4
+ * 接口(2026-11-20 桌面客户端 app.asar bundle 与本机实测,协议沉淀见
5
+ * 记忆 croli-protocol-reverse.md):
6
+ * GET https://ds.croli.net/credits/v1/ops/home
7
+ * 任务中心全量 → { enabled, serverTime, programs: [{ id, key, name,
8
+ * status, tasks: [{ id, key, eventKey, periodUnit, periodKey, progress,
9
+ * target, status, claimMode, milestones: [{index,credits,status}],
10
+ * streak: {current,longest,nextBonusAt,nextBonusCredits} }] }] }
11
+ * POST https://ds.croli.net/credits/v1/ops/checkin { taskId }
12
+ * → { alreadyCheckedIn, creditsAwarded, streak, nextResetAt }
13
+ * GET https://ds.croli.net/credits/v1/account/balance
14
+ * → { balance, trial: { active, dailyLimitCredits, usedCredits,
15
+ * remainingCredits, remainingResets, nextResetAt, endsAt } }
16
+ * GET https://ds.croli.net/credits/v1/account/ledger?limit&before
17
+ * → 积分流水(reason: signup_bonus / daily_checkin / ops_task_reward /
18
+ * invite_reward / client_login_bonus …)
19
+ * POST https://ds.croli.net/credits/v1/invite/code { rotate:false }
20
+ * → { inviteCode, inviterRewardCredits, inviteeRewardCredits }
21
+ *
22
+ * 凭据 = Clerk access token(JWT,iss https://clerk.croli.net,24h 短命),
23
+ * 本机来源两选一:
24
+ * 1. 桌面客户端 %APPDATA%\Croli\auth.json(access_token/refresh_token/expires_at,
25
+ * sidecar croli-server.exe 用 refresh_token 自动轮换回写——token 随时新鲜,
26
+ * 本机导入即拿即用,与 DuMate 本地导入同思路)
27
+ * 2. CD 自造 OAuth PKCE 登录(croliAuth.js,协议同桌面端:
28
+ * clerk.croli.net/oauth/authorize + /oauth/token,loopback 回调)
29
+ *
30
+ * 会话失效统一 HTTP 401 {"code":"unauthenticated"};token 过期且无 refresh
31
+ * 凭据时按「凭据已失效,请重新登录/重新本机导入」处理,不重试、不猜。
32
+ *
33
+ * 首版边界:每日签到(ops/checkin,streak 信息带回)+ 余额展示(balance +
34
+ * trial 剩余);不推 10Router 外部配额卡(10R 无 croli 渠道口径)。
35
+ */
36
+
37
+ import { fetchJsonRace } from './zcodeClient.js';
38
+ import { FETCH_TIMEOUT_MS } from './constants.js';
39
+ import { t } from './i18n.js';
40
+
41
+ export const CROLI_CREDITS_BASE = 'https://ds.croli.net/credits';
42
+ export const CROLI_OPS_HOME_URL = `${CROLI_CREDITS_BASE}/v1/ops/home`;
43
+ export const CROLI_CHECKIN_URL = `${CROLI_CREDITS_BASE}/v1/ops/checkin`;
44
+ export const CROLI_BALANCE_URL = `${CROLI_CREDITS_BASE}/v1/account/balance`;
45
+ export const CROLI_INVITE_CODE_URL = `${CROLI_CREDITS_BASE}/v1/invite/code`;
46
+ export const CROLI_INVITE_REDEEM_URL = `${CROLI_CREDITS_BASE}/v1/invite/redeem`;
47
+
48
+ /** daily-checkin 任务的 key(taskId 服务端编号可能调整,按 key 找行再取 id) */
49
+ export const CROLI_CHECKIN_TASK_KEY = 'daily-checkin';
50
+
51
+ function croliHeaders(token, { json = false } = {}) {
52
+ const h = {
53
+ Authorization: `Bearer ${String(token || '').trim()}`,
54
+ Accept: 'application/json',
55
+ };
56
+ if (json) h['Content-Type'] = 'application/json';
57
+ return h;
58
+ }
59
+
60
+ function isAuthExpired(status, payload) {
61
+ if (status === 401 || status === 403) return true;
62
+ return payload?.code === 'unauthenticated';
63
+ }
64
+
65
+ /**
66
+ * 统一 GET/JSON。返回 { auth, ok, status, data, code }:
67
+ * auth=false = 凭据失效(401/403/unauthenticated),ok=false 其余失败。
68
+ */
69
+ async function croliRequest(url, token, { method = 'GET', body, fetchImpl } = {}) {
70
+ const doIt = fetchImpl || ((u, init) => fetchJsonRace(u, { ...init, timeoutMs: FETCH_TIMEOUT_MS }));
71
+ let res;
72
+ try {
73
+ res = await doIt(url, {
74
+ method,
75
+ headers: croliHeaders(token, { json: body !== undefined }),
76
+ ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
77
+ });
78
+ } catch (e) {
79
+ return { auth: true, ok: false, status: 0, code: 'network', message: e?.message || String(e) };
80
+ }
81
+ const payload = await res.json().catch(() => null);
82
+ if (isAuthExpired(res.status, payload)) {
83
+ return { auth: false, ok: false, status: res.status, code: payload?.code || 'unauthenticated' };
84
+ }
85
+ if (res.status !== 200) {
86
+ return { auth: true, ok: false, status: res.status, code: payload?.code || `HTTP ${res.status}`, message: payload?.message };
87
+ }
88
+ return { auth: true, ok: true, status: 200, data: payload };
89
+ }
90
+
91
+ /** 任务中心全量(签到状态 / streak / 其它任务的 progress 都在这里) */
92
+ export async function fetchCroliOpsHome(token, { fetchImpl } = {}) {
93
+ return croliRequest(CROLI_OPS_HOME_URL, token, { fetchImpl });
94
+ }
95
+
96
+ /** 积分余额 + trial 免费额度 */
97
+ export async function fetchCroliBalance(token, { fetchImpl } = {}) {
98
+ return croliRequest(CROLI_BALANCE_URL, token, { fetchImpl });
99
+ }
100
+
101
+ /** 从 ops/home 里抽出 daily-checkin 任务行(找不到返回 null) */
102
+ export function croliCheckinTask(opsHome) {
103
+ for (const prog of opsHome?.programs || []) {
104
+ for (const task of prog.tasks || []) {
105
+ if (task.key === CROLI_CHECKIN_TASK_KEY || task.eventKey === CROLI_CHECKIN_TASK_KEY) return task;
106
+ }
107
+ }
108
+ return null;
109
+ }
110
+
111
+ /**
112
+ * 每日签到:先 ops/home 找 daily-checkin 任务(拿 taskId 与今日状态),
113
+ * 未完成才 POST ops/checkin。幂等:status=claimed 时直接 already。
114
+ */
115
+ export async function checkinCroli(account, ctx = {}) {
116
+ const token = account?.token;
117
+ if (!token) {
118
+ return { status: 'failed', authExpired: true, message: t('Croli 凭据缺失,请重新本机导入或浏览器登录') };
119
+ }
120
+ const fetchImpl = ctx?.fetchImpl;
121
+
122
+ const home = await fetchCroliOpsHome(token, { fetchImpl });
123
+ if (!home.auth) {
124
+ return { status: 'failed', authExpired: true, message: t('Croli 凭据已失效({code}),请重新本机导入或浏览器登录', { code: home.code || 'unauthenticated' }) };
125
+ }
126
+ if (!home.ok) {
127
+ return { status: 'failed', message: t('Croli 任务中心读取失败:{err}', { err: home.code || 'network' }) };
128
+ }
129
+ const task = croliCheckinTask(home.data);
130
+ if (!task) {
131
+ // 服务端没有 daily-checkin 任务(活动下线 / 结构变化)——如实报告,不猜 taskId
132
+ return { status: 'no-activity', message: t('任务中心无每日签到活动(可能已下线)') };
133
+ }
134
+
135
+ // 余额旁路(失败不影响领取结果)
136
+ let balanceAfter;
137
+ try {
138
+ const bal = await fetchCroliBalance(token, { fetchImpl });
139
+ if (bal.ok && Number.isFinite(bal.data?.balance)) balanceAfter = bal.data.balance;
140
+ } catch { /* 余额拿不到不阻断 */ }
141
+
142
+ if (task.status === 'claimed' || task.progress >= task.target) {
143
+ return { status: 'already', message: t('今日已签到'), ...(balanceAfter !== undefined ? { balanceAfter } : {}) };
144
+ }
145
+
146
+ try {
147
+ const r = await croliRequest(CROLI_CHECKIN_URL, token, { method: 'POST', body: { taskId: task.id }, fetchImpl });
148
+ if (!r.auth) {
149
+ return { status: 'failed', authExpired: true, message: t('Croli 凭据已失效({code}),请重新本机导入或浏览器登录', { code: r.code || 'unauthenticated' }) };
150
+ }
151
+ if (!r.ok) {
152
+ // 并发领取已被服务端记过 / 活动暂停:按服务端话术归类
153
+ const code = String(r.code || '');
154
+ if (/already|checked/i.test(code)) return { status: 'already', message: t('今日已签到') };
155
+ return { status: 'failed', message: t('Croli 签到失败:{err}', { err: code || 'network' }) };
156
+ }
157
+ const awarded = Number(r.data?.creditsAwarded) || 0;
158
+ const streak = r.data?.streak;
159
+ ctx?.log?.(t('Croli 签到成功'));
160
+ return {
161
+ status: 'checked-in',
162
+ message: awarded > 0 ? t('签到成功(+{n} 积分)', { n: awarded }) : t('签到成功'),
163
+ claimedAmount: awarded,
164
+ amount: awarded,
165
+ // streak.current 是**含本次**的连续天数(服务端口径,首次签到=1);CD 签到轮落库
166
+ // 时统一 +1(checkin.js 约定 productImpl 返回签到前口径)——这里回退 1 位对齐,
167
+ // 否则面板「连续 2 天」虚高(2026-11-20 用户实测首签即显示 2 天)
168
+ streakDays: Number.isFinite(Number(streak?.current)) ? Math.max(0, Number(streak.current) - 1) : undefined,
169
+ ...(balanceAfter !== undefined ? { balanceAfter } : {}),
170
+ };
171
+ } catch (e) {
172
+ return { status: 'failed', message: t('Croli 签到失败:{err}', { err: e?.message || 'network' }) };
173
+ }
174
+ }
175
+
176
+ /**
177
+ * 积分余额快照(额度卡口径):balance 为主,trial 每日免费额度并入提示行。
178
+ * parts:[积分余额] + [今日免费额度(剩余/上限)]。
179
+ */
180
+ export async function fetchCroliQuota(account, { fetchImpl } = {}) {
181
+ const token = account?.token;
182
+ if (!token) {
183
+ const err = new Error(t('Croli 凭据缺失,请重新本机导入或浏览器登录'));
184
+ err.auth = true;
185
+ throw err;
186
+ }
187
+ const bal = await fetchCroliBalance(token, { fetchImpl });
188
+ if (!bal.auth) {
189
+ const err = new Error(t('Croli 凭据已失效({code}),请重新本机导入或浏览器登录', { code: bal.code || 'unauthenticated' }));
190
+ err.auth = true;
191
+ throw err;
192
+ }
193
+ if (!bal.ok) {
194
+ throw new Error(t('Croli 余额读取失败:{err}', { err: bal.code || 'network' }));
195
+ }
196
+ const d = bal.data || {};
197
+ const balance = Number(d.balance) || 0;
198
+ const trial = d.trial || {};
199
+ const parts = [{ name: t('积分余额'), total: balance, used: 0, remaining: balance }];
200
+ if (trial.active && Number(trial.dailyLimitCredits) > 0) {
201
+ const limit = Number(trial.dailyLimitCredits);
202
+ const used = Number(trial.usedCredits) || 0;
203
+ parts.push({
204
+ name: t('今日免费额度'),
205
+ total: limit,
206
+ used,
207
+ remaining: Math.max(0, Number.isFinite(Number(trial.remainingCredits)) ? Number(trial.remainingCredits) : Math.max(0, limit - used)),
208
+ recurring: true,
209
+ expiresAt: trial.nextResetAt || undefined,
210
+ });
211
+ }
212
+ return {
213
+ unit: '积分',
214
+ total: parts.reduce((s, p) => s + p.total, 0),
215
+ used: parts.reduce((s, p) => s + p.used, 0),
216
+ remaining: parts.reduce((s, p) => s + p.remaining, 0),
217
+ parts,
218
+ exceeded: balance <= 0,
219
+ };
220
+ }
221
+
222
+ /** 身份验证(addAccount verify 调用):balance 200 即凭据有效;顺带带出 ops/home 里的账号线索 */
223
+ export async function verifyCroliAccount(account, { fetchImpl } = {}) {
224
+ const token = account?.token;
225
+ if (!token) return { auth: false, ok: false, error: t('缺少 Croli 凭据') };
226
+ const bal = await fetchCroliBalance(token, { fetchImpl });
227
+ if (!bal.auth) return { auth: false, ok: false, error: t('Croli 凭据已失效,请重新本机导入或浏览器登录') };
228
+ if (!bal.ok) return { auth: true, ok: false, error: bal.code || 'network' };
229
+ // uid:Clerk JWT 的 sub(user_…),归户稳定且不需要额外请求
230
+ let uid = null;
231
+ try {
232
+ const seg = String(token).split('.');
233
+ if (seg.length === 3) uid = JSON.parse(Buffer.from(seg[1], 'base64url').toString('utf8'))?.sub || null;
234
+ } catch { /* JWT 解析失败不阻断 */ }
235
+ return { auth: true, ok: true, uid, name: null };
236
+ }
237
+
238
+ /** uid 脱敏(user_3MMY… → use****5jz) */
239
+ export function maskCroliUserId(id) {
240
+ const s = String(id ?? '');
241
+ if (s.length >= 7) return s.slice(0, 3) + '****' + s.slice(-3);
242
+ if (s.length >= 4) return s.slice(0, 1) + '****' + s.slice(-1);
243
+ return '****';
244
+ }
245
+
246
+ /**
247
+ * 我的邀请码:POST /v1/invite/code {rotate:false}(实测 2026-11-20:
248
+ * → { inviteCode, inviterRewardCredits:2500, inviteeRewardCredits:3000 };
249
+ * rotate=true 会换新码(旧码作废),CD 一律 rotate:false 只读不轮换)
250
+ */
251
+ export async function fetchCroliMyInviteCode(token, { fetchImpl } = {}) {
252
+ if (!token) return { auth: true, ok: false, error: t('缺少 Croli 凭据') };
253
+ const r = await croliRequest(CROLI_INVITE_CODE_URL, token, { method: 'POST', body: { rotate: false }, fetchImpl });
254
+ if (!r.auth) return { auth: false, ok: false, error: t('Croli 凭据已失效,请重新本机导入或浏览器登录') };
255
+ if (!r.ok) return { auth: true, ok: false, error: r.code || 'network' };
256
+ return {
257
+ auth: true,
258
+ ok: true,
259
+ code: r.data?.inviteCode || null,
260
+ inviterRewardCredits: Number(r.data?.inviterRewardCredits) || null,
261
+ inviteeRewardCredits: Number(r.data?.inviteeRewardCredits) || null,
262
+ };
263
+ }
264
+
265
+ /** 兑换邀请码:POST /v1/invite/redeem {inviteCode, source}(好友安装并完成首个任务后双方得积分) */
266
+ export async function redeemCroliInviteCode(token, code, { fetchImpl } = {}) {
267
+ const clean = String(code || '').trim();
268
+ if (!clean) return { ok: false, error: t('邀请码不能为空') };
269
+ const r = await croliRequest(CROLI_INVITE_REDEEM_URL, token, { method: 'POST', body: { inviteCode: clean, source: 'task_center' }, fetchImpl });
270
+ if (!r.auth) return { ok: false, authExpired: true, error: t('Croli 凭据已失效,请重新本机导入或浏览器登录') };
271
+ if (!r.ok) {
272
+ // 服务端错误码(bundle 口径):已兑换过 / 码不存在 / 自己的码等——code 即话术
273
+ return { ok: false, error: r.code || 'network' };
274
+ }
275
+ return { ok: true, message: r.data?.message || '', result: r.data ?? null };
276
+ }