agentworkshop 0.5.9 → 0.6.0

package/scripts/test-daq-frames.ts

@@ -0,0 +1,180 @@
+/**
+ * DAQ 多形态帧管线单元测试:v2 帧信封 / mock 三形态驱动 / sink 处理器 /
+ * 磁盘对象存储 / SQLite 帧适配 / runtime 帧路径 / 打标与预览。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-daq-frames.ts
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { encodePng, resizeGray } from '../server/services/workshop/daq/png-enc'
+import { runSinkPipeline, registerFrameProcessor, type DaqFrameWorking } from '../server/services/workshop/daq/frames'
+import { mockDaqDriver } from '../server/services/workshop/daq/drivers'
+import { DiskObjectAdapter } from '../server/services/workshop/daq/objectstore/disk.adapter'
+import { daqObjectKey } from '../server/services/workshop/daq/objectstore/objectstore-port'
+import { DaqNode } from '../server/services/workshop/daq/daq-node'
+import { DaqNodeRuntime, type DaqRuntimeHost } from '../server/services/workshop/daq/daq-runtime'
+import type { DaqFrameRow, DaqSampleRow } from '../server/services/workshop/daq/storage/tsdb-port'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+// ===== PNG 编码/解码闭环 + 缩放 =====
+console.log('\n--- PNG 编码器(png-enc)---')
+{
+  const w = 64
+  const h = 48
+  const px = new Uint8Array(w * h)
+  for (let i = 0; i < px.length; i++) px[i] = (i * 7) % 256
+  const blob = encodePng(w, h, px)
+  check('PNG 魔数与 IEND', blob.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])) && blob.subarray(blob.length - 8, blob.length - 4).toString('ascii') === 'IEND')
+  const small = resizeGray(px, w, h, 32, 24)
+  check('最近邻缩放尺寸', small.length === 32 * 24)
+  check('缩放取点保真(角点)', small[0] === px[0] && small[23 * 32 + 31] === px[Math.min(h - 1, Math.floor((23 * h) / 24)) * w + Math.min(w - 1, Math.floor((31 * w) / 32))])
+}
+
+// ===== mock 三形态驱动 =====
+console.log('\n--- mock 驱动三形态 ---')
+{
+  const base = { ctx: { nodeId: 'dn-t1', now: Date.now(), ageMs: 5000 }, config: { base: 0.52, amp: 0.018, min: 0.4, max: 0.65 }, driverConfig: {} }
+  const scalar = await mockDaqDriver.sample({ ...base })
+  check('scalar 形态返回数值(既有契约)', typeof scalar === 'number' && Number.isFinite(scalar))
+
+  const vec = await mockDaqDriver.sample({ ...base, signalKind: 'vector', vector: { points: 64, min: 0.4, max: 0.65 } })
+  check('vector 形态返回帧信封', vec != null && typeof vec === 'object' && 'frame' in vec && vec.frame.kind === 'vector')
+  if (vec != null && typeof vec === 'object' && 'frame' in vec && vec.frame.kind === 'vector') {
+    check('vector 64 点且在量程内', vec.frame.points.length === 64 && vec.frame.points.every(p => p >= 0.4 && p <= 0.65))
+  }
+
+  const img = await mockDaqDriver.sample({ ...base, signalKind: 'image' })
+  check('image 形态返回 PNG blob', img != null && typeof img === 'object' && 'frame' in img && img.frame.kind === 'image')
+  if (img != null && typeof img === 'object' && 'frame' in img && img.frame.kind === 'image') {
+    check('image 尺寸与 mime', img.frame.width === 320 && img.frame.height === 240 && img.frame.mime === 'image/png')
+    check('image blob 可解码出像素(经 thumbnail 处理器间接验证)', img.frame.blob.length > 1000)
+  }
+}
+
+// ===== sink 处理器管线 =====
+console.log('\n--- sink 处理器管线 ---')
+{
+  const points = Array.from({ length: 100 }, (_, i) => 0.5 + Math.sin(i / 10) * 0.05)
+  let wf: DaqFrameWorking = { kind: 'vector', points, metrics: {} }
+  wf = runSinkPipeline(wf, [
+    { name: 'resample', args: { n: 32 } },
+    { name: 'derive-metric', args: { name: 'avg', op: 'avg' } },
+    { name: 'derive-metric', args: { name: 'max', op: 'max' } },
+    { name: 'zones', args: { n: 4 } },
+  ], 'dn-t')
+  check('resample 降采样到 32 点', wf.points?.length === 32, `len=${wf.points?.length}`)
+  check('derive-metric avg/max 入 metrics', Number.isFinite(wf.metrics?.avg) && Number.isFinite(wf.metrics?.max))
+  check('max ≥ avg(轮廓统计自洽)', (wf.metrics?.max ?? 0) >= (wf.metrics?.avg ?? 0))
+  check('zones 分区指标(zone1_avg/zone4_max)', wf.metrics?.zone1_avg != null && wf.metrics?.zone4_max != null)
+  check('未知处理器跳过不抛', (runSinkPipeline(wf, [{ name: 'no-such-proc' }], 'dn-t')).points?.length === 32)
+
+  // image 管线:thumbnail + quality-gate
+  const w = 320
+  const h = 240
+  const px = new Uint8Array(w * h).fill(120)
+  const blob = encodePng(w, h, px)
+  let imf: DaqFrameWorking = { kind: 'image', blob, mime: 'image/png', width: w, height: h, metrics: {} }
+  imf = runSinkPipeline(imf, [{ name: 'thumbnail', args: { width: 64 } }, { name: 'quality-gate' }], 'dn-t')
+  check('thumbnail 生成缩略 blob(平坦图高压缩,仅验存在)', imf.thumbBlob != null && imf.thumbBlob.length > 0)
+  check('quality-gate 亮度/对比度指标', imf.metrics?.brightness != null && Math.abs((imf.metrics?.brightness ?? 0) - 120) < 12, `brightness=${imf.metrics?.brightness}`)
+
+  // 插件处理器注册(同名覆盖 + 自定义)
+  registerFrameProcessor({ name: 'test-double', applies: 'vector', process: f => ({ ...f, metrics: { ...f.metrics, doubled: (f.metrics?.avg ?? 0) * 2 } }) })
+  const out = runSinkPipeline({ kind: 'vector', points: [1, 2, 3], metrics: { avg: 2 } }, [{ name: 'test-double' }], 'dn-t')
+  check('插件处理器注册生效', out.metrics?.doubled === 4)
+}
+
+// ===== 磁盘对象存储 =====
+console.log('\n--- 磁盘对象存储(disk adapter)---')
+{
+  const os = new DiskObjectAdapter()
+  await os.init()
+  const key = daqObjectKey('dn-t1', Date.now(), '.png')
+  const payload = Buffer.from([1, 2, 3, 4, 5])
+  await os.put(key, payload, 'image/png')
+  const back = await os.get(key)
+  check('put/get 闭环', back.equals(payload), `key=${key}`)
+  check('daqObjectKey 目录结构', /^daq\/dn-t1\/\d{4}\/\d{2}\/\d{2}\/\d+\.png$/.test(key))
+  let rejected = false
+  try {
+    await os.put('../evil', payload, 'image/png')
+  }
+  catch {
+    rejected = true
+  }
+  check('路径逃逸键拒绝', rejected)
+  await os.remove(key)
+  check('remove 后 404 化', await os.get(key).then(() => false, () => true))
+}
+
+// ===== SQLite 帧适配(降级环境全链路)=====
+console.log('\n--- SQLite 帧适配 ---')
+{
+  const db: DatabaseSync = openWorkshopDb(':memory:')
+  // SqliteTimeSeriesAdapter 自持连接(文件路径),此处直接验证 SQL 形态:
+  // 用与 adapter 相同 DDL 在内存库上跑一遍查询语义
+  db.exec(`
+    CREATE TABLE daq_frames (
+      node_id TEXT NOT NULL, ts_ms INTEGER NOT NULL, kind TEXT NOT NULL,
+      template_key TEXT, device_binding_id TEXT,
+      line_id TEXT, product_id TEXT, recipe_id TEXT, run_id TEXT,
+      points INTEGER NOT NULL DEFAULT 0, meta TEXT NOT NULL DEFAULT '{}', metrics TEXT NOT NULL DEFAULT '{}',
+      PRIMARY KEY (node_id, ts_ms)
+    );
+  `)
+  const rows: DaqFrameRow[] = [
+    { nodeId: 'dn-v', tsMs: 1000, kind: 'vector', templateKey: 'thickness-scan', deviceBindingId: 'dev-1', lineId: 'line-1', productId: 'p1', recipeId: 'r1', runId: 'run-1', points: 32, meta: { points: [0.5, 0.51] }, metrics: { avg: 0.505, max: 0.51 } },
+    { nodeId: 'dn-i', tsMs: 2000, kind: 'image', templateKey: 'ccd-image', points: 0, meta: { objectKey: 'daq/x/1.png', thumbKey: 'daq/x/1.thumb.png', mime: 'image/png', width: 320, height: 240 }, metrics: { brightness: 120 } },
+  ]
+  const ins = db.prepare('INSERT INTO daq_frames (node_id, ts_ms, kind, template_key, device_binding_id, line_id, product_id, recipe_id, run_id, points, meta, metrics) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)')
+  for (const r of rows) ins.run(r.nodeId, r.tsMs, r.kind, r.templateKey ?? null, r.deviceBindingId ?? null, r.lineId ?? null, r.productId ?? null, r.recipeId ?? null, r.runId ?? null, r.points, JSON.stringify(r.meta), JSON.stringify(r.metrics))
+  const vecRow = db.prepare(`SELECT * FROM daq_frames WHERE node_id = 'dn-v'`).get() as { meta: string, metrics: string }
+  check('向量行 meta.points 还原', JSON.parse(vecRow.meta).points.length === 2)
+  check('打标列逐条携带', db.prepare(`SELECT line_id FROM daq_frames WHERE node_id='dn-v'`).get().line_id === 'line-1')
+  check('图像行对象键在 meta', JSON.parse((db.prepare(`SELECT meta FROM daq_frames WHERE node_id='dn-i'`).get() as { meta: string }).meta).objectKey === 'daq/x/1.png')
+}
+
+// ===== runtime 帧路径(fake host:tick 采样→入队→onSample 消费)=====
+console.log('\n--- runtime 帧路径 ---')
+{
+  const node = new DaqNode({
+    id: 'dn-frame', templateRef: 'thickness-scan', name: '测厚扫描 01', driver: 'mock',
+    intervalMs: 120, publishIntervalMs: 0, min: 0.4, max: 0.65, lineId: '',
+  })
+  const published: Array<Record<string, unknown>> = []
+  const ingested: Array<{ env: Record<string, unknown>, allowPublish: boolean }> = []
+  const sampleRows: DaqSampleRow[] = []
+  const frameRows: DaqFrameRow[] = []
+  const host: DaqRuntimeHost = {
+    defaults: () => ({ intervalMs: 1000, publishIntervalMs: 0 }),
+    sample: (n, now) => mockDaqDriver.sample({
+      ctx: { nodeId: n.id, now, ageMs: 10_000 },
+      config: { base: 0.52, amp: 0.018, min: 0.4, max: 0.65 },
+      driverConfig: {},
+      signalKind: 'vector',
+      vector: { points: 64, min: 0.4, max: 0.65 },
+    }),
+    publishSample: env => published.push(env as Record<string, unknown>),
+    ingest: (n, env, allowPublish) => ingested.push({ env: env as Record<string, unknown>, allowPublish }),
+    broadcastError: () => {},
+  }
+  const rt = new DaqNodeRuntime(node, host)
+  await rt.tick(Date.now())
+  check('tick 产出帧信封(vector)', published.length === 1 && (published[0]!.frame as { kind: string }).kind === 'vector')
+  const env = published[0] as unknown as { nodeId: string, at: string, frame: { kind: 'vector', points: number[] }, value: number }
+  check('信封值语义 = avg 指标回填', Number.isFinite(env.value))
+  const v1 = rt.onSample(env as never)
+  check('onSample 帧路径消费 ok', v1 === 'ok' && ingested.length === 1 && ingested[0]!.allowPublish === true)
+  check('节点触活(lastAt 更新,state=ok)', node.state === 'ok' && node.lastAt != null && node.value != null)
+  check('帧路径不产标量样本行(mock vector 无 value 写库)', sampleRows.length === 0 && frameRows.length === 0)
+  // 迟到帧丢弃
+  const late = rt.onSample({ ...env, at: new Date(Date.parse(env.at) - 5000).toISOString() } as never)
+  check('乱序帧丢弃(late)', late === 'late')
+}
+
+console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/test-daq-minio.ts

@@ -0,0 +1,77 @@
+/**
+ * 补充验证:minio 适配器真容器 roundtrip + 工厂装配/降级路径。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-daq-minio.ts
+ * 凭据从 config.yml daq.objectstore 读取(单一事实源,不在源码硬编码);
+ * 需 daq-minio 容器在 127.0.0.1:9000。
+ */
+import { readFileSync } from 'node:fs'
+import { MinioObjectAdapter } from '../server/services/workshop/daq/objectstore/minio.adapter'
+import { rebuildObjectStore, getObjectStore } from '../server/services/workshop/daq/objectstore'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+/** 从 config.yml 读 daq.objectstore 段(键值对缩进解析,够用即可) */
+function osConfigFromYml(): { endPoint: string, port: number, accessKey: string, secretKey: string, bucket: string } | null {
+  const yml = readFileSync('config.yml', 'utf-8')
+  const m = yml.match(/^ {2}objectstore:\r?\n((?: {4}.*\r?\n?)+)/m)
+  if (!m) return null
+  const kv = (key: string, dflt: string): string => (m[1]!.match(new RegExp(`${key}:\\s*(\\S+)`))?.[1] ?? dflt)
+  return {
+    endPoint: kv('host', '127.0.0.1'),
+    port: Number(kv('port', '9000')),
+    accessKey: kv('accessKey', 'awshop'),
+    secretKey: kv('secretKey', ''),
+    bucket: 'daq-e2e-probe',
+  }
+}
+
+console.log('\n--- MinIO 适配器(真容器)---')
+{
+  const cfg = osConfigFromYml()
+  check('config.yml objectstore 段可读', cfg != null)
+  if (cfg) {
+    const adapter = new MinioObjectAdapter(cfg)
+    let ok = true
+    for (let i = 0; i < 3; i++) {
+      try {
+        await adapter.init()
+        break
+      }
+      catch (err) {
+        if (i === 2) {
+          ok = false
+          console.log('  init 失败:', (err as Error).message)
+        }
+        await new Promise(r => setTimeout(r, 2000))
+      }
+    }
+    check('init(建连 + 建桶)', ok)
+    if (ok) {
+      const key = 'probe/test-object.png'
+      const payload = Buffer.from([0x89, 0x50, 1, 2, 3, 4])
+      await adapter.put(key, payload, 'image/png')
+      const back = await adapter.get(key)
+      check('put/get 闭环', back.equals(payload))
+      await adapter.remove(key)
+      check('remove', (await adapter.get(key).then(() => false, () => true)))
+      await adapter.close()
+    }
+
+    // 工厂装配路径:rebuildObjectStore(online, url) → backend=minio
+    const url = `http://${encodeURIComponent(cfg.accessKey)}:${encodeURIComponent(cfg.secretKey)}@${cfg.endPoint}:${cfg.port}/${cfg.bucket}`
+    await rebuildObjectStore(true, url)
+    check('rebuildObjectStore 装配 minio', getObjectStore().backend === 'minio')
+    await getObjectStore().put('probe/factory.txt', Buffer.from('aw'), 'text/plain')
+    check('工厂 get 可用(真桶)', (await getObjectStore().get('probe/factory.txt')).toString() === 'aw')
+    // 降级路径
+    await rebuildObjectStore(false, null)
+    check('离线判定 → disk 降级', getObjectStore().backend === 'disk')
+  }
+}
+
+console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/test-memory-rrf-mmr.ts

@@ -1,114 +1,114 @@
-/**
- * 记忆检索 v2 算法测试:RRF 融合 / MMR 多样性 / kind 感知半衰期 / 任务关联加权 / 策展层排除。
- * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-memory-rrf-mmr.ts
- */
-import type { DatabaseSync } from 'node:sqlite'
-import { openWorkshopDb } from '../server/services/workshop/db/database'
-import { createMemoryRepo, TEAM_AGENT_ID } from '../server/services/workshop/db/memory.repo'
-import { AgentMemory, buildMatchQuery, estimateTokens } from '../server/services/workshop/runtime/memory'
-
-let failures = 0
-function check(name: string, ok: boolean, detail = ''): void {
-  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
-  if (!ok) failures += 1
-}
-
-const db: DatabaseSync = openWorkshopDb(':memory:')
-const repo = createMemoryRepo(db)
-const seg = (s: string): string => s.replace(/([\u4e00-\u9fff])/g, ' $1 ')
-
-// ===== buildMatchQuery:CJK 词项扩容 + 去重 =====
-console.log('\n--- buildMatchQuery(CJK 词项扩容)---')
-{
-  const q = buildMatchQuery('网关限流方案讨论,部署脚本与令牌桶阈值约定')
-  const termCount = q ? q.split(' OR ').length : 0
-  check('CJK 单字词项上限提升(>12)', termCount > 12, `terms=${termCount}`)
-  const deduped = buildMatchQuery('限流 限流 限流')
-  check('词项去重', deduped !== null && deduped.split(' OR ').length === 2, `terms=${deduped}`) // 限/流
-  check('token 估算为正', estimateTokens('abc 中文') > 0)
-}
-
-// ===== RRF 融合:FTS+向量双榜融合(词袋 embedder)=====
-console.log('\n--- RRF 融合(混合检索)---')
-{
-  // hash 词袋 provider:同词集 → 相近向量(零网络)
-  const { createHashEmbeddingProvider } = await import('../server/services/workshop/runtime/embedding-provider')
-  const embedder = createHashEmbeddingProvider(64)
-
-  const rows = [
-    { dedup: 'task:a', title: 'Redis 缓存穿透方案', content: '布隆过滤器前置拦截,空值缓存五分钟' },
-    { dedup: 'task:b', title: 'Redis 雪崩预案', content: '过期时间加随机抖动,多级缓存兜底' },
-    { dedup: 'task:c', title: '部署脚本清单', content: 'docker compose 拉镜像,健康检查后切流量' },
-  ]
-  for (const r of rows) {
-    repo.upsert({ channelId: 'ch1', agentId: 'a1', kind: 'episodic-task', title: r.title, titleFts: seg(r.title), content: seg(r.content), importance: 0.8, taskId: r.dedup, dedupKey: `task:${r.dedup}` })
-  }
-  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'a1', embedder })
-  // 向量可命中(词袋相似)但 FTS 无词面匹配的查询:RRF 仍能通过向量榜给出结果
-  const hits = await mem.recallRows('cache 穿透 拦截')
-  check('向量榜独有命中可达(RRF 不丢向量结果)', hits.some(s => s.title === 'Redis 缓存穿透方案'), JSON.stringify(hits.map(s => s.title)))
-
-  // 双榜同时命中:融合排序应把两榜都命中的排前
-  const both = await mem.recallRows('Redis 雪崩')
-  check('双榜命中排序靠前', both.length > 0 && both[0]!.title === 'Redis 雪崩预案', JSON.stringify(both.map(s => `${s.title}:${s.score}`)))
-}
-
-// ===== kind 感知半衰期:semantic 不衰减,episodic-task 14d =====
-console.log('\n--- kind 感知半衰期 ---')
-{
-  const old = new Date(Date.now() - 60 * 86_400_000).toISOString()
-  repo.upsert({ channelId: 'ch1', agentId: 'old1', kind: 'semantic', title: '六十天前的架构决策', titleFts: seg('六十天前的架构决策'), content: seg('内核结论:单写多读'), importance: 0.9, taskId: null, dedupKey: 'manual:old-sem' })
-  repo.upsert({ channelId: 'ch1', agentId: 'old1', kind: 'episodic-task', title: '六十天前的任务', titleFts: seg('六十天前的任务'), content: seg('过程性记录,内容已过时'), importance: 0.9, taskId: 't-old', dedupKey: 'task:t-old' })
-  // 直接改 created_at 模拟老化(upsert ON CONFLICT 会刷新,故用参数化 UPDATE)
-  db.prepare('UPDATE agent_memories SET created_at = ? WHERE agent_id = ?').run(old, 'old1')
-
-  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'old1' })
-  const hits = await mem.recallRows('六十天前')
-  const sem = hits.find(s => s.title === '六十天前的架构决策')
-  const epi = hits.find(s => s.title === '六十天前的任务')
-  check('semantic 知识不随时近衰减(分高于 episodic)', sem !== undefined && epi !== undefined && sem.score > epi.score, `sem=${sem?.score} epi=${epi?.score}`)
-}
-
-// ===== 任务关联加权:兄弟/父任务记忆置顶 =====
-console.log('\n--- 任务关联加权(related-task boost)---')
-{
-  repo.upsert({ channelId: 'ch1', agentId: 'rel', kind: 'episodic-task', title: '无关旧任务', titleFts: seg('无关旧任务'), content: seg('数据库迁移完成,版本升到 v14'), importance: 0.8, taskId: 't-other', dedupKey: 'task:t-other' })
-  repo.upsert({ channelId: 'ch1', agentId: 'rel', kind: 'episodic-task', title: '兄弟任务结论', titleFts: seg('兄弟任务结论'), content: seg('API 网关路由表已生成'), importance: 0.55, taskId: 't-sib1', dedupKey: 'task:t-sib1' })
-  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'rel' })
-  // 查询词面同时弱命中两行;兄弟任务 id 加权后必须反超高重要度旧行
-  const hits = await mem.recallRows('任务 结论 数据库 网关', { relatedTaskIds: ['t-sib1', 't-parent'] })
-  check('兄弟任务记忆加权反超(置顶)', hits[0]?.title === '兄弟任务结论', JSON.stringify(hits.map(s => `${s.title}:${s.score}`)))
-  const hitsNoRel = await mem.recallRows('任务 结论 数据库 网关', { touch: false })
-  check('无关联集时高重要度旧行居前(对照)', hitsNoRel[0]?.title === '无关旧任务', JSON.stringify(hitsNoRel.map(s => `${s.title}:${s.score}`)))
-}
-
-// ===== 策展层:brief 走 L0 置顶,L1 引子不重复;chronicle 不进 L1 但 L2 可检索 =====
-console.log('\n--- 策展层(L0/L1/L2 分层)---')
-{
-  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'cur' })
-  await mem.save({ title: '普通结论', content: '普通检索应该能命中', scope: 'private', dedupKey: 'note:normal' })
-  mem.repo.upsert({ channelId: 'ch1', agentId: 'cur', kind: 'brief', title: '会话简报', titleFts: seg('会话简报'), content: seg('最近完成:普通结论'), importance: 0.6, taskId: null, dedupKey: 'brief:cur' })
-  mem.repo.upsert({ channelId: 'ch1', agentId: 'cur', kind: 'chronicle', title: '团队编年史', titleFts: seg('团队编年史'), content: seg('完成 普通结论'), importance: 0.9, taskId: null, dedupKey: 'chronicle:ch1' })
-
-  // L1(recall):brief 经 L0 路径恰好注入一次(去重靠 excludeCurated);chronicle 不进 L1
-  const primer = await mem.recall('普通')
-  const briefHits = (primer?.match(/会话简报/g) ?? []).length
-  check('brief 恰好注入一次(L0 路径)', briefHits === 1, `hits=${briefHits}`)
-  check('L1 引子不含 chronicle(防双份注入)', primer !== null && !primer.includes('编年史'))
-
-  // L2(search_memory/recallRows):策展层可被检索(特性)
-  const found = await mem.recallRows('编年史')
-  check('L2 search_memory 可命中 chronicle', found.some(s => s.title === '团队编年史'), JSON.stringify(found.map(s => s.title)))
-}
-
-// ===== team 域可见性:episodic-team-task 对全员 shared 可检索 =====
-console.log('\n--- team-task 共享域 ---')
-{
-  repo.upsert({ channelId: 'ch1', agentId: TEAM_AGENT_ID, kind: 'episodic-team-task', title: '团队任务成果', titleFts: seg('团队任务成果'), content: seg('数据迁移已全部完成并验证'), importance: 0.8, taskId: 't-team', dedupKey: 'team-task:t-team' })
-  const memB = new AgentMemory(repo, { channelId: 'ch1', agentId: 'member-b' })
-  const seen = await memB.recallRows('数据迁移', { scope: 'shared' })
-  check('其他成员 shared 域可命中 team-task 行', seen.some(s => s.title === '团队任务成果'), JSON.stringify(seen.map(s => s.title)))
-}
-
-console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
-process.exit(failures === 0 ? 0 : 1)
+/**
+ * 记忆检索 v2 算法测试:RRF 融合 / MMR 多样性 / kind 感知半衰期 / 任务关联加权 / 策展层排除。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-memory-rrf-mmr.ts
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createMemoryRepo, TEAM_AGENT_ID } from '../server/services/workshop/db/memory.repo'
+import { AgentMemory, buildMatchQuery, estimateTokens } from '../server/services/workshop/runtime/memory'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const db: DatabaseSync = openWorkshopDb(':memory:')
+const repo = createMemoryRepo(db)
+const seg = (s: string): string => s.replace(/([\u4e00-\u9fff])/g, ' $1 ')
+
+// ===== buildMatchQuery:CJK 词项扩容 + 去重 =====
+console.log('\n--- buildMatchQuery(CJK 词项扩容)---')
+{
+  const q = buildMatchQuery('网关限流方案讨论,部署脚本与令牌桶阈值约定')
+  const termCount = q ? q.split(' OR ').length : 0
+  check('CJK 单字词项上限提升(>12)', termCount > 12, `terms=${termCount}`)
+  const deduped = buildMatchQuery('限流 限流 限流')
+  check('词项去重', deduped !== null && deduped.split(' OR ').length === 2, `terms=${deduped}`) // 限/流
+  check('token 估算为正', estimateTokens('abc 中文') > 0)
+}
+
+// ===== RRF 融合:FTS+向量双榜融合(词袋 embedder)=====
+console.log('\n--- RRF 融合(混合检索)---')
+{
+  // hash 词袋 provider:同词集 → 相近向量(零网络)
+  const { createHashEmbeddingProvider } = await import('../server/services/workshop/runtime/embedding-provider')
+  const embedder = createHashEmbeddingProvider(64)
+
+  const rows = [
+    { dedup: 'task:a', title: 'Redis 缓存穿透方案', content: '布隆过滤器前置拦截,空值缓存五分钟' },
+    { dedup: 'task:b', title: 'Redis 雪崩预案', content: '过期时间加随机抖动,多级缓存兜底' },
+    { dedup: 'task:c', title: '部署脚本清单', content: 'docker compose 拉镜像,健康检查后切流量' },
+  ]
+  for (const r of rows) {
+    repo.upsert({ channelId: 'ch1', agentId: 'a1', kind: 'episodic-task', title: r.title, titleFts: seg(r.title), content: seg(r.content), importance: 0.8, taskId: r.dedup, dedupKey: `task:${r.dedup}` })
+  }
+  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'a1', embedder })
+  // 向量可命中(词袋相似)但 FTS 无词面匹配的查询:RRF 仍能通过向量榜给出结果
+  const hits = await mem.recallRows('cache 穿透 拦截')
+  check('向量榜独有命中可达(RRF 不丢向量结果)', hits.some(s => s.title === 'Redis 缓存穿透方案'), JSON.stringify(hits.map(s => s.title)))
+
+  // 双榜同时命中:融合排序应把两榜都命中的排前
+  const both = await mem.recallRows('Redis 雪崩')
+  check('双榜命中排序靠前', both.length > 0 && both[0]!.title === 'Redis 雪崩预案', JSON.stringify(both.map(s => `${s.title}:${s.score}`)))
+}
+
+// ===== kind 感知半衰期:semantic 不衰减,episodic-task 14d =====
+console.log('\n--- kind 感知半衰期 ---')
+{
+  const old = new Date(Date.now() - 60 * 86_400_000).toISOString()
+  repo.upsert({ channelId: 'ch1', agentId: 'old1', kind: 'semantic', title: '六十天前的架构决策', titleFts: seg('六十天前的架构决策'), content: seg('内核结论:单写多读'), importance: 0.9, taskId: null, dedupKey: 'manual:old-sem' })
+  repo.upsert({ channelId: 'ch1', agentId: 'old1', kind: 'episodic-task', title: '六十天前的任务', titleFts: seg('六十天前的任务'), content: seg('过程性记录,内容已过时'), importance: 0.9, taskId: 't-old', dedupKey: 'task:t-old' })
+  // 直接改 created_at 模拟老化(upsert ON CONFLICT 会刷新,故用参数化 UPDATE)
+  db.prepare('UPDATE agent_memories SET created_at = ? WHERE agent_id = ?').run(old, 'old1')
+
+  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'old1' })
+  const hits = await mem.recallRows('六十天前')
+  const sem = hits.find(s => s.title === '六十天前的架构决策')
+  const epi = hits.find(s => s.title === '六十天前的任务')
+  check('semantic 知识不随时近衰减(分高于 episodic)', sem !== undefined && epi !== undefined && sem.score > epi.score, `sem=${sem?.score} epi=${epi?.score}`)
+}
+
+// ===== 任务关联加权:兄弟/父任务记忆置顶 =====
+console.log('\n--- 任务关联加权(related-task boost)---')
+{
+  repo.upsert({ channelId: 'ch1', agentId: 'rel', kind: 'episodic-task', title: '无关旧任务', titleFts: seg('无关旧任务'), content: seg('数据库迁移完成,版本升到 v14'), importance: 0.8, taskId: 't-other', dedupKey: 'task:t-other' })
+  repo.upsert({ channelId: 'ch1', agentId: 'rel', kind: 'episodic-task', title: '兄弟任务结论', titleFts: seg('兄弟任务结论'), content: seg('API 网关路由表已生成'), importance: 0.55, taskId: 't-sib1', dedupKey: 'task:t-sib1' })
+  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'rel' })
+  // 查询词面同时弱命中两行;兄弟任务 id 加权后必须反超高重要度旧行
+  const hits = await mem.recallRows('任务 结论 数据库 网关', { relatedTaskIds: ['t-sib1', 't-parent'] })
+  check('兄弟任务记忆加权反超(置顶)', hits[0]?.title === '兄弟任务结论', JSON.stringify(hits.map(s => `${s.title}:${s.score}`)))
+  const hitsNoRel = await mem.recallRows('任务 结论 数据库 网关', { touch: false })
+  check('无关联集时高重要度旧行居前(对照)', hitsNoRel[0]?.title === '无关旧任务', JSON.stringify(hitsNoRel.map(s => `${s.title}:${s.score}`)))
+}
+
+// ===== 策展层:brief 走 L0 置顶,L1 引子不重复;chronicle 不进 L1 但 L2 可检索 =====
+console.log('\n--- 策展层(L0/L1/L2 分层)---')
+{
+  const mem = new AgentMemory(repo, { channelId: 'ch1', agentId: 'cur' })
+  await mem.save({ title: '普通结论', content: '普通检索应该能命中', scope: 'private', dedupKey: 'note:normal' })
+  mem.repo.upsert({ channelId: 'ch1', agentId: 'cur', kind: 'brief', title: '会话简报', titleFts: seg('会话简报'), content: seg('最近完成:普通结论'), importance: 0.6, taskId: null, dedupKey: 'brief:cur' })
+  mem.repo.upsert({ channelId: 'ch1', agentId: 'cur', kind: 'chronicle', title: '团队编年史', titleFts: seg('团队编年史'), content: seg('完成 普通结论'), importance: 0.9, taskId: null, dedupKey: 'chronicle:ch1' })
+
+  // L1(recall):brief 经 L0 路径恰好注入一次(去重靠 excludeCurated);chronicle 不进 L1
+  const primer = await mem.recall('普通')
+  const briefHits = (primer?.match(/会话简报/g) ?? []).length
+  check('brief 恰好注入一次(L0 路径)', briefHits === 1, `hits=${briefHits}`)
+  check('L1 引子不含 chronicle(防双份注入)', primer !== null && !primer.includes('编年史'))
+
+  // L2(search_memory/recallRows):策展层可被检索(特性)
+  const found = await mem.recallRows('编年史')
+  check('L2 search_memory 可命中 chronicle', found.some(s => s.title === '团队编年史'), JSON.stringify(found.map(s => s.title)))
+}
+
+// ===== team 域可见性:episodic-team-task 对全员 shared 可检索 =====
+console.log('\n--- team-task 共享域 ---')
+{
+  repo.upsert({ channelId: 'ch1', agentId: TEAM_AGENT_ID, kind: 'episodic-team-task', title: '团队任务成果', titleFts: seg('团队任务成果'), content: seg('数据迁移已全部完成并验证'), importance: 0.8, taskId: 't-team', dedupKey: 'team-task:t-team' })
+  const memB = new AgentMemory(repo, { channelId: 'ch1', agentId: 'member-b' })
+  const seen = await memB.recallRows('数据迁移', { scope: 'shared' })
+  check('其他成员 shared 域可命中 team-task 行', seen.some(s => s.title === '团队任务成果'), JSON.stringify(seen.map(s => s.title)))
+}
+
+console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
+process.exit(failures === 0 ? 0 : 1)