@wps365/openclaw-wpsxiezuo 1.6.0

package/openclaw.plugin.json

@@ -0,0 +1,154 @@
+{
+  "id": "wps-xiezuo",
+  "name": "WPS Xiezuo",
+  "version": "1.5.1",
+  "description": "WPS Xiezuo Openclaw Plugin - 对接 WPS 开放平台应用机器人",
+  "main": "dist/index.js",
+  "author": "WPS Xiezuo Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0",
+    "openclaw": ">=2026.3.28"
+  },
+  "channels": ["wps-xiezuo"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": true,
+    "properties": {}
+  },
+  "channelConfigs": {
+    "wps-xiezuo": {
+      "label": "WPS Xiezuo",
+      "description": "WPS 开放平台企业机器人，支持群聊和私聊消息处理",
+      "schema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "账号显示名称（可选）"
+          },
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "启用或禁用此 WPS 账号配置"
+          },
+          "appId": {
+            "type": "string",
+            "description": "WPS 开放平台应用 ID (Client ID)"
+          },
+          "appSecret": {
+            "type": "string",
+            "description": "WPS 开放平台应用密钥 (Client Secret)"
+          },
+          "companyId": {
+            "type": "string",
+            "description": "WPS 企业 ID（可选）"
+          },
+          "baseUrl": {
+            "type": "string",
+            "default": "https://openapi.wps.cn",
+            "description": "WPS 开放平台 API 端点"
+          },
+          "enableEncryption": {
+            "type": "boolean",
+            "default": true,
+            "description": "启用消息加密"
+          },
+          "webhookPath": {
+            "type": "string",
+            "default": "/wps/webhook",
+            "description": "Webhook 接收路径"
+          },
+          "webhookPort": {
+            "type": "number",
+            "default": 3000,
+            "minimum": 1,
+            "maximum": 65535,
+            "description": "Webhook 服务端口"
+          },
+          "dmPolicy": {
+            "type": "string",
+            "enum": ["open", "pairing", "allowlist"],
+            "default": "pairing",
+            "description": "私聊访问策略：open 允许所有私聊，pairing 需要配对，allowlist 仅允许白名单用户"
+          },
+          "allowFrom": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "当 dmPolicy 为 allowlist 时，允许的用户 ID 列表"
+          },
+          "groupPolicy": {
+            "type": "string",
+            "enum": ["open", "allowlist"],
+            "default": "open",
+            "description": "群聊访问策略：open 允许所有群聊，allowlist 仅允许白名单群组"
+          },
+          "groupAllowFrom": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "当 groupPolicy 为 allowlist 时，允许的群组 ID 列表"
+          },
+          "requireMention": {
+            "type": "boolean",
+            "default": true,
+            "description": "群聊中是否需要 @机器人 才响应"
+          },
+          "instantAck": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "default": true,
+                "description": "启用即时确认消息"
+              },
+              "text": {
+                "type": "string",
+                "default": "内容处理中，请稍候...",
+                "description": "即时确认消息文本"
+              }
+            }
+          },
+          "debug": {
+            "type": "boolean",
+            "default": false,
+            "description": "启用调试日志"
+          },
+          "sdk": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean", "default": false },
+              "logLevel": {
+                "type": "string",
+                "enum": ["debug", "info", "warn", "error"],
+                "default": "info"
+              }
+            }
+          },
+          "mcp": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean", "default": false },
+              "mode": { "type": "string", "enum": ["app"], "default": "app" },
+              "toolAllowlist": {
+                "type": "array",
+                "items": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "capabilities": ["session", "auth", "skills"],
+  "hooks": {
+    "onInstall": "scripts/install.sh",
+    "onUninstall": "scripts/uninstall.sh",
+    "onUpgrade": "scripts/upgrade.sh"
+  },
+  "skills": {
+    "directory": "skills"
+  }
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@wps365/openclaw-wpsxiezuo",
+  "version": "1.6.0",
+  "description": "WPS Xiezuo OpenClaw plugin - connect OpenClaw Agent to the WPS Open Platform enterprise robot",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin"
+  ],
+  "license": "MIT",
+  "author": "WPS Xiezuo Team",
+  "packageManager": "pnpm@10.33.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openclaw-wps-xiezuo": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin/",
+    "dist/index.js",
+    "dist/**/*.d.ts",
+    "skills/",
+    "scripts/install.sh",
+    "scripts/uninstall.sh",
+    "scripts/upgrade.sh",
+    "openclaw.plugin.json",
+    "README.md",
+    "README_ZH-CN.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:release": "rm -rf dist && tsc -p tsconfig.json && node scripts/minify.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pack:bundle": "node scripts/build-bundle.mjs",
+    "release:bundle": "node scripts/release-bundle.mjs",
+    "release:patch": "node scripts/release-bundle.mjs patch",
+    "release:minor": "node scripts/release-bundle.mjs minor",
+    "release:major": "node scripts/release-bundle.mjs major",
+    "prepublishOnly": "pnpm run build:release",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "echo \"Tests not yet implemented\""
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
+    "typescript": "^5.7.3"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.28"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "express": "^5.2.1",
+    "image-size": "^2.0.2",
+    "open-event-sdk": "^1.0.1",
+    "zod": "^4.3.6"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "wps-xiezuo",
+      "label": "WPS Xiezuo",
+      "selectionLabel": "WPS Kingsoft Docs / WPS Xiezuo",
+      "aliases": [
+        "wps"
+      ],
+      "blurb": "WPS Open Platform enterprise robot (Kingsoft Docs / WPS Xiezuo) with support for group and direct message conversations.",
+      "order": 50,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@wps365/openclaw-wpsxiezuo",
+      "localPath": "extensions/wps-xiezuo",
+      "defaultChoice": "npm"
+    }
+  }
+}

package/scripts/upgrade.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+set -euo pipefail
+
+echo "⬆️  开始升级 WPS Xiezuo Openclaw 插件..."
+
+if ! command -v openclaw >/dev/null 2>&1; then
+  echo "❌ 错误: 未检测到 openclaw 命令"
+  exit 1
+fi
+
+if ! command -v pnpm >/dev/null 2>&1; then
+  echo "❌ 错误: 未检测到 pnpm 命令"
+  exit 1
+fi
+
+echo "📦 更新依赖..."
+pnpm install
+
+echo "🔨 重新构建项目..."
+pnpm run build
+
+echo "🔌 重新安装插件..."
+if openclaw plugins --help >/dev/null 2>&1; then
+  openclaw plugins install .
+else
+  openclaw plugin install .
+fi
+
+echo "🔄 尝试重载插件..."
+if openclaw plugin reload wps-xiezuo >/dev/null 2>&1; then
+  echo "✅ 插件重载完成"
+else
+  echo "ℹ️ 当前环境不支持 plugin reload，请手动重启 gateway"
+fi
+
+echo "✅ 升级完成"
+echo "💡 如从旧单账号配置升级，建议检查 channels.wps-xiezuo.accounts 是否已按预期配置"

package/skills/wps-auth-provider.md

@@ -0,0 +1,63 @@
+---
+name: wps-auth-provider
+description: WPS OAuth 认证提供者
+version: 1.0.0
+---
+
+# WPS Xiezuo 认证 Skill
+
+## 功能说明
+
+本 Skill 实现 WPS OAuth 认证流程，支持：
+
+- OAuth 2.0 授权码模式
+- Access Token 管理
+- Token 自动刷新
+- 用户身份验证
+
+## 认证流程
+
+1. **授权请求**: 引导用户到 WPS 授权页面
+2. **授权回调**: 接收授权码
+3. **Token 交换**: 使用授权码换取 access token
+4. **Token 存储**: 安全存储 token
+5. **Token 刷新**: 自动刷新过期 token
+
+## 权限范围
+
+- `bot.message.read`: 读取消息
+- `bot.message.write`: 发送消息
+- `bot.user.info`: 获取用户信息
+
+## 配置参数
+
+- `clientId`: WPS 应用 ID
+- `clientSecret`: WPS 应用密钥
+- 用户 OAuth 回调 URL 由插件内置，无独立 channel 配置项（见 `docs/user-oauth.md`）
+- `scopes`: 权限范围列表
+
+## 安全建议
+
+1. 使用环境变量存储敏感信息
+2. 启用 HTTPS 传输
+3. 验证 state 参数防止 CSRF
+4. 定期轮换密钥
+
+## 使用示例
+
+```typescript
+// 生成授权 URL
+const authUrl = authProvider.getAuthorizationUrl({
+  state: 'random_state',
+  scopes: ['bot.message.read', 'bot.message.write']
+});
+
+// 处理回调
+const tokens = await authProvider.handleCallback({
+  code: 'auth_code',
+  state: 'random_state'
+});
+
+// 刷新 token
+const newTokens = await authProvider.refreshToken(tokens.refreshToken);
+```

package/skills/wps-calendar/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: wps-calendar
+description: |
+  WPS365 日程与日历事件。用户要创建、列举主日历日程或「日程实例」（重复规则展开）时须走开放平台用户日历 API。
+  必须调用 wps_calendar_create / wps_calendar_list_events / wps_calendar_get_event / wps_calendar_list_event_attendees / wps_calendar_respond_invitation / wps_calendar_list_calendar_event_instances / wps_calendar_list_event_instances，禁止生成本地 .ics / 脚本替代。安装本插件后随 skills 目录一并加载。
+---
+
+# WPS365 日程：创建与查询主日历事件
+
+## 执行前必读
+
+- **`wps_calendar_create`**：在用户已完成 **用户 OAuth** 且具备 `kso.calendar_events.readwrite`（或开放平台文档所列等价 delegated 权限）时，调用 `POST /v7/calendars/primary/events/create` 在 **主日历** 创建事件。
+- **`wps_calendar_list_events`**：同一 delegated token 下调用 **`GET /v7/calendars/primary/events`**（即文档中的 `GET /v7/calendars/{calendar_id}/events`，`calendar_id=primary`）。官方说明：[查询日程列表](https://365.kdocs.cn/3rd/open/documents/app-integration-dev/wps365/server/calendar/calendar-event/get-calendar-event-list)。**HTTP 鉴权与创建日程相同**（用户 `access_token` + `Authorization: Bearer`，插件内共用同一 `WpsClient` 用户态路径，不另走 KSO-1）。
+- **`wps_calendar_get_event`**：开放平台「**查询日程**」—— **`GET /v7/calendars/{calendar_id}/events/{event_id}`**（默认 `primary`）。**必填 `event_id`**（通常来自 `wps_calendar_list_events` 的 `id`）。返回体中 **`data` 为单个日程对象**（含 `recurrence`、`original_start_time`、`online_meeting` 等），不是列表。可选请求头：参数 **`x_kso_id_type`** 为 `internal` / `external` 时映射为 **`X-Kso-Id-Type`**（与文档一致）。
+- **`wps_calendar_list_event_attendees`**：开放平台「**获取日程参与者列表**」—— **`GET /v7/calendars/{calendar_id}/events/{event_id}/attendees`**（默认 `primary`）。**必填 `event_id`**。响应 **`data`** 通常含 **`items[]`**（参与者）与可选 **`next_page_token`**。Query：可选 **`page_size`**（默认 30，文档最大 **100**）、**`page_token`**（上一页 `data.next_page_token`）。可选 **`x_kso_id_type`** → **`X-Kso-Id-Type`**。
+- **`wps_calendar_list_calendar_event_instances`**：调用 **`GET /v7/calendars/{calendar_id}/event_instances`**（默认 `calendar_id=primary`）。在时间窗内返回**主日历上多条日程**展开后的实例（日历级扫描）。Query：`start_time` / `end_time` 为 **RFC3339**、时间窗 **≤31 天**；可选 `page_size`（默认 30）、`page_token`。**鉴权与创建相同**（Bearer）。适合「这周所有会议 occurrence」等**不指定某条 event** 的场景。
+- **`wps_calendar_list_event_instances`**：开放平台「**查询日程实例**」—— **`GET /v7/calendars/{calendar_id}/events/{event_id}/event_instances`**（默认 `primary`）。**必填 `event_id`**（从 `wps_calendar_list_events` 返回的 `id` 取得）。Query 仅文档所列：`start_time` / `end_time`（**RFC3339**，**≤31 天**）；无 `page_size` / `page_token`。用于**单条重复日程**在指定时间窗内的展开实例。只看逻辑事件用 `wps_calendar_list_events`。
+- **`wps_calendar_respond_invitation`**：开放平台「**答复日程邀请**」—— **`POST /v7/calendars/{calendar_id}/events/{event_id}/respond`**（默认 `primary`）。**必填**：`event_id`、`mod_type`（`normal` / `one` / `all`）、`response_status`（`accepted` / `declined` / `tentative`）、`which_day_time`（日程开始时刻的 **毫秒时间戳**，与文档一致）。用于接受/拒绝/暂定会议邀请。
+- **与「通讯录」工具链的关系**：找人、发消息用 `wps_user_search` / `wps_message_send`；**日程不要**为解析 `wps_user_id` 去调 `wps_user_search` —— **`wps_user_id` = 入站 `SenderId`**。
+- **授权**：首次无用户 token 时，工具会 **自动发送授权卡片**；返回 `needsAuth: true` 后，提示用户点击「前往授权」，完成后再重试。
+- **部署**：用户 OAuth 回调地址由插件内置；须在开放平台「用户授权回调地址」登记**同一 URL**（见 `docs/user-oauth.md`）。
+
+## 查询接口要点（与官方一致）
+
+| 文档要求 | 插件行为 |
+|----------|----------|
+| `start_time` / `end_time` 为 **RFC3339** 字符串、URL 编码 | 工具参数传 **ISO8601/RFC3339** 字符串（如 `2026-04-22T14:00:00+08:00`），由 HTTP 客户端编码 |
+| 时间窗 **0～31 天** | 超出则 **截断**到 31 天 |
+| `page_size` 默认 **30** | 未传时使用 30 |
+| 增量：`sync_token`、`anchor_time`、`with_cancelled` | 工具支持同名可选参数；若传 **`sync_token`**，不再自动补时间窗（与文档「增量同步」一致） |
+
+## 快速索引：意图→工具
+
+| 意图 | 工具 | 必填参数 |
+|------|------|----------|
+| 创建日程 / 会议 / 提醒 / 写入日历 | `wps_calendar_create` | `summary`, `start_time`（ISO） |
+| 指定结束时间（可选） | 同上 | `end_time`（ISO；省略则默认 start + 1h） |
+| 查看 / 列举主日历日程（逻辑事件） | `wps_calendar_list_events` | `wps_user_id` |
+| **单条**日程完整详情（含重复规则 `recurrence`） | `wps_calendar_get_event` | `wps_user_id`, **`event_id`** |
+| **单条**日程的参与者列表 | `wps_calendar_list_event_attendees` | `wps_user_id`, **`event_id`**（可选 `page_size`、`page_token`） |
+| 主日历时间窗内**所有**日程的展开实例（日历级） | `wps_calendar_list_calendar_event_instances` | `wps_user_id` |
+| **某一条**重复日程的展开实例（须已知 `event_id`） | `wps_calendar_list_event_instances` | `wps_user_id`, **`event_id`** |
+| 接受 / 拒绝 / 暂定**日程邀请** | `wps_calendar_respond_invitation` | `wps_user_id`, **`event_id`**, **`mod_type`**, **`response_status`**, **`which_day_time`**（**毫秒**） |
+| 指定列表时间窗（可选） | 上述列表工具 | `start_time`, `end_time`（**RFC3339**） |
+
+## 核心约束
+
+1. **创建**用 **`wps_calendar_create`**；**逻辑事件列表**用 **`wps_calendar_list_events`**；**单条日程详情**（官方「查询日程」）用 **`wps_calendar_get_event`**（必须 **`event_id`**）；**参与者列表**（官方「获取日程参与者列表」）用 **`wps_calendar_list_event_attendees`**（必须 **`event_id`**）；**答复邀请**用 **`wps_calendar_respond_invitation`**；**日历级实例扫描**用 **`wps_calendar_list_calendar_event_instances`**；**单条 event 的实例**（官方「查询日程实例」路径）用 **`wps_calendar_list_event_instances`**（必须 **`event_id`**）。禁止用本地文件或臆造列表冒充 API。
+2. **禁止**生成 .ics、提醒脚本、txt、MEMORY.md 等替代方案。
+3. **`wps_user_id`**：当前对话 **SenderId**。
+4. **创建**的 `start_time` / `end_time`：事件体用 ISO。**事件列表 / 实例列表** 的 query `start_time` / `end_time`：须为 **RFC3339**。**答复邀请**的 `which_day_time` 为 **毫秒时间戳**（与文档一致）；与 **`wps_message_list` 的 Unix 秒** 不同，勿混用。
+5. 若 **`needsAuth: true`**：引导用户完成授权后再试。
+
+## 调用示例
+
+**创建**（省略 `end_time` 时默认 +1h）：
+
+```json
+{
+  "summary": "站立会",
+  "start_time": "2026-04-23T10:00:00+08:00",
+  "wps_user_id": "<SenderId>"
+}
+```
+
+**列举**（省略时间窗时插件默认约「过去 24h～未来 14d」，且不超过 31 天）：
+
+```json
+{
+  "wps_user_id": "<SenderId>"
+}
+```
+
+**列举**（显式时间窗）：
+
+```json
+{
+  "wps_user_id": "<SenderId>",
+  "start_time": "2026-04-01T00:00:00+08:00",
+  "end_time": "2026-04-07T23:59:59+08:00",
+  "page_size": 30
+}
+```
+
+**单条日程详情**（含 `recurrence`、会议链接等）：
+
+```json
+{
+  "wps_user_id": "<SenderId>",
+  "event_id": "<来自列表的 id>"
+}
+```
+
+**参与者列表**（分页：`page_token` 填上一页返回的 `data.next_page_token`）：
+
+```json
+{
+  "wps_user_id": "<SenderId>",
+  "event_id": "<来自列表的 id>",
+  "page_size": 30
+}
+```
+
+**答复日程邀请**（`which_day_time` 为该日程开始时间的 **毫秒时间戳**，可从 `wps_calendar_get_event` / 列表返回的 `start_time` 换算）：
+
+```json
+{
+  "wps_user_id": "<SenderId>",
+  "event_id": "<来自列表的 id>",
+  "mod_type": "normal",
+  "response_status": "accepted",
+  "which_day_time": 1714233600000
+}
+```
+
+**单条重复日程的实例**（先用 `wps_calendar_list_events` 取 `id` 作为 `event_id`）：
+
+```json
+{
+  "wps_user_id": "<SenderId>",
+  "event_id": "<来自列表的 id>",
+  "start_time": "2026-04-01T00:00:00+08:00",
+  "end_time": "2026-04-07T23:59:59+08:00"
+}
+```
+
+## 常见错误与排查
+
+| 现象 | 可能原因 | 处理 |
+|------|----------|------|
+| `needsAuth: true` | 用户未授权 | 完成 OAuth 卡片后再试 |
+| 403 / 无权限 | 应用未申请日历 delegated 权限 | 在开放平台补齐 `kso.calendar_events.read` / `readwrite` 等文档要求项 |
+| 列表为空 | 时间窗与日程实际时间无交集 | 扩大 `start_time`～`end_time`（≤31 天） |
+
+## 工具覆盖
+
+- `wps_calendar_create` — 创建（`POST .../events/create`）
+- `wps_calendar_list_events` — 逻辑事件列表（`GET /v7/calendars/primary/events`）
+- `wps_calendar_get_event` — 查询单条日程（`GET /v7/calendars/primary/events/{event_id}`）
+- `wps_calendar_list_event_attendees` — 参与者列表（`GET /v7/calendars/primary/events/{event_id}/attendees`）
+- `wps_calendar_list_calendar_event_instances` — 日历级实例列表（`GET /v7/calendars/primary/event_instances`）
+- `wps_calendar_list_event_instances` — 单条日程实例（`GET /v7/calendars/primary/events/{event_id}/event_instances`）
+- `wps_calendar_respond_invitation` — 答复邀请（`POST /v7/calendars/primary/events/{event_id}/respond`）
+
+## 安装说明
+
+- 随插件 **`skills.directory`** 安装；**`tools.allow`** 须包含上述七工具；**`mcp.toolAllowlist`** 默认已含（见 `src/core/config.ts`）。

package/skills/wps-channel-rules/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: wps-channel-rules
+description: |
+  WPS 协作渠道输出规则。在 WPS 会话中始终生效。
+alwaysActive: true
+---
+
+# WPS 输出规则
+
+## 写作风格
+
+- 简短、对话式、低仪式感 — 像同事聊天，不像说明书
+- 简短回答用普通句子，不必每次都用列表
+- 直入正题，说完就停 — 不需要每次都加总结段落
+
+## 注意事项
+
+- WPS 消息支持 @人：使用 `<at id="N">名字</at>` 语法，N 从 1 开始递增
+- WPS 消息最长 5000 字符
+- 回复消息支持 text / rich_text / image 三种类型
+
+## 用户发来的图片 / 文件
+
+- 插件已自动将用户附件下载到本地临时文件（路径在 Body 中标注，如 `/tmp/openclaw-media/xxx.png`）。
+- 用 **`read(<本地路径>)`** 读取已下载的临时文件 — 这是正确做法。
+- **禁止**对附件「显示文件名」（如 `xiezuo....png`）直接调用 `read` —— 会 ENOENT。
+- **禁止**用 `exec(curl ...)` 下载或上传媒体 — 直接用内置工具。
+- **禁止**引导用户手工执行 `openclaw gateway start/pair`、`curl` 等命令。
+
+## 发送图片 / 文件
+
+- **推荐方式**：用 `message` 工具，`media` 参数传入本地路径；若运行环境支持省略 `to` 则自动回当前会话：`message(action="send", message="为您发回图片", media="<已下载路径>")`。否则必须显式：`to="user:<SenderId>"` 或 `to="chat:<chatId>"`（与 `src/index.ts` 注入的 `to` 必填规则一致）。插件会自动完成上传和发送。
+- **备选方式**（需要精细控制时）：先用 `wps_media_upload_base64` 上传得到 `storage_key`，再用 `wps_message_send(msg_type="image", content={"image":{"storage_key":"..."}})` 发送。
+- 回当前会话：`receiver_id` / `to` 取自入站 **RawBody** 的 `chatId`（群）或 **SenderId**（单聊）；**禁止**把 `SessionKey` 里 `:bot:` 后的 `AK…` 等当作聊天 id。
+- **禁止**把文件路径当纯文本回复给用户。
+
+## 日程 / 日历（WPS365）
+
+- 用户要**创建日程、会议、日历提醒、写入日历**时：必须使用 **`wps_calendar_create`**；要**查看主日历逻辑事件列表**时：**`wps_calendar_list_events`**；要**查询单条日程详情**（官方「查询日程」，须 `event_id`）时：**`wps_calendar_get_event`**；要**查看某条日程的参与者列表**（须 `event_id`）时：**`wps_calendar_list_event_attendees`**；要**答复日程邀请**（接受/拒绝/暂定）时：**`wps_calendar_respond_invitation`**；要**日历级**查看时间窗内多条日程展开后的实例时：**`wps_calendar_list_calendar_event_instances`**；要按文档「查询日程实例」查看**单条 event** 的展开实例时：**`wps_calendar_list_event_instances`**（详见 **`wps-calendar`** skill）。**禁止**用 .ics、本地脚本或纯文字假装已创建/已查询。
+- 用户要**创建 / 列举 / 查看 / 更新 / 更新状态 WPS 个人待办**时：创建 **`wps_todo_create_personal_task`**，列举 **`wps_todo_list_personal_tasks`**，详情 **`wps_todo_get_personal_task`**，更新 **`wps_todo_update_personal_task`**，状态更新 **`wps_todo_update_personal_task_status`**（详见 **`wps-todo`** skill）。**禁止**仅用本地备忘冒充已同步待办。
+- 用户要**获取云文档盘列表**时：必须使用 **`wps_drive_list_drives`**（详见 **`wps-drive`** skill），按文档传 `allotee_type`（`user` / `group` / `app`），可选 `allotee_id`。用户要**新建文件（夹）**时：必须使用 **`wps_drive_create_file`**，按文档传 `drive_id`、`parent_id`、`file_type`、`name`。用户要**文档内容抽取**时：必须使用 **`wps_drive_extract_file_content`**，按文档传 `drive_id`、`file_id` 与可选 `format/include_elements/mode/task_id`。用户要**获取文件信息**时：必须使用 **`wps_drive_get_file_meta`**，按文档传 `file_id` 与可选 `with_permission/with_ext_attrs/with_drive`。用户要**文件搜索**时：必须使用 **`wps_drive_search_files`**，按文档传 `type`（`file_name`/`content`/`all`）和可选筛选条件。**禁止**离线拼接或复用旧缓存冒充实时查询结果。
+- **`wps_user_id`** 使用入站 **SenderId**；不要为日程或待办去调用 `wps_user_search`。
+
+## 云文件（cloud file）
+
+- WPS 云文件只有 `link_url`，没有 `storage_key`，不能下载到本地。
+- 转发云文件时，使用 `wps_message_send`，msg_type=`file`，content 使用 cloud 结构：
+  `wps_message_send(receiver_type="user", receiver_id="<id>", msg_type="file", content='{"file":{"type":"cloud","cloud":{"id":"...","link_id":"...","link_url":"..."}}}')`
+- Body 中会提供完整的调用命令，直接复制即可。
+- **禁止**对云文件使用 `message` 工具的 `media` 参数（没有本地路径）。

package/skills/wps-chat/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: wps-chat
+description: |
+  WPS 会话与群管理。在需要创建单聊/群聊、列举会话、查会话详情、拉成员或确认应用是否在群内时使用。
+---
+
+# WPS 会话：创建、查询与成员
+
+## 执行前必读
+
+- **P2P**：`type` 为 `p2p`，需提供**恰好 2 个用户的 user_id**。App Token 场景下应用没有 user_id，不能作为 P2P 一方——P2P 创建通常需要用户身份授权场景。
+- **群聊**：`type` 为 `group`，当前操作者自动加入并成为**群主**；`member_ids` 只需传其他成员。
+- **发群消息**：使用 `wps_message_send` 的 `receiver_type=chat`，`receiver_id` 传 `chat_id`。
+- **发消息前建议**：用 `wps_chat_is_member` 确认应用在群内，避免权限错误。
+
+## 快速索引：意图→工具
+
+| 意图 | 工具 | 必填参数 |
+|------|------|----------|
+| 创建 P2P 或群 | `wps_chat_create` | `type`, `member_ids` |
+| 分页列会话 | `wps_chat_list` | 无（可选分页） |
+| 查看单个会话元数据 | `wps_chat_get` | `chat_id` |
+| 列会话成员 | `wps_chat_members` | `chat_id` |
+| 确认应用是否在群 | `wps_chat_is_member` | `chat_id` |
+
+## 核心约束
+
+- **`wps_chat_create`**
+  - `type`：`p2p` 或 `group`
+  - `member_ids`：用户 ID **数组**
+    - P2P：提供**恰好 2 个** user_id（无自动注入，两个都需要是真实用户）
+    - 群聊：传其他成员的 user_id（操作者自动加入并成为群主）
+  - `name`：可选，群名（仅 group 有效）
+  - 需要 `kso.chat.readwrite` 权限
+- **`wps_chat_list`**
+  - `page_size`：默认 50，最大 100（WPS API 要求必传，已内置兜底）
+  - 支持 `page_token` 翻页
+- **`wps_chat_get`**
+  - 通过 `chat_id` 查会话是否存在、类型、群名等
+- **`wps_chat_members`**
+  - `page_size`：默认 50，最大 100（WPS API 要求必传，已内置兜底）
+  - 支持 `page_token` 翻页
+- **`wps_chat_is_member`**
+  - 返回 `{ is_in_chat: true/false }`，用于发消息前的前置校验
+
+## 使用场景示例
+
+**1）创建 P2P**（提供两个用户 ID）
+
+```json
+{
+  "type": "p2p",
+  "member_ids": ["USER_ID_A", "USER_ID_B"]
+}
+```
+
+**2）创建群聊**（操作者自动加入并为群主）
+
+```json
+{
+  "type": "group",
+  "member_ids": ["USER_ID_A", "USER_ID_B"],
+  "name": "项目协作群"
+}
+```
+
+**3）列举最近会话**
+
+```json
+{
+  "page_size": 20
+}
+```
+
+**4）会话详情**
+
+```json
+{
+  "chat_id": "CHAT_ID"
+}
+```
+
+**5）确认应用在群内**
+
+```json
+{
+  "chat_id": "CHAT_ID"
+}
+```
+
+## 常见错误与排查
+
+| 现象 | 可能原因 | 处理 |
+|------|----------|------|
+| 建群失败 | 成员 ID 无效或成员数不足 | 确认 member_ids 均为有效用户 ID |
+| P2P 创建失败 | 成员数不为 2（去重后）或已存在同对会话 | 确认提供恰好 2 个不同的 user_id |
+| 发群消息无反应 | 应用未入群 | 用 `wps_chat_is_member` 确认 |
+| chat_id 不存在 | 会话已解散 | 用 `wps_chat_get` 检查会话状态 |
+
+## 工具覆盖
+
+- `wps_chat_create` — 创建会话
+- `wps_chat_list` — 列举会话
+- `wps_chat_get` — 查看会话详情
+- `wps_chat_members` — 列举会话成员
+- `wps_chat_is_member` — 判断是否在群