@zhin.js/adapter-dingtalk 1.1.0 → 1.1.3

package/CHANGELOG.md

@@ -1,5 +1,112 @@
 # @zhin.js/adapter-dingtalk
 
+## 1.1.3
+
+### Patch Changes
+
+- Updated dependencies [5b5d270]
+- Updated dependencies [36c2eb9]
+  - @zhin.js/im-contract@1.1.2
+  - @zhin.js/core@1.1.38
+  - @zhin.js/adapter@1.1.15
+  - @zhin.js/host-http@1.1.2
+  - @zhin.js/agent-feature@1.1.2
+  - @zhin.js/feature-kit@1.1.2
+  - @zhin.js/skill@1.1.2
+  - @zhin.js/tool@1.1.2
+
+## 1.1.2
+
+### Patch Changes
+
+- a9e4a40: Derive Command user routes only from explicit `commands/**/*/index.ts(x)` entry paths instead of prepending the plugin owner. Child plugins can now publish top-level static or dynamic commands, while duplicate routes across owners fail during generation construction. Adapter endpoint commands move to explicit paths such as `commands/qq/endpoint/list/index.ts` and are invoked as `qq endpoint list`.
+- 8740059: Standardize TypeScript capabilities on named module directories such as `commands/foo/index.ts`, `middlewares/audit/index.ts`, `handlers/message-receive/index.ts`, `pages/workroom/index.tsx`, and `mcps/filesystem/index.ts`. Only the fixed `index` entry is discovered; sibling files remain private helpers.
+
+  Command route segments come from directories, while `[name]`, `[[name]]`, `[...name]`, and `[[...name]]` directories declare dynamic parameters. Plugin owners do not enter the route unless their config explicitly sets `commandNamespace`; Endpoint `commandPrefix` remains platform-owned and defaults to an empty string.
+
+  Migrate the built-in adapters, plugins, examples, generators, migration tooling, hot reload classification, Agent authoring surfaces, documentation, and release artifacts to the explicit entry convention.
+
+  Make Tool ownership and progressive disclosure explicit across all four supported locations: plugin-public `tools/`, Agent-private `agents/<name>/tools/`, Skill-private `skills/<name>/tools/`, and Agent-Skill-private `agents/<name>/skills/<name>/tools/`. Move adapter and group-suite operations that require domain instructions into their owning Skills so `load_skill` is the only path that unlocks their schemas.
+
+  Remove the package-root `agent/` convention. Public capabilities now use named package-root directories, schedules use `schedules/<name>/index.ts` or `plugin.ts` injection, MCP connections use `mcps/<name>/index.ts`, Prompt Sections use `prompt-sections/<name>/index.ts`, Agent definitions use `agents/<name>/`, and permission vocabulary is published as `PERMITS.md`.
+
+- 25a845a: Unify Skills on `skills/<name>/SKILL.md`, support Agent-private Skills and nested Skill-private Tools, publish and mount existing plugin Skills, add governed Skill metadata and Turn access filtering, unlock only already-admitted same-owner Tools, and make `on-risk` and `once` approval behavior precise.
+- ddbb92e: Isolate adapter Skills under platform-specific Agents and automatically select the matching platform Agent for IM ingress, preventing unrelated adapter Skills from entering another platform's prompt surface.
+- 4380cf9: Colocate adapter command definitions and Agent Skill handlers with their owning capabilities, and provide a shared validated platform permission constructor.
+- ab6bde9: Require the canonical expanded DingTalk endpoint configuration. The protocol no longer reinterprets nested `endpoints` or reads endpoint identity and app credentials from `process.env`. The public config type is now `DingTalkEndpointConfig`; optional webhook and robot fields are no longer incorrectly required by the schema.
+- 5c3858e: Make `@zhin.js/im-contract` the explicit zero-dependency owner of transport identities, canonical segments, media guards, conversation facts, stores, and delivery contracts. Platform adapters now read media contracts from that foundation instead of reaching through Core.
+- 33ea736: Use `tools/<name>/index.ts` and `defineAgentTool` from `@zhin.js/tool` as the sole Agent Tool authoring model. Remove the duplicate `@zhin.js/tools` definition, context, bridge, export, and discovery path; migrate plugin manifests, examples, scaffolding, HMR, and prepack compilation to the generation-owned Tool Feature.
+- Updated dependencies [c861789]
+- Updated dependencies [1414ccb]
+- Updated dependencies [743d470]
+- Updated dependencies [62dee52]
+- Updated dependencies [cd54131]
+- Updated dependencies [244e475]
+- Updated dependencies [a9e4a40]
+- Updated dependencies [5855db7]
+- Updated dependencies [ec921d2]
+- Updated dependencies [8740059]
+- Updated dependencies [63d1f7a]
+- Updated dependencies [25a845a]
+- Updated dependencies [103f2c3]
+- Updated dependencies [9110ab8]
+- Updated dependencies [cd2a888]
+- Updated dependencies [eb3227a]
+- Updated dependencies [b853dba]
+- Updated dependencies [e561309]
+- Updated dependencies [d4c6175]
+- Updated dependencies [7a0e1ca]
+- Updated dependencies [103b5d3]
+- Updated dependencies [5a7a7f7]
+- Updated dependencies [b076eae]
+- Updated dependencies [535fed1]
+- Updated dependencies [73a24b7]
+- Updated dependencies [2dbbc15]
+- Updated dependencies [1cb1163]
+- Updated dependencies [be3061e]
+- Updated dependencies [75f8332]
+- Updated dependencies [81935e2]
+- Updated dependencies [f9ed01b]
+- Updated dependencies [ac0ab50]
+- Updated dependencies [5140ce1]
+- Updated dependencies [522d75f]
+- Updated dependencies [a7611b3]
+- Updated dependencies [8823044]
+- Updated dependencies [379439b]
+- Updated dependencies [11c9352]
+- Updated dependencies [6b70e46]
+- Updated dependencies [135ac91]
+- Updated dependencies [140cf0f]
+- Updated dependencies [251e4d2]
+- Updated dependencies [203ad34]
+- Updated dependencies [e6c5113]
+- Updated dependencies [e0f6478]
+- Updated dependencies [baef56b]
+- Updated dependencies [698f16f]
+- Updated dependencies [da0a8e3]
+- Updated dependencies [2fd8017]
+- Updated dependencies [5c3858e]
+- Updated dependencies [33ea736]
+- Updated dependencies [507d602]
+- Updated dependencies [df9f76b]
+  - @zhin.js/core@1.1.37
+  - @zhin.js/tool@1.1.1
+  - @zhin.js/host-http@1.1.1
+  - @zhin.js/adapter@1.1.14
+  - @zhin.js/feature-kit@1.1.1
+  - @zhin.js/agent-feature@1.1.1
+  - @zhin.js/skill@1.1.1
+  - @zhin.js/logger@1.1.1
+  - @zhin.js/im-contract@1.1.1
+
+## 1.1.1
+
+### Patch Changes
+
+- Updated dependencies [769e67f]
+  - @zhin.js/adapter@1.1.13
+  - @zhin.js/core@1.1.36
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -18,7 +18,7 @@ pnpm add @zhin.js/adapter-dingtalk
 
 ## Plugin Runtime
 
-- `@zhin.js/adapter` — 约定式薄入口 `adapters/dingtalk.ts`（`defineAdapter`）
+- `@zhin.js/adapter` — 约定式薄入口 `adapters/dingtalk/index.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）
@@ -35,7 +35,7 @@ pnpm add @zhin.js/adapter-dingtalk
 3. 设置消息接收 URL 为 `https://your-domain/dingtalk/webhook`
 4. Runtime Host（`http`）须已 listen，Webhook 才可达
 
-必填字段（`endpoints[i]`）：`name`、`appKey`、`appSecret`、`webhookPath`、`robotCode`。
+必填字段（`endpoints[i]`）：`id`、`appKey`、`appSecret`。
 
 ## 最小配置
 
@@ -45,7 +45,7 @@ plugins:
   dingtalk:
     apiBaseUrl: https://oapi.dingtalk.com # 可选，顶层共享
     endpoints:
-      - name: my-dingtalk-bot
+      - id: my-dingtalk-bot
         appKey: ${DINGTALK_APP_KEY}
         appSecret: ${DINGTALK_APP_SECRET}
         robotCode: ${DINGTALK_ROBOT_CODE}
@@ -58,9 +58,9 @@ plugins:
 
 | 变量 | 说明 |
 |------|------|
-| `DINGTALK_APP_KEY` | 应用 AppKey |
-| `DINGTALK_APP_SECRET` | 应用 AppSecret |
-| `DINGTALK_ROBOT_CODE` | RobotCode（主动发送 `/robot/send`） |
+| `DINGTALK_APP_KEY` | 示例中由 YAML `${DINGTALK_APP_KEY}` 引用的 AppKey；变量名可自行定义 |
+| `DINGTALK_APP_SECRET` | 示例中由 YAML `${DINGTALK_APP_SECRET}` 引用的 AppSecret；变量名可自行定义 |
+| `DINGTALK_ROBOT_CODE` | 示例中由 YAML `${DINGTALK_ROBOT_CODE}` 引用的 RobotCode；变量名可自行定义 |
 
 ## 消息类型映射
 
@@ -75,7 +75,7 @@ plugins:
 
 ## Agent 工具
 
-`agent/` 目录保留（get_user、部门、群聊、工作通知等）。工具声明 `adapter: 'dingtalk'` 后，通过惰性的 `context.$client` 自动取得当前操作的 `DingTalkClient`；无需把 Endpoint id 暴露给模型。
+`agents/dingtalk/skills/dingtalk/tools/` 在 DingTalk Skill 激活后提供 get_user、部门、群聊、工作通知等 Tool。工具声明 `adapter: 'dingtalk'` 后，通过惰性的 `context.$client` 自动取得当前操作的 `DingTalkClient`；无需把 Endpoint id 暴露给模型。
 
 ## 平台权限（platform permit）
 

package/adapters/{dingtalk.js → dingtalk/index.js}

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * Convention entry: discover `adapters/dingtalk.ts` → defineAdapter.
+ * Convention entry: discover `adapters/dingtalk/index.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";
+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；
@@ -19,7 +19,7 @@ export default defineAdapter({
     },
     create(context) {
         const config = resolveDingTalkConfig(context.config);
-        // 注册到插件运行时状态（dingtalk.endpoint list 的"运行中"数据源）
+        // 注册到插件运行时状态（dingtalk endpoint list 的"运行中"数据源）
         context.use(dingtalkRuntimeStateToken).endpoints.set(config.id, {
             id: config.id,
             mode: 'webhook',

package/adapters/{dingtalk.ts → dingtalk/index.ts}

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

package/agents/dingtalk/agent.json

@@ -0,0 +1,20 @@
+{
+  "name": "DINGTALK Platform Agent",
+  "version": "1.0.0",
+  "description": "Handles dingtalk platform-specific operations and progressively loads only the required platform Skill.",
+  "trigger_rules": {
+    "file_patterns": [],
+    "keywords": [
+      "dingtalk",
+      "adapter:dingtalk"
+    ]
+  },
+  "entry_points": [
+    "system.md",
+    "boundaries.md",
+    "conventions.md"
+  ],
+  "platforms": [
+    "dingtalk"
+  ]
+}

package/agents/dingtalk/boundaries.md

@@ -0,0 +1,3 @@
+# Boundaries
+
+Operate only on the active dingtalk endpoint and authenticated conversation context. Respect every Tool permission and approval policy. Do not infer identifiers, roles, or authorization from display names.

package/agents/dingtalk/conventions.md

@@ -0,0 +1,3 @@
+# Conventions
+
+Use stable platform identifiers from the current turn or directory queries. Load one task-specific Skill at a time, and use the unified reply and outbound message path.

package/agents/dingtalk/skills/dingtalk/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: dingtalk
+platforms: [dingtalk]
+description: 钉钉组织查询、工作通知和群聊创建维护能力。
+keywords: [dingtalk, 钉钉, 部门, 用户, 工作通知, 群聊]
+tags: [adapter, collaboration]
+tools:
+  - get_user
+  - get_dept_users
+  - list_departments
+  - send_work_notice
+  - create_chat
+  - add_chat_members
+  - dept_info
+  - update_chat
+---
+
+# 钉钉
+
+用户或部门信息不完整时，先查询再执行写操作：
+
+1. 用 `list_departments` / `dept_info` 确认部门。
+2. 用 `get_dept_users` / `get_user` 解析稳定的用户 ID。
+3. 发送工作通知，或创建、更新群聊并添加成员。
+
+不要把昵称直接当作用户 ID。当前 Agent Tool 不提供踢人、改群名或读取当前群详情能力；遇到这些请求时应明确说明能力边界。

package/agents/dingtalk/skills/dingtalk/tools/add_chat_members/index.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '向钉钉群聊添加成员',
+    inputSchema: z.object({
+        chat_id: z.string().describe('群聊 ID'),
+        user_ids: z.string().describe('要添加的用户 ID 列表，逗号分隔'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    permissions: [platformPermission('dingtalk', 'chat_admin')],
+    async execute({ chat_id, user_ids }, context) {
+        const endpoint = context.$client;
+        const success = await endpoint.updateChat(chat_id, { add_useridlist: user_ids.split(',') });
+        return { success, message: success ? '成员添加成功' : '添加失败' };
+    },
+});

package/{agent/tools/add_chat_members.ts → agents/dingtalk/skills/dingtalk/tools/add_chat_members/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ chat_id: string; user_ids: string }>({
   description: '向钉钉群聊添加成员',
@@ -10,7 +10,7 @@ export default defineAgentTool<{ chat_id: string; user_ids: string }>({
   }),
   adapter: 'dingtalk',
   tags: ['dingtalk'],
-  permissions: [platformPermit('chat_admin')],
+  permissions: [platformPermission('dingtalk', '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(',') });

package/agents/dingtalk/skills/dingtalk/tools/create_chat/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '创建钉钉群聊',
+    inputSchema: z.object({
+        name: z.string().describe('群名'),
+        owner: z.string().describe('群主用户 ID'),
+        members: z.string().describe('成员用户 ID 列表，逗号分隔'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    permissions: [platformPermission('dingtalk', 'chat_owner')],
+    async execute({ name, owner, members }, 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/create_chat.ts → agents/dingtalk/skills/dingtalk/tools/create_chat/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ name: string; owner: string; members: string }>({
   description: '创建钉钉群聊',
@@ -11,7 +11,7 @@ export default defineAgentTool<{ name: string; owner: string; members: string }>
   }),
   adapter: 'dingtalk',
   tags: ['dingtalk'],
-  permissions: [platformPermit('chat_owner')],
+  permissions: [platformPermission('dingtalk', '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(','));

package/agents/dingtalk/skills/dingtalk/tools/dept_info/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取钉钉部门详细信息',
+    inputSchema: z.object({
+        dept_id: z.string().describe('部门 ID'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ dept_id }, context) {
+        const endpoint = context.$client;
+        return await endpoint.getDepartmentInfo(Number(dept_id));
+    },
+});

package/{agent/tools/dept_info.ts → agents/dingtalk/skills/dingtalk/tools/dept_info/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ dept_id: string }>({
   description: '获取钉钉部门详细信息',

package/agents/dingtalk/skills/dingtalk/tools/get_dept_users/index.js

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

package/{agent/tools/get_dept_users.ts → agents/dingtalk/skills/dingtalk/tools/get_dept_users/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ dept_id: string }>({
   description: '获取钉钉部门用户列表',

package/agents/dingtalk/skills/dingtalk/tools/get_user/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取钉钉用户信息',
+    inputSchema: z.object({
+        user_id: z.string().describe('用户 ID'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ user_id }, context) {
+        const endpoint = context.$client;
+        return await endpoint.getUserInfo(user_id);
+    },
+});

package/{agent/tools/get_user.ts → agents/dingtalk/skills/dingtalk/tools/get_user/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ user_id: string }>({
   description: '获取钉钉用户信息',

package/agents/dingtalk/skills/dingtalk/tools/list_departments/index.js

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

package/{agent/tools/list_departments.ts → agents/dingtalk/skills/dingtalk/tools/list_departments/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ dept_id?: string }>({
   description: '获取钉钉部门列表',

package/agents/dingtalk/skills/dingtalk/tools/send_work_notice/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '向指定用户发送钉钉工作通知',
+    inputSchema: z.object({
+        user_ids: z.string().describe('用户 ID 列表，逗号分隔'),
+        content: z.string().describe('通知内容'),
+    }),
+    adapter: 'dingtalk',
+    tags: ['dingtalk'],
+    async execute({ user_ids, content }, 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/send_work_notice.ts → agents/dingtalk/skills/dingtalk/tools/send_work_notice/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ user_ids: string; content: string }>({
   description: '向指定用户发送钉钉工作通知',

package/agents/dingtalk/skills/dingtalk/tools/update_chat/index.js

@@ -0,0 +1,29 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    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 }, context) {
+        const endpoint = context.$client;
+        const options = {};
+        if (name)
+            options.name = name;
+        if (owner)
+            options.owner = owner;
+        if (add_members)
+            options.add_useridlist = add_members.split(',').map((s) => s.trim());
+        if (remove_members)
+            options.del_useridlist = remove_members.split(',').map((s) => s.trim());
+        await endpoint.updateChat(chat_id, options);
+        return { success: true, message: '群聊设置已更新' };
+    },
+});

package/{agent/tools/update_chat.ts → agents/dingtalk/skills/dingtalk/tools/update_chat/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }>({
   description: '更新钉钉群聊设置（改名、换群主、增减成员）',

package/agents/dingtalk/system.md

@@ -0,0 +1,3 @@
+# DINGTALK Platform Agent
+
+You are the dingtalk platform specialist. Interpret requests in the current dingtalk conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[id].js → dingtalk/endpoint/add/[id]/index.js}

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

package/commands/dingtalk/endpoint/add/[id]/index.ts

@@ -0,0 +1,3 @@
+import { dingtalkEndpointCommands } from '../../definition.js';
+
+export default dingtalkEndpointCommands.add;

package/{lib/dingtalk-endpoint-commands.js → commands/dingtalk/endpoint/definition.js}

@@ -1,10 +1,11 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * `dingtalk.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `dingtalk endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/dingtalk/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { dingtalkRuntimeStateToken } from './dingtalk-runtime-state.js';
+import { dingtalkRuntimeStateToken } from "../../../lib/dingtalk-runtime-state.js";
 export const dingtalkEndpointCommands = createEndpointCommands({
     adapterKey: 'dingtalk',
     adapterDisplayName: 'DingTalk',

package/{src/dingtalk-endpoint-commands.ts → commands/dingtalk/endpoint/definition.ts}

@@ -1,10 +1,10 @@
 /**
- * `dingtalk.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `dingtalk endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/dingtalk/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { dingtalkRuntimeStateToken } from './dingtalk-runtime-state.js';
+import { dingtalkRuntimeStateToken } from '../../../src/dingtalk-runtime-state.js';
 
 export const dingtalkEndpointCommands = createEndpointCommands({
   adapterKey: 'dingtalk',

package/commands/{endpoint/list.js → dingtalk/endpoint/list/index.js}

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

package/commands/dingtalk/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { dingtalkEndpointCommands } from '../definition.js';
+
+export default dingtalkEndpointCommands.list;

package/commands/{endpoint/remove/[id].js → dingtalk/endpoint/remove/[id]/index.js}

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

package/commands/dingtalk/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { dingtalkEndpointCommands } from '../../definition.js';
+
+export default dingtalkEndpointCommands.remove;

package/lib/dingtalk-runtime-state.js

@@ -1,6 +1,6 @@
 /**
  * DingTalk 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `dingtalk.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `dingtalk endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 export const dingtalkRuntimeStateToken = defineEndpointRuntimeStateToken('dingtalk');

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { dingtalkInboundConversation, formatInboundContent, formatOutboundBody, generateMessageId, headerValue, normalizeWebhookPath, readTextBody, resolveChatType, resolveDingTalkConfig, resolveSender, verifySignature, type AccessToken, type DingTalkAdapterConfig, type DingTalkApiResponse, type DingTalkEvent, type DingTalkMessage, type DingTalkSendBody, type DingTalkWireSegment, type ResolvedDingTalkConfig, } from './protocol.js';
+export { dingtalkInboundConversation, formatInboundContent, formatOutboundBody, generateMessageId, headerValue, normalizeWebhookPath, readTextBody, resolveChatType, resolveDingTalkConfig, resolveSender, verifySignature, type AccessToken, type DingTalkEndpointConfig, type DingTalkApiResponse, type DingTalkEvent, type DingTalkMessage, type DingTalkSendBody, type DingTalkWireSegment, type ResolvedDingTalkConfig, } from './protocol.js';
 export { DingTalkClient, DingTalkEndpoint, type DingTalkClientApi, type DingTalkEndpointOptions, type DingTalkFetch, } from './endpoint.js';
 export { registerDingTalkWebhookRoutes, handleDingTalkWebhookRequest, type DingTalkWebhookHandler, } from './webhook.js';
 export { dingtalkClient, type DingtalkClientEventMap } from './client.js';

package/lib/protocol.d.ts

@@ -3,19 +3,15 @@
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
 import type { IncomingMessage } from 'node:http';
-import type { ConversationRef } from '@zhin.js/im-contract';
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface DingTalkAdapterConfig {
-    readonly id?: string;
-    readonly appKey?: string;
-    readonly appSecret?: string;
+import { type ConversationRef } from '@zhin.js/im-contract';
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface DingTalkEndpointConfig {
+    readonly id: string;
+    readonly appKey: string;
+    readonly appSecret: string;
     readonly webhookPath?: string;
     readonly robotCode?: string;
     readonly apiBaseUrl?: string;
-    /** Transitional: legacy root `endpoints[]` with `context: dingtalk`. */
-    readonly endpoints?: ReadonlyArray<Partial<ResolvedDingTalkConfig> & {
-        readonly context?: string;
-    }>;
 }
 export interface ResolvedDingTalkConfig {
     readonly context: 'dingtalk';
@@ -102,7 +98,7 @@ export interface DingTalkSendBody {
     };
     readonly robotCode?: string;
 }
-export declare function resolveDingTalkConfig(config?: DingTalkAdapterConfig): ResolvedDingTalkConfig;
+export declare function resolveDingTalkConfig(config: DingTalkEndpointConfig): ResolvedDingTalkConfig;
 export declare function normalizeWebhookPath(path: string): string;
 export declare function resolveChatType(conversationType?: string): 'group' | 'private';
 /**

package/lib/protocol.js

@@ -3,7 +3,7 @@
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
 import { createHmac, timingSafeEqual } from 'node:crypto';
-import { isMediaRef } from '@zhin.js/core';
+import { isMediaRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 const logger = getLogger('dingtalk');
 /**
@@ -22,20 +22,13 @@ export function isDingtalkBotMentioned(event, robotCode) {
     }
     return (event.atUsers ?? []).some((user) => user.dingtalkId === robotCode);
 }
-export function resolveDingTalkConfig(config = {}) {
-    const entry = config.endpoints?.find((item) => item.context === 'dingtalk');
-    const appKey = config.appKey ?? entry?.appKey ?? process.env.DINGTALK_APP_KEY;
-    const appSecret = config.appSecret ?? entry?.appSecret ?? process.env.DINGTALK_APP_SECRET;
-    if (!appKey || !appSecret) {
-        throw new TypeError('DingTalk adapter requires appKey + appSecret (plugins.<key> or endpoints with context: dingtalk)');
-    }
-    const id = (typeof config.id === 'string' && config.id)
-        || (typeof entry?.id === 'string' && entry.id)
-        || process.env.DINGTALK_BOT_NAME
-        || 'dingtalk-bot';
-    const webhookPath = normalizeWebhookPath(config.webhookPath ?? entry?.webhookPath ?? '/dingtalk/webhook');
-    const apiBaseUrl = (config.apiBaseUrl ?? entry?.apiBaseUrl ?? 'https://oapi.dingtalk.com').replace(/\/$/, '');
-    const robotCode = config.robotCode ?? entry?.robotCode;
+export function resolveDingTalkConfig(config) {
+    const id = requiredEndpointField(config.id, 'id');
+    const appKey = requiredEndpointField(config.appKey, 'appKey');
+    const appSecret = requiredEndpointField(config.appSecret, 'appSecret');
+    const webhookPath = normalizeWebhookPath(config.webhookPath ?? '/dingtalk/webhook');
+    const apiBaseUrl = (config.apiBaseUrl ?? 'https://oapi.dingtalk.com').replace(/\/$/, '');
+    const robotCode = config.robotCode;
     return {
         context: 'dingtalk',
         id,
@@ -46,6 +39,12 @@ export function resolveDingTalkConfig(config = {}) {
         apiBaseUrl,
     };
 }
+function requiredEndpointField(value, field) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new TypeError(`DingTalk endpoint requires a non-empty ${field}`);
+    }
+    return value.trim();
+}
 export function normalizeWebhookPath(path) {
     const trimmed = path.trim() || '/dingtalk/webhook';
     return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-dingtalk",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "Zhin.js DingTalk (钉钉) adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,27 +33,26 @@
     "directory": "plugins/adapters/dingtalk"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.12",
-    "@zhin.js/core": "1.1.35",
-    "@zhin.js/feature-kit": "1.1.0",
-    "@zhin.js/host-http": "1.1.0",
-    "@zhin.js/im-contract": "1.1.0",
-    "@zhin.js/logger": "1.1.0"
+    "@zhin.js/adapter": "1.1.15",
+    "@zhin.js/agent-feature": "1.1.2",
+    "@zhin.js/core": "1.1.38",
+    "@zhin.js/feature-kit": "1.1.2",
+    "@zhin.js/host-http": "1.1.2",
+    "@zhin.js/im-contract": "1.1.2",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/skill": "1.1.2",
+    "@zhin.js/tool": "1.1.2"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.12",
-    "@zhin.js/agent": "^1.1.23",
-    "@zhin.js/command": "^1.1.0",
-    "@zhin.js/core": "^1.1.35",
-    "@zhin.js/host-http": "^1.1.0",
-    "@zhin.js/permission": "^1.1.0",
-    "zhin.js": "^1.1.0"
+    "@zhin.js/adapter": "^1.1.15",
+    "@zhin.js/command": "^1.1.2",
+    "@zhin.js/core": "^1.1.38",
+    "@zhin.js/host-http": "^1.1.2",
+    "@zhin.js/permission": "^1.1.2",
+    "zhin.js": "^1.1.3"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
     "@zhin.js/command": {
       "optional": true
     },
@@ -69,8 +68,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.23",
-    "zhin.js": "1.1.0"
+    "zhin.js": "1.1.3"
   },
   "files": [
     "adapters",
@@ -79,9 +77,10 @@
     "schema.json",
     "src",
     "lib",
-    "agent",
+    "agents",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PERMITS.md"
   ],
   "publishConfig": {
     "access": "public",
@@ -104,6 +103,18 @@
       {
         "package": "@zhin.js/command",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/agent-feature",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/schema.json

@@ -27,10 +27,11 @@
     },
     "endpoints": {
       "type": "array",
+      "minItems": 1,
       "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
       "items": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "properties": {
           "master": {
             "type": [
@@ -66,6 +67,12 @@
             "type": "string",
             "description": "Dingtalk robot code"
           },
+          "apiBaseUrl": {
+            "type": "string"
+          },
+          "commandPrefix": {
+            "type": "string"
+          },
           "id": {
             "type": "string",
             "description": "Dingtalk bot name"
@@ -74,9 +81,7 @@
         "required": [
           "id",
           "appKey",
-          "appSecret",
-          "webhookPath",
-          "robotCode"
+          "appSecret"
         ]
       }
     },

package/src/dingtalk-runtime-state.ts

@@ -1,6 +1,6 @@
 /**
  * DingTalk 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `dingtalk.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `dingtalk endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 

package/src/index.ts

@@ -11,7 +11,7 @@ export {
   resolveSender,
   verifySignature,
   type AccessToken,
-  type DingTalkAdapterConfig,
+  type DingTalkEndpointConfig,
   type DingTalkApiResponse,
   type DingTalkEvent,
   type DingTalkMessage,

package/src/protocol.ts

@@ -6,24 +6,19 @@
 import { createHmac, timingSafeEqual } from 'node:crypto';
 import type { IncomingMessage } from 'node:http';
 
-import { isMediaRef } from '@zhin.js/core';
-import type { ConversationRef } from '@zhin.js/im-contract';
+import { isMediaRef, type ConversationRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 
 const logger = getLogger('dingtalk');
 
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface DingTalkAdapterConfig {
-  readonly id?: string;
-  readonly appKey?: string;
-  readonly appSecret?: string;
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface DingTalkEndpointConfig {
+  readonly id: string;
+  readonly appKey: string;
+  readonly appSecret: string;
   readonly webhookPath?: string;
   readonly robotCode?: string;
   readonly apiBaseUrl?: string;
-  /** Transitional: legacy root `endpoints[]` with `context: dingtalk`. */
-  readonly endpoints?: ReadonlyArray<Partial<ResolvedDingTalkConfig> & {
-    readonly context?: string;
-  }>;
 }
 
 export interface ResolvedDingTalkConfig {
@@ -115,26 +110,13 @@ export interface DingTalkSendBody {
   readonly robotCode?: string;
 }
 
-export function resolveDingTalkConfig(config: DingTalkAdapterConfig = {}): ResolvedDingTalkConfig {
-  const entry = config.endpoints?.find((item) => item.context === 'dingtalk');
-  const appKey = config.appKey ?? entry?.appKey ?? process.env.DINGTALK_APP_KEY;
-  const appSecret = config.appSecret ?? entry?.appSecret ?? process.env.DINGTALK_APP_SECRET;
-  if (!appKey || !appSecret) {
-    throw new TypeError(
-      'DingTalk adapter requires appKey + appSecret (plugins.<key> or endpoints with context: dingtalk)',
-    );
-  }
-  const id = (typeof config.id === 'string' && config.id)
-    || (typeof entry?.id === 'string' && entry.id)
-    || process.env.DINGTALK_BOT_NAME
-    || 'dingtalk-bot';
-  const webhookPath = normalizeWebhookPath(
-    config.webhookPath ?? entry?.webhookPath ?? '/dingtalk/webhook',
-  );
-  const apiBaseUrl = (
-    config.apiBaseUrl ?? entry?.apiBaseUrl ?? 'https://oapi.dingtalk.com'
-  ).replace(/\/$/, '');
-  const robotCode = config.robotCode ?? entry?.robotCode;
+export function resolveDingTalkConfig(config: DingTalkEndpointConfig): ResolvedDingTalkConfig {
+  const id = requiredEndpointField(config.id, 'id');
+  const appKey = requiredEndpointField(config.appKey, 'appKey');
+  const appSecret = requiredEndpointField(config.appSecret, 'appSecret');
+  const webhookPath = normalizeWebhookPath(config.webhookPath ?? '/dingtalk/webhook');
+  const apiBaseUrl = (config.apiBaseUrl ?? 'https://oapi.dingtalk.com').replace(/\/$/, '');
+  const robotCode = config.robotCode;
   return {
     context: 'dingtalk',
     id,
@@ -146,6 +128,16 @@ export function resolveDingTalkConfig(config: DingTalkAdapterConfig = {}): Resol
   };
 }
 
+function requiredEndpointField(
+  value: unknown,
+  field: 'id' | 'appKey' | 'appSecret',
+): string {
+  if (typeof value !== 'string' || !value.trim()) {
+    throw new TypeError(`DingTalk endpoint requires a non-empty ${field}`);
+  }
+  return value.trim();
+}
+
 export function normalizeWebhookPath(path: string): string {
   const trimmed = path.trim() || '/dingtalk/webhook';
   return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/agent/skills/dingtalk.md

@@ -1,91 +0,0 @@
----
-name: dingtalk
-platforms:
-  - dingtalk
-description: >-
-  钉钉平台管理能力。当用户在钉钉中请求群管理（踢人、改群名、查群信息）、
-  组织架构查询（部门/用户查询）、发送工作通知、创建或管理群聊时使用。
-  即使用户没有提到钉钉，只要上下文是钉钉/DingTalk 场景且涉及群管理、
-  组织架构或工作通知，就应触发。仅有昵称时先查部门用户列表获取 user_id。
-keywords:
-  - dingtalk
-  - 钉钉
-  - adapter:dingtalk
-  - 群管理
-  - 部门
-  - 工作通知
-  - 组织架构
-  - 企业
-  - list_members
-tags:
-  - group
-  - management
-  - im
-  - enterprise
-tools:
-  - dingtalk_get_user
-  - dingtalk_get_dept_users
-  - dingtalk_list_departments
-  - dingtalk_send_work_notice
-  - dingtalk_create_chat
-  - dingtalk_add_chat_members
-  - dingtalk_dept_info
-  - dingtalk_update_chat
-  - dingtalk_kick_member
-  - dingtalk_set_group_name
-  - dingtalk_get_group_info
----
-
-# 钉钉群聊与组织管理技能
-
-钉钉是企业 IM 平台，特有组织架构（部门树）和工作通知能力，区别于个人社交类 IM。
-
-## 核心原则
-
-### 组织架构是核心
-
-钉钉的用户隶属于部门树，很多操作需要从组织架构出发：
-```
-dingtalk_list_departments → 获取部门列表（根部门 ID=1）
-dingtalk_get_dept_users(dept_id) → 获取部门下的用户列表
-dingtalk_get_user(user_id) → 获取用户详情
-```
-
-### 工作通知 ≠ 群消息
-
-`dingtalk_send_work_notice` 是直接发给个人的企业通知，出现在钉钉的「工作通知」入口，不需要群聊。用户说「通知一下张三」，如果是正式的企业通知，用 `send_work_notice`；如果只是聊天消息，用普通消息发送。
-
-## 工具分类
-
-### 群聊管理
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `dingtalk_kick_member` | 踢出成员 | — |
-| `dingtalk_set_group_name` | 改群名 | — |
-| `dingtalk_get_group_info` | 群信息 | — |
-| `dingtalk_create_chat` | 创建群聊 | 需群主 userId + 至少一个成员 |
-| `dingtalk_add_chat_members` | 添加成员 | — |
-| `dingtalk_update_chat` | 更新群设置 | 改名、换群主、增减成员 |
-
-### 组织架构
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `dingtalk_list_departments` | 部门列表 | 默认从根部门 ID=1 开始 |
-| `dingtalk_dept_info` | 部门详情 | — |
-| `dingtalk_get_dept_users` | 部门用户列表 | — |
-| `dingtalk_get_user` | 用户详情 | — |
-
-### 通知
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `dingtalk_send_work_notice` | 工作通知 | 发给指定用户列表，不需要群 |
-
-## 易错点
-
-1. **部门查询从根部门 ID=1 开始**。不知道部门 ID 时先 `list_departments` 获取整棵部门树。
-2. **群聊创建需要群主 userId 和至少一个成员**，不能创建空群。
-3. **工作通知是独立于群聊的**，它发到个人的钉钉「工作通知」入口，不要与群消息混淆。
-4. **操作成员需要钉钉 userId**，仅有昵称时先通过 `get_dept_users` 或 `get_group_info` 查找。

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

@@ -1,3 +0,0 @@
-import { dingtalkEndpointCommands } from '../../../src/dingtalk-endpoint-commands.js';
-
-export default dingtalkEndpointCommands.add;

package/commands/endpoint/list.ts

@@ -1,3 +0,0 @@
-import { dingtalkEndpointCommands } from '../../src/dingtalk-endpoint-commands.js';
-
-export default dingtalkEndpointCommands.list;

package/commands/endpoint/remove/[id].ts

@@ -1,3 +0,0 @@
-import { dingtalkEndpointCommands } from '../../../src/dingtalk-endpoint-commands.js';
-
-export default dingtalkEndpointCommands.remove;

package/lib/dingtalk-endpoint-commands.d.ts

@@ -1 +0,0 @@
-export declare const dingtalkEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage, string | undefined>>>;