tabby-bianbu-mcp 0.5.4 → 0.6.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to `tabby-bianbu-mcp` will be documented in this file.
 
+## [0.6.0] - 2026-03-23
+
+### Added
+- **adaptive request throttling**: `RequestLane` now starts at zero cadence and auto-backs-off only when the server returns 429 / rate-limit errors, then gradually recovers to zero delay on success
+- **concurrent file transfers**: up to 3 files now upload/download in parallel (configurable via `maxConcurrentFiles`)
+- **enhanced shell line editor**: cursor movement (←→), command history (↑↓), Home/End, Delete key, Ctrl+A/E/U/K/W/L shortcuts
+- **colorized shell output**: stderr renders in red, non-zero exit codes in yellow, prompt in bold blue
+- **running indicator**: shell shows `⏳ Running...` during command execution
+- **file manager sort**: click column headers (Name, Size, Modified, Type) to sort; folders always appear first
+- **file manager multi-select**: Ctrl+Click to toggle, Shift+Click for range selection
+- **file type icons**: emoji icons for 50+ file extensions (📁📜🐍📋📦🖼️🎵🎬 etc.)
+- **formatted file sizes**: human-readable display (B, KB, MB, GB)
+- **date column**: shows file modification timestamps
+- **status bar**: shows item count, selection summary, and total size
+- **detail pane toggle**: hide/show the preview panel to maximize file list space
+- **URL domain input**: settings page now shows `https://` [domain] `/mcp` — user only needs to paste the domain
+
+### Changed
+- **upload chunk default**: 32 KiB → 64 KiB (halves HTTP round-trips)
+- **download chunk default**: 128 KiB → 256 KiB
+- **worker cadence default**: 100ms → 0ms (adaptive throttling handles rate-limiting)
+- **download pipeline**: independent flusher coroutine eliminates head-of-line blocking where all workers stalled waiting for ordered disk writes
+- **file manager UI**: complete redesign with Windows 11 Fluent-inspired dark theme (Mica-style backdrop, rounded corners, segmented toolbar, immersive layout)
+- **settings page**: simplified from 6 cards to 3 focused sections; advanced settings in collapsible areas; MCP snippet now masks the API key
+- **config field**: `url` replaced by `domain` — existing `url` values are auto-migrated on first load
+
+### Removed
+- `settings.enabled` config (removed in 0.5.4, cleanup completed)
+- `minIntervalMs` config (replaced by adaptive cadence)
+
 ## [0.5.4] - 2026-03-23
 
 ### Fixed

package/README.md

@@ -1,123 +1,422 @@
-# tabby-bianbu-mcp
+<div align="center">
 
-A Tabby plugin for Bianbu Cloud remote shell and file operations over MCP.
+# <img src="https://img.icons8.com/fluency/48/cloud-development.png" width="32" height="32" /> tabby-bianbu-mcp
 
-It adds a dedicated Bianbu MCP settings page, a shell-like terminal tab, a file manager tab, remote health diagnostics, and a bundled installer push-upgrade flow for the matching Bianbu Cloud MCP server.
+**Tabby terminal plugin for Bianbu Cloud &mdash; Shell & File Manager over MCP**
 
-## Features
+**Bianbu Cloud 的 Tabby 终端插件 &mdash; 基于 MCP 的远程 Shell 和文件管理器**
 
-- Bianbu MCP settings page inside Tabby
-- Bianbu Cloud Shell and Bianbu Cloud Files profiles
-- shell experience backed by MCP `run_command` and logical shell sessions
-- file explorer backed by MCP file tools
-- remote diagnostics: health, versions, capabilities, FILE_ROOT, transport mode
-- packaged remote installer asset with SHA-256 metadata and integrity verification
-- push latest installer to the remote host and trigger `up` or `repair`
-- chunked upload and download support for larger files
-- 32-slot request scheduling with 2 reserved interactive lanes and up to 30 transfer lanes
-- one active file transfer at a time with queued follow-up uploads/downloads
-- parallel offset-based file chunk transfers against the matching remote installer
-- atomic rename support through MCP `rename_path`
-- remote backup and `restore-latest` recovery support in the installer
+[![npm version](https://img.shields.io/npm/v/tabby-bianbu-mcp?style=flat-square&color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/tabby-bianbu-mcp)
+[![license](https://img.shields.io/npm/l/tabby-bianbu-mcp?style=flat-square&color=blue)](LICENSE)
+[![node](https://img.shields.io/node/v/tabby-bianbu-mcp?style=flat-square&color=339933&logo=node.js&logoColor=white)](package.json)
+[![npm downloads](https://img.shields.io/npm/dm/tabby-bianbu-mcp?style=flat-square&color=orange)](https://www.npmjs.com/package/tabby-bianbu-mcp)
+[![GitHub stars](https://img.shields.io/github/stars/niver2002/tabby-bianbu-mcp?style=flat-square&logo=github)](https://github.com/niver2002/tabby-bianbu-mcp)
 
-## What this plugin is not
+---
 
-- not native SSH
-- not native SFTP
-- not a replacement for the upstream Bianbu Cloud gateway authentication layer
+[English](#-overview) &nbsp;&bull;&nbsp; [中文](#-概述)
 
-The plugin talks to a Bianbu Cloud MCP endpoint such as:
+</div>
 
-`https://<domain>/mcp`
+<br/>
 
-Authentication relies on the existing upstream `X-API-KEY` layer. The plugin does not add a second proxy token layer.
+## <img src="https://img.icons8.com/fluency/24/info.png" width="20" /> Overview
 
-## Settings
+> A [Tabby](https://tabby.sh) plugin that brings **cloud shell** and **file manager** experiences to Bianbu Cloud virtual machines,
+> powered by the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).
+> No SSH keys. No SFTP setup. Just MCP over HTTPS.
 
-The plugin stores these main settings under `bianbuMcp`:
+<br/>
 
-- `enabled`
-- `name`
-- `url`
-- `apiKey`
-- `interactiveConcurrency`
-- `transferConcurrency`
-- `workerCadenceMs`
-- `maxRetries`
-- `retryBaseMs`
-- `uploadChunkBytes`
-- `downloadChunkBytes`
-- `notes`
-- `installerRemotePath`
-- `maintenanceAsRoot`
-- `reconnectPollMs`
-- `upgradeHealthTimeoutMs`
+## <img src="https://img.icons8.com/fluency/24/info.png" width="20" /> 概述
 
-## Remote maintenance flow
+> 一款 [Tabby](https://tabby.sh) 插件，为算能板卡宇宙(Bianbu Cloud) 虚拟机提供**云端 Shell** 和**文件管理器**体验，
+> 基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 通信。
+> 无需 SSH 密钥，无需 SFTP，仅需 HTTPS + MCP。
 
-The plugin package contains a bundled copy of `bianbu_agent_proxy.sh` plus release metadata.
+<br/>
 
-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. 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
+## ✨ Features / 功能特性
 
-After a maintenance run, the settings page can also download:
+<table>
+<thead>
+<tr>
+<th width="50%">English</th>
+<th width="50%">中文</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
 
-- a local session log generated by the plugin
-- a remote session log bundle containing the status file and installer log
+**🖥 Cloud Shell**
+- Full terminal experience via MCP shell sessions
+- Persistent sessions with working directory tracking
+- Character-at-a-time input with prompt detection
 
-Both downloads use timestamped filenames and carry the maintenance session name for easier debugging.
+</td>
+<td>
 
-This is the intended commercial-release upgrade path because the client and remote installer ship together.
+**🖥 云端 Shell**
+- 通过 MCP Shell 会话实现完整终端体验
+- 持久会话，自动跟踪工作目录
+- 逐字符输入，智能提示符检测
 
-The remote installer now defaults `ENABLE_PASSWORDLESS_SUDO=false`. If you want unattended `as_root=true` maintenance through MCP, opt in explicitly and understand the security trade-off.
+</td>
+</tr>
+<tr>
+<td>
 
-## Build
+**📁 File Manager**
+- Browse, create, rename, delete files & directories
+- Inline text editor with save support
+- Drag-and-drop file upload
+- Keyboard shortcuts (F2, F5, Del, Ctrl+N, Ctrl+Shift+N)
+
+</td>
+<td>
+
+**📁 文件管理器**
+- 浏览、新建、重命名、删除文件和目录
+- 内联文本编辑器，支持保存
+- 拖拽上传文件
+- 快捷键（F2 重命名 / F5 刷新 / Del 删除 / Ctrl+N 新文件 / Ctrl+Shift+N 新文件夹）
+
+</td>
+</tr>
+<tr>
+<td>
+
+**⚡ High-Performance Transfers**
+- Parallel chunked upload & download
+- 32-slot request scheduler (2 interactive + 30 transfer)
+- Configurable chunk sizes and concurrency
+- Transfer queue with cancel support
+
+</td>
+<td>
+
+**⚡ 高性能传输**
+- 并行分块上传和下载
+- 32 槽位请求调度器（2 交互 + 30 传输）
+- 可配置分块大小和并发数
+- 传输队列，支持取消
+
+</td>
+</tr>
+<tr>
+<td>
+
+**🔧 Remote Maintenance**
+- One-click push-upgrade from Tabby
+- Auto-rollback on failed deployments
+- Remote health diagnostics & version tracking
+- Downloadable session logs (local + remote)
+
+</td>
+<td>
+
+**🔧 远程维护**
+- Tabby 内一键推送升级
+- 部署失败自动回滚
+- 远程健康诊断和版本追踪
+- 可下载会话日志（本地 + 远端）
+
+</td>
+</tr>
+</tbody>
+</table>
+
+<br/>
+
+---
+
+## 📦 Installation / 安装
+
+<table>
+<tr>
+<td><b>npm (recommended)</b></td>
+<td>
 
 ```bash
-npm install
-npm run build
+npm install tabby-bianbu-mcp
 ```
 
-## Test
+</td>
+</tr>
+<tr>
+<td><b>Tabby Plugin Manager</b></td>
+<td>
 
-```bash
-npm test
+Search for `tabby-bianbu-mcp` in **Settings → Plugins → Install from npm**
+
+在 **设置 → 插件 → 从 npm 安装** 中搜索 `tabby-bianbu-mcp`
+
+</td>
+</tr>
+</table>
+
+<br/>
+
+---
+
+## 🚀 Quick Start / 快速上手
+
+### 1. Configure / 配置
+
+Open **Settings → Bianbu MCP** in Tabby and fill in:
+
+在 Tabby 中打开 **设置 → Bianbu MCP**，填写：
+
+| Field / 字段 | Description / 说明 | Example / 示例 |
+|:---|:---|:---|
+| **MCP URL** | Your MCP endpoint / MCP 端点地址 | `https://your-domain.example.com/mcp` |
+| **X-API-KEY** | API key from Bianbu Cloud / API 密钥 | `your-api-key` |
+| **Profile Name** | Display name / 显示名称 | `bianbu` |
+
+### 2. Connect / 连接
+
+Click **"Test Connection"** to verify. Then use:
+
+点击 **"Test connection"** 验证。然后使用：
+
+- **"Open Bianbu Cloud Shell"** — for terminal access / 打开终端
+- **"Open Bianbu Cloud Files"** — for file management / 打开文件管理器
+
+### 3. MCP Snippet / MCP 配置片段
+
+Copy the auto-generated JSON config for other MCP clients:
+
+复制自动生成的 JSON 配置，用于其他 MCP 客户端（如 Claude Desktop）：
+
+```json
+{
+  "mcpServers": {
+    "bianbu": {
+      "type": "http",
+      "url": "https://your-domain.example.com/mcp",
+      "headers": {
+        "X-API-KEY": "your-api-key"
+      }
+    }
+  }
+}
 ```
 
-## Release verification
+<br/>
 
-```bash
-npm run sync:remote-assets
-npm test
-npm run build
-npm pack --dry-run
+---
+
+## ⚙️ Settings Reference / 配置参考
+
+<details>
+<summary><b>Click to expand full settings table / 点击展开完整配置表</b></summary>
+
+<br/>
+
+| Key / 键 | Default / 默认值 | Description (EN) | 说明 (中文) |
+|:---|:---|:---|:---|
+| `name` | `bianbu` | Profile display name | 配置显示名称 |
+| `url` | *(empty)* | MCP endpoint URL | MCP 端点 URL |
+| `apiKey` | *(empty)* | `X-API-KEY` header value | API 密钥 |
+| `interactiveConcurrency` | `2` | Interactive request slots | 交互请求并发槽位数 |
+| `transferConcurrency` | `30` | Transfer request slots | 传输请求并发槽位数 |
+| `workerCadenceMs` | `100` | Dispatch cycle interval (ms) | 调度周期间隔 (毫秒) |
+| `maxRetries` | `2` | Max retry attempts | 最大重试次数 |
+| `retryBaseMs` | `1000` | Base delay between retries (ms) | 重试基础间隔 (毫秒) |
+| `uploadChunkBytes` | `32768` | Upload chunk size (bytes) | 上传分块大小 (字节) |
+| `downloadChunkBytes` | `131072` | Download chunk size (bytes) | 下载分块大小 (字节) |
+| `notes` | *(empty)* | User notes | 用户备注 |
+| `installerRemotePath` | `/tmp/bianbu_agent_proxy.sh` | Remote installer path | 远端安装脚本路径 |
+| `maintenanceAsRoot` | `true` | Run maintenance as root | 以 root 执行维护 |
+| `reconnectPollMs` | `2000` | Health poll interval during upgrade | 升级时健康检测间隔 |
+| `upgradeHealthTimeoutMs` | `120000` | Max wait time for upgrade (ms) | 升级最大等待时间 |
+
+</details>
+
+<br/>
+
+---
+
+## 🔄 Remote Maintenance / 远程维护
+
+<table>
+<tr><td width="50%">
+
+### English
+
+The plugin bundles `bianbu_agent_proxy.sh` — a self-contained MCP server installer with **blue/green deployment** and **automatic rollback**.
+
+**Upgrade flow:**
+1. Upload bundled installer → remote host
+2. Launch detached `up` or `repair` process
+3. Installer stages the new release, validates with `node`, then swaps atomically
+4. Plugin polls remote health until expected version appears
+5. On failure: previous installation is auto-restored
+
+**After maintenance**, download session logs from the Settings page for debugging.
+
+> **Note:** `ENABLE_PASSWORDLESS_SUDO` defaults to `false`. Opt in explicitly if needed.
+
+</td><td width="50%">
+
+### 中文
+
+插件内置了 `bianbu_agent_proxy.sh` — 一个自包含的 MCP 服务器安装脚本，支持**蓝绿部署**和**自动回滚**。
+
+**升级流程:**
+1. 上传内置安装脚本到远端主机
+2. 后台启动 `up` 或 `repair` 进程
+3. 安装脚本在暂存区准备新版本，用 `node` 验证后原子切换
+4. 插件持续轮询远端健康状态，直到出现预期版本号
+5. 如果失败：自动恢复到之前的安装
+
+**维护完成后**，可在设置页面下载会话日志用于调试。
+
+> **注意:** `ENABLE_PASSWORDLESS_SUDO` 默认为 `false`。如需无密码 sudo，请明确开启并了解安全影响。
+
+</td></tr>
+</table>
+
+<br/>
+
+---
+
+## 🏗 Architecture / 架构
+
+```
+┌───────────────────────────────────────────────────────┐
+│                    Tabby Terminal                      │
+│  ┌──────────────┐  ┌──────────────┐  ┌─────────────┐  │
+│  │  Shell Tab   │  │  Files Tab   │  │ Settings Tab│  │
+│  └──────┬───────┘  └──────┬───────┘  └──────┬──────┘  │
+│         │                 │                  │         │
+│  ┌──────┴─────────────────┴──────────────────┴──────┐  │
+│  │              BianbuMcpService                    │  │
+│  │  ┌─────────────────┐  ┌────────────────────────┐ │  │
+│  │  │ Interactive Lane│  │     Transfer Lane      │ │  │
+│  │  │   (2 slots)     │  │     (30 slots)         │ │  │
+│  │  └────────┬────────┘  └───────────┬────────────┘ │  │
+│  │           └───────────┬───────────┘              │  │
+│  │                       │                          │  │
+│  │             JSON-RPC / HTTP(S)                   │  │
+│  └───────────────────────┼──────────────────────────┘  │
+└──────────────────────────┼─────────────────────────────┘
+                           │
+                    ┌──────▼──────┐
+                    │  X-API-KEY  │
+                    │   Gateway   │
+                    └──────┬──────┘
+                           │
+                ┌──────────▼──────────┐
+                │  bianbu-mcp-server  │
+                │   (Express + MCP)   │
+                │                     │
+                │  20 MCP Tools:      │
+                │  health, shell,     │
+                │  files, chunked     │
+                │  transfers ...      │
+                └─────────────────────┘
 ```
 
-## Publish
+<br/>
+
+---
+
+## 🛠 Development / 开发
 
 ```bash
-npm publish --access public
+# Clone / 克隆
+git clone https://github.com/niver2002/tabby-bianbu-mcp.git
+cd tabby-bianbu-mcp
+
+# Install dependencies / 安装依赖
+npm install
+
+# Build (sync assets → types → webpack)
+npm run build
+
+# Watch mode / 监视模式
+npm run watch
+
+# Run tests / 运行测试
+npm test
+
+# Full release verification / 完整发布验证
+npm run verify
 ```
 
-## Files included in the package
+<br/>
+
+---
+
+## ⚠️ Security Considerations / 安全注意事项
+
+<table>
+<thead>
+<tr>
+<th width="50%">English</th>
+<th width="50%">中文</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+
+- **Always use HTTPS** — API key is sent in `X-API-KEY` header; HTTP transmits it in plaintext
+- **`as_root=true`** bypasses `FILE_ROOT` restrictions and uses `sudo -n`
+- The **MCP snippet** in settings shows the real API key — don't share it publicly
+- `pug@2.x` has known prototype pollution CVEs; this is a **build-time-only** dependency
+
+</td>
+<td>
+
+- **始终使用 HTTPS** — API 密钥通过 `X-API-KEY` 头传输，HTTP 会明文传输
+- **`as_root=true`** 会绕过 `FILE_ROOT` 限制，使用 `sudo -n` 执行
+- 设置页的 **MCP 配置片段**会显示真实 API 密钥 — 不要公开分享
+- `pug@2.x` 有已知的原型链污染漏洞，但这只是**构建时依赖**，不影响运行时
+
+</td>
+</tr>
+</tbody>
+</table>
+
+<br/>
+
+---
+
+## 📋 Changelog / 变更日志
+
+See [CHANGELOG.md](CHANGELOG.md) for the full release history.
+
+完整版本历史请查看 [CHANGELOG.md](CHANGELOG.md)。
+
+<br/>
+
+---
+
+## 📄 License / 许可证
+
+[MIT](LICENSE) &copy; [niver2002](https://github.com/niver2002)
+
+---
+
+<div align="center">
+
+**Made with** ❤️ **for the Bianbu Cloud community**
+
+**为算能板卡宇宙社区倾心打造**
 
-- `dist/`
-- `assets/bianbu_agent_proxy.sh`
-- `assets/bianbu_agent_proxy.meta.json`
-- `README.md`
-- `LICENSE`
-- `CHANGELOG.md`
+<br/>
 
-## Source repository
+<sub>
 
-https://github.com/niver2002/tabby-bianbu-mcp
+[Report Bug / 反馈问题](https://github.com/niver2002/tabby-bianbu-mcp/issues) &nbsp;&bull;&nbsp;
+[npm Package](https://www.npmjs.com/package/tabby-bianbu-mcp) &nbsp;&bull;&nbsp;
+[Tabby Terminal](https://tabby.sh)
 
-## License
+</sub>
 
-MIT
+</div>

package/assets/bianbu_agent_proxy.meta.json

@@ -5,5 +5,5 @@
   "serverVersion": "1.2.0",
   "sha256": "729442eb8fa2311e67415ed78d5dbf0c12e58281e075cd3cc43cbb74c595e5b9",
   "bytes": 67756,
-  "generatedAt": "2026-03-23T02:15:11.160Z"
+  "generatedAt": "2026-03-23T02:58:26.632Z"
 }

package/dist/configProvider.d.ts

@@ -4,7 +4,7 @@ export declare class BianbuMcpConfigProvider extends ConfigProvider {
     defaults: {
         bianbuMcp: {
             name: string;
-            url: string;
+            domain: string;
             apiKey: string;
             maxRetries: number;
             retryBaseMs: number;
@@ -13,6 +13,7 @@ export declare class BianbuMcpConfigProvider extends ConfigProvider {
             workerCadenceMs: number;
             uploadChunkBytes: number;
             downloadChunkBytes: number;
+            maxConcurrentFiles: number;
             notes: string;
             installerRemotePath: string;
             maintenanceAsRoot: boolean;

package/dist/filesTab.component.d.ts

@@ -48,6 +48,12 @@ export declare class BianbuCloudFilesTabComponent extends BaseTabComponent {
     private transferSeq;
     private transferQueue;
     private transferQueueRunning;
+    sortKey: 'name' | 'size' | 'date' | 'type';
+    sortAsc: boolean;
+    selectedIndices: Set<number>;
+    lastClickIndex: number;
+    detailPaneVisible: boolean;
+    advancedTransfersExpanded: boolean;
     constructor(injector: Injector, mcp: BianbuMcpService, notifications: NotificationsService, platform: PlatformService);
     ngOnInit(): void;
     get breadcrumbs(): string[];
@@ -56,6 +62,7 @@ export declare class BianbuCloudFilesTabComponent extends BaseTabComponent {
     onKeyDown(event: KeyboardEvent): void;
     refresh(): Promise<void>;
     applyFilter(): void;
+    sortItems(): void;
     navigateToInput(): void;
     navigate(path: string, pushHistory?: boolean): void;
     navigateBreadcrumb(index: number): void;
@@ -63,7 +70,7 @@ export declare class BianbuCloudFilesTabComponent extends BaseTabComponent {
     goForward(): void;
     goUp(): void;
     moveSelection(delta: number): void;
-    selectItem(item: any): void;
+    selectItem(item: any, event?: MouseEvent): void;
     openItem(item: any): Promise<void>;
     saveSelected(): Promise<void>;
     openCreateDirectoryPrompt(): void;
@@ -93,6 +100,16 @@ export declare class BianbuCloudFilesTabComponent extends BaseTabComponent {
     private pumpTransferQueue;
     private runUploadTransfer;
     private runDownloadTransfer;
+    formatSize(bytes: number | null | undefined): string;
+    formatDate(iso: string | null | undefined): string;
+    fileIcon(item: any): string;
+    fileType(item: any): string;
+    toggleSort(key: 'name' | 'size' | 'date' | 'type'): void;
+    sortIndicator(key: string): string;
+    get totalSize(): string;
+    get selectionSummary(): string;
+    isSelected(index: number): boolean;
+    toggleDetailPane(): void;
     private clearPreview;
     baseName(path: string): string;
     private isTextLike;