chore(release): 0.5.0

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Haruhiyuki

.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "vision-mcp",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Vision-MCP plugins — 桌面 GUI 操作的性能 / 长期成本优化层",
   "owner": {
     "name": "Haruhiyuki",
@@ -11,7 +11,7 @@
       "name": "vision-mcp",
       "description": "Vision-MCP: 让 Agent 在使用桌面软件时沉淀指令化操作方法的框架（macOS + Windows）",
       "source": "./",
-      "version": "0.4.1",
+      "version": "0.5.0",
       "keywords": [
         "mcp",
         "vision",

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "vision-mcp",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Vision-MCP: 视觉为主的桌面 GUI 操作 MCP server + Skill。Agent 可像人一样使用真实桌面应用（截图 → 视觉/AX 双轨识别 → click/type/key），支持持续修正 + 安全审批。",
   "author": {
     "name": "Vision-MCP Authors",

packages/cli/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @vision-mcp/cli
 
+## 0.5.0
+
+### Minor Changes
+
+- `saveMap` 增量改：基于原 yaml Document 写回，保留**注释 / 字段顺序 / 手编格式**。
+
+  之前 `commit_state` / `commit_workflow` / `harvest_session` 每次 save 都把手编 yaml 整文件重写，注释丢失、字段顺序乱、zod default 字段（`kind: control` / `risk_level: safe` 等）到处注入污染。
+
+  新方案：
+
+  - `loadMap` 用 `YAML.parseDocument` 保留原 doc source，随 `MapLoadResult.baselineDoc` 返回
+  - `AppHandle` 携带 baselineDoc；`writeEffective` 走增量路径
+  - `applyJsToDoc` 递归算法：原 doc 已有的 leaf path → `setIn` 更新；原 doc 没有的字段 → **跳过**（zod default 注入不会污染）；数组 → 重叠部分递归 update，超出追加，缩短截断
+  - 短标量数组（≤ 8 元素）保 inline flow style
+
+  实测保真：round-trip 自身收敛、注释 / 字段顺序 / 其他字段完全保留、harvest 加 workflow 仅 14 行 diff 全是新增内容。已知限制：首次 save 从 hand-edited 状态一次性规范化（之后稳定）。
+
+### Patch Changes
+
+- Updated dependencies
+  - @vision-mcp/core@0.5.0
+  - @vision-mcp/server@0.5.0
+
 ## 0.4.1
 
 ### Patch Changes

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vision-mcp/cli",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Vision-MCP CLI：视觉为主的桌面 GUI 操作 MCP server + 工具集（init / serve / capsule / snapshot / patch / install-helper 等）",
   "keywords": [
     "mcp",
@@ -41,8 +41,8 @@
     "prepublishOnly": "node ./scripts/prepublish.mjs"
   },
   "dependencies": {
-    "@vision-mcp/core": "^0.4.1",
-    "@vision-mcp/server": "^0.4.1",
+    "@vision-mcp/core": "^0.5.0",
+    "@vision-mcp/server": "^0.5.0",
     "yaml": "^2.7.0"
   },
   "repository": {

packages/core/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @vision-mcp/core
 
+## 0.5.0
+
+### Minor Changes
+
+- `saveMap` 增量改：基于原 yaml Document 写回，保留**注释 / 字段顺序 / 手编格式**。
+
+  之前 `commit_state` / `commit_workflow` / `harvest_session` 每次 save 都把手编 yaml 整文件重写，注释丢失、字段顺序乱、zod default 字段（`kind: control` / `risk_level: safe` 等）到处注入污染。
+
+  新方案：
+
+  - `loadMap` 用 `YAML.parseDocument` 保留原 doc source，随 `MapLoadResult.baselineDoc` 返回
+  - `AppHandle` 携带 baselineDoc；`writeEffective` 走增量路径
+  - `applyJsToDoc` 递归算法：原 doc 已有的 leaf path → `setIn` 更新；原 doc 没有的字段 → **跳过**（zod default 注入不会污染）；数组 → 重叠部分递归 update，超出追加，缩短截断
+  - 短标量数组（≤ 8 元素）保 inline flow style
+
+  实测保真：round-trip 自身收敛、注释 / 字段顺序 / 其他字段完全保留、harvest 加 workflow 仅 14 行 diff 全是新增内容。已知限制：首次 save 从 hand-edited 状态一次性规范化（之后稳定）。
+
 ## 0.4.1
 
 ### Patch Changes

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vision-mcp/core",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Vision-MCP 核心库：数据模型、Capsule、Runtime、Repair、Locator、Trace",
   "type": "module",
   "main": "./dist/index.js",

packages/server/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @vision-mcp/server
 
+## 0.5.0
+
+### Minor Changes
+
+- `saveMap` 增量改：基于原 yaml Document 写回，保留**注释 / 字段顺序 / 手编格式**。
+
+  之前 `commit_state` / `commit_workflow` / `harvest_session` 每次 save 都把手编 yaml 整文件重写，注释丢失、字段顺序乱、zod default 字段（`kind: control` / `risk_level: safe` 等）到处注入污染。
+
+  新方案：
+
+  - `loadMap` 用 `YAML.parseDocument` 保留原 doc source，随 `MapLoadResult.baselineDoc` 返回
+  - `AppHandle` 携带 baselineDoc；`writeEffective` 走增量路径
+  - `applyJsToDoc` 递归算法：原 doc 已有的 leaf path → `setIn` 更新；原 doc 没有的字段 → **跳过**（zod default 注入不会污染）；数组 → 重叠部分递归 update，超出追加，缩短截断
+  - 短标量数组（≤ 8 元素）保 inline flow style
+
+  实测保真：round-trip 自身收敛、注释 / 字段顺序 / 其他字段完全保留、harvest 加 workflow 仅 14 行 diff 全是新增内容。已知限制：首次 save 从 hand-edited 状态一次性规范化（之后稳定）。
+
+### Patch Changes
+
+- Updated dependencies
+  - @vision-mcp/core@0.5.0
+
 ## 0.4.1
 
 ### Patch Changes

packages/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vision-mcp/server",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Vision-MCP MCP Server：暴露 capsule.* / vision_map.* tools 与 vision-mcp:// resources（stdio transport）",
   "keywords": [
     "mcp",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
-    "@vision-mcp/core": "^0.4.1",
+    "@vision-mcp/core": "^0.5.0",
     "zod": "^3.24.1"
   },
   "repository": {