用途：调试无法正常运行的 M365 Copilot 声明式智能体，定位 schema 版本、能力配置、清单限制与图标格式等问题。
主要能力：
- Schema 版本校验：v1.0 为基础版；v1.2 稳定版，新增 WebSearch sites、GraphicArt、CodeInterpreter；v1.5 扩展 TeamsMessages、Email、People；v1.6 最新，新增 Dataverse、Meetings、EmbeddedKnowledge、worker_agents。注意 v1.3 与 v1.4 不存在，使用未识别 schema 会导致整个文档无效。
- 能力兼容性对照：OneDriveAndSharePoint、WebSearch、GraphicArt、CodeInterpreter、GraphConnectors 在 v1.2/v1.5/v1.6 均可用；TeamsMessages、Email、People 需 v1.5+；Meetings、Dataverse、ScenarioModels 需 v1.6；EmbeddedKnowledge 在 v1.6 标注为尚未可用。v1.5/v1.6 能力配 v1.2 schema 会静默失败。
- 清单限制（v1.6）：name 100 字符、description 1000 字符、instructions 8000 字符、conversation_starters 最多 6 项（v1.2 为 12）、actions 1-10 项、WebSearch.sites 4 项、TeamsMessages.urls 5 项、Meetings.items_by_id 5 项。
- 图标要求：color.png 为 192×192 像素、纯色背景、logo 居中于 120×120 安全区；outline.png 为 32×32 像素、仅白色（#FFFFFF）、透明背景（Alpha=0）。常见错误提示 Alpha=255 表示不透明，背景像素必须 Alpha=0。
使用方式：
- 验证包：teamsapp validate --package-file <zip>
- 检查 schema 路径是否为 .../declarative-agent/v1.2/schema.json，v1.3 路径不存在
- 核对能力与 schema 版本匹配
- 用 PowerShell 检查图标透明度：Add-Type -AssemblyName System.Drawing; $bmp = New-Object System.Drawing.Bitmap("outline.png"); $pixel = $bmp.GetPixel(0, 0); $bmp.Dispose(); "Alpha: $($pixel.A)"（应为 0）
- 打包与部署：npx teamsapp package --env local；npx teamsapp validate --package-file appPackage/build/*.zip；上传到 Developer Portal 后在 Teams 中预览
打包清单：manifest.json（Teams 应用清单 v1.19）、declarativeAgent.json（智能体配置 v1.2）、color.png（192×192 纯色）、outline.png（32×32 白色透明）。
常见症状与原因：智能体无响应多为 schema 版本无效；仅显示 1 个对话启动器多为 schema 校验失败；图标校验报错多为透明度或尺寸错误。
记忆方案：智能体通过 OneDriveAndSharePoint 能力读取 OneDrive 中的 Alex-Memory/ 文件夹，用户在聊天中分享文件夹链接，智能体读取认知文件；写入时由 Alex 生成内容后用户粘贴。优点是不需要 Azure Functions、无 API 成本、用户掌控数据。
限制：M365 Copilot 与 Teams 平台 API 快速演进，schema 版本、能力与工具链频繁变化；资料标注最后验证时间为 2026 年 2 月（Schema v1.6+），需关注新 schema 版本、Teams Toolkit 更新、新 M365 Copilot 能力与 Developer Portal 变更。