e00cab2f70
用户对 系统设置 → 数据源配置 的四条要求: ① 这里不要做文件格式筛选(格式归目录级标注决定); ② 列出我账号下能看到的知识库;③ 列出钉盘能看到哪些;④ 勾选那些作为来源。 ① 来源卡片不再渲染 FilenameFilterEditor(目录级筛选仍在「来源与目录」里,按目录就近覆盖)。 ②③ 新端点 GET /api/v1/dingtalk-spaces/available(管理员,只读):用 dws 列举 - 知识库:wiki +space-list --type orgWikiSpace/myWikiSpace(实测 17 + 1 个) - 钉盘:wiki space list --type mySpace/orgSpace(实测 我的文件 + 6 个组织空间) 实测约束写进命令形态:--limit 上限是 50;翻页必须 --page-all(--max-items 兜底), 否则超过一页的知识库会被静默截断(被截断时页面显示"可能不全"而不是假装列全)。 列不出来 ≠ 空列表:dws 未登录/权限不足 → 503 + 原因;某一类失败只丢那一类。 ④ 面板勾选后走既有登记路径(/api/v1/dingtalk-spaces),首次目录扫描自动排队; 已登记的按空间名标「已是来源」并禁用勾选;扫码会话失效时直接弹二维码,扫完自动重试。 基础设施:api 与 worker 共享同一份 dws 状态(bind mount 同一份,refresh token 是轮换制, 不能各留一份)。子进程 HOME 必须指向 DWS_HOME —— 这条是实测踩出来的:漏了会报"未登录", 已有回归测试钉住。dws 子进程沿用白名单环境,库口令等变量不进子进程。 测试:新包 internal/dingtalkdiscovery(fixture 用真实 dws 输出形状):paging 约束、 截断提示、一类失败不连带、全部失败→ErrUnavailable、子进程环境;httpapi 侧 401/501/503/500 与不泄漏内部错误;OpenAPI 契约(400/503 组件)通过。前端 189 条 + tsc 干净。 面板实测:知识库(18)/钉盘(7)都列出来,已有三条钉钉来源自动标「已是来源」; 勾选「视觉文档」→ 加入为来源 → 新来源 sc-8a4be5b8293d1c9a048c3c7e9b194155(dingtalk,enabled) + source.catalog.refresh 已完成。
137 lines
6.7 KiB
TypeScript
137 lines
6.7 KiB
TypeScript
import { useCallback, useEffect, useState } from 'react'
|
||
|
||
import { DingtalkRequestError, registerDingtalkSpace } from './dingtalkSession'
|
||
import { DingtalkSessionControl } from './DingtalkSessionControl'
|
||
import { discoveryCandidates, fetchAvailableDingtalkSources, type AvailableDingtalkSources, type DiscoveryCandidate } from './dingtalkSources'
|
||
|
||
// 「系统设置 → 数据源配置」里的数据源发现面板(管理员):
|
||
// ① 列出当前钉钉账号(dws)能看到的钉钉知识库;
|
||
// ② 列出钉盘空间(我的文件 / 组织空间);
|
||
// ③ 勾选后加入为来源(登记走既有路径,首次目录扫描自动排队);
|
||
// ④ 登记需要有效的钉钉扫码会话:会话失效时直接弹二维码,扫完自动重试本次登记。
|
||
// 这里不显示文件格式筛选:格式由目录级标注决定,不在这张卡上做。
|
||
|
||
export function DingtalkSourceDiscovery({ registeredNames, onRegistered }: { registeredNames: string[]; onRegistered: () => void }) {
|
||
const [list, setList] = useState<AvailableDingtalkSources | null>(null)
|
||
const [loading, setLoading] = useState(false)
|
||
const [loadError, setLoadError] = useState<string | null>(null)
|
||
const [checked, setChecked] = useState<string[]>([])
|
||
const [busy, setBusy] = useState(false)
|
||
const [message, setMessage] = useState<string | null>(null)
|
||
const [failure, setFailure] = useState<string | null>(null)
|
||
const [loginRequired, setLoginRequired] = useState(false)
|
||
|
||
const load = useCallback(async (signal?: AbortSignal) => {
|
||
setLoading(true); setLoadError(null)
|
||
try {
|
||
const next = await fetchAvailableDingtalkSources(signal)
|
||
setList(next)
|
||
// 已登记的默认不再勾选:避免重复登记。
|
||
setChecked([])
|
||
} catch (cause) {
|
||
if (cause instanceof DOMException && cause.name === 'AbortError') return
|
||
setLoadError(cause instanceof Error ? cause.message : '列举数据源失败')
|
||
setList(null)
|
||
} finally {
|
||
setLoading(false)
|
||
}
|
||
}, [])
|
||
|
||
useEffect(() => {
|
||
const controller = new AbortController()
|
||
void load(controller.signal)
|
||
return () => controller.abort()
|
||
}, [load])
|
||
|
||
const candidates = discoveryCandidates(list, registeredNames)
|
||
const knowledgeBases = candidates.filter((item) => item.kind === 'knowledge_base')
|
||
const driveSpaces = candidates.filter((item) => item.kind === 'drive_space')
|
||
const selected = candidates.filter((item) => checked.includes(item.key))
|
||
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); setMessage(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 resumeAfterLogin = () => {
|
||
setLoginRequired(false)
|
||
setFailure(null)
|
||
void submit(true)
|
||
}
|
||
|
||
const renderRow = (candidate: DiscoveryCandidate) => {
|
||
const already = candidate.alreadyRegistered
|
||
return <li key={candidate.key} className={already ? 'discovery-row registered' : 'discovery-row'}>
|
||
<label>
|
||
<input type="checkbox" aria-label={`选择${candidate.name}`} checked={checked.includes(candidate.key)} disabled={already || busy} onChange={() => toggle(candidate.key)} />
|
||
<span><strong>{candidate.name}</strong><small>{candidate.detail}</small></span>
|
||
</label>
|
||
{already ? <span className="safe-badge">已是来源</span> : null}
|
||
</li>
|
||
}
|
||
|
||
return <section className="dingtalk-discovery" aria-label="可加入的数据源">
|
||
<div className="dingtalk-discovery-heading">
|
||
<div>
|
||
<strong>可加入的来源</strong>
|
||
<small>按当前钉钉账号列出能访问的知识库与钉盘空间;勾选后加入为来源,首次目录扫描自动排队。</small>
|
||
</div>
|
||
<button type="button" className="secondary" onClick={() => void load()} disabled={loading}>{loading ? '正在列举…' : '刷新列表'}</button>
|
||
</div>
|
||
{loadError ? <p className="error-message" role="alert">{loadError}</p> : null}
|
||
{list ? <div className="dingtalk-discovery-groups">
|
||
<div className="discovery-group">
|
||
<h4>知识库({knowledgeBases.length})</h4>
|
||
{list.knowledge_notice ? <small className="empty-inline">知识库列表可能不全:{list.knowledge_notice}</small> : null}
|
||
{knowledgeBases.length ? <ul>{knowledgeBases.map(renderRow)}</ul> : <small className="empty-inline">当前账号下没有可访问的知识库。</small>}
|
||
</div>
|
||
<div className="discovery-group">
|
||
<h4>钉盘({driveSpaces.length})</h4>
|
||
{list.drive_notice ? <small className="empty-inline">钉盘这次列不出来:{list.drive_notice}</small> : null}
|
||
{!list.drive_notice && !driveSpaces.length ? <small className="empty-inline">当前账号下没有可见的钉盘空间。</small> : null}
|
||
{driveSpaces.length ? <ul>{driveSpaces.map(renderRow)}</ul> : null}
|
||
</div>
|
||
</div> : null}
|
||
<div className="dingtalk-discovery-actions">
|
||
<button type="button" disabled={!selected.length || busy} onClick={() => void submit()}>{busy ? '正在加入…' : `加入为来源(选中 ${selected.length})`}</button>
|
||
<small>勾选的知识库会登记为来源连接;已登记的条目标为「已是来源」,不会重复登记。</small>
|
||
</div>
|
||
{message ? <p className="success-message" role="status">{message}</p> : null}
|
||
{failure ? <p className="error-message" role="alert">{failure}</p> : null}
|
||
{loginRequired ? <DingtalkSessionControl
|
||
autoStart
|
||
hideTrigger
|
||
space={selected[0]?.url}
|
||
onSuccess={resumeAfterLogin}
|
||
onClose={() => setLoginRequired(false)}
|
||
/> : null}
|
||
</section>
|
||
} |