dsh-data-domain-knowledge 0.1.0-alpha.9 → 0.1.1-alpha.2

package/src/client/AgentBehaviorRulesCard.tsx

@@ -0,0 +1,65 @@
+import { useState, type ReactNode } from 'react'
+import { Switch } from '@tita-agent/ui/components'
+import { AlertCircle } from '@tita-agent/ui/icons'
+import { AGENT_BEHAVIOR_RULE_SETS } from '../agent-behavior-rules.ts'
+import type { SettingsScopeLike } from './NodeSettings.tsx'
+import { useScope } from './NodeSettings.tsx'
+
+/** Shows the exact prompt additions and controls their live setting. */
+export function AgentBehaviorRulesCard({ settings }: { settings?: SettingsScopeLike }): ReactNode {
+  const snapshot = useScope(settings)
+  const [saving, setSaving] = useState(false)
+  const [error, setError] = useState<string>()
+  const enabled = typeof snapshot.value?.enabled === 'boolean' ? snapshot.value.enabled : true
+  const disabled = !settings || snapshot.status !== 'ready' || snapshot.writable === false || saving
+
+  const update = async (next: boolean): Promise<void> => {
+    if (!settings || disabled) return
+    setSaving(true)
+    setError(undefined)
+    try {
+      await settings.set('enabled', next)
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : String(cause))
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  const status = saving ? '正在保存' : snapshot.status !== 'ready' ? '不可用' : enabled ? '已开启' : '已关闭'
+
+  return <section id="tita-agent-behavior" className="tita-settingsSection" aria-labelledby="tita-agent-behavior-rules-label">
+    <div className="tita-settingsSectionHeader items-center">
+      <div>
+        <h3 id="tita-agent-behavior-rules-label">追加行为规则</h3>
+        <p id="tita-agent-behavior-rules-hint">用于标准模式，约束工具使用、知识写入和文件交付。</p>
+      </div>
+      <div className="flex shrink-0 items-center gap-2">
+        <span className="text-xs text-tita-ink-muted" role="status" aria-live="polite">{status}</span>
+        <Switch
+          checked={enabled}
+          disabled={disabled}
+          aria-labelledby="tita-agent-behavior-rules-label"
+          aria-describedby="tita-agent-behavior-rules-hint"
+          onCheckedChange={next => { void update(next) }}
+        />
+      </div>
+    </div>
+
+    {error && <div className="tita-settingsError mt-2 flex items-start gap-2" role="alert">
+      <AlertCircle size={13} className="mt-0.5 shrink-0" /><span>{error}</span>
+    </div>}
+    <div className="mt-5 grid gap-5">
+      {AGENT_BEHAVIOR_RULE_SETS.map(ruleSet => <div key={ruleSet.id}>
+        <h4 className="mb-3 mt-0 text-xs font-medium text-tita-ink-muted">{ruleSet.label} · {ruleSet.rules.length} 条规则</h4>
+        <ol className="m-0 list-decimal space-y-3 pl-5 text-xs leading-relaxed text-tita-ink marker:text-tita-ink-faint">
+          {ruleSet.rules.map(rule => <li key={rule} className="pl-1">
+            {rule.split(/(`[^`]+`)/g).map((part, index) => part.startsWith('`')
+              ? <code key={index} className="break-words rounded-tita-control bg-tita-surface-muted px-1 py-0.5 font-mono text-[11px]">{part.slice(1, -1)}</code>
+              : part)}
+          </li>)}
+        </ol>
+      </div>)}
+    </div>
+  </section>
+}

package/src/client/AttributionEventGuide.tsx

@@ -4,10 +4,10 @@ import {
 import type { ReactNode } from 'react'
 
 /**
- * 智能归因的 Event 说明页。
+ * 智能归因的 Case 说明页。
  *
- * 这页只解释模型，不假装 Event 已经是另一个坐标轴：坐标负责定位问题域，Event 负责
- * 记录一次具体排查里发生了什么。把这件事放在整页里，是因为它需要同时讲关系、例子和边界，
+ * 这页解释 Source Raw 如何并行提取 Knowledge 与 Case，以及 Knowledge 卡片如何引用 Case。
+ * Case 记录一次具体发生；坐标负责定位问题域。把这件事放在整页里，是因为它需要同时讲关系、例子和边界，
  * 不能压缩成侧栏里的 tooltip。
  */
 export function AttributionEventGuide(): ReactNode {
@@ -15,47 +15,49 @@ export function AttributionEventGuide(): ReactNode {
     <header className="attributionGuideIntro">
       <div className="attributionGuideMark" aria-hidden="true"><Workflow size={20} /></div>
       <div className="attributionGuideIntroCopy">
-        <p className="attributionGuideEyebrow">SMART ATTRIBUTION · EVENT MODEL</p>
-        <h2>一次排查，如何变成可复用的 Event</h2>
+        <p className="attributionGuideEyebrow">SMART ATTRIBUTION · CASE MODEL</p>
+        <h2>Source Raw 如何编译为 Fact、Procedure 和 Case</h2>
         <p>
-          Event 不是新的坐标维度，也不是另一张知识卡。它记录一条真实排查轨迹：发生了什么、做了什么、
-          看到了什么结果，以及最后确认了什么根因。
+          同一份 Source Raw 编译到 Knowledge 层：Fact 保存事实，Procedure 保存方法，Case 保存一次具体发生、
+          它的时间线、证据和结果。三类共用 Object × Action × Scene；Fact 按 Object 生成 Wiki Fact，Procedure 按 Object＋Action 生成 Wiki Way，
+          并用坐标引用相关 Case。
         </p>
       </div>
       <div className="attributionGuideFormula" aria-label="核心关系">
         <span>核心关系</span>
-        <code>Document → Event → Knowledge → WikiCard</code>
+        <code>Source Raw → {`{ Fact[], Procedure[], Case[] }`} → Wiki Fact / Wiki Way</code>
       </div>
     </header>
 
     <section className="attributionGuideSection" aria-labelledby="attribution-event-map-title">
       <div className="attributionGuideSectionHead">
         <p className="attributionGuideKicker">先看关系</p>
-        <h3 id="attribution-event-map-title">四个对象，各自回答一个问题</h3>
-        <p>来源保留证据，Event 保留经过，Knowledge 保留可复用的判断，WikiCard 负责让人按坐标找到它。</p>
+        <h3 id="attribution-event-map-title">Knowledge 层统一保存三类记录</h3>
+        <p>Source Raw 保留原始证据；Knowledge 层分为 Fact、Procedure、Case。Case 有实际过程证据时，可独立提炼候选 Procedure。</p>
       </div>
 
-      <div className="attributionGuidePipeline" role="img" aria-label="Document 产生 Event，Event 沉淀为 Knowledge，Knowledge 按坐标组织成 WikiCard；Event 也为 WikiCard 提供案例证据">
-        <GuideNode tone="source" icon={<FileText size={17} />} label="Document" title="原始记录" detail="复盘、工单、聊天、日志说明" />
-        <GuideConnector label="抽取一次具体经过" />
-        <GuideNode tone="event" icon={<CircleDot size={17} />} label="Event" title="一次排查轨迹" detail="按顺序记录观察、验证和结果" />
-        <GuideConnector label="归纳可复用判断" />
-        <GuideNode tone="knowledge" icon={<Lightbulb size={17} />} label="Knowledge" title="事实与方法" detail="可被别的排查再次引用" />
-        <GuideConnector label="按坐标组织" />
-        <GuideNode tone="card" icon={<GitBranch size={17} />} label="WikiCard" title="问题解决页面" detail="Object × Action × Scene" />
+      <div className="attributionGuidePipeline" role="img" aria-label="Source Raw 并行提取 Knowledge 和 Case；Knowledge 按坐标生成 Wiki Fact / Wiki Way，Case 按坐标建立引用">
+        <GuideNode tone="source" icon={<FileText size={17} />} label="Source Raw" title="原始记录" detail="复盘、工单、聊天、日志说明" />
+        <GuideConnector label="并行抽取" />
+        <div className="attributionGuideBranches">
+          <GuideNode tone="knowledge" icon={<Lightbulb size={17} />} label="Fact / Procedure" title="事实与方法" detail="可脱离本次事件复用" />
+          <GuideNode tone="event" icon={<CircleDot size={17} />} label="Case" title="一次具体发生" detail="时间线、证据、结果与缺项" />
+        </div>
+        <GuideConnector label="Fact / Procedure 组织成 Wiki" />
+        <GuideNode tone="card" icon={<GitBranch size={17} />} label="Wiki Fact / Wiki Way" title="知识组织页" detail="按 Object / Object＋Action 组织" />
       </div>
 
       <div className="attributionGuideRelations" aria-label="补充关系">
-        <span><Database size={13} /> Document 永远是证据来源</span>
-        <span><GitBranch size={13} /> Event 可以被 WikiCard 作为案例引用</span>
-        <span><Search size={13} /> Knowledge 才进入通用召回</span>
+        <span><Database size={13} /> Source Raw 永远是证据来源</span>
+        <span><GitBranch size={13} /> 两类内容共用轴归一，身份与判重各自独立</span>
+        <span><Search size={13} /> Case 经独立提炼产生候选 Procedure</span>
       </div>
     </section>
 
     <section className="attributionGuideSection" aria-labelledby="attribution-event-example-title">
       <div className="attributionGuideSectionHead">
         <p className="attributionGuideKicker">举个例子</p>
-        <h3 id="attribution-event-example-title">GMV 下降 20%：Event 记录的是“这一次”</h3>
+        <h3 id="attribution-event-example-title">GMV 下降 20%：Case 记录的是“这一次”</h3>
         <p>
           同一个问题域可以发生很多次排查。每次排查的具体结果可能不同，所以不能把一次结果直接当成永久知识。
         </p>
@@ -66,7 +68,7 @@ export function AttributionEventGuide(): ReactNode {
           <span className="attributionGuideLabel">primary coordinate</span>
           <code>GMV × 排查 × 数据异常</code>
         </div>
-        <p>这条坐标说明“正在处理哪类问题”；它不是 Event 的身份。</p>
+        <p>这条坐标说明“正在处理哪类问题”；它不是 Case 的身份。</p>
       </div>
 
       <ol className="attributionEventTrace">
@@ -79,24 +81,24 @@ export function AttributionEventGuide(): ReactNode {
 
     <section className="attributionGuideSection" aria-labelledby="attribution-event-fields-title">
       <div className="attributionGuideSectionHead">
-        <p className="attributionGuideKicker">Event 的最小结构</p>
-        <h3 id="attribution-event-fields-title">身份、上下文、动作和结果要分开</h3>
-        <p>这样 Agent 才能回放一次排查，也能判断哪些内容值得升级为通用 Knowledge。</p>
+        <p className="attributionGuideKicker">Case 的最小结构</p>
+        <h3 id="attribution-event-fields-title">身份、坐标、经过和出处要分开</h3>
+        <p>Case 信息不完整时先保存已知事实并标出缺项，不补猜；后续文档可以补充同一事件。</p>
       </div>
 
       <div className="attributionGuideFields">
-        <FieldRow name="identity" value="event_id / trace_id / sequence" description="标识是哪一次排查、在轨迹中的第几步。" />
-        <FieldRow name="context" value="primary_coordinate" description="继承 Object × Action × Scene，帮助定位，但不承担唯一身份。" />
-        <FieldRow name="action" value="event_type + target" description="发生了什么动作，例如观察现象、执行检查点、确认根因。" />
-        <FieldRow name="evidence" value="source_ref + knowledge_ref" description="这一步依据了哪份 Document、哪条 Knowledge 或哪个资产。" />
-        <FieldRow name="outcome" value="result + confidence" description="动作得到什么结果，以及结果是否足以支持结论。" />
+        <FieldRow name="identity" value="external_id / 强组合 / 来源内 ID" description="稳定外部 ID 优先；否则需要精确时间、完整坐标和现象；不足时只在本来源内保留。" />
+        <FieldRow name="coordinate" value="Object × Action × Scene" description="Case 和 Knowledge 共用同一轴注册表；不唯一时不绑定猜测的 ID。" />
+        <FieldRow name="timeline" value="observation / check / action / result" description="按原文记录观察、检查、动作与结果；一个事件可含多个时间线节点。" />
+        <FieldRow name="evidence" value="source_ref + quote" description="每个事件和时间线节点尽量附原文引文；落库前由本地核验。" />
+        <FieldRow name="missing" value="missing[]" description="没有时间、现象、根因或结果时显式标出，后续再补。" />
       </div>
     </section>
 
     <section className="attributionGuideSection" aria-labelledby="attribution-event-boundary-title">
       <div className="attributionGuideSectionHead">
         <p className="attributionGuideKicker">边界</p>
-        <h3 id="attribution-event-boundary-title">Event、Knowledge、WikiCard 不是同一层的三个名字</h3>
+        <h3 id="attribution-event-boundary-title">Fact、Procedure、Case 属于 Knowledge 层，Wiki 是组织视图</h3>
       </div>
 
       <table className="attributionGuideTable">
@@ -104,10 +106,10 @@ export function AttributionEventGuide(): ReactNode {
           <tr><th>对象</th><th>它回答什么</th><th>适合保存什么</th><th>是否直接等于坐标</th></tr>
         </thead>
         <tbody>
-          <tr><th><FileText size={14} /> Document</th><td>原话和证据在哪里？</td><td>原始复盘、工单、日志、文档</td><td>不是</td></tr>
-          <tr><th><CircleDot size={14} /> Event</th><td>这一次到底发生了什么？</td><td>有顺序的观察、动作、结果、结论</td><td>有上下文，但不是</td></tr>
+          <tr><th><FileText size={14} /> Source Raw</th><td>原话和证据在哪里？</td><td>原始复盘、工单、日志、文档</td><td>不是</td></tr>
+          <tr><th><CircleDot size={14} /> Case</th><td>这一次到底发生了什么？</td><td>有顺序的观察、动作、结果、结论</td><td>有上下文，但不是</td></tr>
           <tr><th><Lightbulb size={14} /> Knowledge</th><td>以后遇到类似问题，什么判断可复用？</td><td>事实、规则、检查点、操作方法</td><td>不是</td></tr>
-          <tr><th><GitBranch size={14} /> WikiCard</th><td>人和 Agent 从哪里找到并阅读它？</td><td>一个坐标下组织好的问题解决页面</td><td>由坐标定位</td></tr>
+          <tr><th><GitBranch size={14} /> Wiki Fact / Wiki Way</th><td>人和 Agent 从哪里找到并阅读它？</td><td>一个坐标下组织好的问题解决页面</td><td>由坐标定位</td></tr>
         </tbody>
       </table>
     </section>
@@ -116,12 +118,12 @@ export function AttributionEventGuide(): ReactNode {
       <div className="attributionGuideClosingIcon" aria-hidden="true"><CheckCheck size={18} /></div>
       <div>
         <p className="attributionGuideKicker">和记忆模型的关系</p>
-        <h3 id="attribution-event-memory-title">Event 是情节记忆，Knowledge 是语义与操作记忆</h3>
+        <h3 id="attribution-event-memory-title">Case 记录经历，Procedure 复用有证据的方法</h3>
         <p>
-          Event 保留“我在什么上下文里走过哪条路径”；Knowledge 把多次 Event 中稳定的判断和步骤提炼出来。
-          未来的 Agent 先用坐标找到 WikiCard，再用 Knowledge 规划下一步；需要复盘或解释“为什么”时，再回看相关 Event 和 Document。
+          Case 的检查、动作与结果可以支持 Procedure；只有结论不能反推方法。单次根因也不能成为当前问题的默认根因。
+          Agent 按坐标找到 Wiki Fact / Wiki Way 后，可以读取可复用 Knowledge，并用 `get_knowledge_cases` 沿卡片引用查看历史 Case；Case 可补全后续复盘文档。
         </p>
-        <p className="attributionGuideClosingRule"><strong>一句话：</strong>坐标负责找方向，Event 负责记经过，Knowledge 负责可复用，WikiCard 负责呈现。</p>
+        <p className="attributionGuideClosingRule"><strong>一句话：</strong>Source Raw → Knowledge（Fact、Procedure、Case）→ Wiki Fact / Wiki Way；按二级标题检索，交付完整 Wiki。</p>
       </div>
     </section>
   </article>