soundcraft-plugin
DSH 插件 soundcraft-plugin
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:full-aigc-plugins/soundcraft-plugin#324dbfc4214736933664c0b96b33d6d870217136DSH 插件 soundcraft-plugin
Soundcraft Plugin 以 soundcraft-plugin 发布，当前版本为 0.1.0-dev.20261019.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
This plugin belongs to AIGC content creation.
| Category | Marketplace | Purpose |
|---|---|---|
| Full-stack development | Full Stack Plugins | Architecture and UI design, code understanding, quality checks, code review, workflow governance, and server operations |
| AIGC content creation | Full AIGC Plugins | Image, video, audio, music, 3D, and multimodal content creation |
SoundCraft Use — audio editing with verified artifacts
Edit speech, music, and sound effects in one shared editor session, with explicit tracks, sample ranges, and checks that survive save and reopen.
English | 简体中文 · Install · Quick start · Skills · MCP tools · Limits
soundcraft lets an agent work on audio the way an editor does: inspect the session, select real tracks and clips, cut, fade, level, mix, export, then reopen the project and check what actually changed. It wraps the native SoundCraft engine and CLI in ten skills and one embedded editor, and keeps native execution, host rendering, and listening acceptance as separate claims.
This is an installable development candidate. Production promotion is blocked, the package is recorded as local-unreleased, and the recorded technical regressions use synthetic signals rather than a full creative acceptance.
| Property | Value |
|---|---|
| Plugin ID | soundcraft |
| Display name | SoundCraft Use |
| Version | 0.1.0-dev.20261018.5 |
| Stage | Installable development candidate, production promotion blocked |
| Native engine | SoundCraft 0.7.0 via soundcraft-cli |
| Marketplace | soundcraft-marketplace |
| License | Apache-2.0 |
npm install are needed at runtime.soundcraft-cli, which is not installed by this plugin. Query the actual version and command schema before running a recipe.wasm32 target, and a wasm-bindgen CLI matching Cargo.lock.codex plugin marketplace add partme-ai/full-aigc-plugins
codex plugin add soundcraft@full-aigc-plugins
The repository also ships its own marketplace metadata (soundcraft-marketplace) pinned to v0.1.0-dev.20261018.5. Restart the host, open a new task, and ask for a read-only session inspection first.
editor_status to report attached: true before editing. A successful tool response does not mean the page has rendered.Inspect: List tracks, clips, sample rate, and any selection I should not reuse.
Edit: Cut the Voice clip at 2 s and crossfade 50 ms on both sides.
Level: Match two speakers to the same perceived level without clipping.
Deliver: Bounce a 48 kHz 24-bit WAV and confirm its length and format.
Direct CLI form for file tasks, using one argv argument per method:
soundcraft-cli info input.wav
soundcraft-cli run --in session.scraft --cmd 'session.inspect={"detail":"full"}' --save out.scraft
| Workflow | Built-in path | Verifiable output |
|---|---|---|
| Clean up a podcast episode | soundcraft-podcast-cleanup | Edited speech, pauses, and loudness with a reopened project |
| Mix voice over music | soundcraft-voice-over-mix | Dialogue clarity and music bed checked as separate tracks |
| Level multiple speakers | soundcraft-dialogue-leveling | Per-speaker gain decisions and a clip-level recheck |
| Cut and join audio | soundcraft-audio-edit | Trim, join, and fades verified against source offsets |
| Shape a music demo | soundcraft-music-demo | Track balance, pan, and basic effects on editable clips |
| Deliver a format | soundcraft-audio-delivery | Sample rate, bit depth, naming, and decoded output |
| Preserve sync while gating silence | soundcraft-voice-silence-gaps | Visible gaps with later speech still on the original timeline |
| Repeat a short sound exactly | soundcraft-finite-audio-loop | Exact total count, sample length, and seam check |
| Work from a playbook | soundcraft-scenario-playbooks | Eight recipes with real methods, parameters, and checks |
| Skill | What it does |
|---|---|
soundcraft-editor | Open the real editor in an MCP Apps host or host browser and share one workspace session |
soundcraft-scenario-playbooks | Eight recipes for voice level, cut fades, interview quotes, stem delivery, reversed effects, DC offset, and polarity |
| Skill | What it does |
|---|---|
soundcraft-podcast-cleanup | Edit spoken content, pauses, and loudness for a podcast episode |
soundcraft-voice-over-mix | Balance narration against a music bed without losing intelligibility |
soundcraft-dialogue-leveling | Unify level and tonal continuity across several speakers |
| Skill | What it does |
|---|---|
soundcraft-audio-edit | Trim, join, and fade clips while checking source offsets |
soundcraft-music-demo | Balance multiple tracks, set pan, and apply basic effects |
soundcraft-audio-delivery | Choose sample rate and bit depth, name files, and verify the export |
| Skill | What it does |
|---|---|
soundcraft-voice-silence-gaps | Turn long low-level regions into visible gaps without shifting later dialogue |
soundcraft-finite-audio-loop | Repeat a short checked sound an exact number of times and expand it later |
.codex-plugin/mcp.json starts one stdio server, soundcraft-editor, from ui/bootstrap.mjs. The adapter adds three stable tools and passes through the pinned engine's command catalog.
| Tool | Purpose |
|---|---|
open_editor | Open the editor for an absolute workspace; the first call binds the workspace |
open_browser_editor | Return an editorUrl for the same session when the host has a built-in browser |
editor_status | Report whether the editor actually attached and is ready to accept edits |
Inside the session, the engine catalog in ui/catalog.lock.json provides list_commands, the execute wrapper, batch execution, session open/save, audio import, mix bounce, and UI automation tools. Query the live schema before calling; the skill recipes show the wrapper as execute {"command":"…","params":{…}}.
| Setting | Meaning |
|---|---|
${PLUGIN_ROOT} | Expanded by the portable plugin.json and mcp.json |
${CLAUDE_PLUGIN_ROOT} | Expanded by the Claude Code manifest and root .mcp.json |
CRAFT_EDITOR_UPDATE=off | Use the bundled editor only and skip the update query |
CRAFT_EDITOR_CACHE_DIR | Alternate absolute cache directory; default is ~/.cache/full-aigc/editors |
CRAFT_WORKSPACE_ROOT | Workspace root when the adapter is started directly |
CRAFT_PANEL_METADATA_FILE | Host panel metadata used by the ZCode and Claude Code entries |
flowchart LR
U[User] --> H[Agent host]
H --> S[10 skills]
S --> M[stdio MCP soundcraft-editor]
M --> E[Pinned editor engine]
E --> F[Editable .scraft project]
F --> B[Bounce and decode check]
S --> C[soundcraft-cli for file tasks]
C --> F
craft-exports/ under the workspace with new file names. Closing the MCP process ends the session, so save before you exit.| Symptom | Cause | What to do |
|---|---|---|
| You need separate mic tracks from one stereo file | 0.7.0 export does not isolate left and right content | This batch ships no track-splitting skill; do not treat track metadata as proof of separated audio |
| A mix sounds fine in the tool but wrong on playback | No real-material listening or loudness acceptance is recorded | Listen end to end and measure loudness yourself; session.audio_health only checks references |
| The embedded panel never appears | The host does not render MCP Apps | Use the open_browser_editor URL; a text result is not a rendered panel |
| Edits vanished after closing the tool | The session ended with the MCP process | Save the project before closing and reopen it to verify |
| The CLI and the open editor disagree | They are different states | Pick one path, save, and explicitly reopen in the other |
| First launch fails offline | A Git install needs the verified archive | Start online once, or install a complete release ZIP with bundled assets |
| Another host cannot load the plugin | Only Codex has recorded acceptance | Treat other hosts as unverified and report the exact host and version |
codex plugin marketplace upgrade full-aigc-plugins
codex plugin add soundcraft@full-aigc-plugins
The editor update is independent of the plugin version. editor_status reports the runtime source (download, cache, or bundled) and the version actually in use.
Open issues at https://github.com/full-aigc-plugins/soundcraft-plugin/issues. Include the engine and plugin version, the session mode (embedded editor or CLI), the method ID, the actual parameters, and the reopened-result evidence. Synthetic-signal regressions do not replace real-material listening.
Apache-2.0. The plugin bundles guidance and an editor build; the native engine and CLI remain external. Icon provenance and the MIT notice are recorded in assets/official-icon-source.json and the adjacent license file. See LICENSE.