dsh-data-domain-knowledge 0.1.1-alpha.2 → 0.1.1-alpha.4

package/lib/types/intent/types.js

@@ -1,56 +0,0 @@
-/**
- * 内置 act 词表。它是会话审计的固定提示，不是知识召回配置，也不提供编辑入口。
- */
-export const DEFAULT_ACTS = [
-    { id: 'query', label: '查询', description: '向数据或知识提问，要一个答案或一批结果。', enabled: true },
-    { id: 'request', label: '执行请求', description: '让 Agent 做一件事并产生副作用：写入、发送、导出、修改。', enabled: true },
-    { id: 'inform', label: '补充信息', description: '用户提供事实、参数或上下文，本身不要求动作。', enabled: true },
-    { id: 'confirm', label: '确认', description: '用户认可某个提议或方案，允许继续。', enabled: true },
-    { id: 'select', label: '选择', description: '在多个候选中指定一个。', enabled: true },
-    { id: 'correct', label: '纠正', description: '指出前面的理解或结果不对，要求改。', enabled: true },
-    { id: 'cancel', label: '取消', description: '终止或撤回正在进行的任务。', enabled: true },
-    { id: 'review', label: '审阅', description: '对已产出的内容做检查、评估与把关。', enabled: true },
-    { id: 'explain', label: '解释', description: '要求讲清原理、口径或原因，而不是要新数据。', enabled: true },
-    { id: 'compare', label: '对比', description: '把两个及以上对象放在一起比较差异。', enabled: true },
-    { id: 'recommend', label: '推荐', description: '要建议与取舍意见。', enabled: true },
-    { id: 'resume', label: '继续', description: '回到之前中断的任务继续做。', enabled: true },
-    { id: 'reject', label: '拒绝', description: '不接受某个提议或结果。', enabled: true },
-    { id: 'greet', label: '问候', description: '打招呼、开场。', enabled: true },
-    { id: 'chat', label: '闲聊', description: '非任务性的对话。', enabled: true },
-    { id: 'unknown', label: '未判定', description: '无法归入以上任何一类，或本轮信息不足以判断。', enabled: true },
-];
-function category(id, label, route, description, examples) {
-    return { id, label, route, description, examples, enabled: true };
-}
-/**
- * 出厂预置的意图分类。
- *
- * 每一项都**必须**带 `description` 与 `examples`：只给标签（"数据分析"）时模型
- * 只能靠猜，同一句话在不同轮次会被分到不同类。这些文案是模型的匹配依据，全部
- * 词表随代码发布，不通过知识库配置或 UI 修改。
- */
-export const DEFAULT_CATEGORIES = [
-    category('data_analysis', '数据分析', 'query', '取数、算指标、拆口径的请求：给一个数或一段分析结论。', ['帮我算一下上个月的 GMV', '这个指标怎么拆', '跑个数看看环比']),
-    category('metadata_exploration', '元数据探索', 'query', '问"有哪些表/字段/口径"本身，要的是结构而不是数字。', ['这张表有哪些字段', '库里有几张订单表', '这些指标的口径是怎么定义的']),
-    category('data_validation', '数据校验', 'query', '核对数据是否可信：对不上、空值、重复、异常波动。', ['这两个数对不上，查一下', '帮我看下这列有没有重复', '空值率是不是偏高了']),
-    category('knowledge_consultation', '知识咨询', 'query', '问组织既有的结论、规则、流程或负责人，答案在知识库里。', ['我们去年是怎么定这个口径的', '知识库里有没有相关文档', '这个流程找谁确认']),
-    category('knowledge_building', '知识构建', 'request', '把材料沉淀进知识库：录入来源、写卡片、重建索引。', ['把这份文档存进知识库', '记一条：这个口径改成…', '帮我整理成一张知识卡片']),
-    category('document_research', '文档研究', 'query', '对一份或多份长文档做通读、归纳、对比、找证据。', ['把这份 PRD 读一遍，总结需求点', '这几篇文档有没有冲突', '从报告里找出支持这个结论的证据']),
-    category('message_collaboration', '消息协作', 'request', '替用户发消息、同步进度、在群里通知或拉人。', ['发条消息给张三', '在群里同步一下进度', '@一下负责人催确认']),
-    category('artifact_delivery', '产物交付', 'request', '要一个可交付的文件：表格、报告、周报、导出件。', ['导出一份 Excel', '生成这周的周报', '把结果做成表格发我']),
-    category('agent_engineering', 'Agent 工程', 'request', '改 Agent 自身：加工具、调提示词、改 skill、查它为什么这么答。', ['加一个工具', '这个 skill 怎么改', '它刚才为什么没调那个工具']),
-    category('tooling_operations', '工具运维', 'request', '运维动作：重启、看队列、清缓存、处理环境报错。', ['重启一下服务', '看看任务队列', '这个报错怎么修']),
-    category('personal_assistant', '个人助理', 'request', '个人日程与提醒类事务。', ['明天提醒我开会', '帮我约个会', '看下我今天的日程']),
-    category('conversation', '普通对话', 'chat', '寒暄、闲聊、对 Agent 本身的提问，没有数据或交付目标。', ['你好', '你是谁', '谢谢，先这样']),
-];
-export const DEFAULT_PREDICATES = [
-    'query_babel_data', 'query_knowledge', 'query_source_truth', 'query_metadata',
-    'query_graph', 'add_source', 'propose_wiki_cards', 'rebuild_knowledge',
-    'send_message', 'export_artifact', 'unknown',
-];
-export const DEFAULT_INTENT_SETTINGS = {
-    clarifyThreshold: 0.65,
-    ttlSeconds: 600,
-    fallbackEnabled: true,
-};
-//# sourceMappingURL=types.js.map

package/lib/types/intent/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/intent/types.ts"],"names":[],"mappings":"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"}

package/src/client/IntentLogic.tsx

@@ -1,192 +0,0 @@
-/**
- * 「意图的逻辑」—— 把意图模型**讲清楚**，而不是只给一堆表单。
- *
- * 内容现在同时解释两套意图：会话审计里的 act / category，以及召回运行时的 Intent / OAS。
- * 后者不是新增一套持久化记录，而是当前 Query 的解析结果。
- *
- * 这一页是**只读说明**：它不读引擎状态，也不写配置，所以可以独立阅读。
- *
- * 2026-10-05：它从面板里的说明变成**一份整页**（`/knowledge/pages/help/intent`）。
- * 说明只解释会话审计与召回侧 Query 意图的边界，入口是意图页右侧那枚 `?`。
- */
-
-import type { ReactNode } from 'react'
-import { BrainCircuit, CircleHelp, ClipboardCheck, Library, ListTree, Shapes } from '@tita-agent/ui/icons'
-import { Card } from '@tita-agent/ui/components'
-import { styles } from './styles.ts'
-
-/** 一张"字段含义"表。 */
-interface FieldDoc {
-  name: string
-  required: boolean
-  meaning: string
-  where: string
-}
-
-const RECORD_FIELDS: FieldDoc[] = [
-  { name: 'sessionKey', required: true, meaning: '这条意图属于哪个会话。记录按 session + turn 分组，TTL 到期即释放。', where: 'Host 从会话头取，模型不用传' },
-  { name: 'turnKey / turnId', required: true, meaning: '「哪一轮」。同一轮重复记录会 upsert 成一条，不会刷出多条流水。', where: 'Host 在 turn/start 时分配' },
-  { name: 'userInput', required: true, meaning: '本轮用户原文（截断到 2000 字）。它是审计的证据，不是分类的输入。', where: '模型从本轮消息里复制' },
-  { name: 'act', required: true, meaning: '用户在**做什么**：问、让做、补充、确认、取消……与 category 正交。', where: '模型按固定审计契约判断' },
-  { name: 'category', required: false, meaning: '这一轮属于**哪个业务类别**。不命中固定分类时可记录 unknown。', where: '模型判断' },
-  { name: 'predicate', required: false, meaning: '这轮最终要调的**工具/动作**，例如 query_babel_data。用来把意图和真实执行对齐。', where: '模型按可用工具填' },
-  { name: 'slots', required: false, meaning: '从用户话里抽出的关键参数（时间范围、对象、指标……），自由 JSON。', where: '模型抽取' },
-  { name: 'confidence', required: false, meaning: '模型自评把握度 0–1。低于澄清阈值只**标注** lowConfidence，不拦截请求。', where: '模型自评' },
-  { name: 'refs', required: false, meaning: '引用了哪些对象（表、文档、指标），形如 { id, kind, label }。', where: '模型抽取' },
-  { name: 'relation', required: true, meaning: '这轮与已有任务的关系：new_task（开新任务）/ subtask_of（续已有任务）/ unknown。', where: '模型判断，Host 校验 task 是否存在' },
-  { name: 'lineage', required: true, meaning: 'intentId / taskId / subtaskId / runId 四个 id 的链路，下游工具与产物靠它回溯。', where: 'Host 分配，模型可显式续接' },
-  { name: 'source', required: true, meaning: 'model = 模型记录；fallback = 数据轮次结束模型没记，Host 补的一条 unknown。', where: 'Host 标记' },
-]
-
-interface Paper {
-  title: string
-  authors: string
-  venue: string
-  url: string
-  /** 它对应本设计的哪一点。 */
-  relates: string
-  note?: string
-}
-
-const PAPERS: Paper[] = [
-  {
-    title: 'An Evaluation Dataset for Intent Classification and Out-of-Scope Prediction',
-    authors: 'Stefan Larson, Anish Mahendran, Joseph J. Peper, Christopher Clarke, Andrew Lee, Parker Hill, Jonathan Kummerfeld, Kevin Leach, Michael A. Laurenzano, Lingjia Tang, Jason Mars',
-    venue: 'EMNLP 2019（CLINC150）',
-    url: 'https://aclanthology.org/D19-1131/',
-    relates: '「全不命中怎么办」的标准答案：真实流量里必然有落在词表之外的句子，把它硬塞进最近的一类，比多问一句代价大得多。对应本设计的第 2 段（自创 id 或落 unknown）与 lowConfidence 标注。',
-    note: 'CLINC150 给出了 150 类 + out-of-scope 的评测集；数据集的标签体系与本产品的 12 类无关。',
-  },
-  {
-    title: 'A Survey of Joint Intent Detection and Slot Filling Models in Natural Language Understanding',
-    authors: 'H. Weld, X. Huang, S. Long, J. Poon, S. C. Han',
-    venue: 'ACM Computing Surveys, 2022',
-    url: 'https://dl.acm.org/doi/10.1145/3547138',
-    relates: '说明 intent 与 slot 为什么要一起看：`category`（意图）与 `slots`（参数）是同一个判断的两面。本设计把它们放在同一条记录里，就是为了不让"分类对了但参数丢了"成为常态。',
-    note: '这里只借它的问题定义与术语，没有训练任何联合模型。',
-  },
-  {
-    title: 'Efficient Intent Detection with Dual Sentence Encoders',
-    authors: 'Iñigo Casanueva, Tadas Temčinas, Daniela Gerz, Matthew Henderson, Ivan Vulić',
-    venue: 'NLP4ConvAI @ ACL 2020',
-    url: 'https://aclanthology.org/2020.nlp4convai-1.5/',
-    relates: '小样本下"用一句自然语言描述一个类别"就能做分类：这正是本设计的做法——预置分类用 `description` + `examples` 描述，而不是训练一个分类头。',
-    note: '该论文用双句编码器 + 少量标注样例；本产品直接把描述喂给大模型，没有额外模型。',
-  },
-  {
-    title: 'IntentGPT: Few-shot Intent Discovery with Large Language Models',
-    authors: 'Juan Rodriguez, Nicholas Botzer, David Vazquez, Christopher Pal, Marco Pedersoli, Issam H. Laradji',
-    venue: 'arXiv:2411.10670, 2024',
-    url: 'https://arxiv.org/abs/2411.10670',
-    relates: '对应第 2 段"不命中就自己起一个 id"：未知意图不应当被丢掉，而应当被发现为新类别。本设计把新 id 写进记录，后续可以据此把它提升为正式分类。',
-    note: '该论文用 LLM 做零样本意图发现并迭代扩展标签集；本产品只记录新 id，聚类/提升仍是人工动作。',
-  },
-  {
-    title: 'Recent Neural Methods on Dialogue State Tracking for Task-Oriented Dialogue Systems: A Survey',
-    authors: 'Vevake Balaraman, Seyedmostafa Sheikhalishahi, Bernhard Magnini',
-    venue: 'SIGDIAL 2021',
-    url: 'https://aclanthology.org/2021.sigdial-1.25/',
-    relates: '对应 `relation` 与任务链路：多轮对话里"这一轮是在续上一个任务还是开新任务"是对话状态的一部分，不是每轮独立判断。本设计把它显式建模为 new_task / subtask_of。',
-    note: '只借它的状态建模视角；本设计用规则 + 会话内已记录的任务集合来判定，没有跑 DST 模型。',
-  },
-]
-
-function Section({ icon: Icon, title, children }: { icon: typeof CircleHelp; title: string; children: ReactNode }): ReactNode {
-  return <Card className={styles.kbCard}>
-    <div className={styles.kbCardHead}>
-      <div><h3><Icon size={13} />{title}</h3></div>
-    </div>
-    {children}
-  </Card>
-}
-
-export function IntentLogic(): ReactNode {
-  return <div className={styles.viewStack}>
-    <Section icon={CircleHelp} title="什么是意图？">
-      <p className={styles.kbHint}>
-        这里说的「意图」不是要控制流程的指令，而是一条**审计事实**：这一轮用户在做什么、属于哪类业务、
-        要调什么动作、引用了哪些对象、和之前哪个任务同属一件事。
-      </p>
-      <ul className={styles.intentDocList}>
-        <li><b>判断完全交给大模型。</b>`intent_record` 只把模型给出的结论落成一条记录，不做关键词匹配、不做状态机、不反问、不阻断当前请求，也不会因为分类错了就让请求失败。</li>
-        <li><b>记录不驱动控制流。</b>它服务三件事：事后回溯（这轮到底想干什么）、链路串联（下游工具与产物继承 taskId / subtaskId）、质量观测（哪些轮次低置信度、哪些落到了 unknown）。</li>
-        <li><b>数据轮次漏了也不丢。</b>只有进入数据 / 知识域的轮次才需要记录；如果模型漏记，Host 补一条 <code>source: fallback</code> 的 unknown。普通 Agent 和闲聊不会生成意图记录。</li>
-      </ul>
-    </Section>
-
-    <Section icon={BrainCircuit} title="召回侧的意图识别">
-      <p className={styles.kbHint}>
-        召回侧的意图不是会话记录的替代品。每次用户查询进入知识库时，运行时都会先判断用户要完成的事，再从知识矩阵实体注册表解析 OAS；结果只服务本次候选生成和重排，不写入会话意图表。
-      </p>
-      <div className={styles.intentDocGrid}>
-        <div><strong>Intent</strong><span>lookup 查事实、explain 解释概念、procedure 执行步骤、troubleshoot 排查问题、compare 比较差异。</span></div>
-        <div><strong>Object</strong><span>用户正在问的对象，例如指标、表、业务概念；优先匹配注册表 canonical / alias。</span></div>
-        <div><strong>Action</strong><span>对象上的动作，例如计算、排查、配置、接入；它是坐标轴，不等于会话层 act。</span></div>
-        <div><strong>Scene</strong><span>问题发生的场景，例如日报、线上、异常、复盘；与 Object、Action 组成坐标。</span></div>
-      </div>
-      <p className={styles.kbHint}>
-        三个轴实体匹配后组成 Coordinate 候选：Coordinate 路先找到对应 WikiCard，再展开为 Section；FTS 与 Vector 仍然直接召回 Section，三路最终进入同一个 Section 候选池。
-      </p>
-      <div className={styles.intentOasLegend}>
-        <span><Shapes size={11} />OAS 是坐标先验</span>
-        <span><BrainCircuit size={11} />Intent 是任务目标</span>
-        <span>都不替代 Section 重排</span>
-      </div>
-    </Section>
-
-    <Section icon={ListTree} title="意图的描述是什么？">
-      <p className={styles.kbHint}>
-        一条意图记录把"这一轮"描述成四个维度，它们互相正交，缺一个都会让回溯变模糊：
-      </p>
-      <div className={styles.intentDocGrid}>
-        <div><strong>做什么（act）</strong><span>问 / 让做 / 补充 / 确认 / 取消 …… 固定审计分类。</span></div>
-        <div><strong>哪一类（category）</strong><span>数据分析 / 知识构建 / 产物交付 …… 固定审计分类。</span></div>
-        <div><strong>要调什么（predicate）</strong><span>最终落到哪个工具，例如 query_babel_data。</span></div>
-        <div><strong>和谁一起（relation + lineage）</strong><span>新任务还是续任务，以及 intentId / taskId / subtaskId / runId 链路。</span></div>
-      </div>
-      <p className={styles.kbHint}>
-        另一个维度是**把握度**：`confidence` 低于澄清阈值时记录被标成 lowConfidence。它只影响展示与筛选，
-        不改变这一轮的执行。
-      </p>
-    </Section>
-
-    <Section icon={ClipboardCheck} title="记录字段分别是什么含义？">
-      <div className={styles.intentDocTableWrap}>
-        <table className={styles.intentDocTable}>
-          <thead><tr><th>字段</th><th>必填</th><th>含义</th><th>谁来填</th></tr></thead>
-          <tbody>
-            {RECORD_FIELDS.map(field => <tr key={field.name}>
-              <td><code>{field.name}</code></td>
-              <td>{field.required ? '✓' : ''}</td>
-              <td>{field.meaning}</td>
-              <td>{field.where}</td>
-            </tr>)}
-          </tbody>
-        </table>
-      </div>
-      <p className={styles.kbHint}>
-        会话审计词表是固定契约，不属于知识库召回配置，也不在面板中编辑。模型写入未知的 act 或 category 时，
-        记录照样落库，只在 `warnings` 里说明；召回侧的 Intent / Object / Action / Scene 则由当前 Query 运行时解析。
-      </p>
-    </Section>
-
-    <Section icon={Library} title="引用了什么论文？">
-      <p className={styles.kbHint}>
-        诚实说明：**这套实现没有复现任何一篇论文的模型**。它是工程取舍的产物；下面是同一批问题的
-        公开研究，用来说明这些设计点不是凭空来的。每条都标了它对应哪一处设计。
-      </p>
-      <ul className={styles.intentPaperList}>
-        {PAPERS.map(paper => <li key={paper.url}>
-          <a href={paper.url} target="_blank" rel="noreferrer">{paper.title}</a>
-          <span className={styles.intentPaperMeta}>{paper.authors} · {paper.venue}</span>
-          <p>{paper.relates}</p>
-          {paper.note && <p className={styles.intentPaperNote}>注：{paper.note}</p>}
-        </li>)}
-      </ul>
-      <p className={styles.kbHint}>
-        另外两处术语来源不在论文里：<b>act / predicate</b> 的分法沿用本插件既有的意图契约（issue 0012），
-        <b>lineage</b> 是 DSH 自身的链路约定（session / turn / intent / task / subtask / run 六个 id）。
-      </p>
-    </Section>
-  </div>
-}

package/src/client/IntentTab.tsx

@@ -1,343 +0,0 @@
-/**
- * 意图 Tab —— 会话意图审计。
- *
- * 这页只回答一个问题：用户刚才说的话，Agent 是怎么理解的。
- * 它不是控制面板，也不展示召回侧的 Query Intent；召回解析在“召回 · 重排”里完成。
- */
-
-import { useCallback, useEffect, useMemo, useState, type ReactNode } from 'react'
-import { AlertCircle, BrainCircuit, Clock3, RefreshCw, X } from '@tita-agent/ui/icons'
-import { Badge, Button, Card, SelectMenu } from '@tita-agent/ui/components'
-import { styles } from './styles.ts'
-import { InfoHint } from './InfoHint.tsx'
-
-interface IntentRecord {
-  id: string
-  act: string
-  category?: string
-  predicate?: string
-  confidence?: number
-  lowConfidence?: boolean
-  relation: string
-  source: 'model' | 'fallback'
-  userInput: string
-  createdAt: string
-  updatedAt: string
-  lineage: Record<string, string>
-  meta: Record<string, unknown>
-}
-
-interface SessionSummary {
-  sessionKey: string
-  recordCount: number
-  lastAt: string
-}
-
-interface StoreView {
-  sessionKey: string
-  activeTaskId?: string
-  activeIntentId?: string
-  expiresAt?: string
-  tasks: Array<{ taskId: string; lastSubtaskId?: string; category?: string; ageSeconds: number }>
-  recent: IntentRecord[]
-}
-
-async function getJson<T>(url: string): Promise<T> {
-  const response = await fetch(url)
-  const text = await response.text()
-  if (!text.trim()) throw new Error(`服务端返回空响应（HTTP ${response.status}）`)
-  const payload = JSON.parse(text) as { ok?: boolean; data?: T; error?: { message?: string } | null }
-  if (!response.ok || payload.ok === false) throw new Error(payload.error?.message ?? `请求失败（${response.status}）`)
-  if (payload.data === undefined) throw new Error('响应缺少 data')
-  return payload.data
-}
-
-function formatTime(value: string | undefined): string {
-  if (!value) return '—'
-  const date = new Date(value)
-  if (Number.isNaN(date.getTime())) return '—'
-  return date.toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit', second: '2-digit' })
-}
-
-const ACT_LABEL: Record<string, string> = {
-  query: '查询', request: '执行请求', inform: '补充信息', confirm: '确认', select: '选择',
-  correct: '纠正', cancel: '取消', review: '审阅', explain: '解释', compare: '对比',
-  recommend: '推荐', resume: '继续', reject: '拒绝', greet: '问候', chat: '闲聊', unknown: '未判定',
-}
-
-const CATEGORY_LABEL: Record<string, string> = {
-  data_analysis: '数据分析', metadata_exploration: '元数据探索', data_validation: '数据校验',
-  knowledge_consultation: '知识咨询', knowledge_building: '知识构建', document_research: '文档研究',
-  message_collaboration: '消息协作', artifact_delivery: '产物交付', agent_engineering: 'Agent 工程',
-  tooling_operations: '工具运维', personal_assistant: '个人助理', conversation: '普通对话',
-}
-
-function humanize(value: string | undefined, labels: Record<string, string>): string | undefined {
-  if (!value) return undefined
-  return labels[value] ?? value.replaceAll('_', ' ')
-}
-
-function relationLabel(value: string): string {
-  if (value === 'subtask_of') return '继续当前任务'
-  if (value === 'new_task') return '开启新任务'
-  return '任务关系未判定'
-}
-
-function intentTitle(record: IntentRecord): string {
-  const act = humanize(record.act, ACT_LABEL) ?? '未判定'
-  const category = humanize(record.category, CATEGORY_LABEL)
-  return category ? `${act} · ${category}` : act
-}
-
-const SOURCE_LABEL: Record<IntentRecord['source'], string> = { model: '模型判断', fallback: '系统兜底' }
-
-function filterOptions(
-  records: IntentRecord[],
-  field: 'category' | 'act',
-  labels: Record<string, string>,
-  allLabel: string,
-): Array<{ value: string; label: string }> {
-  const values = new Set(records.flatMap(record => {
-    const value = record[field]
-    return value ? [value] : []
-  }))
-  const known = Object.keys(labels).filter(value => values.has(value))
-  const unknown = [...values].filter(value => !(value in labels)).sort()
-  return [
-    { value: '', label: allLabel },
-    ...[...known, ...unknown].map(value => ({ value, label: humanize(value, labels) ?? value })),
-  ]
-}
-
-function DiagnosticDetails({ record }: { record: IntentRecord }): ReactNode {
-  return <details className={styles.intentDiagnostics}>
-    <summary>查看诊断信息</summary>
-    <div className={styles.intentDiagnosticsBody}>
-      <span>内部分类：{record.act}{record.category ? ` · ${record.category}` : ''}</span>
-      {record.predicate && <span>路由谓词：<code>{record.predicate}</code></span>}
-      {record.confidence !== undefined && <span>置信度：{record.confidence.toFixed(2)}{record.lowConfidence ? '（低于阈值）' : ''}</span>}
-      <span>来源：{SOURCE_LABEL[record.source]}</span>
-      {record.lineage.taskId && <span>任务 ID：<code>{record.lineage.taskId}</code></span>}
-      {record.lineage.subtaskId && <span>子任务 ID：<code>{record.lineage.subtaskId}</code></span>}
-    </div>
-  </details>
-}
-
-function Interpretation({ record }: { record: IntentRecord }): ReactNode {
-  return <Card className={styles.intentInterpretation}>
-    <div className={styles.intentSectionHead}>
-      <div>
-        <h3>Agent 是这样理解的</h3>
-        <p className={styles.intentSectionSubhead}>最新一条判断 · 按时间倒序</p>
-      </div>
-      <time dateTime={record.updatedAt}>{formatTime(record.updatedAt)}</time>
-    </div>
-
-    <div className={styles.intentUserBlock}>
-      <span className={styles.intentStepLabel}>用户原话</span>
-      <p className={styles.intentUserInput}>{record.userInput.slice(0, 320) || '（无用户原文）'}</p>
-    </div>
-
-    <div className={styles.intentVerdict}>
-      <div className={styles.intentVerdictHead}>
-        <span className={styles.intentStepLabel}>Agent 判断</span>
-        {record.lowConfidence && <span className={styles.intentLowConfidence}>需要复核</span>}
-      </div>
-      <h4 className={styles.intentResultTitle}>{intentTitle(record)}</h4>
-      <p className={styles.intentResultText}>{relationLabel(record.relation)}。这条判断{record.lowConfidence ? '的把握较低，建议复核。' : '用于记录本轮对话走向。'}</p>
-      <div className={styles.intentResultTags}>
-        <Badge tone={record.lowConfidence ? 'warning' : 'blue'}>{humanize(record.act, ACT_LABEL) ?? '未判定'}</Badge>
-        {record.category && <Badge tone="violet">{humanize(record.category, CATEGORY_LABEL)}</Badge>}
-      </div>
-    </div>
-
-    <div className={styles.intentMetaGrid}>
-      <div className={styles.intentMetaCell}>
-        <span>任务关系</span>
-        <strong>{relationLabel(record.relation)}</strong>
-      </div>
-      <div className={styles.intentMetaCell}>
-        <span>记录来源</span>
-        <strong>{SOURCE_LABEL[record.source]}</strong>
-      </div>
-    </div>
-
-    <DiagnosticDetails record={record} />
-  </Card>
-}
-
-function HistoryItem({ record }: { record: IntentRecord }): ReactNode {
-  return <li className={styles.intentHistoryItem}>
-    <div className={styles.intentHistoryPrimary}>
-      <strong>{intentTitle(record)}</strong>
-      <time dateTime={record.updatedAt}><Clock3 size={11} />{formatTime(record.updatedAt)}</time>
-    </div>
-    <p>{record.userInput.slice(0, 180) || '（无用户原文）'}</p>
-    <div className={styles.intentHistoryMeta}>
-      <span>{relationLabel(record.relation)}</span>
-      <span>{SOURCE_LABEL[record.source]}</span>
-      {record.lowConfidence && <span className={styles.intentHistoryWarning}>需复核</span>}
-    </div>
-  </li>
-}
-
-export function IntentTab({ visible }: { visible: boolean }): ReactNode {
-  const [sessions, setSessions] = useState<SessionSummary[]>([])
-  const [sessionKey, setSessionKey] = useState('')
-  const [categoryFilter, setCategoryFilter] = useState('')
-  const [actFilter, setActFilter] = useState('')
-  const [store, setStore] = useState<StoreView | null>(null)
-  const [loading, setLoading] = useState(false)
-  const [error, setError] = useState<string | null>(null)
-  const [pageNotice, setPageNotice] = useState<string | null>(null)
-
-  const load = useCallback(async (preferred?: string): Promise<void> => {
-    setLoading(true)
-    try {
-      const overview = await getJson<{ sessions: SessionSummary[] }>('/intent/overview')
-      const list = overview.sessions ?? []
-      setSessions(list)
-      const key = preferred && list.some(item => item.sessionKey === preferred)
-        ? preferred
-        : list[0]?.sessionKey ?? ''
-      setSessionKey(key)
-      setStore(key ? await getJson<{ store: StoreView }>(`/intent/store?session_key=${encodeURIComponent(key)}`).then(payload => payload.store) : null)
-      setError(null)
-    } catch (cause) {
-      setError(cause instanceof Error ? cause.message : String(cause))
-    } finally {
-      setLoading(false)
-    }
-  }, [])
-
-  useEffect(() => { if (visible) void load(sessionKey || undefined) }, [visible]) // eslint-disable-line react-hooks/exhaustive-deps
-
-  const selectSession = async (key: string): Promise<void> => {
-    setSessionKey(key)
-    setCategoryFilter('')
-    setActFilter('')
-    setLoading(true)
-    try {
-      setStore((await getJson<{ store: StoreView }>(`/intent/store?session_key=${encodeURIComponent(key)}`)).store)
-      setError(null)
-    } catch (cause) {
-      setError(cause instanceof Error ? cause.message : String(cause))
-    } finally {
-      setLoading(false)
-    }
-  }
-
-  const recent = store?.recent ?? []
-  const categoryOptions = useMemo(() => filterOptions(recent, 'category', CATEGORY_LABEL, '全部意图'), [recent])
-  const actOptions = useMemo(() => filterOptions(recent, 'act', ACT_LABEL, '全部动作'), [recent])
-  const filteredRecent = useMemo(() => recent.filter(record => (
-    (!categoryFilter || record.category === categoryFilter)
-    && (!actFilter || record.act === actFilter)
-  )), [actFilter, categoryFilter, recent])
-  const latest = filteredRecent[0]
-  const history = filteredRecent.slice(1)
-  const hasFilter = Boolean(categoryFilter || actFilter)
-  const auditStats = useMemo(() => ({
-    lowConfidence: filteredRecent.filter(record => record.lowConfidence).length,
-    fallback: filteredRecent.filter(record => record.source === 'fallback').length,
-  }), [filteredRecent])
-
-  return <div className={styles.viewStack}>
-    <div className={styles.intentTop}>
-      <div>
-        <h2>意图记录</h2>
-        <p>先看意图结论，再核对用户原话和任务关系。这里只做审计，不参与召回或执行。</p>
-      </div>
-      <InfoHint
-        className={styles.kbToolbarHint}
-        href="/knowledge/pages/help/overview?node=intent"
-        text="查看会话意图与召回查询意图的边界"
-        onOpenFailed={message => setPageNotice(message)}
-      />
-    </div>
-
-    <div className={styles.intentControls}>
-      <div className={styles.intentPrimaryFilter}>
-        <div className={styles.intentFilterHeading}>
-          <span className={styles.intentControlLabel}>意图</span>
-          <small>优先筛选</small>
-        </div>
-        <SelectMenu
-          value={categoryFilter}
-          onValueChange={setCategoryFilter}
-          disabled={recent.length === 0}
-          aria-label="按意图筛选"
-          options={categoryOptions}
-        />
-        <span className={styles.intentFilterCount}>{filteredRecent.length} 条</span>
-      </div>
-      <div className={styles.intentSecondaryFilters}>
-        <span className={styles.intentControlLabel}>动作</span>
-        <SelectMenu
-          value={actFilter}
-          onValueChange={setActFilter}
-          className="w-full min-w-0"
-          size="sm"
-          disabled={recent.length === 0}
-          aria-label="按动作筛选"
-          options={actOptions}
-        />
-        <span className={styles.intentControlLabel}>会话</span>
-        <SelectMenu
-          value={sessionKey}
-          onValueChange={next => void selectSession(next)}
-          className="w-full min-w-0"
-          size="sm"
-          disabled={sessions.length === 0}
-          aria-label="选择意图记录会话"
-          placeholder={sessions.length === 0 ? '还没有会话记录' : '选择会话'}
-          options={sessions.map(item => ({ value: item.sessionKey, label: `${item.sessionKey.slice(0, 18)} · ${item.recordCount} 条 · ${formatTime(item.lastAt)}` }))}
-        />
-        <Button variant="ghost" size="icon" title="刷新" aria-label="刷新意图记录" onClick={() => void load(sessionKey)} disabled={loading}><RefreshCw size={14} /></Button>
-      </div>
-      <div className={styles.intentFilterSummary} aria-live="polite">
-        <span>当前会话显示 {filteredRecent.length} / {recent.length} 条</span>
-        {categoryFilter && <Badge tone="blue">{humanize(categoryFilter, CATEGORY_LABEL) ?? categoryFilter}</Badge>}
-        {actFilter && <Badge tone="violet">{humanize(actFilter, ACT_LABEL) ?? actFilter}</Badge>}
-      </div>
-    </div>
-
-    {pageNotice !== null && <p className={styles.kbNotice} role="alert">
-      <AlertCircle size={13} /><span>{pageNotice}</span>
-      {/* 这一枚原来是手写的 `<button>`，命中区只有 12px、图标用自己的字号档，焦点圈
-          也是另写的一条。现在用与面板里其余关闭动作同一枚共享控件。 */}
-      <Button className={styles.kbNoticeClose} variant="ghost" size="icon" aria-label="关闭提示" title="关闭提示" onClick={() => setPageNotice(null)}><X size={13} /></Button>
-    </p>}
-    {error && <p className={styles.kbNotice}><AlertCircle size={13} /><span>{error}</span></p>}
-
-    {latest
-      ? <Interpretation record={latest} />
-      : <Card className={styles.intentEmptyCard}>
-        <BrainCircuit size={18} />
-        <strong>{hasFilter ? '当前筛选下没有判断' : '还没有可展示的判断'}</strong>
-        <p>{hasFilter ? '调整“意图”或“动作”筛选后再看。' : '选择一个有记录的会话后，这里会显示用户原话和 Agent 判断。'}</p>
-      </Card>}
-
-    <section className={styles.intentHistory}>
-      <div className={styles.intentSectionHead}>
-        <div>
-          <h3>历史判断</h3>
-          <p className={styles.intentSectionSubhead}>当前会话中更早的记录</p>
-        </div>
-        <span className={styles.intentSectionCount}>{history.length} 条</span>
-      </div>
-      {history.length === 0
-        ? <p className={styles.intentEmpty}>{hasFilter ? '当前筛选下没有更早的判断。' : latest ? '这是当前会话的第一条判断。' : '暂无历史记录。'}</p>
-        : <ol className={styles.intentHistoryList}>
-          {history.map(record => <HistoryItem key={record.id} record={record} />)}
-        </ol>}
-    </section>
-
-    <div className={styles.intentFooter}>
-      <span>共 {filteredRecent.length} 条判断{hasFilter ? `（当前会话 ${recent.length} 条）` : ''}</span>
-      {auditStats.lowConfidence > 0 && <span>{auditStats.lowConfidence} 条需要复核</span>}
-      {auditStats.fallback > 0 && <span>{auditStats.fallback} 条系统兜底</span>}
-      {store?.expiresAt && <span>保留至 {formatTime(store.expiresAt)}</span>}
-    </div>
-  </div>
-}