fdb2 1.0.34 → 1.0.36

package/README.md

@@ -2,14 +2,14 @@
 
 [中文](README_zh.md) | English
 
-> 🚀 A lightweight, open-source database management tool supporting 8+ database types, providing a Navicat Premium-like professional experience — completely free and running locally!
+> 🚀 A lightweight, open-source database management tool supporting 9+ database types, providing a Navicat Premium-like professional experience — completely free and running locally!
 
 ![fdb2 Preview](public/fdb2.png)
 
 ## 🔥 Core Features
 
 ### 🌐 Multi-Database Support
-- **8+ Database Types**: MySQL, PostgreSQL, SQLite, SQL Server, Oracle, CockroachDB, MongoDB, SAP HANA
+- **9+ Database Types**: MySQL, PostgreSQL, SQLite, SQL Server, Oracle, CockroachDB, MongoDB, SAP HANA, ClickHouse
 - **Compatibility Extensions**: MariaDB/TiDB/Aurora compatible with MySQL, Aurora PostgreSQL compatible with PostgreSQL
 - **NoSQL Support**: MongoDB document database
 
@@ -34,7 +34,7 @@
 
 #### 💻 Desktop Client (Recommended)
 Download the pre-built cross-platform desktop application for immediate use:
-- **[Windows / macOS / Linux Client Download](https://github.com/fefeding/fdb2/releases/tag/client)**
+- **[Windows / macOS / Linux Client Download](https://github.com/fefeding/fdb2/releases/)**
 - Unzip and double-click to run, no environment setup required
 
 #### 📦 Command Line Tool
@@ -78,6 +78,25 @@ http://localhost:9800
 
 > 💡 **Tip**: Default port is 9800, but if occupied, it will automatically select another available port
 
+## 🔌 VSCode Extension
+
+Prefer staying inside the editor? `fdb2` also ships as a **VSCode extension** — "Database Tool (fdb2)" — that embeds the same UI directly in VSCode.
+
+- **Native tree navigation** — a dedicated **Database Tool** view in the Activity Bar (Connection → Database → Table → Column). Click any node to open the related panel.
+- **Per-connection tabs** — the same connection reuses one editor tab while different connections open new tabs, so you can compare databases side by side.
+- **Rich content area** — connection overview, database detail, paginated table data (with a one-line pagination + page-size bar), table structure (columns/indexes/foreign keys/SQL), and a full SQL query panel (`Ctrl/Cmd+Enter` to run).
+- **Shared config** — connections are stored at `~/.fdb2/connections.json` and reused by both the desktop app and the extension (override with the `dbtool.dataDir` setting).
+- **Supported databases** — MySQL, PostgreSQL, SQL Server, SQLite, Oracle, CockroachDB, MongoDB, SAP HANA, ClickHouse (Oracle/SQLite/SAP HANA need native drivers compiled for VSCode's Node ABI).
+
+Install from the Marketplace (`Ctrl/Cmd+Shift+X` → search **"Database Tool (fdb2)"**), or build from source:
+
+```bash
+cd packages/vscode && npm install && npm run build
+# then press F5 in VSCode to launch the Extension Development Host
+```
+
+> For full setup, operations, settings, native-driver notes, and publishing, see [**packages/vscode/README.md**](packages/vscode/README.md).
+
 ## 📊 Supported Database Types
 
 | Database Type | Default Port | Key Features |
@@ -90,12 +109,14 @@ http://localhost:9800
 | **CockroachDB** | 26257 | Distributed SQL, strong consistency, automatic sharding |
 | **MongoDB** | 27017 | NoSQL document database, aggregation pipeline, indexing |
 | **SAP HANA** | 39013 | In-memory database, real-time analytics, column store |
+| **ClickHouse** | 8123 | Columnar store, real-time analytics, MergeTree engine, HTTP interface |
 
 ### 🔄 Compatibility Notes
 - **MariaDB/TiDB**: Compatible with MySQL protocol — select MySQL type
 - **Amazon Aurora MySQL**: Compatible with MySQL — select MySQL type
 - **Amazon Aurora PostgreSQL**: Compatible with PostgreSQL — select PostgreSQL type
 - **Better-SQLite3**: Compatible with SQLite — select SQLite type
+- **ClickHouse**: Connect via the HTTP interface (default port 8123) using Basic auth with the default user `default`; supports table/view browsing, schema inspection, data CRUD, SQL queries, backup and restore
 
 ## 🤝 Contribution Guide