codex-to-im 1.0.22 → 1.0.26

package/docs/codex-to-im-prd.md

@@ -8,7 +8,7 @@
 
 配套技术设计见：
 
-- [D:/codex/Claude-to-IM-skill/docs/codex-to-im-shared-thread-design.md](D:/codex/Claude-to-IM-skill/docs/codex-to-im-shared-thread-design.md)
+- [codex-to-im-shared-thread-design.md](./codex-to-im-shared-thread-design.md)
 
 ## 2. 产品定位
 

package/docs/codex-to-im-shared-thread-design.md

@@ -137,15 +137,15 @@ flowchart LR
 
 当前代码中已经存在可复用的基础能力：
 
-- [D:/codex/Claude-to-IM-skill/src/codex-provider.ts](D:/codex/Claude-to-IM-skill/src/codex-provider.ts)
+- [src/codex-provider.ts](../src/codex-provider.ts)
   - 已具备 `sdkSessionId` 复用逻辑
   - 已使用 `startThread()` / `resumeThread()`
-- [D:/codex/Claude-to-IM-skill/src/store.ts](D:/codex/Claude-to-IM-skill/src/store.ts)
+- [src/store.ts](../src/store.ts)
   - 已能持久化 session、binding、message、lock
   - binding 已保存 `sdkSessionId`
-- [D:/codex/Claude-to-IM-skill/src/lib/bridge/channel-router.ts](D:/codex/Claude-to-IM-skill/src/lib/bridge/channel-router.ts)
+- [src/lib/bridge/channel-router.ts](../src/lib/bridge/channel-router.ts)
   - 已支持 chat 到 session 的自动解析与绑定
-- [D:/codex/Claude-to-IM-skill/src/lib/bridge/bridge-manager.ts](D:/codex/Claude-to-IM-skill/src/lib/bridge/bridge-manager.ts)
+- [src/lib/bridge/bridge-manager.ts](../src/lib/bridge/bridge-manager.ts)
   - 已支持 `/new`、`/thread`、`/status`、`/sessions`、`/stop`
 
 当前缺失的不是桥接基础设施，而是“桌面真实会话接管”的这一层：
@@ -558,10 +558,10 @@ sequenceDiagram
 
 ### 本地依据
 
-- [D:/codex/Claude-to-IM-skill/node_modules/@openai/codex-sdk/README.md](D:/codex/Claude-to-IM-skill/node_modules/@openai/codex-sdk/README.md)
-- [D:/codex/Claude-to-IM-skill/src/codex-provider.ts](D:/codex/Claude-to-IM-skill/src/codex-provider.ts)
-- [D:/codex/Claude-to-IM-skill/src/store.ts](D:/codex/Claude-to-IM-skill/src/store.ts)
-- [D:/codex/Claude-to-IM-skill/src/lib/bridge/channel-router.ts](D:/codex/Claude-to-IM-skill/src/lib/bridge/channel-router.ts)
+- [node_modules/@openai/codex-sdk/README.md](../node_modules/@openai/codex-sdk/README.md)
+- [src/codex-provider.ts](../src/codex-provider.ts)
+- [src/store.ts](../src/store.ts)
+- [src/lib/bridge/channel-router.ts](../src/lib/bridge/channel-router.ts)
 - `%USERPROFILE%/.codex/sessions/**/*.jsonl` 的本地实测样本
 
 ### 官方资料

package/docs/install-windows.md

@@ -4,10 +4,7 @@
 
 `codex-to-im` 当前采用的是 **单 npm 包 + 本地 Web 工作台 + 本地后台 bridge** 的部署方案。
 
-补充说明：当前版本不是从零开始的新工程，而是在以下两个已有项目基础上整理和改造而来：
-
-- `Claude-to-IM`
-- `Claude-to-IM-skill`
+补充说明：当前版本不是从零开始的新工程，而是在旧桥接原型基础上整理和演进而来。
 
 核心形态如下：
 
@@ -19,7 +16,6 @@
   - `dist/daemon.mjs` 负责 bridge
 - 运行方式：本地 Node.js detached 子进程，不依赖当前命令窗口常驻
 - 配置目录：`%USERPROFILE%\\.codex-to-im\\`
-- 兼容目录：如果机器上已有旧数据，会回落到 `%USERPROFILE%\\.claude-to-im\\`
 
 这意味着当前推荐的部署方式不是“clone 仓库后让用户手动跑脚本”，而是：
 
@@ -278,15 +274,15 @@ Web 工作台现在只展示自动启动状态；真正的启用和关闭请使
 - `runtime\status.json`
 - `runtime\ui-server.json`
 
-### 7.2 旧目录兼容
+### 7.2 排查提示
 
-如果目标机上已经存在旧安装数据，程序会自动回落到：
+当前版本只读取：
 
 ```text
-%USERPROFILE%\.claude-to-im\
+%USERPROFILE%\.codex-to-im\
 ```
 
-所以安装或排查时，需要先确认当前实际使用的是哪一个 home 目录。
+如果机器上仍然存在旧版本遗留的 home 目录，那只是历史残留，不再被当前版本读取。
 
 ## 8. 安装给别的主机时的建议
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-to-im",
-  "version": "1.0.22",
+  "version": "1.0.26",
   "description": "Installable Codex-to-IM bridge with local setup UI and background service",
   "license": "MIT",
   "homepage": "https://github.com/zhangle1987/codex-to-im#readme",

package/references/troubleshooting.md

@@ -36,7 +36,7 @@
 
 **Steps**:
 
-1. Check `~/.codex-to-im/logs/bridge.log` or `~/.claude-to-im/logs/bridge.log`
+1. Check `~/.codex-to-im/logs/bridge.log`
 2. Look for Feishu error `99991672`
 3. If the error mentions `cardkit:card:write`, add and publish the missing Feishu permissions:
    - `cardkit:card:write`

package/scripts/daemon.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 set -euo pipefail
-CTI_HOME="${CTI_HOME:-$HOME/.claude-to-im}"
+CTI_HOME="${CTI_HOME:-$HOME/.codex-to-im}"
 SKILL_DIR="$(cd "$(dirname "$0")/.." && pwd)"
 PID_FILE="$CTI_HOME/runtime/bridge.pid"
 STATUS_FILE="$CTI_HOME/runtime/status.json"
@@ -21,11 +21,11 @@ ensure_built() {
     if [ -n "$newest_src" ]; then
       need_build=1
     fi
-    # Also check if node_modules/claude-to-im was updated (npm update)
-    # — its code is bundled into dist, so changes require a rebuild
-    if [ "$need_build" = "0" ] && [ -d "$SKILL_DIR/node_modules/claude-to-im/src" ]; then
-      local newest_dep
-      newest_dep=$(find "$SKILL_DIR/node_modules/claude-to-im/src" -name '*.ts' -newer "$SKILL_DIR/dist/daemon.mjs" 2>/dev/null | head -1)
+    # Also check if node_modules/codex-to-im was updated (npm update)
+    # — its code is bundled into dist, so changes require a rebuild
+    if [ "$need_build" = "0" ] && [ -d "$SKILL_DIR/node_modules/codex-to-im/src" ]; then
+      local newest_dep
+      newest_dep=$(find "$SKILL_DIR/node_modules/codex-to-im/src" -name '*.ts' -newer "$SKILL_DIR/dist/daemon.mjs" 2>/dev/null | head -1)
       if [ -n "$newest_dep" ]; then
         need_build=1
       fi

package/scripts/doctor.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 set -euo pipefail
-CTI_HOME="$HOME/.claude-to-im"
+CTI_HOME="$HOME/.codex-to-im"
 CONFIG_FILE="$CTI_HOME/config.env"
 PID_FILE="$CTI_HOME/runtime/bridge.pid"
 LOG_FILE="$CTI_HOME/logs/bridge.log"
@@ -167,7 +167,7 @@ if [ "$CTI_RUNTIME" = "claude" ] || [ "$CTI_RUNTIME" = "auto" ]; then
   if [ "$HAS_ANTHROPIC_CONFIG" = "true" ]; then
     check "ANTHROPIC_* vars in config.env (third-party API provider)" 0
 
-    PLIST_FILE="$HOME/Library/LaunchAgents/com.claude-to-im.bridge.plist"
+    PLIST_FILE="$HOME/Library/LaunchAgents/com.codex-to-im.bridge.plist"
 
     # On macOS, verify the launchd plist also has the vars
     if [ "$(uname -s)" = "Darwin" ] && [ -f "$PLIST_FILE" ]; then

package/scripts/supervisor-macos.sh

@@ -2,7 +2,7 @@
 # macOS supervisor — launchd-based process management.
 # Sourced by daemon.sh; expects CTI_HOME, SKILL_DIR, PID_FILE, STATUS_FILE, LOG_FILE.
 
-LAUNCHD_LABEL="com.claude-to-im.bridge"
+LAUNCHD_LABEL="com.codex-to-im.bridge"
 PLIST_DIR="$HOME/Library/LaunchAgents"
 PLIST_FILE="$PLIST_DIR/$LAUNCHD_LABEL.plist"
 

package/scripts/supervisor-windows.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-  Windows daemon manager for claude-to-im bridge.
+  Windows daemon manager for codex-to-im bridge.
 
 .DESCRIPTION
   Manages the bridge process on Windows.
@@ -28,7 +28,7 @@ param(
 $ErrorActionPreference = 'Stop'
 
 # ── Paths ──
-$CtiHome    = if ($env:CTI_HOME) { $env:CTI_HOME } else { Join-Path $env:USERPROFILE '.claude-to-im' }
+$CtiHome    = if ($env:CTI_HOME) { $env:CTI_HOME } else { Join-Path $env:USERPROFILE '.codex-to-im' }
 $SkillDir   = Split-Path -Parent (Split-Path -Parent $PSCommandPath)
 $RuntimeDir = Join-Path $CtiHome 'runtime'
 $PidFile    = Join-Path $RuntimeDir 'bridge.pid'
@@ -38,7 +38,7 @@ $ErrLogFile = Join-Path (Join-Path $CtiHome 'logs') 'bridge.stderr.log'
 $DaemonMjs  = Join-Path (Join-Path $SkillDir 'dist') 'daemon.mjs'
 $ConfigFile = Join-Path $CtiHome 'config.env'
 
-$ServiceName = 'ClaudeToIMBridge'
+$ServiceName = 'CodexToIMBridge'
 
 # ── Helpers ──
 
@@ -169,7 +169,7 @@ function Install-WinSWService {
     $xmlPath = Join-Path $SkillDir "$ServiceName.xml"
     $configEnv = Get-ConfigEnvironment
 
-    # Run as current user so the service can access ~/.claude-to-im and Codex login state
+    # Run as current user so the service can access ~/.codex-to-im and Codex login state
     $currentUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
     Write-Host "Service will run as: $currentUser"
     $cred = Get-Credential -UserName $currentUser -Message "Enter password for '$currentUser' (required for Windows Service logon)"
@@ -179,8 +179,8 @@ function Install-WinSWService {
     $xml = @"
 <service>
   <id>$ServiceName</id>
-  <name>Claude-to-IM Bridge</name>
-  <description>Claude-to-IM bridge daemon</description>
+  <name>Codex-to-IM Bridge</name>
+  <description>codex-to-im bridge daemon</description>
   <executable>$nodePath</executable>
   <arguments>$DaemonMjs</arguments>
   <workingdirectory>$SkillDir</workingdirectory>
@@ -229,7 +229,7 @@ function Install-NSSMService {
     $nodePath = Get-NodePath
     $configEnv = Get-ConfigEnvironment
 
-    # Run as current user so the service can access ~/.claude-to-im and Codex login state
+    # Run as current user so the service can access ~/.codex-to-im and Codex login state
     $currentUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
     Write-Host "Service will run as: $currentUser"
     $cred = Get-Credential -UserName $currentUser -Message "Enter password for '$currentUser' (required for Windows Service logon)"
@@ -242,7 +242,7 @@ function Install-NSSMService {
     & $NSSMPath set $ServiceName AppStderr $LogFile
     & $NSSMPath set $ServiceName AppStdoutCreationDisposition 4
     & $NSSMPath set $ServiceName AppStderrCreationDisposition 4
-    & $NSSMPath set $ServiceName Description "Claude-to-IM bridge daemon"
+    & $NSSMPath set $ServiceName Description "codex-to-im bridge daemon"
     & $NSSMPath set $ServiceName AppRestartDelay 10000
     $envArgs = @(
         "USERPROFILE=$env:USERPROFILE",

package/config.env.example

@@ -1,138 +0,0 @@
-# Codex-to-IM legacy env snapshot / migration reference
-# The primary runtime config is now ~/.codex-to-im/config.v2.json and is
-# normally managed from the Web workbench.
-# This file is kept only for:
-#   1. migrating old single-instance setups to v2
-#   2. compatibility snapshots / old tooling fallback
-# It no longer fully represents multi-instance channel configuration.
-
-# Runtime backend: claude | codex | auto
-#   claude — uses Claude Code CLI + @anthropic-ai/claude-agent-sdk
-#   codex  (default) — uses @openai/codex-sdk (auth: codex auth login, or OPENAI_API_KEY)
-#   auto   — tries Claude first, falls back to Codex if CLI not found
-CTI_RUNTIME=codex
-
-# Legacy provider enable list (still used by non-v2 providers such as
-# telegram / discord / qq; Feishu and Weixin are now configured as channel
-# instances in config.v2.json).
-CTI_ENABLED_CHANNELS=feishu
-
-# Default workspace root for `/new proj1` style project creation.
-# When unset, codex-to-im falls back to `~/cx2im`
-# and expands it per OS (Windows/macOS/Linux).
-# CTI_DEFAULT_WORKSPACE_ROOT=/path/to/your/workspace
-
-# Default model (optional — inherits from runtime's own default if not set)
-# CTI_DEFAULT_MODEL=
-
-# Default mode (code, plan, ask)
-CTI_DEFAULT_MODE=code
-
-# Number of recent messages returned by /history
-# CTI_HISTORY_MESSAGE_LIMIT=8
-
-# ── Claude CLI path (optional) ──
-# Override if you have multiple `claude` versions in PATH, or the daemon
-# picks the wrong one (e.g. an npm-installed 1.x instead of the native 2.x).
-# CTI_CLAUDE_CODE_EXECUTABLE=/path/to/claude
-
-# ── Third-party API provider (optional) ──
-# If you use Claude through a third-party API provider (not the default
-# Anthropic API), set these so the daemon forwards them to the CLI subprocess.
-# They are automatically passed through in both inherit and strict env modes.
-# All ANTHROPIC_* vars in this file are forwarded to the launchd/setsid daemon.
-# ANTHROPIC_API_KEY=your-third-party-api-key
-# ANTHROPIC_BASE_URL=https://your-api-provider.com/v1
-# ANTHROPIC_AUTH_TOKEN=your-auth-token
-
-# ── Codex auth (optional — only if not using `codex auth login`) ──
-# Priority: CTI_CODEX_API_KEY > CODEX_API_KEY > OPENAI_API_KEY
-# CTI_CODEX_API_KEY=
-# CTI_CODEX_BASE_URL=
-# Allow Codex to run when the selected project directory is not inside a trusted Git repo.
-# This project defaults it to true so first-time setup works more smoothly.
-CTI_CODEX_SKIP_GIT_REPO_CHECK=true
-# Default filesystem permission mode for Codex threads created by codex-to-im.
-# Options: read-only | workspace-write | danger-full-access
-CTI_CODEX_SANDBOX_MODE=workspace-write
-# Default reasoning effort for Codex.
-# Official SDK/runtime levels: minimal | low | medium | high | xhigh
-# IM aliases also support: 1=minimal, 2=low, 3=medium, 4=high, 5=xhigh
-CTI_CODEX_REASONING_EFFORT=medium
-
-# ── Web 控制台访问 ──
-# 默认仅允许本机访问本地工作台。开启后，局域网设备访问时需要先输入 token。
-# 可以在 Web 工作台里直接勾选并自动生成 token。
-# CTI_UI_ALLOW_LAN=false
-# CTI_UI_ACCESS_TOKEN=your-random-access-token
-
-# ── Telegram ──
-CTI_TG_BOT_TOKEN=your-telegram-bot-token
-# Chat ID for authorization (at least one of CHAT_ID or ALLOWED_USERS is required)
-# Get it: send a message to the bot, then visit https://api.telegram.org/botYOUR_TOKEN/getUpdates
-CTI_TG_CHAT_ID=your-chat-id
-# CTI_TG_ALLOWED_USERS=user_id_1,user_id_2
-
-# ── Discord ──
-# CTI_DISCORD_BOT_TOKEN=your-discord-bot-token
-# CTI_DISCORD_ALLOWED_USERS=user_id_1,user_id_2
-# CTI_DISCORD_ALLOWED_CHANNELS=channel_id_1
-# CTI_DISCORD_ALLOWED_GUILDS=guild_id_1
-
-# ── Feishu / Lark (legacy single-instance migration fields) ──
-# For new setups, add Feishu/Lark channel instances in the Web workbench and
-# choose the site there. These env vars are only used when migrating an old
-# single-instance setup into config.v2.json.
-# CTI_FEISHU_APP_ID=your-app-id
-# CTI_FEISHU_APP_SECRET=your-app-secret
-# CTI_FEISHU_SITE=feishu
-# CTI_FEISHU_ALLOWED_USERS=user_id_1,user_id_2
-# Enable streaming response cards in Feishu (default true).
-# Requires published Feishu permissions such as:
-#   - cardkit:card:write
-#   - cardkit:card:read
-#   - im:message:update
-# Current Codex runtime note: thinking/progress can update live, but
-# assistant body text may still arrive only at completion.
-# CTI_FEISHU_STREAMING_ENABLED=true
-# Use Markdown for text sent through the bridge, including normal replies,
-# shared-thread mirror messages, and system feedback such as /h or /status.
-# CTI_FEISHU_COMMAND_MARKDOWN_ENABLED=true
-
-# ── QQ ──
-# Required: obtain from https://q.qq.com/qqbot/openclaw
-# CTI_QQ_APP_ID=your-qq-app-id
-# CTI_QQ_APP_SECRET=your-qq-app-secret
-# Allowed users — comma-separated user_openid values (NOT QQ numbers)
-# CTI_QQ_ALLOWED_USERS=openid_1,openid_2
-# Image input — set to false if the underlying provider doesn't support image input
-# CTI_QQ_IMAGE_ENABLED=true
-# Max image size in MB (default 20)
-# CTI_QQ_MAX_IMAGE_SIZE=20
-
-# ── WeChat / 微信 (legacy single-instance migration fields) ──
-# For new setups, add Weixin channel instances in the Web workbench. These env
-# vars are only used when migrating an old single-instance setup into
-# config.v2.json.
-# No static token is required here. Use the QR login helper to add accounts:
-#   npm run weixin:login
-# Optional protocol overrides (normally leave unset)
-# CTI_WEIXIN_BASE_URL=https://ilinkai.weixin.qq.com
-# CTI_WEIXIN_CDN_BASE_URL=https://novac2c.cdn.weixin.qq.com/c2c
-# Enable inbound media download/processing for image/file/video messages.
-# Voice messages do not use raw audio download/transcription here: the bridge
-# only accepts WeChat-provided speech-to-text text and otherwise returns an error.
-# (default false for safety in CLI setups)
-# CTI_WEIXIN_MEDIA_ENABLED=false
-# Use Markdown for text sent through the bridge, including normal replies,
-# shared-thread mirror messages, and system feedback such as /h or /status.
-# Default is false for WeChat.
-# CTI_WEIXIN_COMMAND_MARKDOWN_ENABLED=false
-
-# ── Permission ──
-# Auto-approve all tool permission requests without user confirmation.
-# Useful for channels that lack interactive permission UI (e.g. Feishu
-# WebSocket long-connection mode, where there is no HTTP webhook to
-# render clickable approve/deny buttons).
-# ⚠️  Only enable this in trusted, access-controlled environments.
-# CTI_AUTO_APPROVE=true