支持方式

File Viewer 是一个开源项目，适合通过 GitHub issue 讨论公开问题、复现样例和改进建议。

推荐求助路径

使用问题: 先看文档和 FAQ
在线验证: 使用 Demo 上传脱敏文件或打开示例文件
Bug / 兼容性问题: 提交 GitHub issue，并尽量附上复现信息
新格式 / 新框架支持: 提交 feature request，说明业务场景和优先级
私有化部署: 说明部署方式、静态资源路径、CSP、浏览器环境和失败资源

提 issue 前请准备

文件类型和文件来源
浏览器、操作系统、移动端 WebView 信息
使用的包名和版本
接入方式: Vue / React / Web Component / script 标签 / jQuery / Svelte
是否使用 @file-viewer/*-full、preset 或独立 renderer
控制台错误、网络失败资源、截图或最小复现

样本文件安全

不要上传含有隐私、商业合同、客户资料、身份证件、内部系统截图或其他敏感信息的文件。可以上传脱敏样本，或只描述文件来源、生成工具、结构特征和失败现象。