插件安装与管理——按需扩展文件预览能力

插件化架构的设计理念

Pixcall 刻意采用了核心客户端 + 插件生态的架构：

核心客户端保持精简（安装包体积小、启动快、内存占用低）
所有预览能力做成独立插件，按需安装
不想看 3D 模型的用户不用装 3D 插件，省几 MB
各插件可以独立更新，和主客户端的迭代节奏不同步
未来可能有第三方开发者贡献更多预览插件

可用插件列表

预览类插件

插件	支持格式	功能
视频播放器插件	MP4、OGG、WebM、MOV	视频逐帧预览、播放控制
GIF 播放器插件	GIF	GIF 逐帧查看、暂停到任意帧
音频播放器插件	MP3、M4A、AAC、OGG、FLAC、WAV	音频播放、进度条、音量控制
3D 模型预览插件	OBJ、STL、GLTF/GLB、3DS、PLY、FBX、Collada	3D 模型旋转、平移、缩放查看
PDF 预览插件	PDF	PDF 翻页、搜索、复制文字
DOCX 预览插件	DOCX（不支持旧版 DOC）	Word 文档渲染预览
PPTX 预览插件	PPTX（不支持旧版 PPT）	PowerPoint 幻灯片预览
EPUB 预览插件	EPUB	电子书翻页、章节导航
MHTML 预览插件	MHTML	网页快照离线预览
文本编辑器插件	TXT、CSS、JSON、JS、HTML、XML、Markdown、PHP、Java、Shell	语法高亮、行号

原生支持的（不需要插件）

格式	预览能力	说明
PSD	✅ 原生	Pixcall 自己解析 PSD
JPG / PNG / WebP / GIF / BMP / ICO / SVG	✅ 原生	图片类
HEIC / HEIF	✅ 原生	iOS 照片格式

安装插件

步骤

打开 Pixcall 桌面客户端
Pixcall 菜单 > 偏好设置 > 插件（入口位置随版本可能在其他地方）
在插件市场/列表里看到所有可用插件
点击插件旁边的"安装"按钮
等待下载和安装完成
部分插件安装后需要重启 Pixcall

批量安装

你可以逐个安装需要的插件，也可以一次性全部选中安装。通常 Pixcall 默认会推荐安装最常用的几个插件（PDF、视频、文本编辑器等）。

插件安装失败

如果插件安装失败，常见原因：

网络问题 → 重试或换网络
Pixcall 版本太旧 → 先升级 Pixcall 客户端
插件市场服务器临时不可用 → 稍后再试

插件更新

插件可能有新版本。Pixcall 通常会在插件市场里显示每个插件的当前版本号和可用更新。点击"更新"按钮即可升级。

自动更新取决于 Pixcall 版本的实现——部分版本支持自动检查并提醒，部分版本需要手动到插件市场查看。

卸载插件

在插件市场里找到已安装的插件，点击"卸载"。卸载后：

该插件提供的预览能力消失（视频不能逐帧预览、PDF 不能翻页等）
但文件本身不会被删除——它们仍然是资源库里的普通文件，只是没有了增强预览能力
卸载可以释放磁盘空间和少量内存（主客户端更精简）

插件 vs 原生支持

一个容易混淆的点：

格式	支持方式	为什么这样设计
PSD	原生	设计师高频使用，必须原生支持
JPG/PNG/WebP/GIF	原生	最基础的图片格式，原生支持
视频 / PDF / Office	插件	不是所有用户都需要，保持核心精简
3D / EPUB / MHTML	插件	小众需求，更应该插件化

结论：越基础、越通用的格式 → 越原生；越专业、越高阶的格式 → 越插件。

跨端插件支持

所有 Pixcall 预览插件只在桌面端可用：

✅ 桌面端 → 完整插件生态
❌ 移动端 → 只有基础预览能力（图片可以，3D 不行）
❌ 网页版 → 基础预览（取决于浏览器能渲染什么）

插件和安全

Pixcall 官方提供的插件经过安全审查，可以放心安装。如果出现：

某个插件安装后 Pixcall 异常（闪退、卡顿）
某个插件安装后 CPU / 内存异常占用

可以尝试：

卸载该插件后重启 Pixcall
检查插件是否为最新版本 → 更新后重试
联系 Pixcall 官方反馈问题

插件和 Mini 程序

插件的安装和卸载只影响桌面客户端主窗口，不影响 Mini 程序的同步能力。同步进程只关心文件和云端，不关心预览插件。