fix: MCP 工具参数错误提示不具体，缺少参数示例

[binggg]

Attribution issue

• issueId: issue_mo8z4jw7_zizg60
• category: tool
• canonicalTitle: MCP 工具参数错误提示不具体，缺少参数示例
• representativeRun: atomic-js-cloudbase-storage-list/2026-04-21T18-44-01-hilb8i

Automation summary

SUMMARY:

• root_cause: The MCP storage tools (queryStorage and manageStorage) had parameter descriptions that lacked specific examples and clear guidance on correct vs. incorrect usage. When users received "400 invalid parameter value" errors, they had no guidance on how to fix the issue (e.g., not using leading / in cloudPath).
• changes: Enhanced parameter descriptions and tool descriptions in mcp/src/tools/storage.ts:

1. Updated queryStorageInputSchema with:

• action: Added explicit examples showing action='list'
• cloudPath: Added correct examples ('images/photo.jpg', 'data/') and incorrect examples ('/images/photo.jpg' - explaining not to start with /)
• maxAge: Added example maxAge=7200 (2小时)

2. Updated manageStorageInputSchema with:

• action: Added explicit examples
• localPath: Added cross-platform examples for macOS/Linux and Windows
• cloudPath: Added correct/incorrect examples
• force: Added note that it must be true for delete operations
• isDirectory: Added example showing directory operations

3. Enhanced tool descriptions with full usage examples showing complete parameter combinations for each action type

• validation: TypeSc

Changed files

• mcp/src/tools/storage.ts

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[binggg]

Attribution post-PR evaluation

• visibility: internal identifiers, run ids, and private links are intentionally omitted
• attempt: 1
• eval_scope: primary_only
• overall: ERROR
• summary: post-PR evaluation errored
• updated_at: 2026-04-28T14:31:19.506Z

Cases

• [ERROR] — primary — evaluation errored