尧图网站建设 
FreeCut工作区与项目管理本地优先存储、ZIP备份与自动保存机制详解【免费下载链接】freecutFreeCut is a professional-grade video editor that runs entirely in your browser. Professional video editing, zero installation. Create stunning videos with multi-track editing, keyframe animations, real-time preview, and high-quality exports.项目地址: https://gitcode.com/gh_mirrors/free/freecutFreeCut 是一款完全运行在浏览器中的专业级多轨视频编辑器主打本地优先local-first存储项目、素材元数据、缩略图、波形与缓存全部以普通文件形式保存在你自己选择的工作区文件夹中无需安装、无需上传。本文详解 FreeCut 的工作区模型、项目管理、ZIP 备份导出与自动保存机制帮助你安全地创建、组织、迁移和备份剪辑工程。什么是 FreeCut 工作区一切皆本地普通文件FreeCut 的工作区就是磁盘上的一个普通文件夹它是应用的唯一事实来源source of truth。应用生成的所有内容都写在这里项目文件时间线、关键帧、标记、转场、设置素材元数据、缩略图、波形、解码音频缓存转写文本、字幕、场景切点、AI 生成资产工作区索引与缓存镜像关键特点导入的源素材不会被复制进工作区FreeCut 只在media/id/下记录一个指向原文件的链接描述source.link.json。因此工作区体积很小而你的原始素材仍留在原处可以像备份普通目录一样备份、同步或迁移。工作区存储层源码位于 src/infrastructure/storage/workspace-fs/官方工作区说明模板见 src/infrastructure/storage/workspace-fs/README.template.md。工作区文件夹结构速览打开你的工作区文件夹可以看到清晰可辨的文件布局文件 / 目录作用.freecut-workspace.json工作区标记 模式版本号index.json快速项目列表索引projects/id/project.json时间线、设置、关键帧、标记、转场projects/id/media-links.json该项目引用的素材清单media/id/metadata.json编码、时长、分辨率等元数据media/id/source.link.json指向磁盘源文件的链接描述media/id/cache/影条、波形、GIF 帧、解码音频等缓存content/proxies/按内容指纹共享的低清代理文件这些文件全部是明文可读的project.json可以在外部直接编辑FreeCut 下次加载时会读取你的修改二进制缓存波形、解码音频、影条均可再生——删除后应用会按需重建。 工作区内置了孤儿清理orphan sweep机制会自动清理由失效素材遗留的无用文件保持目录整洁。如何选择、切换与重连工作区首次启动时FreeCut 会要求你先选择一个工作区文件夹建议选文档等自己拥有的普通目录避免系统保护位置。通过工作区Workspaces控件可添加、切换或移除已记住的工作区切换只改变 FreeCut 使用哪个文件夹不会移动你的源素材。权限过期处理出于安全考虑浏览器可能在会话之间失效文件夹权限。当 FreeCut 提示Reconnect your workspace时点击Reconnect并重新授予读写权限即可。素材丢失处理若链接的源文件被移动可用Locate / Locate Folder重新定位或用Browse Another Folder指向新副本仅在计划稍后重链接时才使用Work Offline。整体迁移直接把工作区文件夹拷贝到新位置下次启动时重新选择该文件夹即可无需任何转换。工作区门禁与入口组件位于 src/features/workspace-gate/官方文档页参考 src/features/docs/pages/02-workspaces.ts。项目创建与组织从项目列表页开始FreeCut 的项目管理功能集中在项目页面路由 src/routes/projects/UI 模块 src/features/projects/新建项目点击New Project设置名称、描述、分辨率、帧率与背景色。分辨率预设覆盖 YouTube 1080p16:9、Shorts/TikTok9:16、Instagram 方形等常见投放平台也支持自定义尺寸画布范围从320x240到7680x4320。查找与组织按名称搜索、排序、过滤缩略图与元数据帮助你快速定位最近编辑的工程Duplicate可以无风险地分出一个变体。当前工作区标识项目页面会显示当前工作区你永远知道工程保存在哪里。版本兼容旧版项目会自动执行模式迁移升级src/features/projects/services/project-upgrade-service.ts早期纯浏览器 IndexedDB 存储的工程也会通过 src/infrastructure/storage/legacy-idb/migrate.ts 自动迁移到本地文件工作区。回收站与恢复软删除如何保护你的工程删除项目在 FreeCut 中是软删除——工程目录完整保留仅追加一个.freecut-trashed.json标记文件来隐藏它实现见 src/infrastructure/storage/workspace-fs/trash.ts恢复在回收站分区点击恢复即可标记移除后工程立即重新可见清空回收站永久删除已回收的工程及其独占引用的素材不可撤销请务必确认名称自动清理回收站中的工程超过默认 30 天保留期TTL后会被自动清除避免磁盘长期占用。这种标记文件设计还有一个好处你在文件管理器中就能直观看到哪些工程处于已回收状态。项目 ZIP 备份一键导出 .freecut.zip 可移植工程包需要跨机器协作、交付项目或做异地备份时导出项目Export Project是首选方案FreeCut 将工程连同其引用的所有素材打包为一个.freecut.zip捆绑包内部包含项目快照、缩略图、动画预设、逐素材条目以及带校验和checksum的清单文件manifest。打包逻辑见 src/features/project-bundle/services/bundle-export-service.ts操作入口在 src/features/project-bundle/components/bundle-export-dialog.tsx。在目标机器的另一个工作区中导入该捆绑包FreeCut 会先校验清单Zod 模式验证再解压媒体文件到指定目录重建工程、关联素材并处理名称冲突src/features/project-bundle/services/bundle-import-service.ts。 捆绑包是安全地把项目交给别人的方式——它把链接的媒体随时间线一起携带对方无需你原始的文件夹结构。配合手动备份习惯日常依赖自动保存 工作区同步阶段性里程碑交付、协作前导出一份 ZIP即可得到完整的本地优先 异地备份策略。自动保存机制默认每 5 分钟落盘一次FreeCut 编辑器内置自动保存防止标签页崩溃或意外关闭丢失工作默认开启autoSaveInterval默认为5 分钟0 表示关闭在 src/features/settings/stores/settings-store.ts 中定义可在设置 → 通用里通过开关和间隔滑块调整。只在有改动时保存自动保存 Hooksrc/features/editor/hooks/use-auto-save.ts检测到脏状态isDirty才会触发避免无谓写盘。不打断编辑保存动作被延迟到浏览器空闲时段requestIdleCallback执行拖动片段、打关键帧等操作不会被 I/O 打断即便持续忙碌也保证 10 秒内落盘。失败有提示保存失败会弹出错误 toast你可以立即手动重试。常见场景与最佳实践清单场景推荐操作换电脑继续剪辑拷贝整个工作区文件夹 素材或导出 ZIP 捆绑包导入释放磁盘空间使用缓存清理动作波形、影条、解码音频等可再生数据不会删除源素材素材被移动Locate重新定位或Browse Another Folder指向副本误删工程回收站恢复30 天内自动清除请尽早处理浏览器提示无权限点击Reconnect重新授权同一文件夹定期备份手动 ZIP 导出 工作区目录同步双保险核心要点回顾FreeCut 把工作区做成一个可读、可备份、可迁移的普通文件夹项目以明文 JSON 存储素材以链接而非副本方式管理软删除 回收站兜底误操作ZIP 捆绑包实现跨设备迁移自动保存保障日常编辑安全。理解这套本地优先机制你就能在浏览器里安心进行专业级剪辑而不用再担心工程文件存在哪里。【免费下载链接】freecutFreeCut is a professional-grade video editor that runs entirely in your browser. Professional video editing, zero installation. Create stunning videos with multi-track editing, keyframe animations, real-time preview, and high-quality exports.项目地址: https://gitcode.com/gh_mirrors/free/freecut创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FreeCut工作区与项目管理：本地优先存储、ZIP备份与自动保存机制详解
FreeCut工作区与项目管理本地优先存储、ZIP备份与自动保存机制详解【免费下载链接】freecutFreeCut is a professional-grade video editor that runs entirely in your browser. Professional video editing, zero installation. Create stunning videos with multi-track editing, keyframe animations, real-time preview, and high-quality exports.项目地址: https://gitcode.com/gh_mirrors/free/freecutFreeCut 是一款完全运行在浏览器中的专业级多轨视频编辑器主打本地优先local-first存储项目、素材元数据、缩略图、波形与缓存全部以普通文件形式保存在你自己选择的工作区文件夹中无需安装、无需上传。本文详解 FreeCut 的工作区模型、项目管理、ZIP 备份导出与自动保存机制帮助你安全地创建、组织、迁移和备份剪辑工程。什么是 FreeCut 工作区一切皆本地普通文件FreeCut 的工作区就是磁盘上的一个普通文件夹它是应用的唯一事实来源source of truth。应用生成的所有内容都写在这里项目文件时间线、关键帧、标记、转场、设置素材元数据、缩略图、波形、解码音频缓存转写文本、字幕、场景切点、AI 生成资产工作区索引与缓存镜像关键特点导入的源素材不会被复制进工作区FreeCut 只在media/id/下记录一个指向原文件的链接描述source.link.json。因此工作区体积很小而你的原始素材仍留在原处可以像备份普通目录一样备份、同步或迁移。工作区存储层源码位于 src/infrastructure/storage/workspace-fs/官方工作区说明模板见 src/infrastructure/storage/workspace-fs/README.template.md。工作区文件夹结构速览打开你的工作区文件夹可以看到清晰可辨的文件布局文件 / 目录作用.freecut-workspace.json工作区标记 模式版本号index.json快速项目列表索引projects/id/project.json时间线、设置、关键帧、标记、转场projects/id/media-links.json该项目引用的素材清单media/id/metadata.json编码、时长、分辨率等元数据media/id/source.link.json指向磁盘源文件的链接描述media/id/cache/影条、波形、GIF 帧、解码音频等缓存content/proxies/按内容指纹共享的低清代理文件这些文件全部是明文可读的project.json可以在外部直接编辑FreeCut 下次加载时会读取你的修改二进制缓存波形、解码音频、影条均可再生——删除后应用会按需重建。 工作区内置了孤儿清理orphan sweep机制会自动清理由失效素材遗留的无用文件保持目录整洁。如何选择、切换与重连工作区首次启动时FreeCut 会要求你先选择一个工作区文件夹建议选文档等自己拥有的普通目录避免系统保护位置。通过工作区Workspaces控件可添加、切换或移除已记住的工作区切换只改变 FreeCut 使用哪个文件夹不会移动你的源素材。权限过期处理出于安全考虑浏览器可能在会话之间失效文件夹权限。当 FreeCut 提示Reconnect your workspace时点击Reconnect并重新授予读写权限即可。素材丢失处理若链接的源文件被移动可用Locate / Locate Folder重新定位或用Browse Another Folder指向新副本仅在计划稍后重链接时才使用Work Offline。整体迁移直接把工作区文件夹拷贝到新位置下次启动时重新选择该文件夹即可无需任何转换。工作区门禁与入口组件位于 src/features/workspace-gate/官方文档页参考 src/features/docs/pages/02-workspaces.ts。项目创建与组织从项目列表页开始FreeCut 的项目管理功能集中在项目页面路由 src/routes/projects/UI 模块 src/features/projects/新建项目点击New Project设置名称、描述、分辨率、帧率与背景色。分辨率预设覆盖 YouTube 1080p16:9、Shorts/TikTok9:16、Instagram 方形等常见投放平台也支持自定义尺寸画布范围从320x240到7680x4320。查找与组织按名称搜索、排序、过滤缩略图与元数据帮助你快速定位最近编辑的工程Duplicate可以无风险地分出一个变体。当前工作区标识项目页面会显示当前工作区你永远知道工程保存在哪里。版本兼容旧版项目会自动执行模式迁移升级src/features/projects/services/project-upgrade-service.ts早期纯浏览器 IndexedDB 存储的工程也会通过 src/infrastructure/storage/legacy-idb/migrate.ts 自动迁移到本地文件工作区。回收站与恢复软删除如何保护你的工程删除项目在 FreeCut 中是软删除——工程目录完整保留仅追加一个.freecut-trashed.json标记文件来隐藏它实现见 src/infrastructure/storage/workspace-fs/trash.ts恢复在回收站分区点击恢复即可标记移除后工程立即重新可见清空回收站永久删除已回收的工程及其独占引用的素材不可撤销请务必确认名称自动清理回收站中的工程超过默认 30 天保留期TTL后会被自动清除避免磁盘长期占用。这种标记文件设计还有一个好处你在文件管理器中就能直观看到哪些工程处于已回收状态。项目 ZIP 备份一键导出 .freecut.zip 可移植工程包需要跨机器协作、交付项目或做异地备份时导出项目Export Project是首选方案FreeCut 将工程连同其引用的所有素材打包为一个.freecut.zip捆绑包内部包含项目快照、缩略图、动画预设、逐素材条目以及带校验和checksum的清单文件manifest。打包逻辑见 src/features/project-bundle/services/bundle-export-service.ts操作入口在 src/features/project-bundle/components/bundle-export-dialog.tsx。在目标机器的另一个工作区中导入该捆绑包FreeCut 会先校验清单Zod 模式验证再解压媒体文件到指定目录重建工程、关联素材并处理名称冲突src/features/project-bundle/services/bundle-import-service.ts。 捆绑包是安全地把项目交给别人的方式——它把链接的媒体随时间线一起携带对方无需你原始的文件夹结构。配合手动备份习惯日常依赖自动保存 工作区同步阶段性里程碑交付、协作前导出一份 ZIP即可得到完整的本地优先 异地备份策略。自动保存机制默认每 5 分钟落盘一次FreeCut 编辑器内置自动保存防止标签页崩溃或意外关闭丢失工作默认开启autoSaveInterval默认为5 分钟0 表示关闭在 src/features/settings/stores/settings-store.ts 中定义可在设置 → 通用里通过开关和间隔滑块调整。只在有改动时保存自动保存 Hooksrc/features/editor/hooks/use-auto-save.ts检测到脏状态isDirty才会触发避免无谓写盘。不打断编辑保存动作被延迟到浏览器空闲时段requestIdleCallback执行拖动片段、打关键帧等操作不会被 I/O 打断即便持续忙碌也保证 10 秒内落盘。失败有提示保存失败会弹出错误 toast你可以立即手动重试。常见场景与最佳实践清单场景推荐操作换电脑继续剪辑拷贝整个工作区文件夹 素材或导出 ZIP 捆绑包导入释放磁盘空间使用缓存清理动作波形、影条、解码音频等可再生数据不会删除源素材素材被移动Locate重新定位或Browse Another Folder指向副本误删工程回收站恢复30 天内自动清除请尽早处理浏览器提示无权限点击Reconnect重新授权同一文件夹定期备份手动 ZIP 导出 工作区目录同步双保险核心要点回顾FreeCut 把工作区做成一个可读、可备份、可迁移的普通文件夹项目以明文 JSON 存储素材以链接而非副本方式管理软删除 回收站兜底误操作ZIP 捆绑包实现跨设备迁移自动保存保障日常编辑安全。理解这套本地优先机制你就能在浏览器里安心进行专业级剪辑而不用再担心工程文件存在哪里。【免费下载链接】freecutFreeCut is a professional-grade video editor that runs entirely in your browser. Professional video editing, zero installation. Create stunning videos with multi-track editing, keyframe animations, real-time preview, and high-quality exports.项目地址: https://gitcode.com/gh_mirrors/free/freecut创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考