1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
//! `/workspace/file/raw` OpenAPI 片段（从 `openapi_paths.rs` 拆出以控制文件行数）。
use serde_json::{Value, json};
pub(super) fn openapi_paths_fragment_workspace_file_raw() -> Value {
json!({
"/workspace/file/raw": {
"get": {
"tags": ["workspace"],
"summary": "读取工作区内常见图片原始字节（png/jpg/jpeg/webp/gif；上限 8 MiB）",
"security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
"parameters": [
{
"name": "path",
"in": "query",
"required": true,
"schema": { "type": "string" },
"description": "工作区相对路径；禁止 `..`；不含 svg"
}
],
"responses": {
"200": {
"description": "图片字节",
"content": {
"image/png": { "schema": { "type": "string", "format": "binary" } },
"image/jpeg": { "schema": { "type": "string", "format": "binary" } },
"image/webp": { "schema": { "type": "string", "format": "binary" } },
"image/gif": { "schema": { "type": "string", "format": "binary" } }
}
},
"4XX": { "description": "路径、类型或大小错误（JSON ApiError）" }
}
},
"put": {
"tags": ["workspace"],
"summary": "写入工作区文件原始字节（任意类型；上限 16 MiB；与 POST /workspace/file 的 JSON content 上限一致）",
"security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
"parameters": [
{
"name": "path",
"in": "query",
"required": true,
"schema": { "type": "string" },
"description": "工作区相对路径；禁止 `..`"
},
{
"name": "create_only",
"in": "query",
"required": false,
"schema": { "type": "boolean" },
"description": "为 true 时若目标已存在则 409 WORKSPACE_FILE_EXISTS"
},
{
"name": "update_only",
"in": "query",
"required": false,
"schema": { "type": "boolean" },
"description": "为 true 时若目标不存在则 404 WORKSPACE_FILE_MISSING"
}
],
"requestBody": {
"required": true,
"content": {
"application/octet-stream": {
"schema": { "type": "string", "format": "binary" }
}
}
},
"responses": {
"204": { "description": "已写入" },
"4XX": { "description": "路径、标志冲突或过大（JSON ApiError）" }
}
}
},
"/workspace/file/download": {
"get": {
"tags": ["workspace"],
"summary": "读取工作区文件原始字节（任意类型；上限 16 MiB；供 Client 保存到本机）",
"security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
"parameters": [
{
"name": "path",
"in": "query",
"required": true,
"schema": { "type": "string" },
"description": "工作区相对路径；禁止 `..`"
}
],
"responses": {
"200": {
"description": "文件字节",
"content": {
"application/octet-stream": {
"schema": { "type": "string", "format": "binary" }
}
}
},
"4XX": { "description": "路径或大小错误（JSON ApiError）" }
}
}
},
"/workspace/dir/archive": {
"get": {
"tags": ["workspace"],
"summary": "将工作区目录打包为 zip（未压缩合计与条目有上限；不跟随符号链接）",
"security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
"parameters": [
{
"name": "path",
"in": "query",
"required": false,
"schema": { "type": "string" },
"description": "相对目录；省略或空表示工作区根；禁止 `..`"
}
],
"responses": {
"200": {
"description": "zip 字节",
"content": {
"application/zip": {
"schema": { "type": "string", "format": "binary" }
}
}
},
"4XX": { "description": "路径、非目录或过大（JSON ApiError）" }
}
}
},
"/workspace/file/move": {
"post": {
"tags": ["workspace"],
"summary": "移动或重命名工作区常规文件（非目录；可选写入会话变更集）",
"security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/WorkspaceFileMoveBody" }
}
}
},
"responses": {
"204": { "description": "已移动" },
"4XX": { "description": "路径、冲突或源不是文件（JSON ApiError）" }
}
}
}
})
}
pub(super) fn openapi_paths_fragment_skills() -> Value {
json!({
"/skills": {
"get": {
"tags": ["skills"],
"summary": "列出当前工作区 skills（供 composer `/` 浮层）",
"security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }],
"responses": {
"200": {
"description": "skills 目录 JSON",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SkillsListResponse" }
}
}
}
}
}
}
})
}