更新文档(乐观锁)
gwl_update_documentUpdate a document's title, content, summary, folder, visibility, or permissions with version-based conflict detection and base-content merging to handle concurrent edits.
Instructions
更新文档:至少要提供一个可变字段(title/content/summary/icon/folder_id/permission_bits/visibility/owning),否则本工具直接报参数错误而不发请求。 并发安全:强烈建议先 gwl_get_document_by_id 拿到 version 并原样传入;版本不符返回 409,且 data 带 current_version / expected_version / editor_username。 base_content 表示「你准备改动的那份原文」,必须与 content 同时提供,服务端据此自动合并他人改动。 重复提交同样内容返回 msg=无变更(幂等)。revision_summary 是这次修订的说明。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"doc_id": "<doc_id>"
},
"name": "gwl_update_document"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| icon | No | ||
| title | No | ||
| doc_id | Yes | 文档 id(路径参数)。 | |
| owning | No | ||
| content | No | ||
| summary | No | ||
| version | No | 乐观锁基线版本;来自 gwl_get_document_by_id 的 version。省略=不做版本校验。 | |
| folder_id | No | 移动到指定文件夹(0=根目录)。 | |
| visibility | No | ||
| base_content | No | 准备改动的原文基线;必须与 content 同时提供。 | |
| permission_bits | No | ||
| revision_summary | No | 本次修订说明(写进修订历史),最多 200 个字符。 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||