59 lines
1.7 KiB
Python
59 lines
1.7 KiB
Python
|
import os
|
|||
|
|
|
|||
|
|
path = '/Users/shenlan/workspaces/cloud-neutral-toolkit/xworkmate-bridge/docs/api-reference.md'
|
|||
|
|
with open(path, 'r') as f:
|
|||
|
|
content = f.read()
|
|||
|
|
|
|||
|
|
content = content.replace(
|
|||
|
|
'HTTP 与 WebSocket 统一使用 JSON-RPC 2.0 结构：',
|
|||
|
|
'HTTP 与 WebSocket 统一使用 **JSON-RPC 2.0** 作为默认通信协议。为了兼容旧版 XWorkmate APP，所有的响应报文均采用混合模式（Hybrid Mode），同时包含 JSON-RPC 2.0 字段与 legacy 扩展字段：'
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
new_rpc_example = '''成功响应：
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"jsonrpc": "2.0",
|
|||
|
|
"id": "req-1",
|
|||
|
|
"result": {
|
|||
|
|
"success": true,
|
|||
|
|
"output": "..."
|
|||
|
|
},
|
|||
|
|
"ok": true,
|
|||
|
|
"type": "res",
|
|||
|
|
"payload": {
|
|||
|
|
"success": true,
|
|||
|
|
"output": "..."
|
|||
|
|
},
|
|||
|
|
"seq": 0
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
错误响应：
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"jsonrpc": "2.0",
|
|||
|
|
"id": "req-1",
|
|||
|
|
"error": {
|
|||
|
|
"code": -32601,
|
|||
|
|
"message": "unknown method: ..."
|
|||
|
|
},
|
|||
|
|
"ok": false,
|
|||
|
|
"type": "res",
|
|||
|
|
"payload": null,
|
|||
|
|
"seq": 0
|
|||
|
|
}
|
|||
|
|
```'''
|
|||
|
|
|
|||
|
|
content = content.replace('成功响应：\n\n```json\n{\n "jsonrpc": "2.0",\n "id": "req-1",\n "result": {}\n}\n```', new_rpc_example)
|
|||
|
|
content = content.replace('错误响应：\n\n```json\n{\n "jsonrpc": "2.0",\n "id": "req-1",\n "error": {\n "code": -32601,\n "message": "unknown method: ..."\n }\n}\n```', '')
|
|||
|
|
|
|||
|
|
content = content.replace(
|
|||
|
|
'- 与 `session.start` 相同；bridge 会复用 session 历史，尤其在 multi-agent 与 Gemini adapter 路径中。',
|
|||
|
|
'- 与 `session.start` 相同；bridge 会复用 session 历史（历史记录会以 `USER: ` 和 `ASSISTANT: ` 前缀进行上下文包裹），尤其在 multi-agent 与 Gemini adapter 路径中。'
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
with open(path, 'w') as f:
|
|||
|
|
f.write(content)
|