import { useCallback, useEffect, useMemo, useState } from 'react' import { DingtalkRequestError, registerDingtalkSpace } from './dingtalkSession' import { DingtalkSessionControl } from './DingtalkSessionControl' import { discoveryCandidates, fetchAvailableDingtalkSources, type AvailableDingtalkSources, type DiscoveryCandidate, } from './dingtalkSources' import './sourceWizard.css' // 「系统设置 → 数据源配置」的统一添加向导。 // 一个入口、五步固定:类型 → 授权 → 范围 → 校验 → 保存。 // 类型只决定「候选从哪来」与「授权怎么说明」,版式和动作词完全一致。 // 对内/对外不在这里配置:策略只在「来源与目录」标注。 // 单篇钉钉文档/表格不进这里——把链接发给我,我用 dws 导入。 type SourceKind = 'wiki' | 'drive' | 'pp' const kinds: { key: SourceKind; title: string; detail: string; icon: string }[] = [ { key: 'wiki', title: '钉钉知识库', detail: '组织 / 我的知识库', icon: '库' }, { key: 'drive', title: '钉盘', detail: '我的文件 / 组织空间', icon: '盘' }, { key: 'pp', title: 'Partner Portal', detail: '公开只读资料中心', icon: '↧' }, ] const steps = ['类型', '授权', '范围', '校验', '保存'] as const export function SourceWizard({ registeredNames, ppConnected, onRegistered, }: { registeredNames: string[] // PP 是一个门户一条来源:已接入时向导只做说明,不重复登记。 ppConnected: boolean onRegistered: () => void }) { const [open, setOpen] = useState(false) const [step, setStep] = useState(0) const [kind, setKind] = useState(null) const [list, setList] = useState(null) const [loading, setLoading] = useState(false) const [loadError, setLoadError] = useState(null) const [checked, setChecked] = useState([]) const [busy, setBusy] = useState(false) const [failure, setFailure] = useState(null) const [message, setMessage] = useState(null) const [loginRequired, setLoginRequired] = useState(false) const load = useCallback(async (signal?: AbortSignal) => { setLoading(true) setLoadError(null) try { setList(await fetchAvailableDingtalkSources(signal)) } catch (cause) { if (cause instanceof DOMException && cause.name === 'AbortError') return setLoadError(cause instanceof Error ? cause.message : '列举数据源失败') setList(null) } finally { setLoading(false) } }, []) useEffect(() => { if (!open || (kind !== 'wiki' && kind !== 'drive')) return const controller = new AbortController() void load(controller.signal) return () => controller.abort() }, [open, kind, load]) const candidates = useMemo(() => discoveryCandidates(list, registeredNames), [list, registeredNames]) const visible = useMemo( () => candidates.filter((item) => kind === 'wiki' ? item.kind === 'knowledge_base' : kind === 'drive' ? item.kind === 'drive_space' : false ), [candidates, kind] ) const selected = visible.filter((item) => checked.includes(item.key)) const close = () => { setOpen(false) setStep(0) setKind(null) setChecked([]) setFailure(null) setMessage(null) setLoginRequired(false) } const toggle = (key: string) => setChecked((current) => (current.includes(key) ? current.filter((item) => item !== key) : [...current, key])) const submit = async (retryAfterLogin = false) => { setBusy(true) setFailure(null) const added: string[] = [] const failed: string[] = [] let needLogin = false for (const candidate of selected) { try { const result = await registerDingtalkSpace(candidate.url) added.push(result.name || candidate.name) } catch (cause) { if (cause instanceof DingtalkRequestError && cause.code === 'login_required' && !retryAfterLogin) { needLogin = true break } failed.push(`${candidate.name}:${cause instanceof Error ? cause.message : '登记失败'}`) } } setBusy(false) if (needLogin) { setLoginRequired(true) setFailure('钉钉扫码会话已失效:扫码后会自动继续这次添加。') return } if (added.length) { setMessage(`已加入 ${added.length} 个来源:${added.join('、')}。首次目录扫描已在后台排队。`) onRegistered() void load() } if (failed.length) setFailure(failed.join(';')) } const canAdvance = (step === 0 && kind !== null) || (step === 1 && kind !== null) || (step === 2 && (kind === 'pp' || selected.length > 0)) || (step === 3 && (kind === 'pp' || selected.length > 0)) return (

数据源

{open ? (
    {steps.map((label, index) => (
  1. {index + 1} {label}
  2. ))}
{step === 0 ? (
{kinds.map((item) => ( ))}
) : null} {step === 1 ? (
{kind === 'pp' ? ( <>
授权方式 公开只读
凭据 由服务端持有,无需填写

资料下载中心的登录凭据由运维放在服务端,向导里不录入任何密码。

) : ( <>
授权方式 当前钉钉账号扫码会话
读取权限 只读;不写回、不删除源文件

用的是平台已登录的 dws 凭据,不需要每个来源单独扫码;会话失效时会在保存时弹二维码。

)}
) : null} {step === 2 ? (
{kind === 'pp' ? (

{ppConnected ? '已接入 PP 资料下载中心(一个门户一条来源),无需重复添加;刷新与归档在下方清单里做。' : 'PP 需要服务端放置只读凭据后才能接入;凭据到位后联系我开通,向导本身不录密码。'}

) : loading ? (

正在列举当前账号可见的来源…

) : loadError ? (

{loadError}

) : visible.length === 0 ? (

当前账号没有可添加的{kind === 'wiki' ? '知识库' : '钉盘空间'};已加入的不会重复列出。

) : ( <>
{visible.map((item) => ( ))}

已选 {selected.length} 项。勾选空间即可,目录细节加入后再在「来源与目录」里标注。

)}
) : null} {step === 3 ? (
    {(kind === 'pp' ? [] : selected).map((item: DiscoveryCandidate) => (
  • {item.name} 仍可见
  • ))} {kind === 'pp' ? (
  • Partner Portal 公开目录 公开只读可达
  • ) : null}

添加时会按当前账号再读一次;如果已看不到,会拒绝并提示刷新。

) : null} {step === 4 ? (
{message ?

{message}

: null} {failure ?

{failure}

: null} {!message && !failure ? (

将加入{' '} {(kind === 'pp' ? ['Partner Portal'] : selected.map((item) => item.name)).join('、') || '(未选择)'} 。

) : null} {loginRequired ? ( { setLoginRequired(false) void submit(true) }} /> ) : null}
) : null}
{kind === 'pp' ? ( ) : step < 3 ? ( ) : step === 3 ? ( ) : ( )}
) : null}
) }