Files
knowledge-governance/web/src/SourceLinkManager.tsx
T
姚章浩 e34306b2db
build / build (push) Failing after 18s
fix(ui): 已释放窗口不再渲染 held 文案,版本页不再把 500 说成未接线
发布管理:maintenanceSummary 只看 job.state === 'failed' 就给 held 处置文案;
窗口已 released 的旧作业(libsync-internal-1793399248431728863)因此自相矛盾。
改为仅 held 时给 recoveryError,已释放时给 releasedFailure(如实记录失败,不提供强制成功)。

版本记录:LoadVersionHistorySyncState 把可空的 finished_at 扫进 time.Time;
部署重启触发的同步在"进行中"时该列为 NULL,扫描失败使整页 500
(nginx access log:GET /api/v1/version-history?limit=30 → 500,74 字节错误体)。
改为指针接值再判空。前端同时区分"未配置/加载失败"并显示服务端 code。

RED/GREEN:新增 Go 集成用例(NULL finished_at)、两条前端用例;
make verify 16/16 通过(local 档案)。
2026-11-01 19:34:31 +08:00

210 lines
7.8 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 { useContext, useEffect, useState } from 'react'
import { fetchCatalogSources } from './sourceCatalog'
import type { CatalogSource } from './sourceCatalog'
import { WorkspaceContextTabsSetter } from './workspaceContext'
import './sourceLinkManager.css'
const typeLabel = { dingtalk: '钉钉知识库', pp: 'PP资料下载中心', alist: 'AList文件源' }
const authLabel = { dingtalk: '专用浏览器扫码登录', pp: '公开访问,无需Key', alist: '只读Token' }
const actionLabel = { dingtalk: '模拟登录并验证目录', pp: '模拟验证公开目录', alist: '模拟验证只读Token' }
const placeholder = {
dingtalk: '粘贴钉钉知识库网页链接(模拟)',
pp: '粘贴PP资料下载中心链接(模拟)',
alist: '例如:https://alist.example.com(模拟)',
}
const linkLabel = { dingtalk: '知识库链接', pp: '资料中心地址', alist: 'AList站点地址' }
interface Props {
sources: CatalogSource[]
selected: CatalogSource | null
validated: boolean
loading: boolean
error: string | null
onSelect: (source: CatalogSource) => void
onValidate: () => void
onRefresh: () => void
}
export function SourceLinkManagerView({
sources,
selected,
validated,
loading,
error,
onSelect,
onValidate,
onRefresh,
}: Props) {
const [link, setLink] = useState('')
return (
<main className="page-shell source-link-manager">
<header className="hero compact">
<div>
<p className="eyebrow">连接配置</p>
<h1>来源链接</h1>
<p className="subtitle">配置钉钉、PP和AList的入口、认证方式及目录验证。</p>
</div>
<button onClick={onRefresh} disabled={loading}>
{loading ? '刷新中…' : '刷新来源'}
</button>
</header>
{error ? (
<div className="error-banner" role="alert">
{error}
</div>
) : null}
<div className="simulation-banner">
<strong>本地模拟配置</strong>
<span>使用真实来源名称和快照数量,但不连接登录服务、不保存真实Key。</span>
</div>
<div className="source-link-layout">
<aside className="source-link-list">
<h2>内容来源</h2>
{sources.map((source) => (
<button
className={selected?.connection_id === source.connection_id ? 'active' : ''}
key={source.connection_id}
onClick={() => {
setLink('')
onSelect(source)
}}
>
<span>
<b>{source.name}</b>
<small>{typeLabel[source.source_type]}</small>
</span>
<strong>{source.file_count}份</strong>
</button>
))}
{!loading && !error && !sources.length ? <div className="empty-state">尚无来源链接。</div> : null}
</aside>
<section className="source-link-editor">
{selected ? (
<>
<div className="source-link-title">
<div>
<h2>{selected.name}</h2>
<span>{typeLabel[selected.source_type]} · 本地只读快照</span>
</div>
<span className="connection-unverified">模拟验证待执行</span>
</div>
<div className="source-link-fields">
<label>
{linkLabel[selected.source_type]}
<input
value={link}
onChange={(event) => setLink(event.target.value)}
placeholder={placeholder[selected.source_type]}
/>
</label>
<label>
认证方式
<input value={authLabel[selected.source_type]} readOnly />
</label>
<label>
Key或Token
<input value="" disabled placeholder="本地模拟阶段不接收真实Key" />
</label>
<label>
起始目录
<input value={selected.source_type === 'alist' ? `/${selected.name}` : selected.name} readOnly />
</label>
</div>
<div className="source-link-boundary">
<b>当前快照</b>
<span>文件 {selected.file_count}</span>
<span>目录 {selected.folder_count}</span>
<span>不下载文件内容,只读取目录和元数据</span>
<span>不执行上传、移动、重命名或删除</span>
</div>
<button className="validate-source-link" onClick={onValidate}>
{actionLabel[selected.source_type]}
</button>
{validated ? (
<div className="validation-results" aria-label="模拟验证结果">
<div>
<span>网络连接</span>
<b>模拟通过</b>
</div>
<div>
<span>登录或Token</span>
<b>模拟通过</b>
</div>
<div>
<span>根目录</span>
<b>模拟通过</b>
</div>
<div>
<span>读取第一层目录</span>
<b>模拟通过</b>
</div>
<div>
<span>只读边界</span>
<b>模拟通过</b>
</div>
<small>以上只是本地交互模拟;迁移到测试服务器后才执行真实验证。</small>
</div>
) : null}
<p className="credential-note">
真实模式下,新凭据先验证,成功后才替换旧凭据;网页永远不能读取已保存Key。
</p>
</>
) : loading ? (
<div className="empty-state">正在加载来源…</div>
) : null}
</section>
</div>
</main>
)
}
export function SourceLinkManager() {
const [sources, setSources] = useState<CatalogSource[]>([])
const [selected, setSelected] = useState<CatalogSource | null>(null)
const [validated, setValidated] = useState(false)
const [loading, setLoading] = useState(true)
const [error, setError] = useState<string | null>(null)
const [revision, setRevision] = useState(0)
const setContextTabs = useContext(WorkspaceContextTabsSetter)
useEffect(() => {
const controller = new AbortController()
setLoading(true)
void fetchCatalogSources(controller.signal)
.then((result) => {
if (!controller.signal.aborted) {
setSources(result)
setSelected(
(current) =>
(current && result.find((item) => item.connection_id === current.connection_id)) || result[0] || null
)
setError(null)
}
})
.catch((cause) => {
if (!controller.signal.aborted) setError(cause instanceof Error ? cause.message : '加载来源链接失败')
})
.finally(() => {
if (!controller.signal.aborted) setLoading(false)
})
return () => controller.abort()
}, [revision])
useEffect(() => {
setContextTabs(selected ? [{ key: selected.connection_id, label: selected.name, onActivate: () => undefined }] : [])
return () => setContextTabs([])
}, [selected, setContextTabs])
return (
<SourceLinkManagerView
sources={sources}
selected={selected}
validated={validated}
loading={loading}
error={error}
onSelect={(source) => {
setSelected(source)
setValidated(false)
}}
onValidate={() => setValidated(true)}
onRefresh={() => {
setValidated(false)
setRevision((value) => value + 1)
}}
/>
)
}