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

package/src/client/AxisRegistrySection.tsx

@@ -87,7 +87,7 @@ interface GuidanceDraft {
 
 export interface AxisRegistrySectionProps {
   kbId: string
-  /** 打开时先滚到这一节（`TypeDefinitionDrawer` 的三个入口之一）。 */
+  /** 打开时先滚到这一节（编译设置视图里的入口之一）。 */
   canEdit: boolean
   onBusyChange?: (busy: boolean) => void
 }

package/src/client/CompileSettingsView.tsx

@@ -0,0 +1,473 @@
+/**
+ * 「编译设置」—— 知识处理整页里的一个视图，不再是面板里的一只抽屉。
+ *
+ * ## 为什么搬到这里
+ *
+ * 它改的是**这个库怎么把文档变成知识**：编译模型、思考强度、坐标提取备注、坐标实体。
+ * 这些决定不属于任何一段流水线，但它们是这条流水线的**参数**。放在面板工具栏上时，
+ * 人和「知识处理」是两个入口、两处容器；放在这一页上时，改完参数就紧挨着跑那一段。
+ *
+ * ## 模型选择为什么是对话框，而不是下拉列表
+ *
+ * 编译模型不是「从三个选项里挑一个」：每个模型要带 provider、模型 id、说明，还要能
+ * 选思考强度，列表有十几项。原来那个扁平下拉把「名字（provider / id）」压成一行长字，
+ * 读不出重点，也没法标出失效项与当前项。所以这里改成**对话框里的可选列表**：
+ * 搜索、按 provider 分组、每行两段（名字 + 出处）、选中打勾，思考强度在底部单独一段。
+ *
+ * 它复用的是宿主对话框那一套：`Dialog` + `Input` + `Button`，视觉走同一套 token，
+ * 不另造一个弹层。
+ */
+
+import { useEffect, useMemo, useState, type ReactNode } from 'react'
+import { AlertCircle, Check, ChevronDown, LoaderCircle, Search } from '@tita-agent/ui/icons'
+import { Badge, Button, Field, Input, Textarea, cn } from '@tita-agent/ui/components'
+import {
+  Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle,
+} from '@tita-agent/ui/overlays'
+import { AxisRegistrySection } from './AxisRegistrySection.tsx'
+import { requestJson } from './request.ts'
+import { DEFAULT_EXTRACTION_TIMEOUT_MINUTES, EXTRACTION_RECOVERY_LIMITS, EXTRACTION_TIMEOUT_OPTIONS, normalizeExtractionTimeoutMinutes, type ExtractionTimeoutMinutes } from '../pipeline/types.js'
+
+export interface CompileModelSelectionView {
+  mode: 'default' | 'fixed'
+  provider?: string
+  model?: string
+  reasoningEffort?: string
+  maxTokens?: number
+}
+
+interface CompileModelCatalogItem {
+  provider: string
+  id: string
+  name: string
+  description?: string
+  available: boolean
+  /** DSH 当前的默认模型。它不是「本库选中的模型」，所以界面上叫「DSH 默认」。 */
+  current?: boolean
+  defaultMaxTokens?: number
+  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
+}
+
+interface BaseView {
+  id: string
+  name: string
+  extractionNote: string
+  compileModel: CompileModelSelectionView
+  extractionTimeoutMinutes?: ExtractionTimeoutMinutes
+}
+
+/**
+ * 思考强度的显示名。
+ *
+ * 目录给的是 `low` / `high` / `max` 这类 id；同一屏其余文字都是中文，直接印 id
+ * 就是在界面中间露出一段配置值。**认得的翻译，不认得的原样保留** —— 后者是目录
+ * 新增档位时唯一诚实的做法（编一个中文名会让两件事看起来是同一个档）。
+ */
+const EFFORT_LABEL: Record<string, string> = {
+  off: '关闭思考', none: '关闭思考', minimal: '最低', low: '低', medium: '中', high: '高', xhigh: '很高', max: '最高',
+}
+
+const DEFAULT_VALUE = '__dsh_default__'
+const fixedValue = (provider: string, model: string): string => `fixed:${encodeURIComponent(provider)}:${encodeURIComponent(model)}`
+const parseValue = (value: string): { provider?: string; model?: string } => {
+  if (!value.startsWith('fixed:')) return {}
+  const [provider, model] = value.slice(6).split(':').map(decodeURIComponent)
+  return { ...(provider ? { provider } : {}), ...(model ? { model } : {}) }
+}
+
+function modelLabel(item: CompileModelCatalogItem | undefined): string {
+  return item?.name?.trim() || item?.id || ''
+}
+
+/** 一行「当前选了什么」。触发按钮与列表行共用同一套读法。 */
+function SelectionSummary({ catalog, selection }: { catalog: CompileModelCatalog | null; selection: CompileModelSelectionView }): ReactNode {
+  const output = <span>单次最大输出：{selection.maxTokens !== undefined ? `${selection.maxTokens.toLocaleString('zh-CN')} token` : '跟随模型默认'}</span>
+  if (selection.mode === 'fixed' && selection.provider && selection.model) {
+    const item = catalog?.models.find(model => model.provider === selection.provider && model.id === selection.model)
+    return <>
+      <strong>{modelLabel(item) || selection.model}</strong>
+      <span>{selection.provider} / {selection.model}{selection.reasoningEffort ? ` · ${selection.reasoningEffort}` : ''}</span>
+      {output}
+    </>
+  }
+  const route = catalog?.default
+  return <>
+    <strong>跟随 DSH 默认模型</strong>
+    <span>{route?.provider && route.model ? `${route.provider} / ${route.model}` : '运行时读取当前模型设置'}{selection.reasoningEffort ? ` · ${selection.reasoningEffort}` : ''}</span>
+    {output}
+  </>
+}
+
+/**
+ * 模型选择对话框。**只在打开时挂载** —— 每次打开都是新的一次草稿，
+ * 不需要再写一段「把草稿重置回已保存的值」的 effect（那种 effect 最容易把
+ * 服务端刚保存的值又改回去）。
+ */
+function ModelPickerDialog({ kb, selection, onClose, onSaved }: {
+  kb: string
+  selection: CompileModelSelectionView
+  onClose: () => void
+  onSaved: () => Promise<void>
+}): ReactNode {
+  const [draft, setDraft] = useState(selection.mode === 'fixed' && selection.provider && selection.model
+    ? fixedValue(selection.provider, selection.model)
+    : DEFAULT_VALUE)
+  const [effort, setEffort] = useState(selection.reasoningEffort ?? '')
+  const [maxTokens, setMaxTokens] = useState(selection.maxTokens === undefined ? '' : String(selection.maxTokens))
+  const [catalog, setCatalog] = useState<CompileModelCatalog | null>(null)
+  const [error, setError] = useState('')
+  const [loading, setLoading] = useState(true)
+  const [saving, setSaving] = useState(false)
+  const [query, setQuery] = useState('')
+
+  /**
+   * 目录按**草稿路由**重新读一次：思考强度是跟着模型走的，只在当前路由上返回。
+   * 目录自己不进依赖（写 `catalog` 的 effect 不能把 `catalog` 当输入），所以
+   * 默认路由的 provider / model 从一个 ref 里取不到时，服务端会自己补。
+   */
+  useEffect(() => {
+    let cancelled = false
+    setLoading(true)
+    setError('')
+    const route = parseValue(draft)
+    const params = new URLSearchParams({ kb })
+    if (route.provider && route.model) {
+      params.set('provider', route.provider)
+      params.set('model', route.model)
+    }
+    void requestJson<CompileModelCatalog>(`/knowledge/models?${params}`).then(result => {
+      if (cancelled) return
+      setCatalog(result.data ?? null)
+    }).catch(cause => {
+      if (cancelled) return
+      setError(cause instanceof Error ? cause.message : String(cause))
+    }).finally(() => { if (!cancelled) setLoading(false) })
+    return () => { cancelled = true }
+  }, [kb, draft])
+
+  const route = parseValue(draft)
+  const effectiveProvider = route.provider ?? catalog?.default.provider
+  const effectiveModel = route.model ?? catalog?.default.model
+  const selectedItem = catalog?.models.find(item => item.provider === effectiveProvider && item.id === effectiveModel)
+  const efforts = selectedItem?.reasoning?.efforts ?? []
+  const defaultAvailable = catalog?.default.available !== false
+
+  /** 过滤只发生在渲染层：目录本身按 provider 分组，搜索不改变分组。 */
+  const groups = useMemo(() => {
+    const needle = query.trim().toLowerCase()
+    const match = (item: CompileModelCatalogItem): boolean => needle === ''
+      || item.name.toLowerCase().includes(needle)
+      || item.id.toLowerCase().includes(needle)
+      || item.provider.toLowerCase().includes(needle)
+      || (item.description ?? '').toLowerCase().includes(needle)
+    const byProvider = new Map<string, CompileModelCatalogItem[]>()
+    for (const item of catalog?.models ?? []) {
+      if (!match(item)) continue
+      const list = byProvider.get(item.provider) ?? []
+      list.push(item)
+      byProvider.set(item.provider, list)
+    }
+    const showDefault = needle === '' || ['跟随', '默认', 'dsh', 'default'].some(token => token.includes(needle) || needle.includes(token))
+    return { groups: [...byProvider.entries()], showDefault }
+  }, [catalog, query])
+
+  const save = async (): Promise<void> => {
+    setSaving(true)
+    setError('')
+    try {
+      const outputLimit = maxTokens.trim() === '' ? undefined : Number(maxTokens)
+      if (outputLimit !== undefined && (!Number.isSafeInteger(outputLimit) || outputLimit <= 0)) throw new Error('单次最大输出必须是正整数 token；留空表示跟随模型默认。')
+      const next: CompileModelSelectionView = draft === DEFAULT_VALUE
+        ? { mode: 'default', ...(effort === '' ? {} : { reasoningEffort: effort }) }
+        : { mode: 'fixed', ...route, ...(effort === '' ? {} : { reasoningEffort: effort }) }
+      if (outputLimit !== undefined) next.maxTokens = outputLimit
+      if (next.mode === 'fixed' && (!next.provider || !next.model)) throw new Error('没有选中模型')
+      const saved = await requestJson<{ base: BaseView }>(`/knowledge/bases/${encodeURIComponent(kb)}`, {
+        method: 'PATCH',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ compileModel: next }),
+      })
+      if (saved.data?.base.compileModel.maxTokens !== outputLimit) throw new Error('服务未保存最大输出设置。请确认已加载新版服务，再重试保存。')
+      await onSaved()
+      onClose()
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : String(cause))
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  const row = (item: CompileModelCatalogItem): ReactNode => {
+    const value = fixedValue(item.provider, item.id)
+    const on = draft === value
+    return <button
+      key={value}
+      type="button"
+      role="radio"
+      aria-checked={on}
+      disabled={!item.available}
+      className={cn('ktModelRow', on && 'ktModelRowOn', !item.available && 'ktModelRowOff')}
+      onClick={() => { setDraft(value); setEffort('') }}
+    >
+      <span className="ktModelRowBody">
+        <span className="ktModelRowName">
+          {item.name}
+          {item.current === true && <Badge tone="neutral">DSH 默认</Badge>}
+          {!item.available && <Badge tone="warning">已失效</Badge>}
+        </span>
+        <span className="ktModelRowMeta">{item.provider} / {item.id}</span>
+        {item.description !== undefined && item.description !== '' && <span className="ktModelRowDesc">{item.description}</span>}
+      </span>
+      <span className="ktModelRowCheck" aria-hidden="true">{on && <Check size={13} />}</span>
+    </button>
+  }
+
+  return <Dialog open onOpenChange={next => { if (!next) onClose() }}>
+    <DialogContent className="ktModelDialog">
+      <DialogHeader>
+        <DialogTitle>选择编译模型</DialogTitle>
+        <DialogDescription>用于抽取、归一补判与卡片组织。任务启动时保存实际选择，之后的运行记录里能读回来。</DialogDescription>
+      </DialogHeader>
+
+      <label className="ktModelSearch">
+        <Search size={13} aria-hidden="true" />
+        <Input value={query} onChange={event => setQuery(event.target.value)} placeholder="搜索模型名、provider 或说明" aria-label="搜索编译模型" autoFocus />
+      </label>
+
+      <div className="ktModelList" role="radiogroup" aria-label="编译模型">
+        {groups.showDefault && <>
+          <button
+            type="button"
+            role="radio"
+            aria-checked={draft === DEFAULT_VALUE}
+            className={cn('ktModelRow', draft === DEFAULT_VALUE && 'ktModelRowOn')}
+            onClick={() => { setDraft(DEFAULT_VALUE); setEffort('') }}
+          >
+            <span className="ktModelRowBody">
+              <span className="ktModelRowName">跟随 DSH 默认模型{!defaultAvailable && <Badge tone="warning">默认模型不可用</Badge>}</span>
+              <span className="ktModelRowMeta">{catalog?.default.provider && catalog.default.model ? `${catalog.default.provider} / ${catalog.default.model}` : '运行时读取当前模型设置'}</span>
+              <span className="ktModelRowDesc">换 DSH 默认模型时，这个库跟着换；任务记录里留下当次实际使用的模型。</span>
+            </span>
+            <span className="ktModelRowCheck" aria-hidden="true">{draft === DEFAULT_VALUE && <Check size={13} />}</span>
+          </button>
+          <div className="ktModelDivider" aria-hidden="true">模型目录</div>
+        </>}
+
+        {loading && catalog === null && <p className="ktModelEmpty" role="status"><LoaderCircle size={13} className="tita-spin" />正在读取 DSH 模型目录…</p>}
+        {!loading && catalog !== null && groups.groups.length === 0 && <p className="ktModelEmpty">没有匹配的模型。</p>}
+        {groups.groups.map(([provider, items]) => <div key={provider} className="ktModelGroup">
+          <p className="ktModelGroupName">{provider}</p>
+          {items.map(row)}
+        </div>)}
+      </div>
+
+      <div className="ktEffort">
+        <div className="ktEffortHead">
+          <h3>思考强度</h3>
+          <p>{efforts.length > 0 ? '档位来自所选模型的 DSH 目录；不选就跟随模型默认。' : '所选模型没有公开档位，使用模型默认行为。'}</p>
+        </div>
+        <div className="ktEffortOptions" role="group" aria-label="思考强度">
+          <button type="button" className={cn('ktEffortOption', effort === '' && 'ktEffortOptionOn')} aria-pressed={effort === ''} onClick={() => setEffort('')}>跟随默认</button>
+          {efforts.map(item => <button
+            key={item.id}
+            type="button"
+            className={cn('ktEffortOption', effort === item.id && 'ktEffortOptionOn')}
+            aria-pressed={effort === item.id}
+            title={item.description}
+            onClick={() => setEffort(item.id)}
+          >{EFFORT_LABEL[item.id] ?? item.name ?? item.id}</button>)}
+          {effort !== '' && !efforts.some(item => item.id === effort)
+            && <button type="button" className="ktEffortOption ktEffortOptionOn" aria-pressed title="当前选择在这份目录里不可用">{effort}（不可用）</button>}
+        </div>
+      </div>
+
+      <div className="ktOutputLimit">
+        <Field label="单次最大输出（token）" hint="留空跟随模型默认；这是单次请求的输出上限，不是文档大小或整次任务预算。">
+          <Input type="number" min={1} step={1} inputMode="numeric" aria-label="单次最大输出 token" value={maxTokens} placeholder="跟随模型默认" onChange={event => setMaxTokens(event.target.value)} aria-invalid={maxTokens !== '' && (!Number.isSafeInteger(Number(maxTokens)) || Number(maxTokens) <= 0)} />
+        </Field>
+        <div className="mt-2 flex flex-wrap items-center gap-2" role="group" aria-label="最大输出快捷设置">
+          <Button variant="ghost" aria-pressed={maxTokens === ''} onClick={() => setMaxTokens('')}>跟随默认</Button>
+          <Button variant="outline" aria-pressed={maxTokens === '100000'} onClick={() => setMaxTokens('100000')}>10 万 token</Button>
+        </div>
+        {selectedItem?.defaultMaxTokens !== undefined && <p className="ktHint">DSH 模型默认输出：{selectedItem.defaultMaxTokens.toLocaleString('zh-CN')} token。此值不是模型的硬上限。</p>}
+        <p className="ktHint">实际可用长度由模型、网关和剩余上下文共同限制；增大此值不会提高生成速度，也不会延长超时。</p>
+      </div>
+
+      {error !== '' && <p className="ktModelError" role="alert"><AlertCircle size={13} />{error}</p>}
+      {catalog?.why !== undefined && catalog.why !== '' && error === '' && <p className="ktModelWhy" role="status">模型目录提示：{catalog.why}</p>}
+
+      <DialogFooter>
+        <Button variant="ghost" size="sm" onClick={onClose} disabled={saving}>取消</Button>
+        <Button size="sm" onClick={() => { void save() }} disabled={saving || loading}>
+          {saving ? <LoaderCircle size={13} className="tita-spin" /> : <Check size={13} />}保存
+        </Button>
+      </DialogFooter>
+    </DialogContent>
+  </Dialog>
+}
+
+/**
+ * 编译设置页。它自己读写 `/knowledge/bases`，因为整页与面板是两份文档 ——
+ * 从面板传 state 过来只会得到一份「面板没打开时就是空的」设置。
+ */
+export function CompileSettingsView({ kb, onNotice }: {
+  kb: string
+  onNotice: (tone: 'success' | 'error', text: string) => void
+}): ReactNode {
+  const [base, setBase] = useState<BaseView | null>(null)
+  const [catalog, setCatalog] = useState<CompileModelCatalog | null>(null)
+  const [failure, setFailure] = useState('')
+  const [note, setNote] = useState('')
+  const [savingNote, setSavingNote] = useState(false)
+  const [pickerOpen, setPickerOpen] = useState(false)
+  const [timeoutMinutes, setTimeoutMinutes] = useState<ExtractionTimeoutMinutes>(DEFAULT_EXTRACTION_TIMEOUT_MINUTES)
+  const [savingTimeout, setSavingTimeout] = useState(false)
+
+  const load = async (): Promise<void> => {
+    try {
+      const result = await requestJson<{ bases: BaseView[] }>('/knowledge/bases')
+      const found = result.data?.bases.find(item => item.id === kb) ?? null
+      setBase(found)
+      setNote(found?.extractionNote ?? '')
+      setTimeoutMinutes(normalizeExtractionTimeoutMinutes(found?.extractionTimeoutMinutes))
+      setFailure(found === null ? '这个地址里的知识库不存在。' : '')
+    } catch (cause) {
+      setFailure(cause instanceof Error ? cause.message : String(cause))
+    }
+  }
+
+  useEffect(() => {
+    let cancelled = false
+    void requestJson<CompileModelCatalog>(`/knowledge/models?${new URLSearchParams({ kb })}`)
+      .then(result => { if (!cancelled) setCatalog(result.data ?? null) })
+      .catch(() => { /* 目录读不到时对话框里会报；这里不重复喊一遍 */ })
+    void requestJson<{ bases: BaseView[] }>('/knowledge/bases').then(result => {
+      if (cancelled) return
+      const found = result.data?.bases.find(item => item.id === kb) ?? null
+      setBase(found)
+      setNote(found?.extractionNote ?? '')
+      setTimeoutMinutes(normalizeExtractionTimeoutMinutes(found?.extractionTimeoutMinutes))
+      setFailure(found === null ? '这个地址里的知识库不存在。' : '')
+    }).catch(cause => { if (!cancelled) setFailure(cause instanceof Error ? cause.message : String(cause)) })
+    return () => { cancelled = true }
+  }, [kb])
+
+  const saveNote = async (): Promise<void> => {
+    setSavingNote(true)
+    try {
+      await requestJson(`/knowledge/bases/${encodeURIComponent(kb)}`, {
+        method: 'PATCH',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ extractionNote: note }),
+      })
+      await load()
+      onNotice('success', note.trim() === '' ? '备注已清空 —— 下一次抽取不再带这段约定。' : `备注已保存（${note.trim().length} 字），下一次抽取会逐字带上它。`)
+    } catch (cause) {
+      onNotice('error', cause instanceof Error ? cause.message : String(cause))
+    } finally {
+      setSavingNote(false)
+    }
+  }
+
+  const saveTimeout = async (): Promise<void> => {
+    setSavingTimeout(true)
+    try {
+      const saved = await requestJson<{ base: BaseView }>(`/knowledge/bases/${encodeURIComponent(kb)}`, {
+        method: 'PATCH', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ extractionTimeoutMinutes: timeoutMinutes }),
+      })
+      if (saved.data?.base.extractionTimeoutMinutes !== timeoutMinutes) throw new Error('服务未保存抽取时限。请确认已加载新版服务，再重试保存。')
+      setBase(saved.data.base)
+      onNotice('success', `文档抽取时限已保存为 ${timeoutMinutes} 分钟；下一次运行或续跑生效。`)
+    } catch (cause) {
+      onNotice('error', cause instanceof Error ? cause.message : String(cause))
+    } finally { setSavingTimeout(false) }
+  }
+
+  if (failure !== '') return <p className="ktError" role="alert"><AlertCircle size={13} />{failure}</p>
+  if (base === null) return <p className="ktEmpty" role="status"><LoaderCircle size={13} className="tita-spin" />正在读取本库的编译设置…</p>
+
+  const selection = base.compileModel ?? { mode: 'default' }
+  const noteChanged = note !== base.extractionNote
+
+  return <div className="ktSettings">
+    <div className="ktSettingsCol">
+      <section className="ktSettingCard" aria-labelledby="kt-model-title">
+        <div className="ktSettingHead">
+          <h2 id="kt-model-title">编译模型</h2>
+          <p>本库的抽取、归一补判与卡片组织都用它。</p>
+        </div>
+        <Field as="div" label="模型" hint="跟随 DSH 默认模型时，默认模型换了本库也跟着换。">
+          <button type="button" className="ktModelField" onClick={() => setPickerOpen(true)} aria-label="更换编译模型">
+            <span className="ktModelFieldBody"><SelectionSummary catalog={catalog} selection={selection} /></span>
+            <span className="ktModelFieldAction">更换<ChevronDown size={13} /></span>
+          </button>
+        </Field>
+        {selection.mode === 'fixed' && catalog !== null && !catalog.models.some(item => item.provider === selection.provider && item.id === selection.model)
+          && <p className="ktHint ktHintWarn" role="status">这个固定模型已不在 DSH 模型目录里；下一次运行可能失败，建议重新选择。</p>}
+        <p className="ktHint">思考强度与最大输出都在「更换」里设置；保存后下一次运行或续跑生效。</p>
+      </section>
+
+      <section className="ktSettingCard" aria-labelledby="kt-timeout-title">
+        <div className="ktSettingHead">
+          <h2 id="kt-timeout-title">文档抽取时限</h2>
+          <p>每份文档的一轮抽取或续跑，最多运行多长时间。</p>
+        </div>
+        <div className="flex flex-wrap gap-2" role="group" aria-label="文档抽取时限">
+          {EXTRACTION_TIMEOUT_OPTIONS.map(minutes => <Button key={minutes} variant={timeoutMinutes === minutes ? 'default' : 'outline'} aria-pressed={timeoutMinutes === minutes} disabled={savingTimeout} onClick={() => setTimeoutMinutes(minutes)}>
+            {minutes} 分钟{minutes === DEFAULT_EXTRACTION_TIMEOUT_MINUTES ? '（默认）' : minutes === 100 ? '（上限）' : ''}
+          </Button>)}
+        </div>
+        <p className="ktHint">保存后，下一次运行或续跑使用新时限；已启动的任务保持原值。达到时限时保留已保存分片。</p>
+        <p className="ktHint">单次模型请求仍默认 {EXTRACTION_RECOVERY_LIMITS.requestTimeoutMs / 60_000} 分钟超时。每轮请求次数上限取 {EXTRACTION_RECOVERY_LIMITS.minimumRequests} 次与初始分片数 × {EXTRACTION_RECOVERY_LIMITS.requestsPerInitialChunk} 次中的较大值，与时限独立。</p>
+        {timeoutMinutes !== normalizeExtractionTimeoutMinutes(base.extractionTimeoutMinutes) && <div className="ktSettingActions">
+          <Button variant="ghost" disabled={savingTimeout} onClick={() => setTimeoutMinutes(normalizeExtractionTimeoutMinutes(base.extractionTimeoutMinutes))}>撤销</Button>
+          <Button variant="outline" disabled={savingTimeout} onClick={() => { void saveTimeout() }}>{savingTimeout ? <LoaderCircle size={12} className="motion-safe:animate-spin" /> : <Check size={12} />}保存时限</Button>
+        </div>}
+      </section>
+
+      <section className="ktSettingCard" aria-labelledby="kt-note-title">
+        <div className="ktSettingHead">
+          <h2 id="kt-note-title">提取备注</h2>
+          <p>逐字加入每次抽取的提示词，只影响本库的坐标判断。</p>
+        </div>
+        <Field label="坐标约定" hint="写本库特有的对象 / 动作 / 场景约定；留空就是不带提示。">
+          <Textarea value={note} rows={5} spellCheck={false} aria-label="坐标提取备注"
+            placeholder="例如：本库的「活动」指投放计划，不指营销活动。"
+            onChange={event => setNote(event.target.value)} />
+        </Field>
+        {noteChanged && <div className="ktSettingActions">
+          <Button variant="ghost" size="sm" onClick={() => setNote(base.extractionNote)}>撤销</Button>
+          <Button variant="outline" size="sm" disabled={savingNote} onClick={() => { void saveNote() }}>
+            {savingNote ? <LoaderCircle size={12} className="tita-spin" /> : <Check size={12} />}保存备注
+          </Button>
+        </div>}
+      </section>
+    </div>
+
+    {/* 坐标实体那一节自带标题与「N 个待确认」，这里不再套一层同名标题 ——
+        同一句话出现两次，人会以为是两个东西。 */}
+    <div className="ktSettingsWide">
+      <AxisRegistrySection kbId={kb} canEdit />
+    </div>
+
+    {pickerOpen && <ModelPickerDialog
+      kb={kb}
+      selection={selection}
+      onClose={() => setPickerOpen(false)}
+      onSaved={async () => {
+        await load()
+        void requestJson<CompileModelCatalog>(`/knowledge/models?${new URLSearchParams({ kb })}`)
+          .then(result => setCatalog(result.data ?? null))
+          .catch(() => { /* 保存已成功；目录刷新失败不推翻这次保存 */ })
+        onNotice('success', '编译模型已保存。')
+      }}
+    />}
+  </div>
+}

package/src/client/DirectoryPicker.tsx

@@ -64,8 +64,6 @@ export interface AgentLayoutView {
   domainKnowledge: string
   /** 0029：记忆那一段（版本快照、反馈、访问审计），按知识库分格。 */
   memory: string
-  /** 意图记录那一段。 */
-  intent: string
   tmp: string
   /** 0029：家当那一段（模型 / Python 环境 / 注册表）。 */
   resource: string