泛微E10日程管理
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../weaver-e10-shared-connector/SKILL.md,其中包含安装、E10 认证、JSON 输出和高风险写入规则。该文件由连接器随包提供,读取失败时必须停止执行;不要自行安装 CLI 或 Skill。
本技能覆盖日程管理业务域:创建日程、查询列表、查询详情、查询总数、更新日程、删除日程、查询类型/紧急程度字典、应用版本检测。写操作(创建/更新/删除)全部走 prepare→apply 确认协议。
命令入口
weaver-work-cli calendar --help
weaver-work-cli --profile eteams calendar schema
weaver-work-cli --profile eteams --json calendar run <operation> --input-json '{"key":"value"}'
schema 是可用能力的唯一事实来源。禁止把本技能或源文档里的接口路径当成可直接调用的地址,也禁止把未出现在 schema 中的能力当作可用 operation。
认证
所有请求复用 weaver-work-cli 托管的 E10 会话,业务输入只描述业务对象和意图。所有 datajson 结构接口的 header.operator 由 CLI 自动填充为当前登录用户,无需在输入中提供。
凭证必须由 E10 命名凭据插件提供,由 weaver-work-cli auth 托管获取。禁止硬编码地址、账号、口令、Cookie、ETEAMSID 或其它会话凭据,禁止用浏览器自动化绕过登录流程,禁止读取、列出、打印或解析认证目录与文件。认证诊断只能通过 weaver-work-cli auth 系列命令、weaver-work-cli doctor --e10 和业务命令返回的 JSON 错误完成。
Reference 路由表
命中任一条件时,执行下一步前读取对应 reference。
| 触发条件 | Reference |
|---|---|
| 查看日程列表、按关键字/时间范围找日程、为更新/删除取日程 ID | references/calendar-query.md |
| 查询日程详情、查询日程总数 | references/calendar-query.md |
| 查询日程类型、查询紧急程度(创建/更新前取选项 ID) | references/calendar-dict.md |
| 创建日程、修改日程、删除日程(写,prepare→apply) | references/calendar-write.md |
| 判断日程应用是否安装、版本检测、详情卡片页链接 | references/calendar-app-check.md |
高优先级语义
- 日程:calendar / agenda,用户常说「日程」「安排」「提醒」「日程列表」「这周有什么安排」。
- 关键字段:
agn_name(名称)、start_time/end_time(起止,yyyy-MM-dd HH:mm)、participants(参与人人员 ID)、agn_type(类型选项 ID)、priority(紧急程度选项 ID)。 - ID 语义:
agn_type与priority必须传选项 ID(先通过calendar.type.list/calendar.priority.list获取),不是meeting/high之类语义字符串。participants必须传人员 ID(通过 weaver-e10-hrm-connector 解析姓名),不是姓名。 - Switch 字段:
all_day、remind、part_receipt必须传数字0/1,禁止布尔值。 - 时间格式:
start_time/end_time为yyyy-MM-dd HH:mm(不含秒);next_start_remind/next_end_remind为yyyy-MM-dd HH:mm:ss(含秒)。
关键业务规则(CLI 已内置)
- 参与人默认带当前人:未传
participants时,CLI 自动用当前登录用户;额外指定他人时当前人仍默认包含,除非用户明确表示自己不参与。 - 时长默认 1 小时:只传
start_time未传end_time时,CLI 自动补end_time = start_time + 1 小时。 - 更新为全量覆盖:
calendar.update.prepare会先查询当前日程详情并合并用户修改,避免遗漏字段。 - 列表默认一页:
page_no/page_size默认 1/10,不自动翻页。
已知回显瑕疵(忽略,不当作 bug)
calendar.list 响应回显的 pageNo/pageSize 可能与实际入参不符(如入参 page_size=20 却回显成 pageNo:20 / pageSize:1)。这是 ESB 响应回显层的展示瑕疵,仅影响这两个回显字段的显示值,不影响实际分页与返回的 count/agenda 数据。接口本身正常:调用方以实际入参 page_no/page_size 为准,忽略回显值,不登记为缺陷、不要求后端修复、不在 CLI 层规避。详见 references/calendar-query.md 的「已知回显瑕疵」小节。
处理链(写操作)
创建、更新、删除日程必须走 prepare→apply:
prepare只归一化输入、查当前数据(更新/删除时)、生成预览和 continuation,不写入。- 向用户摘要目标、差异、风险。
- 用户明确确认后调用
apply,必须带confirm=true和 prepare 返回的 continuation。 apply遇到网络中断/不确定结果时返回partial/write_uncertain,禁止自动重试,先做只读回查。
失败处理
- 遇到
partial、write_uncertain、登录失效、回查失败或网络中断,立即停止当前写流程,不自动重试写入。 - 认证类错误(
authentication/session_expired):引导用户断开并重新连接本连接器,不要用其他方式排查。 - 接口返回 404 或提示「找不到动作流」:日程应用可能未安装,先运行
calendar.app.check检测,再决定是否停止。 - 业务失败看 stderr JSON 的
error.type/error.subtype/error.message。
不在范围
- 参与人「姓名 → 人员 ID」解析不在此技能内,交给 weaver-e10-hrm-connector skill。
- 禁止绕过 CLI 直接 curl/fetch 访问 E10 接口。
- 禁止把未出现在
calendar schema中的能力当作可用 operation。
平台兼容
命令示例同时兼容 Windows 与 macOS/Linux。简单 JSON 用 --input-json,复杂 JSON 存 UTF-8 文件后用 --input <path>。
Windows PowerShell:
weaver-work-cli --profile eteams --json calendar run calendar.list --input-json '{"page_no":1,"page_size":10}'
macOS/Linux(bash/zsh):
printf '%s\n' '{"page_no":1,"page_size":10}' | weaver-work-cli --profile eteams --json calendar run calendar.list --input -