Skip to content

Commit 92541a5

Browse files
committed
docs: align current BeatDesign capabilities
1 parent 4954941 commit 92541a5

5 files changed

Lines changed: 34 additions & 16 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,24 @@ All notable changes to BeatDesign are documented in this file.
44

55
## Unreleased
66

7+
### Added
8+
9+
- Image overlays in the local Editor, with UI and MCP controls for placement, size, opacity, rotation, fades, and replacement with any project-owned image Asset.
10+
- Four caption style presets plus per-cue text, timing, size, width, and vertical-position controls shared by the UI and MCP command path.
11+
- Japanese localization across the released application and public README.
12+
13+
### Changed
14+
15+
- Made new Canvas workflows start with a left-to-right layout and solid, unlabeled connectors while preserving users' saved manual arrangements.
16+
- Made Canvas prompt controls appear on card hover so they do not obstruct everyday workspace use.
17+
- Renamed the Editor side panel to the Agent-neutral Inspector and made it closable and reopenable.
18+
- Simplified BeatAPI key configuration to a clear empty field or full mask with one `Save settings` action.
19+
20+
### Fixed
21+
22+
- Prepared connected local and generated references through the shared upload bridge before remote generation so providers receive public HTTPS media URLs.
23+
- Made static video previews seek past common opening black frames.
24+
725
## [0.2.2] - 2026-09-03
826

927
### Added

‎README.ja.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ BeatDesignは、AI画像・動画制作のための独立したオープンソ
3232

3333
### 動画Editor
3434

35-
Canvasの結果をローカルTimelineへ送ります。トリミング、分割、移動、音声ミックス、SRT字幕の読み込み、AIによる別Takeの作成、プレビュー、ブラウザーでのMP4書き出しに対応します。
35+
Canvasの結果をローカルTimelineへ送ります。トリミング、分割、移動、音声ミックス、画像オーバーレイの配置と調整、SRT字幕のスタイル設定、AIによる別Takeの作成、プレビュー、ブラウザーでのMP4書き出しに対応します。
3636

3737
Studioは集中した生成画面を提供します。Assetsでは、読み込み済み・生成済みのファイルをCanvas、Editor、MCPから共通して利用できます。
3838

@@ -86,7 +86,7 @@ BeatDesignはProject、Asset、Canvas、生成、Editor操作をカバーする2
8686

8787
MCP Hostへ接続した後は、次のように依頼できます。
8888

89-
> 最新のBeatDesign Projectを開き、このClipをTimelineへ追加して字幕を読み込み、確認できるようにEditorを開いてください。
89+
> 最新のBeatDesign Projectを開き、このClipをTimelineへ追加し、ブランド画像のオーバーレイと字幕を調整して、確認できるようにEditorを開いてください。
9090
9191
## プラットフォーム互換性
9292

@@ -116,7 +116,7 @@ MCP Hostへ接続した後は、次のように依頼できます。
116116
- 画像・動画生成とStandard、Deep動画分析。
117117
- Canvas上の画像、動画、音声、生成、Timeline、テキストノード。
118118
- Studio、Canvas、Editor、MCPで共有されるProject Assets。
119-
- 画像、動画、音声、SRT字幕トラックに対応した非破壊Timeline編集。
119+
- 画像、動画、音声、移動可能な画像オーバーレイ、スタイル付きSRT字幕トラックに対応した非破壊Timeline編集。
120120
- WebCodecsとMediabunnyによるローカルプレビューとブラウザー上のH.264/AAC MP4書き出し。
121121
- 英語、中国語、日本語のインターフェース。
122122
- ローカルstdioとStreamable HTTP MCP Transport。

‎README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Drop in prompts, images, video, and audio. Connect nodes, branch ideas, compare
3232

3333
### Video Editor
3434

35-
Turn Canvas results into a local timeline. Trim, split, move, mix audio, import SRT captions, create alternate AI Takes, preview, and export MP4 in the browser.
35+
Turn Canvas results into a local timeline. Trim, split, move, mix audio, place and transform image overlays, style SRT captions, create alternate AI Takes, preview, and export MP4 in the browser.
3636

3737
Studio provides a focused generation surface. Assets keeps every imported and generated file available across Canvas, Editor, and MCP.
3838

@@ -86,7 +86,7 @@ BeatDesign exposes 26 local MCP tools for Projects, Assets, Canvas, generation,
8686

8787
After connecting your MCP host, you can ask:
8888

89-
> Open my latest BeatDesign project, add these clips to a timeline, import the subtitles, and leave the Editor open for review.
89+
> Open my latest BeatDesign project, add these clips to a timeline, place the logo overlay, adjust the subtitles, and leave the Editor open for review.
9090
9191
## Platform compatibility
9292

@@ -116,7 +116,7 @@ After connecting your MCP host, you can ask:
116116
- Image and video generation plus Standard and Deep video analysis.
117117
- Image, video, audio, generation, timeline, and text nodes on the Canvas.
118118
- Project Assets shared across Studio, Canvas, Editor, and MCP.
119-
- Non-destructive timeline editing with image, video, audio, and SRT caption tracks.
119+
- Non-destructive timeline editing with image, video, audio, movable image overlays, and styled SRT caption tracks.
120120
- Local preview and browser-side H.264/AAC MP4 export with WebCodecs and Mediabunny.
121121
- English, Chinese, and Japanese interfaces.
122122
- Local stdio and Streamable HTTP MCP transports.

‎README.zh-CN.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ BeatDesign 是一个独立、开源、本地优先的 AI 图片与视频创作
3232

3333
### 视频 Editor
3434

35-
把 Canvas 结果送入本地时间线。你可以裁剪、分割、移动、混合音频、导入 SRT 字幕、创建 AI 备选 Take,并在浏览器中预览和导出 MP4。
35+
把 Canvas 结果送入本地时间线。你可以裁剪、分割、移动、混合音频、放置和调整图片叠层、设置 SRT 字幕样式、创建 AI 备选 Take,并在浏览器中预览和导出 MP4。
3636

3737
Studio 提供更专注的单次生成入口。Assets 让导入和生成的文件在 Canvas、Editor 与 MCP 之间持续可用。
3838

@@ -86,7 +86,7 @@ BeatDesign 提供 26 个本地 MCP 工具,覆盖 Project、Asset、Canvas、
8686

8787
连接 MCP Host 后,可以直接提出这样的要求。
8888

89-
> 打开我最近的 BeatDesign 项目,把这些片段加入时间线,导入字幕,然后把 Editor 停在方便我检查的位置。
89+
> 打开我最近的 BeatDesign 项目,把这些片段加入时间线,放置品牌图片叠层,调整字幕,然后把 Editor 停在方便我检查的位置。
9090
9191
## 平台兼容性
9292

@@ -116,7 +116,7 @@ BeatDesign 提供 26 个本地 MCP 工具,覆盖 Project、Asset、Canvas、
116116
- 图片与视频生成,以及 Standard 和 Deep 视频分析。
117117
- Canvas 上的图片、视频、音频、生成、Timeline 和文本节点。
118118
- Studio、Canvas、Editor 与 MCP 共用的 Project Assets。
119-
- 支持图片、视频、音频和 SRT 字幕轨的非破坏式时间线编辑。
119+
- 支持图片、视频、音频、可移动图片叠层和带样式 SRT 字幕轨的非破坏式时间线编辑。
120120
- 使用 WebCodecs 与 Mediabunny 完成本地预览和浏览器端 H.264/AAC MP4 导出。
121121
- 英文、中文和日文界面。
122122
- 本地 stdio 与 Streamable HTTP MCP Transport。

‎docs/PRODUCT_PLAN_AND_STATUS.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
- 文档用途:给新加入的开发者、Codex、Claude Code 和其他 AI Agent 提供统一产品上下文
44
- 当前基线:BeatDesign v0.2 Phase 1 本地实现
5-
- 最后核对:2026-09-03
5+
- 最后核对:2026-09-04
66
- 事实边界:只有代码、测试和本文“已完成”栏目共同证明的能力才算完成;规划项不等于已发布
7-
- 发布状态:v0.2.2 发布候选已完成干净安装、工程、MCP、宿主包与本地路由验证;GitHub Release 与第三方市场审核仍按各自状态单独记录
7+
- 发布状态:v0.2.2 已发布;当前 `main` 在该版本之上继续包含 Canvas、Editor、MCP 与连接设置改进,尚未另行提升版本号。第三方市场审核仍按各自状态单独记录
88

99
## 1. BeatDesign 是什么
1010

@@ -112,17 +112,17 @@ Codex / Claude Code / Other Agent
112112
- 非破坏式 trim、split、move、delete 和 ripple delete。
113113
- undo/redo。
114114
- 音量、静音、淡入和淡出。
115-
- 图片 Overlay 叠加,支持在预览中直接拖动,并可精确调整位置、宽度、透明度、旋转和淡入淡出;预览与 MP4 导出保持一致。
115+
- 图片 Overlay 叠加,支持在预览中直接拖动,并可精确调整位置、宽度、透明度、旋转和淡入淡出;可通过 UI 或 MCP 替换为当前 Project 内任意图片 Asset,同时保留原有时间与变换参数;预览与 MP4 导出保持一致。
116116
- 浏览器本地预览。
117117
- 选区派生 MP4。
118118
- BeatAPI 选区 AI redo。
119119
- Redo 结果作为 Take 保存、激活和恢复 Original。
120120
- 完整 Timeline H.264/AAC MP4 导出。
121-
- 字幕在 Overlay 之后绘制,确保字幕始终位于最终画面层;单条字幕可独立调整字号、最大宽度和垂直位置,UI 与 MCP 共用同一操作。
121+
- 字幕在 Overlay 之后绘制,确保字幕始终位于最终画面层;支持四种共享样式预设,单条字幕可独立调整文字、时间、字号、最大宽度和垂直位置,UI 与 MCP 共用同一操作。
122122
- 导出写回 Assets 和 Canvas Timeline Node。
123123
- 缺失素材、Clip 重叠和视频轨空隙诊断。
124124
- Editor 自动保存统一走 Command Kernel;并发写入使用 revision/CAS 和三方合并,不再用旧文档覆盖新版本。
125-
- 右侧栏是 Agent 中立的 Timeline Inspector,不内置或假装存在专有 Clip Agent;Codex、Claude Code、Cursor 等通用 Agent 通过 MCP 修改同一份 Timeline。
125+
- 右侧栏是可关闭、可重新打开且 Agent 中立的 Timeline Inspector,不内置或假装存在专有 Clip Agent;Codex、Claude Code、Cursor 等通用 Agent 通过 MCP 修改同一份 Timeline。
126126
- 同一次加入时间线使用稳定 Clip ID 和幂等键,重复点击、网络重试不会重复插入同一批 Clip。
127127
- Take 必须覆盖 Clip 时长;过短 Take 不可激活,诊断会阻止可能产生冻结尾帧的导出。
128128

@@ -144,7 +144,7 @@ Codex / Claude Code / Other Agent
144144
- Generation 的 `AssetFirstGenerationRequest` 已成为服务端权威输入:适配器媒体参数由 Asset ID 和当前 generation intent 编译,旧的客户端 URL 字段不再决定引用事实。
145145
- UI 命令入口不再接受客户端 `origin`;服务端固定写入 `ui`,MCP 入口在内核边界固定写入 `mcp`。
146146
- Provider Contract 已将逻辑模型目录与 BeatAPI effectId、上传路径和上游模型名拆开;BeatAPI 是默认实现,Fork 可在源码扩展点注册其他 Provider。
147-
- 本地 stdio MCP Server 提供 26 个工具(Project / Asset / Canvas / Generation / Editor),模型和参数通过 capability discovery 暴露;Canvas / Editor 增量操作使用完整 JSON Schema,Agent 可直接发现操作类型和参数。MCP 生成直接调用当前 Provider,本地产品不重复实现 API Key、余额、计费或限流策略,只透传 Provider 的结果与错误。`bdesign_project_target` 绑定当前会话项目,Project/Canvas/Editor view 工具返回 Codex Browser handoff;`bdesign_asset_import` 把本地文件导入项目 Asset 库;`bdesign_asset_extract_frame` 与 `bdesign_canvas_continue_from_tail` 负责抽帧续写;`bdesign_editor_import_srt` 导入字幕轨。
147+
- 本地 stdio MCP Server 提供 26 个工具(Project / Asset / Canvas / Generation / Editor),模型和参数通过 capability discovery 暴露;Canvas / Editor 增量操作使用完整 JSON Schema,Agent 可直接发现操作类型和参数。MCP 生成直接调用当前 Provider,本地产品不重复实现 API Key、余额、计费或限流策略,只透传 Provider 的结果与错误。`bdesign_project_target` 绑定当前会话项目,Project/Canvas/Editor view 工具返回 Codex Browser handoff;`bdesign_asset_import` 把本地文件导入项目 Asset 库;`bdesign_asset_extract_frame` 与 `bdesign_canvas_continue_from_tail` 负责抽帧续写;Editor MCP 可导入 SRT、放置和替换任意项目图片 Overlay,并调整叠层与单条字幕参数。
148148
- Codex、Claude Code 与 WorkBuddy 接入包内含 `beatdesign-workspace` Skill,负责项目选择、字幕/续写工具编排、付费生成停点和可视化复核;三者共用同一 MCP 与本地 Project 数据,其中 Claude Code 和 WorkBuddy 使用本机 HTTP MCP。
149149

150150
## 6. v0.2 Phase 1 本地已实现
@@ -159,7 +159,7 @@ Codex / Claude Code / Other Agent
159159
- Canvas -> Timeline Node -> Editor 连续工作流。
160160
- Editor 自动保存接入命令入口,并补齐冲突三方合并、重复操作保护和稳定播放头时间。
161161
- 图片 Clip、时间线拖拽调整持续时间与图片/视频统一视觉轨。
162-
- 本地 MCP Server 提供 26 个 Project、Asset、Canvas、Generation、Editor 工具;支持会话项目绑定、Canvas/Editor 可视化交接、从绝对路径导入本地素材、抽取尾帧续写,以及导入 SRT 字幕。
162+
- 本地 MCP Server 提供 26 个 Project、Asset、Canvas、Generation、Editor 工具;支持会话项目绑定、Canvas/Editor 可视化交接、从绝对路径导入本地素材、抽取尾帧续写、导入和精调 SRT 字幕,以及放置、替换和调整图片 Overlay。
163163
- MCP 增量 Canvas/Editor 命令在短暂 revision 竞争时会基于最新权威文档限次自动重放;持续冲突返回最新 revision 和明确重试提示。
164164
- Canvas 与 Editor 每 2 秒并在页面重新聚焦时检查 MCP 写入的新 revision。
165165

0 commit comments

Comments
 (0)