@zhin.js/adapter-dingtalk 1.0.81 → 1.1.0

package/README.md

@@ -1,6 +1,14 @@
 # @zhin.js/adapter-dingtalk
 
-Zhin.js 钉钉适配器，支持企业内部机器人和钉钉开放平台机器人开发。
+Zhin.js 钉钉适配器（Plugin Runtime），通过 Runtime Host HTTP Webhook 收发消息。
+
+## 功能
+
+- Webhook 事件接收（`httpHostToken` POST + HMAC-SHA256 签名验证）
+- Access Token 自动刷新
+- Session Webhook 优先回复 / `/robot/send` 主动发送
+- canonical `markdown` 段编码为钉钉原生 `msgtype: markdown`
+- 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
 
 ## 安装
 
@@ -8,357 +16,83 @@ Zhin.js 钉钉适配器，支持企业内部机器人和钉钉开放平台机器
 pnpm add @zhin.js/adapter-dingtalk
 ```
 
-## 配置
-
-### 基础配置
-
-```typescript
-import { DingTalkBotConfig } from '@zhin.js/adapter-dingtalk';
-
-const config: DingTalkBotConfig = {
-  context: 'dingtalk',
-  name: 'my-dingtalk-bot',
-  appKey: 'YOUR_APP_KEY',           // 钉钉应用 AppKey
-  appSecret: 'YOUR_APP_SECRET',     // 钉钉应用 AppSecret
-  webhookPath: '/dingtalk/webhook', // Webhook 路径
-  robotCode: 'YOUR_ROBOT_CODE'      // 机器人编码（可选）
-}
-```
-
-### 完整配置
-
-```typescript
-const config: DingTalkBotConfig = {
-  context: 'dingtalk',
-  name: 'my-dingtalk-bot',
-  appKey: 'YOUR_APP_KEY',
-  appSecret: 'YOUR_APP_SECRET',
-  webhookPath: '/dingtalk/webhook',
-  robotCode: 'YOUR_ROBOT_CODE',
-  
-  // API 配置
-  apiBaseUrl: 'https://oapi.dingtalk.com' // 自定义API地址（可选）
-}
-```
-
-### 配置参数说明
-
-- `appKey` (必需): 钉钉应用的 AppKey，在开发者后台获取
-- `appSecret` (必需): 钉钉应用的 AppSecret，在开发者后台获取
-- `webhookPath` (必需): Webhook 路径，如 `/dingtalk/webhook`
-- `robotCode` (可选): 机器人编码，用于发送消息时识别机器人身份
-- `apiBaseUrl` (可选): 自定义 API 基础地址，默认为 `https://oapi.dingtalk.com`
-
-## 获取配置信息
-
-### 创建钉钉企业内部应用
-
-1. **访问钉钉开放平台**
-   - 登录 [钉钉开放平台](https://open.dingtalk.com/)
-   - 进入「应用开发」→「企业内部开发」
-
-2. **创建应用**
-   - 点击「创建应用」
-   - 选择「企业内部开发」→「机器人」
-   - 填写应用基本信息（应用名称、应用描述、应用图标等）
-
-3. **获取应用凭证**
-   - 在应用详情页面找到「开发管理」
-   - 获取 **AppKey** 和 **AppSecret**
-   - 记录这些信息用于配置
-
-### 配置机器人
-
-1. **配置机器人能力**
-   - 在应用详情页面，进入「机器人配置」
-   - 启用「消息接收」功能
-   - 获取机器人的 **RobotCode**（机器人编码）
-
-2. **配置消息接收地址**
-   - 在「消息接收」设置中配置接收地址
-   - 设置请求 URL：`https://yourdomain.com/dingtalk/webhook`
-   - 钉钉会通过该地址推送消息事件
-
-3. **配置权限**
-   - 在「权限管理」中申请所需权限：
-     - `通讯录只读权限` - 读取通讯录信息
-     - `企业通讯录个人信息读权限` - 获取用户详细信息
-     - `消息通知` - 发送工作通知
-     - 其他业务需要的权限
-
-4. **发布应用**
-   - 完成配置后，发布应用
-   - 在企业工作台添加应用
-   - 员工可在钉钉中找到并使用该机器人
-
-### 创建群机器人（Webhook 机器人）
-
-如果只需要简单的群聊机器人功能：
-
-1. **在群聊中添加机器人**
-   - 进入钉钉群聊
-   - 点击群设置 → 「智能群助手」
-   - 选择「添加机器人」→「自定义机器人」
-
-2. **配置 Webhook**
-   - 输入机器人名称
-   - 获取 Webhook 地址
-   - 配置安全设置（加签或关键词）
-
-3. **使用限制**
-   - 群机器人只能在对应群聊中使用
-   - 功能相对简单，适合轻量级场景
-
-## 使用示例
-
-### 配置文件（zhin.config.ts）
-
-```typescript
-import { defineConfig } from 'zhin.js'
-
-export default defineConfig({
-  bots: [
-    {
-      name: 'dingtalk-bot',
-      context: 'dingtalk',
-      appKey: 'dingxxxxxxxxxx',
-      appSecret: 'your-app-secret',
-      webhookPath: '/dingtalk/webhook',
-      robotCode: 'dingxxxxxxxxxxxxxxxx'
-    }
-  ],
-  plugins: [
-    '@zhin.js/host-router',
-    '@zhin.js/adapter-dingtalk',
-  ],
-})
-```
-
-### 接收和发送消息
-
-```typescript
-import { usePlugin, MessageCommand } from 'zhin.js'
-
-const { addCommand, logger } = usePlugin()
-
-// 定义命令
-addCommand(new MessageCommand('hello <name:text>')
-  .action(async (message, result) => {
-    logger.info(`收到来自 ${result.params.name} 的问候`)
-    return `你好，${result.params.name}！欢迎使用钉钉机器人。`
-  })
-)
-
-// 监听所有消息
-import { onMessage } from 'zhin.js'
-
-onMessage(async (message) => {
-  logger.info(`收到消息：${message.$raw}`)
-  logger.info(`发送者：${message.$sender.name}`)
-  logger.info(`会话类型：${message.$channel.type}`)
-})
-```
-
-### 使用 @ 功能
-
-```typescript
-addCommand(new MessageCommand('notify <...users:at>')
-  .action(async (message, result) => {
-    const users = result.params.users
-    return [
-      { type: 'text', data: { content: '通知以下用户：\n' } },
-      ...users.map(user => ({ 
-        type: 'at', 
-        data: { id: user.data.id, name: user.data.name } 
-      })),
-      { type: 'text', data: { content: '\n请注意查看！' } }
-    ]
-  })
-)
-```
-
-### 发送富文本消息
-
-```typescript
-addCommand(new MessageCommand('info')
-  .action(async (message) => {
-    return [
-      {
-        type: 'markdown',
-        data: {
-          title: '系统信息',
-          content: `
-# 系统信息
-
-## 基本信息
-- **服务器**: 运行正常
-- **版本**: v1.0.0
-- **状态**: ✅ 在线
-
-## 功能列表
-1. 消息接收与发送
-2. 命令解析
-3. @ 提醒功能
-          `
-        }
-      }
-    ]
-  })
-)
-```
-
-## 消息类型支持
+## Plugin Runtime
 
-### 接收消息类型
+- `@zhin.js/adapter` — 约定式薄入口 `adapters/dingtalk.ts`（`defineAdapter`）
+- 实现：`src/endpoint.ts`（生命周期/出站/OpenAPI）、`src/webhook.ts`（验签入站）、`src/protocol.ts`
+- `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
+- `@zhin.js/host-http` — `httpHostToken` 注册 Webhook 路由（**非** legacy host-router/Koa）
+- `zhin.js` — `plugin.ts`（`definePlugin`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
-- ✅ **文本消息** (`text`) - 普通文本和 @ 提醒
-- ✅ **图片消息** (`picture`) - 图片文件
-- ✅ **文件消息** (`file`) - 各类文件
-- ✅ **语音消息** (`audio`) - 音频文件
-- ✅ **视频消息** (`video`) - 视频文件
-- ✅ **富文本消息** (`richText`) - 富文本内容
-- ✅ **Markdown 消息** (`markdown`) - Markdown 格式
+入站：`gateway.receive({ conversation: ConversationRef, message: { conversation, id }, content: text, sender, metadata })`  
+出站：`send({ conversation, payload })` → sessionWebhook 或 `/robot/send`
 
-### 发送消息类型
+## 前置条件
 
-- ✅ **文本消息** - 支持 @ 提醒
-- ✅ **图片消息** - 通过 URL 发送
-- ✅ **Markdown 消息** - 富文本展示
-- ✅ **链接消息** - 卡片式链接
-- ❌ **撤回消息** - 钉钉机器人不支持撤回
+1. 在 [钉钉开放平台](https://open.dingtalk.com/) 创建企业内部应用 / 机器人
+2. 获取 **AppKey**、**AppSecret**（可选 RobotCode）
+3. 设置消息接收 URL 为 `https://your-domain/dingtalk/webhook`
+4. Runtime Host（`http`）须已 listen，Webhook 才可达
 
-## API 方法
+必填字段（`endpoints[i]`）：`name`、`appKey`、`appSecret`、`webhookPath`、`robotCode`。
 
-### 获取用户信息
+## 最小配置
 
-```typescript
-const bot = app.adapters.get('dingtalk')?.bots.get('dingtalk-bot')
-if (bot) {
-  const userInfo = await bot.getUserInfo('user-id')
-  console.log(userInfo)
-}
+```yaml
+# zhin.config.yml（Plugin Runtime）
+plugins:
+  dingtalk:
+    apiBaseUrl: https://oapi.dingtalk.com # 可选，顶层共享
+    endpoints:
+      - name: my-dingtalk-bot
+        appKey: ${DINGTALK_APP_KEY}
+        appSecret: ${DINGTALK_APP_SECRET}
+        robotCode: ${DINGTALK_ROBOT_CODE}
+        webhookPath: /dingtalk/webhook   # 可选，默认 /dingtalk/webhook
 ```
 
-### 获取部门用户列表
+根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-dingtalk`（`instanceKey: dingtalk`）。
 
-```typescript
-const users = await bot.getDepartmentUsers(1) // 部门 ID
-console.log(users)
-```
-
-### 发送工作通知
-
-```typescript
-await bot.sendWorkNotice(
-  ['user1', 'user2'], // 用户 ID 列表
-  {
-    msgtype: 'text',
-    text: { content: '这是一条工作通知' }
-  }
-)
-```
-
-## 安全说明
+## 环境变量
 
-### 签名验证
+| 变量 | 说明 |
+|------|------|
+| `DINGTALK_APP_KEY` | 应用 AppKey |
+| `DINGTALK_APP_SECRET` | 应用 AppSecret |
+| `DINGTALK_ROBOT_CODE` | RobotCode（主动发送 `/robot/send`） |
 
-钉钉会在 Webhook 请求的 Header 中携带签名信息：
-- `timestamp`: 时间戳
-- `sign`: 签名值
+## 消息类型映射
 
-适配器会自动验证签名，确保请求来自钉钉服务器。
+| 钉钉类型 | 入站 content（文本摘要） | 出站 wire |
+|----------|--------------------------|-----------|
+| text | 原文 | text |
+| picture | `[image]` | picture（需 `url`） |
+| file | `[file: name]` | — |
+| audio / video | `[audio]` / `[video]` | — |
+| markdown | 原文或 `[markdown]` | markdown |
+| link | — | link |
 
-### Token 管理
+## Agent 工具
 
-适配器会自动管理 access_token：
-- 首次连接时获取 token
-- Token 过期前 5 分钟自动刷新
-- 所有 API 请求自动携带有效 token
+`agent/` 目录保留（get_user、部门、群聊、工作通知等）。工具声明 `adapter: 'dingtalk'` 后，通过惰性的 `context.$client` 自动取得当前操作的 `DingTalkClient`；无需把 Endpoint id 暴露给模型。
 
-## 最佳实践
-
-### 1. 配置环境变量
-
-不要在代码中硬编码敏感信息：
-
-```typescript
-export default defineConfig({
-  bots: [{
-    name: 'dingtalk-bot',
-    context: 'dingtalk',
-    appKey: process.env.DINGTALK_APP_KEY!,
-    appSecret: process.env.DINGTALK_APP_SECRET!,
-    webhookPath: '/dingtalk/webhook',
-    robotCode: process.env.DINGTALK_ROBOT_CODE
-  }]
-})
-```
+## 平台权限（platform permit）
 
-### 2. 错误处理
+`plugin.ts` 在 generation setup 注册 `src/platform-permit.ts` checker，并在 dispose 注销；CapabilityIngress 与 ToolSystem 统一经 Core `canAccessTool()` 消费工具权限。
 
-处理可能的错误情况：
+## 测试
 
-```typescript
-onMessage(async (message) => {
-  try {
-    // 处理消息逻辑
-  } catch (error) {
-    logger.error('处理消息失败:', error)
-    await message.$reply('抱歉，处理消息时出现错误')
-  }
-})
-```
-
-### 3. 消息限流
-
-注意钉钉的 API 调用频率限制，避免过于频繁的请求。
-
-### 4. 日志记录
-
-开启详细日志，便于排查问题：
-
-```typescript
-export default defineConfig({
-  log_level: 'debug', // 开发环境使用 debug
-  // ... 其他配置
-})
+```bash
+pnpm --filter @zhin.js/adapter-dingtalk build
+pnpm --filter @zhin.js/adapter-dingtalk test
 ```
 
-## 常见问题
-
-### Q: Webhook 收不到消息？
-
-A: 检查以下几点：
-1. Webhook URL 是否可以从公网访问
-2. 钉钉后台的消息接收地址是否配置正确
-3. 应用是否已经发布并添加到工作台
-4. 检查服务器日志是否有错误信息
-
-### Q: 发送消息失败？
-
-A: 可能的原因：
-1. AppKey 或 AppSecret 配置错误
-2. access_token 获取失败
-3. 机器人编码（robotCode）配置错误
-4. 网络问题或 API 限流
-
-### Q: @ 功能不生效？
-
-A: 确保：
-1. 使用正确的用户 ID 格式
-2. @ 的用户在当前会话中
-3. 消息格式正确包含 at 字段
-
-## 相关链接
-
-- [钉钉开放平台](https://open.dingtalk.com/)
-- [钉钉机器人开发文档](https://open.dingtalk.com/document/robots/robot-overview)
-- [Zhin.js 官方文档](https://github.com/zhinjs/zhin)
-
-## 许可证
-
-MIT License
-
-## 贡献
+## 故障排查
 
-欢迎提交 Issue 和 Pull Request！
+| 现象 | 排查 |
+| --- | --- |
+| 平台校验 URL 失败 | 确认公网 HTTPS 可达，HTTP Host 已监听，路径与 `webhookPath` 一致 |
+| Webhook 返回 401/403 | 检查 `appSecret`、签名时间戳与服务器时钟 |
+| 能收到但无法回复 | 检查 `robotCode`、应用权限与 session webhook 是否有效 |
+| Endpoint 未出现 | 在日志查 Schema 或凭据错误，再到运行时能力核对 Endpoint |

package/adapters/dingtalk.js

@@ -0,0 +1,33 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+/**
+ * Convention entry: discover `adapters/dingtalk.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { httpHostToken } from '@zhin.js/host-http';
+import { DingTalkEndpoint } from "../lib/endpoint.js";
+import { resolveDingTalkConfig, } from "../lib/protocol.js";
+import { dingtalkRuntimeStateToken } from "../lib/dingtalk-runtime-state.js";
+export { DingTalkEndpoint } from "../lib/endpoint.js";
+export default defineAdapter({
+    capabilities: ['inbound', 'outbound'],
+    // 钉钉机器人媒体消息仅消费远程 URL；Markdown 走原生 msgtype；
+    // 无按钮交互面，交互段降级纯文本。
+    segments: {
+        outboundMedia: ['url'],
+        interactive: 'text',
+        markdown: 'native',
+    },
+    create(context) {
+        const config = resolveDingTalkConfig(context.config);
+        // 注册到插件运行时状态（dingtalk.endpoint list 的"运行中"数据源）
+        context.use(dingtalkRuntimeStateToken).endpoints.set(config.id, {
+            id: config.id,
+            mode: 'webhook',
+        });
+        return new DingTalkEndpoint({
+            id: context.id,
+            http: context.use(httpHostToken),
+            config,
+        });
+    },
+});

package/adapters/dingtalk.ts

@@ -0,0 +1,38 @@
+/**
+ * Convention entry: discover `adapters/dingtalk.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { httpHostToken } from '@zhin.js/host-http';
+import { DingTalkEndpoint } from '../src/endpoint.js';
+import {
+  resolveDingTalkConfig,
+  type DingTalkAdapterConfig,
+} from '../src/protocol.js';
+import { dingtalkRuntimeStateToken } from '../src/dingtalk-runtime-state.js';
+
+export { DingTalkEndpoint } from '../src/endpoint.js';
+export type { DingTalkEndpointOptions, DingTalkFetch } from '../src/endpoint.js';
+
+export default defineAdapter<DingTalkAdapterConfig>({
+  capabilities: ['inbound', 'outbound'],
+  // 钉钉机器人媒体消息仅消费远程 URL；Markdown 走原生 msgtype；
+  // 无按钮交互面，交互段降级纯文本。
+  segments: {
+    outboundMedia: ['url'],
+    interactive: 'text',
+    markdown: 'native',
+  },
+  create(context) {
+    const config = resolveDingTalkConfig(context.config);
+    // 注册到插件运行时状态（dingtalk.endpoint list 的"运行中"数据源）
+    context.use(dingtalkRuntimeStateToken).endpoints.set(config.id, {
+      id: config.id,
+      mode: 'webhook',
+    });
+    return new DingTalkEndpoint({
+      id: context.id,
+      http: context.use(httpHostToken),
+      config,
+    });
+  },
+});

package/agent/PERMITS.md

@@ -0,0 +1,19 @@
+# 钉钉 DingTalk Platform Permits
+
+## 入站字段
+
+| 字段 | 来源 |
+|------|------|
+| `$sender.role` | `isAdmin` → `admin`；`owner` 需业务侧创建群时指定 |
+| `$sender.permissions` | `chat_owner` · `chat_admin` |
+
+## Permit 词汇表
+
+| `platform(dingtalk,…)` | 含义 |
+|------------------------|------|
+| `chat_owner` | 群主（创建群等） |
+| `chat_admin` | 群管理员 |
+
+## 工厂映射
+
+`scene_admin` → `chat_admin` · `scene_owner` → `chat_owner`

package/agent/tools/add_chat_members.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{ chat_id: string; user_ids: string }>({
+  description: '向钉钉群聊添加成员',
+  inputSchema: z.object({
+    chat_id: z.string().describe('群聊 ID'),
+    user_ids: z.string().describe('要添加的用户 ID 列表，逗号分隔'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  permissions: [platformPermit('chat_admin')],
+  async execute({ chat_id, user_ids    }: { chat_id: string; user_ids: string }, context) {
+    const endpoint = context.$client;
+    const success = await endpoint.updateChat(chat_id, { add_useridlist: user_ids.split(',') });
+    return { success, message: success ? '成员添加成功' : '添加失败' };
+  },
+});
+

package/agent/tools/create_chat.ts

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{ name: string; owner: string; members: string }>({
+  description: '创建钉钉群聊',
+  inputSchema: z.object({
+    name: z.string().describe('群名'),
+    owner: z.string().describe('群主用户 ID'),
+    members: z.string().describe('成员用户 ID 列表，逗号分隔'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  permissions: [platformPermit('chat_owner')],
+  async execute({ name, owner, members    }: { name: string; owner: string; members: string }, context) {
+    const endpoint = context.$client;
+    const chatId = await endpoint.createChat(name, owner, members.split(','));
+    return { success: !!chatId, chat_id: chatId, message: chatId ? `群聊创建成功: ${chatId}` : '创建失败' };
+  },
+});
+

package/agent/tools/dept_info.ts

@@ -0,0 +1,15 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+export default defineAgentTool<{ dept_id: string }>({
+  description: '获取钉钉部门详细信息',
+  inputSchema: z.object({
+    dept_id: z.string().describe('部门 ID'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ dept_id    }: { dept_id: string }, context) {
+    const endpoint = context.$client;
+    return await endpoint.getDepartmentInfo(Number(dept_id));
+  },
+});
+

package/agent/tools/get_dept_users.ts

@@ -0,0 +1,16 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+export default defineAgentTool<{ dept_id: string }>({
+  description: '获取钉钉部门用户列表',
+  inputSchema: z.object({
+    dept_id: z.string().describe('部门 ID'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ dept_id    }: { dept_id: string }, context) {
+    const endpoint = context.$client;
+    const users = await endpoint.getDepartmentUsers(Number(dept_id));
+    return { users, count: users.length };
+  },
+});
+

package/agent/tools/get_user.ts

@@ -0,0 +1,15 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+export default defineAgentTool<{ user_id: string }>({
+  description: '获取钉钉用户信息',
+  inputSchema: z.object({
+    user_id: z.string().describe('用户 ID'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ user_id    }: { user_id: string }, context) {
+    const endpoint = context.$client;
+    return await endpoint.getUserInfo(user_id);
+  },
+});
+

package/agent/tools/list_departments.ts

@@ -0,0 +1,16 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+export default defineAgentTool<{ dept_id?: string }>({
+  description: '获取钉钉部门列表',
+  inputSchema: z.object({
+    dept_id: z.string().optional().describe('父部门 ID，默认 1（根部门）'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ dept_id    }: { dept_id?: string }, context) {
+    const endpoint = context.$client;
+    const departments = await endpoint.getDepartmentList(Number(dept_id || '1'));
+    return { departments, count: departments.length };
+  },
+});
+

package/agent/tools/send_work_notice.ts

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+export default defineAgentTool<{ user_ids: string; content: string }>({
+  description: '向指定用户发送钉钉工作通知',
+  inputSchema: z.object({
+    user_ids: z.string().describe('用户 ID 列表，逗号分隔'),
+    content: z.string().describe('通知内容'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ user_ids, content    }: { user_ids: string; content: string }, context) {
+    const endpoint = context.$client;
+    const msgContent = { msgtype: 'text', text: { content } };
+    const success = await endpoint.sendWorkNotice(user_ids.split(','), msgContent);
+    return { success, message: success ? '工作通知已发送' : '发送失败' };
+  },
+});
+

package/agent/tools/update_chat.ts

@@ -0,0 +1,25 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+export default defineAgentTool<{ chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }>({
+  description: '更新钉钉群聊设置（改名、换群主、增减成员）',
+  inputSchema: z.object({
+    chat_id: z.string().describe('群聊 ID'),
+    name: z.string().optional().describe('新群名（可选）'),
+    owner: z.string().optional().describe('新群主 userId（可选）'),
+    add_members: z.string().optional().describe('要添加的成员 userId，逗号分隔（可选）'),
+    remove_members: z.string().optional().describe('要移除的成员 userId，逗号分隔（可选）'),
+  }),
+  adapter: 'dingtalk',
+  tags: ['dingtalk'],
+  async execute({ chat_id, name, owner, add_members, remove_members    }: { chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }, context) {
+    const endpoint = context.$client;
+    const options: Record<string, unknown> = {};
+    if (name) options.name = name;
+    if (owner) options.owner = owner;
+    if (add_members) options.add_useridlist = add_members.split(',').map((s: string) => s.trim());
+    if (remove_members) options.del_useridlist = remove_members.split(',').map((s: string) => s.trim());
+    await endpoint.updateChat(chat_id, options);
+    return { success: true, message: '群聊设置已更新' };
+  },
+});
+

package/commands/endpoint/add/[id].js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { dingtalkEndpointCommands } from "../../../lib/dingtalk-endpoint-commands.js";
+export default dingtalkEndpointCommands.add;