@wagemule/daemon 0.1.0 → 0.1.3

package/dist/skills/larksuite/lark-wiki/references/lark-wiki-node-create.md

@@ -0,0 +1,127 @@
+# wiki +node-create
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+在飞书知识库中创建一个新节点，并自动解析目标知识空间。该 shortcut 对原生 `wiki.nodes.create` 做了一层更适合日常使用的封装：可以直接指定 `space_id`，也可以从父节点自动反查所属空间；在 `user` 身份下，如果同时省略 `--space-id` 和 `--parent-node-token`，还会自动回退到个人知识库 `my_library`。
+
+## 命令
+
+```bash
+# 在个人知识库根目录下创建一个 docx 节点（user 身份默认回退到 my_library）
+lark-cli wiki +node-create \
+  --title "项目计划"
+
+# 在指定知识空间中创建一个 docx 节点
+lark-cli wiki +node-create \
+  --space-id <SPACE_ID> \
+  --title "项目计划"
+
+# 在指定父节点下创建一个子节点
+lark-cli wiki +node-create \
+  --parent-node-token <PARENT_NODE_TOKEN> \
+  --title "迭代记录"
+
+# 显式指定创建到个人知识库（仅 user 身份；bot 不支持 `--space-id my_library`）
+lark-cli wiki +node-create \
+  --space-id my_library \
+  --title "学习笔记"
+
+# 创建一个快捷方式节点（shortcut）
+lark-cli wiki +node-create \
+  --parent-node-token <PARENT_NODE_TOKEN> \
+  --node-type shortcut \
+  --origin-node-token <ORIGIN_NODE_TOKEN> \
+  --title "原文档快捷方式"
+
+# 创建非 docx 类型节点
+lark-cli wiki +node-create \
+  --space-id <SPACE_ID> \
+  --obj-type sheet \
+  --title "周报数据"
+
+# 预览底层调用链
+lark-cli wiki +node-create \
+  --title "Roadmap" \
+  --dry-run
+```
+
+## 返回值
+
+成功后会返回一个 JSON 对象，常见字段包括：
+
+- `resolved_space_id`：最终用于创建的真实知识空间 ID
+- `resolved_by`：空间解析来源，可能是 `explicit_space_id`、`parent_node_token`、`my_library`
+- `node_token`：新建知识库节点 token
+- `obj_token`：节点关联对象 token
+- `obj_type`：节点关联对象类型
+- `node_type`：节点类型
+- `title`：节点标题
+- `permission_grant`（可选）：仅 `--as bot` 时返回，说明是否已自动为当前 CLI 用户授予可管理权限
+
+> [!IMPORTANT]
+> 如果节点是**以应用身份（bot）创建**的，如 `lark-cli wiki +node-create --as bot`，在创建成功后 CLI 会**尝试为当前 CLI 用户自动授予该知识库节点的 `full_access`（可管理权限）**。
+>
+> 以应用身份创建时，结果里会额外返回 `permission_grant` 字段，明确说明授权结果：
+> - `status = granted`：当前 CLI 用户已获得该知识库节点的可管理权限
+> - `status = skipped`：本地没有可用的当前用户 `open_id`，因此不会自动授权；可提示用户先完成 `lark-cli auth login`，再让 AI / agent 继续使用应用身份（bot）授予当前用户权限
+> - `status = failed`：节点已创建成功，但自动授权用户失败；会带上失败原因，并提示稍后重试或继续使用 bot 身份处理该节点
+>
+> `permission_grant.perm = full_access` 表示该资源已授予“可管理权限”
+>
+> **不要擅自执行 owner 转移。** 如果用户需要把 owner 转给自己，必须单独确认。
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--space-id` | 否 | 目标知识空间 ID；`user` 身份可传特殊值 `my_library` 表示个人知识库，`bot` 身份不支持该值 |
+| `--parent-node-token` | 否 | 父知识库节点 token；传入后会在该节点下创建新节点 |
+| `--title` | 否 | 节点标题 |
+| `--node-type` | 否 | 节点类型，默认 `origin`；可选值：`origin`、`shortcut` |
+| `--obj-type` | 否 | 节点对应对象类型，默认 `docx`；可选值：`sheet`、`mindnote`、`bitable`、`docx`、`slides` |
+| `--origin-node-token` | 否 | 当 `--node-type=shortcut` 时必填，表示快捷方式指向的源节点 token |
+
+## 空间解析规则
+
+- **优先级**：`--space-id` > `--parent-node-token` > `my_library`
+- **显式 space**：传了 `--space-id` 时，shortcut 会直接使用该空间；如果该值是 `my_library`，则仅 `user` 身份可用，并会先调用 `GET /open-apis/wiki/v2/spaces/my_library` 解析成真实 `space_id`
+- **父节点推断**：未传 `--space-id` 但传了 `--parent-node-token` 时，会先调用 `GET /open-apis/wiki/v2/spaces/get_node` 获取父节点，再读取其 `space_id`
+- **个人知识库回退**：`user` 身份下，如果 `--space-id` 和 `--parent-node-token` 都没传，会自动解析 `my_library`
+- **bot 身份限制**：`bot` 身份既没有“个人知识库”回退语义，也不支持显式传 `--space-id my_library`；请改用真实 `space_id` 或 `--parent-node-token`
+
+## shortcut 节点规则
+
+- `--node-type=shortcut` 时，必须同时提供 `--origin-node-token`
+- `--node-type=origin` 时，不能传 `--origin-node-token`
+- `shortcut` 节点只是知识库中的快捷方式入口；真正被引用的节点由 `--origin-node-token` 指定
+
+## 一致性校验
+
+- 如果同时传了 `--space-id` 和 `--parent-node-token`，shortcut 会校验父节点所属空间是否与 `--space-id` 一致
+- 如果两者解析出的空间不一致，命令会直接返回验证错误，而不会继续创建
+- 对于 `my_library`，`user` 身份下也会先解析出真实 `space_id` 后再做这层校验
+
+## 行为说明
+
+- **默认对象类型**：不传 `--obj-type` 时默认创建 `docx` 节点
+- **默认节点类型**：不传 `--node-type` 时默认创建普通节点 `origin`
+- **dry-run 编排**：
+  - 仅传 `--title`：会展示 `my_library` 解析 + 创建节点 两步调用
+  - 仅传 `--parent-node-token`：会展示“查询父节点 -> 创建节点”两步调用
+  - 同时需要 `my_library` 和父节点时：会展示三步调用链
+- **bot 自动授权**：若使用 `--as bot`，结果还会额外带上 `permission_grant`，用于说明是否已自动为当前 CLI 用户授予新建节点的可管理权限
+- **输出结果**：成功后会返回 `resolved_space_id`、`resolved_by`、`node_token`、`obj_token`、`obj_type`、`node_type`、`title` 等字段，便于后续继续操作
+
+## 推荐场景
+
+- 用户说“在我的知识库里新建一篇页面”时，优先用 `lark-cli wiki +node-create --title "..."`
+- 用户已经给出父页面链接或 `parent_node_token` 时，优先传 `--parent-node-token`，让 shortcut 自动推导空间
+- 需要创建知识库快捷方式时，使用 `--node-type shortcut --origin-node-token <token>`
+
+> [!CAUTION]
+> `wiki +node-create` 是**写入操作**，执行前必须确认用户意图。
+
+## 参考
+
+- [lark-wiki](../SKILL.md) -- 知识库全部命令
+- [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数

package/dist/skills/larksuite/lark-wiki/references/lark-wiki-node-list.md

@@ -0,0 +1,88 @@
+# lark-wiki +node-list
+
+List wiki nodes in a space or under a specific parent node. **Default fetches a single page** (large knowledge bases can have thousands of nodes — opt into `--page-all` explicitly with an eye on `--page-limit`).
+
+## Usage
+
+```bash
+# Default: single page of root nodes
+lark-cli wiki +node-list --space-id <SPACE_ID>
+
+# Drill into a sub-directory (still single page by default)
+lark-cli wiki +node-list --space-id <SPACE_ID> --parent-node-token <NODE_TOKEN>
+
+# Personal document library (user identity only)
+lark-cli wiki +node-list --space-id my_library --as user
+
+# Walk every page (capped by --page-limit, default 10)
+lark-cli wiki +node-list --space-id <SPACE_ID> --page-all
+
+# Walk every page with a higher cap
+lark-cli wiki +node-list --space-id <SPACE_ID> --page-all --page-limit 30
+
+# Resume from a cursor
+lark-cli wiki +node-list --space-id <SPACE_ID> --page-token <TOKEN>
+
+# Pretty / table output
+lark-cli wiki +node-list --space-id <SPACE_ID> --format pretty
+```
+
+## Flags
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--space-id` | string | **Yes** | — | Wiki space ID. Use `my_library` for personal document library (user only) |
+| `--parent-node-token` | string | No | — | Parent node token; omit to list the space root |
+| `--page-size` | int | No | 50 | Page size, 1-50 |
+| `--page-token` | string | No | — | Page cursor; implies single-page fetch (no auto-pagination) |
+| `--page-all` | bool | No | `false` | Automatically paginate through all pages (capped by `--page-limit`) |
+| `--page-limit` | int | No | 10 | Max pages with `--page-all` (0 = unlimited) |
+| `--format` | enum | No | `json` | `json` / `pretty` / `table` / `csv` / `ndjson` |
+| `--as` | enum | No | `auto` | Identity `user`/`bot`; wiki is user-centric → pass `--as user` (`my_library` requires `--as user`) |
+
+## Output
+
+```json
+{
+  "ok": true,
+  "data": {
+    "nodes": [
+      {
+        "space_id": "6946843325487912356",
+        "node_token": "wikcn_EXAMPLE_TOKEN",
+        "obj_token": "doccn_EXAMPLE_TOKEN",
+        "obj_type": "docx",
+        "parent_node_token": "",
+        "node_type": "origin",
+        "title": "Getting Started",
+        "has_child": true
+      }
+    ],
+    "has_more": false,
+    "page_token": ""
+  },
+  "meta": { "count": 1 }
+}
+```
+
+When the default single-page fetch (or `--page-all` capped by `--page-limit`) does not exhaust the upstream cursor, `has_more=true` and `page_token=<cursor>` so the caller can resume via `--page-token` or by increasing `--page-limit`.
+
+## Traverse the wiki tree
+
+To list all content recursively, call `+node-list` again with each node's `node_token` as `--parent-node-token` when `has_child` is `true`.
+
+```bash
+# Step 1: list root nodes
+lark-cli wiki +node-list --space-id 6946843325487912356
+
+# Step 2: drill into a node that has children
+lark-cli wiki +node-list --space-id 6946843325487912356 --parent-node-token wikcn_EXAMPLE_TOKEN
+```
+
+## Notes
+
+- `--space-id my_library` is a per-user alias and only valid with `--as user`. The shortcut will refuse `--as bot` with `my_library` upfront.
+
+## Required Scope
+
+`wiki:node:retrieve`

package/dist/skills/larksuite/lark-wiki/references/lark-wiki-space-list.md

@@ -0,0 +1,68 @@
+# lark-wiki +space-list
+
+List wiki spaces accessible to the caller. **Default fetches a single page** (matches the rest of the CLI's list shortcuts); pass `--page-all` to walk every page.
+
+## Usage
+
+```bash
+# Default: single page (first up to --page-size items)
+lark-cli wiki +space-list
+
+# Walk every page (capped by --page-limit, default 10)
+lark-cli wiki +space-list --page-all
+
+# Walk every page, no cap (use with care if you have many spaces)
+lark-cli wiki +space-list --page-all --page-limit 0
+
+# Resume from a specific cursor (single-page fetch regardless of --page-all)
+lark-cli wiki +space-list --page-token <TOKEN>
+
+# Pretty / table / csv / ndjson output
+lark-cli wiki +space-list --format pretty
+lark-cli wiki +space-list --format table
+```
+
+## Flags
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--page-size` | int | 50 | Page size, 1-50 |
+| `--page-token` | string | — | Page cursor; implies single-page fetch (no auto-pagination) |
+| `--page-all` | bool | `false` | Automatically paginate through all pages (capped by `--page-limit`) |
+| `--page-limit` | int | 10 | Max pages with `--page-all` (0 = unlimited) |
+| `--format` | enum | `json` | `json` / `pretty` / `table` / `csv` / `ndjson` |
+| `--as` | enum | `auto` | Identity `user`/`bot`; wiki is user-centric → pass `--as user` |
+
+## Output
+
+```json
+{
+  "ok": true,
+  "data": {
+    "spaces": [
+      {
+        "space_id": "6946843325487912356",
+        "name": "Engineering Wiki",
+        "description": "...",
+        "space_type": "team",
+        "visibility": "private",
+        "open_sharing": "closed"
+      }
+    ],
+    "has_more": false,
+    "page_token": ""
+  },
+  "meta": { "count": 1 }
+}
+```
+
+When the default single-page fetch (or `--page-all` capped by `--page-limit`) does not exhaust the upstream cursor, `has_more=true` and `page_token=<cursor>` so the caller can resume via `--page-token` or by increasing `--page-limit`.
+
+## Notes
+
+- **The underlying API never returns the my_library personal library**; resolve it via `lark-cli wiki spaces get --params '{"space_id":"my_library"}'`.
+- Use `space_id` from the output as `--space-id` for `+node-list` or `+node-copy`.
+
+## Required Scope
+
+`wiki:space:retrieve`

package/dist/skills/larksuite/lark-workflow-meeting-summary/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: lark-workflow-meeting-summary
+version: 1.0.0
+description: "会议纪要整理工作流：汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。"
+metadata:
+  requires:
+    bins: ["lark-cli"]
+---
+
+# 会议纪要汇总工作流
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**。然后阅读 [`../lark-vc/SKILL.md`](../lark-vc/SKILL.md)，了解会议纪要相关操作。
+
+## 适用场景
+
+- "帮我整理这周的会议纪要" / "总结最近的会议" / "生成会议周报"
+- "看看今天开了哪些会" / "回顾过去一周开了哪些会"
+
+## 前置条件
+
+仅支持 **user 身份**。执行前确保已授权：
+
+```bash
+lark-cli auth login --domain vc        # 基础（查询+纪要）
+lark-cli auth login --domain vc,drive   # 含读取纪要文档正文、生成文档
+```
+
+## 工作流
+
+```
+{时间范围} ─► vc +search ──► 会议列表 (meeting_ids)
+                   │
+                   ▼
+               vc +notes ──► 纪要文档 tokens
+                   │
+                   ▼
+               drive metas batch_query 纪要元数据
+                   │
+                   ▼
+               结构化报告
+```
+
+### Step 1: 确定时间范围
+
+默认**过去 7 天**。推断规则："今天"→当天，"这周"→本周一~now，"上周"→上周一~上周日，"这个月"→1日~now。
+
+> **注意**：日期转换必须调用系统命令（如 `date`），不要心算。时间范围参数需根据 CLI 实际要求格式化（通常为 `YYYY-MM-DD` 或 ISO 8601）。
+
+### Step 2: 查询会议记录
+
+```bash
+# page-size 最大为 30
+lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json --page-size 30
+```
+
+- 时间范围拆分：搜索的时间范围最大为 1 个月。搜索更长时间范围的会议，需要拆分为多次时间范围为一个月查询。
+- `--end` 为**包含当天**的日期（即查"今天"时 start 和 end 都填今天）
+- `--format json` 输出 JSON 格式，你更佳擅长解析 JSON 数据。
+- `--page-size 30` 每页最多 30 条。
+- 有 `page_token` 时必须继续翻页，收集所有 `id` 字段（meeting-id）
+
+### Step 3: 获取纪要元数据
+
+1. 查询会议关联的纪要信息
+```bash
+lark-cli vc +notes --meeting-ids "id1,id2,...,idN"   
+```
+- 根据上一步搜集到的 `meeting-id` 查询会议纪要。
+- 单次最多查询 50 个纪要信息，超过 50 个需分批调用。
+- 部分会议返回 `no notes available`，在最终输出中标注"无纪要"
+- 记录每个会议的 `note_doc_token`（纪要文档 Token）和 `verbatim_doc_token`（逐字稿文档 Token）
+
+
+2. 获取纪要文档和逐字稿文档链接
+```bash
+# 学习命令使用方式
+lark-cli schema drive.metas.batch_query
+
+# 批量获取纪要文档与逐字稿链接: 一次最多查询 10 个文档
+lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'
+```
+
+### Step 4: 整理纪要报告
+
+根据时间跨度选择输出格式：
+
+- **单日汇总**（"今天"/"昨天"）：用"今日会议概览"标题，逐会议列出会议时间、主题、纪要链接、逐字稿链接。
+- **多日/周报**（"这周"/"过去 7 天"等）：用"会议纪要周报"标题，含概览统计、逐会议详情。
+
+### Step 5: 生成文档（可选，用户要求时）
+
+阅读 [`../lark-doc/SKILL.md`](../lark-doc/SKILL.md) 学习云文档技能。
+
+```bash
+lark-cli docs +create --api-version v2 --doc-format markdown --content $'<title>会议纪要汇总 (<start> - <end>)</title>\n<内容>'
+# 或追加到已有文档
+lark-cli docs +update --api-version v2 --doc "<url_or_token>" --command append --doc-format markdown --content $'<内容>'
+```
+
+## 参考
+
+- [lark-shared](../lark-shared/SKILL.md) — 认证、权限（必读）
+- [lark-vc](../lark-vc/SKILL.md) — `+search`、`+notes` 详细用法
+- [lark-doc](../lark-doc/SKILL.md) — `+fetch`、`+create`、`+update` 详细用法

package/dist/skills/larksuite/lark-workflow-standup-report/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: lark-workflow-standup-report
+version: 1.0.0
+description: "日程待办摘要：编排 calendar +agenda 和 task +get-my-tasks，生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。"
+metadata:
+  requires:
+    bins: ["lark-cli"]
+---
+
+# 日程待办摘要工作流
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**
+
+## 适用场景
+
+- "今天有什么安排" / "今天的日程和待办"
+- "明天有什么会" / "明日日程与未完成任务"
+- "帮我看看今天要做什么" / "早报摘要"
+- "开工摘要" / "standup report"
+- "这周还有哪些安排"
+
+## 前置条件
+
+仅支持 **user 身份**。执行前确保已授权：
+
+```bash
+lark-cli auth login --domain calendar,task
+```
+
+## 工作流
+
+```
+{date} ─┬─► calendar +agenda [--start/--end] ──► 日程列表（会议/事件）
+        └─► task +get-my-tasks [--due-end]    ──► 未完成待办列表
+                    │
+                    ▼
+              AI 汇总（时间转换 + 冲突检测 + 排序）──► 摘要
+```
+
+### Step 1: 获取日程
+
+```bash
+# 今天（默认，无需额外参数）
+lark-cli calendar +agenda
+
+# 指定日期范围（必须使用 ISO 8601 格式，不支持 "tomorrow" 等自然语言）
+lark-cli calendar +agenda --start "2026-03-26T00:00:00+08:00" --end "2026-03-26T23:59:59+08:00"
+```
+
+> **注意**：`--start` / `--end` 仅支持 ISO 8601 格式（如 `2026-01-01` 或 `2026-01-01T15:04:05+08:00`）和 Unix timestamp，**不支持** `"tomorrow"`、`"next monday"` 等自然语言。需要 AI 根据当前日期自行计算目标日期。
+
+输出包含：event\_id、summary、start\_time（含 timestamp + timezone）、end\_time、free\_busy\_status、self\_rsvp\_status。
+
+### Step 2: 获取未完成待办
+
+```bash
+# 默认：返回分配给当前用户的未完成任务（最多 20 条）
+lark-cli task +get-my-tasks
+
+# 只看指定日期前到期的（推荐用于摘要场景，减少数据量）
+lark-cli task +get-my-tasks --due-end "2026-03-27T23:59:59+08:00"
+
+# 获取全部（超过 20 条时）
+lark-cli task +get-my-tasks --page-all
+```
+
+> **注意**：不带过滤条件时可能返回大量历史待办（实测 30+ 条、100KB+），容易超出上下文限制。摘要场景建议：
+> - 用 `--due-end` 过滤出目标日期前到期的任务
+> - 如果也需要无截止日期的任务，可不加过滤，但 AI 汇总时只展示**近 30 天内创建的**，其余折叠为"其他 N 项历史待办"
+
+### Step 3: AI 汇总
+
+将 Step 1 和 Step 2 的结果整合，按以下结构输出：
+
+```
+## {日期}摘要（{YYYY-MM-DD 星期X}）
+
+### 日程安排
+| 时间 | 事件 | 组织者 | 状态 |
+|------|------|--------|------|
+| 09:00-10:00 | 产品需求评审 | 张三 | 已接受 |
+| 14:00-15:00 | 技术方案讨论 | 李四 | 待确认 |
+
+### 待办事项
+- [ ] {task_summary}（截止：{due_date}）
+- [ ] {task_summary}
+
+### 小结
+- 共 {n} 场会议，{m} 项待办
+- 冲突提醒：{列出时间重叠的日程}
+- 空闲时段：{free_slots}（根据日程推算）
+```
+
+**数据处理规则：**
+
+1. **时间转换**：API 返回 Unix timestamp，需根据 `timezone` 字段（通常为 `Asia/Shanghai`）转换为 `HH:mm` 格式
+2. **RSVP 状态映射**：
+   | API 值 | 显示文案 |
+   |--------|---------|
+   | `accept` | 已接受 |
+   | `decline` | 已拒绝 |
+   | `needs_action` | 待确认 |
+   | `tentative` | 暂定 |
+3. **日程排序**：按开始时间升序排列
+4. **冲突检测**：按时间排序后，检查相邻日程是否有时间重叠（前一个 end\_time > 后一个 start\_time），有则在小结中列出冲突组
+5. **已拒绝日程**：标注"已拒绝"但不计入忙碌时段和冲突检测
+6. **待办排序**：按截止时间升序，已过期的标注"已过期"，无截止时间的排在最后
+
+## 权限表
+
+| 命令 | 所需 scope |
+|------|-----------|
+| `calendar +agenda` | `calendar:calendar.event:read` |
+| `task +get-my-tasks` | `task:task:read` |
+
+## 参考
+
+- [lark-shared](../lark-shared/SKILL.md) — 认证、权限（必读）
+- [lark-calendar](../lark-calendar/SKILL.md) — `+agenda` 详细用法
+- [lark-task](../lark-task/SKILL.md) — `+get-my-tasks` 详细用法

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wagemule/daemon",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "private": false,
   "description": "Wage Mule local daemon for connecting local agent runtimes to Workspace Server.",
   "main": "./dist/main.cjs",
@@ -37,6 +37,7 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.138",
     "@inquirer/prompts": "^8.4.2",
+    "@larksuite/cli": "^1.0.32",
     "commander": "^14.0.3",
     "ws": "^8.0.0"
   }