用户界面：入门与反馈

OneDocs 的用户界面围绕“选择功能—上传文档—启动分析—查看结果—保存或导出”的主流程设计，并通过存档、发现、关于和设置页面补充历史管理、版本信息、帮助教程与运行配置。

目的与范围

本文介绍 OneDocs 面向用户的界面结构、首次使用路径以及结果反馈方式，帮助用户理解各页面之间的关系并完成一次完整的文档分析。内容覆盖顶部导航栏、分析页面、设置页面、存档页面、发现页面和关于页面；其中重点说明分析页面的三栏布局、结果展示方式，以及关于页面中的帮助教程。

本文不展开 AI 模型调用、文档解析、RAG 检索或具体分析算法的内部实现；这些属于后端处理和模型配置等独立主题。模型供应商、API Key、Base URL 和模型选择只在本文中作为设置页面的用户入口进行说明。

概览

OneDocs 的界面由顶部导航栏和多个功能页面组成。导航栏提供分析、存档、发现、关于和设置五个主要入口，右侧提供主题与语言切换。这样的组织方式将高频任务与辅助任务分开：分析页面承载核心工作流，存档页面用于回看历史结果，发现页面用于了解版本变化，关于页面提供项目说明与新手教程，设置页面用于调整模型、外观和通用行为。

首次使用时，建议先在“设置”中确认语言、主题及模型相关配置，然后进入“分析”页面选择分析模式并上传 PDF。分析完成后，结果会显示在右侧区域，并可在渲染视图与源码视图之间切换；需要保留或再次查看时，可使用复制、导出或存档相关功能。

页面架构

从用户任务角度看，界面可以分为三层：

1. 全局导航层：顶部导航栏、主题切换和语言切换始终承担页面间的入口职责。
2. 任务执行层：分析页面的左侧功能选择栏、中间文件上传区和右侧结果展示区共同完成一次分析。
3. 辅助与管理层：设置负责运行偏好和模型参数，存档负责历史结果，发现和关于负责版本信息、项目介绍与帮助内容。

导航入口

右侧的主题切换支持浅色、深色和跟随系统三种模式；语言切换支持中文和 English。语言与主题属于全局界面偏好，不是单次分析的参数。

入门流程

第一步：确认界面偏好

进入“设置”页面的“通用”标签，可切换界面语言，并确认分析相关开关。界面也提供独立的外观配置入口，用于设置主题、字体风格、字号大小、背景颜色和背景图片。

如果用户需要持久化分析数据，还应在“通用”标签中检查数据目录配置。该页面同时提供 RAG 嵌入模型配置入口，可填写 SiliconFlow Token。开发者模式需要手动开启，普通使用场景不需要默认启用。

第二步：配置模型

在“设置”的“模型”标签中选择 AI 模型供应商，填写相应 API Key，并按需设置 Base URL。随后选择具体模型；如果内置列表中没有所需模型，可通过自定义模型入口添加。

模型配置是分析功能的前置条件。本文只描述用户可见的配置项，不推断各供应商的鉴权、网络请求或模型能力差异。

第三步：选择分析功能

进入“分析”页面后，左侧功能选择栏提供四种分析模式：

• 要闻概览
• 罗森析数
• 理工速知
• 文采丰呈

用户选择其中一种模式后，再点击“开始析文”启动分析。模式选择与启动操作位于同一侧栏，使用户能够在上传文件前明确分析意图，也便于在执行前检查当前选择。

第四步：上传并整理 PDF

中间文件上传区支持点击选择或拖拽上传 PDF 文件。上传后，文件会显示在列表中；如果有多个文件，可以通过拖拽调整顺序。文件列表和排序能力使输入顺序成为用户可见、可控制的步骤，尤其适合需要按章节或材料顺序处理的场景。

第五步：启动分析并观察结果

确认分析模式和文件列表后，点击左侧的“开始析文”。分析完成后，右侧结果展示区显示结果。结果区支持渲染视图与源码视图两种查看方式：渲染视图适合直接阅读，源码视图适合检查原始内容或进行进一步复制处理。

结果区还提供复制和导出功能，用于将分析结果带出当前页面。若需要日后再次访问，应结合存档页面查看历史记录。

分析页面的交互结构

分析页面采用三栏布局，每一栏承担明确且互相衔接的职责：

左侧：功能选择栏

左侧区域包含四种分析模式按钮和“开始析文”按钮。模式按钮决定当前任务采用的分析功能；启动按钮则将当前模式和当前文件列表提交给分析流程。

这一布局将“配置任务”和“执行任务”放在同一个区域，降低用户在上传文件后寻找启动入口的成本。使用时应先确认选中的模式，再启动分析，避免以错误模式处理文档。

中间：文件上传区

中间区域是输入材料的管理区，支持点击或拖拽上传 PDF，并展示已上传文件列表。多文件场景下，用户可以拖拽调整顺序；因此，文件列表不仅是状态展示，也是分析输入的编辑界面。

右侧：结果展示区

右侧区域用于呈现分析结果。结果完成后，用户可以在渲染和源码两种模式间切换，并执行复制或导出操作。将结果放在独立的右侧区域，可以让输入文件列表与输出内容同时可见，便于用户核对当前结果对应的输入。

反馈与结果确认

OneDocs 的界面反馈主要通过结果展示、视图切换、复制和导出体现：

1. 文件上传区反馈当前已上传的文件集合。
2. 文件列表的顺序变化反馈用户的拖拽排序操作。
3. 结果展示区反馈分析完成后的内容。
4. 渲染视图反馈面向阅读的最终呈现。
5. 源码视图反馈结果的原始文本形态。
6. 复制和导出反馈结果的可复用性，使用户不必停留在当前页面完成后续工作。

在结果为空或分析尚未完成时，本文提供的界面资料没有给出更细的加载状态、错误提示文案或重试规则。因此，不能据此推断具体的失败提示、进度百分比或自动重试行为。

存档、发现与关于页面

存档页面

存档页面采用左右两栏布局：左侧是历史分析记录列表，显示时间和文件数量；右侧显示选中存档的分析结果，并继续支持渲染与源码查看。

典型使用路径是先在左侧按记录定位目标任务，再在右侧查看结果。该页面适合复核过去的分析，而不是替代分析页面创建新任务。

发现页面

发现页面用于展示 OneDocs 的版本更新记录，同样采用左右分栏：左侧为版本列表，右侧为选中版本的更新说明。用户可以通过该页面了解版本变化，而无需离开应用寻找发布信息。

关于页面

关于页面包含四个标签：

对于首次使用者，“帮助”标签是最直接的入门反馈入口；“功能”标签用于理解四种分析模式的定位；“版本”标签则提供项目身份和相关链接信息。

设置页面

通用设置

通用标签包括：

• 语言设置：中文或 English。
• 分析设置：格式复查开关和自动保存开关。
• 数据管理：数据目录配置。
• RAG 嵌入模型配置：SiliconFlow Token 配置。
• 开发者模式：需要手动开启。

格式复查与自动保存属于分析行为相关开关；数据目录决定数据管理入口；RAG 嵌入模型配置则为相关检索能力提供用户可见的凭据入口。源材料没有说明这些选项的默认值、保存时机或校验规则，因此不应把它们解释为已验证的默认行为。

外观设置

外观标签支持：

• 浅色、深色或跟随系统的主题模式。
• 字体风格选择。
• 字号大小调整。
• 背景颜色自定义。
• 背景图片上传。

这些选项影响界面呈现，不改变分析模式或上传内容。

模型设置

模型标签支持：

• 供应商选择。
• API Key 填写。
• Base URL 自定义。
• 具体模型选择。
• 自定义模型添加。

其中 Base URL 是可选的自定义地址入口；自定义模型用于补充供应商未内置的模型。源材料没有提供具体供应商列表、模型名称、字段校验规则或密钥存储方式，因此这些实现细节无法从现有资料确认。

典型使用场景

单个 PDF 的快速分析

1. 在设置中确认模型配置。
2. 返回分析页面。
3. 选择四种分析模式之一。
4. 点击上传区并选择 PDF，或将 PDF 拖入上传区。
5. 检查文件列表。
6. 点击“开始析文”。
7. 在右侧结果区阅读渲染结果。
8. 必要时切换到源码视图，并复制或导出结果。

多个 PDF 的顺序化分析

1. 上传多个 PDF。
2. 在中间文件列表中确认全部文件均已显示。
3. 通过拖拽调整文件顺序。
4. 选择分析模式。
5. 启动分析并在右侧查看结果。

该流程的关键是先调整输入顺序，再启动任务；启动后再排序的行为和影响，现有资料没有说明。

回看历史结果

1. 打开存档页面。
2. 在左侧历史记录中根据时间和文件数量定位记录。
3. 选择记录。
4. 在右侧查看结果。
5. 在渲染视图和源码视图之间切换。

界面边界与已知限制

根据现有界面说明，可以确认以下能力：

• 输入文件类型为 PDF。
• 支持点击和拖拽上传。
• 支持多个文件列表及拖拽排序。
• 支持四种分析模式。
• 支持结果渲染、源码查看、复制和导出。
• 支持历史存档查看。
• 支持中文和 English。
• 支持浅色、深色和跟随系统主题。

以下细节在现有资料中没有定义：

• PDF 大小、数量和页数限制。
• 上传失败、格式错误或网络错误时的具体提示。
• 分析过程中的进度显示、取消操作和重试策略。
• 复制与导出的目标格式和文件命名规则。
• 自动保存的触发时机及存档保留策略。
• 模型配置的密钥加密、校验和错误处理方式。
• 语言或外观设置是否需要重启应用。

这些内容应以实际实现或产品行为为准，不能仅从页面布局说明中推导。

操作建议

• 首次使用先完成模型配置，再进入分析页面。
• 开始分析前同时检查分析模式和文件顺序。
• 多文件任务应在启动前完成拖拽排序。
• 需要精确复制内容时优先查看源码视图；需要阅读时优先使用渲染视图。
• 重要结果应使用复制、导出或存档功能保留。
• 需要了解功能定位时查看关于页面的“功能”标签，需要完整上手步骤时查看“帮助”标签。
• 遇到界面显示问题时，可先检查主题、字体、字号、背景颜色和背景图片等外观设置。

相关页面

• 分析：创建新任务、上传 PDF、选择分析模式并查看结果。
• 存档：查看历史分析记录和已保存结果。
• 发现：查看版本更新记录。
• 关于：查看版本信息、项目简介、四大功能说明和新手帮助。
• 设置：管理语言、分析开关、数据目录、外观和模型配置。