写入工作区文件（sha256 OCC）

PUT /v1/workspace/files/:name

以原子方式替换工作区 Markdown 文件。必须传入 expected_sha256，即前一次 GET 返回的值（字符串）；创建全新文件时传入 null。不匹配会返回 409 并附带当前 sha，UI 可据此提供覆盖或重新加载选项。请求体上限为 256 KB；超出时返回 413。

请求体

{ "content": "# SOUL.md - Minara\n...", "expected_sha256": "deadbeef..." }

响应体

{ "ok": true, "data": { "name": "SOUL.md", "sha256": "cafef00d...", "size": 2048, "mtime": 1714493000000 } }

说明

乐观并发控制：网关会在写入前比较 expected_sha256 与磁盘上的 sha。未命中返回 409。原子写入经由 apps/agent/src/workspace/seed.ts::atomicWriteFile，它写入临时文件后再原子重命名，并在目标旁写入单槽 .bak 备份。