Files
knowledge-governance/web/src/QAMirrorSync.tsx
T
姚章浩 2da96da592 feat(web): 问答流水立即同步改为次按钮并对齐页面边距
为什么:「立即同步」会让后台入队写同步作业,却与只读的「查询」同为蓝色实心主按钮,
容易误点;问答页左边缘比其他模块多缩进 8px,切换页面时标题会跳。

改了什么(同步的启用条件、调用与状态提示不变):
- 「查询」用全站主按钮色;「立即同步」加 qa-sync-action,改为白底钴蓝描边次按钮;
  「本周」悬停不再被主按钮悬停规则染色。
- 查询区、结果区改为与其他模块一致的圆角卡片 + 极轻投影;焦点改为统一光晕。
- 页头改用共享 .page-header(h2→h1,每页一个 h1);横向边距统一 24px,
  纵向保留原有紧凑密度;删掉被后文覆盖、从未生效的重复 padding/gap。
- 问答区硬编码蓝/灰映射回令牌;修正从未定义的 --danger-ink。

验证:typecheck、vitest 全量通过(含 96px 按钮宽度断言);浏览器只读核对
查询=实心钴蓝、立即同步=白底描边,执行一次查询(GET)台账正常;未点击立即同步。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 17:09:43 +08:00

126 lines
4.5 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { useEffect, useRef, useState } from 'react'
import { fetchQAMirrorStatus, mirrorSyncActive, mirrorStateChanged, startQAMirrorSync } from './qaMirror'
import type { QAMirrorStatus } from './qaMirror'
import { newOperationID } from './operationKey'
import './qaMirror.css'
interface ViewProps {
status: QAMirrorStatus | null
error: string
submitting: boolean
onSync: () => void
}
export function QAMirrorSyncView(p: ViewProps) {
const s = p.status
const active = mirrorSyncActive(s)
return (
<section className="qa-mirror-sync" aria-label="问答同步状态">
<div className="qa-mirror-sync-line">
<button
className="qa-query-action qa-sync-action"
type="button"
onClick={p.onSync}
disabled={p.submitting || !s?.worker_ready || active}
>
{p.submitting ? '正在入队…' : active ? '后台同步中…' : '立即同步'}
</button>
</div>
<div role="status" className="qa-ops-muted">
{!s
? '正在读取同步状态…'
: s.blocked
? '源端权限校验未通过,本地读取已阻断;修复授权后可重新同步。'
: !s.ready
? '首次同步尚未完成,暂不把未同步数据视为空结果。'
: ''}
{s?.job && active ? (
<span>
{' '}
{s.job.expected > 0
? `已检查 ${s.job.loaded} / ${s.job.expected} 条,取回变化 ${s.job.changed} 条。`
: '正在检查源端变化。'}
</span>
) : null}
{s?.error_code && s.error_code !== 'initial_sync_pending' && !s.blocked ? (
<span className="qa-ops-warning"> 最近同步失败,保留上次成功数据;请检查源端连接后重试。</span>
) : null}
{s && !s.worker_ready ? <span className="qa-ops-warning"> 同步执行器未在线。</span> : null}
</div>
{p.error ? (
<p className="error-banner" role="alert">
{p.error}
</p>
) : null}
</section>
)
}
export function QAMirrorSync({ onChanged }: { onChanged: () => void }) {
const [status, setStatus] = useState<QAMirrorStatus | null>(null),
[error, setError] = useState(''),
[submitting, setSubmitting] = useState(false)
const key = useRef('')
const acceptedJob = useRef('')
const changed = useRef(onChanged)
changed.current = onChanged
const observed = useRef<{ revision: number; blocked: boolean; ready: boolean } | undefined>(undefined)
const kick = useRef<() => void>(() => {})
useEffect(() => {
let disposed = false,
timer: ReturnType<typeof setTimeout> | undefined
const controller = new AbortController()
let inFlight = false
const read = async () => {
if (disposed || inFlight) return
inFlight = true
let next = 15000
try {
const fresh = await fetchQAMirrorStatus(controller.signal)
if (disposed) return
const previous = observed.current
observed.current = { revision: fresh.revision, blocked: fresh.blocked, ready: fresh.ready }
setStatus(fresh)
setError('')
if (mirrorStateChanged(previous, fresh)) changed.current()
if (!mirrorSyncActive(fresh) && fresh.job?.id === acceptedJob.current) {
key.current = ''
acceptedJob.current = ''
}
if (mirrorSyncActive(fresh) || !fresh.ready) next = 2500
} catch (e) {
if (!disposed) setError(e instanceof Error ? e.message : '本地同步状态读取失败')
} finally {
inFlight = false
if (!disposed) {
clearTimeout(timer)
timer = setTimeout(() => void read(), next)
}
}
}
kick.current = () => {
clearTimeout(timer)
void read()
}
void read()
return () => {
disposed = true
controller.abort()
clearTimeout(timer)
kick.current = () => {}
}
}, [])
const synchronize = async () => {
if (submitting || mirrorSyncActive(status)) return
setSubmitting(true)
setError('')
if (!key.current) key.current = newOperationID()
try {
acceptedJob.current = await startQAMirrorSync(key.current)
kick.current()
} catch (e) {
setError(e instanceof Error ? e.message : '同步请求未确认,请重试,已有本地数据不变')
} finally {
setSubmitting(false)
}
}
return <QAMirrorSyncView status={status} error={error} submitting={submitting} onSync={() => void synchronize()} />
}