dsh-data-domain-knowledge 0.1.0-alpha.2 → 0.1.0-alpha.3

package/src/client/architecture.tsx

@@ -12,7 +12,7 @@
 
 import {
   BarChart3, Box, BrainCircuit, ClipboardCheck, Clock3, Database, FileCode2, FileText,
-  Gauge, GitBranch, HardDrive, Layers3, MessageCircle, RefreshCw, Search, Share2,
+  Gauge, GitBranch, HardDrive, Layers3, MessageCircle, PenTool, RefreshCw, Search, Share2,
   Table2, UserRound,
 } from '@tita-data-agent/ui/icons'
 import type { LucideIcon } from '@tita-data-agent/ui/icons'
@@ -42,6 +42,23 @@ export type PanelTab = 'overview' | 'intent' | 'knowledge' | 'attribution' | 'me
  */
 export type KnowledgeTab = 'source-raw' | 'wiki' | 'graph' | 'recall'
 
+/**
+ * 「回答 / 数据工具」这个节点能打开的**工作区页面**。
+ *
+ * 三个 kind 各由一个别的插件注册（`dsh-data-table` / `dsh-data-notebook` /
+ * `dsh-data-excalidraw`）—— 这里只写 kind 字符串，不 import 它们的代码，所以某个
+ * 插件没装时按钮依然在，宿主会就着这个 kind 显示「没有页面类型能打开它」。
+ *
+ * 联合写在一处：`NodeLogicPanel` 用它画按钮、`KnowledgePanel` 转发它、客户端入口
+ * 把它交给宿主的 `openTab`。三处各写一份，迟早出现「面板多了一个按钮，入口的类型
+ * 还不认它」——加画布这次就正好会踩到。
+ *
+ * 「回答 / 数据工具」的输出产物就是这三样：可编辑表格、可复现 Notebook、可编辑画布。
+ * 画布是 2026-09-26 补上的第四个出口：Excalidraw 画布已经在宿主里跑着，而这张架构图
+ * 上原先只列了 Table 与 Notebook，读起来像是「Agent 出不了图」。
+ */
+export type WorkspaceTabKind = 'data-sheet' | 'data-notebook' | 'data-excalidraw'
+
 /**
  * 五个分栏的顺序、名字与图标。**定义在这里而不是在 `KnowledgeBaseTab` 里**：
  * 渲染它的地方有两个 —— 面板外壳顶部那一条分栏 tab，和知识库内容本身。
@@ -83,7 +100,7 @@ export const NODE_LANES: LaneMeta[] = [
 ]
 
 export type NodeId =
-  | 'conversation' | 'intent' | 'runtime' | 'answer' | 'data-sheet' | 'data-notebook'
+  | 'conversation' | 'intent' | 'runtime' | 'answer' | 'data-sheet' | 'data-notebook' | 'data-canvas'
   | 'source-raw' | 'compile' | 'build' | 'recall' | 'context'
   | 'interaction' | 'episodic-memory' | 'procedural-memory' | 'memory-quality' | 'daily-update' | 'funded-value'
 
@@ -103,9 +120,12 @@ export const NODE_STATUS_LABEL: Record<NodeStatus, string> = {
 }
 
 /**
- * 卡片上的状态文字。**只有「宿主提供」需要缩短** —— 它是四个字，而卡片右侧那点宽度
- * 是从标题里借的：省下两个字，`记忆整理与质量检查` 这种九字标题才放得下。
- * 面板、无障碍列表和状态记录读的仍是完整措辞，缩的只是图上那一处。
+ * 带名条上的状态文字（`A 宿主 5 · 部分实现 1 · …`）。**只有「宿主提供」需要缩短** ——
+ * 它是四个字，而带名条右侧那条计数是十几个字挤在一行里。
+ * 面板、卡片悬停与无障碍列表读的仍是完整措辞，缩的只是带名条那一处。
+ *
+ * 它原来还负责卡片右上角那枚状态字；2026-09-26 那枚撤掉了（同时出现十六次，
+ * 把每张卡的标题都挤窄），卡片上的状态现在只在悬停的 `title` 里。
  */
 export const NODE_STATUS_SHORT: Record<NodeStatus, string> = {
   ...NODE_STATUS_LABEL,
@@ -113,25 +133,17 @@ export const NODE_STATUS_SHORT: Record<NodeStatus, string> = {
 }
 
 /**
- * 状态色：**四档只用三种颜色，而且只在文字上**。
- *
- * 「已实现」是常态，所以它拿绿（`--tita-success`，白底 5.7:1）；「部分实现」是唯一需要
- * 人动手的一档，拿琥珀（`--tita-warning`，5.4:1）；「待实现」和「宿主提供」都不是我们的
- * 进度，拿两级灰：文字分两级（faint / muted），圆点合并成 faint 一档 —— 共享词表里只有
- * 三级墨色，而这两档圆点本来就只差一格，区分它们的是文字。
- * 四档不各配一个背景色药丸 —— 那样四张卡片并排时，颜色比标题还响。
+ * 状态色表**已删除**（2026-09-26），连同它最后一个消费者。
  *
- * `fill` 仍然保留，但它只用在**需要一整块底**的地方（例如图例上的小色块）；
- * 卡片上的状态是「一个小圆点 + 状态文字」，不是一块色底。
+ * 它服务的是卡片右上角那枚「小圆点 + 状态字」。那枚撤掉之后，画布上唯一的状态读数
+ * 是问题域带名条里一行灰字计数（`A 宿主 5 · 部分实现 1 · …`）—— 计数不分色。
+ * 也就是说四档状态在画布上不再有「颜色」这个说法，留下一张 `fill/text/dot` 的表
+ * 只会让人以为某处还在按它上色。
  *
- * 这些值进的是 G6 **HTML 节点**的 innerHTML，也就是真实 DOM，所以可以用共享令牌。
+ * 状态**照旧要如实标注**，只是改由这三处承担：带名条的逐带计数、点开节点后浮层标题
+ * 旁的 `Badge`（`NodeLogicPanel` 的 `STATUS_BADGE`）、以及卡片悬停 `title` 与无障碍
+ * 列表里的 `statusNote` 依据。
  */
-export const NODE_STATUS_TONE: Record<NodeStatus, { fill: string; text: string; dot: string }> = {
-  live: { fill: 'var(--tita-tone-green-tint)', text: 'var(--tita-success)', dot: 'var(--tita-success)' },
-  partial: { fill: 'var(--tita-tone-amber-tint)', text: 'var(--tita-warning)', dot: 'var(--tita-warning)' },
-  planned: { fill: 'var(--tita-surface-muted)', text: 'var(--tita-ink-faint)', dot: 'var(--tita-ink-faint)' },
-  host: { fill: 'var(--tita-surface-muted)', text: 'var(--tita-ink-muted)', dot: 'var(--tita-ink-faint)' },
-}
 
 /** 一个执行步骤。/  `state` 决定面板里显示对勾、半勾还是空心圈。 */
 export interface NodeStep {
@@ -145,6 +157,10 @@ export interface NodeMeta {
   /**
    * 卡片上的短名。只给放不进 180px 卡片的标题用 —— 卡片是示意图，它旁边还站着
    * 十来个同宽的字；面板里写的始终是完整名字，卡片的 `title` 悬停也给出完整名字。
+   *
+   * 右上角那枚状态字撤掉之后（2026-09-26），卡片的标题行确实空出了一截。这里**没有**
+   * 因此把短名换回全名：短名当初是按「180px 里读得顺」挑的，不只是为了躲开那枚状态字，
+   * 而且面板与悬停里全名一直都在。哪条短名读起来不如全名，单独改那一条即可。
    */
   shortTitle?: string
   subtitle: string
@@ -204,13 +220,13 @@ icon: Box, lane: 'interaction',
   },
   answer: {
     title: '回答 / 数据工具', subtitle: '生成结果、可视化与方案',
-    detail: '输出解释、引用和数据结果，并把结构化结果继续交给 Table 或 Notebook 处理。',
-    input: '模型回答 + 工具返回值', output: '可读回答、可编辑表格、可复现 Notebook',
+    detail: '输出解释、引用和数据结果，并把结构化结果继续交给 Table、Notebook 或画布处理。',
+    input: '模型回答 + 工具返回值', output: '可读回答、可编辑表格、可复现 Notebook、可编辑画布',
     steps: [
       { label: '回答与引用', detail: '每一条结论都能指回 wiki 与 SourceRaw', state: 'done' },
-      { label: '转交数据工具', detail: '结构化结果可继续在 Table / Notebook 里加工', state: 'done' },
+      { label: '转交数据工具', detail: '结构化结果可继续在 Table / Notebook / 画布里加工', state: 'done' },
     ],
-    status: 'host', statusNote: '回答渲染与 Table / Notebook 由宿主工作区提供。',
+    status: 'host', statusNote: '回答渲染与 Table / Notebook / 画布由宿主工作区提供。',
 icon: BarChart3, lane: 'interaction',
   },
   'data-sheet': {
@@ -229,6 +245,14 @@ icon: Table2, lane: 'interaction',
     status: 'host', statusNote: '属于 `dsh-data-notebook` 插件，这里只画调用关系。',
 icon: FileCode2, lane: 'interaction',
   },
+  'data-canvas': {
+    title: '画布', subtitle: '生成 / 编辑 Excalidraw 画布',
+    detail: '把结构化结果画成一张可继续手工编辑的画布：架构草图、流程、方案对比。它是「输出产物」里唯一能被人接着改的那一种。',
+    input: '结构化结果 / 画布指令', output: '可编辑的画布文件与导出图',
+    steps: [{ label: '打开画布面板', detail: '由宿主的 Excalidraw 插件承载', state: 'done' }],
+    status: 'host', statusNote: '属于 `dsh-data-excalidraw` 插件，这里只画调用关系。',
+icon: PenTool, lane: 'interaction',
+  },
 
   'source-raw': {
     title: 'SourceRaw', subtitle: '原始可追溯文档',
@@ -391,11 +415,12 @@ export interface KnowledgeStats {
     cardsRemoved?: number
     notesReused?: number
     notesRecompiled?: number
-    /** Pass 0 · 候选抽取 + 归一的诚实计数（0028）。 */
+    /** Pass 0 · 候选抽取 + 归一的诚实计数（0028 / v1.5）。 */
     candidatesExtracted?: number
     candidatesRejected?: number
-    cardsCreated?: number
-    cardsMerged?: number
+    /** v1.5：Pass 0 只提议，不落卡 —— 这两个计数数的是**提议**（原名 cardsCreated / cardsMerged）。 */
+    proposalsCreated?: number
+    proposalsMerged?: number
     relationsExtracted?: number
     relationsDropped?: number
     sourcesExtracted?: number
@@ -504,7 +529,7 @@ export function metricsByNode(stats: KnowledgeStats, version: number): Partial<R
 
 /** 节点在图上出现的顺序：按链路，再按链内阅读顺序。它就是键盘可达列表的顺序。 */
 export const NODE_ORDER: NodeId[] = [
-  'conversation', 'intent', 'runtime', 'answer', 'data-sheet', 'data-notebook',
+  'conversation', 'intent', 'runtime', 'answer', 'data-sheet', 'data-notebook', 'data-canvas',
   'source-raw', 'compile', 'build', 'recall', 'context',
   'interaction', 'episodic-memory', 'procedural-memory', 'memory-quality', 'daily-update', 'funded-value',
 ]