@wu529778790/open-im 1.10.9-beta.1 → 1.10.9-beta.3

package/README.md

@@ -4,6 +4,10 @@
 
 Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, DingTalk, QQ, and WeChat (WorkBuddy) to Claude Code, Codex, and CodeBuddy — use your AI coding assistant from any phone or chat window.
 
+## Architecture
+
+![Open-IM Architecture](./diagram/architecture/open-im-architecture.svg)
+
 ## Features
 
 - **Six IM platforms** — Telegram, Feishu, WeCom, DingTalk, QQ, WorkBuddy

package/README.zh-CN.md

@@ -4,6 +4,10 @@
 
 多平台 IM 桥接：把 Telegram、飞书、企业微信、钉钉、QQ、微信（WorkBuddy）接到 Claude Code、Codex、CodeBuddy，在手机或聊天里使用 AI 编程助手。
 
+## 架构
+
+![Open-IM 架构图](./diagram/architecture/open-im-architecture.svg)
+
 ## 功能特性
 
 - **六个 IM 平台** — Telegram、飞书、企业微信、钉钉、QQ、WorkBuddy

package/dist/cli.js

@@ -97,21 +97,28 @@ async function cmdStop() {
 }
 async function cmdRestart() {
     const status = getManagerStatus();
+    let restartedExistingInstance = false;
     if (status.pid) {
         await stopBackgroundService();
         const stopped = await stopManagerProcess();
         console.log("\nopen-im stopped.");
         console.log(`  pid: ${stopped.pid}`);
+        restartedExistingInstance = true;
     }
     else {
-        console.log("open-im is not running in the background. Starting a new instance.");
+        console.log("\nopen-im is not running in the background.");
     }
     if (!(await ensureConfigured("start"))) {
         process.exit(1);
     }
     await checkAndUpdate();
     const child = await startManagerProcess(process.cwd());
-    console.log("\nopen-im restarted in the background.");
+    if (restartedExistingInstance) {
+        console.log("\nopen-im restarted in the background.");
+    }
+    else {
+        console.log("\nopen-im started in the background.");
+    }
     console.log(`  pid: ${child.pid}`);
     logWebDashboardAndApi();
     process.exit(0);

package/dist/config/file-io.d.ts

@@ -19,8 +19,11 @@ export declare function getClaudeSdkRuntimeIssue(): string | null;
 export declare function parseCommaSeparated(value: string): string[];
 /**
  * 将最新的 Claude 认证环境变量按优先级合并到 process.env。
- * 优先级：shell 环境变量 > ~/.open-im/config.json 的 tools.claude.env >
- * 本机 Claude 配置（~/.claude/settings.json，与 Claude Code 共用）。
- * 多数用户只维护本机 settings；每次创建 Claude SDK 会话前调用，本机文件变更后下次会话即生效。
+ * 优先级：shell 环境变量 > 本机 Claude 配置（~/.claude/settings.json，与 Claude Code 共用）>
+ * ~/.open-im/config.json 的 tools.claude.env。
+ *
+ * 设计意图：用户只需维护 ~/.claude/settings.json（与 Claude Code CLI 共用），
+ * open-im 自动跟随本地 Claude 配置，无需单独配置。config.json 的 tools.claude.env
+ * 仅作为兜底，供没有本地 Claude 安装的场景使用。
  */
 export declare function refreshClaudeEnvToProcess(): void;

package/dist/config/file-io.js

@@ -350,9 +350,12 @@ export function parseCommaSeparated(value) {
 }
 /**
  * 将最新的 Claude 认证环境变量按优先级合并到 process.env。
- * 优先级：shell 环境变量 > ~/.open-im/config.json 的 tools.claude.env >
- * 本机 Claude 配置（~/.claude/settings.json，与 Claude Code 共用）。
- * 多数用户只维护本机 settings；每次创建 Claude SDK 会话前调用，本机文件变更后下次会话即生效。
+ * 优先级：shell 环境变量 > 本机 Claude 配置（~/.claude/settings.json，与 Claude Code 共用）>
+ * ~/.open-im/config.json 的 tools.claude.env。
+ *
+ * 设计意图：用户只需维护 ~/.claude/settings.json（与 Claude Code CLI 共用），
+ * open-im 自动跟随本地 Claude 配置，无需单独配置。config.json 的 tools.claude.env
+ * 仅作为兜底，供没有本地 Claude 安装的场景使用。
  */
 export function refreshClaudeEnvToProcess() {
     const file = loadFileConfig();
@@ -363,14 +366,16 @@ export function refreshClaudeEnvToProcess() {
             process.env[key] = originalShellEnv[key];
             continue;
         }
-        if (key in claudeToolEnv) {
-            process.env[key] = claudeToolEnv[key];
-            continue;
-        }
+        // 优先读取 ~/.claude/settings.json（与 Claude Code CLI 共用同一配置）
         if (key in claudeSettingsEnv) {
             process.env[key] = claudeSettingsEnv[key];
             continue;
         }
+        // 兜底：config.json tools.claude.env（仅在没有本地 Claude 安装时需要）
+        if (key in claudeToolEnv) {
+            process.env[key] = claudeToolEnv[key];
+            continue;
+        }
         delete process.env[key];
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu529778790/open-im",
-  "version": "1.10.9-beta.1",
+  "version": "1.10.9-beta.3",
   "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, CodeBuddy)",
   "type": "module",
   "main": "dist/index.js",

package/dist/config/credentials.d.ts

@@ -1,19 +0,0 @@
-import type { FileConfig } from './types.js';
-/**
- * Resolves a single credential value using the standard priority chain:
- * environment variable → platform file config → legacy file config.
- */
-export declare function resolveCredential(envKey: string, fileValue?: string, legacyFileValue?: string): string | undefined;
-/**
- * Generic per-platform credential resolution.
- * Returns all resolved credentials and whether the platform should be enabled.
- */
-export interface ResolvedPlatform {
-    enabled: boolean;
-    credentials: Record<string, string | undefined>;
-}
-export declare function resolvePlatformCredentials(envKeys: Record<string, string>, fileValues: Record<string, string | undefined>, legacyValues: Record<string, string | undefined>, requiredKeys: string[], enabledFlag?: boolean): ResolvedPlatform;
-/**
- * Extract WorkBuddy credentials, with legacy platforms.wechat migration support.
- */
-export declare function resolveWorkBuddyFileConfig(fileConfig: FileConfig): NonNullable<FileConfig['platforms']>['workbuddy'] | undefined;

package/dist/config/credentials.js

@@ -1,36 +0,0 @@
-/**
- * Resolves a single credential value using the standard priority chain:
- * environment variable → platform file config → legacy file config.
- */
-export function resolveCredential(envKey, fileValue, legacyFileValue) {
-    return process.env[envKey] ?? fileValue ?? legacyFileValue;
-}
-export function resolvePlatformCredentials(envKeys, fileValues, legacyValues, requiredKeys, enabledFlag) {
-    const credentials = {};
-    for (const [name, envKey] of Object.entries(envKeys)) {
-        credentials[name] = resolveCredential(envKey, fileValues[name], legacyValues[name]);
-    }
-    const hasRequired = requiredKeys.every((key) => credentials[key] !== undefined && credentials[key] !== '');
-    return {
-        enabled: hasRequired && enabledFlag !== false,
-        credentials,
-    };
-}
-/**
- * Extract WorkBuddy credentials, with legacy platforms.wechat migration support.
- */
-export function resolveWorkBuddyFileConfig(fileConfig) {
-    const direct = fileConfig.platforms?.workbuddy;
-    if (direct)
-        return direct;
-    const legacyWechat = fileConfig.platforms?.wechat;
-    if (legacyWechat?.workbuddyAccessToken && legacyWechat?.workbuddyRefreshToken) {
-        return {
-            accessToken: legacyWechat.workbuddyAccessToken,
-            refreshToken: legacyWechat.workbuddyRefreshToken,
-            userId: legacyWechat.userId,
-            baseUrl: legacyWechat.workbuddyBaseUrl,
-        };
-    }
-    return undefined;
-}