@wu529778790/open-im 1.7.0-beta.3 → 1.7.0-beta.4

package/README.md

@@ -57,9 +57,11 @@ The config file is stored at `~/.open-im/config.json` by default.
 | `open-im stop` | Stop the background service |
 | `open-im dev` | Run in the foreground for development/debugging |
 
-## Graphical Config Page
+## Server Deployment & Config Page
 
-Open the config page at **http://127.0.0.1:39282** (or the URL shown after `open-im start`). The page includes:
+### Local (with browser)
+
+Open the config page at [`http://127.0.0.1:39282`](http://127.0.0.1:39282) (or the URL shown after `open-im start`). The page includes:
 
 - **Dashboard** – Configured / Enabled platform count and service status (Idle or Running)
 - **Platforms** – Enable and configure Telegram, Feishu, QQ, WeCom, and DingTalk (credentials, proxy, per-platform AI tool, allowed user IDs). Each platform has a “Test Configuration” button.
@@ -68,10 +70,55 @@ Open the config page at **http://127.0.0.1:39282** (or the URL shown after `open
 
 WeChat is not in the web UI; configure it in `~/.open-im/config.json` or via `open-im init` if needed.
 
-- `open-im start` serves the config page and the bridge.
+- `open-im start` serves both the config page and the bridge.
 - `open-im dev` opens the page automatically only when setup is incomplete.
 - To open the page when config already exists, run `open-im start` and visit the URL above.
 
+### On a headless server (no GUI)
+
+Many servers do not have a desktop environment or browser. In that case, trying to auto-launch a browser (`xdg-open`, `open`, `start`) is unnecessary and may even fail. Use this pattern instead:
+
+- **1) Disable automatic browser launch**
+
+  On the server:
+
+  ```bash
+  export OPEN_IM_NO_BROWSER=1
+  open-im start
+  ```
+
+  This starts the bridge and the config web server in the background without attempting to open a browser.
+
+- **2) Verify that the config page is listening on the server**
+
+  On the server:
+
+  ```bash
+  ss -lntp | grep 39282        # or: netstat -lntp | grep 39282
+  curl -v http://127.0.0.1:39282/
+  ```
+
+  If you see a `LISTEN` line for `127.0.0.1:39282` and `curl` returns HTML, the config UI is running.
+
+- **3) Access the config UI from your local machine via SSH tunnel**
+
+  Instead of exposing port 39282 to the public internet, use SSH port forwarding:
+
+  ```bash
+  # On your local machine:
+  ssh -L 39282:127.0.0.1:39282 user@your-server-ip
+  ```
+
+  Then open in your local browser:
+
+  ```text
+  http://127.0.0.1:39282/
+  ```
+
+  This safely tunnels the config page from the server to your local browser.
+
+> If you really want to expose the config UI directly, you can change the listener in `config-web.ts` from `server.listen(port, "127.0.0.1", ...)` to `0.0.0.0` and open port 39282 in your firewall / security group. For security reasons, SSH tunneling is strongly recommended instead.
+
 ## Session Behavior
 
 Session context is stored locally in `~/.open-im/data/sessions.json` and is separate from the IM chat history itself. Each user has an independent session directory and session metadata. Sending `/new` resets the current AI session.

package/README.zh-CN.md

@@ -57,9 +57,17 @@ open-im start
 | `open-im stop` | 停止后台服务 |
 | `open-im dev` | 前台运行（调试模式） |
 
-## 图形化配置页面
+## 服务器部署与图形化配置
 
-在浏览器中打开 **http://127.0.0.1:39282**（或执行 `open-im start` 后提示的地址），页面结构如下：
+### 本机（带浏览器）使用
+
+在本机直接运行：
+
+```bash
+open-im start
+```
+
+然后在浏览器中打开 [`http://127.0.0.1:39282`](http://127.0.0.1:39282)（或命令行里提示的地址），页面结构如下：
 
 - **概览** – 已配置/已启用平台数量、服务状态（未启动或运行中）
 - **平台配置** – 启用并填写 Telegram、飞书、QQ、企业微信、钉钉的凭证（Bot Token/App ID/Secret、代理、该平台使用的 AI 工具、白名单用户 ID）。每个平台提供「校验配置」按钮
@@ -72,6 +80,51 @@ open-im start
 - `open-im dev` 仅在未完成配置时自动打开页面
 - 已有配置但想手动打开时，执行 `open-im start` 后访问上述地址即可
 
+### 在服务器上部署（无图形界面）
+
+很多服务器没有桌面环境和浏览器，此时「自动打开浏览器」既没意义，还可能因为缺少 `xdg-open` 报错。推荐如下用法：
+
+- **1）关闭自动打开浏览器**
+
+  在服务器上设置环境变量，然后启动：
+
+  ```bash
+  export OPEN_IM_NO_BROWSER=1
+  open-im start
+  ```
+
+  这样只会在后台启动服务与配置页面，不会尝试执行 `xdg-open` / `open` / `start`。
+
+- **2）检查配置页面是否已在服务器本机监听**
+
+  在服务器上执行：
+
+  ```bash
+  ss -lntp | grep 39282        # 或 netstat -lntp | grep 39282
+  curl -v http://127.0.0.1:39282/
+  ```
+
+  若看到 `LISTEN 0 ... 127.0.0.1:39282` 且 `curl` 返回 HTML，则说明 Web 配置页已正常启动。
+
+- **3）通过 SSH 隧道在本地浏览器访问**
+
+  不建议直接对外开放 39282 端口，而是使用 SSH 端口转发：
+
+  ```bash
+  # 在本地电脑执行，将本地 39282 转发到服务器 127.0.0.1:39282
+  ssh -L 39282:127.0.0.1:39282 user@your-server-ip
+  ```
+
+  然后在本地浏览器访问：
+
+  ```text
+  http://127.0.0.1:39282/
+  ```
+
+  即可打开服务器上的配置页面。
+
+> 如确有需要，也可以自行修改 `config-web.ts` 中的监听地址，将 `server.listen(port, "127.0.0.1", ...)` 调整为 `0.0.0.0`，并在防火墙/安全组放行 39282 端口。但出于安全考虑，官方推荐使用 SSH 隧道方式。
+
 ## 会话说明
 
 会话上下文保存在本地 `~/.open-im/data/sessions.json`，与 IM 聊天记录本身无关。每个用户有独立会话目录和 session 信息，发送 `/new` 会重置当前 AI 会话。

package/dist/config-web.js

@@ -459,18 +459,38 @@ function toFileConfig(payload, existing) {
     };
 }
 function openBrowser(url) {
+    // 显式关闭自动打开浏览器（服务器环境推荐设置）
     if (process.env.OPEN_IM_NO_BROWSER === "1") {
         return;
     }
+    // 在无 TTY 且无图形环境（常见于服务器）时直接跳过，避免无意义的 xdg-open 调用
+    if (!process.stdout.isTTY && !process.env.DISPLAY) {
+        log.info(`Skipping browser launch for URL ${url} (no TTY/DISPLAY detected).`);
+        return;
+    }
+    const safeSpawn = (command, args) => {
+        try {
+            const child = spawn(command, args, { detached: true, stdio: "ignore", windowsHide: process.platform === "win32" });
+            // 防止 ENOENT 之类的错误变成未捕获异常
+            child.on("error", (error) => {
+                log.warn(`Failed to launch browser command "${command}": ${error.code ?? error.message}`);
+            });
+            child.unref();
+        }
+        catch (error) {
+            log.warn(`Failed to spawn browser command "${command}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
     if (process.platform === "win32") {
-        spawn("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore", windowsHide: true }).unref();
+        safeSpawn("cmd", ["/c", "start", "", url]);
         return;
     }
     if (process.platform === "darwin") {
-        spawn("open", [url], { detached: true, stdio: "ignore" }).unref();
+        safeSpawn("open", [url]);
         return;
     }
-    spawn("xdg-open", [url], { detached: true, stdio: "ignore" }).unref();
+    // linux / 其他 UNIX 平台：优先尝试 xdg-open，失败时仅记录日志，不抛出
+    safeSpawn("xdg-open", [url]);
 }
 export function getWebConfigPort() {
     const fromEnv = process.env.OPEN_IM_WEB_PORT ? parseInt(process.env.OPEN_IM_WEB_PORT, 10) : NaN;

package/dist/index.js

@@ -103,6 +103,7 @@ function buildShutdownMessage(uptimeMinutes) {
     ].join("\n");
 }
 export async function main() {
+    const startupCwd = process.cwd();
     if (needsSetup()) {
         const saved = process.stdin.isTTY
             ? (await runWebConfigFlow({ mode: "dev", cwd: process.cwd() })) === "saved"
@@ -158,9 +159,12 @@ export async function main() {
     });
     log.info("Starting open-im bridge...");
     log.info(`AI 工具: ${getConfiguredAiCommands(config).join(", ")}`);
-    log.info(`默认会话目录: ${config.claudeWorkDir}`);
+    log.info(`默认会话目录(本次启动 cwd): ${startupCwd}`);
+    if (startupCwd !== config.claudeWorkDir) {
+        log.info(`历史默认会话目录(配置中的 claudeWorkDir): ${config.claudeWorkDir}`);
+    }
     log.info(`启用平台: ${config.enabledPlatforms.join(", ")}`);
-    const sessionManager = new SessionManager(config.claudeWorkDir);
+    const sessionManager = new SessionManager(startupCwd, config.claudeWorkDir);
     // CLI 工具（Codex/CodeBuddy）的 session 是进程级别的，服务重启后一定无效。
     // 启动时仅清除 CLI 工具自己的 sessionId，保留 Claude 的持久上下文。
     sessionManager.clearAllCliSessionIds();
@@ -241,7 +245,7 @@ export async function main() {
     log.info(`Successfully initialized platforms: ${successfulPlatforms.join(", ")}`);
     // Send notification only to successfully initialized platforms
     for (const platform of successfulPlatforms) {
-        const startupMsg = buildStartupMessage(platform, APP_VERSION, resolvePlatformAiCommand(config, platform), config.claudeWorkDir, sessionManager);
+        const startupMsg = buildStartupMessage(platform, APP_VERSION, resolvePlatformAiCommand(config, platform), startupCwd, sessionManager);
         await sendLifecycleNotification(platform, startupMsg).catch((err) => {
             log.warn(`Failed to send startup notification to ${platform}:`, err);
         });

package/dist/session/session-manager.d.ts

@@ -5,7 +5,11 @@ export declare class SessionManager {
     private convSessionMap;
     private defaultWorkDir;
     private saveTimer;
-    constructor(defaultWorkDir: string);
+    /**
+     * @param defaultWorkDir 本次进程的默认工作目录（通常为进程启动时的 cwd）
+     * @param previousDefaultWorkDir 旧版本/旧配置使用的默认目录（用于迁移仍跟随默认值的会话）
+     */
+    constructor(defaultWorkDir: string, previousDefaultWorkDir?: string);
     getSessionIdForConv(userId: string, convId: string, toolId: ToolId): string | undefined;
     setSessionIdForConv(userId: string, convId: string, toolId: ToolId, sessionId: string): void;
     /** 清除指定会话的 sessionId（用于 SDK 报 "No conversation found" 时） */

package/dist/session/session-manager.js

@@ -30,9 +30,13 @@ export class SessionManager {
     convSessionMap = new Map();
     defaultWorkDir;
     saveTimer = null;
-    constructor(defaultWorkDir) {
+    /**
+     * @param defaultWorkDir 本次进程的默认工作目录（通常为进程启动时的 cwd）
+     * @param previousDefaultWorkDir 旧版本/旧配置使用的默认目录（用于迁移仍跟随默认值的会话）
+     */
+    constructor(defaultWorkDir, previousDefaultWorkDir) {
         this.defaultWorkDir = defaultWorkDir;
-        this.load();
+        this.load(previousDefaultWorkDir);
     }
     getSessionIdForConv(userId, convId, toolId) {
         const s = this.sessions.get(userId);
@@ -234,12 +238,16 @@ export class SessionManager {
             throw new Error(`目录不存在: \`${resolved}\``);
         return realpath(resolved);
     }
-    load() {
+    load(previousDefaultWorkDir) {
         try {
             if (existsSync(SESSIONS_FILE)) {
                 const data = JSON.parse(readFileSync(SESSIONS_FILE, 'utf-8'));
                 for (const [k, v] of Object.entries(data)) {
                     if (v && typeof v.workDir === 'string') {
+                        // 如果该会话目录等于旧默认目录，则迁移到新的默认目录（认为用户没有手动 /cd 过）
+                        if (previousDefaultWorkDir && v.workDir === previousDefaultWorkDir) {
+                            v.workDir = this.defaultWorkDir;
+                        }
                         if (!v.activeConvId)
                             v.activeConvId = randomBytes(4).toString('hex');
                         if (!v.sessionIds)

package/dist/shared/ai-task.js

@@ -35,6 +35,7 @@ export function runAITask(deps, ctx, prompt, toolAdapter, platformAdapter) {
         let wasThinking = false;
         let thinkingText = '';
         let currentSessionId = ctx.sessionId;
+        let hadSessionInvalid = false;
         let activeHandle = null;
         const toolLines = [];
         const minDelta = platformAdapter.minContentDeltaChars ?? 0;
@@ -105,8 +106,11 @@ export function runAITask(deps, ctx, prompt, toolAdapter, platformAdapter) {
                         log.info(`[AITask] No threadId or convId, sessionId not persisted to storage`);
                 },
                 onSessionInvalid: () => {
+                    hadSessionInvalid = true;
                     if (ctx.convId)
                         sessionManager.clearSessionForConv(ctx.userId, ctx.convId, aiCommand);
+                    const ok = sessionManager.newSession(ctx.userId);
+                    log.info(`[AITask] Session invalid for user ${ctx.userId}, aiCommand=${aiCommand}; auto /new applied, ok=${ok}`);
                 },
                 onThinking: (t) => {
                     if (!firstContentLogged) {
@@ -208,8 +212,11 @@ export function runAITask(deps, ctx, prompt, toolAdapter, platformAdapter) {
                     else if (aiCommand === 'codex' && isUsageLimitError(error)) {
                         log.info(`Keeping codex session for user ${ctx.userId} after usage limit error`);
                     }
+                    const friendlyError = hadSessionInvalid
+                        ? '当前 Claude 会话已失效，已自动执行 /new 重置会话，请重新发送刚才的问题。'
+                        : error;
                     try {
-                        await platformAdapter.sendError(error);
+                        await platformAdapter.sendError(friendlyError);
                     }
                     catch (err) {
                         log.error('Failed to send error:', err);

package/package.json

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