Polish bilingual documentation for v0.1.1

Author: Aoike123

.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "blender-vse",
   "displayName": "Blender VSE Control",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local, revision-safe control of editable Blender VSE projects with one Skill and a four-tool MCP server.",
   "author": {
     "name": "Aoike",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "blender-vse",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local, revision-safe control of editable Blender VSE projects through one Skill and four MCP tools.",
   "author": {
     "name": "Aoike",

CHANGELOG.md

@@ -2,21 +2,36 @@
 
 [Chinese version](CHANGELOG_zh-CN.md)
 
+## 0.1.1 - 2026-09-04
+
+- Rewrote all 25 English/Chinese documentation pairs for clear, natural prose
+  while preserving commands, contracts, and safety boundaries.
+- Standardized terminology for revisions, observation IDs, targeted reads,
+  operation catalogs, allowlists, Agent hosts, and proxy media.
+- Fixed Markdown emphasis boundaries and added contract checks for emphasis,
+  heading spacing, and fenced code blocks.
+- Replaced the English and Chinese social-preview taglines with concise,
+  reader-friendly copy and regenerated the verified image assets.
+- Corrected documentation examples and claims for `set_text`, new project
+  paths, the GUI smoke workflow, and persistence verification.
+
 ## 0.1.0 - 2026-09-04
 
-- Repositioned the project around local, revision-safe agent editing of
-  persistent `.blend` timelines, with bounded context as a supporting guarantee.
-- Expanded package and plugin discovery metadata for Blender VSE, AI video
-  editing, MCP, NLE, agent Skills, revision safety, and local-first workflows.
-- Fixed the public GUI smoke workflow to pass the observed strip name required
-  by `set_text` while retaining the stable strip ID for follow-up reads.
+- Reframed the project as a local, revision-safe agent editor for persistent
+  `.blend` timelines, with bounded context as a supporting guarantee rather
+  than the product category itself.
+- Expanded the package and plugin discovery metadata to cover Blender VSE, AI
+  video editing, MCP, NLE, Agent Skills, revision safety, and local-first
+  workflows.
+- Corrected the public GUI smoke workflow so `set_text` receives the observed
+  strip name while follow-up reads continue to use the stable strip ID.
 - Added the missing distribution-content verification command to the release
   checklist.
-
-- Standalone Blender VSE control package and CLI.
+- Added a standalone Blender VSE control package and CLI.
 - Revision-safe read, patch, acknowledge, and verify workflow.
-- Four-tool local MCP server with explicit project-root authorization.
-- Low-context Agent Skill with bounded reads and resume capsules.
+- A four-tool local MCP server with explicit project-root authorization.
+- A context-efficient Agent Skill with bounded reads and resume capsules.
 - Codex, Claude Code, and DSH installation paths.
-- uv-managed Python 3.12 runtime bootstrap; no system Python required for plugin users.
+- A `uv`-managed Python 3.12 runtime bootstrap; plugin users do not need a
+  system Python installation.
 - Bilingual English and Chinese documentation.

CHANGELOG_zh-CN.md

@@ -2,19 +2,26 @@
 
 [English version](CHANGELOG.md)
 
+## 0.1.1 - 2026-09-04
+
+- 重写全部 25 组中英文文档，使两种语言都自然、清晰，同时保留命令、契约和安全边界。
+- 统一修订、观察 ID、定向读取、操作目录、允许列表、Agent 宿主和代理媒体等术语。
+- 修复 Markdown 粗体边界，并新增粗体、标题间距和代码围栏的契约检查。
+- 采用更简洁、易读的中英文社交预览标语，并重新生成经过校验的图片资产。
+- 修正文档中关于 `set_text`、新项目路径、GUI 冒烟流程和持久化验证的示例与说明。
+
 ## 0.1.0 - 2026-09-04
 
-- 统一定位为面向持久 `.blend` 时间线的本地、修订安全 Agent 剪辑；有界上下文作为
-  支撑保证，不再作为产品类别本身。
-- 扩展包与插件的发现关键词，覆盖 Blender VSE、AI 视频编辑、MCP、NLE、Agent Skill、
-  修订安全与本地优先工作流。
-- 修复公开 GUI 冒烟流程：`set_text` 使用已观察到的片段名，后续读取仍使用稳定片段 ID。
+- 将项目重新定位为面向持久 `.blend` 时间线、具备修订保护的本地 Agent 剪辑控制层；
+  有界上下文是配套保证，而非产品类别本身。
+- 扩充包和插件的检索元数据，覆盖 Blender VSE、AI 视频编辑、MCP、NLE、Agent Skill、
+  修订保护和本地优先工作流。
+- 修复公开 GUI 冒烟流程：`set_text` 传入观察到的片段名称，后续读取仍使用稳定片段 ID。
 - 在发布清单中补充缺失的分发内容校验命令。
-
-- 独立 Blender VSE 控制包与 CLI。
+- 新增独立的 Blender VSE 控制包和 CLI。
 - 带修订保护的 read、patch、acknowledge 与 verify 工作流。
-- 具有显式项目根目录授权的四工具本地 MCP 服务。
-- 使用有界读取与恢复胶囊的低上下文 Agent Skill。
-- Codex、Claude Code 与 DSH 安装路径。
-- uv 管理的 Python 3.12 运行时；插件用户无需系统 Python。
-- 独立英文与中文文档。
+- 提供明确项目根目录授权的四工具本地 MCP 服务。
+- 通过有界读取和恢复胶囊节省上下文的 Agent Skill。
+- Codex、Claude Code 和 DSH 安装方式。
+- 由 `uv` 管理的 Python 3.12 运行时引导；插件用户无需安装系统 Python。
+- 相互独立的中英文文档。

CODE_OF_CONDUCT.md

@@ -4,7 +4,8 @@
 
 Be respectful, constructive, and specific. Harassment, discrimination, threats,
 and publication of private information are not acceptable. Maintainers may
-remove abusive content or participation to keep the project safe and useful.
+remove abusive content or restrict participation to keep the project safe and
+useful.
 
 When disagreeing, focus on observable behavior, reproducible evidence, and the
 trade-offs of a proposed change.

CODE_OF_CONDUCT_zh-CN.md

@@ -2,6 +2,6 @@
 
 [English version](CODE_OF_CONDUCT.md)
 
-请保持尊重、建设性和具体。骚扰、歧视、威胁以及公开他人隐私信息均不可接受。维护者可以移除滥用性内容或终止相关参与，以维护项目的安全与实用性。
+请以尊重、建设性且具体的方式参与交流。骚扰、歧视、威胁和公开他人隐私信息均不可接受。为维护项目的安全与实用性，维护者可以移除滥用性内容或限制相关人员参与。
 
-发生分歧时，请聚焦可观察行为、可复现证据以及拟议变更的取舍。
+出现分歧时，请聚焦可观察的行为、可复现的证据，以及拟议变更所涉及的取舍。

CONTRIBUTING.md

@@ -3,7 +3,7 @@
 [Chinese version](CONTRIBUTING_zh-CN.md)
 
 Contributions are welcome. Keep the package independent of agent frameworks,
-production databases, downloaders, and media providers.
+production data stores, downloaders, and media providers.
 
 ## Development setup
 
@@ -13,21 +13,22 @@ python -m pip install -e ".[dev]"
 python tests/run.py fast
 ```
 
-The fast gate is the normal inner loop and has a three-second target. Run
-`python tests/run.py list` before choosing a Blender profile.
+The `fast` gate is the normal development loop and is designed to finish within
+three seconds. Run `python tests/run.py list` before selecting a Blender
+profile.
 
 ## Where a change belongs
 
 - Public API and collaboration policy: `src/blender_vse/api.py`
 - Operation names and classification: `src/blender_vse/catalog.py`
-- Fixed bpy templates: `src/blender_vse/blender/vse_ops.py`
+- Fixed `bpy` operation templates: `src/blender_vse/blender/vse_ops.py`
 - Execution and session policy: `src/blender_vse/blender/runner.py` and
   `live_session.py`
-- Serialized contracts: `src/blender_vse/schemas`
+- Serialized data contracts: `src/blender_vse/schemas`
 - Context views and budgets: `src/blender_vse/context.py` and
   `context-policy.json`
-- Compaction capsule construction: `src/blender_vse/resume.py`
-- MCP tool and authorization boundary: `src/blender_vse/mcp`
+- Context-compaction capsules: `src/blender_vse/resume.py`
+- MCP tools and authorization boundaries: `src/blender_vse/mcp`
 - Agent workflow and generated command index: `skills/blender-vse`
 - Local plugin metadata and launch contract: `.codex-plugin/plugin.json` and
   `.mcp.json`
@@ -38,32 +39,33 @@ The fast gate is the normal inner loop and has a three-second target. Run
 
 ## Change checklist
 
-1. Add a focused unit or contract regression first.
-2. Keep new bpy operations fixed and type/JSON encoded; never expose arbitrary
-   Python.
-3. Register each public operation in exactly one catalog family and update the
-   edit-command Schema.
-4. Keep bounded read output within the machine-readable context policy; never
-   introduce a zero-progress cursor.
-5. Add real Blender coverage only where a host-side test cannot prove behavior.
-6. Keep the public smoke profile small; register broader scripts in
-   `blender-full`.
+1. Start with a focused unit or contract regression test.
+2. Keep new `bpy` operations fixed, typed, and JSON-encoded; never expose
+   arbitrary Python.
+3. Register every public operation in exactly one catalog family, and update
+   the edit-command schema.
+4. Keep bounded-read output within the machine-readable context policy, and
+   never introduce a cursor that makes no progress.
+5. Add coverage against real Blender only when a host-side test cannot establish
+   the behavior.
+6. Keep the public smoke profile small; put broader scripts in `blender-full`.
 7. Run `python tests/run.py fast` and `python tests/run.py coverage`.
-8. After command-signature changes, run
+8. After changing a command signature, run
    `python skills/blender-vse/scripts/generate_command_index.py` and commit the
    generated index.
-9. Update public docs and `CHANGELOG.md` when behavior changes.
+9. When behavior changes, update the public documentation and both
+   `CHANGELOG.md` and `CHANGELOG_zh-CN.md`.
 
-Changes to plugin metadata or the stdio launch command must also run
-`python tests/run.py plugin` and the active Codex installation's bundled
-`plugin-creator` validator.
+Changes to plugin metadata or the stdio launch command also require
+`python tests/run.py plugin` and the `plugin-creator` validator bundled with the
+active Codex installation.
 
 Changes to context budgets, compaction state, observation transitions, or Skill
-recovery rules must run `python tests/run.py stateful` and update the model-ready
-scenario corpus when behavior intentionally changes.
+recovery rules require `python tests/run.py stateful`. If behavior changes
+intentionally, update the model-ready scenario corpus as well.
 
-Pull requests that touch session identity, persistence, checkpoint restore,
-proxy validation, or direct-mutation policy should also run
+Pull requests that affect session identity, persistence, checkpoint restore,
+proxy validation, or the direct-mutation policy should also run
 `python tests/run.py blender-smoke` on a visible desktop Blender installation.
 
 See [Testing](docs/testing.md) for profile boundaries and safety rules.

CONTRIBUTING_zh-CN.md

@@ -2,7 +2,7 @@
 
 [English version](CONTRIBUTING.md)
 
-欢迎贡献。请保持本包独立于 Agent 框架、生产数据库、下载器和媒体服务商。
+欢迎贡献。请勿让本包依赖 Agent 框架、生产数据存储、下载器或媒体服务商。
 
 ## 开发环境
 
@@ -12,18 +12,19 @@ python -m pip install -e ".[dev]"
 python tests/run.py fast
 ```
 
-`fast` 是日常内部循环，目标为三秒。选择 Blender 档位前先运行 `python tests/run.py list`。
+`fast` 是日常开发循环，目标耗时不超过三秒。选择 Blender 档位前，请先运行
+`python tests/run.py list`。
 
 ## 变更应放在哪里
 
 - 公开 API 与协作策略：`src/blender_vse/api.py`
 - 操作名称与分类：`src/blender_vse/catalog.py`
-- 固定 bpy 模板：`src/blender_vse/blender/vse_ops.py`
+- 固定的 `bpy` 操作模板：`src/blender_vse/blender/vse_ops.py`
 - 执行与会话策略：`src/blender_vse/blender/runner.py` 和 `live_session.py`
-- 序列化契约：`src/blender_vse/schemas`
+- 序列化数据契约：`src/blender_vse/schemas`
 - 上下文视图与预算：`src/blender_vse/context.py` 和 `context-policy.json`
-- 压缩胶囊构建：`src/blender_vse/resume.py`
-- MCP 工具及授权边界：`src/blender_vse/mcp`
+- 上下文压缩胶囊：`src/blender_vse/resume.py`
+- MCP 工具和授权边界：`src/blender_vse/mcp`
 - Agent 工作流与生成的命令索引：`skills/blender-vse`
 - 本地插件元数据与启动契约：`.codex-plugin/plugin.json` 和 `.mcp.json`
 - 确定性插件归档：`scripts/build_plugin.py`
@@ -33,20 +34,24 @@ python tests/run.py fast
 
 ## 变更检查清单
 
-1. 先添加聚焦的单元或契约回归测试。
-2. 新增 bpy 操作必须固定、类型化并经过 JSON 编码；禁止暴露任意 Python。
-3. 每个公开操作只登记到一个目录功能族，并更新编辑命令 Schema。
-4. 有界读取必须符合机器可读上下文策略，绝不能产生零进度游标。
-5. 只有宿主侧测试无法证明行为时才增加真实 Blender 覆盖。
-6. 公开冒烟档位保持精简；更广的脚本登记到 `blender-full`。
+1. 先添加一个聚焦的单元或契约回归测试。
+2. 新增 `bpy` 操作必须固定、类型化并经过 JSON 编码；禁止暴露任意 Python。
+3. 每个公开操作只能登记到操作目录中的一个功能族，并同步更新编辑命令 Schema。
+4. 有界读取的输出必须符合机器可读的上下文策略，且绝不能产生无法推进的游标。
+5. 只有宿主侧测试无法证明相关行为时，才添加真实 Blender 覆盖。
+6. 保持公开冒烟档位精简；覆盖范围更广的脚本应登记到 `blender-full`。
 7. 运行 `python tests/run.py fast` 与 `python tests/run.py coverage`。
-8. 命令签名变化后运行 `python skills/blender-vse/scripts/generate_command_index.py`，并提交生成的索引。
-9. 行为变化时更新公开文档与 `CHANGELOG.md`、`CHANGELOG_zh-CN.md`。
+8. 命令签名发生变化后，运行 `python skills/blender-vse/scripts/generate_command_index.py`，
+   并提交生成的索引。
+9. 行为发生变化时，更新公开文档以及 `CHANGELOG.md` 和 `CHANGELOG_zh-CN.md`。
 
-修改插件元数据或 stdio 启动命令时，还必须运行 `python tests/run.py plugin` 以及当前 Codex 安装附带的 `plugin-creator` 校验器。
+修改插件元数据或 stdio 启动命令时，还必须运行 `python tests/run.py plugin`，并使用当前
+Codex 安装附带的 `plugin-creator` 校验器。
 
-修改上下文预算、压缩状态、观察状态转换或 Skill 恢复规则时，必须运行 `python tests/run.py stateful`；若行为有意变化，还要更新面向模型的场景语料。
+修改上下文预算、压缩状态、观察状态转换或 Skill 恢复规则时，必须运行
+`python tests/run.py stateful`；若行为是有意调整，还要更新面向模型的场景语料。
 
-涉及会话身份、持久化、检查点恢复、代理验证或直接修改策略的拉取请求，还应在可见桌面 Blender 环境运行 `python tests/run.py blender-smoke`。
+涉及会话身份、持久化、检查点恢复、代理验证或直接修改策略的拉取请求，还应在可见的
+桌面 Blender 环境中运行 `python tests/run.py blender-smoke`。
 
-档位边界与安全规则见[测试指南](docs/testing_zh-CN.md)。
+有关档位边界和安全规则，请参阅[测试指南](docs/testing_zh-CN.md)。