25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。
TypeScript aicliclickhousedatabasedatabase-clientdatabase-managementdockerguimcpmongodbmysqlpostgresqlredisrustsql-serversqlitetaurivue
feat(plugin): add table-scoped context-menu contributions
jearhe78315c377a54
diff --git a/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue b/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vueindex 20ef01b888..41d61a25bf 100644--- a/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue+++ b/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue@@ -72,6 +72,7 @@ import { useSavedSqlStore } from "@/stores/savedSqlStore";import { savedSqlErrorMessage } from "@/lib/savedSql/savedSqlErrors";import { useToast } from "@/composables/useToast";import { createFrontendPluginRegistry } from "@/lib/plugins/frontendPlugin";+import { buildPluginTableContextMenuInvocation } from "@/lib/plugins/pluginContext";import type { InstalledPlugin } from "@/types/database";import { useDatabaseOptions } from "@/composables/useDatabaseOptions";import type { ColumnInfo, ConnectionConfig, DatabaseType, TreeNode, TreeNodeType } from "@/types/database";@@ -5981,6 +5982,7 @@ function buildSpecialSidebarMenu(context: SidebarMenuFactoryContext): boolean {variant: "destructive" as const,});}+ appendPluginTableMenuItems(items, node);return true;}@@ -6162,6 +6164,7 @@ function buildObjectSidebarMenu(context: SidebarMenuFactoryContext): boolean {items.push({ label: "", separator: true });items.push(exportDataSubmenu(false));items.push({ label: t("contextMenu.refreshChildren"), action: refresh, icon: RefreshCw, shortcut: shortcutRefresh });+ appendPluginTableMenuItems(items, node);return true;}const destructiveActions: ContextMenuItem[] = [];@@ -6301,6 +6304,7 @@ function buildObjectSidebarMenu(context: SidebarMenuFactoryContext): boolean {icon: RefreshCw,shortcut: shortcutRefresh,});+ appendPluginTableMenuItems(items, node);return true;}@@ -6746,6 +6750,36 @@ function appendPluginConnectionMenuItems(items: ContextMenuItem[], node: TreeNod}}+/** Plugin-contributed native menu entries for canonical table nodes. */+function appendPluginTableMenuItems(items: ContextMenuItem[], node: TreeNode) {+ if (node.type !== "table") return;+ const pluginItems = sidebarPluginRegistry.value.listContextMenuItems("table");+ if (pluginItems.length === 0) return;++ const tableItems: ContextMenuItem[] = [];+ for (const { plugin, contribution } of pluginItems) {+ const invocation = buildPluginTableContextMenuInvocation(contribution.id, node);+ if (!invocation) continue;+ tableItems.push({+ label: contribution.label,+ icon: PlugZap,+ action: () => {+ api+ .invokePlugin(plugin.manifest.id, invocation.method, invocation.params)+ .then((result) => {+ const message = (result as { message?: unknown } | null | undefined)?.message;+ if (typeof message === "string" && message.trim()) toast(message, 4000);+ })+ .catch((error: unknown) => {+ toast(String((error as Error)?.message || error), 5000);+ });+ },+ });+ }+ if (tableItems.length === 0) return;+ items.push({ label: "", separator: true }, ...tableItems);+}+function activateRuntimeNode(node: TreeNode) {activeNode.value = node;}diff --git a/apps/desktop/src/lib/__tests__/table/tableTree.spec.ts b/apps/desktop/src/lib/__tests__/table/tableTree.spec.tsindex d5634a5128..4fbe3edbe1 100644--- a/apps/desktop/src/lib/__tests__/table/tableTree.spec.ts+++ b/apps/desktop/src/lib/__tests__/table/tableTree.spec.ts@@ -72,6 +72,23 @@ describe("case-sensitive database objects", () => {expect(grouped.find((node) => node.type === "group-views")?.children?.map((node) => node.valid)).toEqual([false, true]);});+ it("stores the canonical table name separately from the display label", () => {+ const nodes = buildTableTreeNodes({+ ...context,+ schema: "public",+ tables: [+ { name: "users", table_type: "BASE TABLE" },+ { name: "active_users", table_type: "VIEW" },+ ],+ });+ const table = nodes.find((node) => node.type === "table");+ const view = nodes.find((node) => node.type === "view");++ expect(table).toMatchObject({ type: "table", label: "users", tableName: "users" });+ expect(view).toMatchObject({ type: "view", label: "active_users" });+ expect(view?.tableName).toBeUndefined();+ });+it("keeps table nodes whose names differ only by case across pages", () => {const firstPage = buildTableTreeNodes({...context,diff --git a/apps/desktop/src/lib/plugins/frontendPlugin.spec.ts b/apps/desktop/src/lib/plugins/frontendPlugin.spec.tsindex 777530b9df..b4c8220370 100644--- a/apps/desktop/src/lib/plugins/frontendPlugin.spec.ts+++ b/apps/desktop/src/lib/plugins/frontendPlugin.spec.ts@@ -214,15 +214,21 @@ describe("FrontendPluginRegistry", () => {const registry = createFrontendPluginRegistry([installedPlugin("com.example.plugin", [{ type: "context-menu", id: "example.inspect", label: "Inspect endpoint", menu: "connection" },- { type: "context-menu", id: "example.other", label: "Wrong surface", menu: "tree" },+ { type: "context-menu", id: "example.inspect-table", label: "Inspect table", menu: "table" },]),]);- const items = registry.listContextMenuItems("connection");- expect(items).toHaveLength(1);- expect(items[0]?.contribution.id).toBe("example.inspect");- expect(items[0]?.plugin.manifest.id).toBe("com.example.plugin");- expect(registry.listContextMenuItems("tree")).toHaveLength(1);+ const connectionItems = registry.listContextMenuItems("connection");+ expect(connectionItems).toHaveLength(1);+ expect(connectionItems[0]?.contribution.id).toBe("example.inspect");+ expect(connectionItems[0]?.plugin.manifest.id).toBe("com.example.plugin");++ const tableItems = registry.listContextMenuItems("table");+ expect(tableItems).toHaveLength(1);+ expect(tableItems[0]?.contribution.id).toBe("example.inspect-table");++ const emptyRegistry = createFrontendPluginRegistry([installedPlugin("com.example.empty")]);+ expect(emptyRegistry.listContextMenuItems("table")).toHaveLength(0);expect(registry.listContextMenuItems("missing")).toHaveLength(0);});diff --git a/apps/desktop/src/lib/plugins/frontendPlugin.ts b/apps/desktop/src/lib/plugins/frontendPlugin.tsindex 069b305c68..4e5245f0bc 100644--- a/apps/desktop/src/lib/plugins/frontendPlugin.ts+++ b/apps/desktop/src/lib/plugins/frontendPlugin.ts@@ -58,7 +58,7 @@ export class FrontendPluginRegistry {return this.listContributions("filesystem-provider");}- /** Native context-menu entries declared for a specific menu surface such as `connection`. */+ /** Native context-menu entries declared for a specific menu surface. */listContextMenuItems(menu: string): PluginContributionEntry<PluginContextMenuContribution>[] {return this.listContributions("context-menu").filter((entry) => entry.contribution.menu === menu);}diff --git a/apps/desktop/src/lib/plugins/pluginContext.spec.ts b/apps/desktop/src/lib/plugins/pluginContext.spec.tsnew file mode 100644index 0000000000..234df67785--- /dev/null+++ b/apps/desktop/src/lib/plugins/pluginContext.spec.ts@@ -0,0 +1,63 @@+import { describe, expect, it } from "vitest";+import type { TreeNode } from "@/types/database";+import { buildPluginTableContext, buildPluginTableContextMenuInvocation } from "./pluginContext";++function tableNode(overrides: Partial<TreeNode> = {}): TreeNode {+ return {+ id: "connection:demo:public:users",+ label: "users",+ type: "table",+ connectionId: "conn-1",+ database: "demo",+ schema: "public",+ tableName: "users",+ ...overrides,+ };+}++describe("plugin table context", () => {+ it("builds the public context from canonical table metadata", () => {+ expect(buildPluginTableContext(tableNode())).toEqual({+ connectionId: "conn-1",+ database: "demo",+ schema: "public",+ table: "users",+ });+ });++ it("omits optional database and schema values when the node has no scope", () => {+ expect(buildPluginTableContext(tableNode({ database: undefined, schema: undefined }))).toEqual({+ connectionId: "conn-1",+ table: "users",+ });+ expect(buildPluginTableContext(tableNode({ database: "", schema: "" }))).toEqual({+ connectionId: "conn-1",+ table: "users",+ });+ });++ it("fails closed when canonical table identity is missing instead of using the label", () => {+ const node = tableNode({ tableName: undefined, label: "users" });++ expect(buildPluginTableContext(node)).toBeNull();+ expect(buildPluginTableContextMenuInvocation("example.inspect", node)).toBeNull();+ });++ it("prepares the existing contextMenu backend invocation without secrets", () => {+ expect(buildPluginTableContextMenuInvocation("example.inspect", tableNode())).toEqual({+ method: "contextMenu/example.inspect",+ params: {+ table: {+ connectionId: "conn-1",+ database: "demo",+ schema: "public",+ table: "users",+ },+ },+ });+ });++ it("does not build table context for non-table nodes", () => {+ expect(buildPluginTableContext(tableNode({ type: "view" }))).toBeNull();+ });+});diff --git a/apps/desktop/src/lib/plugins/pluginContext.ts b/apps/desktop/src/lib/plugins/pluginContext.tsnew file mode 100644index 0000000000..34f08673cd--- /dev/null+++ b/apps/desktop/src/lib/plugins/pluginContext.ts@@ -0,0 +1,44 @@+import type { PluginTableContext, TreeNode } from "@/types/database";++export type PluginTableContextNode = Pick<TreeNode, "type" | "connectionId" | "database" | "schema" | "tableName">;++export interface PluginContextMenuInvocation {+ method: string;+ params: {+ table: PluginTableContext;+ };+}++function nonEmptyContextValue(value: string | undefined): string | undefined {+ const normalized = value?.trim();+ return normalized || undefined;+}++/**+ * Builds the public table identity from the sidebar node's canonical metadata.+ * Display labels are deliberately not part of this input or its fallback path.+ */+export function buildPluginTableContext(node: PluginTableContextNode): PluginTableContext | null {+ if (node.type !== "table") return null;++ const connectionId = nonEmptyContextValue(node.connectionId);+ const table = nonEmptyContextValue(node.tableName);+ if (!connectionId || !table) return null;++ const context: PluginTableContext = { connectionId, table };+ const database = nonEmptyContextValue(node.database);+ const schema = nonEmptyContextValue(node.schema);+ if (database !== undefined) context.database = database;+ if (schema !== undefined) context.schema = schema;+ return context;+}++export function buildPluginTableContextMenuInvocation(contributionId: string, node: PluginTableContextNode): PluginContextMenuInvocation | null {+ if (!contributionId.trim()) return null;+ const table = buildPluginTableContext(node);+ if (!table) return null;+ return {+ method: `contextMenu/${contributionId}`,+ params: { table },+ };+}diff --git a/apps/desktop/src/lib/table/tableTree.ts b/apps/desktop/src/lib/table/tableTree.tsindex 023c1d79a1..2c4e7110c3 100644--- a/apps/desktop/src/lib/table/tableTree.ts+++ b/apps/desktop/src/lib/table/tableTree.ts@@ -87,6 +87,7 @@ function makeTableTreeEntry({database,schema,catalog,+ ...(objectType === "TABLE" ? { tableName: name } : {}),isExpanded: false,children: [],};diff --git a/apps/desktop/src/stores/__tests__/connectionStore.metadataLoading.spec.ts b/apps/desktop/src/stores/__tests__/connectionStore.metadataLoading.spec.tsindex 69cb77f287..ed62a4849b 100644--- a/apps/desktop/src/stores/__tests__/connectionStore.metadataLoading.spec.ts+++ b/apps/desktop/src/stores/__tests__/connectionStore.metadataLoading.spec.ts@@ -848,7 +848,7 @@ describe("connectionStore metadata loading", () => {});it("keeps concurrent table-tree and local-index refreshes in separate cache entries", async () => {- const treeCacheKey = "pg-1:app:public:group-tables:objects-v8";+ const treeCacheKey = "pg-1:app:public:group-tables:objects-v9";const indexCacheKey = `${treeCacheKey}:table-search-index-v1`;const cachedPayloads = new Map<string, unknown>([[@@ -1031,7 +1031,7 @@ describe("connectionStore metadata loading", () => {expect(storedViewGroup?.type).toBe("group-views");await store.loadObjectGroupChildren(storedViewGroup!);- expect(loadSchemaCache).toHaveBeenCalledWith("oracle-1:XE:DIP:group-views:objects-v7");+ expect(loadSchemaCache).toHaveBeenCalledWith("oracle-1:XE:DIP:group-views:objects-v8");expect(listTables).toHaveBeenCalledWith(connection.id, "XE", "DIP", undefined, 201, 0, ["VIEW"]);expect(storedViewGroup?.children?.map((node) => node.label)).toEqual(["V_ONE", "V_THREE", "V_TWO"]);});@@ -2999,7 +2999,7 @@ describe("connectionStore metadata loading", () => {const loadPromise = store.loadTables(connection.id, "prulife", "xtdpcky", { force: true });await vi.waitFor(() => expect(saveSchemaCache).toHaveBeenCalledTimes(1));- expect(saveSchemaCache.mock.calls[0]?.[0]).toBe(`${connection.id}:prulife:xtdpcky:objects-grouped-v8-informix-owner-v2`);+ expect(saveSchemaCache.mock.calls[0]?.[0]).toBe(`${connection.id}:prulife:xtdpcky:objects-grouped-v9-informix-owner-v2`);expect(schemaNode.isLoading).toBe(true);schemaNode.isExpanded = false;diff --git a/apps/desktop/src/stores/connectionStore.ts b/apps/desktop/src/stores/connectionStore.tsindex 0166175d94..6e5af9ed70 100644--- a/apps/desktop/src/stores/connectionStore.ts+++ b/apps/desktop/src/stores/connectionStore.ts@@ -2156,9 +2156,9 @@ export const useConnectionStore = defineStore("connection", () => {function objectGroupCacheKey(node: TreeNode): string {const config = node.connectionId ? getConfig(node.connectionId) : undefined;const objectTreeProfileCacheKey = driverProfileObjectTreeProfileForConnection(config)?.cacheKey;- // objects-v8: object-group listing SQL gained a pg_type branch for- // PostgreSQL-family user-defined types; older cached lists miss TYPE nodes.- const baseCacheVersion = objectTreeCacheVersion(config, node.database, node.schema, config?.db_type === "oracle" ? "objects-v7" : "objects-v8");+ // objects-v9: table nodes now carry canonical tableName metadata for+ // table-scoped plugin context; older cached nodes lack that identity.+ const baseCacheVersion = objectTreeCacheVersion(config, node.database, node.schema, config?.db_type === "oracle" ? "objects-v8" : "objects-v9");const cacheVersion = objectTreeProfileCacheKey ? `${baseCacheVersion}:${objectTreeProfileCacheKey}` : baseCacheVersion;return schemaCacheKey(node.connectionId || "", node.database || "", node.schema || "", node.type, cacheVersion);}@@ -2824,7 +2824,7 @@ export const useConnectionStore = defineStore("connection", () => {if (parent.type === "group-tables") return objectGroupCacheKey(parent);if (parent.type !== "database" && parent.type !== "schema" && parent.type !== "linked-server-schema") return null;const simpleObjectDisplay = useSettingsStore().editorSettings.sidebarObjectDisplay === "simple";- const cacheVersion = ownerAwareMetadataCacheVersion(getConfig(parent.connectionId), simpleObjectDisplay ? "objects-simple-v8" : "objects-grouped-v8");+ const cacheVersion = ownerAwareMetadataCacheVersion(getConfig(parent.connectionId), simpleObjectDisplay ? "objects-simple-v9" : "objects-grouped-v9");return schemaCacheKey(parent.connectionId, parent.database, parent.schema || "", cacheVersion);}@@ -5990,7 +5990,7 @@ export const useConnectionStore = defineStore("connection", () => {nodeKind: "simple-tables",catalog,});- const cacheKey = schemaCacheKey(connectionId, `doris-catalog:${catalog}`, database, "objects-simple-v5");+ const cacheKey = schemaCacheKey(connectionId, `doris-catalog:${catalog}`, database, "objects-simple-v6");if (!options?.force && !searchFilter && !tableNameFilter) {const cached = await loadPersistedTreeChildren(node, cacheKey, load);if (cached.hit) {@@ -6057,7 +6057,7 @@ export const useConnectionStore = defineStore("connection", () => {// collapses that to the database node id, so the loaded tables were attached to the// database node instead of the schema node, leaving `(default)` permanently empty.const nodeId = schema != null ? `${connectionId}:${database}:${schema}` : `${connectionId}:${database}`;- const cacheKey = schemaCacheKey(connectionId, database, schema || "", objectTreeCacheVersion(configForScope, database, schema, "objects-simple-v8"));+ const cacheKey = schemaCacheKey(connectionId, database, schema || "", objectTreeCacheVersion(configForScope, database, schema, "objects-simple-v9"));if (await hydrateTreeNodeFromCache(findNode(treeNodes.value, nodeId), cacheKey)) {void loadTables(connectionId, database, schema, { ...options, force: true }).catch(() => undefined);return;@@ -6097,7 +6097,7 @@ export const useConnectionStore = defineStore("connection", () => {const objectTreeProfile = driverProfileObjectTreeProfileForConnection(config);const isPublicSynonymScope = config?.db_type === "xugu" && isXuguPublicSynonymScope(schema);const isSchedulerJobScope = config?.db_type === "xugu" && isXuguSchedulerJobScope(schema);- const baseCacheVersion = objectTreeCacheVersion(config, database, schema, simpleObjectDisplay ? "objects-simple-v8" : "objects-grouped-v8");+ const baseCacheVersion = objectTreeCacheVersion(config, database, schema, simpleObjectDisplay ? "objects-simple-v9" : "objects-grouped-v9");const cacheVersion = !simpleObjectDisplay && objectTreeProfile?.cacheKey ? `${baseCacheVersion}:${objectTreeProfile.cacheKey}` : baseCacheVersion;const cacheKey = schemaCacheKey(connectionId, database, schema || "", cacheVersion);const querySchema = connectionObjectTreeQuerySchema(config, database, schema);@@ -6438,7 +6438,7 @@ export const useConnectionStore = defineStore("connection", () => {targetParent.objectCount = mergedChildren.length;setChildren(targetParent, nextChildren);if (!options?.searchFilter) {- await savePersistedTreeChildren(schemaCacheKey(parentConnectionId, parentDatabase, parent.schema || "", ownerAwareMetadataCacheVersion(config, "objects-simple-v8")), nextChildren);+ await savePersistedTreeChildren(schemaCacheKey(parentConnectionId, parentDatabase, parent.schema || "", ownerAwareMetadataCacheVersion(config, "objects-simple-v9")), nextChildren);}// 该分支只服务 simple 库/模式表列表;搜索分页结果不是全量,不能作为成员依据。if (!page.hasMore && !options?.searchFilter) pruneTableVGroupStaleMembers(targetParent, nextChildren, true);diff --git a/apps/desktop/src/types/database.ts b/apps/desktop/src/types/database.tsindex eb9a80fea9..f4289b3206 100644--- a/apps/desktop/src/types/database.ts+++ b/apps/desktop/src/types/database.ts@@ -459,13 +459,22 @@ export interface PluginFilesystemMutationResult {entry?: PluginFilesystemEntry;}+export type PluginContextMenuTarget = "connection" | "table";++export interface PluginTableContext {+ connectionId: string;+ database?: string;+ schema?: string;+ table: string;+}+export interface PluginContextMenuContribution {type: "context-menu";id: string;label: string;description?: string;icon?: string;- menu: string;+ menu: PluginContextMenuTarget;}export interface PluginResultViewContribution {diff --git a/crates/dbx-plugin-runtime/src/plugins/manifest.rs b/crates/dbx-plugin-runtime/src/plugins/manifest.rsindex 4bd428e497..e1d9a09236 100644--- a/crates/dbx-plugin-runtime/src/plugins/manifest.rs+++ b/crates/dbx-plugin-runtime/src/plugins/manifest.rs@@ -648,8 +648,8 @@ pub struct PluginWorkbenchContribution {}/// Native context-menu entry contributed to DBX surfaces. v1 targets the-/// saved-connection sidebar menu; clicks are dispatched to the plugin backend-/// as `contextMenu/<id>` requests.+/// saved-connection and table sidebar menus; clicks are dispatched to the+/// plugin backend as `contextMenu/<id>` requests.#[derive(Debug, Clone, Serialize, Deserialize)]#[serde(deny_unknown_fields)]pub struct PluginContextMenuContribution {@@ -659,7 +659,7 @@ pub struct PluginContextMenuContribution {pub description: Option<String>,#[serde(default, skip_serializing_if = "Option::is_none")]pub icon: Option<String>,- /// Menu surface the item belongs to; currently only `connection`.+ /// Menu surface the item belongs to: `connection` or `table`.#[serde(default)]pub menu: String,}@@ -1130,9 +1130,9 @@ fn validate_contributions(PluginContribution::ContextMenu(menu) => {validate_required_text(&menu.label, &format!("Context menu '{id}' label"), errors);validate_declared_icon(plugin_dir, &format!("Context menu '{id}' icon"), menu.icon.as_deref(), errors);- if menu.menu != "connection" {+ if menu.menu != "connection" && menu.menu != "table" {errors.push(format!(- "Context menu '{id}' declares unsupported menu '{}'; only 'connection' is available",+ "Context menu '{id}' declares unsupported menu '{}'; only 'connection' and 'table' are available",menu.menu));}@@ -1488,6 +1488,30 @@ mod tests {PluginManifest, SUPPORTED_PLUGIN_HOST_API_VERSION, SUPPORTED_PLUGIN_PERMISSIONS,};+ fn context_menu_manifest(menu: &str) -> (tempfile::TempDir, PluginManifest) {+ let dir = tempfile::tempdir().unwrap();+ let executable = dir.path().join("bin").join("example");+ std::fs::create_dir_all(executable.parent().unwrap()).unwrap();+ std::fs::write(&executable, b"example").unwrap();+ let manifest = serde_json::from_value(serde_json::json!({+ "manifest_version": 1,+ "id": "io.dbx.example",+ "name": "Example",+ "version": "1.0.0",+ "publisher": "example",+ "engines": { "dbx": ">=0.1.0", "host_api": "^1.0" },+ "entrypoints": { "backend": { "executable": "bin/example" } },+ "contributions": [{+ "type": "context-menu",+ "id": "io.dbx.example.inspect",+ "label": "Inspect",+ "menu": menu+ }]+ }))+ .unwrap();+ (dir, manifest)+ }+#[test]fn connection_provider_proxy_route_defaults_false_and_parses() {let provider: PluginConnectionProviderContribution = serde_json::from_value(serde_json::json!({@@ -1651,6 +1675,43 @@ mod tests {manifest.compatibility(dir.path(), "0.1.0").errors}+ #[test]+ fn accepts_connection_and_table_context_menu_targets() {+ for menu in ["connection", "table"] {+ let (dir, manifest) = context_menu_manifest(menu);+ let compatibility = manifest.compatibility(dir.path(), "0.1.0");+ assert!(compatibility.compatible, "{menu}: {:?}", compatibility.errors);+ }+ }++ #[test]+ fn rejects_unsupported_context_menu_targets() {+ let (dir, manifest) = context_menu_manifest("schema");+ let compatibility = manifest.compatibility(dir.path(), "0.1.0");+ assert!(!compatibility.compatible);+ assert!(compatibility.errors.iter().any(|error| {+ error == "Context menu 'io.dbx.example.inspect' declares unsupported menu 'schema'; only 'connection' and 'table' are available"+ }));+ }++ #[test]+ fn manifest_schema_context_menu_enum_matches_runtime_targets() {+ let schema_path = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))+ .join("..")+ .join("..")+ .join("plugins")+ .join("manifest.schema.json");+ let schema: serde_json::Value = serde_json::from_str(&std::fs::read_to_string(&schema_path).unwrap()).unwrap();+ let declared = schema["$defs"]["contextMenuContribution"]["properties"]["menu"]["enum"]+ .as_array()+ .expect("contextMenuContribution.menu.enum must be an array")+ .iter()+ .map(|value| value.as_str().unwrap().to_string())+ .collect::<Vec<_>>();++ assert_eq!(declared, ["connection", "table"]);+ }+#[test]fn validates_manifest_v1_and_resolves_package_executable() {let dir = tempfile::tempdir().unwrap();diff --git a/docs/content/docs/plugin-development.cn.mdx b/docs/content/docs/plugin-development.cn.mdxindex 57bdec7e50..121f2eaa01 100644--- a/docs/content/docs/plugin-development.cn.mdx+++ b/docs/content/docs/plugin-development.cn.mdx@@ -213,9 +213,24 @@ Manifest 中的路径相对于包根目录,不能以 `/` 开头、不能包含| --- | --- | --- || `workbench` | `type`, `id`, `label` | 注册可从侧边栏或插件入口打开的工作台。 || `filesystem-provider` | `type`, `id`, `label`, `schemes` | 注册虚拟文件系统;`root_uri` 例如 `s3://bucket`,能力可选 `read`、`write`、`delete`、`rename`、`mkdir`。 |-| `context-menu` | `type`, `id`, `label`, `menu: "connection"` | 向连接的右键菜单增加动作。 |+| `context-menu` | `type`、`id`、`label`、`menu: "connection"` 或 `"table"` | 向 Sidebar Tree 的连接或 table 右键菜单增加动作。 || `result-view` | `type`, `id`, `label` | 注册查询或任务结果视图。 |+`menu: "table"` contribution 当前只在用户对 Sidebar Tree 中的具体 table 节点打开右键菜单时生效。DBX 通过必需的 backend entrypoint 调用 `contextMenu/<contribution-id>`,并传递 table identity:++```json+{+ "table": {+ "connectionId": "connection-id",+ "database": "example",+ "schema": "public",+ "table": "users"+ }+}+```++`database` 和 `schema` 是可选字段;不可用时会省略,不会强制传递空字符串。该 context 只包含对象 identity,不包含 credential、connection string 或原始连接配置。Object Browser 后续可以复用相同 identity contract,但本次版本没有把它作为 table 菜单入口。+同一插件内通过 `id` 互相引用:Connection Provider 的 `workbench` 必须指向一个已声明的工作台,`filesystem_provider` 必须指向一个已声明的文件系统 Provider。图标优先使用 Contribution 的 `icon`,缺失时回退到插件级 `icon`。自定义文件浏览器应使用 `workbench`:列表、虚拟滚动、预览、右键菜单和分栏由插件前端实现。只有希望使用 DBX 通用文件管理器时才选择 `filesystem_provider`;同时声明两者时默认打开工作台。`context-menu` 调用后端 `contextMenu/<contribution-id>`,`result-view` 则在工作台 context 中接收结果快照,被打开的 contribution id 会通过 `dbx-plugin-init` 负载下发,因此单个 UI 入口可以为多个工作台和结果视图服务;具体负载见[完整贡献点协议](https://github.com/t8y2/dbx/blob/main/plugins/README.md)。diff --git a/docs/content/docs/plugin-development.mdx b/docs/content/docs/plugin-development.mdxindex df361f19da..f81587a74d 100644--- a/docs/content/docs/plugin-development.mdx+++ b/docs/content/docs/plugin-development.mdx@@ -213,9 +213,24 @@ Action `when` accepts `always`, `create`, or `edit`; `variant` accepts `default`| --- | --- | --- || `workbench` | `type`, `id`, `label` | Registers a workbench opened from the sidebar or plugin entry. || `filesystem-provider` | `type`, `id`, `label`, `schemes` | Registers a virtual filesystem; `root_uri` can be `s3://bucket`, with optional `read`, `write`, `delete`, `rename`, and `mkdir` capabilities. |-| `context-menu` | `type`, `id`, `label`, `menu: "connection"` | Adds an action to a connection context menu. |+| `context-menu` | `type`, `id`, `label`, `menu: "connection"` or `"table"` | Adds an action to a Sidebar Tree connection or table context menu. || `result-view` | `type`, `id`, `label` | Registers a query or task result view. |+A `menu: "table"` contribution is currently exposed when the user opens a context menu on a concrete table node in the Sidebar Tree. DBX invokes the required backend entrypoint as `contextMenu/<contribution-id>` with the table identity:++```json+{+ "table": {+ "connectionId": "connection-id",+ "database": "example",+ "schema": "public",+ "table": "users"+ }+}+```++`database` and `schema` are optional and are omitted when unavailable. The context contains no credential, connection string, or raw connection configuration. Object Browser can reuse this identity contract in a later contribution surface, but it is not a table menu surface in this release.+Reference contributions by ID: a connection provider's `workbench` must point to a declared workbench and `filesystem_provider` to a declared filesystem provider. A contribution icon takes precedence over the plugin-level icon.Choose `workbench` for a custom file browser: the plugin owns its list, virtualization, previews, context menus, and split panes. Choose `filesystem_provider` only to use DBX's generic file manager; declaring both defaults to the workbench. `context-menu` invokes `contextMenu/<contribution-id>` on the backend; `result-view` receives a result snapshot in workbench context, and the opened contribution id arrives in the `dbx-plugin-init` payload so one UI entrypoint can serve several workbenches and result views. See the [full contribution protocol](https://github.com/t8y2/dbx/blob/main/plugins/README.md) for payloads.diff --git a/plugins/README.md b/plugins/README.mdindex 521618bddd..ac6117aa57 100644--- a/plugins/README.md+++ b/plugins/README.md@@ -431,7 +431,7 @@ The `context.result` snapshot is bounded — `{ columns, rows (<= 500), truncate### `context-menu`-A context-menu entry is rendered **natively** by DBX (no sandbox iframe, native theme and keyboard behavior) in the declared menu surface. v1 supports the saved-connection sidebar menu:+A context-menu entry is rendered **natively** by DBX (no sandbox iframe, native theme and keyboard behavior) in the declared menu surface. v1 supports the saved-connection and table menus in the Sidebar Tree. Object Browser integration is not part of the first table contribution surface.```json{@@ -442,7 +442,31 @@ A context-menu entry is rendered **natively** by DBX (no sandbox iframe, native}```-Clicking the item dispatches a `contextMenu/<id>` backend request with a non-secret connection summary (`{ id, dbType, name, database }`). The backend entrypoint is required; return `{ "message": "..." }` to surface a toast.+For a table-scoped action, declare `menu: "table"`:++```json+{+ "type": "context-menu",+ "id": "example.inspect-table",+ "label": "Inspect table",+ "menu": "table"+}+```++Clicking a connection item dispatches `contextMenu/<id>` with a non-secret connection summary (`{ id, dbType, name, database }`). Clicking a table item uses the same backend method and dispatches:++```json+{+ "table": {+ "connectionId": "connection-id",+ "database": "example",+ "schema": "public",+ "table": "users"+ }+}+```++`database` and `schema` are optional and are omitted when the selected database does not expose those scopes. The table context contains object identity only; it never contains credentials, connection strings, or raw connection configuration. The backend entrypoint is required; return `{ "message": "..." }` to surface a toast.### `filesystem-provider`diff --git a/plugins/manifest.schema.json b/plugins/manifest.schema.jsonindex ab82c20318..dce5101ed5 100644--- a/plugins/manifest.schema.json+++ b/plugins/manifest.schema.json@@ -325,7 +325,7 @@"label": { "type": "string", "minLength": 1 },"description": { "type": "string" },"icon": { "$ref": "#/$defs/assetPath" },- "menu": { "const": "connection" }+ "menu": { "enum": ["connection", "table"] }}},"resultViewContribution": {