浏览文档与元数据

浏览知识库文档、查看分块与原文件预览，理解文档信息和只读范围

在知识库里选择一个知识库即可浏览它的文档列表：按名称搜索，按处理状态或文件类型筛选，勾选多行做批量操作。点开文档进入详情页，查看和编辑分块、预览或下载原文件。别队共享进来的知识库带来源徽章，整体只读。

文档列表

每行显示文档名称、类型、大小、分块数、处理状态与创建时间，行尾菜单提供这些操作：

操作	说明
配置 / 快速处理	仅未处理的文档：配置进入详情页调整分块参数，快速处理直接按现有设置开始处理
管理分段	进入文档详情页查看与编辑分块
重新处理	打开分段预览，确认或调整后重新分段入库；手工改过的分块会丢失
重试失败分段	仅失败的文档：只重跑失败的分段
下载原文件	下载上传时的原始文件；URL 导入的文档没有原文件
查看源网址	仅 URL 导入的文档：打开来源地址
删除	删除文档及其全部分块

顶部搜索文档按名称过滤；状态筛选（等待中/处理中/已完成/失败）与类型筛选一次只能选一项。
勾选多行后可批量处理、批量重试失败分段或批量删除。
上传后尚未配置分段的文档会在列表顶部提示，点去批量配置分段继续。
由飞书同步管理的文档带只读标记：原文请在飞书中修改，这里不支持编辑、重新处理或删除。

文档详情页

左侧是分块列表，右侧是分块设置。

分块列表显示每个分块的序号与内容，可编辑分块、新增分块、删除分块；保存时若有未提交的修改会先询问。
状态为失败时，可只对失败分段重试，不必整篇重跑。
未处理的文档可以在右侧调整分块大小（字符数）、分块重叠、自定义分隔符与清理文本，再开始处理。处理完成后再改这些设置只能走重新处理。
顶部预览原文件打开只读预览：图片直接查看；PDF 可翻页；DOCX 支持缩略图、页码与缩放；表格文件（XLSX/CSV）按工作表只读展示。超过 20MB 的文件不做在线预览，按提示下载原文件打开。
URL 导入的文档没有原文件，只能查看来源地址与分块。

预览打不开时会给出具体原因：文件过大、当前账号没有查看或下载权限、未登录、文件类型不支持或解析失败。权限或登录问题解决后重试；格式问题只能下载后本地打开。

文档信息与自动元数据

详情页顶部显示文档名称、所属知识库、文件大小、分块数与处理状态；URL 文档显示来源地址。

系统还会为每个文档和分块自动记录一组信息：文档的格式（是否已转换成 Markdown）、正文字符数、抽取出的内嵌图片，分块所属章节（例如 第一章 > 第二节）与分块类型（表格/代码/列表/正文）。这些信息只读、重新处理时整体重算，界面不提供逐字段编辑；它们会随检索结果一起返回，用于在回答里标注来源。

共享来源与只读

徽章	出现条件	含义
来自 `{团队}`	知识库属于别的团队并共享给你的团队	只读：上传、导入、编辑分块、删除与设置入口全部不可用
已共享 `{N}` 个团队	你的团队拥有该知识库，并已共享给 N 个团队	你仍可正常读写

跨团队共享、只读语义与撤销方式见创建知识库。

改名与其他限制

界面目前不提供文档重命名入口，名称只能通过 API 更新，字段说明见知识库 API。
标签、分类、目录与逐字段元数据编辑都未实现。
检索不支持按元数据过滤或加权，只能把结果限定在指定文档内；调整方式见检索与质量调优。
分块里抽出的图片没有公开链接，需要在登录状态下访问。