@zhin.js/adapter-lark 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,97 @@
 # @zhin.js/adapter-lark
 
+## 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.
+- aaa9361: Require the canonical expanded Lark 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 `LarkEndpointConfig`, and each schema entry uses `id` as its identity.
+- 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

@@ -19,7 +19,7 @@ pnpm add @zhin.js/adapter-lark
 
 ## Plugin Runtime
 
-- `@zhin.js/adapter` — 约定式 `adapters/lark.ts`（`defineAdapter`）
+- `@zhin.js/adapter` — 约定式 `adapters/lark/index.ts`（`defineAdapter`）
 - `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `@zhin.js/host-http` — `httpHostToken` 注册 Webhook 路由（**非** legacy host-router/Koa）
 - `zhin.js` — `plugin.ts`（`definePlugin`）
@@ -28,7 +28,7 @@ pnpm add @zhin.js/adapter-lark
 入站：`gateway.receive({ conversation, message: { conversation, id }, content: text, sender, metadata })`  
 出站：`send({ conversation, payload })` → `im/v1/messages`
 
-入站 `metadata.mentioned`：**未接线**。消息事件的 `mentions[]` 元素含 `id.open_id`，但本适配器拿不到 bot 自身的 open_id——配置（`appId` / `appSecret` / `name` 等）不含 bot open_id，代码也未调用 `bot/v3/info` 获取应用信息，故无可靠判据比对 mentions。
+入站 `metadata.mentioned`：**未接线**。消息事件的 `mentions[]` 元素含 `id.open_id`，但本适配器拿不到 bot 自身的 open_id——配置（`appId` / `appSecret` / `id` 等）不含 bot open_id，代码也未调用 `bot/v3/info` 获取应用信息，故无可靠判据比对 mentions。
 
 ## 前置条件
 
@@ -37,7 +37,7 @@ pnpm add @zhin.js/adapter-lark
 3. 启用机器人能力并配置事件订阅 URL：`https://your-domain/lark/webhook`
 4. Runtime Host（`http`）须已 listen，Webhook 才可达
 
-必填字段（`endpoints[i]`）：`name`、`appId`、`appSecret`。
+必填字段（`endpoints[i]`）：`id`、`appId`、`appSecret`。
 
 ## 最小配置
 
@@ -49,7 +49,7 @@ plugins:
     isFeishu: true                      # 可选，默认 true
     # apiBaseUrl: https://open.feishu.cn/open-apis
     endpoints:
-      - name: my-lark-bot
+      - id: my-lark-bot
         appId: ${LARK_APP_ID}
         appSecret: ${LARK_APP_SECRET}
         # encryptKey: ${LARK_ENCRYPT_KEY}          # 可选
@@ -62,9 +62,8 @@ plugins:
 
 | 变量 | 说明 |
 |------|------|
-| `LARK_APP_ID` | 应用 App ID |
-| `LARK_APP_SECRET` | 应用 App Secret |
-| `LARK_BOT_NAME` | 默认 endpoint 名称（可选） |
+| `LARK_APP_ID` | 示例中由 YAML `${LARK_APP_ID}` 引用的 App ID；变量名可自行定义 |
+| `LARK_APP_SECRET` | 示例中由 YAML `${LARK_APP_SECRET}` 引用的 App Secret；变量名可自行定义 |
 
 ## 消息类型映射
 
@@ -79,7 +78,7 @@ plugins:
 
 ## Agent 工具
 
-`agent/` 目录保留（get_user、群聊、管理员、上传文件等）。工具声明 `adapter: 'lark'` 后，通过惰性的 `context.$client` 自动取得当前操作的 `LarkClient`；无需把 Endpoint id 暴露给模型。
+`tools/` 目录提供 get_user、群聊、管理员、上传文件等 Tool。工具声明 `adapter: 'lark'` 后，通过惰性的 `context.$client` 自动取得当前操作的 `LarkClient`；无需把 Endpoint id 暴露给模型。
 
 ## 平台权限（platform permit）
 

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

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * Convention entry: discover `adapters/lark.ts` → defineAdapter.
+ * Convention entry: discover `adapters/lark/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { LarkEndpoint } from "../lib/endpoint.js";
-import { resolveLarkConfig, } from "../lib/protocol.js";
-import { larkRuntimeStateToken } from "../lib/lark-runtime-state.js";
-export { LarkEndpoint } from "../lib/endpoint.js";
+import { LarkEndpoint } from "../../lib/endpoint.js";
+import { resolveLarkConfig, } from "../../lib/protocol.js";
+import { larkRuntimeStateToken } from "../../lib/lark-runtime-state.js";
+export { LarkEndpoint } from "../../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
     operations: ['recall'],
@@ -22,7 +22,7 @@ export default defineAdapter({
     },
     create(context) {
         const config = resolveLarkConfig(context.config);
-        // 注册到插件运行时状态（lark.endpoint list 的"运行中"数据源）
+        // 注册到插件运行时状态（lark endpoint list 的"运行中"数据源）
         context.use(larkRuntimeStateToken).endpoints.set(config.id, {
             id: config.id,
             mode: 'webhook',

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

@@ -1,19 +1,19 @@
 /**
- * Convention entry: discover `adapters/lark.ts` → defineAdapter.
+ * Convention entry: discover `adapters/lark/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { LarkEndpoint } from '../src/endpoint.js';
+import { LarkEndpoint } from '../../src/endpoint.js';
 import {
   resolveLarkConfig,
-  type LarkAdapterConfig,
-} from '../src/protocol.js';
-import { larkRuntimeStateToken } from '../src/lark-runtime-state.js';
+  type LarkEndpointConfig,
+} from '../../src/protocol.js';
+import { larkRuntimeStateToken } from '../../src/lark-runtime-state.js';
 
-export { LarkEndpoint } from '../src/endpoint.js';
-export type { LarkEndpointOptions, LarkFetch } from '../src/endpoint.js';
+export { LarkEndpoint } from '../../src/endpoint.js';
+export type { LarkEndpointOptions, LarkFetch } from '../../src/endpoint.js';
 
-export default defineAdapter<LarkAdapterConfig>({
+export default defineAdapter<LarkEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
   operations: ['recall'],
   // image 段 canonical MediaRef 经 /im/v1/images 物化为 image_key
@@ -27,7 +27,7 @@ export default defineAdapter<LarkAdapterConfig>({
   },
   create(context) {
     const config = resolveLarkConfig(context.config);
-    // 注册到插件运行时状态（lark.endpoint list 的"运行中"数据源）
+    // 注册到插件运行时状态（lark endpoint list 的"运行中"数据源）
     context.use(larkRuntimeStateToken).endpoints.set(config.id, {
       id: config.id,
       mode: 'webhook',

package/agents/lark/agent.json

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

package/agents/lark/boundaries.md

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

package/agents/lark/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/lark/skills/lark/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: lark
+platforms: [lark]
+description: 飞书用户查询、群聊生命周期、管理员和文件上传能力。
+keywords: [lark, 飞书, user, chat, manager, file]
+tags: [adapter, collaboration]
+tools:
+  - get_user
+  - create_chat
+  - update_chat
+  - add_members
+  - set_managers
+  - remove_managers
+  - dissolve_chat
+  - upload_file
+---
+
+# 飞书
+
+涉及成员的操作先用 `get_user` 取得稳定用户 ID。创建群聊后可添加成员、更新群设置和维护管理员；解散群聊属于不可逆操作，应依照 Tool 审批策略执行。文件发送前先用 `upload_file` 获得文件标识。
+
+当前 Agent Tool 不提供当前群成员列表、踢人或独立群详情查询。

package/agents/lark/skills/lark/tools/add_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('用户 open_id 列表，逗号分隔'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    permissions: [platformPermission('lark', 'chat_admin')],
+    async execute({ chat_id, user_ids }, context) {
+        const endpoint = context.$client;
+        const success = await endpoint.addChatMembers(chat_id, user_ids.split(','));
+        return { success, message: success ? '成员添加成功' : '添加失败' };
+    },
+});

package/{agent/tools/add_members.ts → agents/lark/skills/lark/tools/add_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,11 +10,10 @@ export default defineAgentTool<{ chat_id: string; user_ids: string }>({
   }),
   adapter: 'lark',
   tags: ['lark'],
-  permissions: [platformPermit('chat_admin')],
+  permissions: [platformPermission('lark', 'chat_admin')],
   async execute({ chat_id, user_ids   }: { chat_id: string; user_ids: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.addChatMembers(chat_id, user_ids.split(','));
     return { success, message: success ? '成员添加成功' : '添加失败' };
   },
 });
-

package/agents/lark/skills/lark/tools/create_chat/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({
+        name: z.string().describe('群名'),
+        members: z.string().describe('成员 open_id 列表，逗号分隔'),
+        owner: z.string().optional().describe('群主 open_id（可选）'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    async execute({ name, members, owner }, context) {
+        const endpoint = context.$client;
+        const chatId = await endpoint.createChat(name, members.split(','), owner);
+        return { success: !!chatId, chat_id: chatId, message: chatId ? `群聊创建成功: ${chatId}` : '创建失败' };
+    },
+});

package/{agent/tools/create_chat.ts → agents/lark/skills/lark/tools/create_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<{ name: string; members: string; owner?: string }>({
   description: '创建飞书群聊',

package/agents/lark/skills/lark/tools/dissolve_chat/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({
+        chat_id: z.string().describe('群聊 ID'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    async execute({ chat_id }, context) {
+        const endpoint = context.$client;
+        const success = await endpoint.dissolveChat(chat_id);
+        return { success, message: success ? '群聊已解散' : '解散失败' };
+    },
+});

package/{agent/tools/dissolve_chat.ts → agents/lark/skills/lark/tools/dissolve_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 }>({
   description: '解散飞书群聊（需要群主权限）',

package/agents/lark/skills/lark/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 (open_id)'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    async execute({ user_id }, context) {
+        const endpoint = context.$client;
+        return await endpoint.getUserInfo(user_id);
+    },
+});

package/{agent/tools/get_user.ts → agents/lark/skills/lark/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 }>({

package/agents/lark/skills/lark/tools/remove_managers/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('用户 open_id 列表，逗号分隔'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    permissions: [platformPermission('lark', 'manage_managers')],
+    async execute({ chat_id, user_ids }, context) {
+        const endpoint = context.$client;
+        const success = await endpoint.removeChatManagers(chat_id, user_ids.split(','));
+        return { success, message: success ? '管理员移除成功' : '移除失败' };
+    },
+});

package/{agent/tools/remove_managers.ts → agents/lark/skills/lark/tools/remove_managers/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,11 +10,10 @@ export default defineAgentTool<{ chat_id: string; user_ids: string }>({
   }),
   adapter: 'lark',
   tags: ['lark'],
-  permissions: [platformPermit('manage_managers')],
+  permissions: [platformPermission('lark', 'manage_managers')],
   async execute({ chat_id, user_ids   }: { chat_id: string; user_ids: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.removeChatManagers(chat_id, user_ids.split(','));
     return { success, message: success ? '管理员移除成功' : '移除失败' };
   },
 });
-

package/agents/lark/skills/lark/tools/set_managers/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('用户 open_id 列表，逗号分隔'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    permissions: [platformPermission('lark', 'manage_managers')],
+    async execute({ chat_id, user_ids }, context) {
+        const endpoint = context.$client;
+        const success = await endpoint.setChatManagers(chat_id, user_ids.split(','));
+        return { success, message: success ? '管理员设置成功' : '设置失败' };
+    },
+});

package/{agent/tools/set_managers.ts → agents/lark/skills/lark/tools/set_managers/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,11 +10,10 @@ export default defineAgentTool<{ chat_id: string; user_ids: string }>({
   }),
   adapter: 'lark',
   tags: ['lark'],
-  permissions: [platformPermit('manage_managers')],
+  permissions: [platformPermission('lark', 'manage_managers')],
   async execute({ chat_id, user_ids   }: { chat_id: string; user_ids: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.setChatManagers(chat_id, user_ids.split(','));
     return { success, message: success ? '管理员设置成功' : '设置失败' };
   },
 });
-

package/agents/lark/skills/lark/tools/update_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({
+        chat_id: z.string().describe('群聊 ID'),
+        name: z.string().optional().describe('新群名（可选）'),
+        description: z.string().optional().describe('新描述（可选）'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    permissions: [platformPermission('lark', 'chat_admin')],
+    async execute({ chat_id, name, description }, context) {
+        const endpoint = context.$client;
+        const success = await endpoint.updateChatInfo(chat_id, { name, description });
+        return { success, message: success ? '群信息更新成功' : '更新失败' };
+    },
+});

package/{agent/tools/update_chat.ts → agents/lark/skills/lark/tools/update_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<{ chat_id: string; name?: string; description?: string }>({
   description: '更新飞书群聊信息（群名、描述）',
@@ -11,11 +11,10 @@ export default defineAgentTool<{ chat_id: string; name?: string; description?: s
   }),
   adapter: 'lark',
   tags: ['lark'],
-  permissions: [platformPermit('chat_admin')],
+  permissions: [platformPermission('lark', 'chat_admin')],
   async execute({ chat_id, name, description   }: { chat_id: string; name?: string; description?: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.updateChatInfo(chat_id, { name, description });
     return { success, message: success ? '群信息更新成功' : '更新失败' };
   },
 });
-

package/agents/lark/skills/lark/tools/upload_file/index.js

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '上传文件到飞书（image/file/video/audio）',
+    inputSchema: z.object({
+        file_path: z.string().describe('本地文件路径'),
+        file_type: z.enum(['image', 'file', 'video', 'audio']).default('file').describe('飞书文件类型'),
+    }),
+    adapter: 'lark',
+    tags: ['lark'],
+    async execute({ file_path, file_type }, context) {
+        const endpoint = context.$client;
+        const result = await endpoint.uploadFile(file_path, file_type);
+        return { success: true, file_key: result, message: `文件已上传，file_key: ${result}` };
+    },
+});

package/{agent/tools/upload_file.ts → agents/lark/skills/lark/tools/upload_file/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<{

package/agents/lark/system.md

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { formatInboundContent, formatOutboundBody, generateMessageId, headerValue, larkInboundConversation, normalizeWebhookPath, readTextBody, resolveChatType, resolveLarkConfig, resolveSender, verifySignature, type AccessToken, type LarkAdapterConfig, type LarkApiResponse, type LarkEventBody, type LarkMessage, type LarkSendBody, type LarkWireSegment, type ResolvedLarkConfig, } from './protocol.js';
+export { formatInboundContent, formatOutboundBody, generateMessageId, headerValue, larkInboundConversation, normalizeWebhookPath, readTextBody, resolveChatType, resolveLarkConfig, resolveSender, verifySignature, type AccessToken, type LarkEndpointConfig, type LarkApiResponse, type LarkEventBody, type LarkMessage, type LarkSendBody, type LarkWireSegment, type ResolvedLarkConfig, } from './protocol.js';
 export { larkClient, type LarkClientEventMap } from './client.js';
 export { checkLarkPlatformPermit, larkGroupPermitResolver, normalizeLarkSenderForPermit, platformPermit, } from './platform-permit.js';
 export { LarkClient, LarkEndpoint, type LarkClientApi, type LarkEndpointOptions, type LarkFetch, } from './endpoint.js';

package/lib/lark-runtime-state.js

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

package/lib/media-upload.d.ts

@@ -1,4 +1,4 @@
-import { type MediaRef } from '@zhin.js/core';
+import { type MediaRef } from '@zhin.js/im-contract';
 export interface MediaBinary {
     readonly data: Buffer;
     readonly mimeType: string;

package/lib/media-upload.js

@@ -5,7 +5,7 @@
  */
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
-import { isMediaRef } from '@zhin.js/core';
+import { isMediaRef } from '@zhin.js/im-contract';
 const MIME_EXT = {
     'image/jpeg': 'jpg',
     'image/png': 'png',

package/lib/protocol.d.ts

@@ -3,21 +3,17 @@
  * 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 LarkAdapterConfig {
-    readonly id?: string;
-    readonly appId?: string;
-    readonly appSecret?: string;
+import { type ConversationRef } from '@zhin.js/im-contract';
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface LarkEndpointConfig {
+    readonly id: string;
+    readonly appId: string;
+    readonly appSecret: string;
     readonly encryptKey?: string;
     readonly verificationToken?: string;
     readonly webhookPath?: string;
     readonly apiBaseUrl?: string;
     readonly isFeishu?: boolean;
-    /** Transitional: legacy root `endpoints[]` with `context: lark`. */
-    readonly endpoints?: ReadonlyArray<Partial<ResolvedLarkConfig> & {
-        readonly context?: string;
-    }>;
 }
 export interface ResolvedLarkConfig {
     readonly context: 'lark';
@@ -94,7 +90,7 @@ export interface LarkSendBody {
     readonly msg_type: string;
     readonly content: string;
 }
-export declare function resolveLarkConfig(config?: LarkAdapterConfig): ResolvedLarkConfig;
+export declare function resolveLarkConfig(config: LarkEndpointConfig): ResolvedLarkConfig;
 export declare function normalizeWebhookPath(path: string): string;
 export declare function resolveChatType(chatId?: string, chatType?: string): 'group' | 'private';
 /**

package/lib/protocol.js

@@ -3,28 +3,21 @@
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
 import { createHash, 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('lark');
-export function resolveLarkConfig(config = {}) {
-    const entry = config.endpoints?.find((item) => item.context === 'lark');
-    const appId = config.appId ?? entry?.appId ?? process.env.LARK_APP_ID;
-    const appSecret = config.appSecret ?? entry?.appSecret ?? process.env.LARK_APP_SECRET;
-    if (!appId || !appSecret) {
-        throw new TypeError('Lark adapter requires appId + appSecret (plugins.<key> or endpoints with context: lark)');
-    }
-    const isFeishu = config.isFeishu ?? entry?.isFeishu ?? true;
-    const id = (typeof config.id === 'string' && config.id)
-        || (typeof entry?.id === 'string' && entry.id)
-        || process.env.LARK_BOT_NAME
-        || 'lark-bot';
-    const webhookPath = normalizeWebhookPath(config.webhookPath ?? entry?.webhookPath ?? '/lark/webhook');
+export function resolveLarkConfig(config) {
+    const id = requiredEndpointField(config.id, 'id');
+    const appId = requiredEndpointField(config.appId, 'appId');
+    const appSecret = requiredEndpointField(config.appSecret, 'appSecret');
+    const isFeishu = config.isFeishu ?? true;
+    const webhookPath = normalizeWebhookPath(config.webhookPath ?? '/lark/webhook');
     const defaultBase = isFeishu
         ? 'https://open.feishu.cn/open-apis'
         : 'https://open.larksuite.com/open-apis';
-    const apiBaseUrl = (config.apiBaseUrl ?? entry?.apiBaseUrl ?? defaultBase).replace(/\/$/, '');
-    const encryptKey = config.encryptKey ?? entry?.encryptKey;
-    const verificationToken = config.verificationToken ?? entry?.verificationToken;
+    const apiBaseUrl = (config.apiBaseUrl ?? defaultBase).replace(/\/$/, '');
+    const encryptKey = config.encryptKey;
+    const verificationToken = config.verificationToken;
     return {
         context: 'lark',
         id,
@@ -37,6 +30,12 @@ export function resolveLarkConfig(config = {}) {
         isFeishu,
     };
 }
+function requiredEndpointField(value, field) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new TypeError(`Lark endpoint requires a non-empty ${field}`);
+    }
+    return value.trim();
+}
 export function normalizeWebhookPath(path) {
     const trimmed = path.trim() || '/lark/webhook';
     return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-lark",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Zhin.js Lark/Feishu (飞书) adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,27 +34,26 @@
     "directory": "plugins/adapters/lark"
   },
   "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.14",
+    "@zhin.js/agent-feature": "1.1.1",
+    "@zhin.js/core": "1.1.37",
+    "@zhin.js/feature-kit": "1.1.1",
+    "@zhin.js/host-http": "1.1.1",
+    "@zhin.js/im-contract": "1.1.1",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/skill": "1.1.1",
+    "@zhin.js/tool": "1.1.1"
   },
   "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.14",
+    "@zhin.js/command": "^1.1.1",
+    "@zhin.js/core": "^1.1.37",
+    "@zhin.js/host-http": "^1.1.1",
+    "@zhin.js/permission": "^1.1.1",
+    "zhin.js": "^1.1.2"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
     "@zhin.js/command": {
       "optional": true
     },
@@ -70,8 +69,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.2"
   },
   "files": [
     "adapters",
@@ -80,9 +78,11 @@
     "schema.json",
     "src",
     "lib",
-    "agent",
+    "tools",
+    "agents",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PERMITS.md"
   ],
   "publishConfig": {
     "access": "public",
@@ -105,6 +105,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

@@ -34,10 +34,11 @@
     },
     "endpoints": {
       "type": "array",
+      "minItems": 1,
       "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
       "items": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "properties": {
           "master": {
             "type": [
@@ -73,6 +74,18 @@
             "type": "string",
             "description": "Lark verification token"
           },
+          "webhookPath": {
+            "type": "string"
+          },
+          "apiBaseUrl": {
+            "type": "string"
+          },
+          "isFeishu": {
+            "type": "boolean"
+          },
+          "commandPrefix": {
+            "type": "string"
+          },
           "id": {
             "type": "string",
             "description": "Lark bot name"

package/src/index.ts

@@ -11,7 +11,7 @@ export {
   resolveSender,
   verifySignature,
   type AccessToken,
-  type LarkAdapterConfig,
+  type LarkEndpointConfig,
   type LarkApiResponse,
   type LarkEventBody,
   type LarkMessage,

package/src/lark-runtime-state.ts

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

package/src/media-upload.ts

@@ -5,7 +5,7 @@
  */
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
-import { isMediaRef, type MediaRef } from '@zhin.js/core';
+import { isMediaRef, type MediaRef } from '@zhin.js/im-contract';
 
 export interface MediaBinary {
   readonly data: Buffer;

package/src/protocol.ts

@@ -5,26 +5,21 @@
 
 import { createHash, 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('lark');
 
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface LarkAdapterConfig {
-  readonly id?: string;
-  readonly appId?: string;
-  readonly appSecret?: string;
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface LarkEndpointConfig {
+  readonly id: string;
+  readonly appId: string;
+  readonly appSecret: string;
   readonly encryptKey?: string;
   readonly verificationToken?: string;
   readonly webhookPath?: string;
   readonly apiBaseUrl?: string;
   readonly isFeishu?: boolean;
-  /** Transitional: legacy root `endpoints[]` with `context: lark`. */
-  readonly endpoints?: ReadonlyArray<Partial<ResolvedLarkConfig> & {
-    readonly context?: string;
-  }>;
 }
 
 export interface ResolvedLarkConfig {
@@ -109,31 +104,20 @@ export interface LarkSendBody {
   readonly content: string;
 }
 
-export function resolveLarkConfig(config: LarkAdapterConfig = {}): ResolvedLarkConfig {
-  const entry = config.endpoints?.find((item) => item.context === 'lark');
-  const appId = config.appId ?? entry?.appId ?? process.env.LARK_APP_ID;
-  const appSecret = config.appSecret ?? entry?.appSecret ?? process.env.LARK_APP_SECRET;
-  if (!appId || !appSecret) {
-    throw new TypeError(
-      'Lark adapter requires appId + appSecret (plugins.<key> or endpoints with context: lark)',
-    );
-  }
-  const isFeishu = config.isFeishu ?? entry?.isFeishu ?? true;
-  const id = (typeof config.id === 'string' && config.id)
-    || (typeof entry?.id === 'string' && entry.id)
-    || process.env.LARK_BOT_NAME
-    || 'lark-bot';
-  const webhookPath = normalizeWebhookPath(
-    config.webhookPath ?? entry?.webhookPath ?? '/lark/webhook',
-  );
+export function resolveLarkConfig(config: LarkEndpointConfig): ResolvedLarkConfig {
+  const id = requiredEndpointField(config.id, 'id');
+  const appId = requiredEndpointField(config.appId, 'appId');
+  const appSecret = requiredEndpointField(config.appSecret, 'appSecret');
+  const isFeishu = config.isFeishu ?? true;
+  const webhookPath = normalizeWebhookPath(config.webhookPath ?? '/lark/webhook');
   const defaultBase = isFeishu
     ? 'https://open.feishu.cn/open-apis'
     : 'https://open.larksuite.com/open-apis';
   const apiBaseUrl = (
-    config.apiBaseUrl ?? entry?.apiBaseUrl ?? defaultBase
+    config.apiBaseUrl ?? defaultBase
   ).replace(/\/$/, '');
-  const encryptKey = config.encryptKey ?? entry?.encryptKey;
-  const verificationToken = config.verificationToken ?? entry?.verificationToken;
+  const encryptKey = config.encryptKey;
+  const verificationToken = config.verificationToken;
   return {
     context: 'lark',
     id,
@@ -147,6 +131,16 @@ export function resolveLarkConfig(config: LarkAdapterConfig = {}): ResolvedLarkC
   };
 }
 
+function requiredEndpointField(
+  value: unknown,
+  field: 'id' | 'appId' | 'appSecret',
+): string {
+  if (typeof value !== 'string' || !value.trim()) {
+    throw new TypeError(`Lark endpoint requires a non-empty ${field}`);
+  }
+  return value.trim();
+}
+
 export function normalizeWebhookPath(path: string): string {
   const trimmed = path.trim() || '/lark/webhook';
   return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/agent/skills/lark.md

@@ -1,89 +0,0 @@
----
-name: lark
-platforms:
-  - lark
-description: >-
-  飞书/Lark 群聊管理能力。当用户在飞书中请求群管理（踢人、查成员、改群名）、
-  群聊创建/更新/解散、管理员设置/移除、用户查询或文件上传时使用。
-  即使用户没有提到飞书，只要上下文是 Lark 场景且涉及群聊或用户操作，就应触发。
-  仅有昵称时必须先 list_members 或 get_user 获取 user_id。
-keywords:
-  - lark
-  - 飞书
-  - adapter:lark
-  - 群管理
-  - 管理员
-  - 群聊
-  - 文件上传
-  - 解散
-  - list_members
-tags:
-  - group
-  - management
-  - im
-  - enterprise
-tools:
-  - lark_get_user
-  - lark_create_chat
-  - lark_update_chat
-  - lark_add_members
-  - lark_set_managers
-  - lark_remove_managers
-  - lark_dissolve_chat
-  - lark_upload_file
-  - lark_kick_member
-  - lark_list_members
-  - lark_get_group_info
-  - lark_set_group_name
----
-
-# 飞书/Lark 群聊管理技能
-
-飞书的群聊模型偏向企业场景，有群聊创建/解散的完整生命周期管理，以及文件上传能力。
-
-## 核心原则
-
-### 企业级 ID 体系
-
-飞书的用户 ID 有三种形式（open_id / union_id / user_id），不同 API 可能需要不同 ID 类型。通过 `lark_get_user` 可以查询用户详情并获取各种 ID。
-
-### 群聊生命周期
-
-飞书支持完整的群聊生命周期管理：创建 → 添加成员 → 设管理员 → 正常使用 → 更新设置 → 解散。
-
-**Example — 创建项目群：**
-```
-步骤1: lark_create_chat(name="XX项目组", members=[user1, user2])
-步骤2: lark_set_managers(chat_id, managers=[user1])  # 设管理员
-```
-
-## 工具分类
-
-### 群聊管理
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `lark_create_chat` | 创建群聊 | 需指定群名 + 初始成员 |
-| `lark_update_chat` | 更新群设置 | 群名、群描述等 |
-| `lark_dissolve_chat` | 解散群聊 | **不可逆**，需群主权限 |
-| `lark_add_members` | 添加成员 | — |
-| `lark_kick_member` | 移除成员 | — |
-| `lark_set_managers` | 设管理员 | — |
-| `lark_remove_managers` | 移除管理员 | — |
-| `lark_set_group_name` | 改群名 | — |
-| `lark_list_members` | 成员列表 | — |
-| `lark_get_group_info` | 群信息 | — |
-
-### 用户与文件
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `lark_get_user` | 查询用户信息 | 可获取多种 ID 形式 |
-| `lark_upload_file` | 上传文件 | 返回 file_key，可在消息中引用 |
-
-## 易错点
-
-1. **解散群聊不可逆**，需群主权限。确认用户意图后再执行。
-2. **群聊创建至少需要群名和一个初始成员**。
-3. **文件上传返回 file_key**，这个 key 用于在消息中引用文件，不是文件内容本身。
-4. **飞书有 open_id / union_id / user_id 三种 ID**，操作时注意使用正确的 ID 类型。

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

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

package/commands/endpoint/list.ts

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

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

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

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

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