# ChatCut Desktop Source: [ChatCut Desktop]() Documentation index: [llms.txt]() Last updated: 2026-10-22 ChatCut 桌面端是 ChatCut 编辑器的原生应用版本，适合直接处理电脑里的本地素材、在本机渲染，以及让智能体协助剪辑。 它支持两种不同的智能体工作方式： - 在 ChatCut 桌面端的 AI 输入框里，直接运行 **ChatCut**、**Claude Code**、**Codex CLI**、**DeepSeek Harness** 或 **Hermes Agent**。 - 在 Claude Code、Codex、Hermes Agent 或 WorkBuddy 等外部智能体里对话，让它通过 ChatCut 的本地 MCP 连接控制 ChatCut 桌面端项目。 这两种方式彼此相关，但都不等同于安装 [ChatCut 智能体插件](https://pr-585-preview.chatcut.dev/zh/docs/agent-plugin)。 ## 先选对产品形态 | 产品 | 在哪里操作 | 更适合什么情况 | | --- | --- | --- | | ChatCut 网页端 | 电脑浏览器 | 快速开始、云端项目、协作和浏览器或云端导出 | | ChatCut 桌面端 | macOS 或 Windows 原生编辑器 | 本地素材、更大的素材库、本地智能体和本地 4K/HDR 导出 | | ChatCut 智能体插件 | Claude Code、Codex 或 WorkBuddy 桌面应用 | 让外部桌面智能体创建或修改 ChatCut 项目 | 智能体插件不会安装到 ChatCut 网页编辑器、Claude 网页版或 ChatGPT 网页版里。 ## 下载并安装 ChatCut 桌面端 1. 打开 ChatCut 网页端并登录。 2. 点击右上角头像。 3. 将鼠标悬停在 **桌面应用** 上。 4. 在对应平台旁点击 **下载**：**macOS — Apple silicon**、**macOS — Intel** 或 **Windows**。 5. 打开下载的安装程序，按系统提示完成安装。 6. 启动 ChatCut 桌面端，并登录同一个 ChatCut 账号。 目前下载菜单里没有 Linux 版本。 ## 更新 ChatCut 桌面端 ChatCut 桌面端会检查更新，并在后台下载可用版本。下载完成后，应用会提示立即重启更新或稍后处理；推迟一次重启不会隐藏后续新版本。 如果后台更新失败，或需要手动重装，可以重新下载安装包并覆盖现有版本： 1. 退出 ChatCut 桌面端。 2. 打开 ChatCut 网页端，点击右上角头像，把鼠标移到 **Desktop App**。 3. 点击对应平台旁边的 **下载**。 4. macOS 上打开下载的磁盘映像，把 **ChatCut** 拖到 **应用程序**，确认替换；Windows 上直接运行下载的安装程序。 5. 启动 ChatCut 桌面端，按提示登录。 在现有应用上覆盖安装新版 Desktop，会保留项目包和设置。本地素材仍在原来的磁盘位置。如果更新后项目里的素材显示缺失，用 **重新关联文件** 修复，不要重新导入一遍——见[我的素材](https://pr-585-preview.chatcut.dev/zh/docs/my-assets#%E4%BF%AE%E5%A4%8D%E7%BC%BA%E5%A4%B1%E6%88%96%E4%B8%AD%E6%96%AD%E7%9A%84%E7%B4%A0%E6%9D%90)。 Desktop 0.5.5 及以上版本会优先把新项目创建为本地项目包。即使没有云端项目记录，它们也会保留在 Desktop 项目库中。Desktop 还会自动保留近期项目数据备份；媒体文件仍位于原来的磁盘位置，不会被复制进这些备份。 ## 导入本地或在线素材 在 ChatCut 桌面端打开项目，进入 **我的素材**，点击工具栏里的 **上传** 按钮，然后选择 **文件…** 或 **文件夹…**。也可以从 Finder 或文件资源管理器把文件拖进“我的素材”。 桌面端会记住原始文件在电脑上的位置，并可直接读取支持的媒体，用于剪辑和本地导出。长录音、多机位拍摄和大型素材文件夹因此不需要先完成漫长上传才能开始工作。 部分云端功能仍然需要网络。例如，使用 AI 生成服务时，ChatCut 可能需要上传本次生成所需的参考素材。“本地素材”并不代表 ChatCut 的所有功能都能离线运行。 要从视频或音频 URL 导入素材，选择 **我的素材 → 上传 → 从 URL 导入…**。桌面端会先检查来源，再显示兼容的分辨率、帧率、音频语言和音频质量选项。下载任务会出现在共用任务队列中，处理成功后才会进入当前项目。 仅云端项目也可以从桌面端项目库的卡片或列表行直接导入。卡片会显示下载进度和可重试错误；如果你是点击该项目开始导入，准备完成后桌面端会自动打开它。 ## 在 ChatCut 桌面端内使用本地 Agent 这种方式是在 ChatCut 桌面端内部运行你已经安装的本地智能体。 1. 在 ChatCut 桌面端打开一个项目。 2. 如果 AI 面板处于折叠状态，先将它打开。 3. 在 AI 输入框底部，点击消息框旁当前显示的智能体按钮。 4. 在 **Agent 选择** 中选择 **ChatCut**、**Claude Code**、**Codex CLI**、**DeepSeek Harness** 或 **Hermes Agent**。 5. 如果界面显示 **登录**，完成对应智能体的登录流程。 6. 输入剪辑要求并发送。选中的智能体可以通过 ChatCut 工具读取和修改当前项目的时间线。 ChatCut 只会在检测到兼容的本地安装后显示 Claude Code、Codex CLI、DeepSeek Harness 和 Hermes Agent；没有安装的 Agent 不会出现在列表中。DeepSeek Harness 需要 ChatCut Desktop 0.7.14 及以上版本。如果已检测到的 Agent 未登录或无法启动，对应选项会说明情况，并提供 **登录** 或 **重试**。选择本地 Agent 会使用该服务商自己的账号和额度，不会消耗 ChatCut 内置 Agent 的额度。 ### 为 Codex 选择模型（包括 GPT-6.1 Sol） 选中 **Codex CLI** 后，同一个 **Agent 选择** 菜单下方会显示 **设置**，其中包括 **模型**、**推理强度** 和 **速度**。模型和推理强度选项来自你当前登录的 Codex 账号，因此不同账号看到的列表可能不同。 在 ChatCut 桌面端 0.6.6 及以上版本中，可以在 **模型** 里选择 **GPT-6.1 Sol**。只有同时满足以下条件时才能使用： - 使用 ChatCut 桌面端 0.6.6 及以上版本；网页端和 Agent Plugin 没有 **Agent 选择**； - 这台电脑已安装 Codex CLI 或 Codex 桌面应用，并已用你的 ChatGPT 账号登录； - 这个 ChatGPT 账号本身可以使用 GPT-6.1 Sol。 通过 Codex CLI 发出的请求使用你自己的 ChatGPT 套餐额度。如果更新桌面端后列表里仍没有 GPT-6.1 Sol，说明当前登录的账号可能还不能使用它，可以换用其他模型或其他 Agent。如果 Codex 拒绝了所选模型，这一轮会显示为失败，而不会把错误内容当作回复显示。 这个模型选项只适用于 Codex CLI。在 **Agent 选择** 中选择 **ChatCut** 时，使用的是 ChatCut 自己的 Agent 及其设置。 ### 给本地智能体更多项目背景 Claude Code 和 Codex 在本机运行，因此你可以让它们把项目之外的资料作为剪辑背景，例如脚本、brief、PDF、表格、网站或代码仓库；能否访问这些内容取决于对应智能体的文件与网络权限。这些资料只为智能体提供上下文，不会自动变成时间线素材。真正要使用的视频、图片和音频仍需通过 **我的素材** 导入。 智能体工作时，你仍然保留普通编辑器的完整控制权。可以在预览器和时间线里检查改动，再手动修剪、排序或调整样式。尝试另一个方向前，点击顶部的 **版本**，再选择 **保存当前版本**，保存一个可以随时返回的命名时间线快照。 ## 让外部桌面智能体通过 MCP 控制 ChatCut 桌面端 这是相反的使用方向：对话留在同一台电脑上的 Claude Code、Codex、Hermes Agent、WorkBuddy 或其他支持 MCP 的智能体里，智能体操作的是 ChatCut 桌面端项目，默认是桌面端当前打开的项目。 1. 安装并至少启动一次 ChatCut 桌面端。每次启动时，桌面端都会向它检测到的受支持智能体注册本地 MCP 服务 `chatcut_desktop`，包括 Claude Code、Codex、Hermes Agent 和 WorkBuddy。 2. 如果智能体应用已经开着，先退出再重新打开，然后新建对话或任务。智能体只在会话开始时加载 MCP 工具，已经打开的对话不会自动获得这些工具。 3. 在 ChatCut 桌面端打开你希望智能体处理的项目，再让智能体使用 ChatCut 剪辑它。 4. 要查看连接状态，点击桌面端侧边栏顶部的智能体图标（**这台电脑上的 Agent**）。检测到受支持的智能体后才会显示这个图标，最多列出四个智能体及其状态。打开项目时，**告诉你的 agent：** 下方会提供一段可以复制的提示词，让智能体连接到这个项目。 5. 点击智能体名称，会在对应应用中新建对话。如果某一行显示 **连接**、**重连** 或 **重试**，点击它修复本地 MCP 连接。在 WorkBuddy 里批准连接之前，WorkBuddy 这一行会显示 **确认**。 6. 要连接其他支持 MCP 的智能体，点击 **连接任意 Agent**，把复制的设置提示词粘贴给该智能体。 两个应用必须在同一台电脑上。Desktop 0.7.10 及以上版本不需要一直开着：ChatCut 桌面端或项目窗口关闭时，智能体仍可以继续处理选定的本地项目，这些工具也不会自动启动应用。更早的版本需要保持桌面端打开。 桌面端还会把内置工作流 Skills 复制到共享的 `~/.agents/skills` 文件夹，以及每个已连接智能体自己的 Skill 文件夹（例如 `~/.claude/skills` 或 `~/.codex/skills`），文件夹名以 `chatcut-` 开头。你自己创建的 Skills 不会被改动。 桌面端连接 Claude Code、Codex 或 WorkBuddy 时，会关闭该应用里的托管 [ChatCut 智能体插件](https://pr-585-preview.chatcut.dev/zh/docs/agent-plugin)：在 Claude Code 和 WorkBuddy 中停用，在 Codex 中移除。这样智能体处理的就是 ChatCut 桌面端项目，而不是网页端项目。 Desktop 0.5.16 及以上版本还会把本地创建的项目提供给这些项目工具。Agent 可以列出并指定本地项目，再对它执行重命名、复制、备份、恢复或删除，无需额外创建云端副本。 这个本地 MCP 通道和智能体插件使用的 ChatCut 托管连接不是一回事。另一种流程参见[智能体插件：支持的桌面应用与安装方法](https://pr-585-preview.chatcut.dev/zh/docs/agent-plugin)。 ## 在本地导出 4K 或 HDR 视频 1. 确保时间线上至少有一个内容项。 2. 点击顶部的 **导出**。 3. 打开 **视频** 标签页。 4. 在 **动态范围** 中选择 **SDR** 或 **HDR**。 5. 在 **分辨率** 中选择 **480p**、**720p**、**1080p** 或 **4K**。 6. 选择帧率、导出范围和保存位置，然后开始导出。 ChatCut 桌面端的视频导出会在本机渲染，并保存到你选择的文件夹。HDR 只会在当前电脑支持时启用；不支持时，HDR 选项会被禁用，面板会显示 **HDR export is not available on this computer**。 其他导出标签页、格式和网页端限制参见[导出](https://pr-585-preview.chatcut.dev/zh/docs/exporting)。 ## 哪些部分仍然使用云端？ ChatCut 桌面端不是完全离线应用。账号登录、项目同步、ChatCut 内置智能体、在线生成模型以及其他服务端能力都需要网络。本地 Claude Code 或 Codex 在执行任务时，也可能连接各自服务商的在线服务。 桌面端真正的区别是：它可以从本地素材开始工作，并在本机完成受支持的视频渲染；这不代表每个工具都不会联网。