数据源连接
数据源连接器卡 .kb-connector:Glean 式健康模型(enabled ≠ 健康:24h 未同步 = stale,抓取失败 / 凭证过期 = failing,停用 = off)映射为卡左缘色条 + 状态点;信号行 4 离散信号(健康 / 已同步 / 抓取率 / 变更率)+ 凭证徽标(过期红标 / 未配置灰标);头部类型图标(来源类型注册表)+ scope + cron 同步计划(mono 展示)。操作三钮 → icen:kb-connector-sync / reauth / schedule { connectorId, schedule }。
三张卡各占一态:healthy(3 小时前同步)/ stale(Jira 74 小时未同步)/ failing(HR 凭证过期 + 抓取失败)——点卡上三个操作按钮派事件
事件日志:等待交互
<p class="demo-label" style="margin:0 0 8px">三张卡各占一态:healthy(3 小时前同步)/ stale(Jira 74 小时未同步)/ failing(HR 凭证过期 + 抓取失败)——点卡上三个操作按钮派事件</p><div id="demo-kb-connectors"></div><p class="demo-label" id="demo-kb-connector-log" style="margin-top:8px">事件日志:等待交互</p> 安装
bun add @icen.ai/ui pnpm add @icen.ai/ui npm install @icen.ai/ui yarn add @icen.ai/ui 一行引入该组件(CSS 与 behavior 自动带上,无需关心内部 CSS 文件名):
import { initKbConnectors } from '@icen.ai/ui/kit/kb-connector';initKbConnectors(); 也可以用脚手架直接打印引入行:
bunx --bun @icen.ai/ui add kb-connector
Astro 项目注意:kit 入口里的 CSS import 在页面 <script> 里会被 Astro 的 client bundle 摇掉——请改在布局 frontmatter 里引 CSS(import '@icen.ai/ui/components/kb-ingest.css';),JS 行为仍可走 kit。Vite SPA / webpack 项目无此问题。
用法
import { renderKbConnectors, initKbConnectors } from '@icen.ai/ui/kit/kb-connector';initKbConnectors(); // 委托三钮:sync / reauth / schedule(root 缺省 document,幂等 + 销毁函数) renderKbConnectors(el, [ { id: 'cn-1', name: 'Confluence', kind: 'wiki', scope: '空间:/engineering', enabled: true, lastSyncAt: new Date(Date.now() - 3 * 3600e3).toISOString(), lastCrawlStatus: 'ok', itemsSynced: 1204, crawlRate: 86, changeRate: 12, credential: 'ok', schedule: '0 */2 * * *' }, { id: 'cn-2', name: 'Jira 工单', kind: 'ticket', enabled: true, lastSyncAt: new Date(Date.now() - 74 * 3600e3).toISOString(), lastCrawlStatus: 'ok', itemsSynced: 892, crawlRate: 24, changeRate: 31, credential: 'ok' }, // 24h 停滞 → stale { id: 'cn-3', name: 'HR 系统', kind: 'api', enabled: true, credential: 'expired' }, // → failing]);// 健康类由 kb-core connectorHealth 判定,卡片加 is-healthy / is-stale / is-failing / is-off// kind 图标走来源类型注册表(registerKbSourceType 可扩展自定义连接器)// 事件:icen:kb-connector-sync { connectorId } / icen:kb-connector-reauth { connectorId }// icen:kb-connector-schedule { connectorId, schedule }(schedule = 渲染时 cron 原值)