dsh-plugin-discover 0.0.0-stage → 1.0.0

package/lib/readme-source.js

@@ -0,0 +1,380 @@
+/**
+ * README source resolution for readme-mode vectors.
+ *
+ * Order: GitHub raw (native network) -> npm CDN (exact published version) ->
+ * field-vector fallback in vector.js. GitHub is never sent through a proxy.
+ */
+export const README_REQUEST_TIMEOUT_MS = 30_000
+export const README_TOTAL_BUDGET_MS = 5 * 60_000
+export const README_CONCURRENCY = 4
+export const README_RATE_PER_SECOND = 1
+export const README_RATE_BURST = 1
+export const README_JITTER_MIN_MS = 50
+export const README_JITTER_MAX_MS = 150
+export const CIRCUIT_COOLDOWN_MS = 10 * 60_000
+export const NEGATIVE_CACHE_TTL_MS = 24 * 60 * 60_000
+export const GITHUB_HOST = 'raw.githubusercontent.com'
+export const USER_AGENT = 'dsh-plugin-discover/0.1.0'
+
+const GITHUB_FILENAMES = ['README.md', 'readme.md']
+const NPM_PROVIDERS = [
+  ['unpkg', 'https://unpkg.com'],
+  ['jsdelivr', 'https://cdn.jsdelivr.net/npm'],
+]
+
+export const README_NOTICES = {
+  timeout: 'GitHub README requests timed out repeatedly. GitHub access is paused for 10 minutes; remaining READMEs fall back to the npm CDN or field vectors.',
+  'rate-limit': 'GitHub README requests were rate-limited (HTTP 403/429). GitHub access is paused for 10 minutes; remaining READMEs fall back to the npm CDN or field vectors.',
+  transport: 'GitHub README requests failed repeatedly. GitHub access is paused for 10 minutes; remaining READMEs fall back to the npm CDN or field vectors.',
+}
+
+function defaultSleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+/** One token bucket per worker; four workers therefore cap at 4 req/s. */
+export class RateLimiter {
+  constructor({
+    rate = README_RATE_PER_SECOND,
+    burst = README_RATE_BURST,
+    now = () => Date.now(),
+    sleep = defaultSleep,
+  } = {}) {
+    if (!(rate > 0)) throw new Error('rate must be positive')
+    this.rate = rate
+    this.capacity = Math.max(1, burst)
+    this.tokens = this.capacity
+    this.updated = now()
+    this.now = now
+    this.sleep = sleep
+  }
+
+  refill(now) {
+    const elapsed = (now - this.updated) / 1000
+    if (elapsed <= 0) return
+    this.tokens = Math.min(this.capacity, this.tokens + elapsed * this.rate)
+    this.updated = now
+  }
+
+  async take() {
+    for (;;) {
+      const now = this.now()
+      this.refill(now)
+      if (this.tokens >= 1) {
+        this.tokens -= 1
+        return
+      }
+      const wait = Math.max(1, Math.ceil(((1 - this.tokens) / this.rate) * 1000))
+      await this.sleep(wait)
+    }
+  }
+}
+
+/** Small jitter so four workers do not burst at the same millisecond. */
+export async function jitter(sleep = defaultSleep, min = README_JITTER_MIN_MS, max = README_JITTER_MAX_MS) {
+  if (max <= 0) return
+  await sleep(min + Math.random() * Math.max(0, max - min))
+}
+
+/**
+ * GitHub circuit breaker. A success resets the transport-failure run.
+ * 403/429 are counted separately per round; the third opens the same cooldown.
+ */
+export class GithubGuard {
+  constructor({
+    now = () => Date.now(),
+    cooldownMs = CIRCUIT_COOLDOWN_MS,
+    threshold = 3,
+  } = {}) {
+    this.now = now
+    this.cooldownMs = cooldownMs
+    this.threshold = threshold
+    this.openUntil = 0
+    this.reason = null
+    this.transportFailures = 0
+    this.rateLimitHits = 0
+    this.sawTimeout = false
+  }
+
+  beginRound(now = this.now()) {
+    this.transportFailures = 0
+    this.rateLimitHits = 0
+    this.sawTimeout = false
+    this.expire(now)
+  }
+
+  expire(now) {
+    if (this.openUntil && now >= this.openUntil) {
+      this.openUntil = 0
+      this.reason = null
+      this.transportFailures = 0
+      this.rateLimitHits = 0
+      this.sawTimeout = false
+    }
+  }
+
+  canUse(now = this.now()) {
+    this.expire(now)
+    return this.openUntil === 0
+  }
+
+  recordSuccess() {
+    this.transportFailures = 0
+  }
+
+  recordTransportFailure(kind = 'transport', now = this.now()) {
+    if (!this.canUse(now)) return
+    if (kind === 'timeout') this.sawTimeout = true
+    this.transportFailures += 1
+    if (this.transportFailures >= this.threshold) {
+      this.open(now, this.sawTimeout ? 'timeout' : 'transport')
+    }
+  }
+
+  recordRateLimit(now = this.now(), retryAfterMs = 0) {
+    if (!this.canUse(now)) return
+    this.rateLimitHits += 1
+    if (this.rateLimitHits >= this.threshold) {
+      this.open(now, 'rate-limit', Math.max(this.cooldownMs, retryAfterMs))
+    }
+  }
+
+  open(now, reason, cooldown = this.cooldownMs) {
+    this.openUntil = now + cooldown
+    this.reason = reason
+  }
+
+  status(now = this.now()) {
+    this.expire(now)
+    if (!this.openUntil) return null
+    return {
+      open: true,
+      reason: this.reason,
+      host: GITHUB_HOST,
+      until: new Date(this.openUntil).toISOString(),
+    }
+  }
+
+  reset() {
+    this.openUntil = 0
+    this.reason = null
+    this.transportFailures = 0
+    this.rateLimitHits = 0
+    this.sawTimeout = false
+  }
+}
+
+export const githubGuard = new GithubGuard()
+
+export function githubNotice(reason) {
+  return README_NOTICES[reason] ?? README_NOTICES.transport
+}
+
+function stripGit(value) {
+  return String(value).replace(/\.git$/i, '')
+}
+
+export function parseGithubTarget(record) {
+  const target = typeof record?.install?.target === 'string' ? record.install.target : ''
+  const repo = typeof record?.repo === 'string' ? record.repo : ''
+  let owner = ''
+  let name = ''
+  let ref = 'HEAD'
+  const direct = /^github:([^/#]+)\/([^#]+?)(?:#(.+))?$/i.exec(target)
+  if (direct) {
+    owner = direct[1]
+    name = stripGit(direct[2])
+    ref = direct[3] || 'HEAD'
+  } else {
+    const match = /github\.com\/([^/]+)\/([^/#?]+)/i.exec(repo)
+      || /github\.com\/([^/]+)\/([^/#?]+)/i.exec(target)
+    if (match) {
+      owner = match[1]
+      name = stripGit(match[2])
+    }
+  }
+  if (!owner || !name) return null
+  return { owner, name, ref, key: `github:${owner}/${name}@${ref}` }
+}
+
+function splitNpmSpec(spec) {
+  if (typeof spec !== 'string' || spec === '') return null
+  let name = spec
+  let version = null
+  const at = spec.lastIndexOf('@')
+  if (at > 0) {
+    name = spec.slice(0, at)
+    version = spec.slice(at + 1) || null
+  }
+  if (!name || name.includes('://') || name.includes(':')) return null
+  if (name.includes('/') && !name.startsWith('@')) return null
+  if (version === 'latest') version = null
+  return { name, version }
+}
+
+export function parseNpmTarget(record) {
+  const target = typeof record?.install?.target === 'string' ? record.install.target : ''
+  const lower = target.toLowerCase()
+  let spec = ''
+  if (target && !lower.startsWith('github:') && !lower.startsWith('file:') && !lower.startsWith('link:') && !lower.startsWith('http')) {
+    spec = target
+  } else {
+    spec = typeof record?.alias === 'string' && record.alias !== '' ? record.alias : record?.name
+  }
+  const parsed = splitNpmSpec(spec)
+  if (!parsed) return null
+  return {
+    ...parsed,
+    key: `npm:${parsed.name}@${parsed.version ?? 'latest'}`,
+  }
+}
+
+export function readmeTargets(record) {
+  return {
+    github: parseGithubTarget(record),
+    npm: parseNpmTarget(record),
+  }
+}
+
+const npmVersionCache = new Map()
+
+function cacheFresh(entry, now, ttl) {
+  return Boolean(entry && now - entry.at < ttl)
+}
+
+export async function resolveNpmVersion(name, {
+  fetchImpl,
+  limiter = null,
+  sleep = defaultSleep,
+  timeoutMs = README_REQUEST_TIMEOUT_MS,
+  now = () => Date.now(),
+  etag = null,
+} = {}) {
+  const at = now()
+  const cached = npmVersionCache.get(name)
+  const ttl = cached?.version ? 10 * 60_000 : NEGATIVE_CACHE_TTL_MS
+  if (cacheFresh(cached, at, ttl)) return cached?.version ?? null
+  const result = await requestText(
+    `https://registry.npmjs.org/${encodeURIComponent(name)}`,
+    { fetchImpl, limiter, sleep, timeoutMs, etag, accept: 'application/json' },
+  )
+  if (result.status === 404) {
+    npmVersionCache.set(name, { version: null, at })
+    return null
+  }
+  if (typeof result.text !== 'string') return cached?.version ?? null
+  try {
+    const pkg = JSON.parse(result.text)
+    const version = pkg?.['dist-tags']?.latest
+    if (typeof version === 'string' && version !== '') {
+      npmVersionCache.set(name, { version, at })
+      return version
+    }
+  } catch {}
+  return cached?.version ?? null
+}
+
+function retryAfterMs(response) {
+  const value = response?.headers?.get?.('retry-after')
+  if (!value) return 0
+  const seconds = Number(value)
+  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1000)
+  const date = Date.parse(value)
+  return Number.isFinite(date) ? Math.max(0, date - Date.now()) : 0
+}
+
+async function requestText(url, {
+  fetchImpl,
+  limiter = null,
+  sleep = defaultSleep,
+  timeoutMs = README_REQUEST_TIMEOUT_MS,
+  etag = null,
+  accept = 'text/plain',
+} = {}) {
+  if (typeof fetchImpl !== 'function') {
+    return { network: true, error: 'fetch-unavailable' }
+  }
+  if (limiter) await limiter.take()
+  await jitter(sleep)
+  const headers = { 'user-agent': USER_AGENT, accept }
+  if (etag) headers['if-none-match'] = etag
+  try {
+    const response = await fetchImpl(url, {
+      headers,
+      redirect: 'follow',
+      signal: AbortSignal.timeout(timeoutMs),
+    })
+    if (response.status === 304) return { status: 304, notModified: true }
+    if (response.status === 403 || response.status === 429) {
+      return { status: response.status, rateLimited: true, retryAfterMs: retryAfterMs(response) }
+    }
+    if (response.status === 404) return { status: 404 }
+    if (!response.ok) return { status: response.status, transport: response.status >= 500 }
+    const text = (await response.text()).slice(0, 200_000)
+    if (text.trim() === '') return { status: response.status, empty: true }
+    return {
+      status: response.status,
+      text,
+      etag: response.headers?.get?.('etag') ?? null,
+    }
+  } catch (error) {
+    const cause = error?.cause?.code ?? ''
+    const timeout = error?.name === 'TimeoutError'
+      || error?.name === 'AbortError'
+      || String(cause).includes('TIMEOUT')
+    return { network: true, timeout, error: error instanceof Error ? error.message : String(error) }
+  }
+}
+
+export async function fetchGithubReadme(target, {
+  fetchImpl,
+  limiter = null,
+  sleep = defaultSleep,
+  timeoutMs = README_REQUEST_TIMEOUT_MS,
+  etag = null,
+} = {}) {
+  if (!target) return { status: 404 }
+  const ref = String(target.ref)
+    .split('/')
+    .map(segment => encodeURIComponent(segment))
+    .join('/')
+  for (const filename of GITHUB_FILENAMES) {
+    const url = `https://${GITHUB_HOST}/${target.owner}/${target.name}/${ref}/${filename}`
+    const result = await requestText(url, { fetchImpl, limiter, sleep, timeoutMs, etag })
+    if (result.status === 200 && typeof result.text === 'string') {
+      return { ...result, url, source: 'github-raw', key: target.key }
+    }
+    if (result.notModified) return { ...result, url, source: 'github-raw', key: target.key }
+    if (result.status === 404) continue
+    // 403/429/network/5xx: stop the filename loop and report the outcome.
+    return { ...result, url, source: 'github-raw', key: target.key }
+  }
+  return { status: 404, source: 'github-raw', key: target.key }
+}
+
+export async function fetchNpmReadme(pkg, version, {
+  fetchImpl,
+  limiter = null,
+  sleep = defaultSleep,
+  timeoutMs = README_REQUEST_TIMEOUT_MS,
+  etag = null,
+} = {}) {
+  if (!pkg || !version) return { status: 404 }
+  const key = `npm:${pkg}@${version}`
+  let last = { status: 404 }
+  for (const [provider, base] of NPM_PROVIDERS) {
+    for (const filename of GITHUB_FILENAMES) {
+      const url = `${base}/${pkg}@${version}/${filename}`
+      const result = await requestText(url, { fetchImpl, limiter, sleep, timeoutMs, etag })
+      if (result.status === 200 && typeof result.text === 'string') {
+        return { ...result, url, source: 'npm-cdn', provider, key }
+      }
+      if (result.notModified) return { ...result, url, source: 'npm-cdn', provider, key }
+      last = { ...result, source: 'npm-cdn', provider, key }
+      if (result.status === 404) continue
+      if (result.rateLimited) break
+      if (result.transport || result.network) break
+    }
+  }
+  return last
+}

package/lib/report.js

@@ -0,0 +1,244 @@
+/**
+ * The model-facing text report. Two lines per candidate, no summary, no
+ * recommendation prose: the model owns expression, this module owns facts.
+ */
+import { ATTRIBUTION } from './normalize.js'
+
+const CIRCLED = ['①', '②', '③', '④', '⑤', '⑥', '⑦', '⑧', '⑨', '⑩']
+
+function pad(value) {
+  return String(value).padStart(2, '0')
+}
+
+function shortDate(value, now = new Date()) {
+  if (typeof value !== 'string' || value === '') return ''
+  const date = new Date(value)
+  if (Number.isNaN(date.getTime())) return value.slice(0, 10)
+  if (date.getFullYear() === now.getFullYear()) return `${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
+}
+
+function verificationLabel(level) {
+  if (level === 5) return 'L5 已验证'
+  if (typeof level === 'number' && level >= 1 && level <= 5) return `L${level}`
+  return ''
+}
+
+function securityLabel(security) {
+  if (!security) return ''
+  const status = security.status
+  const risk = security.riskLevel
+  if (status === 'failed') return '审计失败'
+  if (status === 'pending' || status === 'skipped') return '未审计'
+  if (risk === 'low') return '低风险'
+  if (risk === 'medium') return '中风险'
+  if (risk === 'high') return '高风险'
+  if (risk === 'critical') return '严重风险'
+  return ''
+}
+
+/** Rough token estimate: one per CJK character, one per four ASCII characters. */
+function estimateTokens(text) {
+  let tokens = 0
+  for (const character of text) {
+    tokens += character.codePointAt(0) >= 0x2e80 ? 1 : 0.25
+  }
+  return tokens
+}
+
+/** Clip a description to a per-item token budget without cutting a surrogate pair. */
+function clipDescription(text, budget = 45) {
+  const value = String(text ?? '').replace(/\s+/g, ' ').trim()
+  if (value === '' || estimateTokens(value) <= budget) return value
+  let kept = ''
+  let tokens = 0
+  for (const character of value) {
+    const cost = character.codePointAt(0) >= 0x2e80 ? 1 : 0.25
+    if (tokens + cost > budget) break
+    tokens += cost
+    kept += character
+  }
+  return `${kept.trimEnd()}…`
+}
+
+function starsLabel(stars) {
+  if (typeof stars !== 'number' || !Number.isFinite(stars) || stars <= 0) return ''
+  return `${stars >= 1000 ? Math.round(stars).toLocaleString('en-US') : stars}★`
+}
+
+function resultLines(result, index, now) {
+  const badges = [starsLabel(result.stars)]
+  const verification = verificationLabel(result.badges?.verification
+    ? Number(String(result.badges.verification).replace('L', ''))
+    : undefined)
+  if (verification) badges.push(verification)
+  const security = securityLabel(result.badges?.security
+    ? { status: result.badges.security, riskLevel: result.badges.security }
+    : null)
+  if (security) badges.push(security)
+  const updated = shortDate(result.badges?.updatedAt, now)
+  if (updated) badges.push(`更新 ${updated}`)
+  const visible = badges.filter(Boolean)
+  const head = `${CIRCLED[index] ?? `${index + 1}.`} ${result.name}${visible.length ? ` · ${visible.join(' · ')}` : ''}`
+  const description = clipDescription(result.description)
+  const target = result.install?.target
+  const suffix = target && target !== result.name ? `   [装: ${target}]` : ''
+  return [head, `   ${description}${suffix}`]
+}
+
+function headerLine(value) {
+  const parts = [`🔍 ${value.results.length} 个候选`]
+  const preset = value.interpreted?.filters?.preset
+  if (preset) {
+    const dropped = value.filterStats?.droppedBy
+    const total = dropped
+      ? dropped.security + dropped.compat + dropped.verification + (dropped.negation ?? 0)
+      : 0
+    const relaxed = value.interpreted.filters.relaxedFrom
+    parts.push(`过滤 ${preset}${relaxed ? `（已从 ${relaxed} 放宽）` : ''}（排除 ${total} 条）`)
+  }
+  if (value.vector) {
+    const vector = value.vector
+    if (vector.degraded) {
+      parts.push(`向量 ${vector.mode} 不可用，已降级词面`)
+    } else if (vector.mode === 'readme' && vector.readmeCovered !== undefined) {
+      const sources = vector.readmeSources
+      const detail = sources
+        ? `（github ${sources.github ?? 0} · npm ${sources.npm ?? 0} · 字段 ${sources.fields ?? 0}）`
+        : (vector.readmeFallback ? `（字段兜底 ${vector.readmeFallback}）` : '')
+      parts.push(`向量 readme 覆盖 ${vector.readmeCovered}/50${detail}`)
+    } else {
+      parts.push(`向量 ${vector.mode} 覆盖 ${vector.covered}/50`)
+    }
+  }
+  return parts.join(' · ')
+}
+
+function footerLines(manifest, now = new Date()) {
+  const lines = []
+  const sources = manifest?.manifest?.sources ?? manifest?.sources
+  const generatedAt = sources?.dshSo?.generatedAt ?? manifest?.manifest?.generatedAt ?? manifest?.generatedAt
+  if (manifest?.manifest?.catalogError || manifest?.catalogError) {
+    lines.push('⚠️ catalog 源不可用，本次只用 dsh.so。')
+  }
+  if (generatedAt) {
+    const date = new Date(generatedAt)
+    if (!Number.isNaN(date.getTime())) {
+      const ageDays = Math.floor((now.getTime() - date.getTime()) / 86_400_000)
+      if (ageDays > 7) lines.push(`⚠️ 数据已 ${ageDays} 天未更新，可能未收录新插件。`)
+      lines.push(`数据截至 ${date.toISOString().slice(0, 10)} · ${ATTRIBUTION}`)
+      return lines
+    }
+  }
+  lines.push(ATTRIBUTION)
+  return lines
+}
+
+function noMatchLines(value, manifest, now) {
+  const lines = [headerLine(value)]
+  const dropped = value.filterStats?.droppedBy
+  const total = dropped
+    ? dropped.security + dropped.compat + dropped.verification + (dropped.negation ?? 0)
+    : 0
+  if (value.indexMissing) {
+    lines.push('索引尚未建立。')
+    lines.push('先执行：npx dsh-plugin-discover build，或用 refresh: true 触发一次后台建库。')
+  } else if (value.explain?.found === false) {
+    lines.push(`没有找到 id / 名称「${value.explain.id}」。可以先用一次普通检索拿到准确 id。`)
+  } else if (value.gates?.gate1 && value.gates.gate1.passed === false
+    && (!value.gates.gate2 || value.gates.gate2.passed === false)) {
+    lines.push('没有候选通过证据检查（词面 gate1 / 语义 gate2），按没有匹配处理。')
+    lines.push('建议：换成更具体的英文/术语改写；中文需求请同时给出 queryAlts 的英文改写；或去掉过于宽泛的改写词。')
+  } else if (total > 0) {
+    lines.push('没有候选同时满足检索词和过滤条件。')
+    lines.push('建议：去掉「不要 / 除了」这类排除条件；换一个更具体的说法；或把过滤档位放宽到 loose。')
+  } else {
+    lines.push('索引里没有匹配这个需求的插件，这是正常结果，不要硬凑。')
+    lines.push('建议：换成英文/术语说法再试；中文需求请同时给出 queryAlts 的英文改写；或先 refresh 更新索引。')
+  }
+  lines.push(...footerLines(manifest, now))
+  return lines
+}
+
+function explainLines(value, manifest, now) {
+  const item = value.explain
+  if (!item || item.found === false) return noMatchLines(value, manifest, now)
+  const badges = [starsLabel(item.stars)]
+  const verification = verificationLabel(item.verification?.level)
+  if (verification) badges.push(verification)
+  const security = securityLabel(item.security)
+  if (security) badges.push(security)
+  const updated = shortDate(item.updatedAt, now)
+  if (updated) badges.push(`更新 ${updated}`)
+  const visible = badges.filter(Boolean)
+  const lines = [
+    `🔎 ${item.name}${visible.length ? ` · ${visible.join(' · ')}` : ''}`,
+    `   ${String(item.description ?? '').replace(/\s+/g, ' ').trim()}`,
+  ]
+  const tags = [...(item.topics ?? []), ...(item.capability ?? [])]
+  if (tags.length > 0) lines.push(`   标签：${[...new Set(tags)].join(', ')}`)
+  if (item.install?.target) lines.push(`   安装目标：${item.install.target}`)
+  if (item.repo) lines.push(`   仓库：${item.repo}`)
+  if (item.dshRange) lines.push(`   兼容范围：${item.dshRange}`)
+  if (item.verification) {
+    lines.push(`   验证：${item.verification.label ?? `L${item.verification.level}`}`
+      + `${item.verification.lastVerifiedAt ? `（${item.verification.lastVerifiedAt.slice(0, 10)}）` : ''}`)
+  }
+  if (item.security) {
+    const counts = item.security.counts
+    lines.push(`   安全：${item.security.status} / ${item.security.riskLevel}`
+      + `${counts ? `（critical ${counts.critical} · warning ${counts.warning}）` : ''}`)
+  }
+  if (item.url) lines.push(`   详情：${item.url}`)
+  if (item.alternatives?.length) lines.push(`   同仓库其他包：${item.alternatives.map(alt => alt.name).join(', ')}`)
+  lines.push(...footerLines(manifest, now))
+  return lines
+}
+
+/**
+ * Render the report.
+ * @param {object} value tool value
+ * @param {{ manifest?: object, building?: boolean, indexing?: boolean, now?: Date }} state
+ */
+export function textReport(value, state = {}) {
+  const now = state.now ?? new Date()
+  const circuit = value.vector?.circuit?.open && value.vector?.notice
+    ? `⚠️ ${value.vector.notice}`
+    : ''
+  const indexNotice = value.index?.notice ? `⚠️ ${value.index.notice}` : ''
+  const notices = [circuit, indexNotice].filter(Boolean)
+  if (value.refresh) {
+    const refresh = value.refresh
+    return [
+      refresh.started ? '📚 已开始后台建库，立即返回；建好后重新检索即可。' : '📚 建库没有启动。',
+      refresh.reason === 'running' ? '已有一个建库任务在运行。' : '',
+      refresh.reason === 'locked' ? '另一个进程持有建库锁。' : '',
+      ATTRIBUTION,
+    ].filter(Boolean).join('\n')
+  }
+  if (state.indexing) {
+    return [
+      '🔍 索引尚未建立。',
+      '已在后台开始建库（首次约 1–3 分钟，约 25 MB 下载）；建好后重新调用即可。',
+      '也可以前台执行：npx dsh-plugin-discover build',
+      ATTRIBUTION,
+    ].join('\n')
+  }
+  if (value.explain) return explainLines(value, state.manifest, now).join('\n')
+  if (value.results.length === 0) {
+    const lines = noMatchLines(value, state.manifest, now)
+    if (notices.length > 0) lines.unshift(...notices)
+    return lines.join('\n')
+  }
+
+  const lines = [headerLine(value), '']
+  if (notices.length > 0) lines.unshift(...notices)
+  value.results.forEach((result, index) => {
+    lines.push(...resultLines(result, index, now))
+  })
+  lines.push('')
+  lines.push(...footerLines(state.manifest, now))
+  if (state.building) lines.push('⏳ 索引正在后台更新，当前结果来自上一版索引。')
+  if (state.lastError) lines.push('⚠️ 上次建库失败，当前结果来自上一版索引。')
+  return lines.join('\n')
+}