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

package/src/client/TypeDefinitionDrawer.tsx

@@ -1,195 +0,0 @@
-import { useEffect, useMemo, useRef, useState, type ChangeEvent, type ReactNode } from 'react'
-import { Check } from '@tita-agent/ui/icons'
-import { Button, Field, SelectMenu, Textarea, type SelectMenuOption } from '@tita-agent/ui/components'
-import {
-  Drawer, DrawerBody, DrawerContent, DrawerHeader, DrawerTitle,
-} from '@tita-agent/ui/overlays'
-import { styles } from './styles.ts'
-import { AxisRegistrySection } from './AxisRegistrySection.tsx'
-import { requestJson } from './request.ts'
-
-export interface CompileModelSelectionView {
-  mode: 'default' | 'fixed'
-  provider?: string
-  model?: string
-  reasoningEffort?: string
-}
-
-interface CompileModelCatalogItem {
-  provider: string
-  id: string
-  name: string
-  description?: string
-  available: boolean
-  current?: boolean
-  reasoning?: { efforts: Array<{ id: string; name: string; description?: string }>; defaultEffort?: string }
-}
-
-interface CompileModelCatalog {
-  selection: CompileModelSelectionView
-  default: { provider?: string; model?: string; reasoningEffort?: string; available: boolean }
-  models: CompileModelCatalogItem[]
-  why?: string
-}
-
-const DEFAULT_MODEL_VALUE = '__dsh_default__'
-const fixedModelValue = (provider: string, model: string): string => `fixed:${encodeURIComponent(provider)}:${encodeURIComponent(model)}`
-
-export interface TypeDefinitionDrawerProps {
-  open: boolean
-  onOpenChange: (open: boolean) => void
-  kbId: string
-  busy: string | null
-  extractionNote?: string
-  onSaveExtractionNote?: (note: string) => Promise<void>
-  compileModel?: CompileModelSelectionView
-  onSaveCompileModel?: (selection: CompileModelSelectionView) => Promise<void>
-}
-
-export function TypeDefinitionDrawer({
-  open, onOpenChange, kbId, busy, extractionNote = '', onSaveExtractionNote,
-  compileModel = { mode: 'default' }, onSaveCompileModel,
-}: TypeDefinitionDrawerProps): ReactNode {
-  const [noteDraft, setNoteDraft] = useState(extractionNote)
-  const [modelDraft, setModelDraft] = useState(DEFAULT_MODEL_VALUE)
-  const [effortDraft, setEffortDraft] = useState(compileModel.reasoningEffort ?? '__default__')
-  useEffect(() => { setEffortDraft(compileModel.reasoningEffort ?? '__default__') }, [compileModel.reasoningEffort])
-  const [catalog, setCatalog] = useState<CompileModelCatalog | null>(null)
-  const [catalogError, setCatalogError] = useState('')
-  /**
-   * 上一次读回来的默认模型。
-   *
-   * 放进 ref 而不是当成 effect 的依赖：这份 effect **自己会写 `catalog`**，把
-   * `catalog?.default.provider` 列进依赖就是让输出当输入 —— 每读一次目录都会再触发
-   * 一次自己，打开抽屉要打两三次 `/knowledge/models`。ref 让它读到最新值，但不触发。
-   */
-  const catalogRef = useRef<CompileModelCatalog | null>(null)
-  catalogRef.current = catalog
-  useEffect(() => { setNoteDraft(extractionNote) }, [extractionNote])
-  useEffect(() => {
-    if (compileModel.mode === 'fixed' && compileModel.provider && compileModel.model) {
-      setModelDraft(fixedModelValue(compileModel.provider, compileModel.model))
-    } else {
-      setModelDraft(DEFAULT_MODEL_VALUE)
-    }
-  }, [compileModel.mode, compileModel.provider, compileModel.model])
-  useEffect(() => {
-    if (!open || onSaveCompileModel === undefined) return undefined
-    let cancelled = false
-    setCatalogError('')
-    const route = modelDraft.startsWith('fixed:') ? modelDraft.split(':').slice(1).map(decodeURIComponent) : [catalogRef.current?.default.provider, catalogRef.current?.default.model]
-    const params = new URLSearchParams({ kb: kbId })
-    if (route[0] && route[1]) { params.set('provider', route[0]); params.set('model', route[1]) }
-    void requestJson<CompileModelCatalog>(`/knowledge/models?${params}`).then(result => {
-      if (!cancelled) setCatalog(result.data ?? null)
-    }).catch(error => {
-      if (!cancelled) setCatalogError(error instanceof Error ? error.message : String(error))
-    })
-    return () => { cancelled = true }
-  }, [kbId, onSaveCompileModel, open, modelDraft])
-
-  const modelOptions = useMemo(() => {
-    const options: SelectMenuOption[] = [{
-      value: DEFAULT_MODEL_VALUE,
-      label: catalog?.default?.provider && catalog.default.model
-        ? `跟随 DSH 默认模型（${catalog.default.provider} / ${catalog.default.model}）`
-        : '跟随 DSH 默认模型',
-    }]
-    for (const item of catalog?.models ?? []) {
-      options.push({
-        value: fixedModelValue(item.provider, item.id),
-        label: item.available
-          ? `${item.name}（${item.provider} / ${item.id}）`
-          : `当前已失效：${item.provider} / ${item.id}`,
-        ...(item.available ? {} : { disabled: true }),
-      })
-    }
-    if (compileModel.mode === 'fixed' && compileModel.provider && compileModel.model
-      && !options.some(option => option.value === fixedModelValue(compileModel.provider!, compileModel.model!))) {
-      options.push({
-        value: fixedModelValue(compileModel.provider, compileModel.model),
-        label: `当前已失效：${compileModel.provider} / ${compileModel.model}`,
-        disabled: true,
-      })
-    }
-    return options
-  }, [catalog, compileModel.mode, compileModel.model, compileModel.provider])
-
-  const modelChanged = effortDraft !== (compileModel.reasoningEffort ?? '__default__') || modelDraft !== (compileModel.mode === 'fixed' && compileModel.provider && compileModel.model
-    ? fixedModelValue(compileModel.provider, compileModel.model)
-    : DEFAULT_MODEL_VALUE)
-  const saveCompileModel = async (): Promise<void> => {
-    if (onSaveCompileModel === undefined) return
-    if (modelDraft === DEFAULT_MODEL_VALUE) {
-      await onSaveCompileModel({ mode: 'default', ...(effortDraft === '__default__' ? {} : { reasoningEffort: effortDraft }) })
-      return
-    }
-    const selected = catalog?.models.find(item => fixedModelValue(item.provider, item.id) === modelDraft && item.available)
-    if (!selected) return
-    await onSaveCompileModel({ mode: 'fixed', provider: selected.provider, model: selected.id, ...(effortDraft === '__default__' ? {} : { reasoningEffort: effortDraft }) })
-  }
-
-  const selectedModel = catalog?.models.find(item => modelDraft === DEFAULT_MODEL_VALUE
-    ? item.provider === catalog.default.provider && item.id === catalog.default.model
-    : fixedModelValue(item.provider, item.id) === modelDraft)
-  const effortOptions: SelectMenuOption[] = [{ value: '__default__', label: '跟随模型默认强度' }, ...(selectedModel?.reasoning?.efforts ?? []).map(item => ({ value: item.id, label: item.name }))]
-  if (effortDraft !== '__default__' && !effortOptions.some(option => option.value === effortDraft)) effortOptions.push({ value: effortDraft, label: `当前不可用：${effortDraft}`, disabled: true })
-
-  return <Drawer open={open} onOpenChange={onOpenChange}>
-    {open && <DrawerContent
-      className={styles.settingsDrawer}
-      resizable
-      resizeKey="tita-typedef-drawer"
-    >
-      <DrawerHeader>
-        <DrawerTitle>编译设置</DrawerTitle>
-      </DrawerHeader>
-      <DrawerBody>
-        <div className={styles.settingsStack}>
-          {onSaveCompileModel !== undefined && <section className={styles.settingsSection}>
-            <div className={styles.settingsSectionHeader}>
-              <div><h3>编译模型</h3></div>
-            </div>
-            <Field as="div" label="模型" hint="用于抽取、归一补判与卡片组织；任务启动时保存实际选择。">
-              <SelectMenu value={modelDraft} disabled={busy !== null || (catalog === null && catalogError === '')} onValueChange={value => { setModelDraft(value); setEffortDraft('__default__') }}
-                options={modelOptions} placeholder="加载 DSH 模型目录…" aria-label="编译模型" />
-            </Field>
-            <Field as="div" label="思考强度" hint={selectedModel?.reasoning?.efforts.length ? '档位来自当前模型的 DSH 目录。' : '当前模型未提供可选档位，使用模型默认值。'}>
-              <SelectMenu value={effortDraft} options={effortOptions} onValueChange={setEffortDraft} disabled={busy !== null || !selectedModel?.reasoning?.efforts.length} aria-label="编译模型思考强度" />
-            </Field>
-            {catalog?.default && !catalog.default.available && <p className={styles.kbHint} role="status">
-              DSH 默认模型不可用；可在 DSH 设置中修复，或选择固定模型。
-            </p>}
-            {catalogError !== '' && <p className={styles.kbHint} role="alert">模型目录读取失败：{catalogError}</p>}
-            {catalog?.why && <p className={styles.kbHint} role="status">模型目录提示：{catalog.why}</p>}
-            {modelChanged && <div className={styles.settingsSectionActions}>
-              <Button variant="outline" size="sm" disabled={busy !== null || (catalog === null && modelDraft !== DEFAULT_MODEL_VALUE)}
-                onClick={() => void saveCompileModel()}>
-                <Check size={12} />保存
-              </Button>
-            </div>}
-          </section>}
-
-          {onSaveExtractionNote !== undefined && <section className={styles.settingsSection}>
-            <div className={styles.settingsSectionHeader}>
-              <div><h3>提取备注</h3></div>
-            </div>
-            <Field label="坐标约定" hint="逐字加入每次抽取提示词。">
-              <Textarea value={noteDraft} rows={3} spellCheck={false} disabled={busy !== null}
-                aria-label="坐标提取备注" placeholder="填写本库特有的坐标约定。"
-                onChange={(event: ChangeEvent<HTMLTextAreaElement>) => setNoteDraft(event.target.value)} />
-            </Field>
-            {noteDraft !== extractionNote && <div className={styles.settingsSectionActions}>
-              <Button variant="outline" size="sm" disabled={busy !== null}
-                onClick={() => void onSaveExtractionNote(noteDraft)}>
-                <Check size={12} />保存
-              </Button>
-            </div>}
-          </section>}
-
-          <AxisRegistrySection kbId={kbId} canEdit={busy === null} />
-        </div>
-      </DrawerBody>
-    </DrawerContent>}
-  </Drawer>
-}

package/src/intent/README.md

@@ -1,42 +0,0 @@
-# dsh-data-domain-knowledge/intent
-
-本模块是 Tita Data Agent 的会话意图审计记录器。它与知识库召回侧的 Query Analysis
-分开：前者记录会话事实，后者在每次检索时解析 Intent / Object / Action / Scene，
-用于生成和排序 WikiCard 候选。
-
-## 对外契约
-
-Host 提供两个工具：
-
-- `intent_record`：把模型对当前轮次的判断写成一条审计记录。
-- `intent_store_view`：查看当前会话的最近记录与任务链路。
-
-工具在 Host 层注册，供标准模式使用。意图写入与读取只接受 `standard` 会话。
-HTTP 只读接口是 `/intent/overview` 与
-`/intent/store`，服务名仍为 `titaDataAgentIntent`。
-
-## 固定审计契约
-
-分类、act 与 predicate 的内置词表由代码固定提供，不属于知识库配置，也没有编辑入口。
-`intent_record` 的工具描述携带这份固定规则；记录器只校验并保留模型结论，不做完整的
-意图分类、不反问、不阻断请求。门控只负责判断是否进入数据域：其他 preset 和普通聊天
-不创建意图记录；标准模式在数据工具、数据域请求或数据分类被激活后，模型漏调时，
-Host 才在 `turn/end` 补一条 `source: 'fallback'` 的 `unknown` 记录。
-
-## 记录与 ID
-
-- 按 `session + data turn` upsert：同一数据轮次重复调用只保留一条记录，普通轮次不落记录。
-- Host 在 `turn/start` 为当前轮次预分配 `subtaskId`；模型用 `relation` 表示新任务
-  （`new_task`）或已有任务的子任务（`subtask_of`）。
-- 记录写入 `<agentRoot>/intent/intent.db`。`intent_records` 保存每轮当前版本，
-  `intent_record_history` 追加保存每次变更。内存工作集仍按 TTL（默认 600 秒）管理，
-  SQLite 用于重启后的审计留痕与面板读取。
-
-## 与知识库召回的边界
-
-会话审计不会决定 WikiCard 的召回结果。知识库召回单独解析当前 Query，再通过
-Coordinate、FTS、Vector 三路生成 Section 候选，统一重排后归并为完整 WikiCard 返回
-给 Agent Context。
-
-因此，修改意图审计词表不是召回配置动作；需要调整召回行为时，应修改 Query Analysis、
-轴注册表或召回/重排参数。