SoundCraft（音频处理）

口播清理、响度统一、混音与音频剪辑

版本：0.1.0-dev.20261019.1 · 许可证：Apache-2.0 · 技能：10 个 · MCP 服务：1 个

English · 安装 · 快速开始 · 项目结构

项目定位

口播清理、多人响度统一、配音混音、音频剪辑与循环拼接；按段落与静音区间处理，保持对时关系。

本插件属于内容创作线，面向需要直接得到可编辑成果、而不是一段脚本或图片的用户。

一眼看懂

素材 / 需求 / 旧稿
        │
        ▼
SoundCraft（音频处理） 技能（检查 → 计划 → 执行 → 回读）
        │
        ├── 原生 CLI / MCP 工具
        └── MCP 编辑器（浏览器内查看与局部调整）
        │
        ▼
可编辑工程 + 导出文件 + 复核结果

能力与边界

能力	说明	边界
检查	读取现有工程与素材状态	不修改未授权文件
创建	按目标生成可编辑结构	事实与素材需来自输入
编辑	局部修改并保留未涉及内容	修改后必须重新打开
导出	输出目标格式并核对	导出成功不等于版面正确
评审	按明确标准检查结果	不替代最终人工验收

架构与核心流程

宿主 / Agent
   │  调用技能
   ▼
skills/soundcraft-*  ──►  MCP 编辑器 / 原生 CLI
                              │
                              ▼
                     可编辑工程 + 导出
                              │
                              ▼
                     回读、检查、交付

原则：

1. 先只读检查，再计划，再执行。
2. 每次写入保留原件或可回退版本。
3. 导出后重新打开核对。
4. 不确定的结果标记为待核对，不自动重放。

兼容性

项目	状态
宿主	支持 MCP Apps 或内置浏览器的宿主
Node.js	24+（编辑器）
平台	以实际安装包与发行说明为准

安装

codex plugin marketplace add partme-ai/full-aigc-plugins
codex plugin add soundcraft@full-aigc-plugins

安装后重启宿主，先做只读检查。

快速开始

1. 确认目标、输入素材和交付格式。
2. 先检查现有工程，列出缺失项。
3. 执行一次有界修改。
4. 重新打开输出，核对结构与关键内容。
5. 完成视觉或内容复核后交付。

配置

变量	用途	默认
CRAFT_WORKSPACE_ROOT	编辑器绑定的工作区	当前项目
CRAFT_EDITOR_UPDATE	设为 off 跳过增强包下载	开启

不要在工程或配置中写入密钥、令牌和私有路径。

扩展契约

新增技能时应使用 soundcraft- 前缀，声明触发条件和边界，通过 MCP 或固定 CLI 操作真实工程，修改后重新打开核验。

重试、幂等与恢复

• 失败后先检查当前工程状态。
• 不自动重复已产生副作用的操作。
• 重试使用新输出路径并保留旧回执。

数据与状态

• 输入素材只读。
• 输出工程、导出文件和临时目录分开。
• 交付前确认文件可打开、内容完整。

安全

• 不把未授权素材上传到第三方服务。
• 敏感内容脱敏后再交付。
• 发现泄露先轮换凭据，再清理文件。

可观测性与运行

记录命令、输出文件、关键结构和复核结果；交付前至少检查一次真实输出。

开发与验证

node --test
python3 -m pytest

打包与发布

版本与清单、市场、tag 一致；ZIP 根目录为 soundcraft-plugin。

升级与迁移

升级前备份工程；旧版本文件保持可打开；迁移后重新检查结构和导出。

故障排查

现象	检查
打不开工程	文件完整性、版本兼容
编辑器空白	Node.js 版本与工作区权限
导出异常	字体、素材、输出路径
结果不一致	重新打开并核对

项目结构

soundcraft-plugin/
├── .zcode-plugin/      # ZCode 清单与 UI surface
├── skills/             # 10 个技能
├── ui/                 # MCP Apps 编辑器
├── commands/open.md    # 打开编辑器命令
├── docs/               # 架构与验证记录
└── assets/             # 图标与模板

贡献与支持

提交问题时附上插件版本、宿主、输入类型、命令、输出文件和预期结果。不要附敏感素材。

许可证

Apache-2.0，见 LICENSE。