refactor: extract chat history pane and clarify knowledge ownership
This commit is contained in:
mesalogo
@@ -50,7 +50,7 @@ reading 与知识库 master-detail 壳层，KnowledgeWorkspace 不再嵌套壳
|
||||
| 应用中心 → 本机推理监控 | [应用定义](../../../src/renderer/src/ApplicationCenter.tsx)仍为四项；[监控](../../../src/renderer/src/LocalInferencePage.tsx)显示本地服务并加载/释放 OCR | 不承担远程 OCR 配置或管理；关闭监控入口不等于关闭解析能力 |
|
||||
| 监控 → 模型与连接设置 | [IPC](../../../src/main/ipc.ts)的 `localInferenceOpenSettings` 只发出无分类的 `settingsOpen`；[App](../../../src/renderer/src/App.tsx)仅打开设置，[SettingsPanel](../../../src/renderer/src/SettingsPanel.tsx)默认分类为 `runtime` | 文案与默认落点不一致，未直达模型或文档解析；本轮仅记录，产品跳转未修复 |
|
||||
| 聊天附件 | App 的附件按钮直接选文件；当前卡片显示名称、容量、缩略图或图标、文本 tooltip 和移除 | 尚无逐附件更多菜单、显式 OCR、解析结果预览、重解析或文档选图 |
|
||||
| 知识库文档 | [DocumentsView](../../../src/renderer/src/KnowledgeWorkspace.tsx)提供任务、打开来源、失败文档重试和分块管理；来源行另有同步，库页头另有“用于当前对话” | 解析文档详情、成功文档重解析及选图须新增，不能把分块管理 Modal 当作已有完整解析预览 |
|
||||
| 知识库文档 | 当时位于 `KnowledgeWorkspace.tsx` 的 DocumentsView 提供任务、打开来源、失败文档重试和分块管理；来源行另有同步，库页头另有“用于当前对话” | 解析文档详情、成功文档重解析及选图须新增，不能把分块管理 Modal 当作已有完整解析预览 |
|
||||
| 新建选图目标会话 | App 的 `startNewConversation` 返回布尔值，拒绝消息通道项目，并在复用空会话或新建后切到聊天 | 预览保留、目标 ID 取得及返回确认仍需接线；直接调用不满足 US-I9 |
|
||||
|
||||
本轮更正文档中“既有文档详情”的描述，补齐菜单矩阵及 US-H16 / A-15；队列修改统一先
|
||||
@@ -58,6 +58,12 @@ reading 与知识库 master-detail 壳层，KnowledgeWorkspace 不再嵌套壳
|
||||
同步标明本轮范围；本地 OCR 仍为现有能力，HTTP 和新附件流程仍为规划。
|
||||
未修改产品代码、探索脚本或既有应用排序，OCR、文本及视觉模型调用均为 0。
|
||||
|
||||
2026-09-27 模块归属复核：上述表格保留实施前状态。当前
|
||||
[DocumentsView](../../../src/renderer/src/knowledge-workspace/DocumentsView.tsx)
|
||||
已从工作区入口拆出，提供解析预览、返回列表、重新解析及预览内选图；工作区入口保留库选择、
|
||||
检索与分块管理。文档与来源统一列表的行为及验证见
|
||||
[知识库进度](../knowledge-base/progress.md#2026-09-27-文档与来源统一列表)。
|
||||
|
||||
## 2026-09-19 实现与验证
|
||||
|
||||
HTTP PaddleOCR-VL 已接入 `DocumentParsingService` 的生产 PDF/PPTX 路径，设置支持来源切换、
|
||||
|
||||
@@ -6,15 +6,15 @@
|
||||
|
||||
## 1. 容器与共享组件
|
||||
|
||||
遵循根目录 [UI 设计系统](../../../UI-DESIGN.md)，保留当前应用容器结构。下表依据
|
||||
2026-09-18 源码核对，标为新增的内容需要实现，不能当作现有 API。
|
||||
遵循根目录 [UI 设计系统](../../../UI-DESIGN.md)，保留当前应用容器结构。下表的知识库
|
||||
模块归属已于 2026-09-27 复核；各入口的实现与验证状态见[进度](./progress.md)。
|
||||
|
||||
| 位置 | 现有结构及设计用法 |
|
||||
| --- | --- |
|
||||
| 设置中心 | `SettingsPanel.tsx` 整窗 Modal 内的 `DocumentParsingSettingsSection.tsx`；继续使用 `SettingsCategoryHeader`、`settings-section`、`field`，不套第二个 PageShell 或一级标题 |
|
||||
| 聊天 | `App.tsx` 的 `PageShell variant="reading"`；附件卡位于原 Composer 内，待发送队列仍在 Composer 外，不在助手工作栏增加附件栏目 |
|
||||
| 知识库 | `App.tsx` 已提供 `PageShell variant="master-detail"`，`KnowledgeWorkspace.tsx` 内含库导航与 DocumentsView；需在文档区域新增解析详情及返回列表，不再嵌套页面壳层或新建知识库级页签 |
|
||||
| 解析预览 | 新增共享内容视图，分别嵌入设置诊断 Modal、聊天附件 Modal 和知识库文档详情；共享数据和交互，外层容器负责标题、范围、关闭与滚动 |
|
||||
| 知识库 | `App.tsx` 提供 `PageShell variant="master-detail"`，`KnowledgeWorkspace.tsx` 保留库导航并挂载 `knowledge-workspace/DocumentsView.tsx`；文档区域内切换解析详情与列表，不嵌套页面壳层或新建知识库级页签 |
|
||||
| 解析预览 | `DocumentResultPreview.tsx` 分别嵌入设置诊断 Modal、聊天附件 Modal 和知识库文档详情；共享数据和交互，外层容器负责标题、范围、关闭与滚动 |
|
||||
| 页签与选择 | `WorkspacePrimitives.tsx` 的 `PageTabs variant="segmented"` 承载正文、图片、详情；来源及过滤模式使用 `SegmentedControl`，不能用它替换页签语义 |
|
||||
| 浮层 | Modal 沿用 body Portal、`activateModalFocus` 与 `trapTabFocus`；测试及附件菜单复用 `AnchoredMenu`，由共享 `FloatingPortal` 挂入所属 Modal 并在 top layer 绘制。通知遵循根 UI 规范 |
|
||||
| 图文内容 | 复用 `MarkdownRenderer.tsx` 的排版、表格滚动和静态 HTML 处理边界；补齐受管图片与 OCR HTML 表格适配，现有 Markdown 渲染器并未直接支持这些资源 |
|
||||
@@ -36,8 +36,8 @@
|
||||
| 管理本地 OCR 文件 | 同一“文档解析”分类的本地模型区 | 下载、校验、ZIP、删除和目录操作；全局模型下载源仍在“平台功能 / 通用设置”，与 OCR 来源选择分开 |
|
||||
| 查看或释放本地 OCR 内存 | “应用中心” → “本机推理监控”（`local-inference` Modal），或其常驻入口 | 只管理本机执行服务；应用启用及常驻控制入口，不控制解析功能；HTTP 服务不出现在本机服务列表，也不提供远程启停 |
|
||||
| 添加文件或图片 | “当前对话” → “添加附件”，或输入框粘贴 | 先加入当前草稿，再按输入类型处理；上传按钮继续直接选文件，不改成先选 OCR 的菜单 |
|
||||
| 查看聊天解析结果 | 草稿或历史消息的附件卡 | 规划中的共享预览；来源消息与目标草稿分别显示，历史输入只读 |
|
||||
| 查看知识文档结果 | “知识库” → 选库 → “文档与来源”中的文档操作 | 规划新增“查看解析结果”和文档详情；返回恢复库、列表筛选和位置；不改变活动会话 |
|
||||
| 查看聊天解析结果 | 草稿或历史消息的附件卡 | 打开共享预览；来源消息与目标草稿分别显示，历史输入只读 |
|
||||
| 查看知识文档结果 | “知识库” → 选库 → “文档与来源”中的文档操作 | “查看解析结果”进入文档详情；返回恢复库、列表筛选和位置；不改变活动会话 |
|
||||
| 把文档插图用于聊天 | 聊天或知识文档预览 → “图片” → “添加所选图片” | 明确目标会话草稿后复制；设置测试预览无此操作；已有“用于当前对话”仍负责知识库检索范围，不代替选图 |
|
||||
|
||||
从解析失败或未配置提示提供“前往文档解析设置”时，须直达 `document-parsing` 分类并保留
|
||||
|
||||
@@ -37,6 +37,24 @@
|
||||
| `src/renderer/src/ExternalKnowledge.tsx` | 实例 Modal、绑定表单、Provider 配置、外部详情与检索结果 |
|
||||
| `KnowledgeWorkspace.tsx`、`App.tsx`、`KnowledgeCitationDialog.tsx` | 统一列表、聊天选择、刷新及历史引用显示 |
|
||||
|
||||
Renderer 的 `KnowledgeWorkspace.tsx` 保留库选择、页签路由、检索与分块管理状态及回调。
|
||||
原有子组件位于 `src/renderer/src/knowledge-workspace/`：
|
||||
|
||||
| 文件 | 职责 |
|
||||
| --- | --- |
|
||||
| `DocumentsView.tsx` | 来源导入、文档列表与解析结果预览 |
|
||||
| `KnowledgeSettingsView.tsx` | 索引、分块及图谱配置，向量索引状态轮询 |
|
||||
| `KnowledgeTasksView.tsx` | 任务筛选、层级展示、取消和重试 |
|
||||
| `GraphView.tsx`、`GraphEditors.tsx` | 图谱浏览、实体与关系编辑 |
|
||||
| `KnowledgeGraphChartLoader.tsx` | 图谱画布延迟加载及失败重试 |
|
||||
| `LibraryDialogs.tsx`、`RemoveSourceDialog.tsx`、`GraphDestructiveDialog.tsx` | 建库表单、库编辑与删除、来源移除及图谱破坏性操作确认 |
|
||||
| `types.ts` | 工作区 Props 与组件间使用的类型 |
|
||||
| `formatting.ts`、`helpers.ts` | 多个组件共用的本地化格式化、标签、别名解析、进度和错误处理 |
|
||||
|
||||
子组件直接导入所需模块，不反向依赖工作区入口。单个视图专用的格式化与标签留在该视图，
|
||||
检索结果转换留在入口。模块拆分保留组件 Props、挂载位置、key 与副作用顺序；文档与来源
|
||||
合并后的列表结构及操作归属见 [UI 设计](./ui-design.md#6-来源操作)。
|
||||
|
||||
`ExternalKnowledge.tsx` 的字段改用全局 `.field`，修正 body Portal 脱离知识库祖先后
|
||||
丢失 scoped 控件样式的问题。CSS 提供 560px 紧凑弹窗和粘附底部操作区；实例选择复用
|
||||
既有 picker 样式并实现菜单键盘行为。没有新增 Main 模块，具体控件规则由
|
||||
|
||||
Reference in New Issue
Block a user