更新MCP资源文档与工具调用指南

精简共用 Skill 主入口并更新工具选择和 API 映射
补充 MCP 参数示例、上传、异步轮询和画布保存流程
校准鉴权、幂等、按需落库及结果告警说明
同步技术方案与共享文档索引

docs/project-memory/shared-memory/document-map.md

@@ -24,7 +24,7 @@
 外部 MCP 语义工具设计：
 
 1. [外部 OpenAPI 与 API Key 接入方案](../../【后端架构】外部OpenAPI与APIKey接入方案-2026-06-19.md)：现役托管 MCP 与 External API 合同。
-2. [外部 MCP 语义工具说明与参数设计](../../technical/【技术方案】外部MCP语义工具说明与参数设计-2026-09-23.md)：15 个语义工具与全部旧工具并存，复用现有 API 分派和 schema；多功能入口使用 action/input，结果不裁剪，可选幂等只扩展新入口。instructions 与 usage resource 已更新为服务能力和跨工具共同约定，其它 resources 保持原样；线上状态按实际部署核对。
+2. [外部 MCP 语义工具说明与参数设计](../../technical/【技术方案】外部MCP语义工具说明与参数设计-2026-09-23.md)：15 个语义工具与全部旧工具并存，复用现有 API 分派和 schema；多功能入口使用 action/input，结果不裁剪，可选幂等只扩展新入口。instructions 与 resources 已同步当前工具选择、调用流程及结果说明；资源 URI 保留，Skill 文档源与下载包共用，线上状态按实际部署核对。
 
 AI 游戏创作 / DirectProject / UI workflow：
 

docs/technical/【技术方案】外部MCP语义工具说明与参数设计-2026-09-23.md

@@ -353,6 +353,18 @@ register_resource 只登记资源，并不自动创建画布图层。正常生
 
 权威文案位于 `external_mcp.rs` 的 `MCP_INSTRUCTIONS`，初始化响应与 `genarrative://external-editor/usage` 共用同一内容。本次仅更新该说明；其它 resources、工具、API 和独立 Skill 保持不变。
 
+### 5.6 resources 内容更新（2026-09-24）
+
+沿用现有 7 个资源 URI。usage 共用 instructions，OpenAPI 继续提供现有 REST 契约；Skill 主入口和四份 references 按当前工具能力更新，不改变工具、路由、鉴权或 DTO。
+
+- 主入口：服务能力、必要共同约定和按需阅读导航；不要求固定项目、同名文件夹或双重落库。
+- capability-routing：按意图选择工具与 action，说明上传、登记、生成、落画布之间的边界。
+- api-operations：工具到现有 REST 操作的映射，保留直接 REST 调用所需信息。
+- authentication-and-safety：MCP 与 REST 凭证配置、上传分工、幂等键位置、重试与删除范围。
+- requests-and-outputs：单功能及多功能 MCP 参数示例、异步轮询、按需指定生成目标、完整布局保存和结果/告警读取。
+
+文档源位于 `.codex/skills/genarrative-external-editor-api/`，由 MCP resources 与下载的 Skill 包共用；本次不修改 Python helper、独立 CLI 或附件中的配套 Skill。说明仍随 API server 编译发布，不新增独立文档托管机制。验收覆盖资源读取、Skill 归档内容及 manifest 摘要一致性，并检查示例与当前 schema。
+
 ## 6. 核对入口
 
 - [External v1 OpenAPI](../openapi/genarrative-external-v1.openapi.json)：operation、参数、请求体、响应与公开字段权威。