Skip to content

Commit 864090f

Browse files
committed
Release revision-safe Blender VSE positioning
1 parent 893fdc2 commit 864090f

22 files changed

Lines changed: 158 additions & 62 deletions

.claude-plugin/marketplace.json

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"name": "Aoike",
66
"url": "https://github.com/Aoike123"
77
},
8-
"description": "Editable Blender VSE control for local coding agents.",
8+
"description": "Revision-safe local control for editable Blender VSE projects.",
99
"plugins": [
1010
{
1111
"name": "blender-vse",
@@ -14,12 +14,21 @@
1414
"url": "https://github.com/Aoike123/blender-vse-control.git",
1515
"ref": "main"
1616
},
17-
"description": "Safely inspect, edit, recover, render, and verify local Blender VSE projects.",
17+
"description": "Safely inspect, edit, resume, render, and verify persistence for local Blender VSE projects.",
1818
"category": "Productivity",
1919
"tags": [
2020
"blender",
21+
"blender-vse",
22+
"vse",
2123
"video-editing",
22-
"mcp"
24+
"ai-video-editing",
25+
"nle",
26+
"mcp",
27+
"agent-skill",
28+
"codex",
29+
"claude-code",
30+
"revision-safe",
31+
"local-first"
2332
]
2433
}
2534
]

.claude-plugin/plugin.json

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"name": "blender-vse",
44
"displayName": "Blender VSE Control",
55
"version": "0.1.0",
6-
"description": "Low-context local Blender video editing with one focused Skill and a four-tool MCP server.",
6+
"description": "Local, revision-safe control of editable Blender VSE projects with one Skill and a four-tool MCP server.",
77
"author": {
88
"name": "Aoike",
99
"url": "https://github.com/Aoike123"
@@ -13,10 +13,17 @@
1313
"license": "AGPL-3.0-only",
1414
"keywords": [
1515
"blender",
16+
"blender-vse",
1617
"vse",
1718
"video-editing",
19+
"ai-video-editing",
20+
"nle",
1821
"mcp",
19-
"agent-skill"
22+
"agent-skill",
23+
"codex",
24+
"claude-code",
25+
"revision-safe",
26+
"local-first"
2027
],
2128
"skills": "./skills/",
2229
"mcpServers": "./clients/claude/mcp.json",

.codex-plugin/plugin.json

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "blender-vse",
33
"version": "0.1.0",
4-
"description": "Low-context local Blender video editing through one focused Skill and four-tool MCP server.",
4+
"description": "Local, revision-safe control of editable Blender VSE projects through one Skill and four MCP tools.",
55
"author": {
66
"name": "Aoike",
77
"url": "https://github.com/Aoike123"
@@ -11,17 +11,24 @@
1111
"license": "AGPL-3.0-only",
1212
"keywords": [
1313
"blender",
14+
"blender-vse",
1415
"vse",
1516
"video-editing",
17+
"ai-video-editing",
18+
"nle",
1619
"mcp",
17-
"stateful-agent"
20+
"agent-skill",
21+
"codex",
22+
"claude-code",
23+
"revision-safe",
24+
"local-first"
1825
],
1926
"skills": "./skills/",
2027
"mcpServers": "./.mcp.json",
2128
"interface": {
2229
"displayName": "Blender VSE Control",
23-
"shortDescription": "Low-context, focused Blender video editing",
24-
"longDescription": "A focused Blender video-editing Skill with bounded context, editable timelines, and revision-safe local execution. Pair it with creation Skills and enjoy the edit.",
30+
"shortDescription": "Revision-safe local Blender VSE editing for agents",
31+
"longDescription": "Let AI agents safely inspect, edit, resume, render, and verify persistence for local Blender VSE projects. Fresh observations, atomic patches, stale-base protection, and fresh-process verification preserve human changes while the .blend remains editable.",
2532
"developerName": "Aoike",
2633
"category": "Productivity",
2734
"capabilities": [
@@ -31,9 +38,9 @@
3138
],
3239
"websiteURL": "https://github.com/Aoike123/blender-vse-control",
3340
"defaultPrompt": [
34-
"Inspect this Blender VSE project and summarize its editable timeline.",
35-
"Continue editing this .blend safely from a fresh observation.",
36-
"Verify this Blender VSE project and report persistence warnings."
41+
"Inspect this named .blend VSE project and summarize its editable timeline.",
42+
"Apply these edits without silently overwriting human changes.",
43+
"Continue this Blender VSE project from a fresh observation and verify persistence."
3744
],
3845
"brandColor": "#E87D0D",
3946
"composerIcon": "./assets/icon.png",

.gitattributes

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
*.json text eol=lf
66
*.toml text eol=lf
77
*.yml text eol=lf
8+
*.yaml text eol=lf
89
*.in text eol=lf
910
.gitignore text eol=lf
1011
*.blend binary

CHANGELOG.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,16 @@
22

33
[Chinese version](CHANGELOG_zh-CN.md)
44

5-
## 0.1.0
5+
## 0.1.0 - 2026-09-04
6+
7+
- Repositioned the project around local, revision-safe agent editing of
8+
persistent `.blend` timelines, with bounded context as a supporting guarantee.
9+
- Expanded package and plugin discovery metadata for Blender VSE, AI video
10+
editing, MCP, NLE, agent Skills, revision safety, and local-first workflows.
11+
- Fixed the public GUI smoke workflow to pass the observed strip name required
12+
by `set_text` while retaining the stable strip ID for follow-up reads.
13+
- Added the missing distribution-content verification command to the release
14+
checklist.
615

716
- Standalone Blender VSE control package and CLI.
817
- Revision-safe read, patch, acknowledge, and verify workflow.

CHANGELOG_zh-CN.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,14 @@
22

33
[English version](CHANGELOG.md)
44

5-
## 0.1.0
5+
## 0.1.0 - 2026-09-04
6+
7+
- 统一定位为面向持久 `.blend` 时间线的本地、修订安全 Agent 剪辑;有界上下文作为
8+
支撑保证,不再作为产品类别本身。
9+
- 扩展包与插件的发现关键词,覆盖 Blender VSE、AI 视频编辑、MCP、NLE、Agent Skill、
10+
修订安全与本地优先工作流。
11+
- 修复公开 GUI 冒烟流程:`set_text` 使用已观察到的片段名,后续读取仍使用稳定片段 ID。
12+
- 在发布清单中补充缺失的分发内容校验命令。
613

714
- 独立 Blender VSE 控制包与 CLI。
815
- 带修订保护的 read、patch、acknowledge 与 verify 工作流。

README.md

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,13 @@
44

55
![Blender VSE Control — revision-safe editable timelines](assets/social-preview.png)
66

7-
> A low-context, focused Blender video-editing Skill. Install it, pair it with a
8-
> creation Skill, and enjoy the edit.
7+
> Let AI agents edit in Blender while the timeline stays visible, editable,
8+
> and under your control.
99
10-
A typed, revision-safe Python control layer for Blender's Video Sequence
11-
Editor. Applications and agents can edit the visible timeline while the
12-
`.blend` file remains the source of truth and manual edits remain protected.
10+
Blender VSE Control is a local, typed, revision-safe control layer for
11+
Blender's Video Sequence Editor. Applications and agents can inspect, edit,
12+
continue, render, and verify persistence for named `.blend` timelines while
13+
the file remains the source of truth and human changes stay protected.
1314

1415
> Status: alpha. Blender 5.1 is the primary verified target. The bundled bridge
1516
> declares Blender 4.2+ compatibility, but release claims are based only on
@@ -43,8 +44,9 @@ should not need to edit client manifests by hand.
4344
- **Atomic edits:** a command list commits one revision or rolls back.
4445
- **Visible collaboration:** interactive edits require a proven Blender GUI,
4546
project identity, VSE timeline, and preview.
46-
- **Recoverable output:** the `.blend` is canonical; final verification reopens
47-
it in a fresh Blender process.
47+
- **Persistence evidence:** final verification reopens the canonical `.blend`
48+
in a fresh Blender process and checks saved structural facts. It does not
49+
inspect frames or judge visual or creative correctness.
4850
- **Bounded surface:** callers select catalogued operations, never free-form
4951
Python.
5052
- **Bounded context:** reads default to summaries; range/detail pages disclose
@@ -142,11 +144,14 @@ rules are in [Testing](docs/testing.md).
142144

143145
## Project boundary
144146

145-
This repository owns Blender execution, timeline operations, revision safety,
146-
and persistence verification. It does not own downloaders, transcoders, proxy
147-
encoding, project-wide asset databases, or an agent framework. Those systems
148-
integrate through typed operations and the
149-
[external proxy manifest](src/blender_vse/schemas/proxy-manifest.schema.json).
147+
This repository owns Blender execution, allowlisted timeline operations,
148+
revision safety, and persistence verification. It validates externally
149+
generated [proxy manifests](src/blender_vse/schemas/proxy-manifest.schema.json)
150+
for attachment; it does not generate or source media, download or transcode
151+
media, encode or rebuild proxies, automate general Blender 3D work or arbitrary
152+
`bpy`, own a project-wide asset database, or provide an agent framework. Proxy
153+
attachment preserves the original source path, and final rendering still uses
154+
source media.
150155

151156
## License
152157

README_zh-CN.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@
44

55
![Blender VSE Control:具有修订保护的可编辑时间线](assets/social-preview_zh-CN.png)
66

7-
> 这是一个低上下文占用的、纯粹的blender视频编辑skill,安装它,搭配创作skill,开始享受你的剪辑
7+
> 让 AI Agent 在 Blender 中剪片,同时保持时间线可见、可编辑、由你掌控
88
9-
这是一个面向 Blender Video Sequence Editor 的类型化、带修订保护的 Python 控制
10-
层。应用程序或智能体可以与用户在可见时间线中协作,同时让 `.blend` 始终作为事实
11-
源,并保护人工修改不被静默覆盖
9+
Blender VSE Control 是面向 Blender Video Sequence Editor 的本地、类型化、修订安全
10+
工程控制层。应用程序或 Agent 可以检查、编辑、续作和渲染明确指定的 `.blend`
11+
时间线,并验证其持久化;文件始终是事实源,人工修改不会被静默覆盖
1212

1313
> 状态:Alpha。当前主要验证目标为 Blender 5.1。内置 Bridge 的元数据声明支持
1414
> Blender 4.2+,但正式兼容范围只以各版本发布说明中的实测结果为准。
@@ -35,7 +35,8 @@
3535
- **原子编辑:**一组命令只提交一个修订;失败时整体回滚。
3636
- **可见协作:**交互编辑前必须证明 Blender GUI、目标项目、VSE 时间线与预览均
3737
可用。
38-
- **可恢复结果:**`.blend` 是唯一事实源,最终验证会用新 Blender 进程重新打开。
38+
- **持久化证据:**最终验证会在新 Blender 进程中重新打开作为事实源的 `.blend`
39+
检查已保存的结构事实;它不会检查渲染帧,也不判断视觉或创意是否正确。
3940
- **有限操作面:**调用方只能选择登记过的操作,不能传入任意 Python。
4041
- **有界上下文:**读取默认只返回摘要;range/detail 通过分页和可选字段控制进入
4142
Agent 上下文的数据量;写入、验证与错误回执同样具有字节预算。
@@ -125,9 +126,11 @@ blender-vse verify ./projects/demo.blend
125126

126127
## 项目边界
127128

128-
本仓库负责 Blender 执行、时间线操作、修订安全与持久化验证;不负责下载、转码、
129-
代理编码、项目级资产数据库或特定智能体框架。外部系统通过类型化操作和
130-
[代理清单协议](src/blender_vse/schemas/proxy-manifest.schema.json)接入。
129+
本仓库负责 Blender 执行、白名单时间线操作、修订安全与持久化验证。它可以验证并
130+
附加外部生成的[代理清单](src/blender_vse/schemas/proxy-manifest.schema.json),但不生成
131+
或搜集源素材,不下载或转码媒体,不编码或重建代理,不自动化通用 Blender 3D 工作或
132+
任意 `bpy`,不维护项目级资产数据库,也不提供 Agent 框架。附加代理不会改变原始
133+
源路径,最终渲染仍使用源媒体。
131134

132135
## 许可证
133136

RELEASING.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@ python scripts/build_plugin.py --check
4646

4747
```bash
4848
python -m build
49+
python tests/verify_distribution.py dist
4950
```
5051

5152
- [ ] The source archive contains bilingual docs, tests, test-plan JSON,

RELEASING_zh-CN.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ python scripts/build_plugin.py --check
4040

4141
```bash
4242
python -m build
43+
python tests/verify_distribution.py dist
4344
```
4445

4546
- [ ] 源码归档包含中英文文档、测试、测试计划 JSON、许可证、已验证的 Skill 和生成的命令索引。

0 commit comments

Comments
 (0)