claude-codex-wechat 0.1.6 → 0.1.8

package/README.md

@@ -83,11 +83,21 @@ pnpm install
 可用命令：
 
 - `claude-codex-wechat start`
-  - 前台启动 daemon
-- `claude-codex-wechat init`
-  - 写默认配置到 `~/.claude-codex-wechat/config.json`
+  - 后台启动服务（未安装则自动注册系统服务），默认命令
+- `claude-codex-wechat stop`
+  - 停止后台服务
+- `claude-codex-wechat restart`
+  - 重启后台服务
+- `claude-codex-wechat status`
+  - 查看运行状态
+- `claude-codex-wechat logs` / `tail`
+  - 打印 / 实时跟随日志
 - `claude-codex-wechat doctor`
   - 检查配置、前端产物、`claude`/`codex` 可执行文件
+- `claude-codex-wechat init`
+  - 写默认配置到 `~/.claude-codex-wechat/config.json`
+- `claude-codex-wechat uninstall`
+  - 卸载后台服务
 - `claude-codex-wechat print-config`
   - 打印当前配置文件
 - `claude-codex-wechat help`
@@ -178,35 +188,24 @@ pnpm build
 
 ## 生产运行
 
-生产态通常按下面方式运行：
+安装后直接后台启动即可，`start` 会把当前 CLI 注册成操作系统服务并拉起：
 
 ```bash
-claude-codex-wechat start
+claude-codex-wechat init      # 首次：写配置，填好 token / accountId
+claude-codex-wechat start     # 后台启动（自动安装服务）
+claude-codex-wechat status    # 查看状态
 ```
 
-注意：
-
-- 这是前台进程
-- npm 本身不负责守护
-- 长期常驻建议交给进程管理器
-- 如果默认端口已被本程序的后台服务占用，`start` 会先停掉后台服务，再以前台模式启动
-- 如果端口被别的进程占用，`start` 会直接报出占用 PID 和命令，不会强杀陌生进程
-
-### 安装后后台运行
-
-参考 `happier` 的方式，这个仓库现在提供 `service` 命令，把当前 CLI 注册成操作系统服务，而不是在 Node 进程里自己 daemonize。
-
-常用命令：
+常用管理命令：
 
 ```bash
-claude-codex-wechat service install
-claude-codex-wechat service start
-claude-codex-wechat service restart
-claude-codex-wechat service status
-claude-codex-wechat service logs
-claude-codex-wechat service tail
-claude-codex-wechat service stop
-claude-codex-wechat service uninstall
+claude-codex-wechat start      # 后台启动 / 启动已安装服务
+claude-codex-wechat restart    # 重启
+claude-codex-wechat status     # 状态
+claude-codex-wechat logs       # 最近日志
+claude-codex-wechat tail       # 实时日志
+claude-codex-wechat stop       # 停止
+claude-codex-wechat uninstall  # 卸载服务
 ```
 
 当前支持：
@@ -214,73 +213,7 @@ claude-codex-wechat service uninstall
 - macOS：`launchd`（`~/Library/LaunchAgents/`）
 - Linux：`systemd --user`（`~/.config/systemd/user/`）
 
-推荐安装后直接这样：
-
-```bash
-claude-codex-wechat init
-claude-codex-wechat service install
-claude-codex-wechat service status
-```
-
-### pm2
-
-```bash
-npm install -g pm2
-pm2 start claude-codex-wechat --name ccwx -- start
-pm2 logs ccwx
-pm2 restart ccwx
-pm2 startup && pm2 save
-```
-
-### systemd
-
-示例：
-
-```ini
-[Unit]
-Description=claude-codex-wechat bridge daemon
-After=network.target
-
-[Service]
-Type=simple
-User=youruser
-Environment=BRIDGE_PORT=8787
-ExecStart=/usr/bin/claude-codex-wechat start
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=multi-user.target
-```
-
-### launchd
-
-示例：
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.claude-codex-wechat</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>/opt/homebrew/bin/claude-codex-wechat</string>
-    <string>start</string>
-  </array>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>BRIDGE_PORT</key>
-    <string>8787</string>
-  </dict>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <true/>
-</dict>
-</plist>
-```
+服务会以 `KeepAlive` / `Restart=on-failure` 守护，崩溃后自动拉起，无需额外进程管理器。
 
 ## 发布 npm 包
 
@@ -347,7 +280,6 @@ HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ./release.sh
 
 这个脚本会：
 
-- 先检查 `npm whoami`
 - 先执行 `pnpm typecheck`
 - 再执行 `pnpm build`
 - 提交当前改动

package/dist/server/cli.js

@@ -3989,27 +3989,6 @@ async function resolveProviderCommands(providers) {
   };
 }
 
-// src/daemon/portGuard.ts
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-var execFileAsync = promisify(execFile);
-async function findListeningProcess(port) {
-  if (process.platform === "win32") return null;
-  try {
-    const { stdout } = await execFileAsync("lsof", ["-n", "-P", `-iTCP:${port}`, "-sTCP:LISTEN"]);
-    const lines = stdout.trim().split(/\r?\n/).filter(Boolean);
-    const record = lines.slice(1)[0];
-    if (!record) return null;
-    const parts = record.trim().split(/\s+/);
-    const command = parts[0] ?? "";
-    const pid = Number(parts[1] ?? "");
-    if (!command || !Number.isFinite(pid)) return null;
-    return { pid, command };
-  } catch {
-    return null;
-  }
-}
-
 // src/daemon/staticFrontend.ts
 import { readFileSync as readFileSync6 } from "node:fs";
 import { join as join9 } from "node:path";
@@ -4037,10 +4016,10 @@ import { mkdir as mkdir4, readFile as readFile6, rm as rm2, writeFile as writeFi
 import { homedir as homedir7 } from "node:os";
 import { dirname as dirname10, join as join10 } from "node:path";
 import { createReadStream } from "node:fs";
-import { execFile as execFile2, spawn as spawn6 } from "node:child_process";
+import { execFile, spawn as spawn6 } from "node:child_process";
 import { createInterface } from "node:readline";
-import { promisify as promisify2 } from "node:util";
-var execFileAsync2 = promisify2(execFile2);
+import { promisify } from "node:util";
+var execFileAsync = promisify(execFile);
 async function installService(context) {
   if (process.platform === "darwin") {
     const spec = buildLaunchdSpec(context);
@@ -4181,7 +4160,7 @@ function buildLaunchdSpec(context) {
   return {
     label: "com.claude-codex-wechat",
     plistPath: join10(homedir7(), "Library", "LaunchAgents", "com.claude-codex-wechat.plist"),
-    programArgs: [context.nodePath ?? process.execPath, context.cliEntrypointPath, "start"],
+    programArgs: [context.nodePath ?? process.execPath, context.cliEntrypointPath, "__daemon"],
     workingDirectory: homedir7(),
     stdoutPath: join10(stateDir, "logs", "service.stdout.log"),
     stderrPath: join10(stateDir, "logs", "service.stderr.log"),
@@ -4193,7 +4172,7 @@ function buildSystemdUserSpec(context) {
   return {
     unitName: "claude-codex-wechat.service",
     unitPath: join10(homedir7(), ".config", "systemd", "user", "claude-codex-wechat.service"),
-    execStart: [context.nodePath ?? process.execPath, context.cliEntrypointPath, "start"],
+    execStart: [context.nodePath ?? process.execPath, context.cliEntrypointPath, "__daemon"],
     workingDirectory: homedir7(),
     stdoutPath: join10(stateDir, "logs", "service.stdout.log"),
     stderrPath: join10(stateDir, "logs", "service.stderr.log"),
@@ -4292,10 +4271,10 @@ function quoteSystemdEnv(value) {
   return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
 }
 async function runLaunchctl(args) {
-  await execFileAsync2("launchctl", args);
+  await execFileAsync("launchctl", args);
 }
 async function runSystemctl(args) {
-  await execFileAsync2("systemctl", args);
+  await execFileAsync("systemctl", args);
 }
 async function ensureFileExists(path, errorCode) {
   if (!existsSync8(path)) throw new Error(errorCode);
@@ -4350,18 +4329,37 @@ async function main() {
     case "start":
       await cmdStart();
       return;
+    case "stop":
+      await cmdStop();
+      return;
+    case "restart":
+      await cmdRestart();
+      return;
+    case "status":
+      await cmdStatus();
+      return;
+    case "logs":
+      await cmdLogs();
+      return;
+    case "tail":
+      await cmdTail();
+      return;
     case "init":
       cmdInit();
       return;
     case "doctor":
       await cmdDoctor();
       return;
-    case "service":
-      await cmdService(process.argv.slice(3));
+    case "uninstall":
+      await cmdUninstall();
       return;
     case "print-config":
       cmdPrintConfig();
       return;
+    // 内部命令：service 文件实际拉起的前台 daemon 进程，不对外暴露。
+    case "__daemon":
+      await cmdDaemon();
+      return;
     case "help":
     case "--help":
     case "-h":
@@ -4377,24 +4375,38 @@ async function main() {
 async function cmdStart() {
   if (!existsSync9(webRoot)) {
     console.error(`\u627E\u4E0D\u5230\u524D\u7AEF\u6784\u5EFA\u4EA7\u7269: ${webRoot}`);
-    console.error("\u8BF7\u5148\u8FD0\u884C\u6784\u5EFA (pnpm build) \u540E\u518D\u542F\u52A8\uFF0C\u6216\u91CD\u65B0\u5B89\u88C5\u5B8C\u6574\u7684 npm \u5305\u3002");
+    console.error("\u8BF7\u91CD\u65B0\u5B89\u88C5\u5B8C\u6574\u7684 npm \u5305\u3002");
     process.exitCode = 1;
     return;
   }
   const context = createServiceContext();
-  const port = context.port ?? 8787;
-  const occupiedBy = await findListeningProcess(port);
-  if (occupiedBy) {
-    const serviceStatus = await readServiceStatus(context).catch(() => null);
-    if (serviceStatus?.installed && serviceStatus.running) {
-      console.log(`\u7AEF\u53E3 ${port} \u5DF2\u88AB\u540E\u53F0\u670D\u52A1\u5360\u7528\uFF0C\u5148\u505C\u6B62\u670D\u52A1\u518D\u4EE5\u524D\u53F0\u6A21\u5F0F\u542F\u52A8\u3002`);
-      await stopService(context);
-    } else {
-      console.error(`\u7AEF\u53E3 ${port} \u5DF2\u88AB\u5360\u7528: PID=${occupiedBy.pid} COMMAND=${occupiedBy.command}`);
-      console.error("\u8BF7\u5148\u505C\u6B62\u5360\u7528\u8FDB\u7A0B\uFF0C\u6216\u6539\u7528 `claude-codex-wechat service stop` \u505C\u6389\u540E\u53F0\u670D\u52A1\u3002");
-      process.exitCode = 1;
-      return;
-    }
+  const status = await readServiceStatus(context).catch(() => null);
+  const result = status?.installed ? await startService(context) : await installService(context);
+  printServiceStatus("service started", result);
+}
+async function cmdStop() {
+  const status = await stopService(createServiceContext());
+  printServiceStatus("service stopped", status);
+}
+async function cmdRestart() {
+  const status = await restartService(createServiceContext());
+  printServiceStatus("service restarted", status);
+}
+async function cmdStatus() {
+  const status = await readServiceStatus(createServiceContext());
+  printServiceStatus("service status", status);
+}
+async function cmdLogs() {
+  console.log(await readServiceLogs(createServiceContext()));
+}
+async function cmdTail() {
+  await tailServiceLogs(createServiceContext());
+}
+async function cmdDaemon() {
+  if (!existsSync9(webRoot)) {
+    console.error(`\u627E\u4E0D\u5230\u524D\u7AEF\u6784\u5EFA\u4EA7\u7269: ${webRoot}`);
+    process.exitCode = 1;
+    return;
   }
   await startDaemon({
     attachFrontend: attachStaticFrontend(webRoot)
@@ -4452,54 +4464,9 @@ function cmdPrintConfig() {
   }
   console.log(readFileSync7(configPath, "utf8"));
 }
-async function cmdService(args) {
-  const action = args[0] ?? "status";
-  const context = createServiceContext();
-  switch (action) {
-    case "install": {
-      const status = await installService(context);
-      printServiceStatus("service installed", status);
-      return;
-    }
-    case "start": {
-      const status = await startService(context);
-      printServiceStatus("service started", status);
-      return;
-    }
-    case "stop": {
-      const status = await stopService(context);
-      printServiceStatus("service stopped", status);
-      return;
-    }
-    case "restart": {
-      const status = await restartService(context);
-      printServiceStatus("service restarted", status);
-      return;
-    }
-    case "logs": {
-      console.log(await readServiceLogs(context));
-      return;
-    }
-    case "tail": {
-      await tailServiceLogs(context);
-      return;
-    }
-    case "uninstall": {
-      const status = await uninstallService(context);
-      printServiceStatus("service uninstalled", status);
-      return;
-    }
-    case "status": {
-      const status = await readServiceStatus(context);
-      printServiceStatus("service status", status);
-      return;
-    }
-    default:
-      console.error(`\u672A\u77E5 service \u5B50\u547D\u4EE4: ${action}
-`);
-      printUsage();
-      process.exitCode = 1;
-  }
+async function cmdUninstall() {
+  const status = await uninstallService(createServiceContext());
+  printServiceStatus("service uninstalled", status);
 }
 function createServiceContext() {
   return {
@@ -4530,18 +4497,20 @@ function printUsage() {
   claude-codex-wechat <command>
 
 \u547D\u4EE4:
-  start          \u542F\u52A8 daemon\uFF08\u9ED8\u8BA4\u547D\u4EE4\uFF0C\u524D\u53F0\u8FD0\u884C\uFF09
-  init           \u5728 ~/.claude-codex-wechat/ \u521B\u5EFA\u9ED8\u8BA4\u914D\u7F6E
+  start          \u540E\u53F0\u542F\u52A8\u670D\u52A1\uFF08\u672A\u5B89\u88C5\u5219\u81EA\u52A8\u5B89\u88C5\uFF0C\u9ED8\u8BA4\u547D\u4EE4\uFF09
+  stop           \u505C\u6B62\u540E\u53F0\u670D\u52A1
+  restart        \u91CD\u542F\u540E\u53F0\u670D\u52A1
+  status         \u67E5\u770B\u8FD0\u884C\u72B6\u6001
+  logs           \u6253\u5370\u6700\u8FD1\u65E5\u5FD7
+  tail           \u5B9E\u65F6\u8DDF\u968F\u65E5\u5FD7
   doctor         \u68C0\u67E5\u914D\u7F6E\u3001\u524D\u7AEF\u4EA7\u7269\u4E0E claude/codex \u53EF\u6267\u884C\u6587\u4EF6
-  service        \u7BA1\u7406\u540E\u53F0\u670D\u52A1\uFF08install/start/stop/restart/status/logs/tail/uninstall\uFF09
+  init           \u5728 ~/.claude-codex-wechat/ \u521B\u5EFA\u9ED8\u8BA4\u914D\u7F6E
+  uninstall      \u5378\u8F7D\u540E\u53F0\u670D\u52A1
   print-config   \u6253\u5370\u5F53\u524D\u914D\u7F6E\u6587\u4EF6\u5185\u5BB9
   help           \u663E\u793A\u672C\u5E2E\u52A9
 
 \u73AF\u5883\u53D8\u91CF:
   BRIDGE_PORT    \u76D1\u542C\u7AEF\u53E3\uFF08\u9ED8\u8BA4 8787\uFF09
-  BRIDGE_CONFIG  \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4 ~/.claude-codex-wechat/config.json\uFF09
-
-\u5E38\u9A7B\u8FD0\u884C\u8BF7\u7528\u8FDB\u7A0B\u7BA1\u7406\u5668\u6258\u7BA1\uFF0C\u4F8B\u5982:
-  pm2 start claude-codex-wechat -- start`);
+  BRIDGE_CONFIG  \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4 ~/.claude-codex-wechat/config.json\uFF09`);
 }
 await main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-codex-wechat",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": false,
   "type": "module",
   "bin": {