Skip to content

feat: add background dev mode and hide terminal#77

Open
techdou wants to merge 1 commit into
qiuzhi2046:mainfrom
techdou:main
Open

feat: add background dev mode and hide terminal#77
techdou wants to merge 1 commit into
qiuzhi2046:mainfrom
techdou:main

Conversation

@techdou

@techdou techdou commented Apr 4, 2026

Copy link
Copy Markdown

变更说明

本次 PR 主要包含两部分增强功能:

  1. 开发体验优化(后台运行模式)

    • 扩展了 scripts/qclaw-start.sh,新增 qclaw bg 命令以支持将开发服务器放到后台静默运行。
    • 在 macOS 下支持自动最小化/隐藏终端窗口,解决开发模式下终端常驻的问题。
    • 配套提供了 qclaw status(状态查询)、qclaw stop(停止服务)和 qclaw log(实时查看日志)等进程管理命令。
    • 更新了 .gitignore,防止误提交新的 .qclaw-dev.pid 文件。
  2. OpenClaw 升级与版本策略重构(动态版本支持)

    • 移除了原有的硬编码版本限制,使 Qclaw 能够更好地支持和适配不断发布的 OpenClaw 新版本。
    • 新增了 openclaw-version-adapter.ts,为升级流程引入了动态版本适配和校验能力。
    • 优化了 OpenClawUpgradeDialog.tsx 及底层的升级服务 (openclaw-upgrade-service.ts),现在可以更加平滑且安全地进行动态目标版本的升级。

变更类型

  • Bug 修复
  • 新功能
  • 重构 / 优化
  • 依赖更新
  • CI / 构建配置
  • 文档

影响范围

  • Electron 主进程 (electron/main/)
  • Preload / IPC 桥接 (electron/preload/)
  • React 渲染层 (src/)
  • 构建与打包配置
  • 文档

测试

  • 已通过 npm run typecheck
  • 已通过 npm test
  • 已在本地运行 npm run dev 验证功能

补充说明

  • 关于 qclaw bg,目前实现了基于 PID 文件的轻量级进程管理,并在 macOS 的 Terminal 和 iTerm2 测试过窗口自动隐藏。
  • 升级策略的改动兼容历史的降级逻辑和错误回退处理,相关核心逻辑均补充/修改了测试用例(位于 __tests__)。

Comment thread scripts/qclaw-start.sh
BOLD='\033[1m'
NC='\033[0m' # No Color

QCLAW_DIR="/Users/techdou/Project/Qclaw"

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • 这里直接硬编码路径了,所有 qclaw dev/bg/build/test/update 子命令都会失效

Comment on lines +12 to +15
* 允许升级到最新版本的标志
* 设为 true 后,高于 MAX_SUPPORTED 的版本不再被阻断
*/
export const ALLOW_LATEST_OPENCLAW_VERSION = true

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • 如果Openclaw发布了新版本,并做了破坏性更新,这会导致很多功能失效,导致软件非常不稳定

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants