@icode-js/icode 3.1.0 → 3.2.0

package/src/core/remote-merge/providers/gitlab.js

@@ -1,7 +1,10 @@
 import { IcodeError } from '../../errors.js'
+import { withSpinner } from '../../tools/loading.js'
+import { logger } from '../../tools/logger.js'
 import { normalizeRemoteMergeReason, parseRemoteMergePayload } from '../shared.js'
 
 const GITLAB_MERGE_STATUS_POLL_INTERVAL_MS = 1000
+const GITLAB_MERGE_STATUS_MAX_ATTEMPTS = 60
 const GITLAB_PENDING_MERGE_STATUSES = new Set([
   'unchecked',
   'checking',
@@ -19,6 +22,15 @@ const GITLAB_ACCEPTED_MERGE_STATUSES = new Set([
   'merge_time'
 ])
 
+// 生成可读的 GitLab MR 标签，输入 MR id 与 URL，输出适合日志展示的短文本。
+function formatGitLabMergeRequestLabel(mergeRequestId, mergeRequestUrl) {
+  if (mergeRequestUrl) {
+    return `${logger.color('green', mergeRequestUrl)} (#${mergeRequestId})`
+  }
+
+  return `#${mergeRequestId}`
+}
+
 // 根据 Git remote URL 生成标准 GitLab 项目 URL，无法识别时返回空串。
 export function resolveGitLabProjectUrlFromRemote(remoteUrl = '') {
   const raw = String(remoteUrl || '').trim()
@@ -121,6 +133,24 @@ function delay(ms) {
   })
 }
 
+// 合并检查轮询间隔，测试可显式传入 0 以避免等待；输入 options，输出毫秒数。
+function resolvePollIntervalMs(options = {}) {
+  if (Number.isInteger(options.pollIntervalMs) && options.pollIntervalMs >= 0) {
+    return options.pollIntervalMs
+  }
+
+  return GITLAB_MERGE_STATUS_POLL_INTERVAL_MS
+}
+
+// 合并检查最大轮询次数，测试或调用方可显式缩短；输入 options，输出正整数次数。
+function resolveMaxPollAttempts(options = {}) {
+  if (Number.isInteger(options.maxPollAttempts) && options.maxPollAttempts > 0) {
+    return options.maxPollAttempts
+  }
+
+  return GITLAB_MERGE_STATUS_MAX_ATTEMPTS
+}
+
 // 执行一次 GitLab JSON 请求，并统一返回响应对象、原始文本和解析后的负载。
 async function performGitLabJsonRequest(endpoint, requestOptions, errorMessage) {
   let response
@@ -180,6 +210,27 @@ async function fetchGitLabMergeRequest(project, mergeRequestId, apiKey) {
   }
 }
 
+// 构建 GitLab 状态轮询超时结果，输入阶段信息和最后一次响应，输出统一失败结构。
+function buildGitLabPollTimeoutResult(stage, mergeRequestId, mergeRequestUrl, maxAttempts, lastPayload) {
+  const status = typeof lastPayload?.detailed_merge_status === 'string' && lastPayload.detailed_merge_status.trim()
+    ? lastPayload.detailed_merge_status.trim()
+    : (typeof lastPayload?.merge_status === 'string' ? lastPayload.merge_status.trim() : '')
+  const reason = status
+    ? `GitLab 合并检查超时，最后状态: ${status}，已轮询 ${maxAttempts} 次。`
+    : `GitLab 合并检查超时，已轮询 ${maxAttempts} 次。`
+
+  return {
+    ok: false,
+    conflict: false,
+    status: 408,
+    reason,
+    step: stage,
+    mergeRequestId,
+    mergeRequestUrl,
+    payload: lastPayload
+  }
+}
+
 // 将 GitLab MR 状态转换成统一结果，保证上层能明确识别冲突分支。
 function buildGitLabMergeStatusResult(payload, mergeRequestId, mergeRequestUrl) {
   const detailedMergeStatus = typeof payload?.detailed_merge_status === 'string'
@@ -331,61 +382,97 @@ function buildGitLabMergeReadinessResult(payload, mergeRequestId, mergeRequestUr
 }
 
 // 轮询 GitLab MR，直到“是否允许 merge”检查完成。
-async function waitForGitLabMergeReadiness(project, mergeRequestId, mergeRequestUrl, apiKey) {
-  while (true) {
-    const mergeRequest = await fetchGitLabMergeRequest(project, mergeRequestId, apiKey)
-    if (!mergeRequest.response.ok) {
-      return buildGitLabFailedResult(mergeRequest.response, mergeRequest.rawText, mergeRequest.payload, {
-        step: 'inspect',
-        mergeRequestId,
-        mergeRequestUrl,
-        payload: {
-          create: null,
-          approve: null,
-          merge: null,
-          inspect: mergeRequest.payload
+async function waitForGitLabMergeReadiness(project, mergeRequestId, mergeRequestUrl, apiKey, options = {}) {
+  const maxAttempts = resolveMaxPollAttempts(options)
+  const pollIntervalMs = resolvePollIntervalMs(options)
+  let lastPayload = null
+
+  const pollResult = await withSpinner(
+    `等待 GitLab 完成合并前检查 ${formatGitLabMergeRequestLabel(mergeRequestId, mergeRequestUrl)}`,
+    async () => {
+      for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        const mergeRequest = await fetchGitLabMergeRequest(project, mergeRequestId, apiKey)
+        lastPayload = mergeRequest.payload
+        if (!mergeRequest.response.ok) {
+          return buildGitLabFailedResult(mergeRequest.response, mergeRequest.rawText, mergeRequest.payload, {
+            step: 'inspect',
+            mergeRequestId,
+            mergeRequestUrl,
+            payload: {
+              create: null,
+              merge: null,
+              inspect: mergeRequest.payload
+            }
+          })
         }
-      })
-    }
 
-    const result = buildGitLabMergeReadinessResult(mergeRequest.payload, mergeRequestId, mergeRequestUrl)
-    if (result) {
-      return result
-    }
+        const result = buildGitLabMergeReadinessResult(mergeRequest.payload, mergeRequestId, mergeRequestUrl)
+        if (result) {
+          return result
+        }
 
-    await delay(GITLAB_MERGE_STATUS_POLL_INTERVAL_MS)
+        if (attempt < maxAttempts) {
+          await delay(pollIntervalMs)
+        }
+      }
+
+      return null
+    }
+  )
+  if (pollResult) {
+    return pollResult
   }
+
+  return buildGitLabPollTimeoutResult('inspect', mergeRequestId, mergeRequestUrl, maxAttempts, lastPayload)
 }
 
 // 轮询 GitLab MR，直到异步冲突检查完成并得到可归档的最终状态。
-async function waitForGitLabMergeOutcome(project, mergeRequestId, mergeRequestUrl, apiKey) {
-  while (true) {
-    const mergeRequest = await fetchGitLabMergeRequest(project, mergeRequestId, apiKey)
-    if (!mergeRequest.response.ok) {
-      return buildGitLabFailedResult(mergeRequest.response, mergeRequest.rawText, mergeRequest.payload, {
-        step: 'inspect',
-        mergeRequestId,
-        mergeRequestUrl,
-        payload: {
-          create: null,
-          approve: null,
-          merge: null,
-          inspect: mergeRequest.payload
+async function waitForGitLabMergeOutcome(project, mergeRequestId, mergeRequestUrl, apiKey, options = {}) {
+  const maxAttempts = resolveMaxPollAttempts(options)
+  const pollIntervalMs = resolvePollIntervalMs(options)
+  let lastPayload = null
+
+  const pollResult = await withSpinner(
+    `等待 GitLab 完成远程合并 ${formatGitLabMergeRequestLabel(mergeRequestId, mergeRequestUrl)}`,
+    async () => {
+      for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        const mergeRequest = await fetchGitLabMergeRequest(project, mergeRequestId, apiKey)
+        lastPayload = mergeRequest.payload
+        if (!mergeRequest.response.ok) {
+          return buildGitLabFailedResult(mergeRequest.response, mergeRequest.rawText, mergeRequest.payload, {
+            step: 'inspect',
+            mergeRequestId,
+            mergeRequestUrl,
+            payload: {
+              create: null,
+              merge: null,
+              inspect: mergeRequest.payload
+            }
+          })
         }
-      })
-    }
 
-    const result = buildGitLabMergeStatusResult(mergeRequest.payload, mergeRequestId, mergeRequestUrl)
-    if (result) {
-      return result
-    }
+        const result = buildGitLabMergeStatusResult(mergeRequest.payload, mergeRequestId, mergeRequestUrl)
+        if (result) {
+          return result
+        }
+
+        if (attempt < maxAttempts) {
+          await delay(pollIntervalMs)
+        }
+      }
 
-    await delay(GITLAB_MERGE_STATUS_POLL_INTERVAL_MS)
+      return null
+    }
+  )
+  if (pollResult) {
+    return pollResult
   }
+
+  return buildGitLabPollTimeoutResult('inspect', mergeRequestId, mergeRequestUrl, maxAttempts, lastPayload)
 }
 
-// 根据创建 MR 的结果先执行审批，再提交自动合并，确保完整走完 GitLab 审批合并链路。
-async function processGitLabMergeRequest(project, createPayload, apiKey) {
+// 根据创建 MR 的结果提交自动合并，由 GitLab merge 接口按项目审批规则判定是否允许合并。
+async function processGitLabMergeRequest(project, createPayload, apiKey, options = {}) {
   const mergeRequestId = createPayload?.iid ? String(createPayload.iid) : ''
   const mergeRequestUrl = typeof createPayload?.web_url === 'string' ? createPayload.web_url : ''
 
@@ -400,56 +487,26 @@ async function processGitLabMergeRequest(project, createPayload, apiKey) {
       mergeRequestUrl,
       payload: {
         create: createPayload,
+        inspect: null,
         merge: null
       }
     }
   }
 
   const sourceSha = typeof createPayload?.sha === 'string' ? createPayload.sha.trim() : ''
-  const readinessResult = await waitForGitLabMergeReadiness(project, mergeRequestId, mergeRequestUrl, apiKey)
+  logger.success(`GitLab 合并请求已创建: ${formatGitLabMergeRequestLabel(mergeRequestId, mergeRequestUrl)}`)
+  const readinessResult = await waitForGitLabMergeReadiness(project, mergeRequestId, mergeRequestUrl, apiKey, options)
   if (!readinessResult.ok) {
     return {
       ...readinessResult,
       payload: {
         create: createPayload,
-        approve: null,
         merge: null,
         inspect: readinessResult.payload
       }
     }
   }
-
-  const approveRequestBody = {}
-  if (sourceSha) {
-    approveRequestBody.sha = sourceSha
-  }
-
-  const approveEndpoint = `${project.baseUrl}/api/v4/projects/${project.projectId}/merge_requests/${mergeRequestId}/approve`
-  const approveResult = await performGitLabJsonRequest(
-    approveEndpoint,
-    {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'PRIVATE-TOKEN': apiKey
-      },
-      body: JSON.stringify(approveRequestBody)
-    },
-    'GitLab 合并审批请求失败'
-  )
-
-  if (!approveResult.response.ok) {
-    return buildGitLabFailedResult(approveResult.response, approveResult.rawText, approveResult.payload, {
-      step: 'approve',
-      mergeRequestId,
-      mergeRequestUrl,
-      payload: {
-        create: createPayload,
-        approve: approveResult.payload,
-        merge: null
-      }
-    })
-  }
+  logger.success(`GitLab 合并前检查通过: ${formatGitLabMergeRequestLabel(mergeRequestId, mergeRequestUrl)}`)
 
   const mergeRequestBody = {
     auto_merge: true
@@ -459,17 +516,20 @@ async function processGitLabMergeRequest(project, createPayload, apiKey) {
   }
 
   const mergeEndpoint = `${project.baseUrl}/api/v4/projects/${project.projectId}/merge_requests/${mergeRequestId}/merge`
-  const mergeResult = await performGitLabJsonRequest(
-    mergeEndpoint,
-    {
-      method: 'PUT',
-      headers: {
-        'Content-Type': 'application/json',
-        'PRIVATE-TOKEN': apiKey
+  const mergeResult = await withSpinner(
+    `提交 GitLab 自动合并 ${formatGitLabMergeRequestLabel(mergeRequestId, mergeRequestUrl)}`,
+    () => performGitLabJsonRequest(
+      mergeEndpoint,
+      {
+        method: 'PUT',
+        headers: {
+          'Content-Type': 'application/json',
+          'PRIVATE-TOKEN': apiKey
+        },
+        body: JSON.stringify(mergeRequestBody)
       },
-      body: JSON.stringify(mergeRequestBody)
-    },
-    'GitLab 自动合并请求失败'
+      'GitLab 自动合并请求失败'
+    )
   )
 
   if (!mergeResult.response.ok) {
@@ -479,18 +539,17 @@ async function processGitLabMergeRequest(project, createPayload, apiKey) {
       mergeRequestUrl,
       payload: {
         create: createPayload,
-        approve: approveResult.payload,
         merge: mergeResult.payload
       }
     })
   }
 
-  const finalResult = await waitForGitLabMergeOutcome(project, mergeRequestId, mergeRequestUrl, apiKey)
+  logger.success(`GitLab 自动合并已提交: ${formatGitLabMergeRequestLabel(mergeRequestId, mergeRequestUrl)}`)
+  const finalResult = await waitForGitLabMergeOutcome(project, mergeRequestId, mergeRequestUrl, apiKey, options)
   return {
     ...finalResult,
     payload: {
       create: createPayload,
-      approve: approveResult.payload,
       merge: mergeResult.payload,
       inspect: finalResult.payload
     }
@@ -533,5 +592,5 @@ export async function requestGitLabRemoteMerge(options = {}) {
     })
   }
 
-  return processGitLabMergeRequest(project, payload, apiKey)
+  return processGitLabMergeRequest(project, payload, apiKey, options)
 }

package/src/core/tools/interactive.js

@@ -115,33 +115,22 @@ export async function chooseOne(message, choices, defaultIndex = 0) {
 }
 
 /**
- * 在给定选项中进行多选；非交互环境返回默认值集合。
- * 输入为提示文案、选项列表与多选配置，输出为选中的 value 数组或 null。
+ * 按选项顺序输出已选 value。
+ * 输入为选项与已选集合，输出为稳定顺序的 value 数组。
  */
-export async function chooseMany(message, choices, options = {}) {
-  if (!Array.isArray(choices) || choices.length === 0) {
-    throw new Error('chooseMany 需要至少一个可选项')
-  }
-
-  const parsedMin = Number(options.minSelections ?? 0)
-  const parsedMax = Number(options.maxSelections ?? choices.length)
-  const minSelections = Number.isFinite(parsedMin) ? Math.max(0, Math.floor(parsedMin)) : 0
-  const maxCap = Number.isFinite(parsedMax) ? Math.max(0, Math.floor(parsedMax)) : choices.length
-  const maxSelections = Math.max(minSelections, Math.min(choices.length, maxCap))
-  const doneLabel = options.doneLabel || '完成选择'
-  const cancelLabel = options.cancelLabel || '取消'
-  const defaultValues = Array.isArray(options.defaultValues) ? options.defaultValues : []
-  const defaultSet = new Set(defaultValues)
-  const selectedValues = choices
+function collectSelectedValues(choices, selected, maxSelections) {
+  return choices
     .map((choice) => choice.value)
-    .filter((value) => defaultSet.has(value))
+    .filter((value) => selected.has(value))
     .slice(0, maxSelections)
+}
 
-  if (!isInteractive()) {
-    return selectedValues
-  }
-
-  const selected = new Set(selectedValues)
+/**
+ * 使用旧版数字菜单进行多选，供不支持 raw mode 的终端回退。
+ * 输入为多选上下文，输出为已选 value 数组或 null。
+ */
+async function chooseManyByNumberInput(message, choices, context) {
+  const selected = new Set(context.selectedValues)
   const doneValue = '__prompt_done__'
   const cancelValue = '__prompt_cancel__'
 
@@ -152,14 +141,14 @@ export async function chooseMany(message, choices, options = {}) {
     }))
     menuChoices.push({
       value: doneValue,
-      label: `${doneLabel}（已选 ${selected.size} 项）`
+      label: `${context.doneLabel}（已选 ${selected.size} 项）`
     })
     menuChoices.push({
       value: cancelValue,
-      label: cancelLabel
+      label: context.cancelLabel
     })
 
-    const defaultChoiceValue = selected.size >= minSelections ? doneValue : choices[0].value
+    const defaultChoiceValue = selected.size >= context.minSelections ? doneValue : choices[0].value
     const resolvedDefaultIndex = Math.max(0, menuChoices.findIndex((item) => item.value === defaultChoiceValue))
     const selectedAction = await chooseOne(message, menuChoices, resolvedDefaultIndex)
 
@@ -168,14 +157,11 @@ export async function chooseMany(message, choices, options = {}) {
     }
 
     if (selectedAction === doneValue) {
-      if (selected.size < minSelections) {
-        stdout.write(`至少需要选择 ${minSelections} 项。\n`)
+      if (selected.size < context.minSelections) {
+        stdout.write(`至少需要选择 ${context.minSelections} 项。\n`)
         continue
       }
-      return choices
-        .map((choice) => choice.value)
-        .filter((value) => selected.has(value))
-        .slice(0, maxSelections)
+      return collectSelectedValues(choices, selected, context.maxSelections)
     }
 
     if (selected.has(selectedAction)) {
@@ -183,11 +169,200 @@ export async function chooseMany(message, choices, options = {}) {
       continue
     }
 
-    if (selected.size >= maxSelections) {
-      stdout.write(`最多只能选择 ${maxSelections} 项。\n`)
+    if (selected.size >= context.maxSelections) {
+      stdout.write(`最多只能选择 ${context.maxSelections} 项。\n`)
       continue
     }
 
     selected.add(selectedAction)
   }
 }
+
+/**
+ * 渲染 checkbox 多选列表。
+ * 输入为当前光标和选择状态，输出为本次渲染占用的行数。
+ */
+function renderCheckboxChoices(message, choices, context, cursorIndex, selected, statusMessage, renderedLines) {
+  if (renderedLines > 0) {
+    stdout.write(`\x1b[${renderedLines}F`)
+    stdout.write('\x1b[J')
+  }
+
+  const lines = [
+    message,
+    `↑/↓ 移动，Space 选中/取消，Enter ${context.doneLabel}，q ${context.cancelLabel}（已选 ${selected.size} 项）`
+  ]
+
+  if (statusMessage) {
+    lines.push(statusMessage)
+  }
+
+  choices.forEach((choice, index) => {
+    const cursor = index === cursorIndex ? '>' : ' '
+    const checkbox = selected.has(choice.value) ? '[x]' : '[ ]'
+    lines.push(`${cursor} ${checkbox} ${choice.label}`)
+  })
+
+  stdout.write(`${lines.join('\n')}\n`)
+  return lines.length
+}
+
+/**
+ * 使用键盘 checkbox 进行多选。
+ * 输入为多选上下文，输出为已选 value 数组或 null。
+ */
+function chooseManyByCheckbox(message, choices, context) {
+  const selected = new Set(context.selectedValues)
+  let cursorIndex = 0
+  let renderedLines = 0
+  let statusMessage = ''
+  let closed = false
+  const wasRaw = stdin.isRaw === true
+
+  return new Promise((resolve) => {
+    const finish = (value) => {
+      if (closed) {
+        return
+      }
+
+      closed = true
+      stdin.off('data', onData)
+      stdin.setRawMode(wasRaw)
+      stdin.pause()
+      resolve(value)
+    }
+
+    const render = () => {
+      renderedLines = renderCheckboxChoices(message, choices, context, cursorIndex, selected, statusMessage, renderedLines)
+    }
+
+    const moveCursor = (offset) => {
+      statusMessage = ''
+      cursorIndex = (cursorIndex + offset + choices.length) % choices.length
+      render()
+    }
+
+    const toggleCurrent = () => {
+      statusMessage = ''
+      const currentValue = choices[cursorIndex].value
+      if (selected.has(currentValue)) {
+        selected.delete(currentValue)
+        render()
+        return
+      }
+
+      if (selected.size >= context.maxSelections) {
+        statusMessage = `最多只能选择 ${context.maxSelections} 项。`
+        render()
+        return
+      }
+
+      selected.add(currentValue)
+      render()
+    }
+
+    const complete = () => {
+      if (selected.size < context.minSelections) {
+        statusMessage = `至少需要选择 ${context.minSelections} 项。`
+        render()
+        return
+      }
+      finish(collectSelectedValues(choices, selected, context.maxSelections))
+    }
+
+    function onData(chunk) {
+      const input = chunk.toString('utf8')
+
+      for (let index = 0; index < input.length; index += 1) {
+        if (closed) {
+          return
+        }
+
+        const sequence = input.slice(index, index + 3)
+        if (sequence === '\u001b[A') {
+          moveCursor(-1)
+          index += 2
+          continue
+        }
+
+        if (sequence === '\u001b[B') {
+          moveCursor(1)
+          index += 2
+          continue
+        }
+
+        const key = input[index]
+        if (key === '\u0003' || key === '\u001b' || key.toLowerCase() === 'q') {
+          finish(null)
+          return
+        }
+
+        if (key === '\r' || key === '\n') {
+          complete()
+          continue
+        }
+
+        if (key === ' ') {
+          toggleCurrent()
+          continue
+        }
+
+        if (key.toLowerCase() === 'k') {
+          moveCursor(-1)
+          continue
+        }
+
+        if (key.toLowerCase() === 'j') {
+          moveCursor(1)
+        }
+      }
+    }
+
+    stdin.setRawMode(true)
+    stdin.resume()
+    stdin.on('data', onData)
+    render()
+  })
+}
+
+/**
+ * 在给定选项中进行多选；非交互环境返回默认值集合。
+ * 输入为提示文案、选项列表与多选配置，输出为选中的 value 数组或 null。
+ */
+export async function chooseMany(message, choices, options = {}) {
+  if (!Array.isArray(choices) || choices.length === 0) {
+    throw new Error('chooseMany 需要至少一个可选项')
+  }
+
+  const parsedMin = Number(options.minSelections ?? 0)
+  const parsedMax = Number(options.maxSelections ?? choices.length)
+  const minSelections = Number.isFinite(parsedMin) ? Math.max(0, Math.floor(parsedMin)) : 0
+  const maxCap = Number.isFinite(parsedMax) ? Math.max(0, Math.floor(parsedMax)) : choices.length
+  const maxSelections = Math.max(minSelections, Math.min(choices.length, maxCap))
+  const doneLabel = options.doneLabel || '完成选择'
+  const cancelLabel = options.cancelLabel || '取消'
+  const defaultValues = Array.isArray(options.defaultValues) ? options.defaultValues : []
+  const defaultSet = new Set(defaultValues)
+  const selectedValues = choices
+    .map((choice) => choice.value)
+    .filter((value) => defaultSet.has(value))
+    .slice(0, maxSelections)
+
+  if (!isInteractive()) {
+    return selectedValues
+  }
+
+  const context = {
+    minSelections,
+    maxSelections,
+    doneLabel,
+    cancelLabel,
+    selectedValues
+  }
+
+  if (typeof stdin.setRawMode !== 'function') {
+    return chooseManyByNumberInput(message, choices, context)
+  }
+
+  return chooseManyByCheckbox(message, choices, context)
+}

package/src/core/tools/loading.js

@@ -1,9 +1,11 @@
 const SPINNER_FRAMES = ['-', '\\', '|', '/']
 
+// 判断当前进程是否适合渲染动态等待效果，输入为空，输出布尔值。
 function canRenderSpinner() {
   return Boolean(process.stderr.isTTY) && process.env.ICODE_NO_SPINNER !== '1'
 }
 
+// 清理当前终端行，输入为空，输出为空，仅在 TTY 中生效。
 function clearLine() {
   if (!canRenderSpinner()) {
     return
@@ -12,6 +14,7 @@ function clearLine() {
   process.stderr.write('\r\x1b[2K')
 }
 
+// 执行异步任务时展示等待动画，输入展示文案和任务函数，输出任务结果。
 export async function withSpinner(text, task) {
   if (!canRenderSpinner()) {
     return task()
@@ -21,7 +24,8 @@ export async function withSpinner(text, task) {
   const render = () => {
     const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length]
     frameIndex += 1
-    process.stderr.write(`\r[icode] ${frame} ${text}`)
+    clearLine()
+    process.stderr.write(`[icode] ${frame} ${text}`)
   }
 
   render()

package/src/core/tools/logger.js

@@ -25,6 +25,11 @@ function print(stream, level, message) {
 }
 
 export const logger = {
+  // 按指定颜色渲染短文本，输入颜色名和文本，输出可直接拼进日志的 ANSI 字符串。
+  color(color, message) {
+    return colorize(color, String(message ?? ''))
+  },
+
   setVerbose(enabled) {
     verboseEnabled = Boolean(enabled)
   },