tabby-sftp-plus-plus 0.0.0-stage → 3.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DD1024z
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,209 @@
+# SFTP+ — Dual-Pane SFTP File Manager for Tabby
+
+**[中文](https://github.com/10D24D/Tabby-SFTP-Plus/blob/main/README.md) | English**
+
+[![Version](https://img.shields.io/github/package-json/v/10D24D/Tabby-SFTP-Plus?style=for-the-badge&label=Version&color=7B68EE)](https://github.com/10D24D/Tabby-SFTP-Plus)
+[![Stars](https://img.shields.io/github/stars/10D24D/Tabby-SFTP-Plus?style=for-the-badge&label=Stars&color=orange)](https://github.com/10D24D/Tabby-SFTP-Plus/stargazers)
+[![License](https://img.shields.io/github/license/10D24D/Tabby-SFTP-Plus?style=for-the-badge&label=License&color=green)](https://github.com/10D24D/Tabby-SFTP-Plus)
+
+SFTP+ is a plugin for [Tabby Terminal](https://tabby.sh/) that adds a **dual-pane SFTP file manager** right inside your SSH terminal tabs. Each pane can host the **local disk** or **any remote connection**, giving local↔remote, local↔local, remote↔remote and remote↔local setups. Features include **drag-and-drop transfers**, **bookmark system**, **path memory**, transfer logs, file conflict handling, permission editing, and more — all without leaving the terminal.
+
+---
+
+## 📋 Features at a Glance
+
+| Category | Description |
+|----------|-------------|
+| **📂 Dual-Pane Manager** | Each pane can host the **local disk** or **any remote connection** (local↔remote / local↔local / remote↔remote / remote↔local); horizontal / vertical / adaptive / single-pane layouts; draggable splitter, double-click to reset |
+| **🔗 Connection Management** | The **connection picker** in the title bar switches either pane's endpoint in place: it lists open SSH tabs and unopened configured connections, each with a disconnect action (without affecting the panel's own tab) and a "current / other pane / not opened" marker; open it from the connection title or the pane's endpoint badge; the title-bar connection name toggles between "user@host" and the **alias** (falls back to user@host when no alias); reconnect happens in-place and in the background within the existing tab — no focus steal, the list shows "Waiting for <connection>" while disconnected, and returns to the last directory on recovery |
+| **👁️ View / Edit** | Built-in text/image viewer and text editor (local + remote); extra editable extensions or allow-all-types (binaries still protected); image navigation (prev/next in same directory); copy / copy selection; text context menus for copy, cut, paste, and select-all; view-as-text; open or edit in the system default app; **virtualized line rendering** for large text (big logs scroll smoothly), **toggleable line numbers**, three viewer caret shapes (block / beam / underline, matching Tabby's terminal values); saving over a remote file changed by another program asks for confirmation first |
+| **🎨 File Icons** | Built-in colored SVG file/folder icons; overlay badge for symlinks / shortcuts; customize extension mappings, icon directory, disabled built-in icons, and folder icon |
+| **🔄 Drag & Drop** | Drag across panes to upload/download; recursive folder transfer; drag from OS Explorer/Desktop into either pane |
+| **⬆️ Context Transfer** | Upload or download decided by the actual endpoints; a direct "transfer" when both panes are the same kind (multi-select batch) |
+| **⚡ High-Speed Transfer** | Intra-directory file-level parallelism (1-10 concurrent, adjustable); tar channel for massive small-file directories (pack → single-file transfer → unpack), greatly reducing round trips; **five selectable channel modes** (Smart / SFTP only / TAR only / Prefer SFTP / Prefer TAR); **multi-selecting entries under one parent directory can pack them into a single archive**; batch delete via SSH `rm -rf` / `fs.rm(recursive)` |
+| **🔖 Bookmark System** | **Global** bookmarks (visible in any tab) + **scoped** bookmarks (visible only in tabs of the same connection — local tabs included); group by scope or flatten and mix, with draggable group order; sort by **drag order / usage / name**; one click to **locate the bookmark for the current path**; the popup is resizable (double-click a handle to reset) and can be **pinned open** (stays put — clicks elsewhere won't close it / close on select, both panes can keep their popup open at once, and it re-anchors to its own pane on resize at the size you dragged), and a bookmark can carry a **linked path** that moves the other pane along |
+| **📋 Transfer Log** | Full operation history including **Edit Load** / **Edit Save** types; filtering, stats, JSON export |
+| **⚡ Transfer Control** | Progress bars (with percentage), pause/resume/cancel, resume support, real-time speed, **estimated time remaining**; outside TAR-only mode the tar channel falls back to the regular file-by-file transfer on failure; the transfer log tags transfers (⇄ SFTP / 📦 tar packing / file count); **a missing target directory is pre-flighted** (create / use current directory / cancel); submitting the same transfer twice is intercepted with a notice |
+| **⚠️ File Conflict** | Visual diff on conflict (shows upload⬆/download⬇ direction), with overwrite/skip/rename options (**rename numbers duplicates by default**, or use timestamps / random suffixes) and batch processing; merge-overwrite has its own progress panel; content digests can be shown in the dialog, identical files can auto-skip, and differing digests are marked ≠ |
+| **🔐 Permission Editor** | Remote chmod via 3×3 checkbox matrix with octal preview; unreadable permissions and failed changes are now reported instead of failing silently |
+| **📌 Context Menus** | Upload/download, view/edit, new/rename/delete, copy/cut/paste, refresh, select all/invert; text viewer/editor context menus; <br />Header: column visibility, fit widths, borders & zebra stripes; menu items can also be disabled, not just reordered |
+| **🔍 Filter & Sort** | Keyword filter, multi-column sorting (click headers), configurable visible columns; **Group** (None / Name / Date modified / Type / Size) splits the list into collapsible groups with expand-all / collapse-all, ↑/↓ stops on group headers and clicking a header selects the whole group; with focus on a file list, type a name prefix to jump to the match (Explorer-style; IME such as Chinese is supported); an absolute path typed into the address bar navigates there and highlights a trailing file |
+| **🧭 Path Mode** | Four modes: `off` / `remember` / `sync` (sync with terminal) / `mirror` (both panes locked to one directory, available when both are local or both remote); configurable default |
+| **🎨 Theme System** | 7 presets + custom colors, supports following the Tabby system theme |
+| **⌨️ Panel Hotkey** | Customizable panel toggle hotkey with record/clear/conflict detection; panel actions (delete/rename/refresh/go up/back/forward), open/view/edit and common context-menu actions support **multiple key bindings**, and can be bound to mouse side buttons (Mouse3/Mouse4), the **mouse middle button and wheel up/down** (optionally with Ctrl/Alt/Shift/Win), plus an occupied-hotkey reference list |
+| **🌐 Internationalization** | 24 locales (zh/en complete; other languages fall back to English for missing keys); auto-detects Tabby/browser language |
+| **📦 Data Backup** | Export/import data (bookmarks, transfer logs, settings, path memory); **export is selectable per category** (Language / Theme / Layout / Object icons / Other / Transfer settings / Hotkeys / Bookmark data / Transfer logs) — unselected categories are not written, so importing such a file naturally leaves that data untouched |
+| **🐞 Feedback** | Built-in "Report a Bug" / "Feature Request" in Settings, routed to the matching issue template for the UI language with the Tabby version, OS, frontend type and installed plugin list pre-filled |
+
+---
+
+## 🖥️ Interface Guide
+
+| ![SFTP+ Panel](assets/SFTP-Plus_UI_Panel.png) | ![SFTP+ Settings](assets/SFTP-Plus_UI_Config.png) |
+| :------------------------------------------: | :---------------------------------------------: |
+
+---
+
+## 📥 Installation
+
+1. Make sure [Tabby Terminal](https://tabby.sh/) is installed
+2. Configure the plugin directory in Tabby settings
+3. Place the built plugin (see "Development" section) into the plugin directory, then restart Tabby
+4. Open any SSH terminal tab — the **SFTP+** button should appear in the toolbar
+
+---
+
+## 🚀 Quick Start
+
+1. **Open** — Click the `SFTP+` button in the toolbar of an SSH terminal tab
+2. **Browse** — Navigate local files on the left and remote SFTP directories on the right; double-click to enter a directory
+3. **Transfer** — Drag across panes, or use right-click upload/download
+4. **View/Edit** — Right-click text or image files to view in-app; edit text and save (remote files upload automatically)
+
+---
+
+## 📏 File Size Limits
+
+| Operation | Limit |
+|-----------|-------|
+| Text view | 2 MB (virtualized line rendering in the built-in viewer) |
+| Image view | 15 MB |
+| Text edit | 5 MB |
+
+Exceeding a limit shows a clear dialog and toast with the cap.
+
+---
+
+## ⚙️ Settings Panel
+
+Navigate to Tabby Settings → "SFTP+" in the left sidebar:
+
+| Setting | Description |
+|---------|-------------|
+| **Language** | Follow System / Chinese / English |
+| **Theme** | Auto / Dark / Light / Blue / Green / Purple / Red / Custom |
+| **Custom Colors** | Independently set primary, background, text, and border colors |
+| **Layout** | Adaptive (auto-switches based on panel width) / Horizontal / Vertical |
+| **Table Style** | Show borders, show zebra stripes |
+| **Upload/Download Concurrency** | Intra-directory file-level concurrency (1-10), takes effect immediately |
+| **Transfer Channel Mode** | How folder transfers pick a route — five options: **Smart** (route by file count and size, default) / **SFTP only** (always file by file, no packing probe) / **TAR only** (always pack; fails hard with a reason when unavailable) / **Prefer SFTP** / **Prefer TAR**. The old "Tar Packing Acceleration" and "Fast Mode" toggles migrate into this setting automatically |
+| **Default Upload/Download Paths** | Configure separate upload and download target directories; empty values use the current pane directory |
+| **Default Path Mode** | Path mode for new connections on first open (off / remember / sync / mirror) |
+| **Default Show Hidden** | Whether to show hidden files on new connections |
+| **Additional editable extensions** | Extra extensions the built-in editor may open besides the text whitelist (e.g. `service, tf, plist`); accepts `.conf` / `*.conf` / `conf` |
+| **Allow editing all file types** | Ignore the extension whitelist (off by default); binary content is still blocked to avoid corrupting files in a text editor |
+| **Viewer & Editor** | Line-number toggle (on by default); three viewer caret shapes (block / beam / underline, matching Tabby's terminal cursor) |
+| **File Icons** | Choose an icon resource directory, configure extension mappings, disable built-in icons, and replace the folder icon |
+| **Toolbar Customization** | Drag-to-reorder toolbar buttons, hide unused items; pin buttons so they never collapse, or enable the ⋯ overflow menu — that menu lists every button with a per-row pin to move it in or out; the close button can be hidden once a panel toggle hotkey is bound |
+| **Panel Opacity** | Adjustable 0.5–1; overlays and dialogs follow the same opacity (minimum 50%) |
+| **Apply Settings Instantly** | On by default; when off, changes take effect only after closing and reopening the SFTP+ panel — handy when changing many options at once |
+| **Panel Hotkey** | Custom panel toggle hotkey; panel actions (delete/rename/refresh/go up/back/forward), open/view/edit and common context-menu actions can be bound to multiple keys, and also to mouse side buttons (Mouse3/Mouse4), the mouse middle button and wheel up/down, with an occupied-hotkey reference list |
+| **Data Backup** | Export/import data (JSON), selectable per category on export; clear all data (requires typing `DELETE` to confirm) |
+| **Feedback** | Report a bug / request a feature (Tabby version, OS, frontend type and installed plugins are pre-filled) |
+| **Compatibility** | Hide the native Tabby SFTP button to avoid conflicts |
+
+---
+
+## 💾 Data Backup
+
+All data (bookmarks, transfer logs, path memory, settings) can be exported to and imported from a JSON file. Export is **selectable per category** (Language, Theme, Layout, Object icons, Other, Transfer settings, Hotkeys, Bookmark data, Transfer logs); unselected categories are not written — the import side treats a missing field as "do not overwrite", so an appearance-only backup will not wipe bookmarks or transfer logs.
+
+Path: Settings → Data Backup → Export / Import
+
+---
+
+## 📜 Changelog
+
+Latest version: **v3.1.1** (2026-11-05) — [Full changelog](CHANGELOG.en.md)
+
+---
+
+## 🛠️ Development
+
+### Tech Stack
+
+| Category | Technology |
+|----------|-----------|
+| Framework | Angular 9 |
+| Language | TypeScript 5.8 |
+| Build | Webpack 5 |
+| Styling | Inline styles (CSS variables for adaptive theming) |
+| Dependencies | `tabby-core` / `tabby-settings` / `tabby-terminal` |
+| Protocol | SFTP (reuses Tabby SSH Session) |
+
+### Build
+
+```bash
+# Install dependencies
+npm install
+
+# Development mode (watch mode)
+npm run watch
+
+# Production build
+npm run build
+```
+
+The built plugin bundle is in `dist/` (`index.js` + auto-generated `package.json`).
+
+### Project Structure
+
+```
+tabby-FTPS+/
+├── docs/
+├── scripts/                       # Build helpers (copy-sftp-manifest generates dist/package.json)
+├── src/
+│   ├── index.ts
+│   ├── tabby-shims.d.ts
+│   ├── services/                  # sftp.service / bookmarks / i18n / transfer-log / config (Tabby convention)
+│   ├── settings/                  # sftp-settings component (Tabby convention)
+│   ├── tabby/                     # Terminal integration: config/hotkey providers, terminal-decorator
+│   └── sftp/                      # SFTP feature module
+│       ├── sftp-floating-panel.component.ts
+│       ├── sftp-workspace-tab.component.ts
+│       ├── components/            # View layer (V): file panes, dialogs, context menu, conflict, transfer queue…
+│       ├── controllers/           # Controller layer (C): column / viewer / bookmark controllers
+│       └── core/                  # Logic / utils / types: transfer, conflict, digest, drop, clipboard, path…
+├── locale/                        # 24 GNU gettext .po locales
+├── tabby-plugin-common/           # Shared utilities across plugins (theme / utils)
+├── dist/                          # Build output (index.js + package.json, gitignored)
+└── package.json
+```
+
+See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for the full tree.
+
+---
+
+## 🤝 How to Contribute
+
+Contributions are always welcome! The plugin was conceived by the author (DD1024z), with the majority of implementation code generated using AI assistance.
+
+- Report bugs or request features: [GitHub Issues](https://github.com/10D24D/Tabby-SFTP-Plus/issues) 📝
+- Contribute code: Fork the project and submit a Pull Request 🚀
+- Like SFTP+? Give it a [⭐ Star](https://github.com/10D24D/Tabby-SFTP-Plus) to show your support!
+- Prefer something more direct? [☕ Treat me to a coffee](https://ko-fi.com/dd1024z) — every bit keeps it going.
+
+Your stars and support are what keep me developing — thank you! ❤️
+
+## 🙏 Special Thanks
+
+SFTP+ would not have grown without the foundational projects and the community's support. Special thanks to:
+
+- [Tabby](https://tabby.sh/) — the powerful cross-platform terminal that hosts this plugin
+- [SFTP (SSH File Transfer Protocol)](https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol) — the underlying file transfer protocol this plugin's remote file management is built upon
+- [Tabby SFTP-UI](https://github.com/growingupfirst/tabby-sftp-ui) — an early two-pane SFTP file manager whose interaction and implementation ideas served as an important reference; some of SFTP+'s feature designs were inspired by it
+- [@fweiger](https://github.com/fweiger) — Issue #13: a detailed UX optimization report (click/double-click interaction, right-click menu ordering, hotkey focus, etc.); several points shipped in v2.0.2
+- [@HarpyWar](https://github.com/HarpyWar) — Issue #3: reported a broken hotkey settings page; fixed
+- [@xingkongxiademodeng](https://github.com/xingkongxiademodeng) — Issue #10: flagged the serial (non-concurrent) directory upload bottleneck, guiding the concurrency optimization
+- [@Hanzo-Huang](https://github.com/Hanzo-Huang) — Issue #5: suggested "get current working directory" like native SFTP; implemented
+- [@Purgepyro](https://github.com/Purgepyro) — PR #18: additional editable extensions, allow-edit-all-types, and a fix for blank built-in icons after a manual install
+- [@waylandun](https://github.com/waylandun) — Issue #21: editor paste leaked into the SSH terminal; PR #22 isolates text-input keys at the panel root (verified on macOS)
+- Thanks also to [@webbrain-one](https://github.com/webbrain-one) and [@JayceVane](https://github.com/JayceVane) for their Pull Request attempts
+
+## 📝 License
+
+SFTP+ is licensed under the [MIT](LICENSE) license. Feel free to use, modify, and share it — just comply with the terms.
+
+## ⚠️ Disclaimer
+
+SFTP+ is a free and open-source project, primarily built with AI-assisted generation, so bugs and defects are inevitable. The author cannot guarantee that all features and code have been thoroughly verified. By using this plugin, you agree to assume the associated risks. The developer shall not be held liable for any problems or losses arising from its use. Please use it at your own discretion.

package/README.md

@@ -1,3 +1,212 @@
-# Temporary Holding Version
+# SFTP+ — Tabby 双栏 SFTP 文件管理器
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**中文 | [English](https://github.com/10D24D/Tabby-SFTP-Plus/blob/main/README.en.md)**
+
+[![Version](https://img.shields.io/github/package-json/v/10D24D/Tabby-SFTP-Plus?style=for-the-badge&label=版本&color=7B68EE)](https://github.com/10D24D/Tabby-SFTP-Plus)
+[![Stars](https://img.shields.io/github/stars/10D24D/Tabby-SFTP-Plus?style=for-the-badge&label=Stars&color=orange)](https://github.com/10D24D/Tabby-SFTP-Plus/stargazers)
+[![License](https://img.shields.io/github/license/10D24D/Tabby-SFTP-Plus?style=for-the-badge&label=License&color=green)](https://github.com/10D24D/Tabby-SFTP-Plus)
+
+SFTP+ 是 [Tabby Terminal](https://tabby.sh/) 的插件，为 SSH 终端标签页提供**双栏 SFTP 文件管理**功能：两栏各自可选**本机磁盘**或**任意远程连接**，组合出 本地↔远程 / 本地↔本地 / 远程↔远程 / 远程↔本地 四种形态。支持**书签系统**、**路径记忆**、**拖拽上传下载**、传输日志、文件冲突处理、权限编辑等，无需离开终端即可完成文件操作。
+
+---
+
+## 📋 功能一览
+
+| 类别 | 功能 |
+|------|------|
+| **📂 双栏管理** | 左/右两栏各自可选**本机磁盘**或**任意远程连接**（本地↔远程 / 本地↔本地 / 远程↔远程 / 远程↔本地）；可切换 水平/垂直/自适应/单栏 四种布局；分割线可拖拽调整，双击恢复默认 |
+| **🔗 连接管理** | 顶栏**连接选择器**就地切换任一栏端点：列出已打开的 SSH 标签页与未打开的配置连接，每项可一键断开（不影响面板所在标签页）并标注「当前 / 另一栏 / 未打开」，点击连接标题或端点标识均可唤起；标题栏连接名可在「账号@地址」与「别名」间切换（别名缺失时回落账号@地址）；断开重连在已有标签页内就地、后台完成，不抢焦点，断线期间列表留空提示「等待连接」，恢复后回到上次目录 |
+| **👁️ 查看 / 编辑** | 内置文本/图片查看器与文本编辑器（本地+远程）；可额外指定可编辑扩展名，或允许编辑所有类型（二进制仍保护）；图片支持同目录上一张/下一张导航；支持「复制」「复制选中」；文本查看器/编辑器支持右键复制、剪切、粘贴、全选；支持「以文本方式查看」和「在系统中打开/编辑」；**大文本按行虚拟滚动**（可流畅浏览接近上限的日志）、**行号可开关**、查看器光标形状三档（方块 / 竖线 / 下划线，与 Tabby 终端取值一致）；远端文件被其它程序改动后再保存会先确认 |
+| **🎨 文件图标** | 内置彩色 SVG 文件/文件夹图标；符号链接 / 快捷方式叠加角标；支持按扩展名自定义映射、自定义图标目录、禁用内置图标和替换文件夹图标 |
+| **🔄 拖拽传输** | 跨栏拖拽即上传/下载，支持文件夹递归传输；<br />支持从系统资源管理器/桌面拖入到本地或远程面板 |
+| **⬆️ 右键传输** | 按两端端点自动决定上传 / 下载，两端同类时显示「传输」直传（多选批量） |
+| **⚡ 高速传输** | 目录内多文件并行传输（并发数 1-10 可调）；海量小文件走 tar 打包通道（本地打包→单文件传输→对端解包），大幅减少网络往返；**传输通道模式五档可选**（智能 / 仅 SFTP / 仅 TAR / 优先 SFTP / 优先 TAR）；**多选同一父目录下的多个条目可合并为一个归档**一次传输；批量删除优先 SSH `rm -rf` / `fs.rm(recursive)` |
+| **🔖 书签系统** | **全局**书签（任何标签页可见）+ **局部**书签（仅当前标签页的连接可见，本地标签页同样成立）；可按范围分组或扁平混排，分组顺序可拖拽；排序可切 **拖拽顺序 / 使用频率 / 名称**；可一键**定位当前路径的书签**；浮层可拖拽调大小（双击手柄还原），底部可**钉住面板**（常驻：点其它位置也不关／选中后关闭，且左右两栏的书签面板可同时打开，缩放后自动贴回本栏并保持你拖出的尺寸），并可给书签配**联动路径**（点击时另一栏同步切过去） |
+| **📋 传输日志** | 记录所有操作历史，含「编辑加载/编辑保存」分类，支持筛选、统计、JSON 导出 |
+| **⚡ 传输控制** | 进度条显示（含百分比）、暂停/继续/取消、断点续传、实时速度、**预估剩余时间**；非「仅 TAR」模式下打包失败自动回退常规逐文件传输；传输记录标注传输方式（⇄ SFTP / 📦 tar 打包 / 文件数）；**目标目录不存在时先预检**（创建 / 用当前目录 / 取消）；同一笔传输重复提交会被拦截并提示 |
+| **⚠️ 冲突处理** | 文件冲突时弹出对比界面（显示上传⬆/下载⬇方向），支持覆盖/跳过/重命名（重命名默认**按序号堆叠**，可改为时间戳或随机后缀），可批量操作；覆盖合并有独立进度面板；可计算两端内容摘要并在对话框展示，内容未变可自动跳过，内容不同时标 ≠ |
+| **🔐 权限编辑** | 远程文件 chmod — 3×3 勾选框 + 八进制预览；读不到权限或修改失败时明确提示，不再静默 |
+| **📌 右键菜单** | 上传/下载、查看/编辑、新建/重命名/删除、复制/剪切/粘贴、刷新、全选/反选；文本查看器/编辑器提供文本专用右键菜单；<br />表头右键：列显隐/列宽调整/面板边框与斑马纹切换 |
+| **🔍 过滤排序** | 关键词过滤、多列排序（点击列头）、可配置显示列；**分组**（不分组 / 名称 / 修改日期 / 类型 / 大小）把列表切分为可折叠分组，支持全展开·全收起，↑/↓ 可停在分组表头上、点击表头即整组选中；焦点在文件列表时键入文件名前缀即可跳转选中（资源管理器式，支持中文输入法）；地址栏输入绝对路径回车可跳转并定位（末段是文件则高亮该文件） |
+| **🧭 路径模式** | 四选一：`off` / `remember`（路径记忆）/ `sync`（与终端同步）/ `mirror`（两栏锁同一目录，仅两栏同为本地或同为远程时可用）；可设默认值 |
+| **🎨 主题系统** | 7 种预设 + 自定义配色，支持跟随 Tabby 系统主题 |
+| **⌨️ 面板快捷键** | 可自定义面板开关快捷键，支持录制/清除/冲突提示；面板操作（删除/重命名/刷新/返回上级/后退/前进）、打开·查看·编辑与右键菜单常用动作均支持**多键绑定**，并可绑定鼠标侧键（Mouse3/Mouse4）、**鼠标中键与滚轮上滚/下滚**（可叠加 Ctrl/Alt/Shift/Win），并提供已占用快捷键清单 |
+| **🌐 国际化** | 24 种语言（简中 / 英完整，其余缺失键回退英文），自动检测 Tabby/浏览器语言 |
+| **📦 数据备份** | 导出/导入数据（书签 + 传输记录 + 设置 + 路径记忆）；**导出可按九类勾选**（语言 / 主题 / 布局 / 对象图标 / 其它 / 传输设置 / 快捷键 / 书签数据 / 传输记录），未勾选的类别不写入文件，导入时自然不覆盖原有数据 |
+| **🐞 意见反馈** | 设置页内置「报缺陷 / 提需求」入口，按界面语言路由到对应 Issue 模板，并自动预填 Tabby 版本、系统、前端类型与已装插件列表 |
+
+---
+
+## 🖥️ 界面导览
+
+| ![SFTP+ 操作面板](assets/SFTP-Plus_UI_Panel.png) | ![SFTP+ 设置界面](assets/SFTP-Plus_UI_Config.png) |
+| :---------------------------------------------: | :---------------------------------------------: |
+
+---
+
+## 📥 安装
+
+1. 确保已安装 [Tabby Terminal](https://tabby.sh/)
+2. 在 Tabby 设置中配置插件目录
+3. 将构建产物放入插件目录（参见下方「开发」），重启 Tabby
+4. 打开任意 SSH 终端标签页，工具栏出现 **SFTP+** 按钮即安装成功
+
+---
+
+## 🚀 快速上手
+
+1. **打开** — 在 SSH 终端标签页的工具栏点击 `SFTP+` 按钮
+2. **浏览** — 左侧本地文件系统、右侧远程 SFTP 目录，双击进入目录
+3. **传输** — 拖拽、右键上传/下载，或选中后使用右键菜单
+4. **查看/编辑** — 右键文本或图片文件可内置查看；文本可编辑并保存（远程文件自动上传）
+
+---
+
+
+## 📏 文件大小限制
+
+| 操作 | 上限 |
+|------|------|
+| 文本查看 | 2 MB（内置查看器按行虚拟滚动，可流畅浏览接近上限的日志） |
+| 图片查看 | 15 MB |
+| 文本编辑 | 5 MB |
+
+超出上限时仍会提示，并说明具体限制。
+
+---
+
+
+## ⚙️ 设置面板
+
+在 Tabby 设置页左侧找到「SFTP+」：
+
+| 设置项 | 说明 |
+|--------|------|
+| **语言** | 跟随系统 / 中文 / English |
+| **主题** | 自动 / 深色 / 浅色 / 蓝 / 绿 / 紫 / 红 / 自定义 |
+| **自定义颜色** | 独立设置主色、背景、文字、边框颜色 |
+| **布局** | 自适应（按面板宽度自动切换）/ 水平 / 垂直 |
+| **表格样式** | 显示边框、显示斑马纹 |
+| **上传/下载并发数** | 目录内文件级并发数（1-10），即时生效 |
+| **传输通道模式** | 文件夹传输的择路方式，五档：**智能**（按文件数与体积自动择路，默认）/ **仅 SFTP**（永远逐文件，不做打包探测）/ **仅 TAR**（永远打包，不可用时硬失败并说明原因）/ **优先 SFTP** / **优先 TAR**。旧「tar 打包加速」与「快速模式」开关会自动迁移到本项 |
+| **默认上传/下载路径** | 分别设置上传目标目录和下载目标目录；留空时使用当前面板目录 |
+| **默认路径模式** | 新连接首次打开面板时的路径模式（off / remember / sync / mirror） |
+| **默认显示隐藏文件** | 新连接首次打开面板时是否显示隐藏文件 |
+| **额外可编辑扩展名** | 在内置文本白名单之外，额外允许内置编辑器打开的扩展名（如 `service, tf, plist`）；支持 `.conf` / `*.conf` / `conf` 写法 |
+| **允许编辑所有文件类型** | 忽略扩展名白名单（默认关）；二进制内容仍会拦截，避免用文本编辑器损坏文件 |
+| **查看器与编辑器** | 行号显示开关（默认开）；查看器光标形状三档（方块 / 竖线 / 下划线，取值与 Tabby 终端光标一致） |
+| **文件图标** | 选择图标资源目录、配置扩展名映射、禁用内置图标和替换文件夹图标 |
+| **工具栏自定义** | 拖拽排序工具栏按钮、隐藏不常用项；可把按钮「固定」常显，或开启折叠菜单（⋯）把其余按钮收进菜单；该菜单列出全部按钮，每行图钉可就地切固定；关闭按钮 ✕ 需先绑面板快捷键才可停用/收起 |
+| **面板透明度** | 0.5–1 可调，浮层与对话框一并生效（最低 50%） |
+| **调整配置立即生效** | 默认开启；关闭后改动需「关闭并重开 SFTP+ 面板」才生效，适合一次调整多项 |
+| **面板快捷键** | 自定义面板开关快捷键；面板操作（删除/重命名/刷新/返回上级/后退/前进）、打开·查看·编辑与右键菜单常用动作可绑定多个按键，也可绑定鼠标侧键（Mouse3/Mouse4）、鼠标中键与滚轮上滚/下滚，含已占用快捷键清单 |
+| **数据备份** | 导出/导入数据（JSON），导出时可按九类勾选；清除全部数据（输入 `DELETE` 确认） |
+| **意见反馈** | 报缺陷 / 提需求（自动预填 Tabby 版本、系统、前端类型与已装插件列表） |
+| **兼容性** | 隐藏 Tabby 原生 SFTP 按钮避免冲突 |
+
+---
+
+## 💾 数据备份
+
+所有数据（书签、传输日志、路径记忆、设置）可导出为 JSON 文件，也支持导入恢复。导出时可**按类别勾选**（语言、主题、布局、对象图标、其它、传输设置、快捷键、书签数据、传输记录），未勾选的类别不会写入文件——导入侧对不存在的字段是「不覆盖」语义，因此「只导外观」的备份不会清空书签或传输记录。
+
+路径：设置页 → 数据备份 → 导出 / 导入
+
+---
+
+## 📜 版本历史
+
+最新版本 **v3.1.1**（2026-11-05）— [完整更新日志](CHANGELOG.md)
+
+---
+
+## 🛠️ 开发
+
+### 技术栈
+
+| 类别 | 技术 |
+|------|------|
+| 框架 | Angular 9 |
+| 语言 | TypeScript 5.8 |
+| 构建 | Webpack 5 |
+| 样式 | 内联样式（CSS 变量自适应主题） |
+| 平台依赖 | `tabby-core` / `tabby-settings` / `tabby-terminal` |
+| 传输协议 | SFTP（复用 Tabby SSH Session） |
+
+### 构建
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式（watch 自动构建）
+npm run watch
+
+# 生产构建
+npm run build
+```
+
+构建产物 `dist/index.js` 即为 Tabby 插件包；`dist/package.json` 由 `scripts/copy-sftp-manifest.mjs` 在构建时从根 `package.json` 自动派生（改写入口、剔除开发期脚本），**无需手工维护**。
+
+### 项目结构
+
+```
+tabby-FTPS+/
+├── docs/                                # 架构与开发文档
+├── scripts/                             # 构建辅助（copy-sftp-manifest 自动生成 dist/package.json）
+├── src/
+│   ├── index.ts                         # 插件入口（Angular Module 注册）
+│   ├── tabby-shims.d.ts                 # Tabby 类型声明
+│   ├── services/                        # sftp.service / bookmarks / i18n / transfer-log / config（Tabby 约定目录）
+│   ├── settings/                        # sftp-settings 设置组件（Tabby 约定目录）
+│   ├── tabby/                           # 终端集成：config/hotkey provider、terminal-decorator（工具栏注入按钮）
+│   └── sftp/                            # SFTP 功能模块
+│       ├── sftp-floating-panel.component.ts   # 主面板（业务编排）
+│       ├── sftp-workspace-tab.component.ts    # 工作区独立标签页容器
+│       ├── components/                  # 视图层(V)：文件列表面板、对话框、右键菜单、冲突处理、传输队列等
+│       ├── controllers/                 # 控制器层(C)：列 / 查看器 / 书签控制器
+│       └── core/                        # 逻辑/工具/类型：传输、冲突、摘要、拖放、剪贴板、路径等
+├── locale/                              # 24 语言 GNU gettext .po
+├── tabby-plugin-common/                 # 跨插件公共工具（theme / utils）
+├── dist/                                # 构建输出（index.js + package.json，不入库）
+├── package.json
+└── webpack.config.js
+```
+
+更完整的目录说明见 [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)。
+
+---
+
+## 🤝 如何贡献
+
+欢迎为 SFTP+ 贡献代码或建议！本插件功能想法由作者（DD1024z）提供，主要实现代码使用 AI 辅助生成。
+
+- 提交 Bug 或功能请求：[GitHub Issues](https://github.com/10D24D/Tabby-SFTP-Plus/issues) 📝
+- 贡献代码：Fork 项目并提交 Pull Request 🚀
+- 喜欢 SFTP+？可以帮忙点个 [⭐ Star](https://github.com/10D24D/Tabby-SFTP-Plus) 支持一下！
+- 想更直接一点？可以[☕ 请喝咖啡](https://ko-fi.com/dd1024z)，一样是动力。
+
+您的点赞与 Star 是我持续开发的动力，感谢支持！❤️
+
+## 🙏 特别鸣谢
+
+SFTP+ 的成长离不开基石项目与社区用户的支持，在此特别感谢：
+
+- [Tabby](https://tabby.sh/) — 强大的跨平台终端，SFTP+ 得以在其生态内运行
+- [SFTP（SSH File Transfer Protocol）](https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol) — 底层文件传输协议，本插件的远程文件管理能力构建于此之上
+- [Tabby SFTP-UI](https://github.com/growingupfirst/tabby-sftp-ui) — 早期双栏 SFTP 文件管理器，其交互与实现思路为 SFTP+ 提供了重要参考，部分功能设计受其启发
+- [@fweiger](https://github.com/fweiger) — Issue #13 提交了详尽的使用体验优化建议（单击/双击交互、右键菜单排序、快捷键聚焦等），多项已落地 v2.0.2
+- [@HarpyWar](https://github.com/HarpyWar) — Issue #3 反馈热键设置页异常，已修复
+- [@xingkongxiademodeng](https://github.com/xingkongxiademodeng) — Issue #10 指出目录上传串行无并发的性能瓶颈，为并发传输优化提供方向
+- [@Hanzo-Huang](https://github.com/Hanzo-Huang) — Issue #5 提出「获取当前工作目录」功能建议，已实现
+- [@Purgepyro](https://github.com/Purgepyro) — PR #18 新增自定义可编辑扩展名、允许编辑全部类型，并修复手动安装后内置图标空白
+- [@waylandun](https://github.com/waylandun) — Issue #21 反馈编辑器粘贴会进终端，PR #22 在面板根隔离文本按键（macOS 实测）
+- 同时感谢 [@webbrain-one](https://github.com/webbrain-one)、[@JayceVane](https://github.com/JayceVane) 提交 Pull Request 的贡献尝试
+
+## 📝 许可协议
+
+SFTP+ 遵循 [MIT](LICENSE) 开源协议。欢迎使用、修改和分享，但请遵守协议条款。
+
+## ⚠️ 免责声明
+
+SFTP+ 是一个免费的开源项目，主要使用 AI 辅助生成，难免存在一些 BUG 缺陷，作者无法保证功能代码验证到位。使用本插件即表示你同意承担相关风险，开发者不对因使用插件导致的任何问题或损失负责，请酌情使用。

package/dist/assets/icons/audio.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <rect x="3.5" y="5" width="17" height="14" rx="2" fill="#e08a2b"/>
+  <g fill="#fff">
+    <ellipse cx="9" cy="15" rx="1.7" ry="1.3"/>
+    <ellipse cx="15" cy="15" rx="1.7" ry="1.3"/>
+    <rect x="10.3" y="8" width="1.3" height="7"/>
+    <rect x="16.3" y="8" width="1.3" height="7"/>
+    <rect x="10.3" y="7.4" width="7.3" height="1.4" rx="0.6"/>
+  </g>
+</svg>

package/dist/assets/icons/code.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#5a6b8c" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.35)" d="M15 2l4 4h-4z"/>
+  <g fill="#fff" opacity=".95"><path d="M10 9l-2.2 3 2.2 3 1-1.1-1.3-1.9 1.3-1.9zM14 9l-1 1.1 1.3 1.9-1.3 1.9 1 1.1 2.2-3z"/></g>
+</svg>

package/dist/assets/icons/default.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#8a8a8a" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.35)" d="M15 2l4 4h-4z"/>
+  <g fill="#fff" opacity=".9"><rect x="8.5" y="10" width="7" height="1.4" rx=".7"/><rect x="8.5" y="13" width="7" height="1.4" rx=".7"/><rect x="8.5" y="16" width="4.5" height="1.4" rx=".7"/></g>
+</svg>

package/dist/assets/icons/doc.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#2b579a" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.22)" d="M15 2l4 4h-4z"/>
+  <text x="12" y="16.8" font-family="Arial, 'Segoe UI', Helvetica, sans-serif" font-size="11" font-weight="700" text-anchor="middle" fill="#fff">W</text>
+</svg>

package/dist/assets/icons/exe.svg

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <!-- 文档底：橙色，与 doc/xls/ppt/pdf/zip 同家族 -->
+  <path fill="#e8923a" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.35)" d="M15 2l4 4h-4z"/>
+  <!-- 白色齿轮：整体缩小，齿短且不张扬 -->
+  <g fill="#fff">
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35"/>
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35" transform="rotate(45 12 12)"/>
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35" transform="rotate(90 12 12)"/>
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35" transform="rotate(135 12 12)"/>
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35" transform="rotate(180 12 12)"/>
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35" transform="rotate(225 12 12)"/>
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35" transform="rotate(270 12 12)"/>
+    <rect x="11.4" y="7.6" width="1.2" height="2.2" rx=".35" transform="rotate(315 12 12)"/>
+    <circle cx="12" cy="12" r="3.4"/>
+  </g>
+  <!-- 中心孔（透出文档底色，强化齿轮观感） -->
+  <circle cx="12" cy="12" r="1.2" fill="#e8923a"/>
+</svg>

package/dist/assets/icons/folder.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#e3b341" d="M3 6h5l2 2h11v11H3z"/>
+  <path fill="#f0c860" d="M3 8h18v9H3z"/>
+  <path fill="#c8962f" d="M3 6h5l2 2h11v2H3z" opacity=".6"/>
+</svg>

package/dist/assets/icons/github.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">
+  <path fill="#8b949e" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8"/>
+</svg>

package/dist/assets/icons/image.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <rect x="3.5" y="5" width="17" height="14" rx="2.5" fill="#2bb0a3"/>
+  <circle cx="8" cy="9.5" r="2" fill="#fff"/>
+  <path d="M4 18.5 L9.5 12 L12.5 15 L15 12.5 L20 18.5 Z" fill="#fff" opacity="0.92"/>
+</svg>

package/dist/assets/icons/kofi.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">
+  <title>Ko-fi</title>
+  <path fill="none" stroke="#FF5E5B" stroke-width="1.5" stroke-linecap="round" d="M4.7 3.1V1.5M7.6 3.1V1.5"/>
+  <path fill="#FF5E5B" d="M1.7 4.4h9.3v5.4a3.5 3.5 0 0 1-3.5 3.5H5.2a3.5 3.5 0 0 1-3.5-3.5V4.4z"/>
+  <path fill="none" stroke="#FF5E5B" stroke-width="1.5" stroke-linecap="round" d="M11.4 6.1h1.1a2.2 2.2 0 0 1 0 4.4h-1.1"/>
+</svg>

package/dist/assets/icons/npm.svg

@@ -0,0 +1,5 @@
+<svg id="n" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16">
+  <title>n</title>
+  <path fill="#c12127" d="M0,16V0H16V16ZM3,3V13H8V5H3v8h2V3Z"/>
+  <path fill="#fff" d="M3,3H13V13H11V5H8v8H3Z"/>
+</svg>

package/dist/assets/icons/pdf.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#e2574c" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.35)" d="M15 2l4 4h-4z"/>
+  <g fill="#fff" opacity=".92"><rect x="8.5" y="10" width="7" height="1.5" rx=".75"/><rect x="8.5" y="13" width="7" height="1.5" rx=".75"/><rect x="8.5" y="16" width="4.5" height="1.5" rx=".75"/></g>
+</svg>

package/dist/assets/icons/ppt.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#d24726" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.22)" d="M15 2l4 4h-4z"/>
+  <text x="12" y="16.8" font-family="Arial, 'Segoe UI', Helvetica, sans-serif" font-size="11" font-weight="700" text-anchor="middle" fill="#fff">P</text>
+</svg>

package/dist/assets/icons/text.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#5b9bd5" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.35)" d="M15 2l4 4h-4z"/>
+  <g fill="#fff" opacity=".92"><rect x="8.5" y="9" width="7" height="1.4" rx=".7"/><rect x="8.5" y="12" width="7" height="1.4" rx=".7"/><rect x="8.5" y="15" width="4.5" height="1.4" rx=".7"/></g>
+</svg>

package/dist/assets/icons/video.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <rect x="3.5" y="5" width="17" height="14" rx="2" fill="#d2453f"/>
+  <path fill="#fff" d="M10 8.6 15.6 12 10 15.4z"/>
+</svg>

package/dist/assets/icons/xls.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <path fill="#217346" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.22)" d="M15 2l4 4h-4z"/>
+  <text x="12" y="16.8" font-family="Arial, 'Segoe UI', Helvetica, sans-serif" font-size="11" font-weight="700" text-anchor="middle" fill="#fff">S</text>
+</svg>

package/dist/assets/icons/zip.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16">
+  <!-- 文档底：紫色，与 doc/xls/ppt/pdf 同家族 -->
+  <path fill="#9b6dd6" d="M5 2h10l4 4v16H5z"/>
+  <path fill="rgba(255,255,255,.35)" d="M15 2l4 4h-4z"/>
+  <!-- 简洁拉链：居中竖轨 + 滑块 + 顶部拉环 -->
+  <g fill="#fff" opacity=".92">
+    <!-- 顶部拉环 -->
+    <rect x="10.8" y="5.2" width="2.4" height="1.3" rx=".65" transform="rotate(-15,12,5.85)"/>
+    <!-- 竖向轨道 -->
+    <rect x="11.3" y="7" width="1.4" height="12" rx=".7"/>
+    <!-- 中部滑块（闭合块，视觉焦点） -->
+    <rect x="9.4" y="11" width="5.2" height="3.2" rx="1.2"/>
+    <!-- 滑块上的小横纹（增加质感） -->
+    <line x1="11" y1="12.6" x2="13" y2="12.6" stroke="#9b6dd6" stroke-width=".8" stroke-linecap="round"/>
+  </g>
+</svg>