@casatwy/deyo 0.2.1 → 0.2.5

package/deyo.mjs

@@ -5,7 +5,9 @@ import { createHash } from 'node:crypto'
 import { createRequire } from 'node:module'
 import { basename, dirname, extname, isAbsolute, resolve } from 'node:path'
 import { homedir } from 'node:os'
+import { spawn } from 'node:child_process'
 import process from 'node:process'
+import { createInterface } from 'node:readline/promises'
 import { handleSkillCommand } from './skill-manager.mjs'
 
 const CLI_VERSION = createRequire(import.meta.url)('./package.json').version
@@ -18,13 +20,17 @@ const PROGRESS_FORMATS = new Set(['auto', 'text', 'jsonl'])
 const RESULT_FORMATS = new Set(['text', 'srt', 'vtt', 'json', 'verbose_json'])
 const TERMINAL_STATUSES = new Set(['completed', 'failed', 'cancelled'])
 const MAX_UPLOAD_CONCURRENCY = 3
-const HASH_CHUNK_SIZE = 4 * 1024 * 1024
 const UPLOAD_REDACTED_SOURCE_LABEL = 'upload:file'
 const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504])
 const URL_SCHEME_PATTERN = /^[a-z][a-z\d+\-.]*:\/\//i
 const DOMAIN_LIKE_PATTERN = /^(?:[a-z0-9-]+\.)+[a-z]{2,}(?::\d+)?(?:[/?#].*)?$/i
-const SENSITIVE_UPLOAD_RESULT_KEY_PATTERN = /(?:^|_)(?:objectKey|object_key|audioUrl|audio_url|downloadUrl|download_url|signedUrl|signed_url|uploadUrl|upload_url|sourceUrl|source_url|url)$/i
+const SENSITIVE_UPLOAD_RESULT_KEY_PATTERN = /(?:^|_)(?:uploadId|upload_id|objectKey|object_key|ossKey|oss_key|multipartUploadId|multipart_upload_id|etag|audioUrl|audio_url|downloadUrl|download_url|signedUrl|signed_url|uploadUrl|upload_url|sourceUrl|source_url|url)$/i
 const SIGNED_URL_PARAM_PATTERN = /(?:OSSAccessKeyId|Signature|Expires|x-oss-signature|x-oss-credential|x-oss-expires|x-amz-signature)=/i
+const WECHAT_CHANNELS_SENSITIVE_RESULT_KEY_PATTERN = /(?:cookie|credential|generation|mediaUrl|media_url|audioUrl|audio_url|generalToken|general_token|hy_source|hy_user|hy_token|(?:^|_)eid(?:$|_)|(?:^|_)token(?:$|_))/i
+const WECHAT_CHANNELS_SIGNED_MEDIA_PATTERN = /(?:finder\.video\.qq\.com|encfilekey=|[?&]token=)/i
+const WECHAT_CHANNELS_CREDENTIAL_ERROR_CODE = 'WECHAT_CHANNELS_CREDENTIAL_REQUIRED'
+const MAINTENANCE_ERROR_CODES = new Set(['SERVICE_MAINTENANCE', 'MAINTENANCE_STATE_UNAVAILABLE'])
+const WECHAT_CHANNELS_AUTH_TIMEOUT_MS = 5 * 60 * 1000
 const MIME_TYPES_BY_EXTENSION = new Map([
   ['.aac', 'audio/aac'],
   ['.aif', 'audio/aiff'],
@@ -58,9 +64,12 @@ class ReportedCliError extends Error {
 }
 
 class HttpCliError extends Error {
-  constructor(message, status) {
+  constructor(message, status, details = {}) {
     super(message)
     this.status = status
+    this.errorCode = details.errorCode || null
+    this.presentationUrl = details.presentationUrl || null
+    this.retryAfterMs = details.retryAfterMs || null
   }
 }
 
@@ -82,12 +91,12 @@ function printUsage() {
   deyo [选项] <url|file>
   deyo [选项] --file <file>
   deyo auth <login|logout|status> [选项]
-  deyo skill <install|status> [选项]
+  deyo skill <install|status|update> [选项]
 
 转写选项:
   --api-key <key>       可选，Deyo API key
   -O, --output <path>   可选，输出文件路径
-  --source <name>       可选，显式指定来源：xiaoyuzhou | ximalaya | bilibili | douyin | xiaohongshu | youtube | apple-podcasts | twitter
+  --source <name>       可选，显式指定来源：xiaoyuzhou | ximalaya | bilibili | douyin | xiaohongshu | youtube | apple-podcasts | twitter | tiktok | kankanews | wechat_channels
   --file <path>         可选，显式指定本地单个音视频文件
   --mime-type <type>    可选，上传本地文件时显式指定 MIME，例如 audio/mpeg 或 video/mp4
   --language <value>    可选，显式指定转写语言；省略时自动检测
@@ -106,6 +115,8 @@ auth 子命令:
 Skill 管理:
   deyo skill install --platform codex|claude|gemini|openclaw [--scope user|workspace|global]
   deyo skill status [--platform codex|claude|gemini|openclaw] [--json]
+  deyo skill update --platform openclaw [--scope workspace|global]
+                    --confirm-latest 'update @casatwy/deyo to latest now'
 
 API key 读取优先级:
   1. --api-key
@@ -115,6 +126,10 @@ API key 读取优先级:
 本地文件说明:
   v1 只支持单文件上传；不支持目录、glob、stdin、批量和断点续传。
   可以用 deyo -- ./audio.mp3 明确把 -- 后的单个参数当作路径或链接。
+
+B站试看说明:
+  B站专属视频会先显示完整时长、可转写时长和预计扣除分钟。
+  只有交互式终端中明确确认后才会创建任务；拒绝或非交互环境均不会扣分钟。
 `)
 }
 
@@ -343,6 +358,9 @@ function isRetryableRequestError(error) {
   }
 
   if (error instanceof HttpCliError) {
+    if (MAINTENANCE_ERROR_CODES.has(error.errorCode)) {
+      return false
+    }
     return RETRYABLE_STATUS_CODES.has(error.status) || error.status >= 500
   }
 
@@ -469,15 +487,35 @@ function formatBytes(value) {
 }
 
 function redactUploadSourceUrl(sourceType, sourceUrl) {
-  if (sourceType === 'upload' || String(sourceUrl || '').startsWith('upload:sha256:')) {
+  if (sourceType === 'upload' || String(sourceUrl || '').startsWith('upload:')) {
     return UPLOAD_REDACTED_SOURCE_LABEL
   }
 
+  if (sourceType === 'direct_media') {
+    try {
+      const parsed = new URL(String(sourceUrl || ''))
+
+      if (
+        parsed.protocol !== 'https:'
+        || parsed.username
+        || parsed.password
+        || parsed.hash
+      ) {
+        return '音频/视频文件链接已隐藏'
+      }
+
+      return `${parsed.origin}${parsed.pathname}`
+    }
+    catch {
+      return '音频/视频文件链接已隐藏'
+    }
+  }
+
   return sourceUrl || null
 }
 
 function isSensitiveUploadResultString(key, value, sourceType = null) {
-  if (value.startsWith('upload:sha256:')) {
+  if (value.startsWith('upload:')) {
     return true
   }
 
@@ -505,6 +543,12 @@ function sanitizeResultPayload(value, inheritedSourceType = null, inheritedKey =
   }
 
   if (!value || typeof value !== 'object') {
+    if (inheritedSourceType === 'wechat_channels' && typeof value === 'string') {
+      return WECHAT_CHANNELS_SIGNED_MEDIA_PATTERN.test(value)
+        ? '[视频号受保护媒体地址已隐藏]'
+        : value
+    }
+
     if (typeof value === 'string' && isSensitiveUploadResultString(inheritedKey, value, inheritedSourceType)) {
       return UPLOAD_REDACTED_SOURCE_LABEL
     }
@@ -516,6 +560,10 @@ function sanitizeResultPayload(value, inheritedSourceType = null, inheritedKey =
   const next = {}
 
   for (const [key, item] of Object.entries(value)) {
+    if (sourceType === 'wechat_channels' && WECHAT_CHANNELS_SENSITIVE_RESULT_KEY_PATTERN.test(key)) {
+      continue
+    }
+
     if (key === 'sourceUrl') {
       next[key] = redactUploadSourceUrl(sourceType, item)
       continue
@@ -791,20 +839,59 @@ function resolveApiKey(explicitApiKey, storedConfig) {
   return null
 }
 
-async function readErrorMessage(response) {
+function normalizeWechatChannelsPresentationUrl(value) {
+  if (typeof value !== 'string' || value.length > 4096) return null
+
+  try {
+    const presentationUrl = new URL(value)
+    if (presentationUrl.protocol !== 'https:' || presentationUrl.username || presentationUrl.password || presentationUrl.hash) return null
+    if (presentationUrl.pathname !== '/parse') return null
+    if (presentationUrl.searchParams.size !== 2) return null
+    if (presentationUrl.searchParams.getAll('source').length !== 1) return null
+    if (presentationUrl.searchParams.getAll('token').length !== 1) return null
+    if ([...presentationUrl.searchParams.keys()].some(key => key !== 'source' && key !== 'token')) return null
+    if (presentationUrl.searchParams.get('source') !== 'wechat_channels') return null
+
+    const token = presentationUrl.searchParams.get('token') || ''
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(token)) return null
+
+    return presentationUrl.toString()
+  } catch {
+    return null
+  }
+}
+
+async function readErrorResponse(response) {
   const contentType = response.headers.get('content-type') || ''
 
   if (contentType.includes('application/json')) {
     const data = await response.json().catch(() => null)
     const message = data?.message || data?.statusMessage || data?.error?.message
+    const rawErrorCode = data?.data?.errorCode
+    const errorCode = typeof rawErrorCode === 'string' && /^[A-Z0-9_]{1,128}$/.test(rawErrorCode)
+      ? rawErrorCode
+      : null
+    const presentationUrl = errorCode === WECHAT_CHANNELS_CREDENTIAL_ERROR_CODE
+      ? normalizeWechatChannelsPresentationUrl(data?.data?.presentationUrl)
+      : null
+    const rawRetryAfterMs = Number(data?.data?.retryAfterMs)
 
-    if (message) {
-      return String(message)
+    return {
+      message: message ? String(message) : `${response.status} ${response.statusText}`,
+      errorCode,
+      presentationUrl,
+      retryAfterMs: Number.isSafeInteger(rawRetryAfterMs) && rawRetryAfterMs >= 1000 && rawRetryAfterMs <= 5000
+        ? rawRetryAfterMs
+        : null,
     }
   }
 
   const text = await response.text().catch(() => '')
-  return text || `${response.status} ${response.statusText}`
+  return { message: text || `${response.status} ${response.statusText}` }
+}
+
+async function readErrorMessage(response) {
+  return (await readErrorResponse(response)).message
 }
 
 async function requestJson(baseUrl, apiKey, path, options = {}) {
@@ -821,7 +908,8 @@ async function requestJson(baseUrl, apiKey, path, options = {}) {
     })
 
     if (!response.ok) {
-      throw new HttpCliError(await readErrorMessage(response), response.status)
+      const details = await readErrorResponse(response)
+      throw new HttpCliError(details.message, response.status, details)
     }
 
     return response.json()
@@ -969,6 +1057,27 @@ function buildTerminalMessage(status, errorMessage) {
   return errorMessage ? `任务结束：${errorMessage}` : `任务结束：${formatStatus(status)}`
 }
 
+const SAFE_TRANSCRIPTION_FAILURE_MESSAGES = new Map([
+  ['ASR_CAPABILITY_UNSUPPORTED', '当前转写运行环境暂不支持这项任务，请等待服务升级后再试。'],
+  ['ASR_IDENTITY_CHANGED', '转写运行环境在任务期间发生变化，为保护结果一致性，本次任务已停止。'],
+  ['ASR_TIMELINE_EVIDENCE_MISMATCH', '转写时间轴证据无法安全对齐，可以使用当前订单完整重新转写。'],
+  ['ASR_CONTINUE_EVIDENCE_MISMATCH', '现有进度缺少可安全续传的证据，可以使用当前订单完整重新转写。'],
+  ['ASR_RESPONSE_CONTRACT_MISMATCH', '转写运行环境协议不兼容，可以在服务更新后使用当前订单完整重新转写。'],
+  ['SOURCE_MEDIA_REDIRECT_LIMIT_EXCEEDED', '媒体地址重定向次数过多，暂时无法下载，可以稍后使用当前订单完整重新转写。'],
+  ['SOURCE_MEDIA_TIMEOUT', '媒体下载超时，可以稍后使用当前订单完整重新转写。'],
+  ['SOURCE_MEDIA_DOWNLOAD_FAILED', '媒体下载失败，可以稍后使用当前订单完整重新转写。'],
+  ['SOURCE_MEDIA_ALL_CANDIDATES_FAILED', '所有可用媒体地址均下载失败，可以稍后使用当前订单完整重新转写。'],
+  ['TRANSCRIPTION_FAILED', '转写失败，请稍后再试。'],
+])
+
+function getSafeTranscriptionFailureMessage(data) {
+  if (!data || typeof data !== 'object' || Array.isArray(data)) {
+    return '转写失败'
+  }
+
+  return SAFE_TRANSCRIPTION_FAILURE_MESSAGES.get(data.errorCode) || '转写失败'
+}
+
 function normalizeProgressValue(progress, finishedChunks, totalChunks) {
   if (Number.isFinite(progress) && progress >= 0) {
     return Math.max(0, Math.min(1, progress))
@@ -1022,14 +1131,6 @@ function buildUploadProgressMessage(input = {}) {
   return `上传中 ${formatBytes(uploadedBytes)} / ${formatBytes(totalBytes)} (${percent}%)`
 }
 
-function buildHashingMessage(input = {}) {
-  const hashedBytes = Number(input.hashedBytes) || 0
-  const totalBytes = Number(input.totalBytes) || 0
-  const percent = normalizeUploadPercent(hashedBytes, totalBytes)
-
-  return `正在计算文件哈希 ${percent}%`
-}
-
 function getUploadReadyMessage(input = {}) {
   const title = input.title || input.filename || '上传文件'
   const duration = Number(input.durationSeconds)
@@ -1052,7 +1153,7 @@ function getUploadTaskFromCheckResult(checkResult) {
   return null
 }
 
-function getUploadReadySummary(checkResult, fileInput, uploadId) {
+function getUploadReadySummary(checkResult, fileInput) {
   const task = getUploadTaskFromCheckResult(checkResult)
   const upload = checkResult?.upload || {}
   const durationMs = Number(upload.ffprobeDurationMs || upload.clientDurationMs)
@@ -1065,7 +1166,6 @@ function getUploadReadySummary(checkResult, fileInput, uploadId) {
   const requiredMinutes = Number(checkResult?.requiredMinutes)
 
   return {
-    uploadId,
     filename: upload.filename || fileInput.filename,
     title: task?.title || checkResult?.title || upload.filename || fileInput.filename,
     durationSeconds: normalizedDurationSeconds,
@@ -1134,36 +1234,6 @@ function createProgressReporter(progressFormat) {
       writeTextMessage(`本次消耗分钟：${safeTask.consumedMinutes}`)
       writeTextMessage(`剩余分钟：${safeTask.remainingMinutes}`)
     },
-    reportUploadHashing(input = {}) {
-      const message = buildHashingMessage(input)
-      const hashedBytes = Number(input.hashedBytes) || 0
-      const totalBytes = Number(input.totalBytes) || 0
-      const percent = normalizeUploadPercent(hashedBytes, totalBytes)
-
-      if (resolvedMode === 'interactive') {
-        writeInline(outputState, message)
-        return
-      }
-
-      if (resolvedMode === 'jsonl') {
-        writeJsonEvent({
-          event: 'upload.hashing',
-          message,
-          filename: input.filename || null,
-          hashedBytes,
-          totalBytes,
-          percent,
-        })
-        return
-      }
-
-      if (message === lastTextProgressMessage) {
-        return
-      }
-
-      lastTextProgressMessage = message
-      writeTextMessage(message)
-    },
     reportUploadStarted(input = {}) {
       lastTextProgressMessage = ''
       const message = `上传已开始：${input.filename || '上传文件'}（${formatBytes(input.totalBytes)}）`
@@ -1173,7 +1243,6 @@ function createProgressReporter(progressFormat) {
         filename: input.filename || null,
         mimeType: input.mimeType || null,
         totalBytes: Number(input.totalBytes) || 0,
-        uploadId: input.uploadId || null,
         partSize: Number(input.partSize) || null,
         totalParts: Number(input.totalParts) || null,
       })
@@ -1216,7 +1285,6 @@ function createProgressReporter(progressFormat) {
 
       emitTextOrJson(message, {
         event: 'upload.completed',
-        uploadId: input.uploadId || null,
         filename: input.filename || null,
         totalBytes: Number(input.totalBytes) || 0,
       })
@@ -1226,7 +1294,6 @@ function createProgressReporter(progressFormat) {
 
       emitTextOrJson(message, {
         event: 'upload.checking',
-        uploadId: input.uploadId || null,
       })
     },
     reportUploadReady(input = {}) {
@@ -1234,7 +1301,6 @@ function createProgressReporter(progressFormat) {
 
       emitTextOrJson(message, {
         event: 'upload.ready',
-        uploadId: input.uploadId || null,
         sourceType: 'upload',
         sourceUrl: UPLOAD_REDACTED_SOURCE_LABEL,
         title: input.title || input.filename || null,
@@ -1248,14 +1314,12 @@ function createProgressReporter(progressFormat) {
 
       emitTextOrJson(message, {
         event: 'upload.aborted',
-        uploadId: input.uploadId || null,
       })
     },
     reportUploadFailed(message, input = {}) {
       finishInline(outputState)
       emitTextOrJson(message, {
         event: 'upload.failed',
-        uploadId: input.uploadId || null,
         error: message,
       })
     },
@@ -1379,6 +1443,17 @@ function createProgressReporter(progressFormat) {
         event: 'task.notice',
       })
     },
+    reportWechatChannelsCredentialRequired(presentationUrl, browserOpened) {
+      const message = browserOpened
+        ? `已尝试打开视频号扫码授权页；如浏览器未自动打开，请复制：${presentationUrl}`
+        : `请复制到浏览器完成视频号扫码授权：${presentationUrl}`
+      emitTextOrJson(message, {
+        event: 'wechat_channels.credential_required',
+        errorCode: WECHAT_CHANNELS_CREDENTIAL_ERROR_CODE,
+        presentationUrl,
+        browserOpened,
+      })
+    },
     close() {
       finishInline(outputState)
     },
@@ -1593,7 +1668,12 @@ async function consumeTaskEvents(baseUrl, apiKey, taskId, initialTask, reporter,
       if (data?.status === 'transcribing') {
         renderProgress(data)
       } else if (TERMINAL_STATUSES.has(data?.status)) {
-        applyTerminal(data.status, data?.error || data?.message || null)
+        applyTerminal(
+          data.status,
+          data.status === 'failed'
+            ? getSafeTranscriptionFailureMessage(data)
+            : data?.error || data?.message || null,
+        )
       } else {
         applyStatus(data?.status)
       }
@@ -1621,7 +1701,7 @@ async function consumeTaskEvents(baseUrl, apiKey, taskId, initialTask, reporter,
     }
 
     if (event === 'job.failed') {
-      applyTerminal('failed', data?.error || data?.message || '转写失败')
+      applyTerminal('failed', getSafeTranscriptionFailureMessage(data))
       return true
     }
 
@@ -1705,48 +1785,6 @@ function assertNotAborted(signal) {
   }
 }
 
-async function calculateFileSha256(fileInput, reporter, signal) {
-  const hash = createHash('sha256')
-  const fileHandle = await open(fileInput.path, 'r')
-  let hashedBytes = 0
-
-  reporter.reportUploadHashing({
-    filename: fileInput.filename,
-    hashedBytes,
-    totalBytes: fileInput.sizeBytes,
-  })
-
-  try {
-    while (hashedBytes < fileInput.sizeBytes) {
-      assertNotAborted(signal)
-
-      const length = Math.min(HASH_CHUNK_SIZE, fileInput.sizeBytes - hashedBytes)
-      const buffer = Buffer.allocUnsafe(length)
-      const { bytesRead } = await fileHandle.read(buffer, 0, length, hashedBytes)
-
-      if (bytesRead <= 0) {
-        break
-      }
-
-      hash.update(bytesRead === buffer.length ? buffer : buffer.subarray(0, bytesRead))
-      hashedBytes += bytesRead
-      reporter.reportUploadHashing({
-        filename: fileInput.filename,
-        hashedBytes,
-        totalBytes: fileInput.sizeBytes,
-      })
-    }
-  } finally {
-    await fileHandle.close().catch(() => {})
-  }
-
-  if (hashedBytes !== fileInput.sizeBytes) {
-    throw new Error('读取本地文件计算哈希时大小不一致，请重新选择文件')
-  }
-
-  return hash.digest('hex')
-}
-
 async function readFileChunk(filePath, start, length, signal) {
   assertNotAborted(signal)
 
@@ -1823,8 +1861,7 @@ function createRunContext(baseUrl, apiKey, reporter) {
       }
 
       if (!state.uploadAbortAllowed && state.uploadId) {
-        const taskPart = state.taskId ? `，taskId=${state.taskId}` : ''
-        reporter.reportNotice(`已停止本地等待，服务端正在处理上传：uploadId=${state.uploadId}${taskPart}`)
+        reporter.reportNotice('已停止本地等待，服务端正在处理上传')
         reporter.close()
         return
       }
@@ -2017,7 +2054,6 @@ async function uploadLocalFile(fileInput, args, baseUrl, apiKey, reporter, runCo
   let uploadId = ''
 
   try {
-    const fileHash = await calculateFileSha256(fileInput, reporter, runContext.signal)
     const startResponse = await requestJson(baseUrl, apiKey, '/api/cli/uploads/start', {
       method: 'POST',
       signal: runContext.signal,
@@ -2026,7 +2062,6 @@ async function uploadLocalFile(fileInput, args, baseUrl, apiKey, reporter, runCo
         filename: fileInput.filename,
         mimeType: fileInput.mimeType,
         sizeBytes: fileInput.sizeBytes,
-        fileHash,
       },
     })
 
@@ -2078,14 +2113,15 @@ async function uploadLocalFile(fileInput, args, baseUrl, apiKey, reporter, runCo
     runContext.state.uploadAbortAllowed = false
     reporter.reportUploadChecking({ uploadId })
 
+    const checkBody = { uploadId }
+    if (args.language) {
+      checkBody.language = args.language
+    }
     const checkResult = await requestJson(baseUrl, apiKey, '/api/cli/uploads/check', {
       method: 'POST',
       signal: runContext.signal,
       retry: true,
-      body: {
-        uploadId,
-        ...(args.language ? { language: args.language } : {}),
-      },
+      body: checkBody,
     })
     const checkedTask = getUploadTaskFromCheckResult(checkResult)
 
@@ -2094,7 +2130,7 @@ async function uploadLocalFile(fileInput, args, baseUrl, apiKey, reporter, runCo
       runContext.state.taskCreated = true
     }
 
-    reporter.reportUploadReady(getUploadReadySummary(checkResult, fileInput, uploadId))
+    reporter.reportUploadReady(getUploadReadySummary(checkResult, fileInput))
 
     return {
       ...checkResult,
@@ -2191,9 +2227,11 @@ async function handleAuthCommand(argv) {
 function buildUrlTaskCreatePayload(args, input) {
   const createPayload = {
     url: input.url,
-    ...(args.language ? { language: args.language } : {}),
   }
 
+  if (args.language) {
+    createPayload.language = args.language
+  }
   if (args.source) {
     createPayload.source = args.source
   }
@@ -2201,13 +2239,102 @@ function buildUrlTaskCreatePayload(args, input) {
   return createPayload
 }
 
-async function createCliTask(baseUrl, apiKey, createPayload, reporter, runContext) {
-  const created = await requestJson(baseUrl, apiKey, '/api/cli/transcriptions', {
+function shouldPreflightBilibiliUrl(args, input) {
+  if (args.source === 'bilibili') return true
+  if (typeof input?.url !== 'string') return false
+  if (/^bilibili:\/\/video\//i.test(input.url)) return true
+
+  try {
+    const hostname = new URL(input.url).hostname.toLowerCase()
+    return hostname === 'bilibili.com'
+      || hostname.endsWith('.bilibili.com')
+      || hostname === 'b23.tv'
+  } catch {
+    return false
+  }
+}
+
+async function confirmBilibiliTrial(preflight) {
+  process.stderr.write(`${preflight.message || '这是B站专属视频，Deyo 只能转写试看部分'}\n`)
+  process.stderr.write(`完整时长：${preflight.fullDurationLabel || `${preflight.fullDurationSeconds} 秒`}\n`)
+  process.stderr.write(`可转写时长：${preflight.transcribableDurationLabel || `${preflight.transcribableDurationSeconds} 秒`}\n`)
+  process.stderr.write(`本次预计扣除：${preflight.requiredMinutes} 分钟\n`)
+
+  if (!process.stdin.isTTY) {
+    process.stderr.write('当前不是交互式终端，已取消且不会创建任务或扣除分钟。请在交互终端中重新执行并确认。\n')
+    return false
+  }
+
+  const prompt = createInterface({
+    input: process.stdin,
+    output: process.stderr,
+  })
+
+  try {
+    const answer = (await prompt.question('仍然转写试看部分？请输入 y 确认 [y/N]：')).trim().toLowerCase()
+    return answer === 'y' || answer === 'yes'
+  } finally {
+    prompt.close()
+  }
+}
+
+async function preflightBilibiliTask(baseUrl, apiKey, createPayload, runContext) {
+  const preflight = await requestJson(baseUrl, apiKey, '/api/cli/transcriptions/preflight', {
     method: 'POST',
     signal: runContext.signal,
     body: createPayload,
   })
 
+  if (preflight?.confirmationRequired) {
+    const confirmed = await confirmBilibiliTrial(preflight)
+
+    if (!confirmed) {
+      if (process.stdin.isTTY) {
+        process.stderr.write('已取消，不会创建任务或扣除分钟。\n')
+      }
+      throw new ReportedCliError('已取消')
+    }
+  }
+
+  if (!preflight?.parseToken) {
+    throw new Error('服务端预检未返回有效的 parse token')
+  }
+
+  return createPayload.language
+    ? { parseToken: preflight.parseToken, language: createPayload.language }
+    : { parseToken: preflight.parseToken }
+}
+
+async function createCliTask(baseUrl, apiKey, createPayload, reporter, runContext) {
+  const createRequest = () => requestJson(baseUrl, apiKey, '/api/cli/transcriptions', {
+      method: 'POST',
+      signal: runContext.signal,
+      body: createPayload,
+    })
+  let created
+
+  try {
+    created = await createRequest()
+  } catch (error) {
+    if (!(error instanceof HttpCliError) || error.errorCode !== WECHAT_CHANNELS_CREDENTIAL_ERROR_CODE) throw error
+    if (!error.presentationUrl) throw new Error('服务端返回的视频号授权地址无效，请稍后重试')
+
+    const browserOpened = tryOpenSystemBrowser(error.presentationUrl)
+    reporter.reportWechatChannelsCredentialRequired(error.presentationUrl, browserOpened)
+    const parseToken = new URL(error.presentationUrl).searchParams.get('token')
+    if (!parseToken) throw new Error('服务端返回的视频号解析地址无效，请稍后重试')
+    await waitForParseResume(baseUrl, apiKey, parseToken, runContext, error.retryAfterMs)
+
+    try {
+      created = await createRequest()
+    } catch (replayError) {
+      if (replayError instanceof HttpCliError && replayError.errorCode === WECHAT_CHANNELS_CREDENTIAL_ERROR_CODE) {
+        throw new Error('视频号授权状态已变化，请重新执行原命令')
+      }
+      throw replayError
+    }
+  }
+
   runContext.state.taskId = created.taskId || ''
   runContext.state.taskCreated = true
   reporter.reportTaskCreated(created)
@@ -2215,6 +2342,49 @@ async function createCliTask(baseUrl, apiKey, createPayload, reporter, runContex
   return created
 }
 
+function tryOpenSystemBrowser(url) {
+  const command = process.platform === 'darwin'
+    ? { file: 'open', args: [url] }
+    : process.platform === 'win32'
+      ? { file: 'cmd', args: ['/c', 'start', '', url] }
+      : { file: 'xdg-open', args: [url] }
+
+  try {
+    const child = spawn(command.file, command.args, {
+      detached: true,
+      stdio: 'ignore',
+    })
+    child.once('error', () => {})
+    child.unref()
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function waitForParseResume(baseUrl, apiKey, parseToken, runContext, initialRetryAfterMs) {
+  const startedAt = Date.now()
+  let retryAfterMs = Number.isSafeInteger(initialRetryAfterMs) ? initialRetryAfterMs : POLL_INTERVAL_MS
+
+  while (Date.now() - startedAt < WECHAT_CHANNELS_AUTH_TIMEOUT_MS) {
+    await sleep(retryAfterMs)
+    if (runContext.signal.aborted) throw createAbortError()
+
+    const status = await requestJson(baseUrl, apiKey, `/api/cli/parse-status?token=${encodeURIComponent(parseToken)}`, {
+      signal: runContext.signal,
+      retry: true,
+    })
+
+    if (status?.status === 'ready') return
+    if (status?.status !== 'pending') throw new Error('服务端返回了未知的解析状态')
+    retryAfterMs = Number.isSafeInteger(status.retryAfterMs) && status.retryAfterMs >= 1000 && status.retryAfterMs <= 5000
+      ? status.retryAfterMs
+      : POLL_INTERVAL_MS
+  }
+
+  throw new Error('等待视频号扫码授权超时，请重新执行原命令')
+}
+
 function reportTaskStatusTransition(reporter, previousStatus, task) {
   if (task.status === previousStatus) {
     return task.status
@@ -2480,6 +2650,15 @@ async function handleTranscription(argv) {
       }
     } else {
       createPayload = buildUrlTaskCreatePayload(args, input)
+
+      if (shouldPreflightBilibiliUrl(args, input)) {
+        createPayload = await preflightBilibiliTask(
+          baseUrl,
+          resolvedApiKey.apiKey,
+          createPayload,
+          runContext,
+        )
+      }
     }
 
     if (!created) {
@@ -2528,7 +2707,8 @@ async function main() {
   }
 
   if (primaryCommand === 'skill') {
-    await handleSkillCommand(argv, CLI_VERSION)
+    const exitCode = await handleSkillCommand(argv, CLI_VERSION)
+    if (Number.isSafeInteger(exitCode)) process.exitCode = exitCode
     return
   }