附录 支持的文件格式与数据说明
本附录集中说明 AIClue 对文件记录、正文搜索、内置预览和本机数据保存的支持范围。不同能力的支持范围并不完全相同：能出现在文件列表中的文件，不一定都能读取正文或在内置查看器中预览。
A.1 文件记录范围
添加目录后，AIClue 会扫描目录中的普通文件，并记录文件名、路径、大小、时间和文件类型等信息。
以下文件可能不会进入结果，或会被跳过：
- 位于排除规则覆盖范围内的文件或目录
- 软件自身目录中的文件
- 临时下载、临时缓存或系统缓存类文件
- 无法读取、已损坏或被系统权限限制的文件
- 正在被其他程序占用，暂时无法读取的文件
如果文件能进入文件列表，通常可以按文件名、路径、目录和文件类型进行查找或筛选。是否能按正文内容搜索，取决于该文件是否支持正文读取。
A.2 文件类型分类
AIClue 会根据扩展名为文件绑定类型分类。默认分类包括：
| 分类 | 常见扩展名示例 |
|---|---|
| Word 文档 | doc, docx, wps, odt |
| 表格 | xls, xlsx, xlsm, xlsb, et, csv, ods |
| 演示文稿 | ppt, pptx, odp |
pdf | |
| 纯文本 | txt, md, markdown, rtf |
| 电子书 | epub, mobi, azw3 |
| 设计文件 | psd, ai, sketch, fig, xd, dwg, dxf |
| 思维导图 | xmind, mm, emmx, enex, opml |
| 图片 | jpg, jpeg, png, gif, bmp, webp, svg, ico, tiff, tif |
| 音频 | mp3, wav, flac, aac, ogg, wma, m4a |
| 视频 | mp4, avi, mkv, mov, wmv, flv, webm, m4v |
| 压缩包 | zip, rar, 7z, tar, gz, bz2, xz |
| 代码文件 | js, ts, jsx, tsx, vue, py, java, cpp, c, rs, go, php |
| 配置和数据文件 | json, xml, yaml, yml, toml, ini, conf, sql, sqlite, db |
| 证书相关文件 | pem, crt, key |
文件类型分类可以在设置中的“文件类型”页调整。修改扩展名绑定后，新扫描的文件会按新规则归类；已记录文件如未变化，请重新扫描相关目录。
A.3 支持正文搜索的文件类型
正文搜索表示 AIClue 可以尝试读取文件内容，并把可读取的文字用于搜索。
对于英文正文和中英文混合正文，支持使用中文关键词或英文关键词检索。英文大小写不影响匹配；输入较长英文短语时，更接近完整短语的结果通常会优先显示。实际结果仍会受到文件类型、正文是否成功读取、搜索方式和筛选条件影响。
当前支持正文读取的常见类型包括：
| 类型 | 扩展名 |
|---|---|
| 文本文档 | txt, md, rtf, log, csv |
| 配置和网页文本 | json, html, css |
| 代码文件 | js, ts, vue, rs, py, java, c, cpp, go, php |
| Word 文档 | docx, doc |
| 表格 | xlsx, xlsm, xlsb, xls, et, ods |
| 演示文稿 | pptx, ppt |
| 电子书 | epub |
pdf |
以下情况可能导致正文无法读取或读取不完整：
- 文件过大，超过当前版本的读取限制
- 文件损坏、加密或受密码保护
- 文件格式与扩展名不一致
- 文件内容主要是图片、扫描件或二进制数据
- 文件被其他程序占用，当前无法读取
正文读取失败时，文件仍可能出现在文件列表中，但内容搜索不会命中它的正文。
A.4 支持内置预览的文件类型
内置预览表示可以直接在 AIClue 中打开预览区域查看文件。当前常见支持范围如下：
| 类型 | 扩展名 |
|---|---|
pdf | |
| Word 文档 | docx |
| 表格 | xlsx, csv, tsv |
| 演示文稿 | pptx |
| 图片 | jpg, jpeg, png, gif, webp, avif, svg, bmp, ico |
| 音频 | mp3, wav, flac, aac, ogg, opus, oga, weba, m4a |
| 视频 | mp4, m4v, webm, ogv, mov, flv, ts, mkv, m2ts |
| ZIP 压缩包 | zip，仅显示文件清单 |
| 文本和代码 | txt, md, markdown, json, xml, html, css, js, ts, tsx, jsx, vue, py, java, c, cpp, h, rs, go, cs, csv, log, ini, env, rtf, sh, bat, cmd, ps1, yaml, yml, toml, sql, php, rb, swift, kt, kts, dart, scala, mjs, cjs, cts, mts, conf, properties |
部分文件会提示使用系统默认程序打开，例如：
avi,wmv,rmvbheic,tif,tiffpsd,ai,cdr,sketch- 旧版 Office 文档，如
doc,xls,ppt,wps
预览支持还会受到系统能力、文件编码、文件是否损坏、音视频编码等因素影响。无法预览时，可以使用“打开文件”调用系统默认程序。
Markdown 预览会限制远程图片、受限本地图片路径和不安全链接，以保护本机内容；需要打开外部链接时，请按页面提示确认。
A.5 搜索数据与源文件的关系
AIClue 会保存用于搜索和筛选的本机数据，但不会把源文件移动到软件内部。
常见数据包括：
| 数据 | 用途 |
|---|---|
| 目录列表 | 记录您添加过哪些扫描目录 |
| 文件记录 | 保存文件名、路径、大小、时间、扩展名和分类信息 |
| 正文搜索数据 | 保存可读取文件的正文处理结果，用于内容搜索 |
| 标签与分类数据 | 保存文件类型标签、筛选关系和自定义分类 |
| 项目工作区数据 | 保存项目工作区名称、状态和其中关联的文件 |
| 设置项 | 保存语言、启动、托盘、隐私、文件类型和扫描排除设置 |
| 搜索历史 | 保存搜索过的关键词，用于搜索建议 |
| 查重辅助数据 | 保存用于识别重复文件的必要记录 |
| 账号状态 | 保存当前设备上的登录状态、同步时间和功能权限状态 |
这些数据用于让 AIClue 在本机完成搜索、筛选、预览、查重和工作区管理。
A.6 行为记录数据
如果在设置中开启行为记录，AIClue 可能会在本机保存部分使用行为，用于改善近期文件、工作台卡片或相关功能的效果。
行为记录级别可以在“设置 > 隐私设置”中调整：
- 关闭：不记录行为
- 低：记录软件内部文件点击
- 中：记录拖拽目标应用名
- 高：记录外部窗口标题
如果开启行为记录，可以使用应用黑名单排除不希望记录的应用。
A.7 网络相关数据
AIClue 的文件扫描、正文读取和常规搜索在本机完成。
以下功能可能需要网络连接：
- 账号登录、注册和同步权益
- 检查或安装软件更新
- 后续可能接入的在线下载渠道或服务
文件内容不会因为添加目录或本地搜索而自动上传。涉及账号或更新的网络请求，只用于完成对应功能。
A.8 清除与卸载
在“设置 > 隐私设置 > 数据管理”中，可以清除部分本机数据：
| 操作 | 说明 |
|---|---|
| 清除文件分析结果 | 清除文件摘要和关键词，保留目录和文件记录 |
| 清除搜索数据 | 清除文件记录和标签数据，保留软件设置 |
| 清除所有数据 | 清除目录、文件记录、项目工作区和用户设置 |
这些操作不会主动删除磁盘上的源文件。卸载软件也不会删除您原本存放在各个目录中的源文件。若不再需要 AIClue 保存的目录、搜索记录和设置，请先在数据管理中清除所有数据，再卸载软件。