CRITICAL — 开始前 MUST 先用 Read 工具读取 ../weaver-e10-shared-connector/SKILL.md,其中包含安装、E10 认证、JSON 输出和高风险写入规则。该文件由连接器随包提供,读取失败时必须停止执行;不要自行安装 CLI 或 Skill。
认证和登录态只能按共享规则通过 weaver-work-cli auth ... 命令判断;禁止直接读取、列出、打印或解析用户主目录下的旧 .e10-cli、auth、config 或 Keychain 数据。
所有命令通过 weaver-work-cli --profile eteams --json mail run <operation> 执行:简单 JSON 优先传 --input-json '<json>',复杂或多行 JSON 先写入 UTF-8 文件再传 --input <path>,只有确认当前 shell 能稳定传管道时才使用 --input -。调用前先按需读取 references 下对应的文件,查参数结构,不要猜字段;references 是第一信息源,weaver-work-cli --profile eteams mail schema 是 operation、字段和风险等级的合约来源。
命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux;涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时,同时给 Windows PowerShell 与 macOS/Linux(bash/zsh)两套示例。Agent 先根据当前系统和 shell 选择对应示例,不确定时用 node -p "process.platform" 判断。Windows/PowerShell 下不要使用 printf、$HOME/...、~/...、bash 反斜杠续行、rm/ls/diff/python3 等 Unix-only 写法。
涉及邮件附件、图片、本地文件、远程 URL 文件或邮件正文解析的操作,执行前必须提醒用户:文件内容可能被上传到 E10 邮件系统,并可能进入当前大模型上下文用于理解和处理;必须等待用户明确确认后才继续。
泛微E10邮件
认证与请求头契约
登录与会话由 E10 登录能力统一提供:文档型约定为 weaver-e10-login 技能;连接器场景下由连接器完成授权(weaver-work-cli auth login),业务命令统一通过 --profile eteams 读取该登录态。业务 Skill 不自建登录流程,不索取、打印或转存任何凭证。
CLI 发往 E10 的每个请求都自动携带以下三项用户信息参数,缺一不可(业务入参里不要传这些字段,也不要手工拼装请求头):
Cookie: <weaver-e10-login 返回的完整原始 Cookie 串,原样透传,禁止裁剪/去重/改写>
eteamsid: <weaver-e10-login 返回的 ETEAMSID>
User-Agent: AgentType=<agentType>,IsAgent=true
路由优先级(先判断是不是 E10 邮件,再选 operation)
只要用户的核心对象是泛微 E10 邮件(收件箱/发件箱/草稿/已删除/垃圾箱/待办邮件、邮件正文、附件、签名、模板、联系人、黑名单、往来邮件),就优先使用 weaver-e10-mail-connector。
明确归 weaver-e10-mail-connector 的高优先级语义
出现以下任一语义时,优先走本 Skill:
- 邮件 / 收件箱 / 发件箱 / 草稿箱 / 已删除 / 垃圾箱 / 待办邮件
- 查看邮件、看正文、看附件、未读统计、邮件配置
- 发邮件 / 回复 / 转发 / 存草稿 / 定时发送
- 标星、标记已读/未读、全部已读、待办提醒、移动邮件、删除邮件、撤回邮件
- 文件夹新建/删除
- 联系人、联系人分组、邮件模板、签名、二维码名片、黑名单
- 附件上传、附件下载、附件中心
判定规则: 只要最终动作是对 E10 邮件做查询、查看、发送、解析收件人、标记、移动、删除、文件夹、联系人、模板、签名、黑名单或附件处理,就归 weaver-e10-mail-connector。只有当用户处理的是非邮件类 E10 业务(如招聘、薪酬、业票通)或尚未封装的邮件能力时,才不使用本 Skill。
选哪个命令
| 想做什么 | 命令 | 按需读取 reference |
|---|---|---|
| 查看可用 operation、字段和风险等级 | mail schema |
mail-agent-entry.md |
| 查询邮件列表 | mail run mail.list |
mail-read.md |
| 往来邮件 | mail run mail.contact.list |
mail-read.md |
| 查看邮件详情/正文 | mail run mail.view.info / mail run mail.view.content |
mail-read.md |
| 未读统计 / 邮件配置 | mail run mail.unread.count / mail run mail.config.get |
mail-read.md |
| 收件人解析(内部/部门/外部) | mail run mail.person.search / mail run mail.dep.search / mail run mail.address.search |
mail-read.md |
| 发送/回复/转发/存草稿 | mail run mail.send.prepare/apply |
mail-send.md |
| 标星 / 已读 / 全部已读 / 待办 / 移动 / 逻辑删除 / 文件夹 / 撤回 | mail run mail.star / mail run mail.read.status / mail run mail.read.all / mail run mail.wait.add / mail run mail.move.folder / mail run mail.delete.move / mail run mail.folder.create / mail run mail.folder.delete / mail run mail.recall |
mail-manage.md |
| 联系人 / 分组 | mail run mail.contacts.* |
mail-contacts.md |
| 模板 | mail run mail.template.* |
mail-template.md |
| 签名 / 二维码名片 | mail run mail.sign.* |
mail-sign.md |
| 黑名单 | mail run mail.blacklist.* |
mail-blacklist.md |
| 附件上传 / 下载 / 附件中心 | mail run mail.attachment.upload / mail run mail.attachment.download / mail run mail.attachment.center |
mail-attachment.md |
| 破坏性/缺口操作(已暂缓) | 无可用命令 | safety-boundaries.md |
处理链:
- 查邮件:
mail.list(folder/keyword/unread/star/todo/hasFile/date 过滤)-> 必要时mail.view.info(含附件列表)或mail.view.content(正文) - 收件人解析:先用
mail.person.search/mail.dep.search/mail.address.search拿到 id/邮箱;发送时可直接在mail.send.prepare传--to/--to-dep/--to-id/--external让 CLI 解析,重复姓名会要求确认 - 发送:
mail.send.prepare(flag: -1 新建 / 1 回复 / 3 转发 / 4 编辑草稿)-> 展示摘要 -> 用户确认 ->mail.send.apply(传 continuation + confirm)-> 按返回回执报告 - 标记/移动/删除:
mail.star/mail.read.status/mail.read.all/mail.move.folder/mail.delete.move/mail.wait.add/mail.recall/mail.folder.create/mail.folder.delete - 联系人:先
mail.contacts.list/mail.contacts.group.list定位 ->mail.contacts.save.prepare(查全量表单 + 输出摘要)-> 用户确认 ->mail.contacts.save.apply;删除用mail.contacts.delete - 模板:
mail.template.list-> 新增mail.template.save.prepare/apply;编辑mail.template.update(GET 全量 + 保存);删除mail.template.delete;默认mail.template.default - 签名:
mail.sign.list-> 新增mail.sign.save.prepare/apply;编辑mail.sign.update;删除mail.sign.delete;默认mail.sign.default;二维码名片mail.sign.qrcode - 黑名单:
mail.blacklist.operate.prepare(operateType: add/delete)-> 用户确认 ->mail.blacklist.operate.apply - 附件:上传
mail.attachment.upload(预检→上传→绑定,返回 fileid);下载mail.attachment.download(ids + output 目录);附件中心mail.attachment.center
执行原则(减少误路由、误重试和无效消耗)
1) 先拿最小必要信息,再执行
- 只是查邮件列表时,优先直接用
mail.list - 列表默认先取小页,优先
page=1、size=10;用户没有要求全量时不要自动翻完整文件夹 - 用户已经给出邮件 id 时,不要先查列表再过滤,直接用
mail.view.info/mail.view.content/ 对应写操作 - 只有需要正文、附件列表或完整字段时,才补
mail.view.info/mail.view.content
1.5) 大结果只摘要给用户
- 当前 CLI 会把完整 JSON envelope 写 stdout;Agent 回复时不要原样贴完整 JSON
- 列表最多先展示最相关的前 10 条,包含 id、主题、收发件人、日期、已读/星标/附件状态
- 需要全量统计时,按
page/size分页读取并累计必要字段;说明已读取页数、命中数和是否还有更多 - 详情、附件或调试用完整响应过长时,优先落本地文件并向用户提供摘要和文件路径
2) 已知对象时直达动作
- 已拿到邮件 id、联系人 id、模板 id、签名 id、附件 id 或本地文件路径时,优先调用对应 operation
- 同一轮里如果已有足够的新鲜查询结果,不要重复查询同一列表或同一详情
- 不要默认走
list -> filter -> view -> prepare -> apply全链路;对象已明确时应压缩步骤
3) 错误语义驱动,而不是盲目重试
- 失败后先看进程退出码、
error.type、error.subtype和error.message - 除非错误明确提示可恢复或需要补充参数,否则不要重复刷同一个 operation
- 写请求已经发出后,遇到结果不确定必须停止;不要把
.apply当成可重试读操作 - 错误为
authentication(未登录,如E10 auth not found)或session_expired(登录态失效)时:立即停止当前操作,不要用示例占位域名或自行猜域名登录,也不要盲目重试。先读取共享规则../weaver-e10-shared-connector/references/e10-auth-and-session.md,按其中流程引导用户断开并重新连接本连接器完成重新登录,然后再继续原操作。
4) 附件、图片和文件解析确认
- 执行
mail.attachment.upload、mail.attachment.download,或任何会读取本地文件、上传远程 URL 文件、解析图片/PDF 的步骤前,必须先提醒用户文件内容可能进入大模型上下文,也可能发送到 E10 邮件系统。 - 用户未明确确认前,不要运行上传、解析或下载命令。
- 下载附件会落本地
output目录,执行前确认目录与文件名,避免覆盖。
写操作失败处理:partial/write_uncertain 决策树
当发送、联系人/分组/模板/签名保存、黑名单操作等写操作返回 partial/write_uncertain,或提示网络中断、部分成功、回查失败、回查字段不一致时,按下面规则处理:
- 先停止盲目重试,不要连续重复提交相同
.apply - 优先从以下角度解释:
- 写请求可能已经到达服务端,但连接在结果确认前中断
- 服务端可能只处理了部分数据
- 写接口已返回成功,但详情回查失败或与预期不一致
- continuation、目标对象或登录上下文可能已经变化
- 如需确认,只补 一次 只读查询(例如
mail.view.info、列表查询或mail.list),不要陷入 query/write 循环 - 最终给用户明确结论、已知状态和下一步人工确认建议,而不是继续无意义重试
特别注意: 对发送(尤其是回复/转发带原文的)、联系人删除、模板/签名覆盖和黑名单删除场景更要严格执行上述规则;这些场景最容易因重复提交造成重复发送、误删或覆盖用户刚修改的数据。
Windows PowerShell:
weaver-work-cli --profile eteams mail schema
weaver-work-cli --profile eteams --json mail run mail.list --input-json '{"folder":"0","page":1,"size":10}'
weaver-work-cli --profile eteams --json mail run mail.view.info --input-json '{"id":"12345"}'
weaver-work-cli --profile eteams --json mail run mail.send.prepare --input-json '{"flag":"-1","to":"张三","subject":"季度汇报","content":"您好,附件为季度汇报。"}'
weaver-work-cli --profile eteams --json mail run mail.send.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
weaver-work-cli --profile eteams --json mail run mail.star --input-json '{"id":"12345","star":"1"}'
weaver-work-cli --profile eteams --json mail run mail.attachment.upload --input-json '{"file":"./quarterly.pdf","name":"quarterly.pdf"}'
macOS/Linux(bash/zsh):
weaver-work-cli --profile eteams mail schema
weaver-work-cli --profile eteams --json mail run mail.list --input-json '{"folder":"0","page":1,"size":10}'
weaver-work-cli --profile eteams --json mail run mail.view.info --input-json '{"id":"12345"}'
weaver-work-cli --profile eteams --json mail run mail.send.prepare --input-json '{"flag":"-1","to":"张三","subject":"季度汇报","content":"您好,附件为季度汇报。"}'
weaver-work-cli --profile eteams --json mail run mail.send.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
weaver-work-cli --profile eteams --json mail run mail.star --input-json '{"id":"12345","star":"1"}'
weaver-work-cli --profile eteams --json mail run mail.attachment.upload --input-json '{"file":"./quarterly.pdf","name":"quarterly.pdf"}'
不在本 skill 范围
- 禁止加载原始
weaver-e10-mail-connectorSkill 代替 CLI。 - 禁止 curl、fetch、浏览器自动化或直接访问 E10
/api/inc/*或邮件接口。 - 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
- 禁止读取、列出、打印或解析用户主目录下的旧
.e10-cli、auth、config 或 Keychain 数据。 - 永久删除(
mail.delete.batch)与重发(mail.resend)当前未纳入 CLI manifest,已暂缓实现;如确需执行,请在确认风险后以单独授权方式处理,详见safety-boundaries.md。 - 非邮件类 E10 能力(招聘、薪酬、业票通、通用流程编排)不由本 Skill 承载。