// 汽水音乐扫码登录 —— 复刻官方 PC 客户端(SodaMusic)的扫码链路 // 接口: // GET https://api.qishui.com/passport/web/get_qrcode/ → token + 初始化 Cookie // GET 二维码内容不是响应里的 qrcode 图,而是用 qrcode_index_url 的 token 重建的官方扫码页: // https://bff-pc.qishui.com/light/invoke/scan_login?token=&os=Windows&computer_name=<主机名> // (官方 renderer getHandleScanCodeH5Img 即此算法;响应自带的 qrcode 图指向旧页 // ucenter_web/app/sdk-next,该页已 404,抖音扫码会提示「无法访问页面」) // POST https://api.qishui.com/passport/web/check_qrconnect/ → 轮询状态,确认后 Set-Cookie 带 sessionid // 状态映射沿用本仓库约定:800 过期/拒绝 / 801 等待扫码 / 802 已扫码待确认 / 803 登录成功(自动保存) import os from 'node:os' import QRCode from 'qrcode' import { httpFetch } from '../common/request.ts' import { getCredentials, setCredentials } from '../auth/store.ts' const PASSPORT_HOST = 'https://api.qishui.com' const SCAN_LOGIN_URL = 'https://bff-pc.qishui.com/light/invoke/scan_login' const WEB_UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120 Safari/537.36' const PASSPORT_FIXED = { aid: '386088', passport_jssdk_version: '2.4.13', passport_jssdk_type: 'normal', is_from_ttaccountsdk: '1', next: 'https://api.qishui.com', need_logo: 'false', need_short_url: 'false', is_frontier: 'true', is_new_login: '1', version_code: '30020100', } /** * PC 设备身份(同步读,首次懒生成并持久化):passport 登录与 PC 签名公共参数共用, * 持久化于 data/auth.json 的 `_qs_passport_device`,保证同一实例「同一设备」。 */ export const getDeviceIds = (): { deviceId: string; installId: string } => { const existing = getCredentials('_qs_passport_device') as { deviceId?: string; installId?: string } | null if (existing?.deviceId && existing.installId) return { deviceId: String(existing.deviceId), installId: String(existing.installId) } const now = Date.now() const ids = { deviceId: String(now), installId: String(now + 1) } setCredentials('_qs_passport_device', ids) return ids } // 各 passport 请求共用的公共参数(设备身份 + 平台/版本) const commonParams = (): Record => { const { deviceId, installId } = getDeviceIds() return { passport_jssdk_version: PASSPORT_FIXED.passport_jssdk_version, passport_jssdk_type: PASSPORT_FIXED.passport_jssdk_type, is_from_ttaccountsdk: PASSPORT_FIXED.is_from_ttaccountsdk, aid: PASSPORT_FIXED.aid, language: 'zh', is_new_login: PASSPORT_FIXED.is_new_login, device_id: deviceId, install_id: installId, did: deviceId, iid: installId, device_platform: 'PC', version_code: PASSPORT_FIXED.version_code, } } const webHeaders = (cookie = '') => ({ 'User-Agent': WEB_UA, ...(cookie ? { Cookie: cookie } : {}), }) const cookieValues = (headers: Record): string[] => { const raw = headers?.['set-cookie'] return Array.isArray(raw) ? raw : raw ? [raw] : [] } const cookiePairsFrom = (headers: Record): string[] => cookieValues(headers).map(c => String(c).split(';')[0].trim()).filter(Boolean) const cookieMapFrom = (headers: Record): Record => { const out: Record = {} for (const pair of cookiePairsFrom(headers)) { const idx = pair.indexOf('=') if (idx > 0) out[pair.slice(0, idx).trim()] = pair.slice(idx + 1).trim() } return out } const mergeCookies = (current: string, fresh: Record): string => { for (const pair of current.split(';')) { const idx = pair.indexOf('=') if (idx > 0) { const name = pair.slice(0, idx).trim() if (name) fresh[name] = fresh[name] || pair.slice(idx + 1).trim() } } return Object.entries(fresh).map(([k, v]) => `${k}=${v}`).join('; ') } // 登录态 cookie 名(passport 确认后下发;sessionid 为必需项) const SESSION_COOKIE_NAMES = ['sessionid', 'sessionid_ss', 'sid_guard', 'sid_tt'] const sessionIdOf = (cookie: string): string => cookie.match(/(?:^|;\s*)sessionid=([^;]+)/)?.[1] ?? '' // get_qrcode 的 Set-Cookie 需在轮询时原样带上(内存暂存,随二维码生命周期) const qrCookies = new Map() /** 官方扫码页地址:响应 qrcode_index_url 里的 token + PC 标识(官方 renderer 同款算法) */ export const buildScanUrl = (indexUrl: string, computerName = os.hostname() || 'Windows-PC'): string => { let token = '' try { token = new URL(String(indexUrl)).searchParams.get('token') || '' } catch { token = '' } if (!token) throw new Error(`二维码地址缺少 token: ${String(indexUrl).slice(0, 80)}`) const url = new URL(SCAN_LOGIN_URL) url.searchParams.set('token', token) url.searchParams.set('os', 'Windows') url.searchParams.set('computer_name', String(computerName).trim() || 'Windows-PC') // 抖音/客户端把 + 解析成空格,官方实现同样显式替换 return url.toString().replace(/\+/g, '%20') } /** 创建扫码登录二维码(本地渲染官方扫码页,响应自带的 qrcode 图已失效不可用) */ export const createQr = async (): Promise<{ token: string; qrimg: string; expireTime: number; scanApp: string; scanUrl: string }> => { const query = new URLSearchParams({ ...commonParams(), next: PASSPORT_FIXED.next, need_logo: PASSPORT_FIXED.need_logo, need_short_url: PASSPORT_FIXED.need_short_url, }) const request = httpFetch(`${PASSPORT_HOST}/passport/web/get_qrcode/?${query}`, { method: 'get', headers: webHeaders(), timeout: 15000, }) const { statusCode, headers, body } = await request.promise const data = (body as any)?.data ?? {} if (statusCode != 200 || !data.token) { throw new Error(`获取二维码失败: HTTP ${statusCode} ${JSON.stringify(body).slice(0, 120)}`) } const scanUrl = buildScanUrl(data.qrcode_index_url ?? '', undefined) const qrimg = await QRCode.toDataURL(scanUrl, { errorCorrectionLevel: 'M', margin: 2, width: 360 }) qrCookies.set(data.token, mergeCookies('', cookieMapFrom(headers))) return { token: String(data.token), qrimg, expireTime: Number(data.expire_time) || 0, // 官方 PC 客户端扫码文案要求「打开汽水音乐 APP → 搜索框右侧 扫一扫」(passport 的 // copywriting 写的是抖音 APP,但扫描目标是 bff-pc 的 scan_login 页,实际须汽水 App) scanApp: 'qishui', scanUrl, } } export interface QrDecision { state: 'waiting' | 'scanned' | 'confirmed' | 'expired' | 'failed' | 'mfa' message: string status: string errorCode: number rateLimited?: boolean } // 官方状态语义(SodaMusic renderer use-scan-code-login): // 1/new 等待扫码;2/scanned 已扫码待确认;3/confirmed 已确认;4/5/refused/expired 过期或被拒 export const decideQrStatus = (data: Record): QrDecision => { const status = String(data?.status ?? '').toLowerCase() const errorCode = Number(data?.error_code) || 0 const accountFlow = String(data?.account_flow ?? '').toLowerCase() const description = String(data?.description ?? '') if (errorCode === 2046 || accountFlow === 'verify') { return { state: 'mfa', message: '需要手机端二次验证(本服务无法自动完成,请在汽水 App 内完成验证后重试)', status, errorCode } } if (errorCode === 7) { return { state: 'waiting', message: '接口限流,请降低轮询频率', status, errorCode, rateLimited: true } } if (['3', 'confirmed'].includes(status)) { return { state: 'confirmed', message: '已确认,等待登录态下发', status, errorCode } } if (['2', 'scanned'].includes(status)) { return { state: 'scanned', message: '已扫码,待确认', status, errorCode } } if (['4', '5', 'refused', 'expired'].includes(status) || errorCode === 4 || /expire|过期|失效/i.test(description)) { const refused = status === 'refused' || /refus|拒绝/i.test(description) return { state: 'expired', message: refused ? '已在手机端拒绝登录' : '二维码已失效', status, errorCode } } if (['error', 'failed'].includes(status) || (errorCode !== 0 && status !== 'new' && status !== '1' && status !== '')) { return { state: 'failed', message: description || `扫码失败 (code=${errorCode})`, status, errorCode } } return { state: 'waiting', message: '等待扫码', status, errorCode } } /** * 轮询扫码状态(确认后可能还需再轮询一次才下发登录态) * @returns {{ code: 800|801|802|803, message: string, status?: string, errorCode?: number, nickname? }} */ export const checkQr = async (token: string): Promise> => { const query = new URLSearchParams(commonParams()) const form = new URLSearchParams({ need_logo: PASSPORT_FIXED.need_logo, need_short_url: PASSPORT_FIXED.need_short_url, is_frontier: PASSPORT_FIXED.is_frontier, token, is_new_login: PASSPORT_FIXED.is_new_login, next: PASSPORT_FIXED.next, }) const request = httpFetch(`${PASSPORT_HOST}/passport/web/check_qrconnect/?${query}`, { method: 'post', headers: { 'Content-Type': 'application/x-www-form-urlencoded', ...webHeaders(qrCookies.get(token) || ''), }, body: form.toString(), timeout: 15000, }) const { statusCode, headers, body } = await request.promise if (statusCode != 200) throw Object.assign(new Error(`轮询扫码状态失败: HTTP ${statusCode}`), { status: 502 }) const data = (body as any)?.data ?? {} const decision = decideQrStatus(data) // 采集本次轮询下发的 Set-Cookie(确认后登录态就在这里) let cookie = mergeCookies(qrCookies.get(token) || '', cookieMapFrom(headers)) // 确认后若响应体带 redirect_url(浏览器里跳这一跳才落 sessionid),服务端补跳一次收 cookie if (decision.state === 'confirmed' && !SESSION_COOKIE_NAMES.some(name => new RegExp(`(?:^|;\\s*)${name}=`).test(cookie))) { const redirectUrl = String(data.redirect_url || '') if (redirectUrl) { try { const hop = await httpFetch(redirectUrl, { method: 'get', headers: webHeaders(cookie), timeout: 15000 }).promise cookie = mergeCookies(cookie, cookieMapFrom(hop.headers)) } catch { // 补跳失败不致命:下一轮轮询仍可能下发登录态 } } } const sessionid = sessionIdOf(cookie) if (sessionid && SESSION_COOKIE_NAMES.some(name => new RegExp(`(?:^|;\\s*)${name}=`).test(cookie))) { setCredentials('qs', { sessionid, cookie }) qrCookies.delete(token) const profile = (body as any)?.data?.user_info ?? {} return { code: 803, message: '登录成功', nickname: profile.nickname ?? profile.name ?? undefined, status: decision.status, errorCode: decision.errorCode, } } qrCookies.set(token, cookie) if (decision.state === 'confirmed') { return { code: 802, message: decision.message, status: decision.status, errorCode: decision.errorCode } } if (decision.state === 'expired' || decision.state === 'failed') { qrCookies.delete(token) return { code: 800, message: decision.message, status: decision.status, errorCode: decision.errorCode } } if (decision.state === 'scanned' || decision.state === 'mfa') { return { code: 802, message: decision.message, status: decision.status, errorCode: decision.errorCode } } return { code: 801, message: decision.message, status: decision.status, errorCode: decision.errorCode } } /** 当前登录态 */ export const status = (): { logged: boolean; updatedAt?: string } => { const cred = getCredentials('qs') as { sessionid?: string; updatedAt?: string } | null return cred?.sessionid ? { logged: true, updatedAt: cred.updatedAt } : { logged: false } } /** 登录态 sessionid(未登录返回空串) */ export const getSessionId = (): string => (getCredentials('qs') as any)?.sessionid || '' // ---------- 手机验证码登录(接口与官方 PC 客户端 login.asar 的 WebInterfaceSdk 同款)---------- // POST /passport/web/send_code/ { mobile: "86 13800138000", type: 24 } // POST /passport/web/sms_login/ { mobile, code } → Set-Cookie sessionid /** 官方 SDK 的 mobile 参数是 "区号 号码" 空格拼接(如 "86 13800138000") */ const normalizeMobile = (mobile: string, cc = '86'): string => { const s = String(mobile || '').trim() const withCc = s.match(/^(\d{1,3})[\s-]+(\d{4,15})$/) if (withCc) return `${withCc[1]} ${withCc[2]}` return `${cc} ${s.replace(/\D/g, '')}` } const smsUpstream = async (path: string, form: Record, cookie = ''): Promise<{ data: Record; message: string; headers: Record }> => { const query = new URLSearchParams(commonParams()) const request = httpFetch(`${PASSPORT_HOST}${path}?${query}`, { method: 'post', headers: { 'Content-Type': 'application/x-www-form-urlencoded', ...webHeaders(cookie) }, body: new URLSearchParams(form).toString(), timeout: 15000, }) const { statusCode, headers, body } = await request.promise if (statusCode != 200) throw Object.assign(new Error(`汽水接口 HTTP ${statusCode}`), { status: 502 }) return { data: (body as any)?.data ?? {}, message: String((body as any)?.message ?? ''), headers } } // send_code 下发的 cookie(验证码会话),sms_login 时带上 const smsCookies = new Map() export const sendSmsCode = async (mobile: string, cc?: string): Promise<{ sent: true; mobile: string }> => { const norm = normalizeMobile(mobile, cc) const { data, message, headers } = await smsUpstream('/passport/web/send_code/', { mobile: norm, type: '24', // 官方登录页固定 24(登录注册);16 为仅注册 }) if (message !== 'success') { throw Object.assign(new Error(data.description || `验证码发送失败 (code=${data.error_code})`), { status: 400 }) } smsCookies.set(norm, mergeCookies('', cookieMapFrom(headers))) return { sent: true, mobile: norm } } // 官方登录页的失败文案映射(login-7a4b1afd.js catch 分支) const smsFailMessage = (data: Record): string => { if (data.error_code === 1075) return '账号注销中,请前往抖音放弃注销' if (data.error_code === 2046) return '需要二次验证,请在汽水 App 完成安全验证后重试' return data.description || `登录失败 (code=${data.error_code})` } export const smsLogin = async (mobile: string, code: string, cc?: string): Promise> => { const norm = normalizeMobile(mobile, cc) const { data, message, headers } = await smsUpstream('/passport/web/sms_login/', { mobile: norm, code: String(code ?? '').trim(), }, smsCookies.get(norm) || '') let cookie = mergeCookies(smsCookies.get(norm) || '', cookieMapFrom(headers)) smsCookies.delete(norm) // 成功但 sessionid 未随本响应下发时补跳 redirect_url(与扫码确认同款) if (message === 'success' && !sessionIdOf(cookie) && data.redirect_url) { try { const hop = await httpFetch(String(data.redirect_url), { method: 'get', headers: webHeaders(cookie), timeout: 15000 }).promise cookie = mergeCookies(cookie, cookieMapFrom(hop.headers)) } catch { // 补跳失败不致命:sessionid 缺失时按失败处理 } } const sessionid = sessionIdOf(cookie) if (message === 'success' && sessionid) { setCredentials('qs', { sessionid, cookie }) return { code: 803, message: '登录成功', errorCode: 0 } } throw Object.assign(new Error(message === 'success' ? '登录响应缺少 sessionid' : smsFailMessage(data)), { status: 400 }) } /** * 手动绑定 sessionid(汽水 App / 官方 PC 客户端抓包,或已登录浏览器 Cookie)。 * 接受裸 sessionid 值或完整 cookie 串(须含 sessionid= 字段);完整串优先整体保存, * sid_guard 等伴随字段有利于延长登录态寿命。passport 无可用的免签校验接口 * (/passport/web/user_info/ 对本 aid 恒报 20016 无权限),不做上游验证,失效会在取流时暴露。 */ export const loginBySessionId = async(input: string): Promise<{ logged: true; sessionid: string }> => { const raw = String(input || '').trim() const sessionid = sessionIdOf(raw) || (/^[\w-]{10,}$/.test(raw) ? raw : '') if (!sessionid) throw Object.assign(new Error('需提供 sessionid 值或含 sessionid= 字段的 cookie'), { status: 422 }) const cookie = raw.includes('=') ? raw : `sessionid=${sessionid}` setCredentials('qs', { sessionid, cookie }) return { logged: true, sessionid } } /** 登录态完整 Cookie(未登录返回空串;取流优先用它,sessionid 只是最小集) */ export const getCookie = (): string => (getCredentials('qs') as any)?.cookie || '' export default { createQr, checkQr, status, getSessionId, getCookie, buildScanUrl, decideQrStatus, sendSmsCode, smsLogin, loginBySessionId }