# 支持方式

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

## 推荐求助路径

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

## 提 issue 前请准备

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

## 样本文件安全

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