本技能提供 SuperMagic HTML 微应用中 window.Magic.* 的完整 API 参考,用于查询方法签名、参数与返回值。所有 API 已预注入,无需 import;允许使用外部 CDN。文件路径默认相对于应用根目录(index.html 所在目录),禁止使用 ../,可用前导斜杠如 /shared/data.json 访问项目根文件;在应用根之外写入、删除、移动或重命名会触发宿主确认。不得使用内联事件处理器,需用 addEventListener。
主要能力:
- 文件系统 window.Magic.fs:readFile(上限 5 MB)、writeFile(字符串上限 5 MB,Blob/ArrayBuffer 上限 500 MB)、listFiles、deleteFile、deleteDir、moveFile、renameFile、watchFile(约 3 秒轮询,最多 10 个监听路径)。
- LLM window.Magic.llm:getModels、chat(超时 120 秒)、stream(返回取消函数)。model 必填,默认 auto,禁止空字符串,需提供模型选择 UI 且首项为 Auto Select。
- 项目 window.Magic.project:uploadFiles(单文件上限 500 MB)、downloadFiles、addFilesToMessage、createTopicAndSend(超时 30 秒)、sendMessage(超时 15 秒)。复杂文件型 AI 可用 createTopicAndSend 配合 @file 与伴随技能。
- 智能体 window.Magic.agent.getAgents、setInputMessage、reload、getAppBasePath。
- 用户 window.Magic.user.getInfo:默认仅返回 name 与 avatar;敏感字段需在 app.json 声明 permissions.userInfo.scopes 并在运行时传 scopes 与 reason,经用户确认,授权仅缓存于当前 iframe 会话。每个 HTML 微应用目录需在 index.html 旁放置 app.json 清单,不再生成 magic.project.js。