泛微E10邮件管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-vsc9dz4y/weaver-e10-mail。
技能介绍
解决的问题
对外部集成方来说,泛微 E10 的邮箱并不是一套可以直接调用的开放接口:URL 只给到去域名的内部路径,协议、域名、端口与会话认证由登录能力 weaver-e10-login 维护;收件人可能落在内部人员、内部部门或外部邮箱三套不同解析逻辑里;发送还要先取服务端生成的 sessionUuid,再走预校验与正式发送;详情、正文接口还会命中缓存。与此同时,把原始 JSON、内部 ID 和 HTTP 状态码直接丢给用户,很难形成稳定可靠的交互。
技能如何工作
本技能只负责业务动作,不自行拼接完整地址,也不实现认证。调用前先执行登录命令拿到会话与 baseUrl,遇到 401 或登录失效自动重登一次,仍失败则提示重新登录。
- 脚本优先,文档兜底:优先执行
scripts/mail-request.mjs等 Node 脚本;只有脚本这类执行性故障时,才按references/catalog.md定位接口文档手工组装请求。 - 业务性拦截不回退:功能未启用、收件人解析不到、需要用户确认、
success=0等结果,一律按当前结果处理,不换同类型接口绕过。 - 查询与统计:列表可按未读、
hasFile、时间范围叠加过滤;--contact合并收件箱与已发送还原往来邮件;--summary批量取正文后归纳,未读角标以getInboxUnReadCount为准。 - 发送三步与收件人解析:
mailAdd → canSendMail → sendMail顺序执行。--to/--cc/--bcc解析内部姓名、工号或部门,外部地址按邮箱处理;重名与多候选会先让用户选择,不默认取第一个。 - 写操作双阶段确认:
--prepare只输出收件人、主题与正文摘要,用户明确确认后--commit --confirm yes才发送;删除与永久删除同样先确认,永久删除还需二次确认。 - 发送前预检:校验内部邮件、外部邮件是否启用、外部发件账号是否绑定,并用同一请求体触发
canSendMail暴露收件人超限等拦截。 - 防缓存与输出规范:详情、正文接口每次重新生成
randomkey_;列表接口不带随机串。用户可见结果固定为表格、字段块、统计行或状态短语,不贴原始 JSON、内部 ID 或状态码。
适用边界
标星、已读、待办、撤回、重发等参数简单的写操作不脚本化,按对应接口文档执行。邮件定位失败时展示相近邮件或提示核对拼写,发送被服务端拦截时如实转述原因,不尝试绕过。回收站恢复、按文件夹清空、邮件导出未收录;重发依赖邮件发送日志 ID,拿不到时会明确说明。
使用场景
- 早上需要查看收件箱未读邮件数量及列表,定位要优先处理的邮件
- 给内部部门群发通知,需先确认收件人数和部门范围再发送
- 总结某同事发来的几封邮件核心内容,快速梳理沟通要点
- 发送外部邮件前检查外部发件账号是否绑定,避免发送失败
适合人员
- 泛微E10集成开发者,需要把邮件查询与发送能力嵌入自建办公工具
- 企业HR,每周需给多个部门发送通知并确认收件人范围
- 客服主管,需要快速查看客户往来邮件并总结核心诉求
- 财务BP,发送含敏感数据的邮件前需确认附件与外发配置合规