AGC 客户端 MCP 能力暴露 (#274)
Project CI / Repository checks (push) Successful in 2m16s
Project CI / Frontend tests (push) Successful in 4m2s
Project CI / Backend tests (push) Successful in 10m14s
Project CI / Native shell tests (push) Failing after 19m54s

## 目标
保留现有客户端对话与 Codex app-server 链路,把客户端自身受控业务能力通过 MCP 暴露给 Codex。

## 范围
- 客户端会话、项目文件、资源、画布、生成、预览等稳定能力
- 审核 Skill 的索引与按需指导资源
- 复用现有账号、项目路径、权限、计费、幂等、锁和恢复边界

## 明确不做
- 不替换客户端对话入口或 Codex app-server
- 不让客户端替 Codex 判断高层意图、完成状态或规划
- 不暴露任意 Tauri command、shell、凭据、内部 URL、数据库和管理能力

当前 PR 先建立独立分支与审查边界,后续提交实现与定向验证。

Reviewed-on: #274
This commit was merged in pull request #274.
This commit is contained in:
2026-09-08 22:01:29 +08:00
parent 1498247e9f
commit 1f904d28e9
30 changed files with 1122 additions and 376 deletions
@@ -3372,8 +3372,14 @@
},
"sliceLayout": {
"type": "string",
"enum": ["grid-2x2"],
"description": "可选固定图集切片合同。省略时沿用全图 alpha 连通域自动拆分;传 grid-2x2 时服务端要求生成四个固定象限,并按左上、右上、左下、右下各持久化一个独立切片。该模式适用于需要恰好四类核心运行时素材的游戏,不会猜测等分裁切。"
"deprecated": true,
"description": "历史兼容字段,新的调用请使用 sliceCount。"
},
"sliceCount": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "可选的目标切片数量;省略时按图像内容自动识别。"
},
"screenColor": {
"type": ["string", "null"],
@@ -3597,15 +3603,21 @@
},
"iconImageSrcs": {
"type": "array",
"description": "默认模式识别图集中全部有效 alpha 连通域并持久化的独立素材,按视觉阅读顺序命名为“素材 N”;数量由图集内容决定,不由 iconDescriptions 数量决定。sliceLayout=grid-2x2 时固定返回左上、右上、左下、右下四个格子的切片,各格内的零散视觉细节不会被拆成额外素材。",
"description": "识别图集中有效 alpha 连通域并持久化的独立素材,按视觉阅读顺序命名为“素材 N”;可通过 sliceCount 指定目标数量。",
"items": {
"$ref": "#/components/schemas/EditorIconSpritesheetIconResult"
}
},
"sliceLayout": {
"type": "string",
"enum": ["grid-2x2"],
"description": "仅当请求使用固定切片合同且主图完成透明化、切片持久化后返回。调用方可将该字段与 iconImageSrcs=4 共同作为固定四类素材的来源证明。"
"deprecated": true,
"description": "历史兼容字段。"
},
"sliceCount": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "实际生成的切片数量。"
},
"sliceWarning": {
"anyOf": [