@casatwy/deyo 0.1.0

package/README.md

@@ -0,0 +1,100 @@
+# deyo
+
+`@casatwy/deyo` installs the `deyo` command for sending transcription jobs to Deyo from your terminal.
+
+## Install
+
+```bash
+npm install -g @casatwy/deyo
+```
+
+```bash
+pnpm add -g @casatwy/deyo
+```
+
+## First-time login
+
+Create a Deyo API key from `https://deyo.miaobi.fun/me/api-keys`, then save it once locally:
+
+```bash
+deyo auth login --api-key 'deyo_sk_xxx'
+```
+
+Check whether the local config is active:
+
+```bash
+deyo auth status
+```
+
+Remove the saved local config:
+
+```bash
+deyo auth logout
+```
+
+## Usage
+
+The published CLI defaults to the production service at `https://deyo.miaobi.fun`.
+
+After `deyo auth login`, you can run transcription commands without repeating `--api-key`:
+
+```bash
+deyo --language zh -O ./transcript.txt 'https://www.bilibili.com/video/BVxxxx'
+```
+
+```bash
+deyo --language zh --format srt -O ./transcript.srt 'https://www.youtube.com/watch?v=xxxx'
+```
+
+```bash
+deyo --language en 'https://www.youtube.com/watch?v=xxxx'
+```
+
+If you need local development, pass `--base-url` explicitly:
+
+```bash
+deyo auth login --api-key 'deyo_sk_xxx' --base-url 'http://deyo.mac-studio'
+deyo --base-url 'http://deyo.mac-studio' --language zh -O ./transcript.txt 'https://www.bilibili.com/video/BVxxxx'
+```
+
+For a one-off override, `--api-key` still takes precedence over local config:
+
+```bash
+deyo --api-key 'deyo_sk_other' --language zh 'https://www.youtube.com/watch?v=xxxx'
+```
+
+By default, the CLI requests Chinese output, which is equivalent to `--language zh`.
+
+Run `deyo --help` to see the full argument list.
+
+## Install in AI tools
+
+The official install pages live at:
+
+- Codex: `https://deyo.miaobi.fun/ai/install/codex`
+- Claude: `https://deyo.miaobi.fun/ai/install/claude`
+
+These pages tell the AI how to install the `deyo` skill or plugin, ask for the user's API key once, and run `deyo auth login` locally.
+
+## Publish
+
+For maintainers, publish from the `cli_` directory:
+
+```bash
+cd cli_
+make deploy
+```
+
+If you need to publish a new version, pass it explicitly:
+
+```bash
+cd cli_
+make deploy VERSION=0.1.1
+```
+
+With npm 2FA enabled, pass the current OTP code explicitly:
+
+```bash
+cd cli_
+make deploy OTP=123456
+```

package/deyo.mjs

@@ -0,0 +1,844 @@
+#!/usr/bin/env node
+
+import { chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { dirname, extname, resolve } from 'node:path'
+import { homedir } from 'node:os'
+import process from 'node:process'
+
+const DEFAULT_BASE_URL = 'https://deyo.miaobi.fun'
+const DEFAULT_LANGUAGE = 'zh'
+const POLL_INTERVAL_MS = 1500
+const RESULT_FORMATS = new Set(['text', 'srt', 'vtt', 'json', 'verbose_json'])
+const TERMINAL_STATUSES = new Set(['completed', 'failed', 'cancelled'])
+
+function safeJsonParse(value) {
+  try {
+    return JSON.parse(value)
+  } catch {
+    return value
+  }
+}
+
+function fail(message, exitCode = 1) {
+  process.stderr.write(`${message}\n`)
+  process.exit(exitCode)
+}
+
+function printUsage() {
+  process.stderr.write(`用法:
+  deyo [选项] <url>
+  deyo auth <login|logout|status> [选项]
+
+转写选项:
+  --api-key <key>       可选，Deyo API key
+  -O, --output <path>   可选，输出文件路径
+  --source <name>       可选，显式指定来源
+  --language <value>    可选，转写语言，默认 ${DEFAULT_LANGUAGE}
+  --format <value>      可选，text | srt | vtt | json | verbose_json
+  --base-url <url>      可选，默认 ${DEFAULT_BASE_URL}
+  -h, --help            显示帮助
+
+auth 子命令:
+  deyo auth login --api-key <key> [--base-url <url>]
+  deyo auth logout
+  deyo auth status
+
+API key 读取优先级:
+  1. --api-key
+  2. 环境变量 DEYO_API_KEY
+  3. 本地配置文件（先执行 deyo auth login）
+`)
+}
+
+function printAuthUsage() {
+  process.stderr.write(`用法:
+  deyo auth login --api-key <key> [--base-url <url>]
+  deyo auth logout
+  deyo auth status
+
+说明:
+  login   保存本地默认 API key，后续无需每次传 --api-key
+  logout  删除本地保存的配置
+  status  查看当前生效来源与本地配置状态
+`)
+}
+
+function parseTranscriptionArgs(argv) {
+  const args = {
+    apiKey: '',
+    output: '',
+    source: '',
+    language: '',
+    format: '',
+    baseUrl: '',
+    url: '',
+  }
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const current = argv[index]
+
+    if (current === '-h' || current === '--help') {
+      printUsage()
+      process.exit(0)
+    }
+
+    if (current === '-O' || current === '--output') {
+      args.output = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    if (current === '--api-key') {
+      args.apiKey = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    if (current === '--source') {
+      args.source = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    if (current === '--language') {
+      args.language = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    if (current === '--format') {
+      args.format = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    if (current === '--base-url') {
+      args.baseUrl = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    if (current.startsWith('-')) {
+      fail(`未知参数：${current}`)
+    }
+
+    if (args.url) {
+      fail('只能提供一个内容链接')
+    }
+
+    args.url = current
+  }
+
+  return args
+}
+
+function parseAuthArgs(argv) {
+  const action = argv[1] || ''
+  const args = {
+    action,
+    apiKey: '',
+    baseUrl: '',
+  }
+
+  if (!action) {
+    printAuthUsage()
+    fail('缺少 auth 子命令')
+  }
+
+  for (let index = 2; index < argv.length; index += 1) {
+    const current = argv[index]
+
+    if (current === '-h' || current === '--help') {
+      printAuthUsage()
+      process.exit(0)
+    }
+
+    if (current === '--api-key') {
+      args.apiKey = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    if (current === '--base-url') {
+      args.baseUrl = argv[index + 1] || ''
+      index += 1
+      continue
+    }
+
+    fail(`未知参数：${current}`)
+  }
+
+  return args
+}
+
+function normalizeBaseUrl(baseUrl) {
+  try {
+    const url = new URL(baseUrl)
+    return url.toString().replace(/\/$/, '')
+  } catch {
+    fail(`--base-url 不是合法 URL：${baseUrl}`)
+  }
+}
+
+function inferFormat(outputPath, explicitFormat) {
+  if (explicitFormat) {
+    if (!RESULT_FORMATS.has(explicitFormat)) {
+      fail(`--format 不支持：${explicitFormat}`)
+    }
+
+    return explicitFormat
+  }
+
+  if (!outputPath) {
+    return 'text'
+  }
+
+  const extension = extname(outputPath).toLowerCase()
+
+  if (extension === '.srt') return 'srt'
+  if (extension === '.vtt') return 'vtt'
+  if (extension === '.json') return 'json'
+  return 'text'
+}
+
+function getConfigFileCandidates() {
+  const home = homedir()
+  const xdgConfigHome = String(process.env.XDG_CONFIG_HOME || '').trim()
+  const candidates = []
+
+  if (xdgConfigHome) {
+    candidates.push(resolve(xdgConfigHome, 'deyo', 'config.json'))
+  } else if (home) {
+    candidates.push(resolve(home, '.config', 'deyo', 'config.json'))
+    candidates.push(resolve(home, '.deyo', 'config.json'))
+  }
+
+  if (!candidates.length) {
+    candidates.push(resolve(process.cwd(), '.deyo', 'config.json'))
+  }
+
+  return candidates
+}
+
+function normalizeStoredConfig(rawConfig, path) {
+  if (!rawConfig || typeof rawConfig !== 'object') {
+    throw new Error(`本地配置文件格式无效：${path}`)
+  }
+
+  const apiKey = typeof rawConfig.apiKey === 'string' ? rawConfig.apiKey.trim() : ''
+  const baseUrl = typeof rawConfig.baseUrl === 'string' ? rawConfig.baseUrl.trim() : ''
+
+  return {
+    apiKey,
+    baseUrl: baseUrl ? normalizeBaseUrl(baseUrl) : '',
+  }
+}
+
+async function readStoredConfig() {
+  const candidates = getConfigFileCandidates()
+
+  for (const path of candidates) {
+    try {
+      const content = await readFile(path, 'utf8')
+      return {
+        path,
+        config: normalizeStoredConfig(JSON.parse(content), path),
+      }
+    } catch (error) {
+      if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+        continue
+      }
+
+      if (error instanceof SyntaxError) {
+        throw new Error(`本地配置文件不是合法 JSON：${path}`)
+      }
+
+      throw error
+    }
+  }
+
+  return null
+}
+
+async function writeStoredConfig(nextConfig) {
+  const candidates = getConfigFileCandidates()
+  const normalizedConfig = {
+    apiKey: String(nextConfig.apiKey || '').trim(),
+    baseUrl: nextConfig.baseUrl ? normalizeBaseUrl(nextConfig.baseUrl) : '',
+  }
+
+  let lastError = null
+
+  for (const path of candidates) {
+    try {
+      await mkdir(dirname(path), { recursive: true })
+      await writeFile(path, `${JSON.stringify(normalizedConfig, null, 2)}\n`, 'utf8')
+      await chmod(path, 0o600).catch(() => {})
+      return path
+    } catch (error) {
+      lastError = error
+    }
+  }
+
+  throw lastError || new Error('写入本地配置失败')
+}
+
+async function removeStoredConfig() {
+  const candidates = getConfigFileCandidates()
+  const removedPaths = []
+
+  for (const path of candidates) {
+    try {
+      await rm(path, { force: true })
+      removedPaths.push(path)
+    } catch (error) {
+      if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+        continue
+      }
+
+      throw error
+    }
+  }
+
+  return removedPaths
+}
+
+function maskApiKey(apiKey) {
+  const normalized = String(apiKey || '').trim()
+
+  if (!normalized) {
+    return ''
+  }
+
+  if (normalized.length <= 10) {
+    return `${normalized.slice(0, 2)}***${normalized.slice(-2)}`
+  }
+
+  return `${normalized.slice(0, 6)}...${normalized.slice(-4)}`
+}
+
+function resolveBaseUrl(explicitBaseUrl, storedConfig) {
+  if (explicitBaseUrl) {
+    return {
+      baseUrl: normalizeBaseUrl(explicitBaseUrl),
+      source: '--base-url',
+    }
+  }
+
+  const envBaseUrl = String(process.env.DEYO_BASE_URL || '').trim()
+
+  if (envBaseUrl) {
+    return {
+      baseUrl: normalizeBaseUrl(envBaseUrl),
+      source: 'DEYO_BASE_URL',
+    }
+  }
+
+  if (storedConfig?.config.baseUrl) {
+    return {
+      baseUrl: storedConfig.config.baseUrl,
+      source: '本地配置',
+    }
+  }
+
+  return {
+    baseUrl: DEFAULT_BASE_URL,
+    source: '默认值',
+  }
+}
+
+function resolveApiKey(explicitApiKey, storedConfig) {
+  const directApiKey = String(explicitApiKey || '').trim()
+
+  if (directApiKey) {
+    return {
+      apiKey: directApiKey,
+      source: '--api-key',
+    }
+  }
+
+  const envApiKey = String(process.env.DEYO_API_KEY || '').trim()
+
+  if (envApiKey) {
+    return {
+      apiKey: envApiKey,
+      source: 'DEYO_API_KEY',
+    }
+  }
+
+  if (storedConfig?.config.apiKey) {
+    return {
+      apiKey: storedConfig.config.apiKey,
+      source: '本地配置',
+    }
+  }
+
+  return null
+}
+
+async function readErrorMessage(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
+
+    if (message) {
+      return String(message)
+    }
+  }
+
+  const text = await response.text().catch(() => '')
+  return text || `${response.status} ${response.statusText}`
+}
+
+async function requestJson(baseUrl, apiKey, path, options = {}) {
+  const response = await fetch(`${baseUrl}${path}`, {
+    method: options.method || 'GET',
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      ...(options.headers || {}),
+    },
+    body: typeof options.body === 'undefined' ? undefined : JSON.stringify(options.body),
+  })
+
+  if (!response.ok) {
+    throw new Error(await readErrorMessage(response))
+  }
+
+  return response.json()
+}
+
+async function requestResult(baseUrl, apiKey, taskId, format) {
+  const response = await fetch(`${baseUrl}/api/cli/transcriptions/${encodeURIComponent(taskId)}/result?format=${encodeURIComponent(format)}`, {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+    },
+  })
+
+  if (!response.ok) {
+    throw new Error(await readErrorMessage(response))
+  }
+
+  if (format === 'json' || format === 'verbose_json') {
+    return JSON.stringify(await response.json(), null, 2)
+  }
+
+  return response.text()
+}
+
+function sleep(ms) {
+  return new Promise(resolvePromise => setTimeout(resolvePromise, ms))
+}
+
+function formatStatus(status) {
+  if (status === 'queued') return '排队中'
+  if (status === 'downloading') return '下载中'
+  if (status === 'preprocessing') return '预处理中'
+  if (status === 'chunking') return '切分中'
+  if (status === 'transcribing') return '转写中'
+  if (status === 'merging') return '合并中'
+  if (status === 'completed') return '已完成'
+  if (status === 'failed') return '失败'
+  if (status === 'cancelled') return '已取消'
+  return status || '未知状态'
+}
+
+function createOutputState() {
+  return {
+    inlineActive: false,
+  }
+}
+
+function clearInline(outputState) {
+  if (!outputState.inlineActive) {
+    return
+  }
+
+  process.stderr.write('\r\x1b[2K')
+  outputState.inlineActive = false
+}
+
+function writeStatusLine(outputState, message) {
+  clearInline(outputState)
+  process.stderr.write(`${message}\n`)
+}
+
+function writeInline(outputState, message) {
+  process.stderr.write(`\r\x1b[2K${message}`)
+  outputState.inlineActive = true
+}
+
+function finishInline(outputState) {
+  if (!outputState.inlineActive) {
+    return
+  }
+
+  process.stderr.write('\n')
+  outputState.inlineActive = false
+}
+
+function normalizeProgressValue(progress, finishedChunks, totalChunks) {
+  if (Number.isFinite(progress) && progress >= 0) {
+    return Math.max(0, Math.min(1, progress))
+  }
+
+  if (
+    Number.isFinite(finishedChunks)
+    && Number.isFinite(totalChunks)
+    && totalChunks > 0
+  ) {
+    return Math.max(0, Math.min(1, finishedChunks / totalChunks))
+  }
+
+  return null
+}
+
+function buildTranscribingProgressMessage(input = {}) {
+  const finishedChunks = Number(input.finishedChunks)
+  const totalChunks = Number(input.totalChunks)
+  const normalizedProgress = normalizeProgressValue(
+    Number(input.progress),
+    finishedChunks,
+    totalChunks,
+  )
+
+  if (normalizedProgress === null) {
+    return '转写中'
+  }
+
+  const percent = Math.round(normalizedProgress * 100)
+  const chunksPart = Number.isFinite(finishedChunks) && Number.isFinite(totalChunks) && totalChunks > 0
+    ? ` (${Math.max(0, finishedChunks)}/${totalChunks})`
+    : ''
+
+  return `转写中 ${percent}%${chunksPart}`
+}
+
+function parseSseBlock(block) {
+  const lines = block.split('\n')
+  let event = 'message'
+  const dataLines = []
+
+  for (const line of lines) {
+    if (!line || line.startsWith(':')) {
+      continue
+    }
+
+    if (line.startsWith('event:')) {
+      event = line.slice(6).trim()
+      continue
+    }
+
+    if (line.startsWith('data:')) {
+      dataLines.push(line.slice(5).trimStart())
+    }
+  }
+
+  return {
+    event,
+    data: safeJsonParse(dataLines.join('\n')),
+  }
+}
+
+async function consumeTaskEvents(baseUrl, apiKey, taskId, initialTask, outputState) {
+  const response = await fetch(`${baseUrl}/api/cli/transcriptions/${encodeURIComponent(taskId)}/events`, {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+    },
+  })
+
+  if (!response.ok || !response.body) {
+    throw new Error(await readErrorMessage(response))
+  }
+
+  const reader = response.body.getReader()
+  const decoder = new TextDecoder()
+  let buffer = ''
+  let task = {
+    ...initialTask,
+  }
+  let currentStatus = task.status
+
+  function applyStatus(nextStatus) {
+    if (!nextStatus || nextStatus === currentStatus) {
+      return
+    }
+
+    currentStatus = nextStatus
+    task = {
+      ...task,
+      status: nextStatus,
+    }
+    writeStatusLine(outputState, `状态更新：${formatStatus(nextStatus)}`)
+  }
+
+  function applyTerminal(nextStatus, errorMessage) {
+    currentStatus = nextStatus
+    task = {
+      ...task,
+      status: nextStatus,
+      error: errorMessage || task.error || null,
+    }
+    finishInline(outputState)
+  }
+
+  function renderProgress(data) {
+    currentStatus = 'transcribing'
+    task = {
+      ...task,
+      status: 'transcribing',
+    }
+    writeInline(outputState, buildTranscribingProgressMessage(data))
+  }
+
+  while (true) {
+    const { value, done } = await reader.read()
+
+    if (done) {
+      break
+    }
+
+    buffer += decoder.decode(value, { stream: true })
+    buffer = buffer.replace(/\r\n/g, '\n')
+
+    let separatorIndex = buffer.indexOf('\n\n')
+
+    while (separatorIndex >= 0) {
+      const block = buffer.slice(0, separatorIndex).trim()
+      buffer = buffer.slice(separatorIndex + 2)
+      separatorIndex = buffer.indexOf('\n\n')
+
+      if (!block) {
+        continue
+      }
+
+      const { event, data } = parseSseBlock(block)
+
+      if (event === 'job.snapshot') {
+        if (data?.status === 'transcribing') {
+          renderProgress(data)
+        } else {
+          applyStatus(data?.status)
+        }
+        continue
+      }
+
+      if (event === 'job.status_changed') {
+        applyStatus(data?.status)
+        continue
+      }
+
+      if (event === 'job.progress') {
+        renderProgress(data)
+        continue
+      }
+
+      if (event === 'job.completed') {
+        applyTerminal('completed', null)
+        return task
+      }
+
+      if (event === 'job.failed') {
+        applyTerminal('failed', data?.error || data?.message || '转写失败')
+        return task
+      }
+
+      if (event === 'job.cancelled') {
+        applyTerminal('cancelled', '转写任务已取消')
+        return task
+      }
+    }
+  }
+
+  finishInline(outputState)
+  return task
+}
+
+async function writeOutput(outputPath, content) {
+  const resolvedPath = resolve(process.cwd(), outputPath)
+  await mkdir(dirname(resolvedPath), { recursive: true })
+  await writeFile(resolvedPath, content, 'utf8')
+  return resolvedPath
+}
+
+async function handleAuthLogin(args) {
+  if (!args.apiKey) {
+    printAuthUsage()
+    fail('缺少 --api-key')
+  }
+
+  const existingConfig = await readStoredConfig().catch(() => null)
+  const outputPath = await writeStoredConfig({
+    apiKey: args.apiKey,
+    baseUrl: args.baseUrl || existingConfig?.config.baseUrl || '',
+  })
+
+  process.stdout.write(`已保存本地配置：${outputPath}\n`)
+  process.stdout.write(`API key：${maskApiKey(args.apiKey)}\n`)
+
+  if (args.baseUrl || existingConfig?.config.baseUrl) {
+    const resolvedBaseUrl = normalizeBaseUrl(args.baseUrl || existingConfig?.config.baseUrl || DEFAULT_BASE_URL)
+    process.stdout.write(`默认服务地址：${resolvedBaseUrl}\n`)
+  }
+}
+
+async function handleAuthLogout() {
+  const removedPaths = await removeStoredConfig()
+
+  if (!removedPaths.length) {
+    process.stdout.write('本地没有可删除的 Deyo 配置。\n')
+    return
+  }
+
+  process.stdout.write(`已删除本地配置：${removedPaths.join('、')}\n`)
+}
+
+async function handleAuthStatus() {
+  const storedConfig = await readStoredConfig()
+  const activeApiKey = resolveApiKey('', storedConfig)
+  const activeBaseUrl = resolveBaseUrl('', storedConfig)
+
+  process.stdout.write(`当前 API key 来源：${activeApiKey?.source || '未配置'}\n`)
+
+  if (storedConfig?.config.apiKey) {
+    process.stdout.write(`本地配置文件：${storedConfig.path}\n`)
+    process.stdout.write(`本地 API key：${maskApiKey(storedConfig.config.apiKey)}\n`)
+  } else {
+    process.stdout.write('本地配置文件：未找到\n')
+  }
+
+  process.stdout.write(`当前服务地址：${activeBaseUrl.baseUrl}\n`)
+  process.stdout.write(`服务地址来源：${activeBaseUrl.source}\n`)
+}
+
+async function handleAuthCommand(argv) {
+  const args = parseAuthArgs(argv)
+
+  if (args.action === 'login') {
+    await handleAuthLogin(args)
+    return
+  }
+
+  if (args.action === 'logout') {
+    await handleAuthLogout()
+    return
+  }
+
+  if (args.action === 'status') {
+    await handleAuthStatus()
+    return
+  }
+
+  printAuthUsage()
+  fail(`不支持的 auth 子命令：${args.action}`)
+}
+
+async function handleTranscription(argv) {
+  const args = parseTranscriptionArgs(argv)
+  const storedConfig = await readStoredConfig()
+  const resolvedApiKey = resolveApiKey(args.apiKey, storedConfig)
+
+  if (!resolvedApiKey) {
+    printUsage()
+    fail('缺少 API key。请传 --api-key、设置 DEYO_API_KEY，或先执行 deyo auth login')
+  }
+
+  if (!args.url) {
+    printUsage()
+    fail('缺少内容链接')
+  }
+
+  const { baseUrl } = resolveBaseUrl(args.baseUrl, storedConfig)
+  const format = inferFormat(args.output, args.format)
+  const createPayload = {
+    url: args.url,
+    language: args.language || DEFAULT_LANGUAGE,
+  }
+
+  if (args.source) {
+    createPayload.source = args.source
+  }
+
+  const created = await requestJson(baseUrl, resolvedApiKey.apiKey, '/api/cli/transcriptions', {
+    method: 'POST',
+    body: createPayload,
+  })
+  const outputState = createOutputState()
+
+  process.stderr.write(`任务已创建：${created.taskId}\n`)
+  process.stderr.write(`标题：${created.title}\n`)
+  process.stderr.write(`来源：${created.sourceType}\n`)
+  process.stderr.write(`状态：${formatStatus(created.status)}\n`)
+  process.stderr.write(`本次消耗分钟：${created.consumedMinutes}\n`)
+  process.stderr.write(`剩余分钟：${created.remainingMinutes}\n`)
+
+  let task = created
+  let lastStatus = created.status
+
+  if (task.mode === 'transcription' && !TERMINAL_STATUSES.has(task.status)) {
+    try {
+      task = await consumeTaskEvents(baseUrl, resolvedApiKey.apiKey, task.taskId, task, outputState)
+      lastStatus = task.status
+    } catch (error) {
+      finishInline(outputState)
+      process.stderr.write(`事件流中断，回退到轮询状态：${error instanceof Error ? error.message : String(error)}\n`)
+    }
+  }
+
+  while (!TERMINAL_STATUSES.has(task.status)) {
+    await sleep(POLL_INTERVAL_MS)
+    task = await requestJson(baseUrl, resolvedApiKey.apiKey, `/api/cli/transcriptions/${encodeURIComponent(task.taskId)}`)
+
+    if (task.status !== lastStatus) {
+      finishInline(outputState)
+      process.stderr.write(`状态更新：${formatStatus(task.status)}\n`)
+      lastStatus = task.status
+    }
+  }
+
+  finishInline(outputState)
+
+  if (task.status !== 'completed') {
+    throw new Error(task.error || `任务未成功完成：${formatStatus(task.status)}`)
+  }
+
+  const result = await requestResult(baseUrl, resolvedApiKey.apiKey, task.taskId, format)
+
+  if (args.output) {
+    const outputPath = await writeOutput(args.output, result)
+    process.stderr.write(`结果已写入：${outputPath}\n`)
+    return
+  }
+
+  process.stdout.write(result)
+
+  if (!result.endsWith('\n')) {
+    process.stdout.write('\n')
+  }
+}
+
+async function main() {
+  const argv = process.argv.slice(2)
+  const primaryCommand = argv[0]
+
+  if (!primaryCommand || primaryCommand === '-h' || primaryCommand === '--help') {
+    printUsage()
+    return
+  }
+
+  if (primaryCommand === 'auth') {
+    await handleAuthCommand(argv)
+    return
+  }
+
+  await handleTranscription(argv)
+}
+
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error)
+  fail(`执行失败：${message}`)
+})

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@casatwy/deyo",
+  "version": "0.1.0",
+  "description": "CLI for submitting Deyo transcription jobs from the terminal",
+  "homepage": "https://deyo.miaobi.fun/docs",
+  "license": "UNLICENSED",
+  "type": "module",
+  "files": [
+    "deyo.mjs",
+    "README.md"
+  ],
+  "keywords": [
+    "deyo",
+    "transcription",
+    "cli",
+    "subtitle",
+    "whisper"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "deyo": "./deyo.mjs"
+  }
+}