@qzsy/dsh-bridge 2.18.0 → 3.0.1

package/lib/platform/ask-user.js

@@ -1,293 +0,0 @@
-// Agent 决策问答（ask_user_question / 计划审批）的**平台无关**核心。
-//
-// 背景：DSH 把"Agent 需要用户做个决定"统一收敛到 `dsh-user-questions` 服务，
-// 机制是 cordis **waterfall 钩子** `user-questions/request`：
-//
-//   agent 调 ask_user_question 工具
-//     → userQuestions.askTimed(request, callId, timeoutMs)
-//     → ctx.waterfall('user-questions/request', request, noAnswerer)
-//          ↑ 应答者在这里接管：渲染问题、等用户选择、返回答案批次
-//          ↑ 无人接管 → reject('NO_PROVIDER')
-//
-// 在此之前，本插件**完全没有注册该钩子**：IM 用户看不到任何提问，Agent 只能拿到
-// NO_PROVIDER（表现为"它想问却问不出来"，或超时后以 pending 继续）。
-// 本模块提供渲染与答案规整的**纯函数**，供各 IM 平台复用；桥接与平台渲染分别在
-// conversation-bridge.js（归属判定/生命周期）与各平台节点（卡片/按钮）里实现。
-//
-// 请求/答案的数据形状（对齐宿主 schema，勿凭想象改）：
-//   request = { questions: Question[], agent?, signal?, wait?: { callId, timed } }
-//   Question = { id, question, detail?, header?, options?: [{label, description?}], multiSelect? }
-//   answer   = { answers: [{ id, selected: string[], custom?: string }] }  ← 每问恰好一项
-//
-// 一个重要语义（决定交互设计）：**选项可以为空**（纯自由输入式提问）；`multiSelect`
-// 才允许选多个。答案里 `selected: []` 且无 `custom` 表示"用户显式跳过"，与"pending"
-// （超时未答，稍后仍可答）是两件事。
-
-/** 常规输入的单选项上限（超出时提示用户改用文字回复，避免卡片按钮爆炸）。 */
-export const MAX_CARD_OPTIONS = 6
-
-/** 截断过长文本（标题/详情），保持 IM 可读。 */
-export function clip(text, max = 120) {
-  const s = String(text ?? '').replace(/\s+/g, ' ').trim()
-  return s.length > max ? `${s.slice(0, max - 1)}…` : s
-}
-
-/**
- * 问题的展示标题：header 优先，其次问题正文单行。
- * @param {object} question
- */
-export function questionTitle(question) {
-  const header = clip(question?.header, 40)
-  if (header) return header
-  return clip(question?.question, 60) || '请选择'
-}
-
-/**
- * 是否属于"计划审批"型提问。
- *
- * 宿主把 plan-review 也塞进同一入口，用 `question.intent.kind === 'plan-review'` 标记
- * （见 dsh-client-ui-user-questions 的 planReviewOf）。识别出来就能共用一套 UI，
- * 只是标题/按钮措辞更贴合"审阅计划"。
- */
-export function isPlanReview(question) {
-  return question?.intent?.kind === 'plan-review'
-}
-
-/**
- * 判断该问题能否用**纯按钮**表达。
- *
- * 不满足时任选其一：
- *   - 选项为空 → 必须让用户自由输入（卡片按钮无能为力）；
- *   - 选项过多 → 卡片按钮会撑爆（IM 卡片没有滚动列表），退回文字回复更好用。
- * 注意 multiSelect **不**排除按钮方案：多选可用"逐个切换 + 确认"实现，但首版
- * 为稳妥起见，把多选也交回文字回复（见 formatAskPrompt 的提示语），
- * 避免用户在卡片上误以为只能单选。
- *
- * @returns {boolean}
- */
-export function canRenderAsButtons(question, { maxOptions = MAX_CARD_OPTIONS } = {}) {
-  const options = Array.isArray(question?.options) ? question.options : []
-  if (options.length === 0) return false
-  if (options.length > maxOptions) return false
-  if (question?.multiSelect === true) return false
-  return true
-}
-
-/**
- * 把一批问题渲染成 IM 文本（**回退路径**，也是不支持按钮的平台的主路径）。
- *
- * 编号规则：`Q1/Q2…` 问题、`1/2…` 选项。用户回复形如：
- *   `/ask 1`       → Q1 选第 1 项
- *   `/ask 1 2`     → Q1 选第 2 项
- *   `/ask 1=2,3`   → Q1 多选（配合 multiSelect）
- *   `/ask 1=自由文本` → 自由输入
- * 多条用 `;` 分隔，例如 `/ask 1; 2=1`。
- *
- * @param {object[]} questions
- * @param {{ number?: number, timeoutSec?: number, header?: string }} [opts]
- * @returns {string}
- */
-export function formatAskPrompt(questions, { number = 1, timeoutSec = 0, header = '' } = {}) {
-  const list = Array.isArray(questions) ? questions : []
-  const lines = []
-  const plan = list.some(isPlanReview)
-  lines.push(`## ${plan ? '📋 计划待确认' : '❓ 需要你的决定'}${number ? ` (#${number})` : ''}`)
-  if (header) lines.push('', String(header))
-  if (timeoutSec > 0) {
-    const min = Math.max(1, Math.round(timeoutSec / 60))
-    lines.push('', `> 等待超时：${min} 分钟（超时后 Agent 可能先继续其它工作，你稍后仍可回复）`)
-  }
-  lines.push('')
-
-  list.forEach((q, qi) => {
-    const title = questionTitle(q)
-    const detail = clip(q?.detail, 500)
-    lines.push(`**Q${qi + 1}. ${title}**`)
-    if (detail) lines.push(detail)
-    const options = Array.isArray(q?.options) ? q.options : []
-    if (options.length === 0) {
-      lines.push('- （自由输入，无预设选项）')
-    } else {
-      options.forEach((opt, oi) => {
-        const desc = clip(opt?.description, 120)
-        // 推荐项：宿主约定把推荐项放第一位并带 "(Recommended)" 标注
-        const recommended = /\(recommended\)|（推荐）/i.test(String(opt?.label ?? ''))
-        lines.push(`- \`${oi + 1}\` ${clip(opt?.label, 60)}${recommended ? ' ⭐' : ''}${desc ? ` — ${desc}` : ''}`)
-      })
-      if (q?.multiSelect === true) lines.push('  *（可多选，用逗号分隔，如 `1,3`）*')
-    }
-    lines.push('')
-  })
-
-  const n = list.length
-  lines.push('**回复方式**')
-  if (n === 1) {
-    const multiSel = list[0]?.multiSelect === true
-    lines.push(multiSel ? '- 选多项：`/ask 1,3`（逗号分隔）' : '- 选一项：`/ask 1`（选第 1 个选项）')
-    lines.push('- 自由输入：`/ask =你的答案`')
-  } else {
-    lines.push(`- 逐个作答：\`/ask 1; 2; 3\`（按顺序对应 Q1/Q2/Q3；共 ${n} 问）`)
-    lines.push('- 指定问题：`/ask 2=1`（Q2 选第 1 项）')
-    lines.push('- 跳过某问：留空，如 `/ask 1; ; 2`')
-  }
-  return lines.join('\n').trim()
-}
-
-/**
- * 解析用户文字回复为答案批次。
- *
- * 支持的写法（宽松解析，便于手机输入）：
- *   `/ask 1`              单问：选第 1 项
- *   `/ask =自由文本`       单问：自由输入
- *   `/ask 1; 2; 3`        多问按序作答
- *   `/ask 1=2`            指定 Q1 选第 2 项
- *   `/ask Q1=2`           Q 前缀大小写不敏感
- *   `/ask 1=1,3`          多选
- *   `/ask 1=2; 2=自由文本`  混合
- *
- * @param {string} text 用户消息原文（可含 `/ask` 前缀）
- * @param {object[]} questions 与请求同序的问题数组
- * @returns {{ ok: true, answers: object[] } | { ok: false, error: string }}
- */
-export function parseAskReply(text, questions) {
-  const list = Array.isArray(questions) ? questions : []
-  if (list.length === 0) return { ok: false, error: '当前没有待回答的问题。' }
-
-  let raw = String(text ?? '').trim()
-  if (!raw) return { ok: false, error: '回复内容为空。' }
-  // 允许带 /ask、/answer、/a 前缀；也允许纯内容（如 `1`）
-  raw = raw.replace(/^\/(?:ask|answer|a)\b[:：]?\s*/i, '').trim()
-  if (!raw) return { ok: false, error: '请在 /ask 后给出你的选择，例如 `/ask 1`。' }
-  // 全局前缀 `=`：`/ask =自由文本` 表示"直接自由输入"（不指定问题编号，
-  // 单问时等价于给该问 custom；多问时报错提示需指定编号，避免歧义）。
-  if (raw.startsWith('=')) {
-    const body = raw.slice(1).trim()
-    if (list.length !== 1) {
-      return { ok: false, error: `请指明问题编号，例如 \`/ask 1=${body || '你的答案'}\`（共 ${list.length} 问）。` }
-    }
-    if (!body) return { ok: false, error: '自由输入内容为空。' }
-    return { ok: true, answers: [{ id: list[0].id, selected: [], custom: body }] }
-  }
-
-  // 分段：分号优先；单问时整串就是一段（允许内容里含逗号等）
-  const segments = raw.split(/[;；]/).map((s) => s.trim()).filter((s) => s !== '')
-  const byIndex = new Map()
-  const positional = []
-
-  for (const seg of segments) {
-    // Q1=... / 1=...
-    const m = /^(?:q|Q)?\s*(\d+)\s*[=:：]\s*([\s\S]*)$/.exec(seg)
-    if (m) {
-      const qi = Number(m[1]) - 1
-      if (!Number.isInteger(qi) || qi < 0 || qi >= list.length) {
-        return { ok: false, error: `问题编号 ${m[1]} 超出范围（共 ${list.length} 问）。` }
-      }
-      byIndex.set(qi, m[2])
-    } else {
-      positional.push(seg)
-    }
-  }
-
-  // 位置式：按序填进尚未指定的问题
-  let posCursor = 0
-  for (const seg of positional) {
-    while (posCursor < list.length && byIndex.has(posCursor)) posCursor += 1
-    if (posCursor >= list.length) return { ok: false, error: `回复的问题数量多于待答问题（共 ${list.length} 问）。` }
-    byIndex.set(posCursor, seg)
-    posCursor += 1
-  }
-
-  const answers = list.map((q, qi) => {
-    const value = byIndex.get(qi)
-    // 未提及 → 视为显式跳过（selected 为空、无 custom）
-    if (value === undefined || value === '') return { id: q.id, selected: [] }
-    const options = Array.isArray(q?.options) ? q.options : []
-
-    // 纯数字/逗号 → 选选项
-    if (/^\s*\d+(\s*[,，]\s*\d+)*\s*$/.test(value)) {
-      const picks = value.split(/[,，]/).map((x) => Number(x.trim()))
-      const selected = []
-      for (const p of picks) {
-        if (!Number.isInteger(p) || p < 1 || p > options.length) {
-          return { __error: `Q${qi + 1} 的选项编号 ${p} 无效（共 ${options.length} 个选项）。` }
-        }
-        const label = String(options[p - 1]?.label ?? '')
-        if (selected.includes(label)) continue
-        if (selected.length > 0 && q?.multiSelect !== true) {
-          return { __error: `Q${qi + 1} 不是多选，请只给一个选项编号。` }
-        }
-        selected.push(label)
-      }
-      return { id: q.id, selected }
-    }
-
-    // 字母编号（a/b/c）→ 也当选项（部分用户会这么回）
-    const letters = value.trim().toLowerCase()
-    if (/^[a-z](\s*[,，]\s*[a-z])*$/.test(letters) && options.length > 0) {
-      const picks = letters.split(/[,，]/).map((x) => x.trim().charCodeAt(0) - 96)
-      if (picks.every((p) => p >= 1 && p <= options.length)) {
-        const selected = picks.map((p) => String(options[p - 1]?.label ?? ''))
-        if (selected.length > 1 && q?.multiSelect !== true) return { __error: `Q${qi + 1} 不是多选，请只给一个选项。` }
-        return { id: q.id, selected }
-      }
-    }
-
-    // 其它一律当自由输入
-    return { id: q.id, selected: [], custom: value }
-  })
-
-  const bad = answers.find((a) => a.__error)
-  if (bad) return { ok: false, error: bad.__error }
-  return { ok: true, answers: answers.map(({ __error, ...rest }) => rest) }
-}
-
-/**
- * 校验答案批次是否满足宿主约束：**每个问题恰好一项**。
- *
- * 宿主 `userQuestions.answer()` 对不满足的批次抛 BAD_ANSWER，因此必须在这里先自查，
- * 避免把非法批次送出去（表现为"点了没反应"）。
- *
- * @param {object[]} answers
- * @param {object[]} questions
- * @returns {{ ok: true } | { ok: false, error: string }}
- */
-export function validateAnswerBatch(answers, questions) {
-  const list = Array.isArray(questions) ? questions : []
-  const batch = Array.isArray(answers) ? answers : []
-  if (batch.length !== list.length) {
-    return { ok: false, error: `答案条目数（${batch.length}）与问题数（${list.length}）不一致。` }
-  }
-  const seen = new Set()
-  for (const ans of batch) {
-    if (!ans || typeof ans.id !== 'string') return { ok: false, error: '答案缺少 id。' }
-    if (seen.has(ans.id)) return { ok: false, error: `答案重复命名了问题 ${ans.id}。` }
-    seen.add(ans.id)
-    if (!Array.isArray(ans.selected)) return { ok: false, error: `问题 ${ans.id} 的 selected 必须是数组。` }
-    if (ans.custom !== undefined && typeof ans.custom !== 'string') return { ok: false, error: `问题 ${ans.id} 的 custom 必须是字符串。` }
-  }
-  for (const q of list) {
-    if (!seen.has(q?.id)) return { ok: false, error: `答案未覆盖问题 ${q?.id}。` }
-  }
-  return { ok: true }
-}
-
-/**
- * 生成的答案在 IM 里回显一行，便于用户确认自己的选择被正确理解。
- * @param {object[]} answers
- * @param {object[]} questions
- */
-export function formatAnswerAck(answers, questions, { number = 0 } = {}) {
-  const list = Array.isArray(questions) ? questions : []
-  const rows = (Array.isArray(answers) ? answers : []).map((ans) => {
-    const q = list.find((item) => item?.id === ans.id)
-    const title = clip(q?.header || q?.question, 30) || ans.id
-    const picked = ans.selected?.length ? ans.selected.join('、') : (ans.custom ? '' : '（已跳过）')
-    const value = ans.custom ? `${picked ? `${picked}；` : ''}${clip(ans.custom, 80)}` : picked
-    return `- **${title}** → ${value || '（已跳过）'}`
-  })
-  const head = `✓ 已提交你的选择${number ? ` (#${number})` : ''}`
-  return [head, ...rows].join('\n')
-}
-
-/** 按钮回调数据里承载的前缀（与审批的 action 值区分开）。 */
-export const ASK_ACTION_PREFIX = 'ask'

package/lib/platform/base.js

@@ -1,147 +0,0 @@
-// dsh-bridge 平台抽象基类
-//
-// 定义 IM 平台适配器的统一接口。每个平台（微信/QQ/飞书/Telegram…）继承本类，
-// 实现协议层（登录、收发消息、typing）。平台无关的会话桥逻辑在 ConversationBridge
-// （lib/platform/conversation-bridge.js）中实现，通过 platform 注入到 bridge。
-//
-// 生命周期：constructor → start() → stop() → dispose()
-// 消息抽象：sendText / sendTyping / sendMedia（由子类实现）
-
-export class Platform {
-  /**
-   * @param {object} opts
-   * @param {object} opts.ctx          Cordis 上下文
-   * @param {object} opts.logger       日志器
-   * @param {object} [opts.config]     已持久化的平台配置（凭证等）
-   * @param {(patch: object) => (void|Promise<void>)} [opts.onPersist]  主插件保存回调
-   * @param {import('./conversation-bridge.js').ConversationBridge} [opts.bridge] 会话桥实例
-   */
-  constructor({ ctx, logger, config = {}, onPersist, bridge } = {}) {
-    this.ctx = ctx
-    this.logger = logger
-    this.config = { ...config }
-    this.onPersist = onPersist ?? (() => {})
-    this.bridge = bridge ?? null
-
-    // 平台标识（子类必须设置）
-    this.id = ''
-    this.name = ''
-
-    // 连接状态与账号：子类可能用 getter 覆盖（如委托给 gateway），
-    // 因此仅在未被子类覆盖时才初始化默认值。
-    if (!('status' in this)) this.status = 'idle'
-    if (!('accountId' in this)) this.accountId = null
-
-    // 扫码/登录的流式状态（RPC 轮询读取）
-    this.loginState = {
-      phase: 'idle',   // idle | qr | scaned | confirmed | done | error
-      qrPayload: null, // 待渲染内容：dataURL 图片 或 二维码文本
-      qrKind: null,    // 'img' | 'text'
-      error: null,
-    }
-
-    this.disposers = []
-  }
-
-  // ---- 平台能力声明（子类可覆盖）----
-
-  get capabilities() {
-    return {
-      supportsGroup: false,   // 是否支持群聊
-      supportsMedia: false,   // 是否支持媒体收发
-      supportsVoice: false,   // 是否支持语音
-      supportsTyping: false,  // 是否支持 typing 状态
-      maxMessageChars: 2000,  // 单条消息最大字符数
-    }
-  }
-
-  get configured() {
-    return false
-  }
-
-  // ---- 生命周期（子类必须实现 start/stop；dispose 已提供默认实现）----
-
-  async start() {
-    throw new Error(`${this.id || 'platform'}: start() not implemented`)
-  }
-
-  async stop() {
-    throw new Error(`${this.id || 'platform'}: stop() not implemented`)
-  }
-
-  dispose() {
-    for (const disposer of this.disposers) {
-      try { disposer() } catch { /* 忽略 */ }
-    }
-    this.disposers = []
-    this.bridge?.dispose?.()
-    this.bridge = null
-  }
-
-  // ---- 消息抽象（子类必须实现）----
-
-  async sendText(peerId, text, opts = {}) {
-    throw new Error(`${this.id || 'platform'}: sendText() not implemented`)
-  }
-
-  async sendTyping(peerId, state) {
-    return Promise.resolve()
-  }
-
-  async sendMedia(peerId, media, opts = {}) {
-    throw new Error(`${this.id || 'platform'}: sendMedia() not implemented`)
-  }
-
-  // ---- 登录（子类必须实现 login；getLoginState 已提供默认）----
-
-  async login(opts = {}) {
-    throw new Error(`${this.id || 'platform'}: login() not implemented`)
-  }
-
-  getLoginState() {
-    return { ...this.loginState }
-  }
-
-  // ---- 状态汇总（供 RPC/UI 读取）----
-
-  getStatus() {
-    return {
-      id: this.id,
-      name: this.name,
-      status: this.status,
-      configured: this.configured,
-      accountId: this.accountId,
-      login: this.getLoginState(),
-      peerId: this.bridge?.peerId ?? null,
-      sessionId: this.bridge?.activeSessionId ?? null,
-      config: this.getEditableConfig?.(),
-    }
-  }
-
-  /** 可编辑配置（供 UI 设置面板读取）；子类可覆盖返回具体字段。 */
-  getEditableConfig() {
-    return {}
-  }
-
-  // ---- 工具 ----
-
-  setStatus(status) {
-    if (this.status === status) return
-    this.status = status
-    try {
-      this.ctx.emit?.(`${this.id}/status`, status)
-    } catch { /* emit 失败不致命 */ }
-  }
-
-  async persist(patch) {
-    try {
-      await this.onPersist(patch)
-    } catch (err) {
-      this.logger?.warn?.(`[dsh-bridge ${this.id}] persist failed: %s`, err?.message ?? err)
-    }
-  }
-
-  async destroy() {
-    this.dispose()
-  }
-}

package/lib/platform/changes-digest.js

@@ -1,93 +0,0 @@
-// 本轮改动摘要 / 统一 diff 生成（纯函数，便于单测）
-//
-// 数据来源：宿主 `@deepseek-ai/dsh-workspace-changes` 服务（Web 端「改动/交付物」面板的同一份数据）
-//   ctx.workspaceChanges.summary(sessionId, seq) → {
-//     turn, cwd, total, added, deleted,
-//     files: [{ path, display, added, deleted, binary?, oversized? }]   // 已按 display 排序、条数受宿主 cap
-//   }
-//   ctx.workspaceChanges.diff(sessionId, seq, index, signal) → { kind:'text', hunks:[{oldStart,oldLines,newStart,newLines,lines[]}] }
-//                                                           | { kind:'binary'|'oversized', path, display }
-//
-// 本模块只负责「把这些数据变成 IM 里可读的摘要文本 / 可下载的 patch 文本」，不做任何 IO。
-
-/** 单个文件的改动量标注（二进制/过大文件宿主不给行数） */
-function describeCounts(file) {
-  if (file?.oversized) return '过大，未统计'
-  if (file?.binary) return '二进制'
-  return `+${Number(file?.added) || 0}/-${Number(file?.deleted) || 0}`
-}
-
-/** 去掉可能破坏 Markdown 代码块的字符（路径里出现反引号时） */
-function safeLabel(text) {
-  return String(text ?? '').replace(/`/g, '')
-}
-
-/**
- * 生成本轮改动摘要文本；**没有改动时返回空串**（调用方据此静默，不刷屏）。
- *
- * @param {object} summary ctx.workspaceChanges.summary(...) 的返回值
- * @param {object} [opts]
- * @param {number} [opts.maxFiles=8] 最多逐条列出的文件数（其余折成"…等 N 个"）
- * @returns {string}
- */
-export function formatChangesDigest(summary, { maxFiles = 8 } = {}) {
-  const total = Number(summary?.total) || 0
-  if (!summary || total <= 0) return ''
-  const files = Array.isArray(summary.files) ? summary.files : []
-  const added = Number(summary.added) || 0
-  const deleted = Number(summary.deleted) || 0
-
-  const head = `📝 **本轮改动** ${total} 个文件（+${added}/-${deleted}）`
-  const shown = files.slice(0, Math.max(0, maxFiles))
-  const lines = shown.map((f) => `- \`${safeLabel(f?.display || f?.path || '(未知)')}\` ${describeCounts(f)}`)
-  const rest = total - shown.length
-  if (rest > 0) lines.push(`- …共 ${total} 个（其余 ${rest} 个未逐条列出）`)
-  if (lines.length === 0) lines.push(`- （宿主未提供逐文件明细，共 ${total} 个）`)
-  return [head, ...lines].join('\n')
-}
-
-/**
- * 生成统一 diff（.patch）文本：逐文件 `diff --git` + `---/+++` + hunk 头 + hunk 行。
- * 与 `git apply` 的路径匹配不保证（宿主给的是 display 路径，可能是 `../` 或 `~` 形式），
- * 主要用途是"发给用户看/存档"，因此保留宿主原样 display 作为路径。
- *
- * @param {object} summary
- * @param {Array<object|undefined>} diffs 与 summary.files 同序的 diff 结果
- * @returns {string}
- */
-export function buildUnifiedPatch(summary, diffs = []) {
-  const total = Number(summary?.total) || 0
-  const files = Array.isArray(summary.files) ? summary.files : []
-  const head = [
-    `# dsh-bridge 本轮改动（第 ${Number(summary?.turn) || 0} 轮）`,
-    `# 共 ${total} 个文件，+${Number(summary?.added) || 0}/-${Number(summary?.deleted) || 0}`,
-    `# 工作区：${safeLabel(summary?.cwd || '(未知)')}`,
-    '',
-  ].join('\n')
-
-  const body = files.map((file, i) => {
-    const display = safeLabel(file?.display || file?.path || `file-${i}`)
-    const diff = diffs[i]
-    const header = [`diff --git a/${display} b/${display}`, `--- a/${display}`, `+++ b/${display}`]
-    if (!diff || diff.kind === 'binary' || diff.kind === 'oversized') {
-      const why = diff?.kind === 'oversized' ? '文件过大，未提供行级 diff' : diff?.kind === 'binary' ? '二进制文件，无行级 diff' : '宿主未提供该文件的 diff'
-      return [...header, `# ${why}`, ''].join('\n')
-    }
-    const hunks = Array.isArray(diff.hunks) ? diff.hunks : []
-    if (hunks.length === 0) return [...header, '# 无行级差异', ''].join('\n')
-    const hunkText = hunks.map((h) => {
-      const head2 = `@@ -${h.oldStart},${h.oldLines} +${h.newStart},${h.newLines} @@`
-      const lines = Array.isArray(h.lines) ? h.lines : []
-      return [head2, ...lines].join('\n')
-    }).join('\n')
-    return [...header, hunkText, ''].join('\n')
-  }).join('\n')
-
-  return head + body
-}
-
-/** patch 附件文件名（含轮次，便于用户区分） */
-export function changesPatchFileName(turn) {
-  const n = Number(turn) || 0
-  return `changes-turn-${n}.patch`
-}