codex-to-im 0.1.2 → 0.1.6

package/docs/install-windows.md

@@ -141,6 +141,15 @@ http://127.0.0.1:4781
 
 如果 `4781` 已被占用，程序会自动查找一个可用端口，并在启动时把实际地址打印到命令行。
 
+默认情况下，Web 工作台只允许本机访问。
+
+如果你要在手机或局域网其他设备上打开配置页，可以在“配置”页里勾选“允许局域网访问 Web 控制台”。开启后：
+
+- 工作台会显示当前可用的局域网地址
+- 工作台会显示访问 token
+- 局域网设备访问时会先看到登录页，输入 token 后才能进入工作台
+- 也可以直接复制工作台里的局域网登录链接，链接中会附带 `?token=...`
+
 如果之后忘记了当前 Web 地址，可以执行：
 
 ```powershell
@@ -167,22 +176,34 @@ codex-to-im stop
    - 推荐：`codex`
 2. 设置默认工作目录
 3. 设置 `/history` 默认返回条数（可选）
-4. 如果目标目录不是 Codex 已信任的 Git 仓库，可勾选“允许在未信任 Git 目录运行 Codex”
-5. 勾选要启用的通道
+4. 设置默认工作空间
+   - 用于 `/new proj1` 这类相对项目名
+   - 留空时自动回退到 `~/cx2im`，并按当前系统展开为实际路径
+5. 选择 Codex 文件系统权限
+   - 默认推荐 `workspace-write`
+6. 选择 Codex 思考级别
+   - 默认推荐 `medium`
+   - 官方仅有 5 个级别：`minimal`、`low`、`medium`、`high`、`xhigh`
+   - 如果这台机器就是你自己的本地开发机，希望 `codex-to-im` 直接承担更强的编码执行能力，建议改成：
+     - 文件系统权限：`danger-full-access`
+     - 思考级别：`xhigh`
+7. 如果目标目录不是 Codex 已信任的 Git 仓库，可勾选“允许在未信任 Git 目录运行 Codex”
+8. 如果要从局域网设备访问配置页，可勾选“允许局域网访问 Web 控制台”
+9. 勾选要启用的通道
    - 飞书：勾选 `启用飞书`
    - 微信：勾选 `启用微信`
-6. 飞书场景下填写：
+10. 飞书场景下填写：
    - `App ID`
    - `App Secret`
    - `Domain`
    - `Allowed Users` 可选
    - `启用飞书流式响应卡片` 可选
-7. 微信场景下点击：
+11. 微信场景下点击：
    - `开始微信扫码`
-8. 点击测试
+12. 点击测试
    - 飞书：`测试飞书凭据`
    - Codex：`测试 Codex`
-9. 点击：
+13. 点击：
     - `启动 Bridge`
 
 说明：
@@ -196,7 +217,24 @@ codex-to-im stop
 - 缺权限时，`logs\\bridge.log` 里通常会出现 `99991672` 和 `cardkit:card:write`。
 - 另外，当前 `codex` runtime 下正文通常不是逐字流式输出；更常见的效果是先显示 `Thinking / Tool Progress`，正文在回答完成时一次性落到卡片里。
 - IM 里发送 `/history` 可以查看当前会话最近 N 条消息，N 由“基础配置”中的返回条数控制。
+- IM 里发送 `/history` 默认返回整理后的摘要；发送 `/history raw` 才会查看最近 N 条原始消息。
+- IM 里发送 `/reasoning high` 或 `/reasoning 4` 之类命令，可以只对当前会话覆盖思考级别。
+- IM 里发送 `/thread 0` 会进入临时草稿线程，适合短讨论或临时想法。
+- “通道”页里可以分别控制“命令反馈使用 Markdown”：
+  - 飞书默认开启
+  - 微信默认关闭
+  - 只影响 `/h`、`/status`、`/threads` 这类系统反馈，不影响 Codex 原始回复
+- IM 里也支持一组短命令别名：
+- `/` / `/status` 当前会话
+- `/h` / `/help` 帮助
+- `/t` / `/threads` 最近桌面会话，`/t 1` / `/thread 1` 接管
+- `/n proj1` / `/new proj1` 新建项目会话
+- `/m` / `/mode` 查看或切换模式，可选 `code` / `plan` / `ask`
+- `/r` / `/reasoning` 查看或切换思考级别，也支持 `1|2|3|4|5`
+- `/his` / `/history` 历史摘要，`/his raw` / `/history raw` 原始记录
+- `/t 0` / `/thread 0` 临时草稿线程
 - 如果 `测试 Codex` 失败，优先检查当前 Windows 用户下是否已经存在可用的 Codex 登录态或 API Key。
+- 如果开启了局域网访问，建议直接从本机工作台复制局域网登录链接，再发给手机或其他设备打开。
 
 ## 7. 目标机上的目录说明
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-to-im",
-  "version": "0.1.2",
+  "version": "0.1.6",
   "description": "Installable Codex-to-IM bridge with local setup UI and background service",
   "license": "MIT",
   "type": "module",
@@ -20,6 +20,7 @@
     "codex-to-im": "dist/cli.mjs"
   },
   "scripts": {
+    "postinstall": "node scripts/patch-codex-sdk-windows-hide.js",
     "build": "node scripts/build.js",
     "typecheck": "tsc --noEmit",
     "dev": "tsx src/main.ts",

package/scripts/patch-codex-sdk-windows-hide.js

@@ -0,0 +1,83 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const PATCH_MARKER = 'windowsHide: process.platform === "win32"';
+const SUPPORTED_SDK_VERSION = /^0\.110\.\d+$/;
+
+function logSkip(message) {
+  console.warn(`[postinstall] ${message}`);
+}
+
+function resolveSdkPaths() {
+  const packageRoot = path.join(process.cwd(), 'node_modules', '@openai', 'codex-sdk');
+  const packageJsonPath = path.join(packageRoot, 'package.json');
+  const entryPath = path.join(packageRoot, 'dist', 'index.js');
+  if (!fs.existsSync(packageJsonPath) || !fs.existsSync(entryPath)) {
+    return null;
+  }
+  return { packageJsonPath, entryPath };
+}
+
+function readSdkVersion(packageJsonPath) {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    return typeof pkg.version === 'string' ? pkg.version : null;
+  } catch {
+    return null;
+  }
+}
+
+function applyPatch(filePath) {
+  const source = fs.readFileSync(filePath, 'utf-8');
+  if (source.includes(PATCH_MARKER)) {
+    console.log('[postinstall] codex-sdk windowsHide patch already applied');
+    return false;
+  }
+
+  const patched = source.replace(
+    /const child = spawn\(this\.executablePath, commandArgs, \{\s*env,\s*signal: args\.signal\s*\}\);/,
+    `const child = spawn(this.executablePath, commandArgs, {
+      env,
+      windowsHide: process.platform === "win32",
+      signal: args.signal
+    });`,
+  );
+
+  if (patched === source) {
+    throw new Error(`Unable to locate Codex SDK spawn block in ${filePath}`);
+  }
+
+  fs.writeFileSync(filePath, patched, 'utf-8');
+  console.log(`[postinstall] patched codex-sdk windowsHide in ${path.relative(process.cwd(), filePath)}`);
+  return true;
+}
+
+if (process.platform !== 'win32') {
+  console.log('[postinstall] non-Windows platform detected, skipping codex-sdk windowsHide patch');
+  process.exit(0);
+}
+
+const sdkPaths = resolveSdkPaths();
+if (!sdkPaths) {
+  console.log('[postinstall] @openai/codex-sdk not installed, skipping windowsHide patch');
+  process.exit(0);
+}
+
+const sdkVersion = readSdkVersion(sdkPaths.packageJsonPath);
+if (!sdkVersion) {
+  logSkip('unable to read @openai/codex-sdk version, skipping windowsHide patch');
+  process.exit(0);
+}
+
+if (!SUPPORTED_SDK_VERSION.test(sdkVersion)) {
+  logSkip(`unsupported @openai/codex-sdk version ${sdkVersion}; skipping windowsHide patch`);
+  process.exit(0);
+}
+
+try {
+  applyPatch(sdkPaths.entryPath);
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  logSkip(`failed to patch codex-sdk windowsHide (${message}); install will continue and the Windows console may still appear`);
+  process.exit(0);
+}