@icode-js/icode 3.2.0 → 3.4.0

package/src/commands/continue.js

@@ -0,0 +1,104 @@
+import { parseCommandArgs, printJson } from '../core/cli/output.js'
+import { c, print, renderBranchResults } from '../core/cli/render.js'
+import { confirm, isInteractiveTerminal } from '../core/tools/interactive.js'
+import { logger } from '../core/tools/logger.js'
+import { inspectPausedWork, runAbortWorkflow, runContinueWorkflow } from '../workflows/continue-workflow.js'
+
+const RESULT_LABELS = {
+  pushed: '已推送',
+  'merged-and-pushed': '已合并并推送',
+  'force-pushed': '已强推',
+  'skipped-protected': '已跳过（受保护分支）',
+  synced: '已同步',
+  'synced-and-pushed': '已同步并推送',
+  missing: '本地和远程都不存在'
+}
+
+function printContinueHelp() {
+  process.stdout.write(`
+Usage:
+  icode continue [options]
+
+解决冲突后继续刚才被打断的操作：
+  1. 检查冲突文件里是否还有 <<<<<<< / >>>>>>> 标记，有就列出文件和行号
+  2. 自动 git add 已解决的文件
+  3. 继续 merge / rebase / cherry-pick / revert
+  4. 如果是 push / migrate / sync 中途冲突，接着把剩下的步骤做完（推送、处理剩余分支、切回原分支）
+
+Options:
+  --json                 输出机器可读 JSON
+  --repo-mode <mode>     仓库模式: auto | strict
+  -h, --help             查看帮助
+`)
+}
+
+function printAbortHelp() {
+  process.stdout.write(`
+Usage:
+  icode abort [options]
+
+放弃刚才被冲突打断的操作：中止 merge / rebase / cherry-pick / revert，并切回原分支。
+已经推送成功的分支不会被撤回。
+
+Options:
+  -y, --yes              不再确认
+  --json                 输出机器可读 JSON
+  --repo-mode <mode>     仓库模式: auto | strict
+  -h, --help             查看帮助
+`)
+}
+
+export async function runContinueCommand(rawArgs) {
+  const { values } = parseCommandArgs(rawArgs)
+  if (values.help) {
+    printContinueHelp()
+    return
+  }
+
+  const result = await runContinueWorkflow({ repoMode: values['repo-mode'], silentLog: values.json })
+  if (values.json) {
+    printJson(result)
+    return result
+  }
+
+  if (result.summary.length) {
+    print('')
+    renderBranchResults(result.summary, RESULT_LABELS)
+    print('')
+  }
+  if (result.resumed) {
+    logger.success(`${result.description} 已全部完成${result.returnedTo ? c.gray(`，已切回 ${result.returnedTo}`) : ''}`)
+  }
+  return result
+}
+
+export async function runAbortCommand(rawArgs) {
+  const { values } = parseCommandArgs(rawArgs)
+  if (values.help) {
+    printAbortHelp()
+    return
+  }
+
+  if (!values.yes && !values.json && isInteractiveTerminal()) {
+    const paused = await inspectPausedWork({ repoMode: values['repo-mode'] })
+    if (paused) {
+      const accepted = await confirm(`放弃 ${paused.description}？冲突处理到一半的改动会丢弃`, false)
+      if (!accepted) {
+        logger.hint('已保留现场。处理完冲突后执行 icode continue。')
+        return
+      }
+    }
+  }
+
+  const result = await runAbortWorkflow({ repoMode: values['repo-mode'] })
+  if (values.json) {
+    printJson(result)
+    return result
+  }
+
+  logger.success(`已放弃 ${result.description || result.operation}${result.returnedTo ? c.gray(`，已切回 ${result.returnedTo}`) : ''}`)
+  if (result.done.length) {
+    logger.hint(`这些分支在中断前已推送，不会撤回: ${result.done.join(', ')}`)
+  }
+  return result
+}

package/src/commands/doctor.js

@@ -1,6 +1,6 @@
 import { parseArgs } from 'node:util'
 import { normalizeLegacyArgs } from '../core/cli/args.js'
-import { logger } from '../core/tools/logger.js'
+import { keyValues, print, renderChecks, renderOverallStatus, title, ui } from '../core/cli/render.js'
 import { runDoctorWorkflow } from '../workflows/doctor-workflow.js'
 
 // 输出 doctor 子命令帮助，输入为空，输出标准帮助文本。
@@ -15,31 +15,10 @@ Options:
   -h, --help             查看帮助
 
 Notes:
-  检查 Git、origin、hooks、AI profile 与远程合并配置，并给出修复建议。
+  检查 Git、当前 remote、hooks、AI profile 与平台 token，并给出修复建议。
 `)
 }
 
-// 根据检查状态选择输出函数，输入状态，输出 logger 方法。
-function resolveLogMethod(status) {
-  if (status === 'fail') {
-    return logger.error
-  }
-  if (status === 'warn') {
-    return logger.warn
-  }
-  return logger.success
-}
-
-// 输出单条 doctor 检查结果，输入检查项，输出彩色日志。
-function printCheck(check) {
-  const log = resolveLogMethod(check.status).bind(logger)
-  const statusLabel = check.status.toUpperCase()
-  log(`[${statusLabel}] ${check.title}: ${check.detail}`)
-  if (check.suggestion) {
-    logger.info(`建议: ${check.suggestion}`)
-  }
-}
-
 // 执行 doctor 子命令，输入原始参数，输出健康检查结果。
 // 执行 doctor 子命令，输入原始参数，输出健康检查结果；参数会先归一化。
 export async function runDoctorCommand(rawArgs) {
@@ -68,13 +47,20 @@ export async function runDoctorCommand(rawArgs) {
     return result
   }
 
-  logger.info(`仓库根目录: ${result.context.topLevelPath}`)
-  logger.info(`配置文件: ${result.configPath}`)
-  result.checks.forEach((check) => {
-    printCheck(check)
-  })
+  print(title('icode doctor'))
+  print(keyValues([
+    ['仓库', ui.path(result.context.topLevelPath)],
+    ['remote', ui.remote(result.context.remote || 'origin')],
+    ['配置文件', ui.path(result.configPath)]
+  ]))
+  print('')
+  renderChecks(result.checks)
 
   const summary = result.summary
-  logger.info(`doctor 完成: pass=${summary.pass}, warn=${summary.warn}, fail=${summary.fail}`)
+  renderOverallStatus(summary.fail ? 'fail' : summary.warn ? 'warn' : 'pass', {
+    通过: summary.pass,
+    注意: summary.warn,
+    失败: summary.fail
+  })
   return result
 }

package/src/commands/help.js

@@ -7,60 +7,80 @@ export function printMainHelp() {
 icode v3 - Git workflow CLI
 
 Usage:
-  icode <command> [options]
+  icode [global options] <command> [options]
 
-Commands:
-  ai          AI 助手能力（提交信息/冲突建议/代码评审）
-  codereview  AI 代码评审（不带 ai 前缀）
-  checkout    切换/创建分支（本地/远程自动识别）
+日常:
   ready       检查仓库是否适合继续 save/push（适合 AI agent 读取）
-  save        安全快速提交本地改动（检查 + add + commit）
-  push        提交并推送，可合并到多个目标分支
+  save        安全提交（风险扫描 + add + commit），可只提交指定路径
+  push        提交并推送，可合并到多个目标分支；--force 安全强推
+  sw          快速切换分支（模糊匹配 / 最近使用 / 切回上一个）
+  checkout    切换/创建分支（本地/远程自动识别）
+  stash       查看、暂存、恢复 stash
+  log         更易读的提交历史（--mine / --unpushed / --file）
   sync        批量同步分支（fetch + pull）
-  clean       清理已合并分支（可删远程）
-  undo        向导式撤销/回滚（revert/reset）
+
+整理历史:
+  amend       修改上一个提交（追加改动 / 改提交信息）
+  fixup       把改动合进更早的某个提交（自动 autosquash）
   migrate     迁移分支提交（cherry-pick）
-  tag         创建并推送 tag（支持自动命名）
-  config      查看和修改本地配置（含 AI profile）
-  doctor      检查 Git/AI/远程合并配置健康状态
+  clean       清理已合并 / 远程已删除 / 长期未动的分支
+
+兜底:
+  continue    冲突解决后继续（自动暂存，并接着完成被打断的 push/migrate/sync）
+  abort       放弃被冲突打断的操作并切回原分支
+  undo        向导式撤销/回滚（revert/reset）
+  rescue      找回恢复点和 reflog 里的提交
+
+协作与发布:
+  pr          创建/查看/检出/合并 PR、MR（GitHub/GitLab/Gitee/Gitea）
+  open        在浏览器打开仓库、分支、文件、PR、CI
+  tag         创建并推送 tag（日期命名或语义化版本）
+  release     一条命令发版（版本号 + changelog + tag + 平台 Release）
+
+AI:
+  ai          AI 助手能力（提交信息/冲突建议/代码评审）
+  codereview  AI 代码评审（不带 ai 前缀）
   explain     AI 解释 Git diff（自然语言）
+
+配置与环境:
+  config      查看和修改本地配置（AI profile / 平台 token / 受保护分支）
+  doctor      检查 Git/AI/平台配置健康状态
   info        查看当前 git 与配置环境
   completion  生成 bash/zsh tab 补全脚本
   help        查看帮助（命令总览）
 
 Global options:
+  -R, --remote <name>    指定使用的 remote（默认按 upstream / .icoderc / origin 自动选择）
   -d, --debug            开启调试日志（输出更多细节）
   -h, --help             查看帮助
 
 Tips:
+  直接运行 icode 会显示常用操作菜单；多数命令不带参数时会给出可选项，方向键选择即可。
   icode <command> -h     查看子命令完整参数说明
+  大多数命令支持 --json，便于脚本和 AI agent 读取；出错时也会输出 {"ok":false,...}
+  会改写历史或删除分支的操作都会自动创建恢复点，可用 icode rescue 找回。
+  仓库根目录的 .icoderc.json 可以共享 remote、主分支、受保护分支和提交扫描规则。
 
 Examples:
-  icode checkout feature/login main --push-origin
   icode ready
-  icode ready --json
   icode save -m "feat: add login form"
-  icode save --ai-commit -y
-  icode save -m "fix: adjust copy" --dry-run
-  icode ai commit --apply -y
-  icode ai codereview
-  icode codereview --base origin/main --head HEAD
-  icode explain --base origin/main --head HEAD
+  icode save -m "fix: typo" src/login.vue
+  icode sw login
   icode push release test -m "feat: batch publish" -y
-  icode push release test --ai-commit -y
-  icode push release test -m "feat: keep merge commit" --local-merge -y
-  icode push release test --dry-run
-  icode sync --all-local --merge-main
-  icode clean --remote --force -y
-  icode undo a1b2c3d --mode revert -y
-  icode undo --mode revert --ref HEAD~1 -y
-  icode undo --recover abort
-  icode migrate feature/login release --push -y
-  icode migrate --interactive
-  icode push --no-verify -m "chore: bypass hooks"
-  icode config protect add main release
-  icode doctor
+  icode push --force -y
+  icode amend -a
+  icode fixup -a
+  icode log --unpushed
+  icode stash save -m "wip"
+  icode clean --gone -y
+  icode continue
+  icode undo --mode hard --ref HEAD~1
+  icode rescue
+  icode pr create --ai
+  icode open src/cli.js:42
+  icode release --dry-run
+  icode --remote upstream sync
+  icode config platform token set github <token>
   source <(icode completion zsh)
-  icode info
 `)
 }

package/src/commands/history.js

@@ -0,0 +1,147 @@
+import { parseCommandArgs, printJson } from '../core/cli/output.js'
+import { c, ui } from '../core/cli/render.js'
+import { isInteractiveTerminal } from '../core/tools/interactive.js'
+import { logger } from '../core/tools/logger.js'
+import { runAmendWorkflow, runFixupWorkflow } from '../workflows/history-workflow.js'
+
+const SHARED_OPTIONS = {
+  all: { type: 'boolean', short: 'a', default: false },
+  'allow-risky': { type: 'boolean', default: false },
+  'no-verify': { type: 'boolean', default: false }
+}
+
+function printAmendHelp() {
+  process.stdout.write(`
+Usage:
+  icode amend [path...] [options]
+
+Arguments:
+  [path...]              把这些路径的改动追加到上一个提交
+
+Options:
+  -m, --message <msg>    修改上一个提交的信息
+  -a, --all              追加全部未提交改动
+  --allow-risky          检测到敏感文件/疑似密钥/大文件时仍继续
+  --no-verify            跳过 hook 校验
+  --json                 输出机器可读 JSON
+  -y, --yes              已推送时也不再确认
+  --repo-mode <mode>     仓库模式: auto | strict
+  -h, --help             查看帮助
+
+Notes:
+  不传 -a 或路径时只追加已暂存的改动。上一个提交已推送时会提示，之后需要 icode push --force。
+  执行前会自动创建恢复点。
+
+Examples:
+  icode amend -a
+  icode amend -m "feat: 更准确的描述"
+  icode amend src/login.js
+`)
+}
+
+function printFixupHelp() {
+  process.stdout.write(`
+Usage:
+  icode fixup [commit] [options]
+
+Arguments:
+  [commit]               要修正的提交；不传则从当前分支未合入主分支的提交里选择
+
+Options:
+  -a, --all              先暂存全部未提交改动
+  --no-rebase            只生成 fixup! 提交，不自动整理历史
+  --allow-risky          检测到敏感文件/疑似密钥/大文件时仍继续
+  --no-verify            跳过 hook 校验
+  --json                 输出机器可读 JSON
+  -y, --yes              已推送时也不再确认
+  --repo-mode <mode>     仓库模式: auto | strict
+  -h, --help             查看帮助
+
+Notes:
+  等同于 git commit --fixup=<commit> && git rebase -i --autosquash（不会打开编辑器）。
+  发生冲突时用 icode continue / icode abort 处理。执行前会自动创建恢复点。
+
+Examples:
+  icode fixup -a
+  icode fixup a1b2c3d
+`)
+}
+
+function printForceHint(result) {
+  if (result.needsForcePush) {
+    logger.warn('改写的提交之前已推送，更新远程请执行: icode push --force')
+  }
+}
+
+export async function runAmendCommand(rawArgs) {
+  const { values, positionals } = parseCommandArgs(rawArgs, {
+    ...SHARED_OPTIONS,
+    message: { type: 'string', short: 'm' }
+  })
+  if (values.help) {
+    printAmendHelp()
+    return
+  }
+
+  const result = await runAmendWorkflow({
+    message: values.message,
+    all: values.all,
+    paths: positionals,
+    interactive: !values.json && !values.yes && isInteractiveTerminal(),
+    allowRisky: values['allow-risky'],
+    noVerify: values['no-verify'],
+    yes: values.yes,
+    repoMode: values['repo-mode'],
+    silentLog: values.json
+  })
+
+  if (values.json) {
+    printJson(result)
+    return result
+  }
+  if (result.canceled) {
+    logger.warn('已取消。')
+    return result
+  }
+  logger.success(`已修改上一个提交 ${ui.hash(result.previousCommitId)} ${c.gray('→')} ${ui.hash(result.commitId)}  ${ui.subject(result.message.split('\n')[0])}`)
+  printForceHint(result)
+  return result
+}
+
+export async function runFixupCommand(rawArgs) {
+  const { values, positionals } = parseCommandArgs(rawArgs, {
+    ...SHARED_OPTIONS,
+    'no-rebase': { type: 'boolean', default: false }
+  })
+  if (values.help) {
+    printFixupHelp()
+    return
+  }
+
+  const result = await runFixupWorkflow({
+    commit: positionals[0],
+    all: values.all,
+    noRebase: values['no-rebase'],
+    allowRisky: values['allow-risky'],
+    noVerify: values['no-verify'],
+    yes: values.yes,
+    repoMode: values['repo-mode'],
+    silentLog: values.json
+  })
+
+  if (values.json) {
+    printJson(result)
+    return result
+  }
+  if (result.canceled) {
+    logger.warn('已取消。')
+    return result
+  }
+  if (result.rebased) {
+    logger.success(`已把改动合进提交 ${ui.hash(result.target)}`)
+  } else {
+    logger.success(`已创建 fixup 提交 ${result.fixupCommit}（目标 ${result.target}），之后可执行 git rebase -i --autosquash`)
+  }
+  printForceHint(result)
+  return result
+}

package/src/commands/info.js

@@ -1,6 +1,7 @@
 import { parseArgs } from 'node:util'
 import { normalizeLegacyArgs } from '../core/cli/args.js'
-import { logger } from '../core/tools/logger.js'
+import { printJson } from '../core/cli/output.js'
+import { c, keyValues, print, title, ui } from '../core/cli/render.js'
 import { runInfoWorkflow } from '../workflows/info-workflow.js'
 
 function printHelp() {
@@ -10,6 +11,7 @@ Usage:
 
 Options:
   --repo-mode <mode>     仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --json                 输出机器可读 JSON
   -h, --help             查看帮助
 
 Notes:
@@ -25,6 +27,7 @@ export async function runInfoCommand(rawArgs) {
     allowPositionals: true,
     options: {
       'repo-mode': { type: 'string', default: 'auto' },
+      json: { type: 'boolean', default: false },
       help: { type: 'boolean', short: 'h', default: false }
     }
   })
@@ -46,15 +49,47 @@ export async function runInfoCommand(rawArgs) {
     inheritedFromParent: result.context.inheritedFromParent,
     currentBranch: result.context.currentBranch,
     defaultBranch: result.context.defaultBranch,
+    remote: result.context.remote,
+    remoteSource: result.context.remoteSource,
+    remotes: result.context.remotes,
+    repoConfigFile: result.context.repoConfig?.filePath || '',
     hookPath: result.context.hookPath,
     hasHookPath: result.context.hasHookPath,
     hasHuskyFolder: result.context.hasHuskyFolder,
     isSubmodule: result.context.isSubmodule,
     superprojectPath: result.context.superprojectPath,
-    protectedBranches: result.repoPolicy.protectedBranches || [],
+    protectedBranches: [...new Set([...(result.repoPolicy.protectedBranches || []), ...(result.context.repoConfig?.protectedBranches || [])])],
     ai: result.aiConfig
   }
 
-  process.stdout.write(`${JSON.stringify(infoBlock, null, 2)}\n`)
-  logger.success('info 输出完成')
+  if (parsed.values.json) {
+    printJson(infoBlock)
+    return infoBlock
+  }
+
+  const remoteSourceLabel = {
+    option: '命令行参数', env: '环境变量', 'repo-config': '.icoderc.json', config: '全局配置',
+    upstream: '分支 upstream', default: '默认', 'first-remote': '第一个 remote'
+  }[infoBlock.remoteSource] || infoBlock.remoteSource
+
+  print(title('仓库'))
+  print(keyValues([
+    ['根目录', ui.path(infoBlock.repoRoot)],
+    ['当前目录', infoBlock.inheritedFromParent ? `${ui.path(infoBlock.cwd)} ${c.yellow('(继承父级仓库)')}` : ''],
+    ['当前分支', infoBlock.currentBranch ? ui.branch(infoBlock.currentBranch) : c.red('DETACHED')],
+    ['主分支', ui.branch(infoBlock.defaultBranch)],
+    ['remote', `${ui.remote(infoBlock.remote)} ${c.gray(`(${remoteSourceLabel})`)}${infoBlock.remotes?.length > 1 ? c.gray(`  可用: ${infoBlock.remotes.join(', ')}`) : ''}`],
+    ['受保护分支', infoBlock.protectedBranches.length ? infoBlock.protectedBranches.map(ui.branch).join(', ') : c.gray('无')],
+    ['子模块', infoBlock.isSubmodule ? `是，父仓库 ${ui.path(infoBlock.superprojectPath)}` : '']
+  ]))
+  print('')
+  print(title('环境'))
+  print(keyValues([
+    ['Git', infoBlock.gitVersion.replace(/^git version /, '')],
+    ['Hooks', infoBlock.hasHuskyFolder ? c.green('husky') : infoBlock.hasHookPath ? `${c.green('已配置')} ${c.gray(infoBlock.hookPath)}` : c.gray('未检测到')],
+    ['AI profile', infoBlock.ai.activeProfile ? `${c.green(infoBlock.ai.activeProfile)} ${c.gray(`(共 ${infoBlock.ai.profileCount} 个)`)}` : c.gray('未配置')],
+    ['全局配置', ui.path(infoBlock.configPath)],
+    ['仓库配置', infoBlock.repoConfigFile ? ui.path(infoBlock.repoConfigFile) : c.gray('无（icode config init 生成）')]
+  ]))
+  return infoBlock
 }

package/src/commands/log.js

@@ -0,0 +1,142 @@
+import { IcodeError } from '../core/errors.js'
+import { parseCommandArgs, printJson } from '../core/cli/output.js'
+import { renderCommits } from '../core/cli/render.js'
+import { runCommand } from '../core/commands/shell.js'
+import { resolveGitContext } from '../core/git/context.js'
+import { GitService } from '../core/git/service.js'
+import { logger } from '../core/tools/logger.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode log [range] [options]
+
+Arguments:
+  [range]                提交范围或分支，例如 main..HEAD、origin/main、v1.2.0..
+
+Options:
+  -n, --limit <n>        显示条数（默认 20）
+  --mine                 只看自己的提交（按 git config user.email）
+  --author <name>        按作者过滤
+  --since <date>         起始时间，例如 "2 weeks ago"、2026-10-01
+  --grep <text>          按提交信息过滤（忽略大小写）
+  --file <path>          只看某个文件的历史（跟踪重命名）
+  --unpushed             只看还没推送到远程的提交
+  --no-merges            不显示 merge commit
+  --graph                显示分支图（调用 git log --graph）
+  --json                 输出机器可读 JSON
+  --repo-mode <mode>     仓库模式: auto | strict
+  -h, --help             查看帮助
+
+Examples:
+  icode log
+  icode log --mine --since "1 week ago"
+  icode log --unpushed
+  icode log --file src/cli.js -n 5
+  icode log main..HEAD --json
+`)
+}
+
+function parseLimit(value) {
+  if (value == null) {
+    return 20
+  }
+  const number = Number(value)
+  if (!Number.isInteger(number) || number <= 0) {
+    throw new IcodeError('--limit 需要正整数', { code: 'LOG_LIMIT_INVALID', exitCode: 2 })
+  }
+  return number
+}
+
+/**
+ * 解析 --unpushed 对应的范围：有 upstream 用 @{u}..HEAD，否则用 <remote>/<默认分支>..HEAD。
+ */
+async function resolveUnpushedRange(git, context) {
+  const upstream = await git.getUpstreamRef()
+  if (upstream) {
+    return `${upstream}..HEAD`
+  }
+  const fallback = git.remoteRef(context.defaultBranch)
+  if (await git.refExists(fallback)) {
+    return `${fallback}..HEAD`
+  }
+  return 'HEAD'
+}
+
+export async function runLogCommand(rawArgs) {
+  const { values, positionals } = parseCommandArgs(rawArgs, {
+    limit: { type: 'string', short: 'n' },
+    mine: { type: 'boolean', default: false },
+    author: { type: 'string' },
+    since: { type: 'string' },
+    grep: { type: 'string' },
+    file: { type: 'string' },
+    unpushed: { type: 'boolean', default: false },
+    'no-merges': { type: 'boolean', default: false },
+    graph: { type: 'boolean', default: false }
+  })
+
+  if (values.help) {
+    printHelp()
+    return
+  }
+
+  const context = await resolveGitContext({ repoMode: values['repo-mode'] })
+  const git = new GitService(context)
+  const limit = parseLimit(values.limit)
+
+  let author = values.author || ''
+  if (values.mine) {
+    author = (await git.getConfigValue('user.email')) || (await git.getConfigValue('user.name'))
+    if (!author) {
+      throw new IcodeError('未配置 git user.email，无法使用 --mine。', { code: 'LOG_USER_UNKNOWN', exitCode: 2 })
+    }
+  }
+
+  const range = values.unpushed ? await resolveUnpushedRange(git, context) : positionals[0] || ''
+
+  if (values.graph && !values.json) {
+    // 分支图直接交给 git 渲染，颜色和对齐都更可靠。
+    const args = ['log', '--graph', '--color=always', '--format=%C(yellow)%h%C(reset) %C(cyan)%ar%C(reset) %C(green)%an%C(reset)%C(auto)%d%C(reset) %s', `-${limit}`]
+    if (author) {
+      args.push(`--author=${author}`)
+    }
+    if (values.since) {
+      args.push(`--since=${values.since}`)
+    }
+    if (range) {
+      args.push(range)
+    } else {
+      args.push('--all')
+    }
+    const result = await runCommand('git', args, { cwd: context.topLevelPath })
+    process.stdout.write(result.stdout)
+    return
+  }
+
+  const entries = await git.logEntries({
+    range,
+    limit,
+    author,
+    since: values.since,
+    grep: values.grep,
+    file: values.file,
+    noMerges: values['no-merges']
+  })
+
+  if (values.json) {
+    printJson({ range, commits: entries })
+    return entries
+  }
+
+  if (!entries.length) {
+    logger.info(values.unpushed ? '没有未推送的提交。' : '没有匹配的提交。')
+    return entries
+  }
+
+  renderCommits(entries)
+  if (entries.length === limit) {
+    logger.hint(`只显示最近 ${limit} 条，可用 -n 调整`)
+  }
+  return entries
+}