mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
49 lines
2.3 KiB
Markdown
49 lines
2.3 KiB
Markdown
---
|
||
id: fileview.concept
|
||
title: 文件预览（fileview）是什么
|
||
type: concept
|
||
feature: fileview
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- fileview
|
||
- 文件预览
|
||
- 在线预览
|
||
- 预览 PDF
|
||
- 预览 Word
|
||
- kkfileview
|
||
- 在线看文件
|
||
related_tools: []
|
||
related_pages: [file]
|
||
prerequisites:
|
||
- 应用市场已安装 fileview 插件
|
||
negative:
|
||
- fileview 只提供「只读预览」，不能在线编辑（编辑要装 OnlyOffice，见 [[office.concept]]）
|
||
- 主程序本身能直接预览图片（jpg/png/gif 等）和文本/代码，这些不需要 fileview
|
||
- 视频/音频在线播放走主程序自带能力，也不属于 fileview 范畴
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 文件预览（fileview）是什么
|
||
|
||
## 定义
|
||
fileview 是 DooTask 的**通用文件在线预览**能力，基于开源 kkfileview 引擎，由独立插件提供。所有不能被主程序直接渲染的文件类型（PDF、Word 系、Excel 系、PPT 系、Visio、CAD 等）在点击文件名时会跳转到 fileview 的预览页（路径 `fileview/onlinePreview?url=<base64 文件地址>`），返回浏览器内可滚动、可缩放、可翻页的页面。
|
||
|
||
## 关键属性
|
||
- **只读**：仅查看，不可编辑（编辑能力需 OnlyOffice 插件）
|
||
- **入口**：点击文件即可，主程序对超出本地预览范围的文件自动 301 到 fileview 路径
|
||
- **格式覆盖**：远超主程序自带能力，包括 Office 全家桶、PDF、各类压缩包、3D 模型、CAD 等（详见 [[fileview.supported.concept]]）
|
||
- **加载机制**：fileview 后端拉取文件 → 转码或解析 → 推送渲染结果到浏览器
|
||
- **依赖**：依赖独立 fileview 容器持续运行
|
||
|
||
## 与其他预览能力的关系
|
||
- **图片**（jpg/jpeg/png/gif/bmp 等）：主程序内置直接渲染，不走 fileview
|
||
- **代码/文本**（2MB 内、扩展名属于 `codeExt` 列表）：主程序内嵌 AceEditor 渲染，不走 fileview
|
||
- **Word/Excel/PPT**：装了 OnlyOffice 时走 OnlyOffice 编辑器（可编辑）；没装但装了 fileview 则走 fileview 只读预览
|
||
- **思维导图（mind）/ 流程图（drawio）**：DooTask 自己的图形文件，由 minder/drawio 插件渲染，不走 fileview
|
||
|
||
## 相关
|
||
- 插件元信息：[[fileview.plugin.concept]]
|
||
- 支持的文件类型：[[fileview.supported.concept]]
|
||
- 在线编辑 Office 文档：[[office.concept]]
|