@icode-js/icode 3.2.0 → 3.4.0

package/src/workflows/history-workflow.js

@@ -0,0 +1,211 @@
+import { IcodeError } from '../core/errors.js'
+import { createBackup } from '../core/git/backup.js'
+import { resolveGitContext } from '../core/git/context.js'
+import { assertNoRiskyFiles, inspectPendingFiles } from '../core/git/file-guard.js'
+import { assertNoConflictedFiles, assertNoPendingOperation, assertOnBranch, readGitSafetyState } from '../core/git/preconditions.js'
+import { GitService } from '../core/git/service.js'
+import { chooseOne, confirm, input, isInteractiveTerminal } from '../core/tools/interactive.js'
+import { logger } from '../core/tools/logger.js'
+
+// 改写历史类操作：amend（修改上一个提交）与 fixup（把改动合进更早的提交）。
+
+async function prepare(options, commandName) {
+  const context = await resolveGitContext({ cwd: options.cwd, repoMode: options.repoMode, remote: options.remote })
+  const git = new GitService(context)
+  const state = await readGitSafetyState(git)
+  const code = commandName.toUpperCase()
+  assertOnBranch(state.currentBranch, commandName, `${code}_DETACHED_HEAD`)
+  assertNoPendingOperation(state.operation, commandName, `${code}_GIT_OPERATION_IN_PROGRESS`)
+  assertNoConflictedFiles(state.changes, commandName, `${code}_CONFLICTED_FILES`)
+  return { context, git, state }
+}
+
+/**
+ * 判断提交是否已经推送到 upstream（或当前 remote 的同名分支）。
+ * 改写已推送的提交后需要强推，这里提前提示。
+ */
+async function isCommitPublished(git, sha, branchName) {
+  const upstream = (await git.getUpstreamRef()) || (await git.refExists(git.remoteRef(branchName)) ? git.remoteRef(branchName) : '')
+  if (!upstream) {
+    return { published: false, upstream: '' }
+  }
+  return { published: await git.isAncestor(sha, upstream), upstream }
+}
+
+async function confirmRewritePublished(options, upstream, what) {
+  const message = `${what}已推送到 ${upstream}，改写后需要执行 icode push --force 才能更新远程。`
+  if (options.yes) {
+    logger.warn(message)
+    return true
+  }
+  if (!isInteractiveTerminal()) {
+    throw new IcodeError(`${message} 确认要继续请加 -y。`, { code: 'HISTORY_REWRITE_PUBLISHED', exitCode: 2 })
+  }
+  return confirm(`${message} 是否继续？`, false)
+}
+
+// 按选项暂存改动：-a 全部，传路径只暂存这些路径，否则只用已暂存的改动。
+async function stageForRewrite(git, context, options) {
+  const paths = (options.paths || []).filter(Boolean)
+  const mode = options.all ? 'all' : paths.length ? 'paths' : 'staged'
+  const { findings } = await inspectPendingFiles(git, context, { mode: mode === 'paths' ? 'all' : mode, paths })
+  assertNoRiskyFiles(findings, options.commandName, `${options.commandName.toUpperCase()}_RISKY_FILES`, options.allowRisky === true)
+
+  if (mode === 'all') {
+    await git.stageAll()
+  } else if (mode === 'paths') {
+    await git.stagePaths(paths)
+  }
+  return git.hasStagedChanges()
+}
+
+/**
+ * 修改上一个提交：可追加改动（暂存区 / -a / 路径）和/或改提交信息。
+ * 输出 { commitId, previousCommitId, published, backupId }。
+ */
+export async function runAmendWorkflow(options = {}) {
+  const { context, git, state } = await prepare(options, 'amend')
+  const headSha = await git.revParse('HEAD')
+  if (!headSha) {
+    throw new IcodeError('仓库还没有提交，无法 amend。', { code: 'AMEND_NO_COMMIT', exitCode: 2 })
+  }
+
+  const { published, upstream } = await isCommitPublished(git, headSha, state.currentBranch)
+  if (published && !(await confirmRewritePublished(options, upstream, '上一个提交'))) {
+    return { canceled: true }
+  }
+
+  // 交互终端里没给 -a / 路径 / -m 且暂存区为空时，直接让用户选要做什么。
+  if (options.interactive && !options.all && !(options.paths || []).length && !String(options.message || '').trim() && !(await git.hasStagedChanges())) {
+    const current = await git.getCommitMessage('HEAD')
+    const hasChanges = !state.changes.clean
+    const action = await chooseOne('要怎么修改上一个提交？', [
+      ...(hasChanges ? [{ value: 'all', label: '追加全部未提交改动', hint: `${state.changes.total} 个文件` }] : []),
+      { value: 'reword', label: '只改提交信息', hint: current?.subject || '' },
+      ...(hasChanges ? [{ value: 'both', label: '追加改动并修改提交信息' }] : []),
+      { value: 'cancel', label: '取消' }
+    ], 0, { filter: false })
+    if (action === 'cancel') {
+      return { canceled: true }
+    }
+    if (action === 'all' || action === 'both') {
+      options = { ...options, all: true }
+    }
+    if (action === 'reword' || action === 'both') {
+      options = { ...options, message: await input('新的提交信息', current?.subject || '') }
+    }
+  }
+
+  const hasStaged = await stageForRewrite(git, context, { ...options, commandName: 'amend' })
+  const newMessage = String(options.message || '').trim()
+  if (!hasStaged && !newMessage) {
+    throw new IcodeError('没有要追加的改动，也没有新的提交信息。用 -a 追加全部改动，或 -m 修改提交信息。', {
+      code: 'AMEND_NOTHING_TO_DO',
+      exitCode: 2
+    })
+  }
+
+  const previous = await git.getCommitMessage('HEAD')
+  const message = newMessage || [previous?.subject, previous?.body].filter(Boolean).join('\n\n')
+  const backup = await createBackup(git, { reason: `amend ${state.currentBranch}`, silent: options.silentLog })
+
+  await git.commit(message, { amend: true, noVerify: options.noVerify })
+
+  return {
+    branch: state.currentBranch,
+    previousCommitId: headSha.slice(0, 8),
+    commitId: await git.revParseShort('HEAD'),
+    message,
+    published,
+    needsForcePush: published,
+    backupId: backup.entries.length ? backup.id : '',
+    repoRoot: context.topLevelPath
+  }
+}
+
+// fixup 候选：当前分支上还没进入主分支的提交（不含 merge commit）。
+async function listFixupCandidates(git, context) {
+  const baseCandidates = [git.remoteRef(context.defaultBranch), context.defaultBranch]
+  let range = ''
+  for (const base of baseCandidates) {
+    if (base && await git.refExists(base)) {
+      range = `${base}..HEAD`
+      break
+    }
+  }
+  const entries = await git.logEntries({ range: range || 'HEAD', limit: 30, noMerges: true })
+  return entries
+}
+
+/**
+ * 把改动合进更早的某个提交：git commit --fixup + rebase --autosquash（不打开编辑器）。
+ * 输入为 { commit, all, paths, noRebase }，输出 { target, fixupCommit, rebased, backupId }。
+ */
+export async function runFixupWorkflow(options = {}) {
+  const { context, git, state } = await prepare(options, 'fixup')
+
+  let targetRef = String(options.commit || '').trim()
+  if (!targetRef) {
+    const candidates = await listFixupCandidates(git, context)
+    if (!candidates.length) {
+      throw new IcodeError('当前分支没有可 fixup 的提交（都已在主分支里）。可以直接指定: icode fixup <commit>', {
+        code: 'FIXUP_NO_CANDIDATES',
+        exitCode: 2
+      })
+    }
+    if (options.yes || !isInteractiveTerminal()) {
+      throw new IcodeError('请指定要修正的提交: icode fixup <commit>', { code: 'FIXUP_TARGET_REQUIRED', exitCode: 2 })
+    }
+    targetRef = await chooseOne('把改动合进哪个提交？', candidates.map((item) => ({
+      value: item.hash,
+      label: `${item.shortHash}  ${item.relativeDate}  ${item.subject}`
+    })), 0)
+  }
+
+  const targetSha = await git.revParse(targetRef)
+  if (!targetSha) {
+    throw new IcodeError(`提交不存在: ${targetRef}`, { code: 'FIXUP_TARGET_NOT_FOUND', exitCode: 2 })
+  }
+  if (!(await git.isAncestor(targetSha, 'HEAD'))) {
+    throw new IcodeError(`${targetRef} 不在当前分支历史上。`, { code: 'FIXUP_TARGET_NOT_ANCESTOR', exitCode: 2 })
+  }
+
+  const { published, upstream } = await isCommitPublished(git, targetSha, state.currentBranch)
+  if (published && !options.noRebase && !(await confirmRewritePublished(options, upstream, '目标提交'))) {
+    return { canceled: true }
+  }
+
+  const hasStaged = await stageForRewrite(git, context, { ...options, commandName: 'fixup' })
+  if (!hasStaged) {
+    throw new IcodeError('暂存区没有改动。先 git add，或用 -a 暂存全部改动。', { code: 'FIXUP_NOTHING_STAGED', exitCode: 2 })
+  }
+
+  const backup = await createBackup(git, { reason: `fixup ${targetSha.slice(0, 8)} on ${state.currentBranch}`, silent: options.silentLog })
+  await git.commitFixup(targetSha, { noVerify: options.noVerify })
+  const fixupCommit = await git.revParseShort('HEAD')
+
+  if (options.noRebase) {
+    return { target: targetSha.slice(0, 8), fixupCommit, rebased: false, backupId: backup.id, repoRoot: context.topLevelPath }
+  }
+
+  const parentSha = await git.revParse(`${targetSha}^`)
+  try {
+    await git.rebaseOnto(parentSha, { autosquash: true, autostash: true, root: !parentSha })
+  } catch (error) {
+    throw new IcodeError(
+      'fixup 自动整理提交时发生冲突。解决冲突后执行 `icode continue`，' +
+        `或执行 \`icode abort\` 放弃（之前的状态在恢复点 ${backup.id}）。`,
+      { code: 'FIXUP_REBASE_CONFLICT', exitCode: 2, cause: error, meta: error.meta }
+    )
+  }
+
+  return {
+    target: targetSha.slice(0, 8),
+    fixupCommit,
+    rebased: true,
+    published,
+    needsForcePush: published,
+    backupId: backup.entries.length ? backup.id : '',
+    repoRoot: context.topLevelPath
+  }
+}

package/src/workflows/migrate-workflow.js

@@ -1,4 +1,7 @@
 import { IcodeError } from '../core/errors.js'
+import { ui, shortenHome } from '../core/tools/theme.js'
+import { createBackup } from '../core/git/backup.js'
+import { saveOperationState } from '../core/git/operation-state.js'
 import { resolveGitContext } from '../core/git/context.js'
 import { GitService } from '../core/git/service.js'
 import { chooseMany, chooseOne, isInteractiveTerminal } from '../core/tools/interactive.js'
@@ -40,11 +43,11 @@ function uniqueBranches(branches) {
   return Array.from(new Set((branches || []).map((item) => item.trim()).filter(Boolean))).sort((a, b) => a.localeCompare(b))
 }
 
-// 读取迁移交互模式的分支候选，输入 GitService，输出本地与 origin 远程分支名。
+// 读取迁移交互模式的分支候选，输入 GitService，输出本地与当前 remote 的远程分支名。
 async function listBranchCandidates(git) {
   const [localBranches, remoteBranches] = await Promise.all([
     git.listLocalBranches(),
-    git.listRemoteBranches('origin')
+    git.listRemoteBranches()
   ])
   return uniqueBranches([...localBranches, ...remoteBranches])
 }
@@ -324,13 +327,13 @@ async function assertMigratePreconditions(git) {
 }
 
 // 将本地/远程分支存在性解析为可用于 rev-list 的 ref，输入分支名和存在性，输出明确 ref。
-function resolveBranchRef(branchName, existsLocal, existsRemote, label) {
+function resolveBranchRef(branchName, existsLocal, existsRemote, label, remoteName = 'origin') {
   if (existsLocal) {
     return branchName
   }
 
   if (existsRemote) {
-    return `origin/${branchName}`
+    return `${remoteName}/${branchName}`
   }
 
   throw new IcodeError(`${label} 分支不存在: ${branchName}`, {
@@ -360,14 +363,14 @@ function buildMigrateSteps(plan) {
       action: 'checkout-target',
       detail: plan.targetExistsLocal
         ? `切换到本地目标分支 ${plan.targetBranch}`
-        : `从 origin/${plan.targetBranch} 创建 tracking 分支`
+        : `从 ${plan.remote}/${plan.targetBranch} 创建 tracking 分支`
     }
   ]
 
   if (plan.targetExistsRemote) {
     steps.push({
       action: 'pull-target',
-      detail: `同步 origin/${plan.targetBranch} 到目标分支`
+      detail: `同步 ${plan.remote}/${plan.targetBranch} 到目标分支`
     })
   }
 
@@ -399,8 +402,8 @@ function logMigratePlan(options, plan) {
   const previewCommits = plan.commits.slice(0, previewLimit)
 
   logInfo(options, '迁移计划:')
-  logInfo(options, `  source: ${plan.sourceBranch} (${plan.sourceRef})`)
-  logInfo(options, `  target: ${plan.targetBranch} (${plan.targetRef})`)
+  logInfo(options, `  source: ${ui.branch(plan.sourceBranch)} (${plan.sourceRef})`)
+  logInfo(options, `  target: ${ui.branch(plan.targetBranch)} (${plan.targetRef})`)
   logInfo(options, `  range: ${plan.rangeSpec}`)
   logInfo(options, `  commits: ${plan.migratedCommits}`)
 
@@ -441,6 +444,7 @@ async function buildMigratePlan(git, values) {
     targetExistsLocal: values.targetExistsLocal,
     targetExistsRemote: values.targetExistsRemote,
     push: values.push,
+    remote: values.remote || 'origin',
     repoRoot: values.repoRoot
   }
 
@@ -470,7 +474,7 @@ export async function runMigrateWorkflow(options) {
   const precheck = await assertMigratePreconditions(git)
   const originalBranch = precheck.currentBranch
 
-  logInfo(options, `仓库根目录: ${context.topLevelPath}`)
+  logInfo(options, `仓库 ${shortenHome(context.topLevelPath)}`)
   if (context.inheritedFromParent) {
     logWarn(options, '当前目录继承了父级 Git 仓库，命令将基于父仓库根目录执行。')
   }
@@ -527,11 +531,11 @@ export async function runMigrateWorkflow(options) {
 
   const sourceExistsLocal = await git.branchExistsLocal(sourceBranch)
   const sourceExistsRemote = await git.branchExistsRemote(sourceBranch)
-  const sourceRef = resolveBranchRef(sourceBranch, sourceExistsLocal, sourceExistsRemote, 'source')
+  const sourceRef = resolveBranchRef(sourceBranch, sourceExistsLocal, sourceExistsRemote, 'source', git.remote)
 
   const targetExistsLocal = await git.branchExistsLocal(targetBranch)
   const targetExistsRemote = await git.branchExistsRemote(targetBranch)
-  const targetRef = resolveBranchRef(targetBranch, targetExistsLocal, targetExistsRemote, 'target')
+  const targetRef = resolveBranchRef(targetBranch, targetExistsLocal, targetExistsRemote, 'target', git.remote)
 
   // 默认迁移 source 相对 target 的增量提交；交互模式可选择最近 N 条或手动挑选提交。
   const effectiveRangeSpec = rangeSpec || `${targetRef}..${sourceRef}`
@@ -547,6 +551,7 @@ export async function runMigrateWorkflow(options) {
     targetExistsLocal,
     targetExistsRemote,
     push: Boolean(options.push),
+    remote: git.remote,
     repoRoot: context.topLevelPath
   })
 
@@ -608,6 +613,13 @@ export async function runMigrateWorkflow(options) {
       })
     }
 
+    // cherry-pick 会改写目标分支，先记录恢复点。
+    const backup = await createBackup(git, {
+      reason: `migrate ${sourceBranch} -> ${targetBranch}`,
+      branches: [targetBranch],
+      silent: options.silentLog
+    })
+
     if (selectedCommits.length) {
       logInfo(options, `迁移范围: 手动选择 ${selectedCommits.length} 个提交（mode=${rangeMode}）`)
     } else {
@@ -617,8 +629,19 @@ export async function runMigrateWorkflow(options) {
     try {
       await git.cherryPick(commits)
     } catch (error) {
+      if (await git.getInProgressOperation()) {
+        saveOperationState(context, {
+          command: 'migrate',
+          sourceBranch,
+          targetBranch,
+          originalBranch,
+          push: Boolean(options.push),
+          targetExistsRemote,
+          options: { noVerify: Boolean(options.noVerify) }
+        })
+      }
       throw new IcodeError(
-        '迁移失败: cherry-pick 发生冲突。请先解决冲突后执行 `icode undo --recover continue`，或执行 `icode undo --recover abort` 回滚。',
+        `迁移暂停: cherry-pick 发生冲突，已停在 ${targetBranch}。解决冲突后执行 \`icode continue\` 接着迁移剩下的提交${options.push ? '并推送' : ''}，或执行 \`icode abort\` 放弃并切回原分支。`,
         {
           code: 'MIGRATE_CHERRY_PICK_FAILED',
           cause: error,
@@ -642,14 +665,16 @@ export async function runMigrateWorkflow(options) {
       rangeSpec: effectiveRangeSpec,
       rangeMode,
       pushed: Boolean(options.push),
+      backupId: backup.entries.length ? backup.id : '',
       repoRoot: context.topLevelPath
     }
   } finally {
-    if (originalBranch && originalBranch !== targetBranch) {
+    // 冲突暂停时留在目标分支上，方便直接解决冲突。
+    if (originalBranch && originalBranch !== targetBranch && !(await git.getInProgressOperation())) {
       try {
         await git.checkout(originalBranch)
       } catch (error) {
-        logWarn(options, `未能自动切回原分支 ${originalBranch}: ${error.message}`)
+        logWarn(options, `未能自动切回原分支 ${ui.branch(originalBranch)}: ${error.message}`)
       }
     }
   }

package/src/workflows/pr-workflow.js

@@ -0,0 +1,252 @@
+import { askAiJson } from '../core/ai/client.js'
+import { buildLimitedDiffPrompt } from '../core/ai/diff-prompt.js'
+import { IcodeError } from '../core/errors.js'
+import { resolveGitContext } from '../core/git/context.js'
+import { GitService } from '../core/git/service.js'
+import { createPlatformClientForGit } from '../core/platform/index.js'
+import { chooseOne, input } from '../core/tools/interactive.js'
+import { logger } from '../core/tools/logger.js'
+import { c, print, ui } from '../core/tools/theme.js'
+
+async function openContext(options) {
+  const context = await resolveGitContext({ cwd: options.cwd, repoMode: options.repoMode, remote: options.remote })
+  const git = new GitService(context)
+  const client = await createPlatformClientForGit(git, { provider: options.provider })
+  return { context, git, client }
+}
+
+function parsePrNumber(value) {
+  const raw = String(value || '').trim().replace(/^[#!]/, '')
+  const number = Number(raw)
+  if (!Number.isInteger(number) || number <= 0) {
+    throw new IcodeError(`无效的 PR/MR 编号: ${value}`, { code: 'PR_NUMBER_INVALID', exitCode: 2 })
+  }
+  return number
+}
+
+// 计算 PR 的基线 ref：优先远程基线分支，没有时回退本地。
+async function resolveBaseRef(git, base) {
+  const remoteBase = git.remoteRef(base)
+  if (await git.refExists(remoteBase)) {
+    return remoteBase
+  }
+  if (await git.branchExistsLocal(base)) {
+    return base
+  }
+  throw new IcodeError(`基线分支不存在: ${base}`, { code: 'PR_BASE_MISSING', exitCode: 2 })
+}
+
+/**
+ * 根据提交生成 PR 标题与正文：单个提交直接用它的标题/正文，多个提交列出提交清单。
+ */
+export function buildPrContentFromCommits(commits = [], headBranch = '') {
+  if (!commits.length) {
+    return { title: headBranch, body: '' }
+  }
+  if (commits.length === 1) {
+    return { title: commits[0].subject, body: commits[0].body || '' }
+  }
+  const latest = commits[commits.length - 1]
+  return {
+    title: latest.subject,
+    body: ['## 变更', '', ...commits.map((commit) => `- ${commit.subject}`)].join('\n')
+  }
+}
+
+async function buildAiPrContent(git, baseRef, commits, options) {
+  const diff = await git.exec(['diff', `${baseRef}...HEAD`], { allowFailure: true })
+  const limited = buildLimitedDiffPrompt(diff.stdout || '', { limit: 12000 })
+  const language = (options.lang || 'zh') === 'en' ? 'English' : 'Chinese'
+  const { parsed } = await askAiJson({
+    systemPrompt: `You write pull request descriptions for code review. Output JSON only. Language: ${language}.`,
+    userPrompt: 'Return JSON {"title":"one-line title (Conventional Commit style if commits use it)","body":"markdown with sections: 背景/改动/测试 (or Background/Changes/Testing)"}.\n\n' +
+      `Commits:\n${commits.map((commit) => `- ${commit.subject}`).join('\n')}\n\nDiff:\n${limited.diff}`
+  }, { profile: options.profile })
+  return {
+    title: String(parsed?.title || '').trim(),
+    body: String(parsed?.body || '').trim()
+  }
+}
+
+/**
+ * 创建 PR/MR：必要时先推送当前分支，再调用平台 API；没有 token 时返回网页创建链接。
+ * 输入为 { base, title, body, draft, noPush, ai }，输出 { pr, created, existed, webUrl, pushed }。
+ */
+export async function runPrCreateWorkflow(options = {}) {
+  const { context, git, client } = await openContext(options)
+  const head = await git.getCurrentBranch()
+  if (!head) {
+    throw new IcodeError('当前不在分支上，无法创建 PR。', { code: 'PR_DETACHED_HEAD', exitCode: 2 })
+  }
+  let base = String(options.base || context.defaultBranch).trim()
+  // 交互终端里没指定目标分支、且存在常见的集成分支时，让用户选一下。
+  if (!options.base && options.interactive) {
+    const candidates = []
+    for (const name of [context.defaultBranch, 'develop', 'dev', 'test', 'release', 'staging']) {
+      if (name && name !== head && !candidates.includes(name) && (await git.refExists(git.remoteRef(name)))) {
+        candidates.push(name)
+      }
+    }
+    if (candidates.length > 1) {
+      base = await chooseOne(`合并到哪个分支？`, candidates.map((name) => ({ value: name, label: name, hint: name === context.defaultBranch ? '主分支' : '' })), 0, { filter: false })
+    }
+  }
+  if (head === base) {
+    throw new IcodeError(`当前分支就是基线分支 ${base}，请在功能分支上创建 PR。`, { code: 'PR_HEAD_IS_BASE', exitCode: 2 })
+  }
+
+  await git.fetch()
+  const baseRef = await resolveBaseRef(git, base)
+  const commits = await git.listCommitMessages(`${baseRef}..HEAD`)
+  if (!commits.length) {
+    throw new IcodeError(`${head} 相对 ${baseRef} 没有新提交，无需创建 PR。`, { code: 'PR_NO_COMMITS', exitCode: 2 })
+  }
+
+  // 平台只能看到远程分支，所以先确保当前分支已推送且是最新。
+  let pushed = false
+  const remoteSha = await git.getRemoteBranchSha(head)
+  const localSha = await git.revParse('HEAD')
+  if (remoteSha !== localSha) {
+    if (options.noPush) {
+      throw new IcodeError(`${git.remoteRef(head)} 不是最新，请先推送（或去掉 --no-push）。`, { code: 'PR_HEAD_NOT_PUSHED', exitCode: 2 })
+    }
+    if (remoteSha && !(await git.isAncestor(remoteSha, 'HEAD'))) {
+      throw new IcodeError(`本地 ${head} 与远程已分叉，请先同步或执行 icode push --force。`, { code: 'PR_HEAD_DIVERGED', exitCode: 2 })
+    }
+    logger.info(`推送 ${head} 到 ${git.remote}`)
+    await git.push(head, { setUpstream: !remoteSha, noVerify: options.noVerify })
+    pushed = true
+  }
+
+  let content = buildPrContentFromCommits(commits, head)
+  if (options.ai) {
+    const aiContent = await buildAiPrContent(git, baseRef, commits, options)
+    content = { title: aiContent.title || content.title, body: aiContent.body || content.body }
+  }
+  let title = String(options.title || content.title).trim()
+  let body = options.body != null ? String(options.body) : content.body
+  let draft = Boolean(options.draft)
+  let web = Boolean(options.web)
+
+  // 创建前确认：直接创建 / 改标题 / 草稿 / 去网页创建，不用重新敲命令。
+  if (options.interactive && client.hasToken && !web) {
+    for (;;) {
+      print('')
+      print(`  ${c.bold(ui.subject(title))}  ${c.gray(`${head} → ${base} · ${commits.length} 个提交`)}`)
+      body.split('\n').filter(Boolean).slice(0, 8).forEach((line) => print(`  ${c.gray(line)}`))
+      print('')
+      const action = await chooseOne(`创建 ${client.prNoun}？`, [
+        { value: 'create', label: draft ? '创建草稿' : '创建' },
+        { value: 'title', label: '修改标题' },
+        { value: 'draft', label: draft ? '改为正式' : '改为草稿' },
+        ...(options.ai ? [] : [{ value: 'ai', label: 'AI 生成标题和描述' }]),
+        { value: 'web', label: '在浏览器中继续编辑' },
+        { value: 'cancel', label: '取消' }
+      ], 0, { filter: false })
+      if (action === 'create') {
+        break
+      }
+      if (action === 'cancel') {
+        return { created: false, canceled: true, head, base, pushed, provider: client.name }
+      }
+      if (action === 'title') {
+        title = (await input('标题', title)).trim() || title
+      } else if (action === 'draft') {
+        draft = !draft
+      } else if (action === 'ai') {
+        const aiContent = await buildAiPrContent(git, baseRef, commits, options)
+        title = aiContent.title || title
+        body = aiContent.body || body
+      } else if (action === 'web') {
+        web = true
+        break
+      }
+    }
+  }
+
+  if (web || !client.hasToken) {
+    return {
+      created: false,
+      reason: client.hasToken ? 'web' : 'no-token',
+      webUrl: client.urls.newPr(base, head),
+      title,
+      body,
+      head,
+      base,
+      pushed,
+      provider: client.name
+    }
+  }
+
+  const pr = await client.createPullRequest({ title, body, head, base, draft })
+  return {
+    created: !pr.existed,
+    existed: Boolean(pr.existed),
+    pr,
+    webUrl: pr.url || client.urls.pr(pr.number),
+    head,
+    base,
+    pushed,
+    provider: client.name
+  }
+}
+
+export async function runPrListWorkflow(options = {}) {
+  const { client } = await openContext(options)
+  const items = await client.listPullRequests({ state: options.state || 'open', base: options.base, head: options.head, limit: options.limit })
+  return { provider: client.name, prNoun: client.prNoun, items, webUrl: client.urls.prs() }
+}
+
+// 未指定编号时查找当前分支对应的 PR。
+async function resolvePrNumberForCurrentBranch(git, client) {
+  const head = await git.getCurrentBranch()
+  const [pr] = await client.listPullRequests({ head, state: 'open' })
+  if (!pr) {
+    throw new IcodeError(`当前分支 ${head} 没有打开的 ${client.prNoun}。创建: icode pr create`, { code: 'PR_NOT_FOUND', exitCode: 2 })
+  }
+  return pr.number
+}
+
+export async function runPrViewWorkflow(options = {}) {
+  const { git, client } = await openContext(options)
+  const number = options.number ? parsePrNumber(options.number) : await resolvePrNumberForCurrentBranch(git, client)
+  const pr = await client.getPullRequest(number)
+  return { provider: client.name, prNoun: client.prNoun, pr }
+}
+
+/**
+ * 把 PR/MR 检出到本地分支 pr/<编号>（fork 来的 PR 也能用）。
+ */
+export async function runPrCheckoutWorkflow(options = {}) {
+  const { context, git, client } = await openContext(options)
+  const number = parsePrNumber(options.number)
+  const localBranch = options.branch || `pr/${number}`
+  const current = await git.getCurrentBranch()
+
+  if (current === localBranch) {
+    await git.exec(['pull', git.remote, client.prRef(number)])
+  } else {
+    await git.exec(['fetch', git.remote, `+${client.prRef(number)}:refs/heads/${localBranch}`])
+    await git.switchBranch(localBranch)
+  }
+
+  return { number, branch: localBranch, provider: client.name, repoRoot: context.topLevelPath }
+}
+
+export async function runPrMergeWorkflow(options = {}) {
+  const { git, client } = await openContext(options)
+  const number = options.number ? parsePrNumber(options.number) : await resolvePrNumberForCurrentBranch(git, client)
+  const pr = await client.getPullRequest(number)
+  if (pr.merged) {
+    return { number, merged: true, alreadyMerged: true, pr }
+  }
+  const result = await client.mergePullRequest(number, { method: options.method })
+  if (!result.ok) {
+    throw new IcodeError(`${client.prNoun} #${number} 合并失败${result.conflict ? '（存在冲突或不满足合并条件）' : ''}: ${result.reason}`, {
+      code: 'PR_MERGE_FAILED',
+      exitCode: 2,
+      meta: result
+    })
+  }
+  return { number, merged: true, pr: { ...pr, merged: true, state: 'merged' }, reason: result.reason }
+}