@icode-js/icode 3.2.0 → 3.4.0

package/src/core/platform/index.js

@@ -0,0 +1,165 @@
+import { readConfig } from '../config/store.js'
+import { IcodeError } from '../errors.js'
+import { PLATFORM_PROVIDERS, SUPPORTED_PLATFORM_NAMES } from './providers.js'
+import { detectProviderFromHost, parseRemoteUrl } from './remote-url.js'
+
+export { SUPPORTED_PLATFORM_NAMES } from './providers.js'
+export { detectProviderFromHost, parseRemoteUrl } from './remote-url.js'
+
+// 各平台 token 的环境变量名，按顺序取第一个非空值。
+const TOKEN_ENV_NAMES = {
+  github: ['ICODE_GITHUB_TOKEN', 'GITHUB_TOKEN', 'GH_TOKEN'],
+  gitlab: ['ICODE_GITLAB_TOKEN', 'GITLAB_TOKEN', 'GITLAB_PRIVATE_TOKEN'],
+  gitee: ['ICODE_GITEE_TOKEN', 'GITEE_TOKEN'],
+  gitea: ['ICODE_GITEA_TOKEN', 'GITEA_TOKEN']
+}
+
+/**
+ * 读取平台 token。
+ * 优先级：platforms.tokens.<provider> > 旧配置 platforms.remoteMerge.apiKey（provider 一致时）> 环境变量。
+ * 输入为 provider 与可选的已读取配置，输出 { token, source }。
+ */
+export function resolvePlatformToken(provider, config = readConfig()) {
+  const name = String(provider || '').trim().toLowerCase()
+  const fromTokens = String(config.platforms?.tokens?.[name] || '').trim()
+  if (fromTokens) {
+    return { token: fromTokens, source: `config:platforms.tokens.${name}` }
+  }
+
+  const legacy = config.platforms?.remoteMerge || {}
+  if (String(legacy.provider || '').trim().toLowerCase() === name && String(legacy.apiKey || '').trim()) {
+    return { token: String(legacy.apiKey).trim(), source: 'config:platforms.remoteMerge.apiKey' }
+  }
+
+  for (const envName of TOKEN_ENV_NAMES[name] || []) {
+    const value = String(process.env[envName] || '').trim()
+    if (value) {
+      return { token: value, source: `env:${envName}` }
+    }
+  }
+
+  return { token: '', source: '' }
+}
+
+/**
+ * 识别平台：显式 provider > 配置 platforms.hosts 映射 > 主机名推断 > 旧配置 remoteMerge.provider。
+ * 输入为 remote URL 与 { provider }，输出 provider 名称或空串。
+ */
+export function resolveProviderName(remoteUrl, options = {}, config = readConfig()) {
+  const explicit = String(options.provider || '').trim().toLowerCase()
+  if (explicit) {
+    return explicit
+  }
+
+  const repo = parseRemoteUrl(remoteUrl)
+  const detected = repo ? detectProviderFromHost(repo.host, config.platforms?.hosts || {}) : ''
+  if (detected) {
+    return detected
+  }
+
+  return String(config.platforms?.remoteMerge?.provider || '').trim().toLowerCase()
+}
+
+/**
+ * 根据 remote URL 创建平台客户端。
+ * 输入为 remote URL 与 { provider, token }，输出 provider 客户端（包含 name/urls/PR/Release 方法）和仓库信息。
+ */
+export function createPlatformClient(remoteUrl, options = {}) {
+  const config = options.config || readConfig()
+  const repo = parseRemoteUrl(remoteUrl)
+  if (!repo) {
+    throw new IcodeError(`无法识别 remote 地址: ${remoteUrl || '(空)'}。请检查 git remote -v。`, {
+      code: 'PLATFORM_REMOTE_UNRECOGNIZED',
+      exitCode: 2
+    })
+  }
+
+  const provider = resolveProviderName(remoteUrl, options, config)
+  const factory = PLATFORM_PROVIDERS[provider]
+  if (!factory) {
+    throw new IcodeError(
+      `无法识别代码托管平台: ${repo.host}。支持 ${SUPPORTED_PLATFORM_NAMES.join(', ')}；` +
+        `自建平台请执行 icode config platform host set ${repo.host} <provider>`,
+      { code: 'PLATFORM_UNSUPPORTED', exitCode: 2, meta: { host: repo.host, provider } }
+    )
+  }
+
+  const tokenInfo = options.token ? { token: options.token, source: 'option' } : resolvePlatformToken(provider, config)
+  const client = factory(repo, tokenInfo.token)
+  return {
+    ...client,
+    repo,
+    tokenSource: tokenInfo.source,
+    hasToken: Boolean(tokenInfo.token)
+  }
+}
+
+/**
+ * 基于 GitService 当前 remote 创建平台客户端。
+ */
+export async function createPlatformClientForGit(git, options = {}) {
+  const remoteUrl = await git.getRemoteUrl()
+  if (!remoteUrl) {
+    throw new IcodeError(`当前仓库没有 ${git.remote} remote，无法访问代码托管平台。`, {
+      code: 'PLATFORM_REMOTE_MISSING',
+      exitCode: 2
+    })
+  }
+  return createPlatformClient(remoteUrl, options)
+}
+
+function delay(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms)
+  })
+}
+
+/**
+ * 通用远程合并：找已有 PR 或新建 -> 等待平台算出可合并状态 -> 合并。
+ * 输入为平台客户端与 { sourceBranch, targetBranch, title, body, pollIntervalMs, maxAttempts }，
+ * 输出与 GitLab 远程合并一致的结果：{ ok, conflict, step, reason, mergeRequestUrl, mergeRequestId }。
+ */
+export async function performPlatformRemoteMerge(client, options = {}) {
+  const pollIntervalMs = Number.isInteger(options.pollIntervalMs) ? options.pollIntervalMs : 1500
+  const maxAttempts = Number.isInteger(options.maxAttempts) ? options.maxAttempts : 40
+
+  let pr
+  try {
+    pr = await client.createPullRequest({
+      title: options.title,
+      body: options.body,
+      head: options.sourceBranch,
+      base: options.targetBranch
+    })
+  } catch (error) {
+    return { ok: false, conflict: false, step: 'create', reason: error.message }
+  }
+
+  const base = { mergeRequestUrl: pr.url || client.urls.pr(pr.number), mergeRequestId: pr.number }
+
+  // 平台异步计算 mergeable，null 表示还没算完。
+  let current = pr
+  for (let attempt = 0; attempt < maxAttempts && current.mergeable === null && !current.merged; attempt += 1) {
+    await delay(pollIntervalMs)
+    try {
+      current = await client.getPullRequest(pr.number)
+    } catch (error) {
+      return { ok: false, conflict: false, step: 'inspect', reason: error.message, ...base }
+    }
+  }
+
+  if (current.merged) {
+    return { ok: true, conflict: false, step: 'merge', reason: `${client.prNoun} 已合并`, ...base }
+  }
+
+  if (current.conflict || current.mergeable === false) {
+    return { ok: false, conflict: true, step: 'inspect', reason: `${client.prNoun} 存在冲突或不可合并，请在平台上处理`, ...base }
+  }
+
+  const merged = await client.mergePullRequest(pr.number, { method: options.method })
+  if (!merged.ok) {
+    return { ok: false, conflict: merged.conflict, step: 'merge', reason: merged.reason, ...base }
+  }
+
+  return { ok: true, conflict: false, step: 'merge', reason: '远程合并已完成', ...base }
+}

package/src/core/platform/providers.js

@@ -0,0 +1,454 @@
+import { IcodeError } from '../errors.js'
+import { assertResponseOk, requestJson } from './http.js'
+
+// 各平台的 API 适配。每个 provider 都实现同一组方法，并把 PR/MR 归一化成：
+// { number, title, state, url, head, base, author, draft, merged, mergeable, conflict }
+
+function requireToken(provider, token) {
+  if (!token) {
+    throw new IcodeError(
+      `缺少 ${provider} 平台 token。请执行: icode config platform token set ${provider} <token>（也可用环境变量）`,
+      { code: 'PLATFORM_TOKEN_MISSING', exitCode: 2, meta: { provider } }
+    )
+  }
+}
+
+function encodePath(value) {
+  return String(value).split('/').map(encodeURIComponent).join('/')
+}
+
+// ---------------- GitHub ----------------
+
+function normalizeGitHubPr(item = {}) {
+  return {
+    number: item.number,
+    title: item.title || '',
+    state: item.merged_at ? 'merged' : item.state || '',
+    url: item.html_url || '',
+    head: item.head?.ref || '',
+    base: item.base?.ref || '',
+    author: item.user?.login || '',
+    draft: Boolean(item.draft),
+    merged: Boolean(item.merged || item.merged_at),
+    mergeable: typeof item.mergeable === 'boolean' ? item.mergeable : null,
+    conflict: item.mergeable_state === 'dirty'
+  }
+}
+
+function createGitHubProvider(repo, token) {
+  const apiBase = repo.host === 'github.com' ? 'https://api.github.com' : `${repo.protocol}//${repo.host}/api/v3`
+  const repoApi = `${apiBase}/repos/${encodePath(repo.path)}`
+  const headers = () => {
+    requireToken('github', token)
+    return {
+      Accept: 'application/vnd.github+json',
+      Authorization: `Bearer ${token}`,
+      'X-GitHub-Api-Version': '2022-11-28',
+      'User-Agent': 'icode-cli',
+      'Content-Type': 'application/json'
+    }
+  }
+
+  return {
+    name: 'github',
+    label: 'GitHub',
+    prNoun: 'PR',
+    prRef: (number) => `refs/pull/${number}/head`,
+    urls: {
+      repo: () => repo.webUrl,
+      branch: (branch) => `${repo.webUrl}/tree/${encodePath(branch)}`,
+      commit: (sha) => `${repo.webUrl}/commit/${sha}`,
+      file: (ref, file, line) => `${repo.webUrl}/blob/${encodePath(ref)}/${encodePath(file)}${line ? `#L${line}` : ''}`,
+      pr: (number) => `${repo.webUrl}/pull/${number}`,
+      prs: () => `${repo.webUrl}/pulls`,
+      newPr: (base, head) => `${repo.webUrl}/compare/${encodePath(base)}...${encodePath(head)}?expand=1`,
+      compare: (base, head) => `${repo.webUrl}/compare/${encodePath(base)}...${encodePath(head)}`,
+      releases: () => `${repo.webUrl}/releases`,
+      pipelines: () => `${repo.webUrl}/actions`
+    },
+    async listPullRequests(filter = {}) {
+      const url = new URL(`${repoApi}/pulls`)
+      url.searchParams.set('state', filter.state === 'merged' ? 'closed' : filter.state || 'open')
+      url.searchParams.set('per_page', String(filter.limit || 30))
+      if (filter.head) {
+        url.searchParams.set('head', `${repo.owner.split('/')[0]}:${filter.head}`)
+      }
+      if (filter.base) {
+        url.searchParams.set('base', filter.base)
+      }
+      const result = await requestJson(url.toString(), { headers: headers() }, 'GitHub 读取 PR 列表失败')
+      assertResponseOk(result, 'GitHub 读取 PR 列表失败')
+      const items = (Array.isArray(result.payload) ? result.payload : []).map(normalizeGitHubPr)
+      return filter.state === 'merged' ? items.filter((item) => item.merged) : items
+    },
+    async getPullRequest(number) {
+      const result = await requestJson(`${repoApi}/pulls/${number}`, { headers: headers() }, 'GitHub 读取 PR 失败')
+      assertResponseOk(result, `GitHub 读取 PR #${number} 失败`)
+      return normalizeGitHubPr(result.payload)
+    },
+    async createPullRequest(input) {
+      const result = await requestJson(`${repoApi}/pulls`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ title: input.title, body: input.body || '', head: input.head, base: input.base, draft: Boolean(input.draft) })
+      }, 'GitHub 创建 PR 失败')
+      if (!result.ok && result.status === 422 && /already exists/i.test(result.reason)) {
+        const [existing] = await this.listPullRequests({ head: input.head, base: input.base })
+        if (existing) {
+          return { ...existing, existed: true }
+        }
+      }
+      assertResponseOk(result, 'GitHub 创建 PR 失败')
+      return normalizeGitHubPr(result.payload)
+    },
+    async mergePullRequest(number, options = {}) {
+      const result = await requestJson(`${repoApi}/pulls/${number}/merge`, {
+        method: 'PUT',
+        headers: headers(),
+        body: JSON.stringify({ merge_method: options.method || 'merge' })
+      }, 'GitHub 合并 PR 失败')
+      return {
+        ok: result.ok && result.payload?.merged !== false,
+        conflict: result.status === 405 || result.status === 409,
+        status: result.status,
+        reason: result.ok ? result.payload?.message || '已合并' : result.reason
+      }
+    },
+    async createRelease(input) {
+      const result = await requestJson(`${repoApi}/releases`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ tag_name: input.tag, name: input.name || input.tag, body: input.body || '', prerelease: Boolean(input.prerelease), draft: Boolean(input.draft) })
+      }, 'GitHub 创建 Release 失败')
+      assertResponseOk(result, 'GitHub 创建 Release 失败')
+      return { url: result.payload?.html_url || `${repo.webUrl}/releases/tag/${encodeURIComponent(input.tag)}` }
+    }
+  }
+}
+
+// ---------------- Gitea / Forgejo ----------------
+
+function normalizeGiteaPr(item = {}) {
+  return {
+    number: item.number,
+    title: item.title || '',
+    state: item.merged ? 'merged' : item.state || '',
+    url: item.html_url || '',
+    head: item.head?.ref || '',
+    base: item.base?.ref || '',
+    author: item.user?.login || '',
+    draft: Boolean(item.draft) || /^(wip|draft)[:\s]/i.test(item.title || ''),
+    merged: Boolean(item.merged),
+    mergeable: typeof item.mergeable === 'boolean' ? item.mergeable : null,
+    conflict: item.mergeable === false && !item.merged
+  }
+}
+
+function createGiteaProvider(repo, token) {
+  const repoApi = `${repo.protocol}//${repo.host}/api/v1/repos/${encodePath(repo.path)}`
+  const headers = () => {
+    requireToken('gitea', token)
+    return { Authorization: `token ${token}`, 'Content-Type': 'application/json', Accept: 'application/json' }
+  }
+
+  return {
+    name: 'gitea',
+    label: 'Gitea',
+    prNoun: 'PR',
+    prRef: (number) => `refs/pull/${number}/head`,
+    urls: {
+      repo: () => repo.webUrl,
+      branch: (branch) => `${repo.webUrl}/src/branch/${encodePath(branch)}`,
+      commit: (sha) => `${repo.webUrl}/commit/${sha}`,
+      file: (ref, file, line) => `${repo.webUrl}/src/branch/${encodePath(ref)}/${encodePath(file)}${line ? `#L${line}` : ''}`,
+      pr: (number) => `${repo.webUrl}/pulls/${number}`,
+      prs: () => `${repo.webUrl}/pulls`,
+      newPr: (base, head) => `${repo.webUrl}/compare/${encodePath(base)}...${encodePath(head)}`,
+      compare: (base, head) => `${repo.webUrl}/compare/${encodePath(base)}...${encodePath(head)}`,
+      releases: () => `${repo.webUrl}/releases`,
+      pipelines: () => `${repo.webUrl}/actions`
+    },
+    async listPullRequests(filter = {}) {
+      const url = new URL(`${repoApi}/pulls`)
+      url.searchParams.set('state', filter.state === 'merged' ? 'closed' : filter.state || 'open')
+      url.searchParams.set('limit', String(filter.limit || 50))
+      const result = await requestJson(url.toString(), { headers: headers() }, 'Gitea 读取 PR 列表失败')
+      assertResponseOk(result, 'Gitea 读取 PR 列表失败')
+      return (Array.isArray(result.payload) ? result.payload : [])
+        .map(normalizeGiteaPr)
+        .filter((item) => (!filter.head || item.head === filter.head) && (!filter.base || item.base === filter.base))
+        .filter((item) => filter.state !== 'merged' || item.merged)
+    },
+    async getPullRequest(number) {
+      const result = await requestJson(`${repoApi}/pulls/${number}`, { headers: headers() }, 'Gitea 读取 PR 失败')
+      assertResponseOk(result, `Gitea 读取 PR #${number} 失败`)
+      return normalizeGiteaPr(result.payload)
+    },
+    async createPullRequest(input) {
+      const title = input.draft ? `WIP: ${input.title}` : input.title
+      const result = await requestJson(`${repoApi}/pulls`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ title, body: input.body || '', head: input.head, base: input.base })
+      }, 'Gitea 创建 PR 失败')
+      if (!result.ok && result.status === 409) {
+        const [existing] = await this.listPullRequests({ head: input.head, base: input.base })
+        if (existing) {
+          return { ...existing, existed: true }
+        }
+      }
+      assertResponseOk(result, 'Gitea 创建 PR 失败')
+      return normalizeGiteaPr(result.payload)
+    },
+    async mergePullRequest(number, options = {}) {
+      const result = await requestJson(`${repoApi}/pulls/${number}/merge`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ Do: options.method || 'merge' })
+      }, 'Gitea 合并 PR 失败')
+      return {
+        ok: result.ok,
+        conflict: result.status === 405 || result.status === 409,
+        status: result.status,
+        reason: result.ok ? '已合并' : result.reason
+      }
+    },
+    async createRelease(input) {
+      const result = await requestJson(`${repoApi}/releases`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ tag_name: input.tag, name: input.name || input.tag, body: input.body || '', prerelease: Boolean(input.prerelease), draft: Boolean(input.draft) })
+      }, 'Gitea 创建 Release 失败')
+      assertResponseOk(result, 'Gitea 创建 Release 失败')
+      return { url: result.payload?.html_url || `${repo.webUrl}/releases/tag/${encodeURIComponent(input.tag)}` }
+    }
+  }
+}
+
+// ---------------- Gitee ----------------
+
+function normalizeGiteePr(item = {}) {
+  return {
+    number: item.number,
+    title: item.title || '',
+    state: item.state || '',
+    url: item.html_url || '',
+    head: item.head?.ref || '',
+    base: item.base?.ref || '',
+    author: item.user?.login || '',
+    draft: Boolean(item.draft),
+    merged: item.state === 'merged',
+    mergeable: typeof item.mergeable === 'boolean' ? item.mergeable : null,
+    conflict: item.mergeable === false && item.state === 'open'
+  }
+}
+
+function createGiteeProvider(repo, token) {
+  const repoApi = `https://gitee.com/api/v5/repos/${encodePath(repo.path)}`
+  const withToken = (url) => {
+    requireToken('gitee', token)
+    url.searchParams.set('access_token', token)
+    return url.toString()
+  }
+  const jsonHeaders = { 'Content-Type': 'application/json;charset=UTF-8' }
+
+  return {
+    name: 'gitee',
+    label: 'Gitee',
+    prNoun: 'PR',
+    prRef: (number) => `refs/pull/${number}/head`,
+    urls: {
+      repo: () => repo.webUrl,
+      branch: (branch) => `${repo.webUrl}/tree/${encodePath(branch)}`,
+      commit: (sha) => `${repo.webUrl}/commit/${sha}`,
+      file: (ref, file, line) => `${repo.webUrl}/blob/${encodePath(ref)}/${encodePath(file)}${line ? `#L${line}` : ''}`,
+      pr: (number) => `${repo.webUrl}/pulls/${number}`,
+      prs: () => `${repo.webUrl}/pulls`,
+      newPr: (base, head) => `${repo.webUrl}/compare/${encodePath(base)}...${encodePath(head)}`,
+      compare: (base, head) => `${repo.webUrl}/compare/${encodePath(base)}...${encodePath(head)}`,
+      releases: () => `${repo.webUrl}/releases`,
+      pipelines: () => `${repo.webUrl}/gitee_go/pipelines`
+    },
+    async listPullRequests(filter = {}) {
+      const url = new URL(`${repoApi}/pulls`)
+      url.searchParams.set('state', filter.state || 'open')
+      url.searchParams.set('per_page', String(filter.limit || 30))
+      if (filter.head) {
+        url.searchParams.set('head', filter.head)
+      }
+      if (filter.base) {
+        url.searchParams.set('base', filter.base)
+      }
+      const result = await requestJson(withToken(url), {}, 'Gitee 读取 PR 列表失败')
+      assertResponseOk(result, 'Gitee 读取 PR 列表失败')
+      return (Array.isArray(result.payload) ? result.payload : []).map(normalizeGiteePr)
+    },
+    async getPullRequest(number) {
+      const result = await requestJson(withToken(new URL(`${repoApi}/pulls/${number}`)), {}, 'Gitee 读取 PR 失败')
+      assertResponseOk(result, `Gitee 读取 PR #${number} 失败`)
+      return normalizeGiteePr(result.payload)
+    },
+    async createPullRequest(input) {
+      requireToken('gitee', token)
+      const result = await requestJson(`${repoApi}/pulls`, {
+        method: 'POST',
+        headers: jsonHeaders,
+        body: JSON.stringify({ access_token: token, title: input.title, head: input.head, base: input.base, body: input.body || '', draft: Boolean(input.draft) })
+      }, 'Gitee 创建 PR 失败')
+      if (!result.ok && /已存在|already exists/i.test(result.reason)) {
+        const [existing] = await this.listPullRequests({ head: input.head, base: input.base })
+        if (existing) {
+          return { ...existing, existed: true }
+        }
+      }
+      assertResponseOk(result, 'Gitee 创建 PR 失败')
+      return normalizeGiteePr(result.payload)
+    },
+    async mergePullRequest(number, options = {}) {
+      requireToken('gitee', token)
+      const result = await requestJson(`${repoApi}/pulls/${number}/merge`, {
+        method: 'PUT',
+        headers: jsonHeaders,
+        body: JSON.stringify({ access_token: token, merge_method: options.method || 'merge' })
+      }, 'Gitee 合并 PR 失败')
+      return {
+        ok: result.ok,
+        conflict: result.status === 405 || result.status === 409,
+        status: result.status,
+        reason: result.ok ? '已合并' : result.reason
+      }
+    },
+    async createRelease(input) {
+      requireToken('gitee', token)
+      const result = await requestJson(`${repoApi}/releases`, {
+        method: 'POST',
+        headers: jsonHeaders,
+        body: JSON.stringify({
+          access_token: token,
+          tag_name: input.tag,
+          name: input.name || input.tag,
+          body: input.body || input.tag,
+          prerelease: Boolean(input.prerelease),
+          target_commitish: input.target || 'HEAD'
+        })
+      }, 'Gitee 创建 Release 失败')
+      assertResponseOk(result, 'Gitee 创建 Release 失败')
+      return { url: result.payload?.html_url || `${repo.webUrl}/releases/tag/${encodeURIComponent(input.tag)}` }
+    }
+  }
+}
+
+// ---------------- GitLab ----------------
+
+function normalizeGitLabMr(item = {}) {
+  return {
+    number: item.iid,
+    title: item.title || '',
+    state: item.state === 'opened' ? 'open' : item.state || '',
+    url: item.web_url || '',
+    head: item.source_branch || '',
+    base: item.target_branch || '',
+    author: item.author?.username || '',
+    draft: Boolean(item.draft || item.work_in_progress),
+    merged: item.state === 'merged',
+    mergeable: item.has_conflicts === true ? false : item.detailed_merge_status === 'mergeable' ? true : null,
+    conflict: item.has_conflicts === true
+  }
+}
+
+function createGitLabProvider(repo, token) {
+  const projectApi = `${repo.protocol}//${repo.host}/api/v4/projects/${encodeURIComponent(repo.path)}`
+  const headers = () => {
+    requireToken('gitlab', token)
+    return { 'PRIVATE-TOKEN': token, 'Content-Type': 'application/json' }
+  }
+  const stateMap = { open: 'opened', closed: 'closed', merged: 'merged', all: 'all' }
+
+  return {
+    name: 'gitlab',
+    label: 'GitLab',
+    prNoun: 'MR',
+    prRef: (number) => `refs/merge-requests/${number}/head`,
+    urls: {
+      repo: () => repo.webUrl,
+      branch: (branch) => `${repo.webUrl}/-/tree/${encodePath(branch)}`,
+      commit: (sha) => `${repo.webUrl}/-/commit/${sha}`,
+      file: (ref, file, line) => `${repo.webUrl}/-/blob/${encodePath(ref)}/${encodePath(file)}${line ? `#L${line}` : ''}`,
+      pr: (number) => `${repo.webUrl}/-/merge_requests/${number}`,
+      prs: () => `${repo.webUrl}/-/merge_requests`,
+      newPr: (base, head) => `${repo.webUrl}/-/merge_requests/new?${new URLSearchParams({
+        'merge_request[source_branch]': head,
+        'merge_request[target_branch]': base
+      }).toString()}`,
+      compare: (base, head) => `${repo.webUrl}/-/compare/${encodePath(base)}...${encodePath(head)}`,
+      releases: () => `${repo.webUrl}/-/releases`,
+      pipelines: () => `${repo.webUrl}/-/pipelines`
+    },
+    async listPullRequests(filter = {}) {
+      const url = new URL(`${projectApi}/merge_requests`)
+      url.searchParams.set('state', stateMap[filter.state || 'open'] || 'opened')
+      url.searchParams.set('per_page', String(filter.limit || 30))
+      if (filter.head) {
+        url.searchParams.set('source_branch', filter.head)
+      }
+      if (filter.base) {
+        url.searchParams.set('target_branch', filter.base)
+      }
+      const result = await requestJson(url.toString(), { headers: headers() }, 'GitLab 读取 MR 列表失败')
+      assertResponseOk(result, 'GitLab 读取 MR 列表失败')
+      return (Array.isArray(result.payload) ? result.payload : []).map(normalizeGitLabMr)
+    },
+    async getPullRequest(number) {
+      const result = await requestJson(`${projectApi}/merge_requests/${number}`, { headers: headers() }, 'GitLab 读取 MR 失败')
+      assertResponseOk(result, `GitLab 读取 MR !${number} 失败`)
+      return normalizeGitLabMr(result.payload)
+    },
+    async createPullRequest(input) {
+      const title = input.draft ? `Draft: ${input.title}` : input.title
+      const result = await requestJson(`${projectApi}/merge_requests`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ source_branch: input.head, target_branch: input.base, title, description: input.body || '' })
+      }, 'GitLab 创建 MR 失败')
+      if (!result.ok && result.status === 409) {
+        const [existing] = await this.listPullRequests({ head: input.head, base: input.base })
+        if (existing) {
+          return { ...existing, existed: true }
+        }
+      }
+      assertResponseOk(result, 'GitLab 创建 MR 失败')
+      return normalizeGitLabMr(result.payload)
+    },
+    async mergePullRequest(number) {
+      const result = await requestJson(`${projectApi}/merge_requests/${number}/merge`, {
+        method: 'PUT',
+        headers: headers(),
+        body: JSON.stringify({})
+      }, 'GitLab 合并 MR 失败')
+      return {
+        ok: result.ok,
+        conflict: result.status === 406 || result.status === 409,
+        status: result.status,
+        reason: result.ok ? '已合并' : result.reason
+      }
+    },
+    async createRelease(input) {
+      const result = await requestJson(`${projectApi}/releases`, {
+        method: 'POST',
+        headers: headers(),
+        body: JSON.stringify({ tag_name: input.tag, name: input.name || input.tag, description: input.body || '' })
+      }, 'GitLab 创建 Release 失败')
+      assertResponseOk(result, 'GitLab 创建 Release 失败')
+      return { url: `${repo.webUrl}/-/releases/${encodeURIComponent(input.tag)}` }
+    }
+  }
+}
+
+export const PLATFORM_PROVIDERS = {
+  github: createGitHubProvider,
+  gitlab: createGitLabProvider,
+  gitee: createGiteeProvider,
+  gitea: createGiteaProvider
+}
+
+export const SUPPORTED_PLATFORM_NAMES = Object.keys(PLATFORM_PROVIDERS)