agentworkshop 0.7.27 → 0.7.33

package/server/plugins-builtin/diag-bridge/i18n.json

@@ -0,0 +1,72 @@
+{
+  "zh-CN": {
+    "settings": {
+      "base_url": "诊断服务地址",
+      "token": "诊断 API Token",
+      "harness": "诊断引擎",
+      "max_turns": "诊断最大轮数",
+      "max_minutes": "诊断超时(分钟)",
+      "auto_enabled": "自动诊断",
+      "auto_rules": "自动诊断规则"
+    },
+    "group": {
+      "conn": "诊断服务连接",
+      "run": "诊断执行参数",
+      "auto": "自动诊断",
+      "rules": "自动诊断规则"
+    },
+    "panel": {
+      "title": "深度诊断(industrial-deep-diagnostic)",
+      "runs": "诊断记录",
+      "none": "暂无诊断记录;Agent 经 diag_run 工具发起",
+      "run": "Run",
+      "line": "产线",
+      "status": "状态",
+      "score": "评分",
+      "stored": "入库",
+      "refresh": "刷新",
+      "st_running": "运行中",
+      "st_completed": "已完成",
+      "st_failed": "失败",
+      "st_stopped": "已停止",
+      "st_other": "其他",
+      "yes": "是",
+      "no": "否"
+    }
+  },
+  "en": {
+    "settings": {
+      "base_url": "Diagnosis service URL",
+      "token": "Diagnosis API token",
+      "harness": "Diagnosis harness",
+      "max_turns": "Max turns",
+      "max_minutes": "Timeout (minutes)",
+      "auto_enabled": "Auto diagnosis",
+      "auto_rules": "Auto diagnosis rules"
+    },
+    "group": {
+      "conn": "Diagnosis service connection",
+      "run": "Diagnosis run parameters",
+      "auto": "Auto diagnosis",
+      "rules": "Auto diagnosis rules"
+    },
+    "panel": {
+      "title": "Deep diagnosis (industrial-deep-diagnostic)",
+      "runs": "Diagnosis runs",
+      "none": "No runs yet; agents start one via the diag_run tool",
+      "run": "Run",
+      "line": "Line",
+      "status": "Status",
+      "score": "Score",
+      "stored": "Stored",
+      "refresh": "Refresh",
+      "st_running": "Running",
+      "st_completed": "Completed",
+      "st_failed": "Failed",
+      "st_stopped": "Stopped",
+      "st_other": "Other",
+      "yes": "Yes",
+      "no": "No"
+    }
+  }
+}

package/server/plugins-builtin/diag-bridge/index.mjs

@@ -19,7 +19,7 @@ const startingLines = new Set()
 
 /** 诊断服务 base(kv diag.base_url;只允许 http/https 且 host 为 127.0.0.1/localhost) */
 function baseOf(ctx) {
-  const raw = String(ctx.config?.get?.('plugins.diag.base_url') || ctx.kv.get('diag.base_url') || DEFAULT_BASE).trim()
+  const raw = String(ctx.config?.get?.('plugins.diag-bridge.base_url') || ctx.kv.get('diag.base_url') || DEFAULT_BASE).trim()
   try {
     const u = new URL(raw)
     const okProto = u.protocol === 'http:' || u.protocol === 'https:'
@@ -32,6 +32,33 @@ function baseOf(ctx) {
   }
 }
 
+/** 诊断服务鉴权 token(系统配置 plugins.diag-bridge.token 优先,kv diag.token 兜底;空=匿名)。
+ *  诊断服务 v4 起默认强制 Bearer(AUTH_ENABLED!==0),401 AUTH_REQUIRED 时先查这里。 */
+function diagTokenOf(ctx) {
+  return String(ctx.config?.get?.('plugins.diag-bridge.token') || ctx.kv.get('diag.token') || '').trim()
+}
+
+function authHeadersOf(ctx) {
+  const t = diagTokenOf(ctx)
+  return t ? { authorization: `Bearer ${t}` } : {}
+}
+
+/** rag-knowledge 出站鉴权(系统配置 plugins.rag-bridge.token 优先,kv kb.token;与 rag-bridge 同源。
+ *  入库管线要打 web 6789 / api 8770,服务端开启鉴权时缺头会 401 → catalog 查不到库 → 跳过入库) */
+function kbHeadersOf(ctx) {
+  const t = String(ctx.config?.get?.('plugins.rag-bridge.token') || ctx.kv.get('kb.token') || '').trim()
+  return t ? { 'authorization': `Bearer ${t}`, 'x-kb-token': t } : {}
+}
+
+// ── 配置读取(系统配置优先,kv 兜底;前端全局设置→运行配置→插件组可改,保存即热生效) ──
+
+const harnessOf = ctx => String(ctx.config?.get?.('plugins.diag-bridge.harness') || ctx.kv.get('diag.harness') || 'omp')
+const maxTurnsOf = ctx => Number(ctx.config?.get?.('plugins.diag-bridge.max_turns')) || Number(ctx.kv.get('diag.max_turns')) || 220
+const maxMinutesOf = ctx => Number(ctx.config?.get?.('plugins.diag-bridge.max_minutes')) || Number(ctx.kv.get('diag.max_minutes')) || 40
+/** 自动诊断开关:系统配置布尔或 kv 'true'(kv 为历史字符串语义) */
+const autoEnabledOf = ctx => ctx.config?.get?.('plugins.diag-bridge.auto_enabled') === true || ctx.kv.get('auto_diag_enabled') === 'true'
+const autoRulesOf = ctx => String(ctx.config?.get?.('plugins.diag-bridge.auto_rules') || ctx.kv.get('auto_rules') || '')
+
 const runKey = id => `run:${id}`
 
 /** kv 中全部 run 记录 → [{ id, meta }] */
@@ -58,20 +85,26 @@ function short(body) {
   }
 }
 
+/** 401 时给可操作的修复指引(生产最常见故障:会话 token 随诊断服务重启失效) */
+function authHint(status, msg) {
+  if (status !== 401) return msg
+  return `${msg};修复:在 系统设置→运行配置→插件 更新「诊断 API Token」(推荐使用诊断服务侧的持久化 API Token,idd_ 前缀,服务重启不失效)`
+}
+
 /** JSON GET:断言 HTTP ok 且 body.success===true,返回 body */
 async function jget(ctx, url, timeoutMs = 8000) {
-  const res = await ctx.http.get(url, { timeoutMs })
+  const res = await ctx.http.get(url, { timeoutMs, headers: authHeadersOf(ctx) })
   const body = await res.json().catch(() => null)
-  if (!res.ok) throw new Error(`HTTP ${res.status} ${short(body)}`)
+  if (!res.ok) throw new Error(authHint(res.status, `HTTP ${res.status} ${short(body)}`))
   if (!body || body.success !== true) throw new Error(`success!=true ${short(body)}`)
   return body
 }
 
-/** JSON POST:断言 HTTP ok 且 body.success===true,返回 body */
-async function jpost(ctx, url, body, timeoutMs = 15000) {
-  const res = await ctx.http.post(url, body, { timeoutMs })
+/** JSON POST:断言 HTTP ok 且 body.success===true,返回 body(extraHeaders 供 KB 端点叠加鉴权) */
+async function jpost(ctx, url, body, timeoutMs = 15000, extraHeaders = {}) {
+  const res = await ctx.http.post(url, body, { timeoutMs, headers: { ...authHeadersOf(ctx), ...extraHeaders } })
   const out = await res.json().catch(() => null)
-  if (!res.ok) throw new Error(`HTTP ${res.status} ${short(out)}`)
+  if (!res.ok) throw new Error(authHint(res.status, `HTTP ${res.status} ${short(out)}`))
   if (!out || out.success !== true) throw new Error(`success!=true ${short(out)}`)
   return out
 }
@@ -181,7 +214,7 @@ async function snapshotCore(ctx, line, fromMs, toMs) {
     const fd = new FormData()
     fd.append('folder', UPLOAD_FOLDER)
     fd.append('files', new Blob([csv], { type: 'text/csv' }), safeName(line, toMs))
-    const res = await fetch(`${base}/api/files/data/upload`, { method: 'POST', body: fd, signal: ac.signal })
+    const res = await fetch(`${base}/api/files/data/upload`, { method: 'POST', body: fd, signal: ac.signal, headers: authHeadersOf(ctx) })
     const body = await res.json().catch(() => null)
     if (!res.ok) throw new Error(`HTTP ${res.status} ${short(body)}`)
     if (!body || body.success !== true) throw new Error(`success!=true ${short(body)}`)
@@ -215,11 +248,11 @@ async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene, source
       dataPath: snap.csvPath,
       sceneName,
       userQuestion: q,
-      harness: String(ctx.kv.get('diag.harness') || 'omp'), // 缺省落 claude 引擎会因无 key 失败,必须显式
+      harness: harnessOf(ctx), // 缺省落 claude 引擎会因无 key 失败,必须显式(系统配置 plugins.diag-bridge.harness → kv → omp)
       enhancement: 'off',
       reportLanguage: 'zh',
-      maxTurns: Number(ctx.kv.get('diag.max_turns')) || 220, // 修复循环会加转数;150 不够走完全管线
-      timeoutMinutes: Number(ctx.kv.get('diag.max_minutes')) || 40,
+      maxTurns: maxTurnsOf(ctx), // 修复循环会加转数;150 不够走完全管线
+      timeoutMinutes: maxMinutesOf(ctx),
     })
     const runId = String(started.data?.runId ?? '')
     const name = String(started.data?.name ?? '')
@@ -244,10 +277,10 @@ async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene, source
 async function ingestCompleted(ctx, runId, meta, st) {
   try {
     // kv 按插件命名空间隔离:rag-bridge 建的库不在本插件 kv 里,需自行从 catalog 幂等解析
-    const webBase = String(ctx.config?.get?.('plugins.kb.web_url') || ctx.kv.get('kb.web_url') || 'http://127.0.0.1:6789').replace(/\/+$/, '')
+    const webBase = String(ctx.config?.get?.('plugins.rag-bridge.web_url') || ctx.kv.get('kb.web_url') || 'http://127.0.0.1:6789').replace(/\/+$/, '')
     let kbId = String(ctx.kv.get('kb.id') || '').trim()
     if (!kbId) {
-      const cat = await ctx.http.get(`${webBase}/api/kb/catalog`, { timeoutMs: 15000 })
+      const cat = await ctx.http.get(`${webBase}/api/kb/catalog`, { timeoutMs: 15000, headers: kbHeadersOf(ctx) })
         .then(r => r.json()).catch(() => null)
       const hit = (Array.isArray(cat?.knowledgeBases) ? cat.knowledgeBases : [])
         .find(kb => kb?.name === 'aw-industrial')
@@ -272,10 +305,10 @@ async function ingestCompleted(ctx, runId, meta, st) {
     const content = String(rep.data?.content ?? '')
     if (!content) throw new Error('报告内容为空')
 
-    const apiBase = String(ctx.config?.get?.('plugins.kb.base_url') || ctx.kv.get('kb.base_url') || 'http://127.0.0.1:8770').replace(/\/+$/, '')
+    const apiBase = String(ctx.config?.get?.('plugins.rag-bridge.base_url') || ctx.kv.get('kb.base_url') || 'http://127.0.0.1:8770').replace(/\/+$/, '')
 
     // 2) web 建文档(响应 {success, document:{path,…}},path 供索引用)
-    const doc = await jpost(ctx, `${webBase}/api/kb/documents/create`, { kbId, name: `${runName}.md`, content }, 15000)
+    const doc = await jpost(ctx, `${webBase}/api/kb/documents/create`, { kbId, name: `${runName}.md`, content }, 15000, kbHeadersOf(ctx))
     const docPath = String(doc.document?.path ?? '')
     if (!docPath) throw new Error(`documents/create 响应缺少 document.path: ${short(doc)}`)
 
@@ -285,7 +318,7 @@ async function ingestCompleted(ctx, runId, meta, st) {
       doc_path: docPath,
       content,
       tags: [meta.line, '诊断', 'source:diag-bridge'].filter(Boolean),
-    }, 30000)
+    }, 30000, kbHeadersOf(ctx))
 
     // 4) backend 经验沉淀
     const q = String(meta.question || '')
@@ -296,7 +329,7 @@ async function ingestCompleted(ctx, runId, meta, st) {
       solution: content.slice(0, 800),
       result: 'success',
       tags: [meta.line, meta.scene].filter(Boolean),
-    }, 30000)
+    }, 30000, kbHeadersOf(ctx))
 
     ctx.kv.set(runKey(runId), { ...ctx.kv.get(runKey(runId)), stored: true, storedAt: Date.now() })
     ctx.logger.info(`诊断 ${runId}(产线 ${meta.line})报告已入库: ${docPath}`)
@@ -363,10 +396,45 @@ async function sweepOnce(ctx) {
 
 export default {
   name: 'diag-bridge',
-  version: '1.0.0',
+  version: '1.1.0',
   description: '深度诊断桥接:导出 DAQ 时序快照 CSV,发起 industrial-deep-diagnostic 深度诊断并跟踪状态,完成后报告自动入知识库。',
   auth: 'user',
+  client: './client.mjs', // 前端面板(插件页注入;i18n 见 i18n.json)
+  // 插件配置分组(声明式):连接 / 执行 / 自动化 三个独立分区
+  configGroups: [
+    { id: 'default', labelKey: 'plugin.diag-bridge.group.conn', label: '诊断服务连接', description: '后端地址与鉴权 Token', order: 420 },
+    { id: 'run', labelKey: 'plugin.diag-bridge.group.run', label: '诊断执行参数', description: 'diag_run 的引擎与预算', order: 430 },
+    { id: 'auto', labelKey: 'plugin.diag-bridge.group.auto', label: '自动诊断', description: '越限自动发起诊断(DAQ 采样事件驱动)', order: 440, collapsed: true },
+  ],
+  // 插件设置声明(key 编址 plugins.diag-bridge.<key>;labelKey 解析 i18n.json)
+  settings: [
+    { key: 'base_url', type: 'string', default: DEFAULT_BASE, group: 'default', labelKey: 'plugin.diag-bridge.settings.base_url', label: '诊断服务地址', description: 'industrial-deep-diagnostic 后端(http/https,host 限 127.0.0.1/localhost);保存即热生效' },
+    { key: 'token', type: 'string', default: '', group: 'default', labelKey: 'plugin.diag-bridge.settings.token', label: '诊断 API Token', description: '诊断服务开启鉴权时(v4 起默认强制)的 API Token(Authorization: Bearer);空=匿名;保存即热生效' },
+    { key: 'harness', type: 'string', default: '', group: 'run', labelKey: 'plugin.diag-bridge.settings.harness', label: '诊断引擎', description: 'diag_run 用的引擎 id(omp/claude/mock 等;空=取 kv/omp);无 Anthropic key 的机器请用 omp' },
+    { key: 'max_turns', type: 'number', default: 0, min: 0, max: 2000, group: 'run', labelKey: 'plugin.diag-bridge.settings.max_turns', label: '诊断最大轮数', description: 'diagnosis/start 的 maxTurns(0=取 kv/内置默认 220)' },
+    { key: 'max_minutes', type: 'number', default: 0, min: 0, max: 720, group: 'run', labelKey: 'plugin.diag-bridge.settings.max_minutes', label: '诊断超时(分钟)', description: 'diagnosis/start 的 timeoutMinutes(0=取 kv/内置默认 40)' },
+    { key: 'auto_enabled', type: 'boolean', default: false, group: 'auto', labelKey: 'plugin.diag-bridge.settings.auto_enabled', label: '自动诊断', description: 'daq:sample 越限命中规则时自动发起深度诊断(每产线冷却 30 分钟)' },
+  ],
   setup(ctx) {
+    // 运行时追加分区与字段(ctx.config.defineGroup / defineField):
+    // 字段 key 与声明式完全等价(plugins.diag-bridge.auto_rules),已保存的值不丢;
+    // 这里演示「插件在 setup 里按条件调用平台 API 扩展自己的配置面」。
+    ctx.config.defineGroup({
+      id: 'rules',
+      labelKey: 'plugin.diag-bridge.group.rules',
+      label: '自动诊断规则',
+      description: 'JSON 规则;命中即触发自动诊断(仅 auto_enabled=true 时生效)',
+      order: 450,
+    })
+    ctx.config.defineField({
+      key: 'auto_rules',
+      type: 'string',
+      default: '',
+      group: 'rules',
+      labelKey: 'plugin.diag-bridge.settings.auto_rules',
+      label: '自动诊断规则',
+      description: 'JSON: {"节点id":{"op":"gt|lt","value":数值}};命中即触发自动诊断(空=无规则)',
+    })
     // 轮询器(15s)+ setup 重水化:恢复对 kv 中 running run 的跟踪(热重载安全)
     const sweep = () => sweepOnce(ctx).catch(err => ctx.logger.warn(`诊断轮询异常(继续): ${err?.message ?? err}`))
     ctx.timer.setInterval(sweep, 15000)
@@ -375,9 +443,9 @@ export default {
     // 自动诊断(默认关):daq:sample 命中规则 → 冷却 30min → 同管线发起(source:'auto')
     ctx.hooks.on('daq:sample', (s) => {
       try {
-        if (ctx.kv.get('auto_diag_enabled') !== 'true') return
+        if (!autoEnabledOf(ctx)) return
         if (!s || typeof s.value !== 'number' || !s.nodeId || !s.lineId) return
-        const rule = parseAutoRules(ctx.kv.get('auto_rules'))[s.nodeId]
+        const rule = parseAutoRules(autoRulesOf(ctx))[s.nodeId]
         if (!rule || typeof rule?.value !== 'number' || !['gt', 'lt'].includes(rule.op)) return
         const hit = rule.op === 'lt' ? s.value < rule.value : s.value > rule.value
         if (!hit) return
@@ -508,14 +576,42 @@ export default {
       for (const { meta } of runs) byStatus[meta?.status ?? 'unknown'] = (byStatus[meta?.status ?? 'unknown'] ?? 0) + 1
       const base = baseOf(ctx)
       let remote
+      let tokenState = { configured: Boolean(diagTokenOf(ctx)), accepted: null }
       if (base) {
         try {
-          // /api/health 响应无 success 字段,单独取(不套 jget 断言)
+          // 连通性:/api/health 是公开端点(无鉴权),只回答「服务在不在」。
           const res = await ctx.http.get(`${base}/api/health`, { timeoutMs: 5000 })
           const body = await res.json().catch(() => null)
           remote = res.ok && body
             ? { status: body.status ?? 'ok', activeRuns: body.checks?.activeRuns ?? null }
             : { status: `HTTP ${res.status}`, activeRuns: null }
+          // Token 有效性:/api/health 不校验鉴权,必须另打一个受保护端点,
+          // 否则 token 配错时健康面依旧 ok —— 配置错误完全不可见(实测踩过)。
+          if (tokenState.configured) {
+            try {
+              const auth = await ctx.http.get(`${base}/api/files/workspace`, {
+                timeoutMs: 5000,
+                headers: authHeadersOf(ctx),
+              })
+              if (auth.status === 401 || auth.status === 403) {
+                tokenState = { configured: true, accepted: false, hint: authHint(auth.status, 'Token 被上游拒绝') }
+                remote = { ...remote, auth: `HTTP ${auth.status}(鉴权被拒)`, hint: tokenState.hint }
+              }
+              else if (auth.ok) {
+                tokenState = { configured: true, accepted: true }
+                remote = { ...remote, auth: 'ok' }
+              }
+              else {
+                remote = { ...remote, auth: `HTTP ${auth.status}` }
+              }
+            }
+            catch (err) {
+              remote = { ...remote, auth: 'unreachable', authError: String(err?.message ?? err) }
+            }
+          }
+          else {
+            tokenState = { configured: false, accepted: null }
+          }
         }
         catch (err) {
           remote = { status: 'unreachable', error: String(err?.message ?? err) }
@@ -524,7 +620,16 @@ export default {
       else {
         remote = { status: 'bad_base_url' }
       }
-      return { plugin: ctx.name, base: base ?? String(ctx.kv.get('diag.base_url') || DEFAULT_BASE), remote, runs: { total: runs.length, byStatus } }
+      return {
+        plugin: ctx.name,
+        base: base ?? String(ctx.kv.get('diag.base_url') || DEFAULT_BASE),
+        harness: harnessOf(ctx),
+        auth: diagTokenOf(ctx) ? 'bearer' : 'anonymous',
+        /** Token 配置态 + 实测是否被上游接受(401/403 → false;网络不通 → null) */
+        token: tokenState,
+        remote,
+        runs: { total: runs.length, byStatus },
+      }
     })
 
     ctx.route('GET', '/runs', () => ({

package/server/plugins-builtin/rag-bridge/client.mjs

@@ -0,0 +1,108 @@
+/**
+ * rag-bridge 客户端面板 —— 经 ctx.ui.registerPanel 注入 'plugins.page' 插槽。
+ * 自包含 ESM(零导入);ctx 由宿主 loader 注入(fetch 带鉴权/t 命名空间翻译)。
+ * 健康徽标(后端/Web/知识库) + 快捷检索框,30s 自动刷新,返回清理函数供卸载回收。
+ */
+export function setup(ctx) {
+  // 面板样式(自包含注入,幂等;不依赖宿主页面样式表)
+  const styleId = 'aw-rb-styles'
+  if (!document.getElementById(styleId)) {
+    document.head.append(ctx.el('style', { id: styleId }, [`
+      .aw-rb { display:flex; flex-direction:column; gap:8px; font-size:12px; }
+      .aw-rb-row { display:flex; gap:8px; align-items:center; flex-wrap:wrap; }
+      .aw-rb-cell { display:inline-flex; align-items:center; gap:4px; }
+      .aw-rb-dot { width:8px; height:8px; border-radius:50%; display:inline-block; }
+      .aw-rb-dot-ok { background:#35e0a0; }
+      .aw-rb-dot-bad { background:#e05a5a; }
+      .aw-rb-input { flex:1; min-width:200px; padding:5px 9px; border:1px solid color-mix(in srgb, currentColor 24%, transparent); border-radius:7px; background:transparent; color:inherit; }
+      .aw-rb-btn { padding:5px 13px; border:1px solid color-mix(in srgb, currentColor 28%, transparent); border-radius:7px; background:transparent; color:inherit; cursor:pointer; }
+      .aw-rb-btn:disabled { opacity:.5; cursor:default; }
+      .aw-rb-results { display:flex; flex-direction:column; gap:6px; }
+      .aw-rb-empty { opacity:.6; }
+      .aw-rb-hit { padding:6px 8px; border:1px solid color-mix(in srgb, currentColor 12%, transparent); border-radius:7px; }
+      .aw-rb-hit-head { font-size:11px; opacity:.85; }
+      .aw-rb-hit-brief { opacity:.7; margin-top:2px; }
+    `]))
+  }
+
+  ctx.ui.registerPanel({
+    slot: 'plugins.page',
+    name: 'kb-panel',
+    titleKey: 'panel.title',
+    order: 10,
+    mount(el) {
+      const t = k => ctx.t(`panel.${k}`)
+      const timer = setInterval(refresh, 30_000)
+
+      function dot(ok) {
+        return ctx.el('span', {
+          class: `aw-rb-dot ${ok ? 'aw-rb-dot-ok' : 'aw-rb-dot-bad'}`,
+          title: ok ? t('ok') : t('bad'),
+        })
+      }
+
+      const backendCell = ctx.el('span', { class: 'aw-rb-cell' }, [dot(false), ` ${t('backend')}`])
+      const webCell = ctx.el('span', { class: 'aw-rb-cell' }, [dot(false), ` ${t('web')}`])
+      const kbCell = ctx.el('span', { class: 'aw-rb-cell aw-mono' }, [dot(false), ` ${t('kb')}: -`])
+      const counterCell = ctx.el('span', { class: 'aw-rb-cell faint' }, [
+        `${t('counters')}: ${t('store')} 0 · ${t('index')} 0`,
+      ])
+      const statusRow = ctx.el('div', { class: 'aw-rb-row' }, [backendCell, webCell, kbCell, counterCell])
+
+      const input = ctx.el('input', {
+        class: 'aw-rb-input',
+        placeholder: t('searchPlaceholder'),
+      })
+      input.addEventListener('keydown', (e) => {
+        if (e.key === 'Enter') void runSearch()
+      })
+      const btn = ctx.el('button', { class: 'aw-rb-btn' }, [t('searchBtn')])
+      btn.addEventListener('click', () => void runSearch())
+      const results = ctx.el('div', { class: 'aw-rb-results' })
+
+      el.append(
+        ctx.el('div', { class: 'aw-rb' }, [
+          statusRow,
+          ctx.el('div', { class: 'aw-rb-row' }, [input, btn]),
+          results,
+        ]),
+      )
+
+      async function refresh() {
+        const h = await ctx.fetch('/api/plugins/rag-bridge/health').catch(() => null)
+        backendCell.replaceChildren(dot(Boolean(h?.backend?.ok)), ` ${t('backend')}`)
+        webCell.replaceChildren(dot(Boolean(h?.web?.ok)), ` ${t('web')}`)
+        kbCell.replaceChildren(dot(Boolean(h?.kb?.id)), ` ${t('kb')}: ${h?.kb?.id ? String(h.kb.id).slice(0, 8) : '-'}(${h?.auth === 'bearer' ? t('bearer') : t('anonymous')})`)
+        counterCell.replaceChildren(`${t('counters')}: ${t('store')} ${h?.counters?.store ?? 0} · ${t('index')} ${h?.counters?.index ?? 0}`)
+      }
+
+      async function runSearch() {
+        const q = String(input.value ?? '').trim()
+        if (!q) return
+        btn.disabled = true
+        btn.textContent = t('searching')
+        results.replaceChildren()
+        const r = await ctx.fetch(`/api/plugins/rag-bridge/search?q=${encodeURIComponent(q)}&top_k=5`).catch(() => null)
+        btn.disabled = false
+        btn.textContent = t('searchBtn')
+        const items = Array.isArray(r?.results) ? r.results.slice(0, 5) : []
+        if (!items.length) {
+          results.append(ctx.el('div', { class: 'aw-rb-empty' }, [t('empty')]))
+          return
+        }
+        for (const [i, h] of items.entries()) {
+          const brief = String(h?.content ?? '').replace(/\s+/g, ' ').trim().slice(0, 140)
+          results.append(ctx.el('div', { class: 'aw-rb-hit' }, [
+            ctx.el('div', { class: 'aw-rb-hit-head aw-mono' }, [
+              `${i + 1}. [${Number(h?.score ?? 0).toFixed(3)}] ${h?.doc_path ?? '-'}`,
+            ]),
+            ctx.el('div', { class: 'aw-rb-hit-brief' }, [brief]),
+          ]))
+        }
+      }
+
+      void refresh()
+      return () => clearInterval(timer)
+    },
+  })
+}

package/server/plugins-builtin/rag-bridge/i18n.json

@@ -0,0 +1,60 @@
+{
+  "zh-CN": {
+    "settings": {
+      "base_url": "rag-knowledge 后端地址",
+      "web_url": "rag-knowledge Web 地址",
+      "token": "rag-knowledge API Token"
+    },
+    "group": {
+      "conn": "rag-knowledge 连接",
+      "auth": "rag-knowledge 鉴权"
+    },
+    "panel": {
+      "title": "工业知识库(rag-knowledge)",
+      "backend": "后端",
+      "web": "Web",
+      "kb": "知识库",
+      "counters": "累计",
+      "store": "经验沉淀",
+      "index": "文档入库",
+      "searchPlaceholder": "检索工业知识(诊断报告/经验/规范)…",
+      "searchBtn": "检索",
+      "searching": "检索中…",
+      "empty": "未检索到相关内容",
+      "refresh": "刷新",
+      "ok": "正常",
+      "bad": "不可达",
+      "anonymous": "匿名",
+      "bearer": "鉴权"
+    }
+  },
+  "en": {
+    "settings": {
+      "base_url": "rag-knowledge backend URL",
+      "web_url": "rag-knowledge Web URL",
+      "token": "rag-knowledge API token"
+    },
+    "group": {
+      "conn": "rag-knowledge connection",
+      "auth": "rag-knowledge auth"
+    },
+    "panel": {
+      "title": "Industrial knowledge base (rag-knowledge)",
+      "backend": "Backend",
+      "web": "Web",
+      "kb": "Knowledge base",
+      "counters": "Total",
+      "store": "Experiences",
+      "index": "Documents",
+      "searchPlaceholder": "Search industrial knowledge (reports/lessons/specs)…",
+      "searchBtn": "Search",
+      "searching": "Searching…",
+      "empty": "No results",
+      "refresh": "Refresh",
+      "ok": "Up",
+      "bad": "Down",
+      "anonymous": "Anonymous",
+      "bearer": "Auth"
+    }
+  }
+}