weaver-work-cli 0.1.38 → 0.1.40

package/skills/weaver-e10-meeting/SKILL.md

@@ -5,7 +5,7 @@ display_name_en: Weaver E10 Meeting Management
 description: "泛微 E10 会议管理：查会议、预约建会（推荐会议室、查冲突与空闲时段）、改期/改地点/改参会人、取消删除、流程建会、会议室查询与推荐、生成邀请函、读取会议附件、回执签到、纪要与决议任务、参会二维码。详见 description_zh。"
 description_zh: "泛微 E10 会议管理，帮您处理会议日常事务：[会议]-查询今天/本周/我的会议与会议详情，预约建会（自动推荐会议室、检测参会人会议冲突与日程空闲、冲突时给出当天可选时段），改期/换地点/改参会人、取消、删除；受限环境可走审批流程建会，提交后必出邀请函；[会议室]-查询会议室与占用，按人数/设备/常用程度智能推荐；[邀请函]-生成邀请函文档（有会议 id 用真实数据；没有也能按会议名+时间出预置函）；[资料]-读取会议与议题的附件、抽取文档正文；参会回执、签到与补签、纪要、议题、决议与决议任务；[二维码]-把文本渲染成参会码/签到码图片。认证与会话由 weaver-e10-shared 提供。"
 description_en: "Weaver E10 meeting management: [Meetings] query today/week/my meetings and details, book meetings with automatic room recommendation, attendee conflict and calendar-availability checks (plus same-day alternative slots), reschedule / change room / change attendees, cancel, delete; flow-based booking with automatic invitation when the app only allows workflow creation; [Rooms] occupancy queries and smart recommendation by capacity, equipment and personal usage; [Invitation] generate invitation docx from real meeting data; [Content] list and read meeting/topic attachments and extract document text; receipts, sign-in, minutes, topics, decisions and decision tasks; [QR] render text into attendee/sign-in QR images. Auth and session are provided by weaver-e10-shared."
-version: 2.45.8
+version: 2.48.1
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -29,6 +29,10 @@ cliHelp: "weaver-work-cli meeting --help"
 
 用户说「帮我约个会 / 预约明天和 XX 开会」时，**先按这个顺序做，不要一上来就问一堆**：
 
+**⛔ 参会人员不许收集**：用户没点名要请谁时，**不要用任何弹框/表单/输入框问『参会人员』**，直接调用 CLI 且**不传 `hrm_members`** —— CLI 会自动填当前登录人（实测表单里就是 `| 参会人员 | 卜伟领 |`）。用户主动说"叫上张三"才传。
+这条优先于下面所有步骤：先弹『参会人员（可选）』再建会 = 多问一轮，用户明确投诉过。
+
+
 0. **不确定 CLI 有没有某个能力 → `weaver-work-cli meeting ops`（纯文本）**，查具体能力用
    `meeting ops --grep 关键词`（如 `--grep suggest`、`--grep 建会`）。
    ⛔ **不准用 `meeting schema --json` 判断能力存在性**：完整 308KB、stdout 只回 20KB 预览，
@@ -41,8 +45,9 @@ cliHelp: "weaver-work-cli meeting --help"
    - ✅ **只有这两种情况传 `true`**：
      ① 用户**原话明确**给出了（"明天 9 点到 10 点"、"用 502 茶室"）；
      ② 用户**在选项里点选**后，把 `options[].value` **整体原样回传**（value 里自带该标记，别手动拼）。
-   - ⛔ **其他一切情况都不传**：用户只说"明天/上午/下午"、你从上下文推断、你觉得 9 点最合适、
+   - ⛔ **其他一切情况都不传**：用户只说"明天"（没给时段词）、你从上下文推断、你觉得 9 点最合适、
      你觉得这间房最合适 —— **一律不传**。
+     （用户说了"上午 / 下午 / 晚上"**不算猜**：按第 2 条固定区间传 `time_slot`，CLI 自己展开并置标记。）
      不传时**即使你填了** `begin_datetime` / `address`，CLI 也不会当成已定，而是返回时段/房间选项让用户点选。
    - ⛔ **禁止把候选写成定论**。`NEEDS_SELECTION` 返回的 `options` 是**候选**，不是已选：
      不许说「时间：09:00–10:00」「地点：测试会议室1」这种既定语气，
@@ -50,14 +55,24 @@ cliHelp: "weaver-work-cli meeting --help"
    - ⛔ **禁止绕过**：不许先自己调 `room.list` / `room.recommend` 挑一间，再带 `roomConfirmed: true` 硬塞；
      也不许因为"懒得再多问一轮"就直接传标记。用户没说过，就是没说过。
 
-1. **确认顺序固定：名称 → 时间 → 参会人 → 地点 → 流程**。
+1. **确认顺序固定：名称 → 时间 →（参会人，可省略）→ 地点 → 流程**。
    流程只是审批载体，**不许在四要素定下来之前就问"用哪条流程"**。CLI 也是这个顺序：
    时间没确认先回 `slot`，地点没确认再回 `room`，四个都定了才回 `flow`；
    `flow` 的 `options[].value` 里已带 `begin_datetime`/`end_datetime`/`address` 和两个确认标记，
    用户点选流程后**原样回传 value** 就直接进确认，不要再问一遍时间/地点。
 
-2. **没给具体几点 → 直接走 ① 的 `prepare` 且不传 `begin_datetime`**，它会返回「所有参会人空闲 **且**
-   该时段有可用会议室」的时段选项，直接做成选项让用户挑；禁止问"安排在几点"。
+2. **时间只有粗粒度说法时，按固定口径直接定**（2026-11-02 用户确认，不要再弹候选）：
+   - 说了「上午 / 早上」→ **09:00–12:00**；「下午」→ **13:00–18:00**；「晚上」→ **18:00–21:00**；
+   - **正确传法（优先用这个）**：`{"dateFrom":"2026-11-03","time_slot":"上午"}` —— CLI 会自己展开成
+     `2026-11-03 09:00`~`12:00` 并视为已确认；
+     也可以直接写 `begin_datetime: "2026-11-03 上午"`，两种都认；
+   - ⛔ **不要只传 `dateFrom` 就等 CLI 返回时段候选** —— 用户已经说了"上午"，再弹一次"选时段"就是重复问
+     （2026-11-02 用户投诉的就是这个）；
+   - 只给了一个**开始时间** → 结束 = 开始 + 1 小时（`durationMinutes` 可覆盖）；
+   - 给了**完整区间**（"9 点到 11 点"）→ 按给的，不做映射；
+   - 以上都算用户拍过板，CLI 会自动置 `timeConfirmed`，**不要再返回时段选项让他挑**。
+2.1 **连日期都没有时才返回候选**：不传 `begin_datetime`，`prepare` 会返回「所有参会人空闲 **且**
+   该时段有可用会议室」的时段选项，做成选项让用户挑；禁止问"安排在几点"。
    只有"只想看空闲、还不建会"时才单独调 `meeting.eb.meeting.create.suggest`。
    - 每个时段选项的 `reason` 会写明「N 人全部空闲（会议回执 + 日程已核）；M 间会议室可用：…」——
      这就是"人和房都空闲"的凭据，`options[].rooms` 是该时段真实的可用房间清单。
@@ -66,13 +81,19 @@ cliHelp: "weaver-work-cli meeting --help"
 
 3. **没指定会议室 → 不要"问"，要"给选项"**。`suggest` 返回里的 `rooms`、`prepare` 返回里的
    `roomOptions` / `options` 自带候选（已按人数/常用/时段占用排序，默认 3 个）。
+   **带了客户（`crm_members` 非空）时，接待类会议室会排前面** —— 判据是会议室描述（`room_desc`，
+   如「接待重要客户使用」）或名称含 接待/招待/客户/商务/贵宾，`reasons` 里会写明「带客户优先：…」。
+   这一层是 CLI 自动做的，**不需要你额外传参、也不要自己按名字挑**。
    - ⛔ **禁止开放式提问**：不要说「会议地点是必填项，需要你指定一间 / 你想用哪间会议室」——
      这是把选择题变成填空题，等于没推荐。
    - ✅ **必须做成选项控件**：`options[].label` 作标题、`reason` 作副标题，第一个标「推荐」。
    - ⛔ **不要自己再去调 `meeting.eb.room.list` 拼候选** —— 排好序的 `options` 就在返回值里，
      另拉列表既丢排序又会把不合适（容量不够/已被占用）的房间混进来。
    - 候选为空（该时段全被占用）→ 给「改时段 / 线上会议 / 地点待定」三个选项，仍不要让用户手填房间名。
-4. **不要问「参会人数」**。CLI 自动算 = `hrm_members` 人数 **+ 召集人自己**（已在上线账号里就不重复加），
+4. **没给参会人 → 不要弹窗问，CLI 默认就是当前登录人**（2026-11-02 用户要求）：
+   `hrm_members` 不传时 CLI 自动填当前登录人并写进表单；用户后面想加人会说，
+   所以**不要**为了"请选择参会人"打断他。
+4.1 **不要问「参会人数」**。CLI 自动算 = `hrm_members` 人数 **+ 召集人自己**（已在上线账号里就不重复加），
    用于会议室容量过滤；`total_member` / `memberCount` 是可选参数，**只有用户明确说了"几个人"才传**。
    ⛔ 不要自己推算人数、也不要因为"看起来只有 1 个参会人"就降级给人少的房间。
 5. **不要逐个问必填项**。会议名称没给就从上下文拟一个（如"十一月开发进度沟通会"）让用户一次确认；
@@ -112,6 +133,11 @@ cliHelp: "weaver-work-cli meeting --help"
      不许因为"名字不完整"就跳过查询、改成弹「客户怎么写」的选择框 —— 2026-10-31 用户投诉的就是这个：
      小E 弹了「填入参会客户字段 / 仅写入会议内容备注」两个选项，**"仅写入备注"正是明令禁止的做法**。
      先查，再谈确认；不存在"先问怎么填"这一步。
+   - **`items` 可能有多条**（动作流是 like 模糊查：搜「中国民航」能命中"中国民航信息网络股份有限公司--…"、"中航信数智…"等一票近名客户）。
+     → **把前 3–5 个客户做成选项让用户选**（标题用客户全名），不要默认取第一个、也不要自己合并；
+   - 用户选定后，`crm_members` 传 **该客户的 `{id, name}`**（就是 `items[]` 里的那一项）。
+     CLI 会**直接用这个客户自己的联系人明细**（`contacts`），**不会再回查 ESB** —— 所以选中谁就只有谁的联系人。
+     如果 `items[]` 里带了 `contacts`，原样一起传更稳（省掉一次查询）。
    - `exact: false`（命中名 ≠ 关键词）→ **把命中的全名原样念出来问"是这家吗"**，用户认了就往下走。
      ⛔ 不要问成选择题（"填客户字段 / 只写备注"），也不要拿首个匹配当定论。
    - `items: []`（真没查到）→ 才问用户：「CRM 里没搜到「X」，能给我完整的公司名吗？或这家先不关联客户？」
@@ -262,7 +288,11 @@ cliHelp: "weaver-work-cli meeting --help"
   ```
   把 `label` 做成选项让用户挑一个（`value.begin/end/address` 直接可回填），选定后带时间走 prepare。
   - 没候选时它会说明原因（人没共同空闲 / 人空闲但订不到会议室），**如实转达**，别自己编一个时间；
-  - 用户说了"上午/下午"这种粗粒度，也走它（`workStartHour`/`workEndHour` 约束），不要直接默认 9 点。
+  - ⛔ **用户说了"上午/下午/晚上"就不要走 suggest**：直接按固定时段定下来
+    （上午 09:00–12:00 / 下午 13:00–18:00 / 晚上 18:00–21:00），
+    建会时传 `{"dateFrom":"<日期>","time_slot":"上午"}` 给 `create.flow.prepare/quick`；
+    **不要**再传 `workStartHour`/`workEndHour` 让 CLI 给候选 —— 那会二次追问用户时间
+    （2026-11-03 真实翻车：用户说"明天上午"，小E 还是弹了 08:00~09:00 / 09:00~10:00 让选）。
   - ⛔ 这个操作调不通（返回 `unknown operation`）时**先跑 `meeting ops --grep suggest` 自查**，
     确认 CLI 装的是不是最新版；**不要**直接对用户说"没有这个能力" —— 建会主链路本来就不需要它。
 - ⛔ **仅限「会议建会」这一件事：不要自己手搓 `workflow.*`**
@@ -356,9 +386,9 @@ cliHelp: "weaver-work-cli meeting --help"
      没证据。正确说法："这项没核验到（原因 X）"，并原样转达原因。
      以前这些失败被 `.catch(() => null)` 静默吞掉，"没查"和"没冲突"长得一模一样，用户以为查过了
      （会议室查不到就卡在选房 → 冲突检测不跑 → 却答复"流程表单本身不做冲突检测"，就是这么错的）。
-   - **会议室台账缓存 24 小时，但「建会」链路强制拉最新**：`create.flow.prepare` / `create.flow.quick` /
-     `create.suggest` 内部都会强制刷新台账，所以刚导入/新建的会议室在建会时一定看得到。
-     只有**纯查询**（`meeting.eb.room.recommend`）会走 24h 缓存（快）；缓存超过 4 小时会在 warnings 提示
+   - **会议室台账缓存 24 小时（2026-11-03 松绑：建会链路也走缓存）**：`create.flow.prepare` / `create.flow.quick` /
+     不再每次强制重拉台账（省 ~1s），靠「候选为空自动强制重拉」兜底；代价是**刚导入的会议室在缓存期可能按名称查不到**
+     （按 id 指定不受影响）。只有**纯查询**（`meeting.eb.room.recommend`）同样走 24h 缓存（快）；缓存超过 4 小时会在 warnings 提示
      "数据可能过时"，最近改过会议室就带 `refresh: true` 重查。候选为空时还会自动强制重拉一次
      （`meta.cacheRetried: true`）。
      ⛔ **不要因为"只有 1 间/查不到"就去断言系统里没有会议室** —— 先看 `meta.roomsTotal` 与 `cacheRetried`，
@@ -412,13 +442,17 @@ cliHelp: "weaver-work-cli meeting --help"
    - 取表单一律用 `meeting.eb.meeting.create.flow.prepare`（内部按固化流程候选、未命中回落 `mt_new_wf` 调 `workflow.createForm`），
      **不要**自己拼 `workflow.createRequestDirect` / `workflow.createForm`。
 3. **能自动推的绝不问用户；剩下要问的一次问全**
-   - **时间没说具体几点**（只说"明天/下周三/上午"）→ **不要问，直接调 ① 的 `prepare` 且不传 `begin_datetime`**，
-     它会返回「所有人都空闲 + 该时段有会议室」的时段选项（带会议室名，`value` 可直接回填）。
-     这是 2026-10-30 用户明确要求的：没填时间就要推荐时间，不许弹空输入框让人手填。
+   - **时间只说了日期**（"明天 / 下周三"，**且话里没有任何时段词**）→ 不要问，直接调 ① 的 `prepare`
+     且不传 `begin_datetime`，它会返回「所有人都空闲 + 该时段有会议室」的时段选项（`value` 可直接回填）。
+     ⛔ **只要话里出现"上午/早上/下午/晚上"，就不许走这条路**：必须按第 2 条传
+     `{"dateFrom":"<日期>","time_slot":"上午"}`，让 CLI 直接定成 09:00–12:00。
+     2026-11-03 用户第二次投诉的就是这个：说了"明天上午"，还是弹「09:00~10:00 / 10:00~11:00」让他选。
      只有"只想看空闲、不建会"才单独用 `meeting.eb.meeting.create.suggest`。
    - **会议室没指定** → **不要问，要给选项**（`prepare` 返回的 `options` / `roomOptions`，
      已排好序）。呈现规则见本节第 2 条：做成选项控件，禁止列成文本 + "需要你指定一间"。
-   - 其余真正缺的（会议名称 / 参会人 / 会议类型）**一次列完问**，不要"先问人 → 再问类型"。
+   - 其余真正缺的（会议名称 / 会议类型）**一次列完问**，不要"先问人 → 再问类型"。
+     ⛔ **参会人不算"缺"**：不传 = 当前登录人（CLI 自动补进表单），**不许弹框问"参会人员是谁"**
+     （2026-11-03 用户投诉：明明可以默认自己，却又弹了一次输入框）。用户后面想加人会说。
      每多一轮追问就多一次模型推理（20–40 秒），用户体感"建个会要 2 分钟"基本都是这么来的（实测 CLI 全程只要 3 秒）。
    - 用户一句话里已经给全的要素**不要再复述确认**，直接进下一步。
 4. **不要在 prepare 之前自己先去查会议室/类型/冲突** —— `prepare`/`quick` 内部已并行跑完（见上面「会议室不能默默留空」）。
@@ -540,7 +574,10 @@ weaver-work-cli --json meeting run meeting.minute.fromGroupChat --input-json '{"
 `attachment.upload` → `minute.create` 挂附件 → ESB「解析附件」（文档同步、可能 60s 超时报 `write_uncertain` 但**不代表没执行**；音频异步约 9s 返回、原文约 2 分钟就绪）→ 等 `video_taskResult=1` / `minutes_status=4` → ESB「生成智能纪要文本」（写 `parse_content`）→ ESB「保存解析并生成文档」。
 ⛔ 不要自己拟纪要文案（提示词在 ESB 里，自己写会和小E 现有格式不一致）。
 ⛔ 不要调「获取解析纪要音频结果」：它是 1 分钟一轮的定时任务、会自己写表单，重复调可能覆盖；查进度只用 `meeting.minute.parseStatus`。
-⚠️ 流程 id / 页面 id 是**租户级配置**，文中 `<…>` 均为占位符。
+✅ **三个动作流 id 与智能纪要页面 id 已内置**（本租户 primary_key），`meeting.minute.fromGroupChat` 默认就用它们，
+你**不用传** `flowGenerateMinutes` / `flowGenerateDocument` / `aiPageId`；换租户才需要覆盖。
+⛔ 手工触发时用 `uniqueIndent: "<32位 primary_key>"`，**不要塞进 `esbFlowId`** —— 那个入参只认 19 位数字 id，
+传 GUID 会报 `can not cast to long` / `系统错误`。
 ## 读附件内容（会议附件 / 项目文件 / 议题资料）
 
 ⛔ **旧结论作废**：以前 skill 里写"附件回读只有文件名、拿不到 fileId ⇒ 下载不了"，**是错的**。
@@ -643,6 +680,12 @@ weaver-work-cli --json meeting run meeting.attachment.extract --input-json '{"mt
 - **不要**在建会前自己先跑 `hrm.employee.query`、`room.list`、`conflict.member`、`schedule.free` —— prepare/quick 内部已经并行做完了
   （只有在需要给用户**换人/换房/换时间**时才单独查）；
 - 需要让用户挑选时（多流程 / 有冲突要改期 / 换会议室），用 `quick`/`prepare` 返回的 `options` 做**一次**选择，选定后再 `quick` 一次即可收口。
+- ✅ **两个省时机制已内置（2.48.0），不用做任何事**：
+  ① **全天占用缓存**——quick/prepare 第一次跑某天会一次拉全天全部会议室占用（~2s，5 分钟内有效），
+  同一天内改时间/换会议室/再推荐**不再打占用接口**；提交成功后当天缓存自动作废，不会拿旧台账放行冲突。
+  ② **流程记忆**——多个建会流程都可发起时，自动沿用**这个人上次成功用过的流程**直接发起
+  （留痕说明"沿用了你上次选的"），不再弹流程选项；要强制回到"每次都问"传 `flowChoice: "ask"`。
+  权限过滤照做：记忆只是默认值，不是绕过权限。
 
 ## 流程建会（`meeting.eb.meeting.create.flow`）
 
@@ -679,21 +722,41 @@ weaver-work-cli --json meeting run meeting.eb.meeting.create.flow.apply \
   - **刷新为完整版**：审批通过后 `meeting.eb.meeting.list` 找到该会议 id →
     `meeting.invitation.render --mtId <id>`（只生成、不发送）。
   - ⛔ **不要因为"会议还在审批"就重复 `apply`** —— 会重复建单/重复建会。
-  - **只有 `submit_mode=browser` 才可能返回 `status=BROWSER_FILL`**（2026-10-31 起默认不再进这一档，
-    见下方「提交方式」）。万一真进到这一档：CLI 会返回 `contextId` + `finalMarkdown`（那段 `<browsertool>` 表单）
-    + `invitation.filePath`（按申请单预生成的预置函）。正确做法：把 `finalMarkdown` 内容原样作为本轮回复正文
-    （从 `<browsertool>` 到 `</browsertool>`、不包代码块），并告诉用户邀请函已生成在哪个路径；
+  - **`status=BROWSER_FILL` 时**：CLI 返回 `contextId` + `finalMarkdown`（那段 `<browsertool>` 表单）
+    + `invitation`（按申请单预生成的预置函）。具体做法见下方「提交方式」第一条；
     ⛔ 不要说"流程没提交成功 / 没有邀请函"，也不要因为"没有 requestId"重复 `apply`。
 
 - **✅ 提交方式默认「弹表单」**（2026-10-31 用户纠正；之前默认直提是错的，别再改回去）：
-  `create.flow.quick/apply` 默认 `submit_mode=browser` —— 在小e 里会**打开流程表单**，会议名称/时间/地点/参会人员/参会客户都已预填
-  （浏览按钮传的是 id，页面能落值），用户核对、修改后**自己点提交**。
-  - `browser` 下 CLI **不向服务端写入**，返回 `status=BROWSER_FILL` + `finalMarkdown`（那段 `<browsertool>`），
-    没有 `requestId` / `meetingId` —— ⛔ **不能说"流程已提交"**，要说"表单已打开，您在页面上核对后点提交"；
-  - 邀请函照给（预置函）；审批通过、会议生成后再用 mtId 跑一次 `meeting.invitation.render` 拿完整版；
+  `create.flow.quick/apply` 默认 `submit_mode=browser` —— CLI **只把表单块返回给你，不会自己打开页面**。
+  会议名称/时间/地点/参会人员/参会客户都已预填（浏览按钮传的是 id，页面能落值），用户核对、修改后自己点提交。
+  - **打开表单的唯一动作 = 把 `finalMarkdown` 原样贴进回复**（从 `<browsertool>` 到 `</browsertool>`）：
+    - 放在回复**最后**、单独成段；⛔ 不包代码块、不省略、不转述、不改缩进；
+    - **发送前自检**：正文里必须能搜到 `<browsertool>` 和 `"toolId": "fill_form"`；搜不到就补上再发；
+    - ⛔ 没贴这段却写"表单已在右侧打开"＝骗人，用户看到的就是没有表单（2026-11-02 就是这么翻车的）。
+  - `browser` 下 CLI **不向服务端写入**，返回 `status=BROWSER_FILL` + `finalMarkdown`，没有 `requestId` / `meetingId` ——
+    ⛔ **不能说"流程已提交"**，要说"表单已打开（贴在下方），您在页面上核对后点提交"。
+  - **邀请函照给，且 `invitation.text` 必须全文贴在回复里**（预置函：按申请单已知信息生成，字段可能不全）。
+    ⛔ 不要只丢一个 `filePath`；也**不要因为"流程还没提交成功"就不给邀请函** —— 这是两件独立的事。
   - 只有用户明确说"不用我确认，直接建"时才传 `submit_mode=direct`：直接写服务端 → 拿 `requestId` + `meetingId`，
-    会议当场生成；判断落库看这两个 id，并用 `meeting.eb.meeting.detail --id <meetingId>` 回读核对；
+    会议当场生成；判断落库看这两个 id，并用 `meeting.eb.meeting.detail --id <meetingId>` 回读核对。
+    ⚠️ 小e 环境里即使传 `direct` 也可能仍返回 `BROWSER_FILL`（流程侧没有强制提交开关）——
+    **一切以返回的 `status` 为准**：只有 `status=COMPLETE` 且拿到 `meetingId` 才算建好，
+    否则就是"表单已给出、等用户点提交"，⛔ 不要说"已提交/已建好"。
   - ⛔ 不管哪种模式，`quick` / `apply` 都是真提交，必须已拿到用户对时间/地点/人/客户的确认。
+- **群聊随建会同步创建**（2026-11-02 用户要求；CLI 自动做，不用你另外调）：
+  `quick` / `apply` 的返回里带 `groupChat: {ok, groupId, groupName, created, bound}`。
+  - `groupChat.ok=true` → 群已按「会议名称」建好，并在群里发过一条会议信息；回复里说一句"会议群已建好（群名＝会议名称）"即可；
+  - `bound=true` → 群 id 已回写会议记录 `imchat_groupid`；`bound=false`（browser 档必然如此，因为还没有会议 id）→
+    告诉用户"群已建好，会议生成后再绑定"；
+    **用户说"我提交了/审批过了"之后**，跑 `meeting.eb.meeting.group.ensure`：
+    - 有流程单号 → 传 `{"requestId":"<单据id>"}`（**首选**，会议记录的 `request_id` 是唯一凭据）；
+    - 没单号 → 传 `{"lookupPending":true}`：CLI 读本机「表单已发出」记录，用建群时记的基线单号
+      找出之后新提交的那张，再按它反查会议。
+      ⛔ **不要用会议名称反查**（用户可能在表单里改名、也可能有同名会议）；
+      返回 `requestCandidates` 说明同时有多张新单 —— 让用户确认是哪一张，别猜；
+      返回 `meetingLookup` 就是找到的会议；查不到会明说"可能还没提交/还在审批"，别反复重试；
+  - `groupChat.ok=false` → 如实说"群没建成功"+原因；⛔ 不许编群 id、不许说群已建好；
+  - ⛔ 不要重复建群：重试前先看已有返回里有没有 `groupChat.groupId`。
 - **⛔ 提交前必须把 `formPreview` 贴给用户过一眼**（2.44.0 起，2026-10-31 用户要求
   「为什么没有直接发起流程表单让我确认重填后让我点击提交」）：
   浏览器填单那条路走不通（浏览按钮不赋值），所以用"把要提交的内容原样列出来"替代核对环节。

package/skills/weaver-e10-meeting/references/meeting-minute-file.md

@@ -155,22 +155,36 @@ video_taskResult == '2'                        → 生成失败
 
 ## ESB 解析链路
 
-三个动作流都可用 `esbFlowId` 或 `uniqueIndent` 触发，走 `esb.trigger.prepare → apply`。
+三个动作流走 `esb.trigger.prepare → apply`，但**目标入参按 id 形态二选一，不能混**：
 
-> ⚠️ **表里的 id / primary_key 都是租户级配置**，各环境不同，换租户必须替换。
-> `meeting.minute.fromGroupChat` 内置了参考租户的默认值（生成纪要 / 生成文档两条），
-> 其他租户用入参 `flowGenerateMinutes` / `flowGenerateDocument` 覆盖；解析附件那条由调用方显式传 `esbFlowId`。
+| id 形态 | 用哪个入参 | 服务端行为 |
+| --- | --- | --- |
+| 19 位数字（如 `1333212605456498718`） | `esbFlowId` | 正常 |
+| 32 位十六进制 primary_key（如 `7204936B2ACC4B12A1CECD1DAB60DD97`） | **`uniqueIndent`** | 传进 `esbFlowId` 会报 `can not cast to long, value : 7204…`（查模板）或 `{"code":400,"msg":"系统错误"}`（触发） |
 
-| 用途 | esbFlowId | primary_key | mainTable |
-| --- | --- | --- | --- |
-| **解析附件**（文档同步 / 音视频异步） | `<解析附件flowId>` | `<解析附件uniqueIndent>` | `mtAIMinutePageID*`、`minuteId*`、`mt_id*`；可选 `doc_file` / `video_file` / `file_type` |
-| **保存解析并生成文档** | `<生成文档flowId>` | `<生成文档uniqueIndent>` | `parse_content*`、`mt_minute_id*` |
-| 解析文本生成智能纪要（备用） | `<生成纪要flowId>` | `<生成纪要uniqueIndent>` | `minuteId*` |
+> ⛔ **本租户（e-cology / 泛微网络）后台只给 primary_key，没有数字 id** —— 所以一律走 `uniqueIndent`。
+> `uniqueIndent` 触发时 prepare 会提示"无法按 applicationId 回查模板"，这是**正常**的，不影响执行。
+
+| 用途 | primary_key（本租户） | mainTable |
+| --- | --- | --- |
+| **解析附件**（文档同步 / 音视频异步） | `AD8EE1B345FD4570AE1D0882FD1B5927` | `mtAIMinutePageID*`、`minuteId*`、`mt_id*`；可选 `doc_file` / `video_file` / `file_type` |
+| **保存解析并生成文档** | `1F638AE31BC746C28A1D9DCF26D91037` | `parse_content*`、`mt_minute_id*` |
+| **解析文本生成智能纪要** | `7204936B2ACC4B12A1CECD1DAB60DD97` | `minuteId*` |
+| 获取解析纪要音频结果 | `1DB38C10699A47E89DD7CEFDAA76B8A1` | **由后台解析任务自己触发，不要手动调**（见下节） |
 
-调用示例（解析附件）：
+智能纪要页面 id（`mt_minutes_ai_page`，租户级、无接口可查）：**`1250830691712172036`**。
+`meeting.minute.fromGroupChat` 已内置上述三个 primary_key 与页面 id 作默认值，
+换租户用入参 `flowGenerateMinutes` / `flowGenerateDocument` / `aiPageId` 覆盖。
+
+调用示例（生成纪要文案 → 生成文档，实测 resultCode=200）：
 
 ```bash
-weaver-work-cli esb run esb.trigger.prepare --input-json '{"employeeId":"<员工id>","esbFlowId":"<解析附件flowId>","customParams":{"mainTable":{"minuteId":"<纪要id>","mt_id":"<会议id>","file_type":"1","video_file":"<附件id>","mtAIMinutePageID":""}}}'
+# ① 解析文本 → 智能纪要文本（写 parse_content）
+weaver-work-cli esb run esb.trigger.prepare --input-json '{"employeeId":"<员工id>","uniqueIndent":"7204936B2ACC4B12A1CECD1DAB60DD97","customParams":{"mainTable":{"minuteId":"<纪要id>"}}}'
+weaver-work-cli esb run esb.trigger.apply --input-json '{"continuation":"<上一步返回值>","confirm":true}'
+
+# ② 保存解析并生成文档（回写 mt_minutes，返回 customData.mainTable.wdID）
+weaver-work-cli esb run esb.trigger.prepare --input-json '{"employeeId":"<员工id>","uniqueIndent":"1F638AE31BC746C28A1D9DCF26D91037","customParams":{"mainTable":{"parse_content":"<①产出的正文>","mt_minute_id":"<纪要id>"}}}'
 weaver-work-cli esb run esb.trigger.apply --input-json '{"continuation":"<上一步返回值>","confirm":true}'
 ```
 

package/skills/weaver-e10-shared/SKILL.md

@@ -53,7 +53,7 @@ XiaoE 环境有两种识别入口：桌面客户端由 Agent 根据宿主或任
 - 工作目录名含 `xiaoeUserData`、使用 XiaoE 内置 Node.js，或已安装相关 CLI；
 - 过去在同一台机器上登录或安装过 XiaoE。
 
-桌面客户端首次没有本地会话时，Agent 判定为 XiaoE 后显式执行 `weaver-work-cli auth xiaoe`；后续业务命令只有需要 XiaoE 专属业务行为时才在 `weaver-work-cli` 之后加 `--runtime-agent xiaoe`，例如 `weaver-work-cli --runtime-agent xiaoe workflow ...`。已保存的 XiaoE 会话过期恢复不依赖这个参数，也不依赖 Skill 或 Agent：CLI 会根据会话内的 `agentType` / `loginSource` 在公共请求层自行处理。`--runtime-agent` 不携带、不选择凭据。
+桌面客户端首次没有本地会话时，Agent 判定为 XiaoE 后可显式执行 `weaver-work-cli auth xiaoe`，或通过 `--runtime-agent xiaoe` 标识宿主，让业务命令在加载会话时自动获取登录信息，例如 `weaver-work-cli --runtime-agent xiaoe workflow ...`；网页端已有 `XIAOE_*` 标记时自动识别。已保存的 XiaoE 会话过期恢复不依赖这个参数，也不依赖 Skill 或 Agent：CLI 会根据会话内的 `agentType` / `loginSource` 在公共请求层自行处理。`--runtime-agent` 表示运行时身份，不携带凭据。
 
 WorkBuddy、Codex 及其他智能体一律使用 `weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_type "<当前智能体名称>"` 走浏览器 OAuth。`auth login` / `auth oidc` 不会读取或消费 XiaoE 凭据。
 
@@ -67,9 +67,9 @@ Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读
 
 下述 `auth xiaoe` 流程仅适用于上述已确认的 XiaoE 智能体环境；其他智能体不执行宿主脚本检测，直接进入浏览器 OAuth 流程。`auth xiaoe` 命令本身就是认证方式的显式选择；`hasXiaoEEnv` 使用桌面的 `--runtime-agent xiaoe` 或任意 `XIAOE_*` 环境变量识别运行环境。
 
-首次缺少本地会话时只运行 `weaver-work-cli auth xiaoe`。CLI 内部按「平台凭证 Node 换票 → CLI 自带 `xiaoe_env.py` 兼容换票 → 宿主 `tokens.py` → 桌面 XiaoE 客户端会话 → `WEAVER_XIAOE_*` 环境映射」顺序取凭据；其中 `XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 地址。`xiaoe_env.py` 属于 CLI npm 包，不放入 shared Skill，且只能由 CLI 内部执行和解析。已有 XiaoE 会话被接口明确拒绝为失效时，CLI 根据会话元数据在公共请求层静默恢复并重放一次；这个流程绕开 shared Skill，Agent 不参与，也不得再补跑登录或原业务命令。失败时 CLI 返回最终结构化错误。
+首次缺少本地会话时，已识别为 XiaoE 的业务命令会在 CLI 公共会话加载层自动获取登录信息；如需提前登录，只运行 `weaver-work-cli auth xiaoe`。CLI 内部按「平台凭证 Node 换票 → CLI 自带 `xiaoe_env.py` 兼容换票 → 宿主 `tokens.py` → 桌面 XiaoE 客户端会话 → `WEAVER_XIAOE_*` 环境映射」顺序取凭据；其中 `XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 地址。`xiaoe_env.py` 属于 CLI npm 包，不放入 shared Skill，且只能由 CLI 内部执行和解析。已有 XiaoE 会话达到换票结果的 `expiryTimes` 时，CLI 会在业务请求发出前静默换票；已有 XiaoE 会话被接口明确拒绝为失效时，CLI 根据会话元数据在公共请求层静默恢复并重放一次。这个流程绕开 shared Skill，Agent 不参与，也不得再补跑登录或原业务命令。失败时 CLI 返回最终结构化错误。
 
-1. 首次无本地登录态、准备执行业务命令前需要建立 E10 会话，或 `auth status --no-check` 显示未登录时，运行：
+1. 首次无本地登录态、需要在业务命令之前显式建立 E10 会话时，可运行：
    ```text
    weaver-work-cli auth xiaoe
    ```
@@ -77,7 +77,7 @@ Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读
 3. XiaoE 统一登录由 CLI 按序取凭证：① 平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`，先走 Node 换票，再由 CLI npm 包自带的标准库 `xiaoe_env.py` 作兼容回退；② 宿主 `xiaoeUserData/tokens.py`（仅桌面宿主，CLI 在 macOS/Windows 都会先自动发现 XiaoE 客户端内置 Python，再回退到系统 Python）；③ 内置原生实现读取桌面 XiaoE 客户端会话换取 `eteamId`，依次查找 `XIAOE_USER_SETTINGS_PATH`、`XIAOE_ROBOT_DATA_ROOT` / `XIAOE_ROBOT_ROOT` 和默认 `XiaoE/Robots/<id>/user_settings.json`，因此会话有效时不要求存在 `tokens.py`；④ `WEAVER_XIAOE_*` 环境映射。宿主只注入 `XIAOE_DOMAIN`、`XIAOE_USER_TOKEN` 等平台变量，不会注入 ETEAMSID 环境变量，CLI 也不读取 `XIAOE_ETEAMSID`。Agent 不要打印、转述、索取或要求用户手动设置这些凭证，也不要直接执行任一脚本或因为脚本报缺依赖就让用户安装 Python 包——凭据链内部的兼容回退由 CLI 完成。
 4. `auth xiaoe` 是 XiaoE 认证方式的显式入口：CLI 不再判断当前宿主，只检查并消费可用凭据源。E10 目标地址按「显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → CLI 内置默认值」解析，绝不能把 `XIAOE_DOMAIN` 当作 E10 地址。Token、Cookie、ETEAMSID 仍属于凭证，禁止在回复中展示。
 5. XiaoE 统一登录走不通时，无论 macOS、Windows、Linux 或 Web，CLI 都返回 `authentication/xiaoe_credential_unavailable`，绝不自动打开浏览器或降级到 `auth login`；本任务必须停止，不得另行调用其他登录 Skill 或登录命令。
-6. `auth status --no-check` 不会触发 XiaoE 统一登录；业务命令加载到 `agentType=XiaoE` 或 `loginSource=xiaoe-unified` 的会话并被 E10 明确拒绝为失效时，即使没有 `XIAOE_*` 或 `--runtime-agent xiaoe`，也会静默触发一次统一登录并重放该请求一次。首次无本地会话仍须显式执行 `auth xiaoe`；具体读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
+6. `auth status --no-check` 不会触发 XiaoE 统一登录；业务命令加载到 `agentType=XiaoE` 或 `loginSource=xiaoe-unified` 的会话并被 E10 明确拒绝为失效时，即使没有 `XIAOE_*` 或 `--runtime-agent xiaoe`，也会静默触发一次统一登录并重放该请求一次。无可读取的本地会话时，则需要当前 `XIAOE_*` 或 `--runtime-agent xiaoe` 等宿主标记才能自动获取；显式 `--auth` 不触发自动替换。具体读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
 
 ### 认证错误只报告状态，不指定登录命令
 
@@ -202,4 +202,4 @@ User-Agent: AgentType=<agentType>,IsAgent=true
 
 7. 附件、图片上传或文件解析属于敏感数据处理。即便 operation 风险等级不是高风险写入，也必须先取得用户对“文件内容可能进入大模型/外部解析服务”的明确确认；不能把用户仅提供文件路径或文件名视为同意解析或上传。
 
-8. Agent 明确选择 `auth xiaoe` 后，CLI 按顺序从平台注入凭证（Node 换票后由 CLI npm 包自带 `xiaoe_env.py` 兼容回退）、宿主 `xiaoeUserData/tokens.py`、内置原生实现读取的桌面 XiaoE 客户端会话（宿主注入路径优先、默认 `XiaoE/Robots/<id>/user_settings.json` 回退）、`WEAVER_XIAOE_*` 环境映射读取支持统一登录的凭证。业务命令不会在首次无会话时自动登录，但已有会话被接口明确拒绝时会根据持久化会话的 `agentType` / `loginSource` 静默恢复 1 次，不要求 Agent 添加 `--runtime-agent xiaoe`；该参数仅用于其他 XiaoE 专属业务行为。不要要求用户提供、展示或手动设置这些凭证。任意系统失败时都反馈结构化错误，不自动降级浏览器。
+8. Agent 明确选择 `auth xiaoe` 后，或业务命令在已识别的 XiaoE 运行时发现本地会话缺失时，CLI 按顺序从平台注入凭证（Node 换票后由 CLI npm 包自带 `xiaoe_env.py` 兼容回退）、宿主 `xiaoeUserData/tokens.py`、内置原生实现读取的桌面 XiaoE 客户端会话（宿主注入路径优先、默认 `XiaoE/Robots/<id>/user_settings.json` 回退）、`WEAVER_XIAOE_*` 环境映射读取支持统一登录的凭证。已有会话被接口明确拒绝时会根据持久化会话的 `agentType` / `loginSource` 静默恢复 1 次，不要求 Agent 添加 `--runtime-agent xiaoe`。不要要求用户提供、展示或手动设置这些凭证。任意系统失败时都反馈结构化错误，不自动降级浏览器。

package/skills/weaver-e10-shared/references/e10-auth-and-session.md

@@ -29,7 +29,7 @@ weaver-work-cli auth whoami
 - 业务命令失败，stderr JSON 中 `error.type === "authentication"`（如 `E10 auth not found`）
 - 业务命令返回 `error.subtype === "session_expired"`（E10 登录态 401/302 失效）
 
-CLI 的认证错误只是状态信号，不是登录命令。已有 XiaoE 会话过期时，公共请求层会根据持久化会话的 `agentType` / `loginSource` 自动恢复，不依赖 `XIAOE_*`、`--runtime-agent xiaoe`、shared Skill 或 Agent。仅首次无会话、`auth not found` 等认证缺失才进入下述显式登录流程。
+CLI 的认证错误只是状态信号，不是登录命令。已有 XiaoE 会话达到换票结果的 `expiryTimes` 时，CLI 会在业务请求发出前静默换票；被接口判定过期时，公共请求层会根据持久化会话的 `agentType` / `loginSource` 自动恢复，不依赖 `XIAOE_*`、`--runtime-agent xiaoe`、shared Skill 或 Agent。业务命令无可读取的本地会话时，若当前 `XIAOE_*`、`--runtime-agent xiaoe` 等标记已识别为 XiaoE，公共会话加载层也会先静默获取登录信息。失败时返回 `xiaoe_credential_unavailable`，提示已尝试自动获取，Agent 只反馈并停止；不要再次登录或重跑。需要在业务命令之前主动建立会话时，可按下述流程显式登录。
 
 此时**禁止**：
 
@@ -40,12 +40,12 @@ CLI 的认证错误只是状态信号，不是登录命令。已有 XiaoE 会话
 
 **正确流程（按序执行，缺一不可）：**
 
-0. **仅首次无本地会话时，由 XiaoE 智能体环境主动选择统一登录**：桌面端宿主/任务上下文明确标识为 XiaoE，或网页端命中原有环境变量判断时，才运行：
+0. **首次无本地会话且需要提前登录时，由 XiaoE 智能体环境显式选择统一登录**：桌面端宿主/任务上下文明确标识为 XiaoE，或网页端命中原有环境变量判断时，才运行：
    ```text
    weaver-work-cli auth xiaoe
    ```
    本机存在 `xiaoeUserData/tokens.py`、XiaoE 客户端目录、工作目录或历史登录，都不能作为宿主身份依据。桌面客户端可由 `--runtime-agent xiaoe` 标识；命令进程中存在任意 `XIAOE_*` 变量时也直接标识为 XiaoE。未命中这两类判断的 WorkBuddy、Codex 及其他智能体必须跳过此步，进入下方浏览器 OAuth 流程。
-   CLI 会按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile `config.baseUrl` → CLI 内置默认值”解析 E10 登录域名；`XIAOE_DOMAIN` 只作为 XiaoE/erpa 换票服务地址。业务命令不会在缺少本地会话时主动登录；已有会话被接口明确拒绝为失效时，公共请求层根据会话内 `agentType=XiaoE` 或 `loginSource=xiaoe-unified` 静默恢复并重放一次，不要求 Agent 添加 `--runtime-agent xiaoe`。恢复失败或重放后仍失效时，Agent 只反馈最终错误并停止，不再运行登录或业务命令。
+   CLI 会按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile `config.baseUrl` → CLI 内置默认值”解析 E10 登录域名；`XIAOE_DOMAIN` 只作为 XiaoE/erpa 换票服务地址。已识别为 XiaoE 的业务命令缺少本地会话时会静默尝试统一登录；已有会话被接口明确拒绝为失效时，公共请求层根据会话内 `agentType=XiaoE` 或 `loginSource=xiaoe-unified` 静默恢复并重放一次，不要求 Agent 添加 `--runtime-agent xiaoe`。恢复失败或重放后仍失效时，Agent 只反馈最终错误并停止，不再运行登录或业务命令。
 
 1. **仅非 XiaoE 环境进入本步**。禁止先执行 `auth xiaoe` 或调用其他登录 Skill。先调用宿主提供的提问 / 弹框能力询问用户，让用户二选一：
    - 输入本次要登录的 E10 登录域名（base URL），形如 `https://<企业域名>`；或

package/skills/weaver-e10-wenshuding/SKILL.md

@@ -3,9 +3,9 @@ name: weaver-e10-wenshuding
 display_name: 泛微E10文书定档案管理
 display_name_en: Weaver E10 Wenshuding
 description: "泛微 E10 文书定档案管理：全宗与预归档库、全文检索、档案基本信息、借阅车、借阅单、原文下载、发起借阅/续借流程页与预归档上传确认链。"
-description_zh: "泛微 E10 文书定档案管理。支持查询全宗与预归档电子文件库、全文检索可借档案、查看档案基本信息、查看借阅车并直接加入档案（免确认写操作）、查看借阅单与详情、下载借阅单原文 zip，并通过 prepare/apply 确认链处理发起借阅、续借和预归档上传。全宗信息仅在预归档上传时需要查询；借阅相关流程页面默认用系统默认浏览器打开。全文检索结果的默认返回显示样式为三段式卡片视图（标题可点击、命中词高亮、全宗/分类/日期摘要行）。"
+description_zh: "泛微 E10 文书定档案管理。支持查询全宗与预归档电子文件库、全文检索可借档案、查看档案基本信息、查看借阅车并直接加入档案（免确认写操作）、查看借阅单与详情、下载借阅单原文 zip，并通过 prepare/apply 确认链处理发起借阅、续借和预归档上传。全宗信息仅在预归档上传时需要查询；借阅/续借流程页只生成 Markdown 超链接（a 标签）返回，不自动打开浏览器，由客户端决定打开方式。全文检索结果的默认返回显示样式为三段式卡片视图（标题可点击、命中词高亮、全宗/分类/日期摘要行）。"
 description_en: "Weaver E10 Wenshuding archive skill for fonds and pre-archive libraries, full-text search, archive info, borrow car, borrow orders, original file packaging and download, borrow/renew workflow URL generation, and confirmed pre-archive upload."
-version: 1.0.4
+version: 1.0.5
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -24,7 +24,21 @@ cliHelp: "weaver-work-cli archive --help"
 
 本 Skill 是 CLI 型技能，不自行发起 HTTP 请求：认证与会话**统一由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系托管**，禁止自建或绕过登录流程。
 
-请求头三件套（Cookie 完整原始串 / `eteamsid` / `User-Agent`）由 `weaver-work-cli` 统一注入，唯一权威声明见 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md) 的「请求头契约」章节。
+接口请求头（由 CLI 注入，Agent 不手写）：
+
+```text
+Cookie: <登录返回的完整原始 Cookie 串>   # 禁止裁剪、去重或改写
+eteamsid: <登录返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+| 凭证 | 取值与要求 |
+| --- | --- |
+| `Cookie` | 登录返回的**完整原始 Cookie 串**，禁止裁剪、去重或改写 |
+| `eteamsid` | 登录返回的 `ETEAMSID` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
+完整权威说明见 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md) 的「请求头契约」章节。
 
 Agent 不得自行拼接、改写或向用户索取上述凭证（禁止要求用户贴 Cookie / ETEAMSID / token），也不得直接 `curl` / `fetch` E10 接口。
 所有命令通过 `weaver-work-cli --json archive run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli archive schema` 是 operation、字段和风险等级的合约来源。
@@ -41,7 +55,7 @@ Agent 不得自行拼接、改写或向用户索取上述凭证（禁止要求
 
 出现以下任一语义时，优先走本 Skill：
 
-- 文书定 / 档案 / 全宗 / 收集库 / 管理库 / 预归档库 / 电子文件库
+- 文书定 / 档案 / 全宗 / 收集库 / 管理库 / 预归档库 / 电子文件库 / 我上传的档案 / 我上传的档案文件
 - 档案检索 / 全文检索 / 可借档案 / 档号 / 案卷 / 保管期限 / 密级 / 库位
 - 借阅车 / 加入借阅车 / 我的借阅车
 - 借阅单 / 我的借阅 / 借阅记录 / 续借 / 归还期限
@@ -57,6 +71,11 @@ Agent 不得自行拼接、改写或向用户索取上述凭证（禁止要求
 |---|---|---|
 | 查看可用 operation、字段和风险等级 | `archive schema` | [`archive-agent-entry.md`](references/archive-agent-entry.md) |
 | 查询全宗 / 预归档电子文件库节点 | `archive run archive.fonds.list` / `archive.prelib.tree` | [`archive-fonds.md`](references/archive-fonds.md) |
+| 查看电子文件库列表（预归档库内的数据） | `archive run archive.prelib.list` | [`archive-prelib-list.md`](references/archive-prelib-list.md) |
+| 查看我的档案 / 我上传的档案（默认我上传的电子文件库） | `archive run archive.prelib.list` | [`archive-prelib-list.md`](references/archive-prelib-list.md) |
+| 对电子文件库数据做智能识别 | `archive run archive.prelib.intelligent.prepare` -> 用户确认 -> `.apply` | [`archive-prelib-list.md`](references/archive-prelib-list.md) |
+| 提交整理（预归档数据整理提交） | `archive run archive.prelib.arrange.prepare` -> 用户确认 -> `.apply` | [`archive-prelib-arrange.md`](references/archive-prelib-arrange.md) |
+| 打开某条预归档档案（生成链接） | `archive run archive.prelib.open` | [`archive-prelib-open.md`](references/archive-prelib-open.md) |
 | 全文检索可借档案（默认卡片视图展示） | `archive run archive.search.run` | [`archive-search.md`](references/archive-search.md) |
 | 查看档案基本信息 | `archive run archive.info.get` | [`archive-info.md`](references/archive-info.md) |
 | 查看借阅车 | `archive run archive.borrow-car.list` | [`archive-borrow-car.md`](references/archive-borrow-car.md) |
@@ -72,11 +91,15 @@ Agent 不得自行拼接、改写或向用户索取上述凭证（禁止要求
 处理链：
 
 - 检索并借阅：`archive.search.run` -> 用户选择条目 -> `archive.borrow-car.add`（免确认直接加入）-> 需要时 `archive.borrow-car.list` 复核
-- 从借阅车发起借阅：`archive.borrow-car.list` 取 `arcDangan` 与 `dataId` -> `archive.flow.borrow-car.prepare` -> 用户确认 -> `.apply` -> 用系统默认浏览器打开返回的流程创建页 URL（仅用户强调内置打开时用 IDE 内置视图）
+- 从借阅车发起借阅：`archive.borrow-car.list` 取 `arcDangan` 与 `dataId` -> `archive.flow.borrow-car.prepare` -> 用户确认 -> `.apply` -> 把流程创建页 URL 以 Markdown 超链接（a 标签）返回，不自动打开浏览器，由客户端决定打开方式
 - 从检索结果直接发起借阅：`archive.search.run` 取 `id`+`formId` -> `archive.flow.search.prepare` -> 用户确认 -> `.apply` -> 同上默认系统浏览器打开 URL
 - 续借：`archive.borrow-list.list` 取 `dataId` -> `archive.flow.renew.prepare` -> 用户确认 -> `.apply` -> 同上默认系统浏览器打开 URL
 - 下载原文：`archive.borrow-list.list` 取 `dataId` -> `archive.borrow-list.download.prepare`（校验未超期且有可下载原文）-> 用户确认 -> `.apply`（轮询打包并落盘）
-- 预归档上传：`archive.fonds.list` 取全宗 `id` -> 需要时 `archive.prelib.tree` 取 `treeId` -> `archive.upload.prelib.prepare` -> 用户确认 -> `.apply`
+- 查看我的档案 / 我上传的档案：`archive.prelib.list`（默认即"我上传的电子文件库"数据，不传 treeId 自动取电子文件库节点）
+- 提交整理：`archive.prelib.list` 取行 id -> `archive.prelib.arrange.prepare` -> 用户确认 -> `.apply`（只处理识别成功的数据，必须原样转达服务端 message，见 [`archive-prelib-arrange.md`](references/archive-prelib-arrange.md)）
+- 打开档案链接：`archive.prelib.list` 取行 id -> `archive.prelib.open` 生成 `/sp/custom/archive/fileLibEdit?singleMetaId=行id&treeId=节点treeId`（见 [`archive-prelib-open.md`](references/archive-prelib-open.md)）
+- 预归档上传：`archive.fonds.list` 取全宗 `id`（**名称字段是 `fonds_name`，不是 `name`/`content`**）-> 需要时 `archive.prelib.tree` 取 `treeId` -> `archive.upload.prelib.prepare` -> `.apply`（用户已给出文件 + 明确全宗即视为已确认，直接上传；全宗未定、有歧义或多节点未指定时必须先问，详见 [`archive-upload.md`](references/archive-upload.md)）
+- 查看并识别电子文件库数据：`archive.prelib.list`（取列表与行 `id`）-> 用户勾选 -> `archive.prelib.intelligent.prepare` -> 用户确认 -> `.apply` -> 返回识别任务 `taskId`（异步，不要声称识别完成）
 
 ## 执行原则（减少误路由、误重试和无效消耗）
 

package/skills/weaver-e10-wenshuding/references/archive-borrow-list.md

@@ -39,6 +39,20 @@ weaver-work-cli --json archive run archive.borrow-list.detail --input-json '{"da
 - 表格样式：所有列（表头与内容）居中显示。
 - 无值列留空或用 `-`；题名过长时截断。
 
+## 详情展示（档案题名必须可点击）
+
+`archive.borrow-list.detail` 返回的 `details[].arcDangan[]` 每项都带 `name`、`viewPath`、`url`（已拼好环境域名）。
+
+展示借阅明细时，**"档案"列用题名做超链接**（Markdown `[题名](url)`，渲染即 `<a>`），点击在系统里打开该档案：
+
+| 档案 | 档号 | 文件日期 | 借阅方式 |
+| :---: | :---: | :---: | :---: |
+| [发文](http://host/sp/custom/archive/archiveView?arcId=...&arcFormId=...) | GXDA-XZ·2025-30-8 | 2025-11-03 | 电子查看、下载 |
+
+- 优先用 `url`（含域名，可直接点）；`url` 为空时用 `viewPath` 自行拼当前环境域名。
+- `id` 形如 `{档案ID}_{表单ID}`，是内部标识，**不要直接展示**，也不要让用户抄。
+- 同一明细有多条档案时，每条都要带链接；无 `url` 时退回纯文本题名，不要拼半个链接。
+
 ## 字段复用
 
 - `dataId` 是借阅单主表 ID，用于查看详情、下载和续借。

package/skills/weaver-e10-wenshuding/references/archive-download.md

@@ -43,6 +43,8 @@ weaver-work-cli --json archive run archive.borrow-list.download.apply --input-js
 ## 注意
 
 - 下载是异步任务，`.apply` 可能持续一段时间；进度只在终端以进度条形式反馈，Agent 不要因为等待就中断并重试。
+- 文件下载接口可能返回 **302 重定向**（跳到文件服务/CDN）。CLI 已对下载请求开启跟随重定向，**不会再把这种 302 误判为登录失效**；若仍报 `session_expired`，才是真的需要重新登录。
+- 提交打包任务与下载是两个阶段：`batchDownloadBorrowZip`（提交）→ 轮询进度 → `file/remotedownload`（取文件）。若提交和轮询都成功、只有最后一步失败，说明是下载环节问题，不要把整个任务重复提交。
 - 打包完成前中断会浪费一次服务端任务；中断后如需继续，重新执行 `.prepare` 再 `.apply`。
 - 涉及本地文件写入：下载到的 zip 可能包含敏感档案内容，**必须先提醒用户文件内容会落到本地磁盘并可能进入当前大模型上下文，等待用户明确确认后才执行 `.apply`**。
 - `exportType=0`（直接导出）时其余三个分组字段必须为空；`exportType=1` 时按结构补齐分组字段，字段取值只能取档案基础字段候选。

package/skills/weaver-e10-wenshuding/references/archive-flow.md

@@ -41,6 +41,6 @@ weaver-work-cli --json archive run archive.flow.renew.prepare --input-json '{"da
 ## 注意
 
 - `.prepare` 会检查是否绑定借阅流程；未绑定时返回 `validation/borrow_flow_unbound`，应提示联系管理员在档案设置中绑定借阅流程，不要重试。
-- `.apply` 返回的是**流程创建页 URL**，CLI 不自动打开浏览器。Agent 拿到 URL 后**默认用系统默认浏览器打开**供用户填写提交（macOS `open`，Windows `start`），除非用户明确要求“在 IDE 内置浏览器打开”；不要声称“已发起借阅申请”。
+- `.apply` 返回的是**流程创建页 URL**，CLI 不自动打开浏览器，**Agent 也不要自动打开**（不要执行 `open` / `start`）。把 URL 作为 **Markdown 超链接**返回，例如 `[填写并提交](URL)`（渲染即 `<a>` 标签），由客户端/用户自行决定打开方式（内置浏览器、系统浏览器或复制链接）。不要声称“已发起借阅申请”。
 - 从借阅车发起会缓存档案与借阅车两组参数（两次缓存写入），从检索结果发起只缓存档案，续借不缓存。
 - URL 中的缓存参数由服务端生成，Agent 不要手工拼接或改写 URL。

package/skills/weaver-e10-wenshuding/references/archive-prelib-arrange.md

@@ -0,0 +1,76 @@
+# 提交整理（预归档电子文件库）
+
+## 什么时候读取
+
+用户要对电子文件库里的数据做「提交整理 / 整理 / 归档整理」时读取本文件。写操作前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
+
+## 链路
+
+`archive.prelib.list` 取列表 -> 用户给序号 -> 取 `rows[序号-1].id` -> 提交整理。
+
+| 阶段 | Operation | 必填输入 |
+| --- | --- | --- |
+| 准备 | `archive.prelib.arrange.prepare` | `checkIds`；可选 `treeId`、`formId` |
+| 提交 | `archive.prelib.arrange.apply` | `continuation`、`confirm=true` |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.prelib.arrange.prepare --input-json '{"checkIds":["1313909785262178418"]}'
+
+weaver-work-cli --json archive run archive.prelib.arrange.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.prelib.arrange.prepare --input-json '{"checkIds":["1313909785262178418"]}'
+
+weaver-work-cli --json archive run archive.prelib.arrange.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 前置参数
+
+- `checkIds` 取 `archive.prelib.list` 返回 `rows[n].id`（该列 `hide=true` 不展示），**按用户给的序号取，不要让用户抄 id**。
+- `treeId` 取 `archive.prelib.tree` 的电子文件库节点 `id`；不传时自动取第一个节点。
+- `formId` 不传时取 `getTreeDetail` 的 `extraParams.metaFormId`。
+
+## 接口
+
+`POST /api/archive/core/prefileBatch/batchSave`（无 query 参数）
+
+```json
+{
+  "treeId": "1229705529974292495_1229705529974292495",
+  "autoBatchProduct": true,
+  "formId": "1042286248190812199",
+  "checkIds": "1330598993225465906",
+  "logFlag": "preLib"
+}
+```
+
+与智能识别 `intelligentCate` **完全同参**，只多一个 `autoBatchProduct: true`。
+
+## 提交前：只有「已识别」的数据会被处理
+
+- 提交整理**只处理识别状态为「已识别」**的数据；**未识别、识别中、识别异常**的行会被服务端**自动过滤掉**。
+- 所以提交前先看列表的 `read_state`：若不是"已识别"，**先提示用户**——这些行提交了也不会被处理，建议先做智能识别并确认识别成功（可再查一次列表确认状态变为"已识别"）。
+- 用户仍要提交也可以提交：**后台会过滤，不会报错**，但必须如实转达服务端 `message`，并说明实际处理了 0 条。
+
+## 关键：不要声称"整理完成"
+
+- 该接口**只处理识别成功的数据**；未识别、识别异常的行会被跳过。
+- 响应**没有 `data`**，处理说明在顶层 `msg`，例如：
+
+  ```
+  选中1条数据包含1条异常数据，系统仅处理0条识别成功的数据！
+  ```
+
+- 必须把 `message` **原样转达**给用户，不要说"已整理完成"。
+- 若处理条数为 0（全是未识别/异常），要提示用户先做**智能识别**，识别成功后再提交整理。
+
+## 注意
+
+- 提交整理是**写操作**：必须先 `prepare`、用户明确确认后才 `apply`，不要自动补 `confirm=true`。
+- 任一步失败直接报错，不要自动重放 `.apply`。
+- 未拿到 `treeId`（预归档树返回空）时按 [`archive-prelib-list.md`](archive-prelib-list.md) 的"获取不到节点"规则处理：重新获取一次 -> 仍无则判无权限并停止，**不要猜测 treeId**。