CreatorCut by AgentMesh360

AgentMesh-CreatorCut

AgentMesh-CreatorCut 是 CreatorCut 的公开执行产品：一款用于智能后期制作访谈视频和产品屏幕录制内容的 Agent。

M1 专为中文、英文和混合语言录制内容打造。公开客户端会在本地处理媒体，在不同宿主环境中渲染由 Director 驱动的交互卡片，验证已签名的剪辑计划，预览更改，并且只应用声明式、可逆的操作。

安装

macOS 或 Ubuntu：

curl -fsSL https://raw.githubusercontent.com/jiyangnan/AgentMesh-CreatorCut/main/scripts/install.sh | bash

Windows PowerShell：

irm https://raw.githubusercontent.com/jiyangnan/AgentMesh-CreatorCut/main/scripts/install.ps1 | iex

安装程序会设置固定版本的 Node 运行时、Git、FFmpeg、whisper.cpp、多语言转录模型、安全凭据后端、CLI 启动器和已签名的托管更新渠道。安装成功后会立即启动引导式 Agent 交接：

creatorcut onboard

onboard 会检查本地工具链和受信任的 Director 配置，通过安全标准输入提示输入 AgentMesh API 密钥，引导导入本地录制内容，启动多语言转录，然后返回确切的下一步操作。启动其他进程的 Agent 必须使用 next_process.executable、next_process.argv、next_process.cwd、shell: false，并将允许列表中的 env_overrides 合并到宿主环境中。嵌入式 API 宿主可以将 next_argv 直接传回 executeCli。 OpenClaw 则必须将确切的 next_openclaw.exec 对象传给其 exec 工具。该对象始终使用固定字面命令 creatorcut __openclaw-bridge；argv 只通过工具的结构化环境字段传递。对于两个非机密 JSON 输入步骤，请遵循返回的 PTY json-line-v1 合约。API 密钥不会使用桥接程序，必须在私密终端中手动输入。 完成私密登录后，OpenClaw 只会在保留的非机密后续流程中，将 auth login 改为 auth status；返回的后续流程会恢复相同的项目范围 onboard 流程以及明确的本地依赖项覆盖设置。 OpenClaw Skill 和 CreatorCut CLI 必须从同一个经过验证的发布归档安装。不匹配的旧版 Skill 会在访问项目之前安全失败；在匹配的 Skill 发布到 ClawHub 之前，请从同一个经过验证的发布归档重新安装。 next_suggested 仅用于显示；仍需用户输入时会使用占位符。随时运行相同的命令，即可从第一个未完成阶段继续。

如果项目由 v0.2.1 创建，v0.3.0 要求先显式执行一次元数据接管，然后才能运行状态或修改命令：

creatorcut project adopt-public \
  --project /path/to/project.creatorcut \
  --confirm-local

此操作会验证现有公开历史记录，并且只写入本地权限元数据。它不会调用实验性的内部项目迁移。--confirm-local 还表示确认所有 v0.2.1 CreatorCut 进程均已退出，且没有旧版预览、Director 请求、导出或转录任务仍在进行。接管后，请勿在 v0.2.1 中同时打开该项目。已完成的旧版生成资产、预览和转录内容会原样保留，不纳入元数据备份、摘要计算或回滚删除范围。对于 Windows v0.2.1 生成的资产路径，系统会验证但不会改写其存储字节；不支持在接管前将此类项目移至 POSIX 主机进行路径转换。 项目状态必须位于本地文件系统中，并支持同卷原子重命名以及可靠的 SQLite／操作系统文件锁定；FAT/exFAT、网络共享和云同步虚拟文件系统均不支持作为 v0.3 项目位置。

请参阅支持的平台，了解 macOS、Ubuntu、Windows、架构和依赖项的确切要求。

当前状态

AgentMesh-CreatorCut M1 Cycle 1–5 已完成，并已通过签名托管安装渠道提供稳定公开版本。已激活的确切版本和构件由签名的 AgentMesh Core 策略以及 release/production-smoke-lock.json 记录。Director 主功能已开放生产云端准入，AgentMesh Core 的权威价格为 50 credits。本仓库包含冻结的公开 Protocol v1，以及可从源码构建的本地运行时、Director 验证代码、跨平台安全凭证适配器、稳定的 JSON CLI、公开 MCP 服务、语义卡片／文本呈现适配器、本地媒体导入、中文／英文／混合语言 whisper.cpp 转录、本地 Manifest 预览／应用／撤销／重做，以及可续传导出。

v0.3.0 增加了绑定摘要／Generation 的公开变更恢复，以及经过验证的 v0.2.1 公共项目接入。在原生打包、安装、平台和恢复门槛全部完成之前，内部项目迁移和回滚仍处于禁用状态。

Batch 3 现已包含独立的 creatorcut-operations/1.0 契约、不可变的 *_ref 解析、由真实 Server 生成的签名 remove_range 夹具、完整的已公布操作测试矩阵、Codex MCP App 代码、公开 OpenClaw Skill、通用文本夹具提交，以及命名会话／Generation／预览／导出恢复测试。

针对 M1 支持矩阵，Cycle 3 已完成：真实 Codex 原生呈现与提交门禁、真实 OpenClaw Skill 运行、通用文本回退，以及四点恢复矩阵均已通过，使用的是同一固定夹具和 AnswerSet 摘要。Claude Code 延后至 M1 后的兼容性迭代，不属于 M1 支持或发布测试的宿主。其源码预览仍位于 skills/claude-code，但不包含在支持声明中。

Cycle 4 增加了托管安装程序和签名发布链。Cycle 5 完成了真实的 GitHub RC／稳定版标签和规范归档、暂存环境签名 Manifest、原色三素材 dogfood、生产环境暗色部署、经批准的 50-credit 付费金丝雀／回滚、持久化的 Core 稳定版 ReleaseManifest，以及通过真实 Server／Core 预检完成的正式公开渠道全新安装。

公开仓库是发布载体；可用性、准入权限以及 Director 的权威价格 50 credits 仍由 AgentMesh Core 控制。

产品边界

AgentMesh-CreatorCut (public, local execution)
  -> creatorcut-server (private Director strategy)
  -> agentmesh-core (identity, entitlements, price and credits)

CreatorCut 是内部 Studio／dogfood 源码。creatorcut-server 负责卡片编排、语义编辑策略、签名计划生成和计费恢复。agentmesh-core 仍是共享控制平面和价格来源。本产品不依赖 AgentMesh360-Client。

请参阅系统边界，了解数据和信任模型。

开发

要求：

• Node 24
• pnpm 10

pnpm install
pnpm verify
pnpm protocol:digest
pnpm pack:protocol

pnpm protocol:digest 会打印私有使用方必须固定使用的稳定摘要。 pnpm pack:protocol 会构建独立可用的协议 tarball，供私有服务在此预发布阶段使用。

完成源码构建后，可以使用 Node 24 调用开发 CLI：

node apps/cli/dist/src/main.js doctor

本地专用的媒体路径可用于开发验证：

node apps/cli/dist/src/main.js media import \
  --project /path/to/demo.creatorcut \
  --source /path/to/recording.mov

node apps/cli/dist/src/main.js transcribe start \
  --project /path/to/demo.creatorcut \
  --model /path/to/ggml-model.bin \
  --language mixed

node apps/cli/dist/src/main.js export start \
  --project /path/to/demo.creatorcut \
  --output /path/to/demo.mp4

支持 zh、en、auto 和 mixed 转录模式。mixed 模式会运行本地 auto、中文和英文候选，并选出最佳双语结果。除非已签名的 Manifest 明确要求进行受支持的更改，否则本地编辑会保留原始音频。应用已签名的 Manifest 需要提供 edit preview 返回的准确确认令牌；除非指定 --confirm-overwrite，否则导出不会覆盖已有文件。

远程 Director 命令有意要求提供 AgentMesh API 密钥，该密钥由 creatorcut auth login 存储在 macOS Keychain、Windows DPAPI 或 Linux Secret Service 中；还要求提供由受信任恢复根密钥签名的 Director 密钥集、明确指定的端点以及固定的协议包摘要。官方托管安装程序会配置固定的公共生产信任包。源码构建不会附带凭据、静默选择 staging，也不会绕过该信任配置。

独立的本地 MCP 包请参阅 MCP 分发。

请参阅 Agent 入门指南、隐私协议和托管发布策略。Cycle 4 的确切范围和验证记录见 Cycle 4 收尾证据。

AgentMesh360 产品矩阵的一部分

本产品属于 AgentMesh360 产品矩阵，一个账号即可驱动多个垂直领域 AI Agent。

产品	仓库	网站
AgentMesh-JobAgent — 面向中国招聘平台的 AI 求职 Agent	jiyangnan/AgentMesh-JobAgent	jobagent.agentmesh360.com
AgentMesh-CreatorCut — 面向口播和产品录制内容的 AI 后期制作	jiyangnan/AgentMesh-CreatorCut	creatorcut.agentmesh360.com
AgentMesh-Lecturecast — Agent 式课程视频制作	jiyangnan/AgentMesh-Lecturecast	lecturecast.agentmesh360.com
AgentMesh-Runtime — 本地 AI Agent 记忆与恢复	jiyangnan/AgentMesh-Runtime	runtime.agentmesh360.com
AgentMesh-Deploy-Agent — 开源部署运维 Agent	jiyangnan/AgentMesh-Deploy-Agent	deploy.agentmesh360.com
AgentMesh-OfficialRecruitment — 官方职业网站申请工作区	jiyangnan/AgentMesh-OfficialRecruitmentAgent	recruit.agentmesh360.com

许可证

Apache-2.0。详见 LICENSE。