From 29848b0bfb4143431af0cd3dbfdf5d6833b136ea Mon Sep 17 00:00:00 2001
From: t8y2 <1156263951@qq.com>
Date: Fri, 11 Sep 2026 23:34:44 +0800
Subject: [PATCH] feat(plugins): expose installed plugin project links

---
 .../plugins/PluginContributionsPanel.vue      | 62 +++++++++++++++++--
 apps/desktop/src/i18n/locales/en.ts           |  2 +
 apps/desktop/src/i18n/locales/es.ts           |  2 +
 apps/desktop/src/i18n/locales/it.ts           |  2 +
 apps/desktop/src/i18n/locales/ja.ts           |  2 +
 apps/desktop/src/i18n/locales/ko.ts           |  2 +
 apps/desktop/src/i18n/locales/pt-BR.ts        |  2 +
 apps/desktop/src/i18n/locales/zh-CN.ts        |  2 +
 apps/desktop/src/i18n/locales/zh-TW.ts        |  2 +
 apps/desktop/src/types/database.ts            |  2 +
 crates/dbx-core/src/plugins/manifest.rs       |  4 ++
 plugins/GETTING_STARTED.zh-CN.md              |  2 +
 plugins/README.md                             |  2 +
 .../examples/hello-workbench/manifest.json    |  2 +
 plugins/manifest.schema.json                  |  2 +
 plugins/sdk/cli/src/lib.rs                    |  2 +
 16 files changed, 90 insertions(+), 4 deletions(-)

diff --git a/apps/desktop/src/components/plugins/PluginContributionsPanel.vue b/apps/desktop/src/components/plugins/PluginContributionsPanel.vue
index a0ac6925fb..b2ff8608b6 100644
--- a/apps/desktop/src/components/plugins/PluginContributionsPanel.vue
+++ b/apps/desktop/src/components/plugins/PluginContributionsPanel.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
-import { computed, onBeforeUnmount, onMounted, ref, watch } from "vue";
-import { Check, ChevronRight, CircleAlert, Download, ExternalLink, FileUp, FolderTree, Loader2, PackageCheck, Pencil, Plus, RefreshCw, RotateCcw, Search, Settings2, ShieldCheck, Store, Trash2 } from "@lucide/vue";
+import { computed, h, onBeforeUnmount, onMounted, ref, watch } from "vue";
+import { Check, ChevronRight, CircleAlert, Download, ExternalLink, FileUp, FolderTree, Globe, Loader2, PackageCheck, Pencil, Plus, RefreshCw, RotateCcw, Search, Settings2, ShieldCheck, Store, Trash2 } from "@lucide/vue";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
@@ -29,6 +29,17 @@ const emit = defineEmits<{
   newConnection: [pluginId: string, providerId: string];
 }>();
 
+// lucide no longer ships brand icons; mirror the inline glyph used in AppToolbar.
+const GithubIcon = {
+  render() {
+    return h("svg", { class: "size-3", viewBox: "0 0 24 24", fill: "currentColor" }, [
+      h("path", {
+        d: "M12 0C5.37 0 0 5.37 0 12c0 5.3 3.438 9.8 8.205 11.387.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61-.546-1.387-1.333-1.756-1.333-1.756-1.09-.745.083-.729.083-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 21.795 24 17.295 24 12 24 5.37 18.627 0 12 0z",
+      }),
+    ]);
+  },
+};
+
 const PLUGIN_ALLOW_UNSIGNED_STORAGE_KEY = "dbx-plugin-allow-unsigned";
 
 type TauriFileDropPayload = { type: "enter"; paths: string[]; position: { x: number; y: number } } | { type: "over"; position: { x: number; y: number } } | { type: "drop"; paths: string[]; position: { x: number; y: number } } | { type: "leave" };
@@ -91,6 +102,19 @@ const catalogErrors = computed(() => catalogResults.value.filter((result) => res
 const customRepositories = computed(() => repositories.value.filter((repository) => !repository.managed));
 const showCustomRepositoryTrustSettings = computed(() => customRepositories.value.length > 0 || trustedKeys.value.length > 0);
 
+function openExternal(url?: string) {
+  const target = url?.trim();
+  if (!target) return;
+  try {
+    const parsed = new URL(target);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return;
+  } catch {
+    return;
+  }
+  if (isTauriRuntime()) void import("@tauri-apps/plugin-shell").then(({ open }) => open(target));
+  else window.open(target, "_blank", "noopener,noreferrer");
+}
+
 async function refresh(preferredPluginId = props.focusTarget?.pluginId || selectedPluginId.value) {
   loading.value = true;
   error.value = "";
@@ -510,7 +534,15 @@ onBeforeUnmount(() => {
                     <span class="truncate text-sm font-semibold">{{ listing.name }}</span>
                     <Badge v-if="listing.verified" variant="secondary" class="h-5 gap-1 px-1.5 text-[10px]"><ShieldCheck class="size-3" />{{ t("pluginPlatform.verified") }}</Badge>
                   </div>
-                  <div class="mt-1 truncate text-[11px] text-muted-foreground">{{ listing.plugin.publisher }} · {{ listing.repository.name }}</div>
+                  <div class="mt-1 flex min-w-0 items-center gap-1 text-[11px] text-muted-foreground">
+                    <span class="truncate">{{ listing.plugin.publisher }} · {{ listing.repository.name }}</span>
+                    <button v-if="listing.plugin.source" type="button" class="shrink-0 rounded p-0.5 opacity-60 transition-opacity hover:opacity-100" :title="t('pluginPlatform.sourceRepository')" :aria-label="t('pluginPlatform.sourceRepository')" @click.stop="openExternal(listing.plugin.source)">
+                      <GithubIcon />
+                    </button>
+                    <button v-if="listing.plugin.homepage" type="button" class="shrink-0 rounded p-0.5 opacity-60 transition-opacity hover:opacity-100" :title="t('pluginPlatform.pluginHomepage')" :aria-label="t('pluginPlatform.pluginHomepage')" @click.stop="openExternal(listing.plugin.homepage)">
+                      <Globe class="size-3" />
+                    </button>
+                  </div>
                 </div>
                 <Badge variant="outline" class="h-5 px-1.5 text-[10px]">v{{ listing.plugin.latestVersion }}</Badge>
               </div>
@@ -582,7 +614,29 @@ onBeforeUnmount(() => {
                   <div class="min-w-0">
                     <div class="text-sm font-medium">{{ selectedDefinition.plugin.manifest.name }}</div>
                     <div class="mt-1 text-xs leading-5 text-muted-foreground">{{ selectedDefinition.plugin.manifest.description }}</div>
-                    <div class="mt-1 font-mono text-[10px] text-muted-foreground">{{ selectedDefinition.plugin.manifest.id }}</div>
+                    <div class="mt-1 flex flex-wrap items-center gap-1.5">
+                      <span class="font-mono text-[10px] text-muted-foreground">{{ selectedDefinition.plugin.manifest.id }}</span>
+                      <button
+                        v-if="selectedDefinition.plugin.manifest.source"
+                        type="button"
+                        class="rounded p-0.5 text-muted-foreground opacity-70 transition-opacity hover:text-foreground hover:opacity-100"
+                        :title="t('pluginPlatform.sourceRepository')"
+                        :aria-label="t('pluginPlatform.sourceRepository')"
+                        @click="openExternal(selectedDefinition.plugin.manifest.source)"
+                      >
+                        <GithubIcon />
+                      </button>
+                      <button
+                        v-if="selectedDefinition.plugin.manifest.homepage"
+                        type="button"
+                        class="rounded p-0.5 text-muted-foreground opacity-70 transition-opacity hover:text-foreground hover:opacity-100"
+                        :title="t('pluginPlatform.pluginHomepage')"
+                        :aria-label="t('pluginPlatform.pluginHomepage')"
+                        @click="openExternal(selectedDefinition.plugin.manifest.homepage)"
+                      >
+                        <Globe class="size-3" />
+                      </button>
+                    </div>
                   </div>
                 </div>
                 <div class="flex gap-2">
diff --git a/apps/desktop/src/i18n/locales/en.ts b/apps/desktop/src/i18n/locales/en.ts
index e5620ebb3a..d7f98b3f31 100644
--- a/apps/desktop/src/i18n/locales/en.ts
+++ b/apps/desktop/src/i18n/locales/en.ts
@@ -182,6 +182,8 @@ export default {
     unsupportedTarget: "Not available for {target}",
     installedVersion: "Installed v{version}",
     licenseUnknown: "License not specified",
+    sourceRepository: "Source repository",
+    pluginHomepage: "Homepage",
     marketplaceStatus: {
       install: "Install",
       installed: "Installed",
diff --git a/apps/desktop/src/i18n/locales/es.ts b/apps/desktop/src/i18n/locales/es.ts
index d4014cc559..cab554d456 100644
--- a/apps/desktop/src/i18n/locales/es.ts
+++ b/apps/desktop/src/i18n/locales/es.ts
@@ -184,6 +184,8 @@ export default withEnglishFallback({
     unsupportedTarget: "No disponible para {target}",
     installedVersion: "Instalado v{version}",
     licenseUnknown: "Licencia no especificada",
+    sourceRepository: "Repositorio de código fuente",
+    pluginHomepage: "Página principal",
     marketplaceStatus: { install: "Instalar", installed: "Instalado", update: "Actualizar", unsupported: "No compatible" },
     updateSuccess: "Se actualizó {name} a {version}",
     noInstalledPlugins: "No hay plugins instalados",
diff --git a/apps/desktop/src/i18n/locales/it.ts b/apps/desktop/src/i18n/locales/it.ts
index 51429267ea..fac8772188 100644
--- a/apps/desktop/src/i18n/locales/it.ts
+++ b/apps/desktop/src/i18n/locales/it.ts
@@ -183,6 +183,8 @@ export default withEnglishFallback({
     unsupportedTarget: "Non disponibile per {target}",
     installedVersion: "Installato v{version}",
     licenseUnknown: "Licenza non specificata",
+    sourceRepository: "Repository del codice sorgente",
+    pluginHomepage: "Sito web",
     marketplaceStatus: { install: "Installa", installed: "Installato", update: "Aggiorna", unsupported: "Non supportato" },
     updateSuccess: "{name} aggiornato alla versione {version}",
     noInstalledPlugins: "Nessun plugin installato",
diff --git a/apps/desktop/src/i18n/locales/ja.ts b/apps/desktop/src/i18n/locales/ja.ts
index 8bf2ffa7a1..0044c62bdd 100644
--- a/apps/desktop/src/i18n/locales/ja.ts
+++ b/apps/desktop/src/i18n/locales/ja.ts
@@ -184,6 +184,8 @@ export default withEnglishFallback({
     unsupportedTarget: "{target} では利用できません",
     installedVersion: "インストール済み v{version}",
     licenseUnknown: "ライセンス未指定",
+    sourceRepository: "ソースリポジトリ",
+    pluginHomepage: "ホームページ",
     marketplaceStatus: { install: "インストール", installed: "インストール済み", update: "更新", unsupported: "非対応" },
     updateSuccess: "{name} を {version} に更新しました",
     noInstalledPlugins: "プラグインはまだありません",
diff --git a/apps/desktop/src/i18n/locales/ko.ts b/apps/desktop/src/i18n/locales/ko.ts
index 828654a83b..77faf18ea1 100644
--- a/apps/desktop/src/i18n/locales/ko.ts
+++ b/apps/desktop/src/i18n/locales/ko.ts
@@ -183,6 +183,8 @@ export default withEnglishFallback({
     unsupportedTarget: "{target}에서는 사용할 수 없음",
     installedVersion: "설치된 버전 v{version}",
     licenseUnknown: "라이선스 미지정",
+    sourceRepository: "소스 저장소",
+    pluginHomepage: "홈페이지",
     marketplaceStatus: {
       install: "설치",
       installed: "설치됨",
diff --git a/apps/desktop/src/i18n/locales/pt-BR.ts b/apps/desktop/src/i18n/locales/pt-BR.ts
index 563e32b9ed..eaa1d32d98 100644
--- a/apps/desktop/src/i18n/locales/pt-BR.ts
+++ b/apps/desktop/src/i18n/locales/pt-BR.ts
@@ -184,6 +184,8 @@ export default withEnglishFallback({
     unsupportedTarget: "Indisponível para {target}",
     installedVersion: "Instalado v{version}",
     licenseUnknown: "Licença não informada",
+    sourceRepository: "Repositório do código-fonte",
+    pluginHomepage: "Página inicial",
     marketplaceStatus: { install: "Instalar", installed: "Instalado", update: "Atualizar", unsupported: "Não compatível" },
     updateSuccess: "{name} atualizado para {version}",
     noInstalledPlugins: "Nenhum plugin instalado",
diff --git a/apps/desktop/src/i18n/locales/zh-CN.ts b/apps/desktop/src/i18n/locales/zh-CN.ts
index f65e2f74e8..e0353b3b38 100644
--- a/apps/desktop/src/i18n/locales/zh-CN.ts
+++ b/apps/desktop/src/i18n/locales/zh-CN.ts
@@ -107,6 +107,8 @@ export default withEnglishFallback({
     unsupportedTarget: "暂不支持 {target}",
     installedVersion: "已安装 v{version}",
     licenseUnknown: "未声明许可证",
+    sourceRepository: "源码仓库",
+    pluginHomepage: "主页",
     marketplaceStatus: { install: "安装", installed: "已安装", update: "更新", unsupported: "不支持" },
     updateSuccess: "已将 {name} 更新到 {version}",
     noInstalledPlugins: "尚未安装插件",
diff --git a/apps/desktop/src/i18n/locales/zh-TW.ts b/apps/desktop/src/i18n/locales/zh-TW.ts
index 3dd3348e91..6d390d1c6a 100644
--- a/apps/desktop/src/i18n/locales/zh-TW.ts
+++ b/apps/desktop/src/i18n/locales/zh-TW.ts
@@ -184,6 +184,8 @@ export default withEnglishFallback({
     unsupportedTarget: "暫不支援 {target}",
     installedVersion: "已安裝 v{version}",
     licenseUnknown: "未指定授權條款",
+    sourceRepository: "原始碼倉庫",
+    pluginHomepage: "主頁",
     marketplaceStatus: { install: "安裝", installed: "已安裝", update: "更新", unsupported: "不支援" },
     updateSuccess: "已將 {name} 更新至 {version}",
     noInstalledPlugins: "尚未安裝外掛",
diff --git a/apps/desktop/src/types/database.ts b/apps/desktop/src/types/database.ts
index a491d99ac8..b791bb0232 100644
--- a/apps/desktop/src/types/database.ts
+++ b/apps/desktop/src/types/database.ts
@@ -454,6 +454,8 @@ export interface PluginManifest {
   entrypoints?: PluginEntrypoints;
   protocol_version?: number;
   description?: string;
+  source?: string;
+  homepage?: string;
   executable?: string;
   drivers: PluginDriverManifest[];
   contributions?: PluginContribution[];
diff --git a/crates/dbx-core/src/plugins/manifest.rs b/crates/dbx-core/src/plugins/manifest.rs
index 0f4b00e1ae..ac19a4d603 100644
--- a/crates/dbx-core/src/plugins/manifest.rs
+++ b/crates/dbx-core/src/plugins/manifest.rs
@@ -57,6 +57,10 @@ pub struct PluginManifest {
     pub publisher: String,
     #[serde(default)]
     pub description: String,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub source: Option<String>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub homepage: Option<String>,
     #[serde(default)]
     pub engines: PluginEngines,
     #[serde(default, skip_serializing_if = "Vec::is_empty")]
diff --git a/plugins/GETTING_STARTED.zh-CN.md b/plugins/GETTING_STARTED.zh-CN.md
index fe0c95b999..67eb959481 100644
--- a/plugins/GETTING_STARTED.zh-CN.md
+++ b/plugins/GETTING_STARTED.zh-CN.md
@@ -9,6 +9,8 @@
 - Sidecar Protocol v1：可选原生后端与 DBX 通信的协议。
 - `.dbxp`：DBX 最终安装的插件包。
 
+插件可以在 `manifest.json` 中声明可选的 `source`（源码仓库）和 `homepage`（项目主页）。这两个字段会随插件包签名并在“已安装”页面本地显示，因此不依赖联网；市场目录可以重复这些字段用于展示未安装插件。
+
 正式文档和仓库提交流程参考 [`docs/content/docs/plugin-development.cn.mdx`](../docs/content/docs/plugin-development.cn.mdx)。完整协议和贡献点参考 [`README.md`](./README.md)，底层发布流程参考 [`RELEASING.md`](./RELEASING.md)。
 
 ## 先说结论：SDK 不需要“启动”
diff --git a/plugins/README.md b/plugins/README.md
index 6793511723..949d96f26c 100644
--- a/plugins/README.md
+++ b/plugins/README.md
@@ -144,6 +144,8 @@ Add the schema to a manifest for editor validation:
   "name": "Example",
   "icon": "assets/plugin.svg",
   "version": "1.0.0",
+  "source": "https://github.com/example/dbx-plugin",
+  "homepage": "https://example.com/dbx-plugin",
   "engines": {
     "dbx": ">=0.5.68",
     "host_api": "^1.0"
diff --git a/plugins/examples/hello-workbench/manifest.json b/plugins/examples/hello-workbench/manifest.json
index fd72f1a306..04c0402378 100644
--- a/plugins/examples/hello-workbench/manifest.json
+++ b/plugins/examples/hello-workbench/manifest.json
@@ -7,6 +7,8 @@
   "version": "1.0.0",
   "publisher": "dbx",
   "description": "A complete DBX plugin example with a native sidecar, events, workbench UI, connection provider, and virtual filesystem provider.",
+  "source": "https://github.com/t8y2/dbx",
+  "homepage": "https://github.com/t8y2/dbx/tree/main/plugins/examples/hello-workbench",
   "engines": {
     "dbx": ">=0.5.68",
     "host_api": "^1.0"
diff --git a/plugins/manifest.schema.json b/plugins/manifest.schema.json
index a3de704e9a..2fbfbcd19a 100644
--- a/plugins/manifest.schema.json
+++ b/plugins/manifest.schema.json
@@ -14,6 +14,8 @@
     "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
     "publisher": { "type": "string", "minLength": 1 },
     "description": { "type": "string" },
+    "source": { "type": "string", "pattern": "^https?://[^\\s]+$" },
+    "homepage": { "type": "string", "pattern": "^https?://[^\\s]+$" },
     "engines": {
       "type": "object",
       "additionalProperties": false,
diff --git a/plugins/sdk/cli/src/lib.rs b/plugins/sdk/cli/src/lib.rs
index 0cf4446dc1..23f8329c05 100644
--- a/plugins/sdk/cli/src/lib.rs
+++ b/plugins/sdk/cli/src/lib.rs
@@ -999,6 +999,8 @@ fn reject_unknown_manifest_fields(manifest: &Value) -> Result<(), String> {
         "version",
         "publisher",
         "description",
+        "source",
+        "homepage",
         "engines",
         "permissions",
         "entrypoints",