tabby-bianbu-mcp 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `tabby-bianbu-mcp` will be documented in this file.
 
+## [0.5.2] - 2026-03-20
+
+### Fixed
+- remote push-upgrade now launches through a completion status file and waits for the installer to actually finish instead of trusting the first recovered health response
+- bundled `bianbu_agent_proxy.sh` now stages the next release before cutover and auto-rolls back to the previous install if activation fails, preventing half-upgraded broken remotes
+
+## [0.5.1] - 2026-03-19
+
+### Fixed
+- remote installer bootstrap/upgrade now defines `MAX_REQUEST_BODY_MB` in the shell layer, fixing the `未绑定的变量` failure during `write_env`
+
 ## [0.5.0] - 2026-03-19
 
 ### Added

package/README.md

@@ -62,8 +62,9 @@ When you click `Push latest installer + upgrade`:
 1. the plugin uploads the bundled installer to `installerRemotePath`
 2. it makes the script executable remotely
 3. it starts the installer in the background with `up` or `repair`
-4. it polls the MCP endpoint until health returns
-5. it shows the reported remote script version and server version
+4. the launcher writes a remote status file when the installer exits, including the exit code and log path
+5. the plugin waits for both installer completion and the expected remote health/version report before declaring success
+6. if the cutover fails, the installer auto-rolls back to the previous backup instead of leaving the remote half-upgraded
 
 This is the intended commercial-release upgrade path because the client and remote installer ship together.
 

package/assets/bianbu_agent_proxy.meta.json

@@ -1,9 +1,9 @@
 {
   "fileName": "bianbu_agent_proxy.sh",
   "sourceFile": "bianbu_agent_proxy.sh",
-  "scriptVersion": "1.2.0",
+  "scriptVersion": "1.2.1",
   "serverVersion": "1.2.0",
-  "sha256": "62c492d026fe0e16e007d9f0bbeeaedfcbd55b457ca357a8d137aff9a24ce594",
-  "bytes": 63063,
-  "generatedAt": "2026-03-19T11:00:34.100Z"
+  "sha256": "2579a96d69100625feef3ac205a877a3b742c62adec1db2ee284dcd3cc834fb4",
+  "bytes": 67586,
+  "generatedAt": "2026-03-20T04:59:13.343Z"
 }

package/assets/bianbu_agent_proxy.sh

@@ -4,7 +4,7 @@ set -Eeuo pipefail
 umask 077
 
 SCRIPT_NAME="$(basename "$0")"
-SCRIPT_VERSION="${SCRIPT_VERSION:-1.2.0}"
+SCRIPT_VERSION="${SCRIPT_VERSION:-1.2.1}"
 SERVER_VERSION="${SERVER_VERSION:-1.2.0}"
 APP_NAME="bianbu-mcp-server"
 INSTALL_ROOT="/opt/${APP_NAME}"
@@ -24,10 +24,17 @@ FILE_ROOT="${FILE_ROOT:-/home/${RUN_USER}}"
 ENABLE_PASSWORDLESS_SUDO="${ENABLE_PASSWORDLESS_SUDO:-false}"
 MAX_FILE_MB="${MAX_FILE_MB:-64}"
 MAX_COMMAND_OUTPUT_KB="${MAX_COMMAND_OUTPUT_KB:-256}"
+MAX_REQUEST_BODY_MB="${MAX_REQUEST_BODY_MB:-8}"
 TLS_CERT_FILE="${TLS_CERT_FILE:-}"
 TLS_KEY_FILE="${TLS_KEY_FILE:-}"
 MCP_TRANSPORT_MODE="${MCP_TRANSPORT_MODE:-stateless}"
 
+LAST_BACKUP_DIR=""
+ROLLBACK_ON_EXIT=0
+ROLLBACK_BACKUP_DIR=""
+ROLLBACK_STAGING_ROOT=""
+ROLLBACK_PREVIOUS_ROOT=""
+
 log() {
   printf '[%s] %s\n' "$SCRIPT_NAME" "$*"
 }
@@ -215,6 +222,7 @@ backup_existing_installation() {
   local backup_dir
   local has_content=0
 
+  LAST_BACKUP_DIR=""
   timestamp="$(date -u +%Y%m%dT%H%M%SZ)"
   backup_dir="${BACKUP_ROOT}/${timestamp}"
   run_as_root install -d -m 700 "$BACKUP_ROOT" "$backup_dir"
@@ -244,6 +252,7 @@ backup_existing_installation() {
   fi
 
   log "已创建备份: $backup_dir"
+  LAST_BACKUP_DIR="$backup_dir"
 }
 
 ensure_runtime_user() {
@@ -338,7 +347,8 @@ ensure_node_version() {
 }
 
 write_package() {
-  write_root_file "$PACKAGE_FILE" 644 <<EOF
+  local package_file="${1:-$PACKAGE_FILE}"
+  write_root_file "$package_file" 644 <<EOF
 {
   "name": "bianbu-mcp-server",
   "version": "${SERVER_VERSION}",
@@ -354,7 +364,8 @@ EOF
 }
 
 write_app() {
-  write_root_file "$APP_FILE" 755 <<'EOF'
+  local app_file="${1:-$APP_FILE}"
+  write_root_file "$app_file" 755 <<'EOF'
 import { randomBytes, randomUUID } from 'node:crypto';
 import { exec as execCb } from 'node:child_process';
 import { promisify } from 'node:util';
@@ -1609,7 +1620,7 @@ process.on('uncaughtException', (error) => {
 process.on('SIGINT', () => process.exit(0));
 process.on('SIGTERM', () => process.exit(0));
 EOF
-  run_as_root python3 - "$APP_FILE" "$SERVER_VERSION" "$SCRIPT_VERSION" <<'PY'
+  run_as_root python3 - "$app_file" "$SERVER_VERSION" "$SCRIPT_VERSION" <<'PY'
 from pathlib import Path
 import sys
 
@@ -1624,15 +1635,61 @@ PY
 }
 
 install_node_modules() {
+  local install_root="${1:-$INSTALL_ROOT}"
   ensure_node_version
-  log "安装 Node 依赖到: $INSTALL_ROOT"
-  run_as_root rm -rf "$INSTALL_ROOT/node_modules" "$INSTALL_ROOT/package-lock.json"
-  run_as_root sh -c "cd '$INSTALL_ROOT' && npm install --omit=dev --no-fund --no-audit"
-  run_as_root test -f "$INSTALL_ROOT/node_modules/@modelcontextprotocol/sdk/package.json" || die "npm 安装后缺少 @modelcontextprotocol/sdk"
-  run_as_root test -f "$INSTALL_ROOT/node_modules/express/package.json" || die "npm 安装后缺少 express"
-  run_as_root test -f "$INSTALL_ROOT/node_modules/zod/package.json" || die "npm 安装后缺少 zod"
-  run_as_root chmod -R a+rX "$INSTALL_ROOT/node_modules"
-  run_as_root sh -c "cd '$INSTALL_ROOT' && node -e \"import('./server.mjs').then(() => process.exit(0)).catch((err) => { console.error(err); process.exit(1); })\"" || die "Node 运行时无法解析 MCP server"
+  log "安装 Node 依赖到: $install_root"
+  run_as_root rm -rf "$install_root/node_modules" "$install_root/package-lock.json"
+  run_as_root sh -c "cd '$install_root' && npm install --omit=dev --no-fund --no-audit"
+  run_as_root test -f "$install_root/node_modules/@modelcontextprotocol/sdk/package.json" || die "npm 安装后缺少 @modelcontextprotocol/sdk"
+  run_as_root test -f "$install_root/node_modules/express/package.json" || die "npm 安装后缺少 express"
+  run_as_root test -f "$install_root/node_modules/zod/package.json" || die "npm 安装后缺少 zod"
+  run_as_root chmod -R a+rX "$install_root/node_modules"
+  run_as_root sh -c "cd '$install_root' && node -e \"import('./server.mjs').then(() => process.exit(0)).catch((err) => { console.error(err); process.exit(1); })\"" || die "Node 运行时无法解析 MCP server"
+}
+
+prepare_release_root() {
+  local release_root="$1"
+  local release_package_file="${release_root}/package.json"
+  local release_app_file="${release_root}/server.mjs"
+
+  log "预构建新版本到暂存目录: $release_root"
+  run_as_root rm -rf "$release_root"
+  run_as_root install -d -m 755 "$release_root"
+  write_package "$release_package_file"
+  write_app "$release_app_file"
+  install_node_modules "$release_root"
+}
+
+activate_release_root() {
+  local release_root="$1"
+  local previous_root="$2"
+
+  stop_existing_service_if_needed
+
+  if run_as_root test -d "$INSTALL_ROOT"; then
+    log "暂存当前安装目录: $INSTALL_ROOT -> $previous_root"
+    run_as_root rm -rf "$previous_root"
+    run_as_root mv "$INSTALL_ROOT" "$previous_root"
+  fi
+
+  log "切换新版本安装目录: $release_root -> $INSTALL_ROOT"
+  run_as_root rm -rf "$INSTALL_ROOT"
+  run_as_root mv "$release_root" "$INSTALL_ROOT"
+}
+
+clear_release_rollback_state() {
+  ROLLBACK_ON_EXIT=0
+  ROLLBACK_BACKUP_DIR=""
+  ROLLBACK_STAGING_ROOT=""
+  ROLLBACK_PREVIOUS_ROOT=""
+}
+
+cleanup_release_artifacts() {
+  local release_root="$1"
+  local previous_root="$2"
+
+  run_as_root rm -rf "$release_root" >/dev/null 2>&1 || true
+  run_as_root rm -rf "$previous_root" >/dev/null 2>&1 || true
 }
 
 write_env() {
@@ -1702,18 +1759,34 @@ log_release_summary() {
 }
 
 apply_release() {
+  local release_id
+  local staging_root
+  local previous_root
+
   require_systemd
   cmd_install
   ensure_runtime_user
   configure_passwordless_sudo
   backup_existing_installation
-  cleanup_legacy_install
-  write_package
-  write_app
-  install_node_modules
+
+  release_id="$(date -u +%Y%m%dT%H%M%SZ)-$$"
+  staging_root="${INSTALL_ROOT}.staging-${release_id}"
+  previous_root="${INSTALL_ROOT}.previous-${release_id}"
+
+  prepare_release_root "$staging_root"
+
+  ROLLBACK_ON_EXIT=1
+  ROLLBACK_BACKUP_DIR="$LAST_BACKUP_DIR"
+  ROLLBACK_STAGING_ROOT="$staging_root"
+  ROLLBACK_PREVIOUS_ROOT="$previous_root"
+
+  activate_release_root "$staging_root" "$previous_root"
   write_env
   write_service
   finalize_service_start
+
+  clear_release_rollback_state
+  cleanup_release_artifacts "$staging_root" "$previous_root"
 }
 
 cmd_bootstrap() {
@@ -1817,6 +1890,69 @@ SERVICE_NAME=${SERVICE_NAME}
 EOF
 }
 
+cleanup_failed_release() {
+  local exit_code="${1:-0}"
+  local backup_dir="$ROLLBACK_BACKUP_DIR"
+  local staging_root="$ROLLBACK_STAGING_ROOT"
+  local previous_root="$ROLLBACK_PREVIOUS_ROOT"
+
+  if [ "$ROLLBACK_ON_EXIT" -ne 1 ] || [ "$exit_code" -eq 0 ]; then
+    return 0
+  fi
+
+  clear_release_rollback_state
+  set +e
+
+  log "检测到发布失败，尝试自动回滚到上一版本"
+
+  if command -v systemctl >/dev/null 2>&1; then
+    if service_file_exists && run_as_root systemctl is-active --quiet "$SERVICE_NAME"; then
+      log "停止失败中的服务进程: $SERVICE_NAME"
+      run_as_root systemctl stop "$SERVICE_NAME" || true
+    fi
+  fi
+
+  if [ -n "$staging_root" ]; then
+    run_as_root rm -rf "$staging_root" >/dev/null 2>&1 || true
+  fi
+
+  if [ -n "$previous_root" ] && run_as_root test -d "$previous_root"; then
+    log "回滚安装目录: $previous_root -> $INSTALL_ROOT"
+    run_as_root rm -rf "$INSTALL_ROOT"
+    run_as_root mv "$previous_root" "$INSTALL_ROOT"
+  elif [ -n "$backup_dir" ] && run_as_root test -d "$backup_dir/install_root"; then
+    log "从备份恢复安装目录: $backup_dir/install_root -> $INSTALL_ROOT"
+    run_as_root rm -rf "$INSTALL_ROOT"
+    run_as_root cp -a "$backup_dir/install_root" "$INSTALL_ROOT"
+  fi
+
+  if [ -n "$backup_dir" ] && run_as_root test -f "$backup_dir/${SERVICE_NAME}.service"; then
+    log "回滚 systemd service"
+    run_as_root cp -a "$backup_dir/${SERVICE_NAME}.service" "$SERVICE_FILE" || true
+  fi
+
+  if [ -n "$backup_dir" ] && run_as_root test -f "$backup_dir/${SERVICE_NAME}.env"; then
+    log "回滚环境文件"
+    run_as_root cp -a "$backup_dir/${SERVICE_NAME}.env" "$ENV_FILE" || true
+  fi
+
+  if command -v systemctl >/dev/null 2>&1 && service_file_exists; then
+    run_as_root systemctl daemon-reload || true
+    run_as_root systemctl reset-failed "$SERVICE_NAME" || true
+    run_as_root systemctl enable --now "$SERVICE_NAME" || true
+    run_as_root systemctl restart "$SERVICE_NAME" || true
+    if wait_for_local_health 25 2; then
+      log "自动回滚完成，远端已恢复到上一可用版本"
+    else
+      log "自动回滚后健康检查仍未通过，请执行 '$SCRIPT_NAME restore-latest'"
+      run_as_root systemctl --no-pager --full status "$SERVICE_NAME" || true
+      run_as_root journalctl -u "$SERVICE_NAME" -n 120 --no-pager || true
+    fi
+  fi
+}
+
+trap 'exit_code=$?; trap - EXIT; cleanup_failed_release "$exit_code"; exit "$exit_code"' EXIT
+
 main() {
   local cmd="${1:-up}"
   shift || true

package/dist/commands.d.ts

@@ -1,7 +1,7 @@
-import { AppService, Command, CommandProvider } from 'tabby-core';
-/** @hidden */
-export declare class BianbuCloudCommandProvider extends CommandProvider {
-    private app;
-    constructor(app: AppService);
-    provide(): Promise<Command[]>;
-}
+import { AppService, Command, CommandProvider } from 'tabby-core';
+/** @hidden */
+export declare class BianbuCloudCommandProvider extends CommandProvider {
+    private app;
+    constructor(app: AppService);
+    provide(): Promise<Command[]>;
+}

package/dist/configProvider.d.ts

@@ -1,25 +1,25 @@
-import { ConfigProvider } from 'tabby-core';
-/** @hidden */
-export declare class BianbuMcpConfigProvider extends ConfigProvider {
-    defaults: {
-        bianbuMcp: {
-            enabled: boolean;
-            name: string;
-            url: string;
-            apiKey: string;
-            minIntervalMs: number;
-            maxRetries: number;
-            retryBaseMs: number;
-            interactiveConcurrency: number;
-            transferConcurrency: number;
-            workerCadenceMs: number;
-            uploadChunkBytes: number;
-            downloadChunkBytes: number;
-            notes: string;
-            installerRemotePath: string;
-            maintenanceAsRoot: boolean;
-            reconnectPollMs: number;
-            upgradeHealthTimeoutMs: number;
-        };
-    };
-}
+import { ConfigProvider } from 'tabby-core';
+/** @hidden */
+export declare class BianbuMcpConfigProvider extends ConfigProvider {
+    defaults: {
+        bianbuMcp: {
+            enabled: boolean;
+            name: string;
+            url: string;
+            apiKey: string;
+            minIntervalMs: number;
+            maxRetries: number;
+            retryBaseMs: number;
+            interactiveConcurrency: number;
+            transferConcurrency: number;
+            workerCadenceMs: number;
+            uploadChunkBytes: number;
+            downloadChunkBytes: number;
+            notes: string;
+            installerRemotePath: string;
+            maintenanceAsRoot: boolean;
+            reconnectPollMs: number;
+            upgradeHealthTimeoutMs: number;
+        };
+    };
+}

package/dist/filesTab.component.d.ts

@@ -1,104 +1,104 @@
-import { Injector } from '@angular/core';
-import { BaseTabComponent, NotificationsService, PlatformService } from 'tabby-core';
-import { BianbuMcpService } from './mcp.service';
-interface TransferItem {
-    id: number;
-    name: string;
-    direction: 'upload' | 'download';
-    status: 'queued' | 'running' | 'done' | 'error' | 'cancelled';
-    bytesDone: number;
-    bytesTotal: number | null;
-    startedAt: number;
-    finishedAt?: number;
-    error?: string;
-    controller?: AbortController;
-}
-/** @hidden */
-export declare class BianbuCloudFilesTabComponent extends BaseTabComponent {
-    private mcp;
-    private notifications;
-    private platform;
-    currentPath: string;
-    pathInput: string;
-    asRoot: boolean;
-    busy: boolean;
-    items: any[];
-    filteredItems: any[];
-    selectedPath: string;
-    selectedContent: string;
-    selectedIsText: boolean;
-    status: string;
-    dragActive: boolean;
-    searchText: string;
-    history: string[];
-    historyIndex: number;
-    selectedIndex: number;
-    contextMenuVisible: boolean;
-    contextMenuX: number;
-    contextMenuY: number;
-    contextItem: any;
-    promptVisible: boolean;
-    promptTitle: string;
-    promptPlaceholder: string;
-    promptValue: string;
-    promptAction: null | 'mkdir' | 'newfile' | 'rename';
-    promptTarget: any;
-    transfersVisible: boolean;
-    transfers: TransferItem[];
-    private transferSeq;
-    private transferQueue;
-    private transferQueueRunning;
-    constructor(injector: Injector, mcp: BianbuMcpService, notifications: NotificationsService, platform: PlatformService);
-    ngOnInit(): void;
-    get breadcrumbs(): string[];
-    get selectedItem(): any | null;
-    onDocumentClick(): void;
-    onKeyDown(event: KeyboardEvent): void;
-    refresh(): Promise<void>;
-    applyFilter(): void;
-    navigateToInput(): void;
-    navigate(path: string, pushHistory?: boolean): void;
-    navigateBreadcrumb(index: number): void;
-    goBack(): void;
-    goForward(): void;
-    goUp(): void;
-    moveSelection(delta: number): void;
-    selectItem(item: any): void;
-    openItem(item: any): Promise<void>;
-    saveSelected(): Promise<void>;
-    openCreateDirectoryPrompt(): void;
-    openCreateFilePrompt(): void;
-    openRenamePrompt(item: any): void;
-    closePrompt(): void;
-    confirmPrompt(): Promise<void>;
-    createDirectory(name: string): Promise<void>;
-    createFile(name: string): Promise<void>;
-    renameItem(item: any, name: string): Promise<void>;
-    deleteItem(item: any): Promise<void>;
-    showContextMenu(event: MouseEvent, item: any): void;
-    hideContextMenu(): void;
-    uploadFile(event: Event): Promise<void>;
-    private createTransfer;
-    cancelTransfer(transfer: TransferItem): void;
-    transferPercent(transfer: TransferItem): number | null;
-    transferRate(transfer: TransferItem): string;
-    uploadDroppedFile(file: File): Promise<void>;
-    onDragOver(event: DragEvent): void;
-    onDragLeave(): void;
-    onDrop(event: DragEvent): Promise<void>;
-    downloadSelected(): Promise<void>;
-    private enqueueUpload;
-    private enqueueDownload;
-    private queueTransferJob;
-    private pumpTransferQueue;
-    private runUploadTransfer;
-    private runDownloadTransfer;
-    private clearPreview;
-    private baseName;
-    private isTextLike;
-    private joinPath;
-    private uint8ToBase64;
-    private base64ToUint8;
-    private readFileAsBase64;
-}
-export {};
+import { Injector } from '@angular/core';
+import { BaseTabComponent, NotificationsService, PlatformService } from 'tabby-core';
+import { BianbuMcpService } from './mcp.service';
+interface TransferItem {
+    id: number;
+    name: string;
+    direction: 'upload' | 'download';
+    status: 'queued' | 'running' | 'done' | 'error' | 'cancelled';
+    bytesDone: number;
+    bytesTotal: number | null;
+    startedAt: number;
+    finishedAt?: number;
+    error?: string;
+    controller?: AbortController;
+}
+/** @hidden */
+export declare class BianbuCloudFilesTabComponent extends BaseTabComponent {
+    private mcp;
+    private notifications;
+    private platform;
+    currentPath: string;
+    pathInput: string;
+    asRoot: boolean;
+    busy: boolean;
+    items: any[];
+    filteredItems: any[];
+    selectedPath: string;
+    selectedContent: string;
+    selectedIsText: boolean;
+    status: string;
+    dragActive: boolean;
+    searchText: string;
+    history: string[];
+    historyIndex: number;
+    selectedIndex: number;
+    contextMenuVisible: boolean;
+    contextMenuX: number;
+    contextMenuY: number;
+    contextItem: any;
+    promptVisible: boolean;
+    promptTitle: string;
+    promptPlaceholder: string;
+    promptValue: string;
+    promptAction: null | 'mkdir' | 'newfile' | 'rename';
+    promptTarget: any;
+    transfersVisible: boolean;
+    transfers: TransferItem[];
+    private transferSeq;
+    private transferQueue;
+    private transferQueueRunning;
+    constructor(injector: Injector, mcp: BianbuMcpService, notifications: NotificationsService, platform: PlatformService);
+    ngOnInit(): void;
+    get breadcrumbs(): string[];
+    get selectedItem(): any | null;
+    onDocumentClick(): void;
+    onKeyDown(event: KeyboardEvent): void;
+    refresh(): Promise<void>;
+    applyFilter(): void;
+    navigateToInput(): void;
+    navigate(path: string, pushHistory?: boolean): void;
+    navigateBreadcrumb(index: number): void;
+    goBack(): void;
+    goForward(): void;
+    goUp(): void;
+    moveSelection(delta: number): void;
+    selectItem(item: any): void;
+    openItem(item: any): Promise<void>;
+    saveSelected(): Promise<void>;
+    openCreateDirectoryPrompt(): void;
+    openCreateFilePrompt(): void;
+    openRenamePrompt(item: any): void;
+    closePrompt(): void;
+    confirmPrompt(): Promise<void>;
+    createDirectory(name: string): Promise<void>;
+    createFile(name: string): Promise<void>;
+    renameItem(item: any, name: string): Promise<void>;
+    deleteItem(item: any): Promise<void>;
+    showContextMenu(event: MouseEvent, item: any): void;
+    hideContextMenu(): void;
+    uploadFile(event: Event): Promise<void>;
+    private createTransfer;
+    cancelTransfer(transfer: TransferItem): void;
+    transferPercent(transfer: TransferItem): number | null;
+    transferRate(transfer: TransferItem): string;
+    uploadDroppedFile(file: File): Promise<void>;
+    onDragOver(event: DragEvent): void;
+    onDragLeave(): void;
+    onDrop(event: DragEvent): Promise<void>;
+    downloadSelected(): Promise<void>;
+    private enqueueUpload;
+    private enqueueDownload;
+    private queueTransferJob;
+    private pumpTransferQueue;
+    private runUploadTransfer;
+    private runDownloadTransfer;
+    private clearPreview;
+    private baseName;
+    private isTextLike;
+    private joinPath;
+    private uint8ToBase64;
+    private base64ToUint8;
+    private readFileAsBase64;
+}
+export {};

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export default class BianbuMcpModule {
-}
+export default class BianbuMcpModule {
+}