用途:在会话之间持久保存 API 密钥、令牌等配置值,并支持查询、列出与删除环境变量。默认将个人环境变量保存到 ~/.magic/super-magic.env,以便跨工作区复用;只有当用户明确要求保存或删除当前工作区/项目值时,才传入 "scope": "workspace"。
主要能力与作用域:运行时生效环境会合并工作区环境与个人环境,个人环境优先级最高,同键会覆盖工作区值。工具展示与结果不会回显明文值。
使用方式:在 run_sdk_snippet 内通过 sdk.tool.call(...) 调用 set_env、get_env、unset_env、list_env。查询单个键优先用 get_env,默认查询最终生效环境(scope=all),不要仅为查看一个键而调用 list_env,以免把无关变量名和掩码值暴露到模型上下文;仅当需要确认某个键是否存在于特定存储范围时,才传 "scope": "personal" 或 "scope": "workspace"。list_env 的 scope=all 表示工作区与个人环境的最终合并结果。每次调用后检查 result.ok,失败时抛出 result.content。
适用场景:需要跨会话复用凭据、在工作区与个人之间分层管理配置,或对配置项进行增删查列。
限制:资料未提供额外限制、定价或平台支持信息;命令需按原文使用,密钥值不应被明文回显。