@wu529778790/open-im 1.5.2-beta.4 → 1.5.2-beta.5

package/README.md

@@ -8,8 +8,7 @@
 - 多 AI 工具：支持 Claude、Codex、Cursor
 - 流式输出：实时回传 AI 回复与工具执行进度
 - 会话隔离：每个用户独立维护本地会话，`/new` 可重置
-- 权限模式：支持 `ask`、`accept-edits`、`plan`、`yolo`
-- 常用命令：支持 `/help`、`/mode`、`/new`、`/cd`、`/pwd`、`/status`
+- 常用命令：支持 `/help`、`/new`、`/cd`、`/pwd`、`/status`
 
 ## 环境要求
 
@@ -185,26 +184,16 @@ Claude 默认使用 Agent SDK，不依赖本地 `claude` 可执行文件；通
 说明：钉钉当前采用“Stream Mode 收消息 + OpenAPI 发送消息”的混合模式。
 
 - 会话内普通文本回复默认走 `sessionWebhook`
-- 如果配置了 `cardTemplateId` / `DINGTALK_CARD_TEMPLATE_ID`，AI 回复会升级为单条 `ai_card` 流式更新（`prepare / update / finish`）
+- 若配置了 `cardTemplateId`，会尝试 AI 助理 `prepare/update/finish` 流式卡片；失败则 fallback 为普通文本（自定义机器人/普通群场景下互动卡片 API 报 param.error，暂不支持单条流式更新）
 - 启动/关闭通知会发给最近一次已互动的钉钉会话；如果服务冷启动后还没有任何钉钉会话互动过，则没有可用目标可发
 
-钉钉 AI 卡片模板需至少兼容以下字段，建议模板按这些 key 取值：
-
-- `title`
-- `content`
-- `note`
-- `toolName`
-- `status`
-- `flowStatus`
-- `displayText`
+钉钉 AI 卡片模板：已适配官方「搜索结果卡片」模板，使用变量 `lastMessage`、`content`、`resources`、`users`、`flowStatus`。若使用该模板，无需修改模板即可实现流式更新。
 
 ## IM 内命令
 
 | 命令 | 说明 |
 | ---- | ---- |
 | `/help` | 显示帮助 |
-| `/mode` | 飞书显示卡片，Telegram 显示按钮，其它平台（含钉钉）显示文本模式列表 |
-| `/mode <模式>` | 直接切换：`ask` / `accept-edits` / `plan` / `yolo` |
 | `/new` | 开始新会话 |
 | `/status` | 显示 AI 工具、版本、会话目录、会话 ID |
 | `/cd <路径>` | 切换会话目录 |
@@ -212,17 +201,6 @@ Claude 默认使用 Agent SDK，不依赖本地 `claude` 可执行文件；通
 | `/allow` `/y` | 允许权限请求 |
 | `/deny` `/n` | 拒绝权限请求 |
 
-### 权限模式
-
-与 Claude Code 官方命名保持一致，参考 [permissions](https://code.claude.com/docs/en/permissions)：
-
-| 模式 | Claude 名 | 说明 |
-| ---- | --------- | ---- |
-| `ask` | `default` | 首次使用工具时询问 |
-| `accept-edits` | `acceptEdits` | 自动允许编辑 |
-| `plan` | `plan` | 只读分析，不执行命令、不改文件 |
-| `yolo` | `bypassPermissions` | 跳过所有权限确认 |
-
 ## 故障排除
 
 **Telegram 无响应**：检查网络，必要时在 Telegram 平台配置中添加 `"proxy": "http://127.0.0.1:7890"` 或设置 `TELEGRAM_PROXY`。
@@ -233,7 +211,7 @@ Claude 默认使用 Agent SDK，不依赖本地 `claude` 可执行文件；通
 
 **钉钉无法回复**：确认应用已启用机器人 Stream Mode，并检查 `DINGTALK_CLIENT_ID`、`DINGTALK_CLIENT_SECRET` 或 `platforms.dingtalk` 配置是否正确。
 
-**钉钉没有流式更新**：如果未配置 `DINGTALK_CARD_TEMPLATE_ID`（或 `platforms.dingtalk.cardTemplateId`），会自动退回普通文本回复；配置 AI 卡片模板后才会启用单条流式更新。
+**钉钉没有流式更新**：prepare 失败时 fallback 为普通文本回复。自定义机器人/普通群场景下，AI 助理和互动卡片 API 均不可用，仅支持单条文本回复。
 
 **Cursor 报 `Authentication required`**：先执行 `agent login`，或在 `env` 中设置 `CURSOR_API_KEY`。
 

package/dist/adapters/registry.d.ts

@@ -2,7 +2,4 @@ import type { Config } from '../config.js';
 import type { ToolAdapter } from './tool-adapter.interface.js';
 export declare function initAdapters(config: Config): void;
 export declare function getAdapter(aiCommand: string): ToolAdapter | undefined;
-/**
- * Cleanup all adapter resources.
- */
 export declare function cleanupAdapters(): void;

package/dist/adapters/registry.js

@@ -14,7 +14,7 @@ export function initAdapters(config) {
             console.log('🚀 使用标准 Claude 适配器');
             adapters.set('claude', new ClaudeAdapter(config.claudeCliPath, {
                 useProcessPool: true,
-                idleTimeoutMs: 2 * 60 * 1000, // 2 minutes
+                idleTimeoutMs: 2 * 60 * 1000,
             }));
         }
     }
@@ -30,11 +30,8 @@ export function initAdapters(config) {
 export function getAdapter(aiCommand) {
     return adapters.get(aiCommand);
 }
-/**
- * Cleanup all adapter resources.
- */
 export function cleanupAdapters() {
     ClaudeAdapter.destroy();
-    ClaudeSDKAdapter.destroy(); // 清理 SDK 查询
+    ClaudeSDKAdapter.destroy();
     adapters.clear();
 }

package/dist/check-update.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 检查更新，若有新版本则自动执行全局更新
+ * @returns true 表示已更新并需要重启（调用方应退出），false 表示无需更新或更新失败
+ */
+export declare function checkAndUpdate(): Promise<{
+    updated: boolean;
+    latest?: string;
+}>;

package/dist/check-update.js

@@ -0,0 +1,70 @@
+/**
+ * 启动时检查并自动更新到最新版本
+ */
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const { version: CURRENT_VERSION } = require("../package.json");
+const PKG_NAME = "@wu529778790/open-im";
+const REGISTRY_URL = `https://registry.npmjs.org/${encodeURIComponent(PKG_NAME)}`;
+/** 从 npm registry 获取最新版本 */
+async function fetchLatestVersion() {
+    try {
+        const res = await fetch(`${REGISTRY_URL}?fields=dist-tags`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data["dist-tags"]?.latest ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 简单 semver 比较：若 a < b 返回 true */
+function isNewerVersion(current, latest) {
+    const parse = (v) => {
+        const m = v.replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)/);
+        return m ? [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)] : [0, 0, 0];
+    };
+    const [c1, c2, c3] = parse(current);
+    const [l1, l2, l3] = parse(latest);
+    if (l1 !== c1)
+        return l1 > c1;
+    if (l2 !== c2)
+        return l2 > c2;
+    return l3 > c3;
+}
+/** 执行全局更新 */
+function runGlobalUpdate() {
+    const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+    const result = spawnSync(npm, ["install", "-g", `${PKG_NAME}@latest`], {
+        stdio: "inherit",
+        shell: process.platform === "win32",
+    });
+    return result.status === 0;
+}
+/**
+ * 检查更新，若有新版本则自动执行全局更新
+ * @returns true 表示已更新并需要重启（调用方应退出），false 表示无需更新或更新失败
+ */
+export async function checkAndUpdate() {
+    const latest = await fetchLatestVersion();
+    if (!latest || !isNewerVersion(CURRENT_VERSION, latest)) {
+        return { updated: false };
+    }
+    console.log(`\n📦 检测到新版本 v${latest}（当前 v${CURRENT_VERSION}），正在更新...`);
+    const ok = runGlobalUpdate();
+    if (ok) {
+        console.log(`\n✅ 已更新到 v${latest}，正在启动服务...\n`);
+        spawnSync("open-im", ["start"], {
+            stdio: "inherit",
+            shell: true,
+            windowsHide: false,
+        });
+        return { updated: true, latest };
+    }
+    console.log("\n⚠️ 自动更新失败，请手动执行: npm install -g @wu529778790/open-im@latest");
+    return { updated: false };
+}

package/dist/cli.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 import { main, needsSetup, runInteractiveSetup } from "./index.js";
 import { loadConfig } from "./config.js";
 import { runPlatformSelectionPrompt } from "./setup.js";
+import { checkAndUpdate } from "./check-update.js";
 import { APP_HOME, SHUTDOWN_PORT } from "./constants.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PID_FILE = join(APP_HOME, "open-im.pid");
@@ -91,7 +92,8 @@ async function validateOrSetup() {
 async function cmdStart() {
     const pid = getPid();
     if (pid && isRunning(pid)) {
-        console.log(`open-im 已在后台运行 (pid=${pid})`);
+        console.log("\n🟢 open-im 已在后台运行");
+        console.log(`   pid: ${pid}`);
         return;
     }
     else {
@@ -100,6 +102,11 @@ async function cmdStart() {
     if (!(await validateOrSetup())) {
         process.exit(1);
     }
+    // 检查并自动更新到最新版本
+    const { updated } = await checkAndUpdate();
+    if (updated) {
+        process.exit(0);
+    }
     // 有 TTY 时在父进程让用户选择要启用的平台，再启动子进程
     let config = loadConfig();
     if (process.stdin.isTTY) {
@@ -118,7 +125,8 @@ async function cmdStart() {
     });
     child.unref();
     writePid(child.pid);
-    console.log(`open-im 已在后台启动 (pid=${child.pid})`);
+    console.log("\n🟢 open-im 已在后台启动");
+    console.log(`   pid: ${child.pid}`);
 }
 async function cmdStop() {
     const pid = getPid();
@@ -162,7 +170,8 @@ async function cmdStop() {
     catch {
         /* ignore */
     }
-    console.log(`open-im 已停止 (pid=${pid})`);
+    console.log("\n🔴 open-im 已停止");
+    console.log(`   pid: ${pid}`);
 }
 async function cmdInit() {
     console.log("\n━━━ open-im 配置向导 ━━━\n");

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

@@ -1,7 +1,5 @@
 /**
- * Codex CLI Runner - 解析 codex exec --json 的 JSONL 输出
- * 参考: https://developers.openai.com/codex/cli/reference/
- *       https://takopi.dev/reference/runners/codex/exec-json-cheatsheet/
+ * Codex CLI Runner - 解析 `codex exec --json` 的 JSONL 输出。
  */
 export interface CodexRunCallbacks {
     onText: (accumulated: string) => void;

package/dist/codex/cli-runner.js

@@ -1,7 +1,5 @@
 /**
- * Codex CLI Runner - 解析 codex exec --json 的 JSONL 输出
- * 参考: https://developers.openai.com/codex/cli/reference/
- *       https://takopi.dev/reference/runners/codex/exec-json-cheatsheet/
+ * Codex CLI Runner - 解析 `codex exec --json` 的 JSONL 输出。
  */
 import { spawn } from 'node:child_process';
 import { execFileSync } from 'node:child_process';
@@ -51,7 +49,6 @@ function buildCodexArgs(_prompt, sessionId, workDir, options) {
         : ["exec", ...newSessionOptions, "-"];
 }
 function quoteForWindowsCmd(arg) {
-    // 普通 flag / sessionId / 无空格路径不需要加引号，否则引号可能被原样传给子进程。
     if (/^[A-Za-z0-9_./:=+\\-]+$/.test(arg)) {
         return arg;
     }
@@ -62,7 +59,6 @@ function quoteForWindowsCmd(arg) {
     return `"${escaped}"`;
 }
 function formatWindowsCommandName(command) {
-    // 裸命令名（如 codex）依赖 PATH 查找，不能再包双引号，否则 cmd 会按字面量查找。
     if (/^[A-Za-z0-9_.-]+$/.test(command)) {
         return command;
     }
@@ -118,7 +114,6 @@ function resolveWindowsCodexLaunch(cliPath, args) {
     }
 }
 export function runCodex(cliPath, prompt, sessionId, workDir, callbacks, options) {
-    // codex exec --json 非交互模式
     const args = buildCodexArgs(prompt, sessionId, workDir, options);
     const env = {};
     for (const [k, v] of Object.entries(process.env)) {
@@ -138,13 +133,11 @@ export function runCodex(cliPath, prompt, sessionId, workDir, callbacks, options
         env.all_proxy = options.proxy;
     }
     if (process.platform === 'win32') {
-        // 强制子进程在 Windows 下使用 UTF-8，避免中文源码/命令输出乱码。
         env.LANG = env.LANG || 'C.UTF-8';
         env.LC_ALL = env.LC_ALL || 'C.UTF-8';
     }
     const argsForLog = args.join(' ');
     log.info(`Spawning Codex CLI: path=${cliPath}, cwd=${workDir}, session=${sessionId ?? 'new'}, args=${argsForLog}`);
-    // Windows: .cmd/.bat 或简单命令名（如 codex）需通过 cmd.exe 执行，否则 spawn 报 ENOENT
     const isWinCmd = process.platform === 'win32' &&
         (/\.(cmd|bat)$/i.test(cliPath) || cliPath === 'codex');
     const directWindowsLaunch = isWinCmd
@@ -171,13 +164,11 @@ export function runCodex(cliPath, prompt, sessionId, workDir, callbacks, options
         env,
         windowsHide: process.platform === 'win32',
     });
-    // 通过 stdin 传 prompt，避免 Windows 下命令行参数引用导致中文/路径/空格被拆分。
     child.stdin?.write(prompt);
     child.stdin?.end();
     let accumulated = '';
     let accumulatedThinking = '';
     let completed = false;
-    let threadId = '';
     const toolStats = {};
     const startTime = Date.now();
     const MAX_TIMEOUT = 2_147_483_647;
@@ -226,7 +217,7 @@ export function runCodex(cliPath, prompt, sessionId, workDir, callbacks, options
         const type = event.type;
         log.debug(`[Codex event] type=${type}`);
         if (type === 'thread.started') {
-            threadId = event.thread_id ?? '';
+            const threadId = event.thread_id ?? '';
             if (threadId)
                 callbacks.onSessionId?.(threadId);
             return;
@@ -302,7 +293,6 @@ export function runCodex(cliPath, prompt, sessionId, workDir, callbacks, options
             completed = true;
             if (timeoutHandle)
                 clearTimeout(timeoutHandle);
-            const usage = event.usage;
             const durationMs = Date.now() - startTime;
             callbacks.onComplete({
                 success: true,

package/dist/dingtalk/client.d.ts

@@ -1,6 +1,13 @@
 import { type DWClientDownStream } from 'dingtalk-stream';
 import type { Config } from '../config.js';
 import type { DingTalkActiveTarget } from '../shared/active-chats.js';
+export interface DingTalkStreamingTarget {
+    chatId: string;
+    conversationType?: string;
+    senderStaffId?: string;
+    senderId?: string;
+    robotCode?: string;
+}
 export declare function registerSessionWebhook(chatId: string, sessionWebhook: string): void;
 export declare function sendText(chatId: string, content: string): Promise<unknown>;
 export declare function sendMarkdown(chatId: string, title: string, text: string): Promise<unknown>;
@@ -8,6 +15,14 @@ export declare function ackMessage(messageId: string, result?: unknown): void;
 export declare function initDingTalk(cfg: Config, eventHandler: (data: DWClientDownStream) => Promise<void>): Promise<void>;
 export declare function stopDingTalk(): void;
 export declare function sendProactiveText(target: string | DingTalkActiveTarget, content: string): Promise<void>;
-export declare function prepareStreamingCard(chatId: string, templateId: string, cardData: Record<string, unknown>): Promise<string>;
+export declare function prepareStreamingCard(target: string | DingTalkStreamingTarget, templateId: string, cardData: Record<string, unknown>): Promise<string>;
 export declare function updateStreamingCard(conversationToken: string, templateId: string, cardData: Record<string, unknown>): Promise<void>;
 export declare function finishStreamingCard(conversationToken: string): Promise<void>;
+/** 创建并投放卡片（卡片平台 API，支持普通群流式更新） */
+export declare function createAndDeliverCard(target: DingTalkStreamingTarget, templateId: string, outTrackId: string, cardData: Record<string, unknown>): Promise<void>;
+/** 更新卡片实例（用于流式更新） */
+export declare function updateCardInstance(outTrackId: string, cardData: Record<string, unknown>): Promise<void>;
+/** 互动卡片普通版：发送（用于 prepare 失败时的 fallback 流式） */
+export declare function sendRobotInteractiveCard(target: DingTalkStreamingTarget, cardBizId: string, cardData: Record<string, unknown>): Promise<void>;
+/** 互动卡片普通版：更新（单条消息流式更新） */
+export declare function updateRobotInteractiveCard(cardBizId: string, cardData: Record<string, unknown>): Promise<void>;