设置、备份和排障

在侧边栏底部打开设置，左侧可直接跳转到常规设置、素材存储、索引管理、AI Agent、专业版授权、软件更新和帮助与反馈。

备份素材库

1. 等待导入、索引、迁移、合并和导出任务完成。
2. 完全退出 ClipSeek，再复制素材库。
3. 复制整个素材库目录，包括 library.json、images 和隐藏的 .clipstudio。
4. 把副本保存到另一块磁盘或备份服务中。

仅引用源文件的原件不在库内，需要另外备份。 只复制素材或数据库，都不能得到完整的素材库备份。不要让两台电脑或实时同步服务同时写入正在使用的素材库。

恢复备份

1. 把完整备份复制到电脑的本地磁盘。
2. 打开 ClipSeek，在素材库菜单选择导入素材库，选中恢复的目录或其中的 library.json。
3. 打开库，检查素材、分类和搜索是否正常。
4. 引用素材的路径若有变化，从新位置重新导入同一文件，恢复关联。

从较新版本恢复的库如果提示需要升级，请先更新 ClipSeek。不要手动修改库版本或直接打开数据库。应用自动生成的数据库升级备份只包含数据库，不能代替完整素材库备份。

管理搜索索引

打开设置 → 索引管理，分别查看和管理画面索引与字幕索引。画面索引用于文字搜画面和以图搜图；字幕索引用于按已导入的台词查找视频。

索引管理中的画面索引、字幕索引、自动建立开关与补建入口

索引管理中的画面索引、字幕索引、自动建立开关与补建入口

自动建立与手动补建

• 导入时自动建立画面索引 / 字幕索引：只影响之后提交的导入任务。关闭不删除已有索引；重新开启不会自动处理旧素材。
• 建立搜索索引：补建缺失的索引，保留已有结果。可以在索引管理中处理当前整个库，也可以在素材详情或选中素材、文件夹、标签后操作。
• 字幕索引：只适用于已经关联文字字幕的视频。提示“无字幕”时，先导入字幕。

如果只想先整理素材，可以关闭自动索引；之后需要搜索时再补建。关闭画面自动索引后，视频仍生成封面，但不会提取搜索关键帧。

查看进度、取消与重试

在导入队列中查看每个素材的入库、画面索引、字幕索引和提醒。素材详情也会显示索引状态。

状态	接下来怎么做
排队中 / 构建中	等待完成；需要时可取消。取消会在当前处理步骤之后生效。
未索引 / 已取消	需要参与搜索时，选择建立搜索索引。
失败	查看错误，检查源文件、权限、模型和磁盘空间后重试。
无字幕	为视频导入字幕，再建立字幕索引。
已索引	可以在对应搜索模式中查找。

入库成功不代表索引已完成。 没有索引的素材仍可按名称或属性查找；画面搜索只返回画面索引可用的素材，字幕搜索只返回字幕索引可用的视频。重启后可继续未完成任务；被取消的任务不会自动重启。

画面索引损坏时再使用修复

缺少部分素材的索引时，先用建立搜索索引补建。如果持续提示画面索引无法打开，先点重试；仍失败时，再进入：

设置 → 索引管理 → 画面索引 → 索引修复 → 重建画面索引。

重建只修复当前库的画面搜索数据，不删除原素材、字幕、文件夹或标签。确认窗口会显示需要处理的帧数、当前索引大小、预计临时空间和可用磁盘空间。检查后开始，保持 ClipSeek 开启和素材库磁盘可访问，运行中可以取消。

旧索引会保留到新索引校验通过；如果应用在最终替换时退出，下次启动会恢复到一致状态。无法读取的缩略图或关键帧会在结束后报告。字幕搜索问题应先检查字幕内容和字幕索引，不需要重建画面索引。

检测无效的引用素材

仅引用素材需要此检测，拷贝入库的素材不参与。

1. 打开设置 → 素材存储 → 检测无效的源素材，点击开始检测。
2. 发现丢失项后，点击查看，在素材页检查这些文件。
3. 磁盘离线时先重新连接；文件被移动或改名时，从新位置重新导入同一文件，恢复原素材关联。

素材存储设置中的源文件检测入口

素材存储设置中的源文件检测入口

检测可以取消，不会删除或重新导入任何文件。不再需要的无效素材可以手动移入垃圾箱；这不会删除引用的外部源文件。

常规设置、更新与授权

在设置 → 常规设置中修改界面语言、主题和垃圾箱保留天数。

常规设置中的语言、主题和垃圾箱保留天数

常规设置中的语言、主题和垃圾箱保留天数

检查版本时，打开设置 → 软件更新 → 检查更新。开启自动检查后，应用会在启动后静默检查。也可以退出 ClipSeek 后从官网下载页安装新版本；更新应用会保留素材库和设置，升级前仍建议备份。

免费版允许所有已登记素材库合计最多 5 GiB 的有效原素材，引用素材同样计入；垃圾箱内容不计入。购买、激活、找回序列号和换机方法见软件序列号。

常见问题

问题	先这样处理
模型下载失败	检查网络和剩余空间，保持应用开启后重试；下载长期没有进展时重启应用。
导入没有找到文件	检查支持的格式、文件路径和读取权限。
文件导入失败	查看队列错误，检查空间、源文件权限和免费版容量后重试。
重复数量增加	相同内容已经入库，属于正常去重结果。
入库后搜不到画面	清除筛选、换用画面描述，并检查画面索引是否完成。
找不到台词	检查是否关联字幕、字幕索引是否完成，尝试更短关键词或“包含文字”。
引用素材无法播放、导出或剪切	重新连接磁盘；路径改变时从新位置导入同一文件。
Windows 视频无法播放	按解码提示查看 Windows 视频扩展，并用系统播放器测试原片。
导入中断	重开同一个库，按提示继续任务；放弃任务会保留已入库素材。
素材库打不开	恢复原磁盘或目录，重试授权；提示版本过旧时先升级应用。
迁移或合并失败	先停止播放，按空间、权限或文件提示处理后重试；不要手动删除原库。
更新失败	稍后重试；持续失败时导出日志并反馈。

问题反馈

1. 打开设置 → 帮助与反馈 → 导出日志，保存最近三天的脱敏日志。
2. 发送到 support@clipseek.ai，附上 ClipSeek 版本、系统版本、操作步骤、大致发生时间和错误提示。

日志不包含素材文件。不要在公开反馈中提交序列号或 MCP 访问 Token；私人素材无需随日志发送。