# 在自己的智能体中剪辑 Desktop 项目

Source: [在自己的智能体中剪辑 Desktop 项目](<https://chatcut.io/zh/docs/desktop-agent-workflows>)

Documentation index: [llms.txt](<https://chatcut.io/zh/docs/llms.txt>)

Last updated: 2026-10-24

在同一台电脑上的外部智能体中继续对话，通过 ChatCut Desktop 的本地工具剪辑选定的项目。选定项目及受支持的剪辑操作不需要项目窗口。本指南适用于 **macOS 版 ChatCut Desktop 0.7.21**；安装与本地 MCP 连接方法见 [ChatCut Desktop](https://chatcut.io/zh/docs/desktop-app)。

## 开始前

让智能体连接 ChatCut Desktop 的本地 `chatcut_desktop` 工具，而不是托管的[智能体插件](https://chatcut.io/zh/docs/agent-plugin)。刚完成连接时，新建智能体对话以加载工具。确保项目包和源素材在这台电脑上可用，并给予智能体所需的文件访问权限。

关闭 Desktop 不代表所有操作都能离线完成。账号服务、智能体服务商和在线 AI 功能仍可能需要网络、登录、积分或服务商额度。使用参考素材的服务可能需要上传素材。执行前，查看实际操作及其确认提示。

## 1\. 找到正确的项目

让智能体列出项目，并提供足以辨认目标本地项目包的信息：

Prompt

```text
使用 ChatCut Desktop 的本地工具。列出项目，不要修改它们。显示项目 ID、名称，以及返回的本地项目包位置或位置错误。我在找[项目名称或已知项目包位置]。暂时不要创建或剪辑项目。
```

把方括号里的文字换成实际项目名称或已知位置。Desktop 项目列表可以同时包含账号项目和这台电脑上已登记的项目包。结合**项目 ID**、返回的项目包位置和预期内容辨认；不能只凭同名判断。

仅本地的 Desktop 项目是 `.chatcutproject` 项目包，不会出现在网页编辑器或托管连接的项目列表中。账号项目出现在 Desktop 列表中，也不代表其本地项目包与素材已经可用。

需要新项目时，明确让智能体创建，不要选择一个名称相近的项目。`create_project` 会创建并选定本地项目包，默认不打开窗口。保留返回的项目 ID，供后续操作使用。

## 2\. 选定项目并先读取内容

把列表中的实际 ID 提供给智能体，让它用 `target_project` 选定该项目，再用 `read_project` 读取项目概况。让它检查与任务有关的现有时间线和素材，根据返回的实际标识选择剪辑位置。

选定本地项目会为该智能体客户端指定目标，不会打开或切换 Desktop 窗口。读取项目可以确认已有内容；仅选定项目不会导入素材或生成初剪。如果读到了不符合预期的素材或时间线，先辨认清楚项目再剪辑。

## 3\. 请求一个可编辑的结果

使用实际项目 ID，以及你有权使用的素材的绝对路径。下面的示例明确要求导入，因为该录制素材尚未进入项目：

Prompt

```text
使用 ChatCut Desktop 本地项目[项目 ID]。选定它但不要打开窗口，然后检查已有时间线和素材。导入[录制素材的绝对路径]，在名为[验看时间线名称]的新时间线上做一版可编辑的初剪。去掉明显说错重来、重复内容和过长停顿，保留原意、原始画面与声音、自然呼吸。只使用这段素材。等我验看初剪后，再决定字幕、生成素材和导出。报告项目与时间线 ID、实际改动和仍在等待的步骤。
```

发送前替换所有方括号内容。素材已经导入时，把导入要求改成引用项目读取结果中的实际素材。只剪一部分时，写明范围或必须保留的要点。

任务需要导入本地文件时，智能体可以用 `push_asset` 导入它能够读取的文件。导入让素材进入项目；把它剪到时间线上是另一个结果。先等待素材处理或转录完成，再判断口播剪辑效果。遇到问题或错误时先阅读，不要直接重发整个任务。

## 4\. 验看结果并继续修改

让智能体重新读取同一个项目及结果时间线。对照任务检查项目身份、保留的片段、顺序和时长。工具返回成功或智能体给出总结，都不能单独证明已保存项目里有预期的初剪。

需要看画面时，启动 ChatCut Desktop，再让智能体显示同一个项目。Desktop 已运行时，`target_project` 的 `openWindow=true` 可以显示或聚焦项目窗口；它不会启动已关闭的应用。在 Viewer 和时间线中检查目标时间线。口播剪辑要打开声音，从第一句话播放到最后一句，检查原意、呼吸和剪辑接点。验看标准见[口播剪辑](https://chatcut.io/zh/docs/talking-head-edit)。

继续在同一项目中修改，使用实际时间线和片段引用。例如，让智能体恢复一处剪掉的呼吸，其他剪辑保持不变。需要交付文件时再导出；按照 [Desktop 本地导出](https://chatcut.io/zh/docs/desktop-local-export)操作，并打开实际文件检查。

关闭窗口不代表剪辑、导入或渲染已经完成，也不代表已取消。先检查操作报告的状态，以及结果项目或文件，再判断是否完成。

## 流程停住时

| 看到的情况 | 下一步 |
| --- | --- |
| 只有托管／网页工具，或没有 Desktop 工具 | 按[本地连接设置](https://chatcut.io/zh/docs/desktop-app)处理，再新建智能体对话。不要创建网页项目来代替找不到的本地项目。 |
| 本地项目未列出、标识不唯一，或位置报错 | 对照完整项目 ID 和项目包位置，确认项目包在这台电脑上可用。保留原项目包，报告返回的错误，不要另建同名项目。 |
| 项目已创建，但窗口没有打开 | 保留返回的 ID，选定这个已有项目，不要重复创建。想显示窗口时先启动 Desktop。 |
| 素材缺失或导入失败 | 检查原始文件路径、访问权限和处理状态。已有素材使用对应的[重新关联方法](https://chatcut.io/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 关闭或无网络时使用。 |

问题仍未解决时，保留项目与原始文件。通过**反馈**或当前支持对话提供项目 ID、项目包位置、Desktop 版本、失败步骤和完整错误信息。