@lemoncat7/dsh-knowledge 2.6.1 → 2.8.0

package/web/document-sync.js

@@ -0,0 +1,43 @@
+/** One bounded metadata poll for the active document; no full-library reloads. */
+export function createDocumentSync({ current, check, refresh, notify, visible = () => !document.hidden, interval = 5000 }) {
+  let timer, controller, stopped = false, failures = 0
+  const same = target => {
+    const active = current()
+    return active && active.identity === target.identity && active.version === target.version && active.key === target.key
+  }
+  async function tick() {
+    clearTimeout(timer)
+    if (stopped || controller) return
+    const target = visible() ? current() : null
+    if (!target) return schedule()
+    controller = new AbortController()
+    const timeout = setTimeout(() => controller?.abort(), 10000)
+    try {
+      const remote = await check(target, controller.signal)
+      if (stopped || !visible() || !same(target)) return
+      failures = 0
+      if (remote.version !== target.version || remote.updatedAt !== target.updatedAt) {
+        if (current().busy()) notify(target, 'changed')
+        else await refresh(target, controller.signal, () => !stopped && visible() && same(target) && !current().busy())
+      } else notify(target, 'current')
+    } catch (error) {
+      if (!stopped && same(target)) {
+        failures++
+        notify(target, error.status === 404 ? 'missing' : 'offline')
+      }
+    } finally {
+      clearTimeout(timeout)
+      controller = null
+      schedule()
+    }
+  }
+  function schedule() {
+    clearTimeout(timer)
+    if (!stopped && visible()) timer = setTimeout(tick, Math.min(30000, interval * 2 ** Math.min(failures, 3)))
+  }
+  return {
+    wake() { if (!stopped) void tick() },
+    pause() { clearTimeout(timer); controller?.abort() },
+    stop() { stopped = true; clearTimeout(timer); controller?.abort() },
+  }
+}

package/web/styles.css

@@ -1,3 +1,17 @@
+.document-sync-notice {
+  flex: 1 0 100%; display: flex; flex-wrap: wrap; align-items: center; gap: 8px;
+  padding: 8px 0 0; color: var(--text); font-size: 12px;
+  border-top: 1px solid var(--separator); overflow-wrap: anywhere;
+}
+.note-editor-toolbar:has(.document-sync-notice), .notes-document-toolbar:has(.document-sync-notice) { flex-wrap: wrap; }
+.sync-conflict-dialog { width: min(980px, calc(100vw - 32px)); max-width: 980px; }
+.sync-conflict-body { display: grid; gap: 16px; }
+.sync-merge-columns { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 16px; }
+.sync-merge-columns section { min-width: 0; display: flex; flex-direction: column; gap: 8px; }
+.sync-merge-columns h3, .sync-merge-columns p { margin: 0; overflow-wrap: anywhere; }
+.sync-conflict-dialog .sync-merge-content { width: 100%; height: 260px; min-height: 200px; resize: vertical; line-height: 1.6; }
+@media (max-width: 640px) { .sync-merge-columns { grid-template-columns: minmax(0, 1fr); } }
+
 :root {
   color-scheme: light dark;
   font-family: var(--font-ui);
@@ -2028,3 +2042,12 @@ html,
 @media (forced-colors: active) {
   .status-dot, .history-dot { forced-color-adjust: none; }
 }
+/* Durable outbox: reuse workspace controls and surfaces, no animated cards. */
+.writeback-workspace { display: grid; gap: 12px; min-width: 0; }
+.writeback-toolbar { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }
+.writeback-toolbar input { flex: 1 1 220px; min-width: 0; }
+.writeback-job-list { display: grid; gap: 12px; }
+.writeback-job { padding: 12px; border: 1px solid var(--border); border-radius: 12px; min-width: 0; }
+.writeback-job p { margin: 8px 0; overflow-wrap: anywhere; }
+.writeback-job-key { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; margin-top: 8px; }
+.writeback-job pre { white-space: pre-wrap; overflow-wrap: anywhere; }

package/web/writeback-live.d.ts

@@ -0,0 +1 @@
+export function subscribeWritebackChanges(client: 'conversation-web' | 'management-web', listener: () => void): () => void

package/web/writeback-live.js

@@ -0,0 +1,52 @@
+// Shared by visible conversation turns; the iframe owns its own single channel.
+const groups = new Map()
+export function subscribeWritebackChanges(client, listener) {
+  let group = groups.get(client)
+  if (!group) {
+    const listeners = new Set()
+    let stopped = false, request, timer, revision = '', failures = 0
+    function emit() { for (const fn of listeners) fn() }
+    async function poll() {
+      if (stopped || document.hidden) return
+      const controller = new AbortController()
+      request = controller
+      try {
+        const response = await fetch(`/knowledge-control/v1/writeback-changes?since=${encodeURIComponent(revision)}`, {
+          credentials: 'same-origin', cache: 'no-store', headers: { 'x-dsh-knowledge-client': client },
+          signal: AbortSignal.any([controller.signal, AbortSignal.timeout(25000)]),
+        })
+        if (!response.ok) throw new Error('notification transport unavailable')
+        const data = await response.json()
+        if (typeof data.revision !== 'string') throw new Error('invalid revision')
+        if (stopped || controller.signal.aborted) return
+        const changed = revision !== data.revision || failures > 0
+        revision = data.revision
+        failures = 0
+        if (changed) emit()
+      } catch { if (!controller.signal.aborted) failures++ }
+      finally {
+        if (request === controller) {
+          request = undefined
+          if (!stopped && !document.hidden) timer = setTimeout(poll, failures ? Math.min(30000, 1000 * 2 ** Math.min(failures, 5)) : 0)
+        }
+      }
+    }
+    function resume() {
+      clearTimeout(timer)
+      request?.abort()
+      request = undefined
+      if (!document.hidden && !stopped) { emit(); void poll() }
+    }
+    document.addEventListener('visibilitychange', resume)
+    window.addEventListener('online', resume)
+    group = { listeners, close() { stopped = true; clearTimeout(timer); request?.abort(); document.removeEventListener('visibilitychange', resume); window.removeEventListener('online', resume) } }
+    groups.set(client, group)
+    // Let the first caller attach before the initial revision arrives.
+    timer = setTimeout(poll, 0)
+  }
+  group.listeners.add(listener)
+  return () => {
+    group.listeners.delete(listener)
+    if (!group.listeners.size) { group.close(); groups.delete(client) }
+  }
+}

package/web/writeback-workspace.js

@@ -0,0 +1,76 @@
+import { subscribeWritebackChanges } from './writeback-live.js'
+/** Local outbox UI. Poll only this view, never reload the knowledge workspace. */
+export function createWritebackWorkspace({ element, actionButton, openConfirm, sessionId = '' }) {
+  const labels = { queued: '排队中', running: '回写中', failed: '失败', completed: '已完成', cancelled: '已取消' }
+  let disposed = false, timer, request, offset = 0, busy = false, previous = '', dirty = false
+  const message = element('p', { role: 'status' })
+  const list = element('div', { class: 'writeback-job-list' })
+  const page = element('span', {})
+  const filter = element('input', { class: 'input', value: sessionId, placeholder: '按会话编号筛选（可留空）', 'aria-label': '会话编号' })
+  const previousButton = actionButton('上一页', () => { offset = Math.max(0, offset - 50); previous = ''; void refresh() }, 'ghost small')
+  const nextButton = actionButton('下一页', () => { offset += 50; previous = ''; void refresh() }, 'ghost small')
+  const root = element('section', { class: 'writeback-workspace' },
+    element('p', {}, '本机回写队列。同一会话按顺序执行；网络中断会自动重试，连续失败可手动重试或取消。取消不会撤销已经写入的内容。'),
+    element('div', { class: 'writeback-toolbar' }, filter, actionButton('筛选', () => { sessionId = filter.value.trim(); offset = 0; previous = ''; void refresh() }, 'small'), actionButton('刷新', () => { void refresh() }, 'ghost small')),
+    message, list, element('div', { class: 'writeback-toolbar' }, previousButton, page, nextButton))
+  async function fetchJson(params, method = 'GET', signal) {
+    const response = await fetch(`/knowledge-control/v1/writeback-jobs?${params}`, { method, credentials: 'same-origin', headers: { 'x-dsh-knowledge-client': 'management-web' }, signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(15000)]) : AbortSignal.timeout(15000) })
+    const data = await response.json().catch(() => ({}))
+    if (!response.ok) throw new Error(data.error || `读取回写队列失败（${response.status}）`)
+    return data
+  }
+  async function operate(job, action) {
+    if (busy || disposed) return
+    busy = true
+    request?.abort()
+    message.textContent = action === 'cancel' ? '正在请求取消…' : '正在提交重试…'
+    try {
+      const result = await fetchJson(new URLSearchParams({ action, sourceKey: job.sourceKey }), 'POST')
+      message.textContent = result.summary
+      previous = ''
+    } catch (error) { message.textContent = error.message }
+    finally { busy = false; if (!disposed) void refresh(true) }
+  }
+  function renderJob(job) {
+    const actions = element('div', { class: 'writeback-toolbar' })
+    if (job.status === 'failed') actions.append(actionButton('重试', () => operate(job, 'retry'), 'small'))
+    if (['queued', 'running', 'failed'].includes(job.status)) actions.append(actionButton(job.cancelRequested ? '取消中…' : '取消回写', () => openConfirm({ title: '取消这条回写？', message: '取消后不再重试，并允许后续轮次继续。已经写入的内容不会撤销。', confirmLabel: '取消回写', danger: true, onConfirm: () => operate(job, 'cancel') }), 'ghost small', { disabled: job.cancelRequested }))
+    return element('article', { class: 'writeback-job' },
+      element('div', { class: 'writeback-toolbar' }, element('strong', {}, labels[job.status] || job.status), element('span', {}, `已尝试 ${job.attempts} 次`), actions),
+      element('div', { class: 'writeback-job-key', title: job.sourceKey }, job.sourceKey),
+      job.createdAt ? element('p', {}, '创建于 ', element('time', { datetime: new Date(job.createdAt).toISOString() }, new Date(job.createdAt).toLocaleString())) : element('p', {}, '历史任务 · 创建时间未记录'),
+      element('p', {}, job.summary),
+      job.blockedBy ? element('p', {}, `阻塞任务：${job.blockedBy}`) : null,
+      job.nextAttemptAt ? element('p', {}, `下次自动重试：${new Date(job.nextAttemptAt).toLocaleString()}`) : null,
+      job.error ? element('details', {}, element('summary', {}, '失败原因'), element('pre', {}, job.error)) : null,
+      ...(job.destinations || []).map(destination => element('p', {}, `${destination.knowledgeBaseName} / ${destination.documentTitle || destination.documentId || ''}`)))
+  }
+  async function refresh(preserveMessage = false) {
+    clearTimeout(timer)
+    if (disposed || document.hidden || busy) return
+    dirty = false
+    request?.abort()
+    const controller = new AbortController()
+    request = controller
+    try {
+      const data = await fetchJson(new URLSearchParams({ sessionId, offset: String(offset) }), 'GET', controller.signal)
+      if (disposed || request !== controller) return
+      const fingerprint = JSON.stringify(data)
+      if (fingerprint !== previous) {
+        list.replaceChildren(...(data.items.length ? data.items.map(renderJob) : [element('p', {}, '没有回写任务')]))
+        previous = fingerprint
+      }
+      page.textContent = `共 ${data.total} 条 · 第 ${Math.floor(offset / 50) + 1} 页`
+      previousButton.disabled = offset === 0
+      nextButton.disabled = offset + 50 >= data.total
+      if (!preserveMessage) message.textContent = '状态自动更新'
+    } catch (error) { if (!controller.signal.aborted && !disposed) message.textContent = `${error.message}；将自动重连` }
+    finally { if (request === controller) { request = undefined; if (!disposed) timer = setTimeout(() => refresh(), dirty ? 0 : 5000) } }
+  }
+  function visibility() { if (document.hidden) { clearTimeout(timer); request?.abort() } else void refresh() }
+  document.addEventListener('visibilitychange', visibility)
+  window.addEventListener('online', visibility)
+  const unsubscribeChanges = subscribeWritebackChanges('management-web', () => { if (request || busy) dirty = true; else void refresh() })
+  void refresh()
+  return { root, dispose() { disposed = true; clearTimeout(timer); request?.abort(); unsubscribeChanges(); document.removeEventListener('visibilitychange', visibility); window.removeEventListener('online', visibility) } }
+}