ygc-dsh-sync 1.0.0 → 1.0.1

package/client.js

@@ -927,6 +927,32 @@ function makePanel(React) {
           const others = ((detail && detail.others) || []).filter((p) => !p.installed);
           const installedFromOthers = ((detail && detail.others) || []).filter((p) => p.installed);
           const sources = (detail && detail.sources) || [];
+
+    /**
+     * 来源的人读形式。
+     *
+     * 需求是「备份来源」：npm 就记 npm，git 就记仓库地址。
+     * 这里只负责展示——数据来自清单里的 source 对象（由 lib/plugins.js 生成）。
+     */
+          const sourceText = (src) => {
+            if (!src || typeof src !== 'object') return '';
+            if (src.type === 'npm') return `npm · ${src.spec || src.package || ''}`;
+            if (src.type === 'git') {
+              const ref = src.ref ? `#${src.ref}` : '';
+              return src.url ? `git · ${src.url}${ref}` : `git · ${src.raw || ''}`;
+            }
+            if (src.type === 'local') return `local · ${[src.form, src.path].filter(Boolean).join(' ')}`;
+            if (src.type === 'installation') return '随桌面端安装';
+            return src.type || '';
+          };
+
+    /** 来源标签的配色：git 用强调色，装不了的用警告色。 */
+          const sourceTagClass = (src) => {
+            if (!src || typeof src !== 'object') return 'dsb-tag';
+            if (src.type === 'git') return 'dsb-tag dsb-tag-ok';
+            if (src.type === 'local') return 'dsb-tag dsb-tag-warn';
+            return 'dsb-tag';
+          };
           const last = st.lastResult || null;
           return h(
             'div',
@@ -1049,6 +1075,21 @@ function makePanel(React) {
                         h('span', { className: 'dsb-tag' }, (p.features || []).join(' / ')),
                       ),
                       p.description ? h('div', { className: 'dsb-row-d' }, String(p.description).slice(0, 140)) : null,
+                      // 来源：npm 给 registry 坐标，git 给**仓库地址**与 ref
+                      sourceText(p.source)
+                        ? h(
+                            'div',
+                            { className: 'dsb-row-d', style: { marginTop: 2 } },
+                            '来源 ',
+                            h('span', { className: sourceTagClass(p.source) }, sourceText(p.source)),
+                            p.source && p.source.declared && p.source.type === 'npm'
+                              ? h('span', { style: { opacity: 0.6 } }, `  （profile 里声明为 ${p.source.declared}）`)
+                              : null,
+                            p.source && p.source.type === 'git' && p.source.raw && p.source.url !== p.source.raw
+                              ? h('span', { style: { opacity: 0.6 } }, `  （原始写法 ${p.source.raw}）`)
+                              : null,
+                          )
+                        : null,
                     ),
                     h(
                       'button',

package/lib/plugins.js

@@ -29,6 +29,9 @@ import os from 'node:os';
 
 /* ---------------------------------------------------------------- 路径 */
 
+/** 默认 registry（写进来源里，让别人知道这个包是从哪查到的）。 */
+export const DEFAULT_REGISTRY = 'https://registry.npmjs.org/';
+
 /** 插件库默认根：D 盘 Ai工作空间 下的「插件库」。 */
 export const DEFAULT_LIBRARY_ROOT = 'D:\\Ai工作空间\\插件库';
 
@@ -377,6 +380,82 @@ function bytesOf(file) {
   }
 }
 
+/* ------------------------------------------------------------ 来源描述 */
+
+/**
+ * 描述一个插件的**来源**（v1.0.1 新增）。
+ *
+ * 要记的是「这个插件从哪来」，不是「它的代码长什么样」——所以这里只给出
+ * 类型与坐标，绝不读、也不写任何源码。
+ *
+ * 四种形态：
+ *   npm          registry 包：registry 地址 + 包名@版本 + profile 里的原始写法
+ *   git          git 仓库：**仓库 URL** + 钉住的 ref（分支/标签/commit）+ 原始写法
+ *   local        本地路径（file: / link: / workspace: / 直链 tar）：形式 + 路径
+ *   installation 随桌面端安装提供：没有可复现的来源，如实写明
+ *
+ * @param {{name?:string, kind?:string, spec?:string|null, version?:string|null}} plugin
+ * @returns {{type:string}}
+ */
+export function describeSource(plugin) {
+  const name = String(plugin?.name || '');
+  const kind = String(plugin?.kind || '');
+  const version = plugin?.version ? String(plugin.version) : '';
+  const spec = typeof plugin?.spec === 'string' ? plugin.spec.trim() : '';
+
+  if (kind === 'registry') {
+    return {
+      type: 'npm',
+      registry: DEFAULT_REGISTRY,
+      package: name,
+      version,
+      // 别人拿去安装的坐标，与 installSpec 一致
+      spec: version ? `${name}@${version}` : name,
+      // profile 里的原始写法（纯版本号 / ^ / ~ 都可能），能看出当初怎么声明的
+      declared: spec || undefined,
+    };
+  }
+
+  if (kind === 'git') {
+    const parsed = parseGitSpec(spec);
+    return {
+      type: 'git',
+      // 仓库地址：优先归一成 https 形式，别人那台机器能直接 clone
+      url: (parsed && parsed.url) || spec || undefined,
+      // 钉住的 ref（分支 / 标签 / commit）；没有就是跟默认分支
+      ref: (parsed && parsed.ref) || undefined,
+      owner: (parsed && parsed.owner) || undefined,
+      repo: (parsed && parsed.repo) || undefined,
+      // 原始写法照录：`github:o/r#v1` 与 `git+https://…` 归一后看不出区别
+      raw: spec || undefined,
+      version,
+    };
+  }
+
+  if (kind === 'local') {
+    const m = /^(file|link|workspace|portal):(.*)$/i.exec(spec);
+    const form = m ? m[1].toLowerCase() : /^https?:\/\//i.test(spec) ? 'tarball' : 'unknown';
+    return {
+      type: 'local',
+      form,
+      // 路径照录：这是本机事实，别人装不了，但要知道它指向哪
+      path: m ? m[2].trim() : spec || undefined,
+      version,
+    };
+  }
+
+  if (kind === 'installation') {
+    return {
+      type: 'installation',
+      // 随 DSH 桌面端一起发布，版本跟桌面端走，没有独立的可复现来源
+      bundledWith: 'dsh-desktop',
+      version: version || undefined,
+    };
+  }
+
+  return { type: 'unknown', kind: kind || undefined, spec: spec || undefined };
+}
+
 /* ------------------------------------------------------- 本机插件枚举 */
 
 /**
@@ -417,6 +496,8 @@ export function collectLocalPlugins(options) {
         installable: Boolean(installSpec),
         description: meta.description || '',
         homepage: meta.homepage || '',
+        // 来源：npm / git（含仓库地址与 ref）/ local / installation
+        source: describeSource({ name, kind, spec, version }),
         reason: registryLike
           ? 'registry 来源，按名称+版本联网拉取'
           : kind === 'git'
@@ -461,7 +542,8 @@ export async function syncMyFeature({ config, machineId, machineHash, machineNam
   const purged = purgeLegacyBundles(root);
 
   const manifest = {
-    schemaVersion: 2,
+    // 3：新增 source（记录来源类型与坐标，不含任何源码）
+    schemaVersion: 3,
     feature,
     machine: machineName || '',
     machineId: feature,
@@ -481,6 +563,10 @@ export async function syncMyFeature({ config, machineId, machineHash, machineNam
       manifestOnly: true,
       storesBundles: false,
       installVia: 'registry',
+      // 来源记录的边界：只记「从哪来」，不记「代码长什么样」
+      recordsSource: true,
+      storesSourceCode: false,
+      sourceKinds: ['npm', 'git', 'local', 'installation'],
       note: '特征文件夹只存清单；安装一律按 installSpec 联网拉取，不使用本地副本。',
     },
     plugins,
@@ -631,15 +717,22 @@ export function collectSharedPlugins({ config, machineId, publishedNames } = {})
             : kind === 'git' && typeof plugin.spec === 'string'
               ? plugin.spec
               : '';
+      const specOf = typeof plugin.spec === 'string' ? plugin.spec : '';
       const record = {
         name: plugin.name,
         version,
         kind,
-        spec: typeof plugin.spec === 'string' ? plugin.spec : '',
+        spec: specOf,
         installSpec,
         installable: Boolean(installSpec),
         description: typeof plugin.description === 'string' ? plugin.description : '',
         homepage: typeof plugin.homepage === 'string' ? plugin.homepage : '',
+        // 来源：新清单自带就用它；老清单没这个字段就按现有字段现推一份，
+        // 这样别人那台跑旧版插件时，本机看到的来源也不会是空的
+        source:
+          plugin.source && typeof plugin.source === 'object'
+            ? plugin.source
+            : describeSource({ name: plugin.name, kind, spec: specOf, version }),
         features: [feature],
         mine: isMine || Boolean(plugin.mine),
       };
@@ -659,6 +752,7 @@ export function collectSharedPlugins({ config, machineId, publishedNames } = {})
         old.installable = Boolean(old.installSpec);
         old.description = record.description || old.description;
         old.homepage = record.homepage || old.homepage;
+        old.source = record.source || old.source;
       } else if (!old.installSpec && record.installSpec) {
         old.installSpec = record.installSpec;
         old.installable = true;
@@ -685,6 +779,19 @@ export function writeAggregate({ config, machineId, publishedNames, log } = {})
     installSpec: plugin.installSpec || '',
   }));
 
+  /** 来源的人读形式：git 给仓库 URL，npm 给 registry 坐标，local 给路径。 */
+  const sourceText = (src) => {
+    if (!src || typeof src !== 'object') return '-';
+    if (src.type === 'npm') return `npm · ${src.spec || src.package || ''}`;
+    if (src.type === 'git') {
+      const ref = src.ref ? `#${src.ref}` : '';
+      return src.url ? `git · ${src.url}${ref}` : `git · ${src.raw || '-'}`;
+    }
+    if (src.type === 'local') return `local · ${src.form || ''} ${src.path || ''}`.trim();
+    if (src.type === 'installation') return '随桌面端安装';
+    return src.type || '-';
+  };
+
   const others = items.filter((item) => !item.mine);
   const installable = others.filter((item) => !item.installed && item.installKind !== 'none');
 
@@ -732,11 +839,11 @@ export function writeAggregate({ config, machineId, publishedNames, log } = {})
     '',
     '## 他人插件',
     '',
-    '| 插件 | 版本 | 来源 | 本机 | 安装方式 | 安装坐标 |',
-    '|---|---|---|---|---|---|',
+    '| 插件 | 版本 | 来源 | 出处 | 本机 | 安装方式 | 安装坐标 |',
+    '|---|---|---|---|---|---|---|',
     ...others.map(
       (item) =>
-        `| \`${item.name}\` | ${item.version || '-'} | ${item.features.join(', ')} | ${
+        `| \`${item.name}\` | ${item.version || '-'} | ${item.features.join(', ')} | ${sourceText(item.source)} | ${
           item.installed ? `已装 ${item.installedVersion}` : '无'
         } | ${item.installKind} | ${item.installSpec ? `\`${item.installSpec}\`` : '-'} |`,
     ),

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "ygc-dsh-sync",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
-  "description": "DSH 同步插件：会话按工作区落地、按机器隔离的跨机备份与拉取；技能本机↔母版双向同步（含记忆插件技能优化闭环）；插件清单共享（特征文件夹，只存清单、只能联网装）。",
+  "description": "DSH 同步插件：会话按工作区落地、按机器隔离的跨机备份与拉取；技能本机↔母版双向同步（含记忆插件技能优化闭环）；插件清单共享（只存清单与来源，不存源码，只能联网装）。",
   "icon": "icon.svg",
   "keywords": [
     "dsh",