@wu529778790/open-im 1.0.2-beta.2 → 1.0.2

package/README.md

@@ -87,8 +87,16 @@ open-im run
 
 1. 在 [飞书开放平台](https://open.feishu.cn/) 创建企业自建应用
 2. 开启「机器人」能力
-3. 配置事件订阅：启用 `im.message.receive_v1`，使用 **长连接** 模式（WebSocket）
-4. 将机器人添加到目标群聊或发起私聊
+3. 配置事件订阅：启用 `im.message.receive_v1`（接收消息），使用 **长连接** 模式（WebSocket）
+4. **卡片按钮（/mode、权限允许/拒绝）需额外配置回调**：
+   - 打开 [开放平台](https://open.feishu.cn/app) → 进入你的应用 → **「事件与回调」**
+   - 注意：页面有 **「事件」** 和 **「回调」** 两个 Tab，卡片在 **「回调」** 里，不在「事件」里
+   - 切换到 **「回调」** Tab → 选择 **「使用长连接接收回调」**
+   - 点击 **「添加回调」**（或类似按钮）→ 在列表中找到 **「卡片回传交互」**（`card.action.trigger`）
+   - 若列表里搜不到，可尝试：切换分类、搜「action」或「trigger」、或直接浏览「消息与群组」相关分类
+5. 将机器人添加到目标群聊或发起私聊
+
+**若点击 /mode 卡片按钮报错**：说明未配置卡片回调。配置较复杂时，可直接用 `/mode ask`、`/mode yolo` 等命令切换模式，无需卡片。
 
 ## 开发
 
@@ -103,6 +111,8 @@ npm run foreground # 前台运行已构建版本
 | 命令 | 说明 |
 |------|------|
 | `/help` | 显示帮助 |
+| `/mode` | 切换权限模式（卡片/按钮选择） |
+| `/mode <模式>` | 直接切换：ask / accept-edits / plan / yolo |
 | `/new` | 开始新会话 |
 | `/status` | 显示状态（AI 工具、工作目录、费用等） |
 | `/cd <路径>` | 切换工作目录 |
@@ -110,6 +120,17 @@ npm run foreground # 前台运行已构建版本
 | `/allow` `/y` | 允许权限请求 |
 | `/deny` `/n` | 拒绝权限请求 |
 
+### 权限模式
+
+与 Claude Code 官方命名一致，见 [permissions](https://code.claude.com/docs/en/permissions)：
+
+| 模式 | Claude 名 | 说明 |
+|------|-----------|------|
+| ask | default | 首次使用每个工具时提示确认 |
+| accept-edits | acceptEdits | 编辑权限自动通过 |
+| plan | plan | 仅分析，不修改文件不执行命令 |
+| yolo | bypassPermissions | 跳过所有权限确认 |
+
 ## 📝 License
 
 [MIT](LICENSE)
@@ -214,3 +235,14 @@ npx @wu529778790/open-im run
 3. **用户 ID 白名单问题**
    - 检查配置文件中的 `allowedUserIds` 是否包含你的用户 ID
    - 或留空允许所有人访问（仅开发环境建议）
+
+### Q: 飞书 /mode 卡片点击报错（如 200340）？
+
+说明未配置**卡片回调**。注意：卡片在 **「回调」** Tab，不在「事件」Tab。
+
+1. 打开 [飞书开放平台](https://open.feishu.cn/app) → 进入你的应用 → **「事件与回调」**
+2. 切换到 **「回调」** Tab（不是「事件」）
+3. 选择 **「使用长连接接收回调」**
+4. 添加 **「卡片回传交互」**（`card.action.trigger`）— 若搜不到，可尝试搜「action」「trigger」或浏览分类
+
+**更简单**：直接用 `/mode ask`、`/mode yolo` 等命令切换模式，无需配置卡片。

package/dist/adapters/claude-adapter.js

@@ -17,6 +17,7 @@ export class ClaudeAdapter {
     run(prompt, sessionId, workDir, callbacks, options) {
         const opts = {
             skipPermissions: options?.skipPermissions,
+            permissionMode: options?.permissionMode,
             timeoutMs: options?.timeoutMs,
             model: options?.model,
             chatId: options?.chatId,

package/dist/adapters/tool-adapter.interface.d.ts

@@ -21,6 +21,8 @@ export interface RunCallbacks {
 }
 export interface RunOptions {
     skipPermissions?: boolean;
+    /** Claude --permission-mode: default | acceptEdits | plan（yolo 时用 skipPermissions） */
+    permissionMode?: 'default' | 'acceptEdits' | 'plan';
     timeoutMs?: number;
     model?: string;
     chatId?: string;

package/dist/claude/cli-runner.d.ts

@@ -17,6 +17,7 @@ export interface ClaudeRunCallbacks {
 }
 export interface ClaudeRunOptions {
     skipPermissions?: boolean;
+    permissionMode?: 'default' | 'acceptEdits' | 'plan';
     timeoutMs?: number;
     model?: string;
     chatId?: string;

package/dist/claude/cli-runner.js

@@ -12,8 +12,12 @@ export function runClaude(cliPath, prompt, sessionId, workDir, callbacks, option
         "--verbose",
         "--include-partial-messages",
     ];
-    if (options?.skipPermissions)
+    if (options?.skipPermissions) {
         args.push("--dangerously-skip-permissions");
+    }
+    else if (options?.permissionMode) {
+        args.push("--permission-mode", options.permissionMode);
+    }
     if (options?.model)
         args.push("--model", options.model);
     if (sessionId)

package/dist/claude/process-pool.d.ts

@@ -27,6 +27,7 @@ export interface ClaudeResult {
 }
 export interface ClaudeRunOptions {
     skipPermissions?: boolean;
+    permissionMode?: 'default' | 'acceptEdits' | 'plan';
     timeoutMs?: number;
     model?: string;
     chatId?: string;

package/dist/claude/process-pool.js

@@ -62,8 +62,12 @@ export class ClaudeProcessPool {
                 "--verbose",
                 "--include-partial-messages",
             ];
-            if (options.skipPermissions)
+            if (options.skipPermissions) {
                 args.push("--dangerously-skip-permissions");
+            }
+            else if (options.permissionMode) {
+                args.push("--permission-mode", options.permissionMode);
+            }
             if (options.model)
                 args.push("--model", options.model);
             if (sessionId)

package/dist/commands/handler.d.ts

@@ -1,11 +1,14 @@
 import type { Config } from '../config.js';
 import type { SessionManager } from '../session/session-manager.js';
 import type { RequestQueue } from '../queue/request-queue.js';
+import { type PermissionMode } from '../permission-mode/types.js';
 import type { ThreadContext } from '../shared/types.js';
 export type { ThreadContext };
 export interface MessageSender {
     sendTextReply(chatId: string, text: string, threadCtx?: ThreadContext): Promise<void>;
     sendDirectorySelection?(chatId: string, currentDir: string, userId: string): Promise<void>;
+    sendModeCard?(chatId: string, userId: string, currentMode: PermissionMode): Promise<void>;
+    sendModeKeyboard?(chatId: string, userId: string, currentMode: PermissionMode): Promise<void>;
 }
 export interface CommandHandlerDeps {
     config: Config;
@@ -19,6 +22,8 @@ export declare class CommandHandler {
     private deps;
     constructor(deps: CommandHandlerDeps);
     dispatch(text: string, chatId: string, userId: string, platform: 'feishu' | 'telegram', handleClaudeRequest: ClaudeRequestHandler): Promise<boolean>;
+    private handleMode;
+    private getClearHistoryHint;
     private handleHelp;
     private handleNew;
     private handlePwd;

package/dist/commands/handler.js

@@ -1,4 +1,6 @@
 import { resolveLatestPermission, getPendingCount } from '../hook/permission-server.js';
+import { getPermissionMode, setPermissionMode } from '../permission-mode/session-mode.js';
+import { MODE_LABELS, MODE_DESCRIPTIONS, parsePermissionMode } from '../permission-mode/types.js';
 import { TERMINAL_ONLY_COMMANDS } from '../constants.js';
 import { execFile } from 'node:child_process';
 import { readdirSync } from 'node:fs';
@@ -16,8 +18,10 @@ export class CommandHandler {
         }
         if (t === '/help')
             return this.handleHelp(chatId, platform);
+        if (t === '/mode' || t.startsWith('/mode '))
+            return this.handleMode(chatId, userId, platform, t.slice(6).trim());
         if (t === '/new')
-            return this.handleNew(chatId, userId);
+            return this.handleNew(chatId, userId, platform);
         if (t === '/pwd')
             return this.handlePwd(chatId, userId);
         if (t === '/status')
@@ -27,7 +31,7 @@ export class CommandHandler {
         if (t === '/deny' || t === '/n')
             return this.handleDeny(chatId);
         if (t === '/cd' || t.startsWith('/cd ')) {
-            return this.handleCd(chatId, userId, t.slice(3).trim());
+            return this.handleCd(chatId, userId, t.slice(3).trim(), platform);
         }
         const cmd = t.split(/\s+/)[0];
         if (TERMINAL_ONLY_COMMANDS.has(cmd)) {
@@ -36,11 +40,46 @@ export class CommandHandler {
         }
         return false;
     }
+    async handleMode(chatId, userId, platform, arg) {
+        const defaultMode = this.deps.config.defaultPermissionMode;
+        const currentMode = getPermissionMode(userId, defaultMode);
+        if (arg) {
+            const parsed = parsePermissionMode(arg);
+            if (parsed) {
+                setPermissionMode(userId, parsed);
+                await this.deps.sender.sendTextReply(chatId, `✅ 权限模式已切换为 **${MODE_LABELS[parsed]}**\n${MODE_DESCRIPTIONS[parsed]}`);
+                return true;
+            }
+            await this.deps.sender.sendTextReply(chatId, `无效模式: ${arg}\n可用: ask, accept-edits, plan, yolo`);
+            return true;
+        }
+        if (platform === 'feishu' && this.deps.sender.sendModeCard) {
+            await this.deps.sender.sendModeCard(chatId, userId, currentMode);
+            return true;
+        }
+        if (platform === 'telegram' && this.deps.sender.sendModeKeyboard) {
+            await this.deps.sender.sendModeKeyboard(chatId, userId, currentMode);
+            return true;
+        }
+        const lines = [
+            `🔐 **权限模式** (当前: ${MODE_LABELS[currentMode]})`,
+            '',
+            ...['ask', 'accept-edits', 'plan', 'yolo'].map((m) => `• \`/mode ${m}\` - ${MODE_LABELS[m]}: ${MODE_DESCRIPTIONS[m]}`),
+        ];
+        await this.deps.sender.sendTextReply(chatId, lines.join('\n'));
+        return true;
+    }
+    getClearHistoryHint(platform) {
+        return platform === 'feishu'
+            ? '💡 提示：如需清除本对话的历史消息，请点击飞书聊天右上角「...」→ 清除聊天记录'
+            : '💡 提示：如需清除本对话的历史消息，请点击 Telegram 聊天右上角 ⋮ → 清除历史';
+    }
     async handleHelp(chatId, platform) {
         const help = [
             '📋 可用命令:',
             '',
             '/help - 显示帮助',
+            '/mode - 切换权限模式（安全/编辑放行/只读/YOLO）',
             '/new - 开始新会话（AI 上下文重置）',
             '/status - 显示状态',
             '/cd <路径> - 切换工作目录',
@@ -48,16 +87,15 @@ export class CommandHandler {
             '/allow (/y) - 允许权限请求',
             '/deny (/n) - 拒绝权限请求',
             '',
-            '💡 提示：清除聊天历史请点击 Telegram 右上角 ⋮ → 清除历史',
+            this.getClearHistoryHint(platform),
         ].join('\n');
         await this.deps.sender.sendTextReply(chatId, help);
         return true;
     }
-    async handleNew(chatId, userId) {
+    async handleNew(chatId, userId, platform) {
         const ok = this.deps.sessionManager.newSession(userId);
         await this.deps.sender.sendTextReply(chatId, ok
-            ? '✅ AI 会话已重置，下一条消息将使用全新上下文。\n\n' +
-                '💡 提示：如需清除本对话的历史消息，请点击 Telegram 聊天右上角 ⋮ → 清除历史'
+            ? `✅ AI 会话已重置，下一条消息将使用全新上下文。\n\n${this.getClearHistoryHint(platform)}`
             : '当前没有活动会话。');
         return true;
     }
@@ -82,7 +120,7 @@ export class CommandHandler {
         await this.deps.sender.sendTextReply(chatId, lines.join('\n'));
         return true;
     }
-    async handleCd(chatId, userId, dir) {
+    async handleCd(chatId, userId, dir, platform) {
         // 如果 dir 为空，显示目录选择界面
         if (!dir) {
             const currentDir = this.deps.sessionManager.getWorkDir(userId);
@@ -98,7 +136,7 @@ export class CommandHandler {
             const resolved = await this.deps.sessionManager.setWorkDir(userId, dir);
             await this.deps.sender.sendTextReply(chatId, `📁 工作目录已切换到: ${resolved}\n\n` +
                 `🔄 AI 会话已重置，下一条消息将使用全新上下文。\n` +
-                `💡 提示：如需清除本对话的历史消息，请点击 Telegram 聊天右上角 ⋮ → 清除历史`);
+                this.getClearHistoryHint(platform));
         }
         catch (err) {
             await this.deps.sender.sendTextReply(chatId, err instanceof Error ? err.message : String(err));

package/dist/config.d.ts

@@ -14,8 +14,10 @@ export interface Config {
     claudeWorkDir: string;
     allowedBaseDirs: string[];
     claudeSkipPermissions: boolean;
+    defaultPermissionMode: 'ask' | 'accept-edits' | 'plan' | 'yolo';
     claudeTimeoutMs: number;
     claudeModel?: string;
+    hookPort: number;
     logDir: string;
     logLevel: LogLevel;
     platforms: {

package/dist/config.js

@@ -84,9 +84,13 @@ export function loadConfig() {
     const claudeSkipPermissions = process.env.CLAUDE_SKIP_PERMISSIONS !== undefined
         ? process.env.CLAUDE_SKIP_PERMISSIONS === 'true'
         : file.claudeSkipPermissions ?? true;
+    const defaultPermissionMode = (file.defaultPermissionMode ?? 'ask');
     const claudeTimeoutMs = process.env.CLAUDE_TIMEOUT_MS !== undefined
         ? parseInt(process.env.CLAUDE_TIMEOUT_MS, 10) || 600000
         : file.claudeTimeoutMs ?? 600000;
+    const hookPort = process.env.HOOK_PORT !== undefined
+        ? parseInt(process.env.HOOK_PORT, 10) || 35801
+        : file.hookPort ?? 35801;
     // 6. 校验 Claude CLI
     if (aiCommand === 'claude') {
         if (isAbsolute(claudeCliPath) || claudeCliPath.includes('/') || claudeCliPath.includes('\\')) {
@@ -164,8 +168,10 @@ export function loadConfig() {
         claudeWorkDir,
         allowedBaseDirs,
         claudeSkipPermissions,
+        defaultPermissionMode,
         claudeTimeoutMs,
         claudeModel: process.env.CLAUDE_MODEL ?? file.claudeModel,
+        hookPort,
         logDir,
         logLevel,
         platforms,

package/dist/feishu/client.d.ts

@@ -1,5 +1,5 @@
 import { Client } from '@larksuiteoapi/node-sdk';
 import type { Config } from '../config.js';
 export declare function getClient(): Client;
-export declare function initFeishu(config: Config, eventHandler: (data: unknown) => Promise<void>): Promise<void>;
+export declare function initFeishu(config: Config, eventHandler: (data: unknown) => Promise<void | Record<string, unknown>>): Promise<void>;
 export declare function stopFeishu(): void;

package/dist/feishu/client.js

@@ -34,6 +34,19 @@ export async function initFeishu(config, eventHandler) {
                 log.error('[EVENT] Error calling event handler:', err);
             }
         },
+        // 卡片按钮点击回调（权限允许/拒绝等）
+        'card.action.trigger': async (data) => {
+            log.info('[EVENT] Received Feishu card action event');
+            log.info('[EVENT] Card action data:', JSON.stringify(data).slice(0, 800));
+            try {
+                const result = await eventHandler(data);
+                return result;
+            }
+            catch (err) {
+                log.error('[EVENT] Error handling card action:', err);
+                return { toast: { type: 'error', content: '处理失败' } };
+            }
+        },
     });
     // Register catch-all handler using wildcard
     eventDispatcher.register({

package/dist/feishu/event-handler.d.ts

@@ -3,6 +3,6 @@ import type { SessionManager } from '../session/session-manager.js';
 export interface FeishuEventHandlerHandle {
     stop: () => void;
     getRunningTaskCount: () => number;
-    handleEvent: (data: unknown) => Promise<void>;
+    handleEvent: (data: unknown) => Promise<void | Record<string, unknown>>;
 }
 export declare function setupFeishuHandlers(config: Config, sessionManager: SessionManager): FeishuEventHandlerHandle;