weaver-work-cli 0.1.7 → 0.1.20

package/skills/weaver-e10-blog/references/blog-default-permission.md

@@ -0,0 +1,38 @@
+# 默认共享查询（blog.default_permission）
+
+## 何时使用
+
+发布前想确认某日期会共享给哪些对象；一般无需单独调用——`blog.publish.prepare` 默认自动回填默认共享（`share_default=true`）。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| date | 是 | 日报归属日期 `YYYY-MM-DD` |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.default_permission --input-json '{"date":"2026-09-17"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.default_permission --input-json '{"date":"2026-09-17"}'
+```
+
+## 输出处理
+
+- `list[]`：默认共享对象数组（`obj_id` 展示名、`_entityType` 类型等）。
+- `list` 为空表示该日期无默认共享。
+
+## 注意
+
+- 只读操作，无需确认。
+
+## 失败处理
+
+- `business_error`：透出服务端 message。

package/skills/weaver-e10-blog/references/blog-disabled-capabilities.md

@@ -0,0 +1,11 @@
+# 暂未暴露的能力（处理边界）
+
+以下能力在源资料中存在或被提及，但 CLI 未暴露对应 operation。用户提出时如实说明并停止，不要绕过 CLI 构造请求。
+
+| 能力 | 原因 | 建议话术 |
+| --- | --- | --- |
+| 按 userId 列表批量查个人日报 | 服务端忽略该过滤（`filter.userIds`/`empIds`/`userId`/`creator`），恒定返回登录人自己的日报且不报错，会造成「查 A 得到 B」的静默错误 | 「按人查请逐人查询，我用 query_user 按天扫描」 |
+| `unRead` 时间段查询 | 该接口在当前租户三种请求形态实测恒返回空列表 | 「统一改用群体查询或单人查询」 |
+| EB 日报应用接口族（查询/发布/编辑/删除） | 依赖租户启用 EB 日报应用；当前租户未启用，接口族与标准日报完全不同且启用状态需逐租户探测 | 「当前环境使用标准日报接口，能力一致」 |
+| 删除日报 / 撤回已发送提醒 | 源资料未提供可靠接口 | 「暂不支持，请在客户端手动处理」 |
+| 附件上传 / @ 提醒 | 源资料未给出经过验证的完整契约 | 「暂不支持」 |

package/skills/weaver-e10-blog/references/blog-edit.md

@@ -0,0 +1,51 @@
+# 编辑日报（blog.edit prepare -> apply）
+
+## 何时使用
+
+修改已存在的日报正文（自己的或有权操作的目标人员日报）。目标当天无日报时报错，应改用发布。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_id / name | 否（二选一） | 目标人员；都不传时编辑当前登录人的日报 |
+| date | 是 | 日报归属日期 |
+| content | 是 | 新正文；纯文本自动包裹 `<p>` |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.edit.prepare --input-json '{"date":"2026-09-17","content":"修正后的日报内容。"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.edit.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.edit.prepare --input-json '{"user_id":"1000000000000000001","date":"2026-08-18","content":"<p>修正后的日报内容。</p>"}'
+weaver-work-cli --json blog run blog.edit.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+1. prepare 返回原内容（`original.content_text`）与新内容、差异摘要和 continuation。
+2. 向用户复述原内容与新内容，取得明确确认后调 apply。
+3. apply 回查验证内容已更新，返回 `updated=true, verified=true`。
+
+## 注意
+
+- 编辑覆盖整篇正文，不是追加；确认时让用户看清原内容。
+- 内容与新内容相同时 prepare 报 `changes_noop`。
+
+## 失败处理
+
+- `edit_target_missing`：目标当天无日报，建议改用发布。
+- `target_changed`：确认期间日报被修改，重新 prepare。
+- `partial/write_uncertain`：停止重试，用 `blog.query_user` 回查后报告。

package/skills/weaver-e10-blog/references/blog-export.md

@@ -0,0 +1,42 @@
+# 日报导出（blog.export）
+
+## 何时使用
+
+把日期段内的日报导出为本地 `.xlsx` 文件。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| start_date / end_date | 是 | 日期范围（含边界） |
+| output | 是 | 本地输出路径，必须是 `.xlsx` 文件；已存在时 CLI 拒绝覆盖 |
+| page_size | 否 | 默认 200 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.export --input-json '{"start_date":"2026-08-01","end_date":"2026-08-31","output":"C:\\tmp\\blog-2026-08.xlsx"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.export --input-json '{"start_date":"2026-08-01","end_date":"2026-08-31","output":"/tmp/blog-2026-08.xlsx"}'
+```
+
+## 输出处理
+
+- `output`：落盘路径；`bytes`：文件大小。
+- 导出范围为当前账号**有权限查看的全部日报**（不限于本人）；xlsx 第一行是标题，第二行是表头（姓名 / 部门 / 日报日期 / 提交状态 / 日报提交时间 / 是否隐藏 / 日报内容）。
+
+## 注意
+
+- 这是本地文件写入：`output_exists` 时换路径或先征得用户同意移除旧文件，不要静默覆盖。
+- 导出的日报内容会进入本地文件；如需把文件内容发给外部服务或进入大模型上下文，先向用户确认。
+
+## 失败处理
+
+- `output_parent_missing` / `output_parent_invalid`：先创建输出目录。
+- `export_failed`：服务端返回了非 xlsx 内容，错误详情带响应预览，向用户报告。

package/skills/weaver-e10-blog/references/blog-like.md

@@ -0,0 +1,50 @@
+# 点赞 / 取消点赞（blog.like prepare -> apply）
+
+## 何时使用
+
+对某条日报点赞或取消点赞。目标日报必须存在，`prepare` 阶段自动定位。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| blog_id | 与 date 二选一 | 日报记录 id |
+| date | 与 blog_id 二选一 | 日报归属日期，配合 user_id / name 定位 |
+| user_id / name | 否（二选一） | 目标人员；都缺省时定位当前登录人当天日报 |
+| cancel | 否 | 默认 false=点赞（vote）；true=取消点赞（cancelVote） |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.like.prepare --input-json '{"name":"PLACEHOLDER_NAME","date":"2026-08-18"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.like.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.like.prepare --input-json '{"date":"2026-08-18","cancel":true}'
+weaver-work-cli --json blog run blog.like.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+- `action`：`vote` / `cancelVote`；`receipt` 是服务端回执文案（如「点赞成功!」）。
+- 点赞状态没有只读回查接口，动作是否生效以业务码为准（`verified=false` 属预期，不是失败）。
+
+## 注意
+
+- 目标日期无日报时报 `target_missing`，如实报告「对应日报不存在，无法点赞」。
+- 不要为了「确认生效」而重复发送同一动作。
+
+## 失败处理
+
+- `target_missing`：报告目标不存在。
+- `business_error`：透出服务端 message。

package/skills/weaver-e10-blog/references/blog-publish.md

@@ -0,0 +1,52 @@
+# 发布日报（blog.publish prepare -> apply）
+
+## 何时使用
+
+为当前登录人新建指定日期的日报。只能发布自己的日报；当天已有日报时 prepare 会直接报错（防重复提交），应改用 blog.edit。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| date | 是 | 日报归属日期 `YYYY-MM-DD` |
+| content | 是 | 正文；纯文本自动包裹 `<p>`，HTML 原样保留 |
+| share_default | 否 | 默认 true：自动回填该日期默认共享对象；false 表示仅自己可见 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.publish.prepare --input-json '{"date":"2026-09-17","content":"今日完成：接口联调；明日计划：冒烟测试。"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.publish.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.publish.prepare --input-json '{"date":"2026-09-17","content":"今日完成：接口联调；明日计划：冒烟测试。"}'
+weaver-work-cli --json blog run blog.publish.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+1. prepare 返回 `status=AWAITING_CONFIRMATION`、日期、内容与 continuation（10 分钟有效）。
+2. 向用户复述日期与内容，取得明确确认（如「确认发布」）后才能调 apply。
+3. apply 内部回查验证：返回 `blog_id` 与 `submit_status`（当天补交属正常现象）。
+
+## 注意
+
+- 日报正文会进入业务系统并对共享对象可见；发布前必须逐字确认内容来自用户。
+- continuation 由 CLI 签发，禁止手工构造或复用过期 token。
+
+## 失败处理
+
+- `publish_already_exists`：当天已有日报，向用户说明并建议改用编辑。
+- `target_changed`：确认期间出现了日报，重新 prepare。
+- `confirmation.required`：未带 `confirm=true`。
+- `partial/write_uncertain`：停止重试，用 `blog.query_user` 回查后报告。

package/skills/weaver-e10-blog/references/blog-query-user.md

@@ -0,0 +1,45 @@
+# 单人日报查询（blog.query_user）
+
+## 何时使用
+
+查「某一个具体的人」某天或某段时间的日报详情，以及判断某人某天是否提交。这是按人查询的唯一路径——群体接口的按 userId 过滤会被服务端忽略并静默返回登录人自己的日报，禁止使用。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_id / name | 否 | 目标人员 userId 或姓名（姓名经 HRM 精确解析，同名多命中报错）；**两者都不传时默认查当前登录人**，是「查我自己的日报」的唯一路径 |
+| date | 是 | 起始日期 `YYYY-MM-DD` |
+| end_date | 否 | 结束日期（含）；缺省只查当天。区间按天逐日扫描，上限 62 天 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.query_user --input-json '{"name":"PLACEHOLDER_NAME","date":"2026-08-18"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.query_user --input-json '{"user_id":"1000000000000000001","date":"2026-08-15","end_date":"2026-08-20"}'
+```
+
+## 输出处理
+
+- `items[]`：每天一条，`date` 为 `YYYY-MM-DD`；`found=true` 表示当天有日报，`blog.content_text` 是去标签正文，`blog.create_time_str` 是实际提交时间。
+- `items[].submit_status`：`正常` / `补交` / `未提交`（无日报的天为 `未提交`），与 `blog.query` 口径一致。
+- `submitted_days` / `normal_days` / `later_days` / `missing_days`：区间内的已提交、正常、补交、未提交天数汇总，可直接用于按人报表。
+- 编辑 / 评论 / 点赞前的目标定位也可以直接用对应的 prepare 操作（内部同样按此接口解析），无需先手动查 id。
+
+## 注意
+
+- 区间上限 62 天；查询跨月报表时按月分段调用。
+- `blog.hasData` 字段不可靠，是否提交以 `found` 为准（CLI 已归一化）。
+
+## 失败处理
+
+- `name_not_found`：请用户确认姓名或改传 user_id。
+- `name_ambiguous`：报错里带 `candidates[]`，让用户挑选后改传 user_id。
+- `range_too_large`：缩小日期范围。

package/skills/weaver-e10-blog/references/blog-query.md

@@ -0,0 +1,49 @@
+# 群体日报查询（blog.query）
+
+## 何时使用
+
+查「一群人」某天 / 某段时间的日报提交情况：直接下属、间接下属、全部下属、我关注的人。按人查单个目标改用 `blog.query_user`。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_type | 是 | `directSubordinate`（直接下属）/ `indirectSubordinate`（间接下属）/ `allSubordinate`（全部下属）/ `myFollow`（我关注的人） |
+| start_date / end_date | 是 | `YYYY-MM-DD`，含边界 |
+| keywords | 否 | 内容关键字服务端过滤，可传空串 |
+| page_size | 否 | 默认 300（上限 300）。服务端返回行数 ≈ 人数 × 天数，窗口大时务必保持默认值 |
+| page_no | 否 | 默认 1。服务端实测**忽略** pageNo，调大不会拿到更多数据，不要靠翻页取数 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.query --input-json '{"user_type":"directSubordinate","start_date":"2026-09-14","end_date":"2026-09-16"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.query --input-json '{"user_type":"myFollow","start_date":"2026-09-14","end_date":"2026-09-16"}'
+```
+
+## 输出处理
+
+- `items[]`：每人每天一行，含 `date`（`YYYY-MM-DD`）、`username`、`submit_status`、`blog`（未提交时为 `null`）。
+- `submit_status`：`正常` / `补交` / `未提交`（CLI 按「提交时间 vs 日报日期是否同日」判定，不要用原始 later 字段）。
+- `not_submitted[]`：未提交的**人天**列表 `{date, user_id, username}`；同一人只缺个别日期也会列出，可直接用于催交。
+- `not_submitted_people[]`：整个窗口内一条日报都没有的人（「完全没交」名单）；`missing_count` 是未提交人天数。
+- `submitted_count` / `people`：统计与人员清单。
+- `_note` 出现时说明**单页 300 行已顶满、窗口更早的部分没取到**（服务端忽略 pageNo，无法翻页）。此时不要重试或调大 page_no；应缩小日期范围或减少人员范围后重查，并向用户说明只覆盖到哪个日期。
+
+## 注意
+
+- 返回较大时只向用户呈现统计摘要和异常行，不粘贴全部 items。
+- 查「我关注的人」是合法的 user_type；不要尝试其它写法（follow、myAttention 等）。
+
+## 失败处理
+
+- `range_too_large`：缩小区间（`start_date` 到 `end_date` 按天计数，**上限 62 天**，与 `blog.query_user` 口径一致）。
+- `session_expired`：按 shared 规则确认登录域名后重新登录。
+- 返回 0 条：如实告知该范围无数据，不要自动换 user_type 重试。

package/skills/weaver-e10-blog/references/blog-remind.md

@@ -0,0 +1,51 @@
+# 提醒提交日报（blog.remind prepare -> apply）
+
+## 何时使用
+
+向指定人员发送「请填写日报」提醒消息。多人时逐人发送。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_ids / names | 二选一 | 被提醒人列表（userId 数组、逗号分隔串或姓名数组，最多 50 人） |
+| date | 是 | 日报归属日期，用于默认文案与年份 |
+| content | 否 | 自定义文案；缺省生成「请填写 YYYY年 M月 D日 的日报！」 |
+| year | 否 | 日报所属年份；缺省从 date 推断 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.remind.prepare --input-json '{"names":["PLACEHOLDER_NAME"],"date":"2026-08-19"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.remind.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.remind.prepare --input-json '{"user_ids":"1000000000000000001","date":"2026-08-19"}'
+weaver-work-cli --json blog run blog.remind.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+1. prepare 返回被提醒人清单（`user_id` + 解析出的姓名）、文案与年份、continuation。
+2. 向用户复述目标人员与文案，取得明确确认后调 apply。
+3. apply 逐人发送；`succeeded[]` / `failed[]` 分别列出结果；status 为 `PARTIAL` 时如实报告失败名单。
+
+## 注意
+
+- 默认文案固定以「请填写」开头且包含与 `date` 一致的日期；自定义文案必须包含具体日期。
+- 提醒是推给真人的消息，发送前必须逐项确认人名与文案。
+
+## 失败处理
+
+- `name_not_found` / `name_ambiguous`：修正名单后重新 prepare。
+- `partial/write_uncertain`：已发送部分不重发；向用户报告成功与失败名单，失败者确认后重新 prepare。

package/skills/weaver-e10-blog/references/blog-resolve-users.md

@@ -0,0 +1,38 @@
+# HRM 姓名解析（blog.resolve_users）
+
+## 何时使用
+
+用户只给了姓名而没有 userId，且后续需要跨多次调用复用 userId（如先查日报再提醒）时，先解析一次。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| name | 是 | 员工姓名，精确匹配 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.resolve_users --input-json '{"name":"PLACEHOLDER_NAME"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.resolve_users --input-json '{"name":"PLACEHOLDER_NAME"}'
+```
+
+## 输出处理
+
+- `matched`：命中人数；`users[]` 含 `user_id` / `name` / `department`。
+- 多命中时向用户列出候选让其选择，不要自行挑第一个。
+
+## 注意
+
+- 单次查询类操作（query_user、remind.prepare）内部已支持直接传 `name`，无需先解析。
+
+## 失败处理
+
+- `matched=0`：如实告知未找到该员工，请用户确认姓名。