在同一台电脑上的外部智能体中继续对话，通过 ChatCut Desktop 的本地工具剪辑选定的项目。选定项目及受支持的剪辑操作不需要项目窗口。本指南适用于 macOS 版 ChatCut Desktop 0.7.21；安装与本地 MCP 连接方法见 ChatCut Desktop。
开始前
让智能体连接 ChatCut Desktop 的本地 chatcut_desktop 工具，而不是托管的智能体插件。刚完成连接时，新建智能体对话以加载工具。确保项目包和源素材在这台电脑上可用，并给予智能体所需的文件访问权限。
关闭 Desktop 不代表所有操作都能离线完成。账号服务、智能体服务商和在线 AI 功能仍可能需要网络、登录、积分或服务商额度。使用参考素材的服务可能需要上传素材。执行前，查看实际操作及其确认提示。
1. 找到正确的项目
让智能体列出项目，并提供足以辨认目标本地项目包的信息：
使用 ChatCut Desktop 的本地工具。列出项目，不要修改它们。显示项目 ID、名称，以及返回的本地项目包位置或位置错误。我在找[项目名称或已知项目包位置]。暂时不要创建或剪辑项目。
把方括号里的文字换成实际项目名称或已知位置。Desktop 项目列表可以同时包含账号项目和这台电脑上已登记的项目包。结合项目 ID、返回的项目包位置和预期内容辨认；不能只凭同名判断。
仅本地的 Desktop 项目是 .chatcutproject 项目包，不会出现在网页编辑器或托管连接的项目列表中。账号项目出现在 Desktop 列表中，也不代表其本地项目包与素材已经可用。
需要新项目时，明确让智能体创建，不要选择一个名称相近的项目。create_project 会创建并选定本地项目包，默认不打开窗口。保留返回的项目 ID，供后续操作使用。
2. 选定项目并先读取内容
把列表中的实际 ID 提供给智能体，让它用 target_project 选定该项目，再用 read_project 读取项目概况。让它检查与任务有关的现有时间线和素材，根据返回的实际标识选择剪辑位置。
选定本地项目会为该智能体客户端指定目标，不会打开或切换 Desktop 窗口。读取项目可以确认已有内容；仅选定项目不会导入素材或生成初剪。如果读到了不符合预期的素材或时间线，先辨认清楚项目再剪辑。
3. 请求一个可编辑的结果
使用实际项目 ID，以及你有权使用的素材的绝对路径。下面的示例明确要求导入，因为该录制素材尚未进入项目：
使用 ChatCut Desktop 本地项目[项目 ID]。选定它但不要打开窗口，然后检查已有时间线和素材。导入[录制素材的绝对路径]，在名为[验看时间线名称]的新时间线上做一版可编辑的初剪。去掉明显说错重来、重复内容和过长停顿，保留原意、原始画面与声音、自然呼吸。只使用这段素材。等我验看初剪后，再决定字幕、生成素材和导出。报告项目与时间线 ID、实际改动和仍在等待的步骤。
发送前替换所有方括号内容。素材已经导入时，把导入要求改成引用项目读取结果中的实际素材。只剪一部分时，写明范围或必须保留的要点。
任务需要导入本地文件时，智能体可以用 push_asset 导入它能够读取的文件。导入让素材进入项目；把它剪到时间线上是另一个结果。先等待素材处理或转录完成，再判断口播剪辑效果。遇到问题或错误时先阅读，不要直接重发整个任务。
4. 验看结果并继续修改
让智能体重新读取同一个项目及结果时间线。对照任务检查项目身份、保留的片段、顺序和时长。工具返回成功或智能体给出总结，都不能单独证明已保存项目里有预期的初剪。
需要看画面时，启动 ChatCut Desktop，再让智能体显示同一个项目。Desktop 已运行时，target_project 的 openWindow=true 可以显示或聚焦项目窗口；它不会启动已关闭的应用。在 Viewer 和时间线中检查目标时间线。口播剪辑要打开声音，从第一句话播放到最后一句，检查原意、呼吸和剪辑接点。验看标准见口播剪辑。
继续在同一项目中修改，使用实际时间线和片段引用。例如，让智能体恢复一处剪掉的呼吸，其他剪辑保持不变。需要交付文件时再导出；按照 Desktop 本地导出操作，并打开实际文件检查。
关闭窗口不代表剪辑、导入或渲染已经完成，也不代表已取消。先检查操作报告的状态，以及结果项目或文件，再判断是否完成。
流程停住时
| 看到的情况 | 下一步 |
|---|---|
| 只有托管／网页工具，或没有 Desktop 工具 | 按本地连接设置处理，再新建智能体对话。不要创建网页项目来代替找不到的本地项目。 |
| 本地项目未列出、标识不唯一，或位置报错 | 对照完整项目 ID 和项目包位置，确认项目包在这台电脑上可用。保留原项目包，报告返回的错误，不要另建同名项目。 |
| 项目已创建，但窗口没有打开 | 保留返回的 ID，选定这个已有项目，不要重复创建。想显示窗口时先启动 Desktop。 |
| 素材缺失或导入失败 | 检查原始文件路径、访问权限和处理状态。已有素材使用对应的重新关联方法，避免重复导入。 |
| 找不到初剪，或语音内容尚未就绪 | 读取同一项目和目标时间线，检查处理或转录状态，找出未完成步骤。带上实际目标继续该步骤，不要重复已完成的工作。 |
| 工具要求窗口、登录或其他服务 | 遵循该操作的实际要求。无需窗口即可选定项目，不代表所有工具都能在 Desktop 关闭或无网络时使用。 |
问题仍未解决时，保留项目与原始文件。通过反馈或当前支持对话提供项目 ID、项目包位置、Desktop 版本、失败步骤和完整错误信息。