// 「系统设置 → 数据源配置」的数据源发现客户端:列出当前 dws 账号能看到的钉钉知识库与钉盘空间。 // 只读;勾选后的登记仍走既有的 /api/v1/dingtalk-spaces(由扫码会话解析空间根目录)。 export interface AvailableKnowledgeBase { name: string space_id: string space_type?: string url: string description?: string } export interface AvailableDriveSpace { name: string space_id: string space_type: string root_folder_id?: string } export interface AvailableDingtalkSources { knowledge_bases: AvailableKnowledgeBase[] drive_spaces: AvailableDriveSpace[] /** 知识库这一类为什么不全(某类无权限、被上限截断)。 */ knowledge_notice?: string /** 钉盘这一类为什么列不出来(租户权限差异)。 */ drive_notice?: string fetched_at: string } // 钉盘空间的链接形态与知识库一致(空间 id 决定地址),勾选后按同一条登记路径提交。 export function driveSpaceURL(spaceID: string): string { return `https://alidocs.dingtalk.com/i/spaces/${spaceID}/overview` } function isRecord(value: unknown): value is Record { return typeof value === 'object' && value !== null && !Array.isArray(value) } export async function fetchAvailableDingtalkSources(signal?: AbortSignal): Promise { const response = await fetch('/api/v1/dingtalk-spaces/available', { headers: { Accept: 'application/json' }, signal }) if (!response.ok) { // 503 是环境问题(dws 未登录/权限不足),501 是后端没接线:都要说清楚"不是没有来源"。 if (response.status === 503) throw new Error('暂时列不出来:dws 未登录或缺少租户目录读权限。先刷新钉钉会话,或让管理员检查 dws 凭据。') if (response.status === 501) throw new Error('后端未接线:数据源发现接口不可用。') if (response.status === 401 || response.status === 403) throw new Error('需要管理员身份才能列举数据源。') throw new Error(`列举数据源失败(HTTP ${response.status})`) } const payload = await response.json() as unknown const data = isRecord(payload) && isRecord(payload.data) ? payload.data : {} const knowledgeBases = Array.isArray(data.knowledge_bases) ? data.knowledge_bases : [] const driveSpaces = Array.isArray(data.drive_spaces) ? data.drive_spaces : [] return { knowledge_bases: knowledgeBases.flatMap((item) => { if (!isRecord(item)) return [] const name = typeof item.name === 'string' ? item.name : '' const spaceID = typeof item.space_id === 'string' ? item.space_id : '' const url = typeof item.url === 'string' && item.url ? item.url : driveSpaceURL(spaceID) const spaceType = typeof item.space_type === 'string' ? item.space_type : '' return name && spaceID ? [{ name, space_id: spaceID, space_type: spaceType, url, description: typeof item.description === 'string' ? item.description : '' }] : [] }), drive_spaces: driveSpaces.flatMap((item) => { if (!isRecord(item)) return [] const name = typeof item.name === 'string' ? item.name : '' const spaceID = typeof item.space_id === 'string' ? item.space_id : '' const spaceType = typeof item.space_type === 'string' ? item.space_type : '' return name && spaceID ? [{ name, space_id: spaceID, space_type: spaceType, root_folder_id: typeof item.root_folder_id === 'string' ? item.root_folder_id : '' }] : [] }), knowledge_notice: typeof data.knowledge_notice === 'string' ? data.knowledge_notice : '', drive_notice: typeof data.drive_notice === 'string' ? data.drive_notice : '', fetched_at: typeof data.fetched_at === 'string' ? data.fetched_at : '', } } export interface DiscoveryCandidate { key: string kind: 'knowledge_base' | 'drive_space' name: string spaceID: string url: string detail: string alreadyRegistered: boolean } // 把发现结果拍平成可勾选列表:已登记(按空间名比对来源连接名)的条目打标,页面据此禁用勾选, // 避免重复登记。 export function discoveryCandidates(list: AvailableDingtalkSources | null, registeredNames: string[]): DiscoveryCandidate[] { const registered = new Set(registeredNames.map((name) => name.trim()).filter(Boolean)) const knowledgeBases = (list?.knowledge_bases ?? []).map((item): DiscoveryCandidate => ({ key: `kb:${item.space_id}`, kind: 'knowledge_base', name: item.name, spaceID: item.space_id, url: item.url || driveSpaceURL(item.space_id), detail: item.space_type === 'myWikiSpace' ? '钉钉知识库 · 我的知识库' : '钉钉知识库 · 组织知识库', alreadyRegistered: registered.has(item.name.trim()), })) const driveSpaces = (list?.drive_spaces ?? []).map((item): DiscoveryCandidate => ({ key: `drive:${item.space_id}`, kind: 'drive_space', name: item.name, spaceID: item.space_id, url: driveSpaceURL(item.space_id), detail: item.space_type === 'mySpace' ? '钉盘 · 我的文件' : '钉盘 · 组织空间', alreadyRegistered: registered.has(item.name.trim()), })) return [...knowledgeBases, ...driveSpaces] }