Mailscope 邮件检测

当用户希望对电子邮件（.eml）文件执行安全分析时，请使用本技能。该技能通过将文件上传至 Mailscope 分析平台，生成一份全面的安全评估报告。

语言

以用户的语言进行响应：若用户使用中文，则用中文回复；若使用英文，则用英文回复。所有技术标识符（如路径、命令行参数、字段名等）须保留英文原文。

工作流程

步骤 0：配置 API Key

当用户提供 API Key（例如：“我的 key 是 msk_xxx”、“帮我配置 API Key”、“set api key to msk_xxx”、“这是key: msk_xxx”）时，请将其写入 config.json 文件：

1. 检查技能根目录下是否存在 config.json。若不存在，则读取 config.json.example 作为模板，并据此创建 config.json。
2. 读取当前的 config.json 并解析为 JSON 对象。
3. 将 api_key 字段设为用户提供的密钥值。
4. 将更新后的 JSON 写回 config.json（使用 2 个空格缩进以保证可读性）。
5. 向用户确认：“API Key 已配置成功。”

用户需访问 https://x.lizhisec.com 申请自己的 API Key。若用户询问如何获取，请指引其前往该网址。

步骤 1：检查前置条件

在运行分析前，请验证以下条件均已满足：

1. Node.js 22+ 已安装。可通过 node --version 命令检查。若未安装，请提示用户安装 Node.js 22 或更高版本。
2. config.json 文件存在，且其中包含有效的 api_key 字段。若缺失，请引导用户完成上述“步骤 0”。

步骤 2：运行分析脚本

npx tsx scripts/analyze.ts 

该脚本将执行以下操作：

1. 将 .eml 文件上传至分析平台
2. 每 3 秒轮询一次结果，直至分析完成
3. 输出格式化后的安全分析报告

步骤 3：为用户解读结果

报告本身结构完整、易于理解。以下是关键字段说明，帮助用户快速掌握核心信息：

• 风险等级 (Risk Tier)：risky（高危）、clean（安全），或其他等级
• 置信度 (Confidence)：AI 判定的可信度百分比
• 身份认证 (Authentication)：SPF、DKIM、DMARC 的验证结果
• 域名信息 (Domain Profile)：域名注册日期、ICP 备案情况——新近注册的域名通常可疑
• AI 综合分析 (AI Analysis)：涵盖身份核验、行为模式识别、意图判断及整体威胁评估的详细分析

若邮件被标记为 risky，请重点强调以下建议操作：

• 立即隔离该邮件
• 封禁发件人域名
• 切勿打开附件或输入密码
• 妥善保存原始 .eml 文件，供后续取证使用

错误处理

常见错误及其应对方式如下：

禁止事项

• 不得直接将 API 响应中的原始 JSON 输出给用户
• 不得在面向用户的响应中硬编码任何 API Key
• 除非用户明确要求配置其 API Key（见“步骤 0”），否则不得修改 config.json
• 不得向用户暴露 API_BASE_URL 配置项（属内部实现细节）