weaver-work-cli 0.1.5 → 0.1.7

package/skills/weaver-e10-yimiaoban/references/msg-write.md

@@ -2,20 +2,20 @@
 
 ## 何时使用
 
-给某人/某群发文本、图片或文件消息；撤回自己 2 分钟内的消息；群消息置顶/取消置顶。全部是两段式写操作：
+给某人/某群发文本、图片或文件消息；撤回自己发出的消息（时限以回包 `withdrawInterval` 为准）；群消息置顶/取消置顶。全部是两段式写操作：
 
 | operation 对 | 动作 |
 | --- | --- |
-| `yimiaoban.msg.send.single.prepare` / `.apply` | 发送单聊消息 |
-| `yimiaoban.msg.send.group.prepare` / `.apply` | 发送群聊消息 |
-| `yimiaoban.msg.withdraw.prepare` / `.apply` | 撤回消息（`type`=single/group） |
-| `yimiaoban.msg.top.set.prepare` / `.apply` | 群消息置顶/取消（`type`:1 置顶 2 取消，或 `cancel:true`） |
+| `im.msg.send.single.prepare` / `.apply` | 发送单聊消息 |
+| `im.msg.send.group.prepare` / `.apply` | 发送群聊消息 |
+| `im.msg.withdraw.prepare` / `.apply` | 撤回消息（`type`=single/group） |
+| `im.msg.top.set.prepare` / `.apply` | 群消息置顶/取消（`type`:1 置顶 2 取消，或 `cancel:true`） |
 
 ## 输入要点（prepare 阶段）
 
 - 发送单聊：`toUid`+`toCid`（接收人，先用 `person.resolve` 解析）；群聊：`groupId`。文本用 `txt`；图片用本地路径 `img`；文件用本地路径 `file`（CLI 会先上传到 E10 文件服务再发送，`img`/`file` 与 `txt` 可组合）。
 - **全空白文本（空格/换行）不算内容，会被拒绝（`content_required`）**；`img` 与 `file` 一次只能传一种（`content_conflict`）。
-- 撤回：`type`（single/group）+ `msgid`（消息 `ser_msgid`）；单聊还需 `toUid`/`toCid`，群聊还需 `groupId`。**只能撤回本人 2 分钟内发出的消息**；回包带 `time_out` 时会返回 `withdrawInterval`（如"2 分钟"），超时（1505）错误里也会带上该时限。
+- 撤回：`type`（single/group）+ `msgid`（消息 `ser_msgid`）；单聊还需 `toUid`/`toCid`，群聊还需 `groupId`。**只能撤回本人发出的消息，且有时限**——`apply` 回包会给出该环境实际时限（`withdrawInterval`，实测如"30 秒"，不同环境可能是"2 分钟"），超时（1505）错误里也会带上；以回包值为准，不要写死时限。
 - 置顶：`groupId` + `msgid` + `type`（1 置顶 / 2 取消）。
 - 本地文件路径：绝对路径或相对 CLI 运行目录的路径均可；上传前必须先与用户确认该文件内容可能进入大模型上下文并被发送到 E10 文件服务。
 
@@ -24,13 +24,13 @@
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json yimiaoban run yimiaoban.msg.send.group.prepare --input-json '{"groupId":"1788334281700000004","txt":"下午 3 点评审，请准时参加"}'
+weaver-work-cli --json im run im.msg.send.group.prepare --input-json '{"groupId":"1788334281700000004","txt":"下午 3 点评审，请准时参加"}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json yimiaoban run yimiaoban.msg.send.group.prepare --input-json '{"groupId":"1788334281700000004","txt":"下午 3 点评审，请准时参加"}'
+weaver-work-cli --json im run im.msg.send.group.prepare --input-json '{"groupId":"1788334281700000004","txt":"下午 3 点评审，请准时参加"}'
 ```
 
 prepare 返回 `data.summary`（动作/目标/内容预览）与 `data.continuation`。向用户确认后执行 apply：
@@ -38,13 +38,13 @@ prepare 返回 `data.summary`（动作/目标/内容预览）与 `data.continuat
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json yimiaoban run yimiaoban.msg.send.group.apply --input-json '{"confirm":true,"continuation":"<prepare 返回的 continuation>"}'
+weaver-work-cli --json im run im.msg.send.group.apply --input-json '{"confirm":true,"continuation":"<prepare 返回的 continuation>"}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json yimiaoban run yimiaoban.msg.send.group.apply --input-json '{"confirm":true,"continuation":"<prepare 返回的 continuation>"}'
+weaver-work-cli --json im run im.msg.send.group.apply --input-json '{"confirm":true,"continuation":"<prepare 返回的 continuation>"}'
 ```
 
 ## 注意

package/skills/weaver-e10-yimiaoban/references/person.md

@@ -6,8 +6,8 @@
 
 | operation | 用途 |
 | --- | --- |
-| `yimiaoban.person.resolve` | 按姓名/工号/手机/邮箱**模糊**查询在职员工 → uid/cid/部门 |
-| `yimiaoban.person.resolveByIds` | 按 uid 批量解析 → 姓名/部门/岗位/cid（一次最多 100，超出自动分批） |
+| `im.person.resolve` | 按姓名/工号/手机/邮箱**模糊**查询在职员工 → uid/cid/部门 |
+| `im.person.resolveByIds` | 按 uid 批量解析 → 姓名/部门/岗位/cid（一次最多 100，超出自动分批） |
 
 ## 输入要点
 
@@ -20,15 +20,15 @@
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json yimiaoban run yimiaoban.person.resolve --input-json '{"name":"初四十九"}'
-weaver-work-cli --json yimiaoban run yimiaoban.person.resolveByIds --input-json '{"ids":["100234","100235"]}'
+weaver-work-cli --json im run im.person.resolve --input-json '{"name":"初四十九"}'
+weaver-work-cli --json im run im.person.resolveByIds --input-json '{"ids":["100234","100235"]}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json yimiaoban run yimiaoban.person.resolve --input-json '{"name":"初四十九"}'
-weaver-work-cli --json yimiaoban run yimiaoban.person.resolveByIds --input-json '{"ids":["100234","100235"]}'
+weaver-work-cli --json im run im.person.resolve --input-json '{"name":"初四十九"}'
+weaver-work-cli --json im run im.person.resolveByIds --input-json '{"ids":["100234","100235"]}'
 ```
 
 ## 注意

package/skills/weaver-e10-yimiaoban/references/safety-boundaries.md

@@ -1,21 +1,23 @@
 # 易秒办红线与边界
 
-本文件汇总易秒办业务域**不可违反**的红线，供写操作/消息展示前自查。写协议（prepare→apply、continuation、停止条件）见 [`msg-write.md`](msg-write.md)、[`ding-write.md`](ding-write.md)、[`group-write.md`](group-write.md)；共享层通用规则见 `weaver-work-cli-shared`。
+本文件汇总易秒办业务域**不可违反**的红线，供写操作/消息展示前自查。写协议（prepare→apply、continuation、停止条件）见 [`msg-write.md`](msg-write.md)、[`ding-write.md`](ding-write.md)、[`group-write.md`](group-write.md)；共享层通用规则见 `weaver-e10-shared`。
 
 ## 红线（违规 = 必须停下说明，不绕过）
 
 1. **请求体禁止操作人字段**：任何 operation 的输入都不接受 `user`/`sender`/`creator`/`operator` 等操作人字段；操作者由会话 `eteamsid` 识别。不要在入参里补这些字段，CLI 会直接拒绝（`forbidden_keys`）。
-2. **人名一律走 hrm**：姓名解析（消息发送者、群成员、阅读人、@提及）只认 `yimiaoban.person.resolve`/`resolveByIds`（底层 `/api/hrm/common/getEmployeeByIds`）或消息行里的 hrm 姓名；**禁止用 IM 群成员接口返回的 `name` 字段**展示姓名，禁止本地猜测/拼表。
+2. **人名一律走 hrm**：姓名解析（消息发送者、群成员、阅读人、@提及）只认 `im.person.resolve`/`resolveByIds`（底层 `/api/hrm/common/getEmployeeByIds`）或消息行里的 hrm 姓名；**禁止用 IM 群成员接口返回的 `name` 字段**展示姓名，禁止本地猜测/拼表。
 3. **uid/cid/群 id 非 0、按字符串传输**：uint64 必须字符串化；`0`、空串直接拒绝。
-4. **不本地过滤、不隐式全量**：搜索/筛选一律服务端完成（`mask`/`cond`/`type` 等）；拉历史/会话/系统消息默认单页，需要更多用返回锚点显式请求，**未经用户确认不得自动循环翻页拉全部**。
-5. **时间范围查询转 id 区间**：单聊/群聊历史不支持服务端时间过滤，CLI 把 `from/to` 换算为消息 id 区间分页；跨天/全量拉取必须先与用户确认范围。
-6. **消息展示完整不截断**：拉到的 `content` 完整展示，无论多长；不得自行截断/省略/改写正文。渲染表格时转义 `|`、保留换行提示（⏎）、媒体显示为 `[图片]/[视频]/[文件]名称` 且预览/下载链接保持可点击，必达消息保留 `[必达]` 前缀。
-7. **写操作只认 CLI 签发的 continuation**：不手工拼、不复用、不跨操作；prepare 后 10 分钟有效；`apply` 不自动重试。
-8. **禁止发送空白消息**：`txt` 为空或全空白（空格/换行）不算内容，CLI 直接返回 `content_required`，需提示用户提供非空内容。
-9. **超时即失败**：普通请求超过 15 秒即视为失败（上传 15/60 秒），不再重试，向用户说明失败原因；禁止无限重试或静默换接口。
-10. **未匹配不猜测**：人员/群未匹配（`total=0`/空）时直接告知「未找到『XX』，请确认名称是否正确」并停止。🔴 禁止翻历史会话、拉会话列表、按相似名/部分名模糊搜索去猜人，也不要推荐"可能的人"。
-11. **禁止拉全量获取数量**：不允许通过逐页拉全量统计消息总数/会话总数等；触发此类需求（如"一共有多少条消息"）直接回复「无法统计总数，功能暂时不支持」，不提供逐页全量变通。数量只基于当页返回（如当页 `total=N`）。
-12. **数据对不上不得自行猜测**：接口返回与预期不符（返回 0 条/条数不符/字段缺失）时，按下面模板先给证据再让用户选方向；禁止自作主张换参数反复探测、换同类型接口或编造数据。
+4. **不本地过滤、分页口径固定**：搜索/筛选一律服务端完成（`mask`/`cond`/`type` 等），**禁止先拉数据再本地过滤**；唯一例外是 `session.list` 的 `type`（接口本身不支持类型条件，CLI 与源脚本同为本地筛选，属于模块既定行为，不要据此扩展到其它字段）。分页口径固定：**有界区间**（时间范围 / 默认当天 / 显式 `end`）由 CLI 自动循环翻页拉完（上限 100 页），直接展示即可；**无界区间**（`latest:true`）只拉一页，需要更早数据时用 `nextStart` 显式续拉，同一轮内不要连续多次续拉；**会话列表不自动翻页**，用 `nextMsgid` 显式续拉。
+5. **时间范围查询转 id 区间 + 强制收敛 7 天**：单聊/群聊/系统消息历史不支持服务端时间过滤，CLI 把 `from/to` 换算为消息 id 区间；跨度 > 7 天自动收敛为该范围最后 7 个自然日，`rangeShrink.notice` **必须原样转述给用户**；要更早历史就按 ≤ 7 天分段，不要替用户改口径。
+6. **本人 IM 身份只用于本机组装**：`group.search` 的 `members/owner/creator` 条件、撤回/必达消息体、建群自检、消息「我」的判定，由 CLI 用 `teamsCheck` 取得的本人 `imCid`/`imUid` 完成；调用方不要传、也传不了这些身份（`user`/`sender`/`operator` 会被 `forbidden_key` 拒绝），不要自行拼 `cid`/`uid` 顶替。
+7. **消息展示完整不截断**：拉到的 `content` 完整展示，无论多长；不得自行截断/省略/改写正文。输出顺序为最新在前；渲染表格时转义 `|`、保留换行提示（⏎）、媒体显示为 `[图片]/[视频]/[文件]名称` 且预览/下载链接保持可点击，必达消息保留 `[必达]` 前缀。
+8. **写操作只认 CLI 签发的 continuation**：不手工拼、不复用、不跨操作；prepare 后 10 分钟有效；`apply` 不自动重试。
+9. **禁止发送空白消息**：`txt` 为空或全空白（空格/换行）不算内容，CLI 直接返回 `content_required`，需提示用户提供非空内容。
+10. **超时即失败**：普通请求超过 15 秒即视为失败（上传 15/60 秒），不再重试，向用户说明失败原因；禁止无限重试或静默换接口。
+11. **未匹配不猜测**：人员/群未匹配（`total=0`/空）时直接告知「未找到『XX』，请确认名称是否正确」并停止。🔴 禁止翻历史会话、拉会话列表、按相似名/部分名模糊搜索去猜人，也不要推荐"可能的人"。
+12. **禁止拉全量获取数量**：不允许通过逐页拉全量统计消息总数/会话总数等；触发此类需求（如"一共有多少条消息"）直接回复「无法统计总数，功能暂时不支持」，不提供逐页全量变通。数量只基于本次返回（如 `total=N`）。**有界区间的自动翻页只服务于"按范围取数据"，同样不能用来做全量计数。**
+13. **旧字段兼容要显式**：`file.upload` 的旧名 `filePath`/`shareGroups` 仍可用，但与新名 `file`/`shareGroup` 同时出现且取值不一致时返回 `alias_conflict`；只保留一个，不要依赖"后者覆盖前者"。
+14. **数据对不上不得自行猜测**：接口返回与预期不符（返回 0 条/条数不符/字段缺失）时，按下面模板先给证据再让用户选方向；禁止自作主张换参数反复探测、换同类型接口或编造数据。
 
 ## 写链停止条件
 
@@ -52,6 +54,8 @@
 | `1303` | 无聊天记录 | 按成功空列表（看 `emptyReason`），不报错 |
 | `1209` / 群不存在 | 群不可读/已解散 | 告知用户 |
 | `forbidden_keys` | 传了操作人字段 | 去掉后重试（说明红线） |
+| `alias_conflict` | 旧字段与新字段同时出现且取值不一致 | 只保留其中一个后重试 |
+| `self_identity_missing` | 需要本人 cid/uid 的查询取不到有效身份 | 说明登录态不完整，按共享规则重新登录 |
 | `context_mismatch` / `continuation_expired` | 会话/租户或超时变化 | 重新 prepare |
 | `target_changed` | prepare 后目标/内容指纹变化 | 重新 prepare |
 | `members_resolve_failed` | 成员 hrm 解析失败 | 列失败项，问是否 `removeFailed:true` |

package/skills/weaver-e10-yimiaoban/references/session-sysmsg.md

@@ -6,32 +6,32 @@
 
 | operation | 用途 |
 | --- | --- |
-| `yimiaoban.session.list` | 拉当前用户会话列表（单聊/群聊/系统消息，名称与副标题已解析） |
-| `yimiaoban.sysmsg.groupSearch` | 按名称搜系统消息分组/类型配置（供 query 使用） |
-| `yimiaoban.sysmsg.typeSync` | 按 gids/tids 拉系统消息分组/类型配置 |
-| `yimiaoban.sysmsg.query` | 拉系统消息（流程/任务/公文等），支持阅读维度/处理状态/时间范围/单页倒序 |
+| `im.session.list` | 拉当前用户会话列表（单聊/群聊/系统消息，名称与副标题已解析） |
+| `im.sysmsg.groupSearch` | 按名称搜系统消息分组/类型配置（供 query 使用） |
+| `im.sysmsg.typeSync` | 按 gids/tids 拉系统消息分组/类型配置 |
+| `im.sysmsg.query` | 拉系统消息（流程/任务/公文等），支持阅读维度/处理状态/时间范围/单页倒序 |
 
 ## 输入要点
 
-- `session.list`：`num` 默认 20 上限 50；`flag` 0 up+down / 1 up / 2 down（默认 2，从最新拉）；`msgid` 锚点实现翻页（取上页边界消息 id）；`type` 只过滤该 session_type；`around` 表示锚点附近上下各半。
+- `session.list`：`num` 默认 20 上限 50；`flag` 0 up+down / 1 up / 2 down（默认 2，从最新拉）；`msgid` 锚点实现翻页（取上页返回的 `nextMsgid`）；`type` 只过滤该 session_type；`around` 表示锚点附近上下各半。**会话列表不参与消息类自动翻页**：一次只返回一页，更旧会话需用户明确要求后用 `nextMsgid` 继续。
 - 会话返回带 `sessionTypeName`（单聊/群聊/系统消息）、`name`（单聊=对方姓名、群聊=群名、系统=分组名）、`unread`（来自 `unread_count`）、`unreadLabel`（免打扰会话显示 `N（免打扰）`）、`time`（会话更新时间）、`subtitle`（发送者：最近消息内容）、`lastMsgid`（下一页锚点 `nextMsgid`）。
 - `sysmsg.groupSearch` 用名称找分组/类型（流程/待办/公告等），返回 gid/tid 供 `typeSync` 与 `query`。
-- `sysmsg.query`：**必填 `group`（系统分组 id，来自 `groupSearch`/会话列表）**，可选 `type`（消息类型 id）、`flag`（0 不分已读未读/1 已读/2 未读）、`deal`（0 全部/1 未处理/2 已处理）、`num`（默认 20、上限 50）、时间范围 `from`/`to`/`latest`、显式 `start`/`end`。系统消息"已读/处理"类状态更新在需要时由 Agent 引导用户到易秒办处理，CLI 不伪装处理。
+- `sysmsg.query`：**必填 `group`（系统分组 id，来自 `groupSearch`/会话列表）**，可选 `type`（消息类型 id）、`flag`（0 不分已读未读/1 已读/2 未读）、`deal`（0 全部/1 未处理/2 已处理）、`num`（默认 **50**、上限 50）、时间范围 `from`/`to`/`latest`、显式 `start`/`end`。分页口径与聊天消息一致：有界区间（时间范围/默认当天/显式 `end`）自动循环翻页拉完，`latest:true` 只拉一页；`from`/`to` 跨度 > 7 天自动收敛为最后 7 个自然日并把 `rangeShrink.notice` 转述给用户。系统消息「已读/处理」类状态更新在需要时由 Agent 引导用户到易秒办处理，CLI 不伪装处理。
 
 ## 命令
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json yimiaoban run yimiaoban.session.list --input-json '{"num":20}'
-weaver-work-cli --json yimiaoban run yimiaoban.sysmsg.query --input-json '{"group":110,"num":20,"flag":2}'
+weaver-work-cli --json im run im.session.list --input-json '{"num":20}'
+weaver-work-cli --json im run im.sysmsg.query --input-json '{"group":110,"num":50,"flag":2}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json yimiaoban run yimiaoban.session.list --input-json '{"num":20}'
-weaver-work-cli --json yimiaoban run yimiaoban.sysmsg.query --input-json '{"group":110,"num":20,"flag":2}'
+weaver-work-cli --json im run im.session.list --input-json '{"num":20}'
+weaver-work-cli --json im run im.sysmsg.query --input-json '{"group":110,"num":50,"flag":2}'
 ```
 
 ## 输出处理
@@ -39,6 +39,7 @@ weaver-work-cli --json yimiaoban run yimiaoban.sysmsg.query --input-json '{"grou
 - 会话列表渲染：单聊/群聊显示名称（走 hrm/群信息），系统消息显示分组名；副标题按类型给最近消息预览，媒体会话显示 `[图片]xxx.png`/`[文件]xxx.pdf` 形式，必达消息保留 `[必达]` 前缀。
 - 列表结果大时按共享规则汇总（只给关键列 + 总数），不要整表倾倒；按需翻页。
 - `sysmsg.query` 返回 `dealMode`：`true` 表示该分组以**处理状态**为准（`statusLabel` = 已处理/未处理），`false` 表示以**阅读状态**为准（已读/未读）；`title` 为系统消息标题（如流程标题），展示时标题一行、内容一行。
+- 系统消息同样是分页字段：`pages`/`autoPaged`/`pageSize`/`exhausted`/`hasMore`/`nextStart`/`range`/`rangeShrink`；`start` 是**排除边界**（返回 id `< start`），CLI 已按消息 id 去重。
 
 ## 失败处理