dsh-plugin 2.2.1 → 2.2.3

package/lib/services/profile/installed-versions.js

@@ -23,10 +23,27 @@ import { dirname, join } from 'node:path';
 export function versionsFilePath(profile) {
     return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'profiles', profile, 'gro.ngilp-hsd-versions.json');
 }
+/** 读取某 profile 的版本账本；缺失/损坏/字段不全一律归一化成完整形状。
+ *  安装一开始只会写入 npm 包名映射（版本要等任务结束才知道），所以磁盘上可能存在
+ *  只有 npmPackage 的记录 —— 原样下发会让客户端的版本比较拿到 undefined 直接抛错。 */
 export function readInstalledVersions(profile) {
     try {
         const raw = JSON.parse(readFileSync(versionsFilePath(profile), 'utf8'));
-        return raw !== null && typeof raw === 'object' ? raw : {};
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+            return {};
+        const table = {};
+        for (const [key, value] of Object.entries(raw)) {
+            if (value === null || typeof value !== 'object')
+                continue;
+            const rec = value;
+            table[key] = {
+                version: typeof rec.version === 'string' ? rec.version : '',
+                updatedAt: typeof rec.updatedAt === 'string' ? rec.updatedAt : '',
+                installedAt: typeof rec.installedAt === 'string' ? rec.installedAt : '',
+                ...(typeof rec.npmPackage === 'string' && rec.npmPackage !== '' ? { npmPackage: rec.npmPackage } : {}),
+            };
+        }
+        return table;
     }
     catch {
         return {};
@@ -48,7 +65,14 @@ export function recordInstalledVersion(profile, repo, version, updatedAt) {
 export function recordResolvedNpmPackage(profile, repo, npmPackage) {
     const table = readInstalledVersions(profile);
     const key = repo.toLowerCase();
-    table[key] = { ...table[key], npmPackage };
+    // 显式写全字段：这一步发生在安装开始时，版本还不知道 —— 但落盘记录必须是完整形状，
+    // 否则只带 npmPackage 的残缺记录会在客户端版本比较时崩掉整块界面
+    table[key] = {
+        version: table[key]?.version ?? '',
+        updatedAt: table[key]?.updatedAt ?? '',
+        installedAt: table[key]?.installedAt ?? '',
+        npmPackage,
+    };
     writeVersions(profile, table);
 }
 /** 清除某仓库记录的版本（卸载时调用）。 */

package/lib/types/services/profile/installed-versions.d.ts

@@ -10,6 +10,9 @@ export interface InstalledVersionRecord {
 }
 export type InstalledVersionTable = Record<string, InstalledVersionRecord>;
 export declare function versionsFilePath(profile: string): string;
+/** 读取某 profile 的版本账本；缺失/损坏/字段不全一律归一化成完整形状。
+ *  安装一开始只会写入 npm 包名映射（版本要等任务结束才知道），所以磁盘上可能存在
+ *  只有 npmPackage 的记录 —— 原样下发会让客户端的版本比较拿到 undefined 直接抛错。 */
 export declare function readInstalledVersions(profile: string): InstalledVersionTable;
 /** 记录某仓库安装时的目录信号（版本 + 仓库更新时间）。 */
 export declare function recordInstalledVersion(profile: string, repo: string, version: string, updatedAt: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "description": "A community plugin marketplace for DeepSeek Harness, built to the official plugin spec — browse, search and install 10000+ human-curated community plugins without leaving the app. · DeepSeek Harness 社区插件市场（遵循官方开发规范）：10000+ 人工精选社区插件，每日更新。",
   "type": "module",
   "main": "lib/index.js",

package/src/client/data/hub.ts

@@ -6,7 +6,7 @@
  * Hub 元数据仓库：自我更新检查与「关注我们」内容背后的 Cloudflare Worker 接口。
  * 失败降级为 null —— 由调用方决定如何兜底（不显示徽标、占位文案），绝不抛错。
  */
-import type { HubAboutInfo, HubUpdateInfo } from '../types.ts'
+import type { HubAboutInfo, HubUpdateInfo, HubUpdateVersion } from '../types.ts'
 import { HUB_ABOUT_URL, HUB_UPDATE_URL } from '../logic/constants.ts'
 
 /** 版本接口是 Pages 静态文件，默认带 CDN 缓存（Cache-Control: public, max-age=43200，
@@ -18,7 +18,26 @@ function busted(url: string): string {
   return `${url}${sep}_t=${Date.now()}`
 }
 
-/** Worker 版本控制中心：最新版本 + Markdown 变更记录；不可用返回 null。 */
+/** 归一化接口下发的 recentVersions：只保留带版本号的条目，其余字段按类型补。
+ *  这条数据是「最新版还在 24.5h 门禁内时回退到更早的已过门槛版本」的唯一依据；
+ *  入口处漏传会让候选只剩最新版，整体变成 pending —— 用户就永远看不到更新入口。 */
+function recentVersionsOf(value: unknown): HubUpdateVersion[] {
+  if (!Array.isArray(value)) return []
+  const list: HubUpdateVersion[] = []
+  for (const item of value) {
+    if (item === null || typeof item !== 'object') continue
+    const entry = item as { version?: unknown; publishedAt?: unknown; notes?: unknown }
+    if (typeof entry.version !== 'string' || entry.version === '') continue
+    list.push({
+      version: entry.version,
+      ...(typeof entry.publishedAt === 'string' ? { publishedAt: entry.publishedAt } : {}),
+      ...(entry.notes === undefined ? {} : { notes: entry.notes as HubUpdateVersion['notes'] }),
+    })
+  }
+  return list
+}
+
+/** 版本控制中心：最新版本 + Markdown 变更记录 + 最近发版（门禁回退用）；不可用返回 null。 */
 export async function fetchHubUpdate(): Promise<HubUpdateInfo | null> {
   try {
     const res = await fetch(busted(HUB_UPDATE_URL), { cache: 'no-store' })
@@ -27,7 +46,12 @@ export async function fetchHubUpdate(): Promise<HubUpdateInfo | null> {
     if (!data) return null
     const version = typeof data.version === 'string' && data.version.length > 0 ? data.version : null
     if (version === null) return null
-    return { version, publishedAt: data.publishedAt ?? null, notes: data.notes ?? null }
+    return {
+      version,
+      publishedAt: data.publishedAt ?? null,
+      notes: data.notes ?? null,
+      recentVersions: recentVersionsOf(data.recentVersions),
+    }
   } catch {
     return null
   }

package/src/client/logic/installed.ts

@@ -91,7 +91,7 @@ export function installedNameOf(
 export function installedVersionOf(plugin: HubPlugin, versions: Record<string, InstalledVersionSignal>): string | null {
   const repo = plugin.source?.repo
   if (!repo) return null
-  return versions[repo.toLowerCase()]?.version ?? null
+  return signalOf(repo, versions)?.version || null
 }
 
 /** 该插件对应的 npm 包名（目录下发，或安装时持久化的映射）；无则 null。决定更新是否走 npm registry。 */
@@ -118,9 +118,13 @@ export function hasUpdateOf(
   if (!repo) return false
   const rec = versions[repo.toLowerCase()]
   if (!rec) return false
-  if (plugin.version) return compareVersions(plugin.version, rec.version) > 0
+  // 账本记录可能是残缺的：安装一开始就会先写入 npm 包名映射，版本要等任务结束才知道。
+  // 缺版本的记录按「无版本信号」处理、退回更新时间比较 —— 直接拿去比版本会让整个插件区块崩掉
+  const recorded = typeof rec.version === 'string' ? rec.version : ''
+  if (plugin.version && recorded !== '') return compareVersions(plugin.version, recorded) > 0
   const current = plugin.dates?.repoUpdatedAt
-  return Boolean(current && rec.updatedAt && current > rec.updatedAt)
+  const seen = typeof rec.updatedAt === 'string' ? rec.updatedAt : ''
+  return Boolean(current && seen && current > seen)
 }
 
 /** 依赖 spec 能否解析出仓库身份（owner/repo 形态才算）。 */
@@ -222,7 +226,7 @@ export function installedItemsOf(
       plugin: p,
       repo,
       installPath: paths?.[name] ?? null,
-      installedVersion: rec?.version ?? null,
+      installedVersion: rec?.version || null,
       installedAt: rec?.installedAt ?? null,
       catalogVersion: p.version ?? null,
       hasUpdate: hasUpdateOf(p, installed, versions),
@@ -245,7 +249,7 @@ export function installedItemsOf(
       plugin: null,
       repo,
       installPath: paths?.[name] ?? null,
-      installedVersion: rec?.version ?? null,
+      installedVersion: rec?.version || null,
       installedAt: rec?.installedAt ?? null,
       catalogVersion: null,
       // 目录外没有目录信号可比，无法判断是否有更新

package/src/client/logic/release-age.ts

@@ -23,14 +23,14 @@ export function isReleaseTooFresh(publishedAt: string | null | undefined, now: n
  *  兼容目录里的 `v1.1.8` 与 npm 的 `1.1.8`：每段先剥掉前导非数字，再取整。
  *  预发布后缀单独处理：`1.0.0` 高于 `1.0.0-beta.1`，两个预发布版按标识符比较
  *  （纯数字段按数值，数字段低于字母段）。 */
-export function compareVersions(a: string, b: string): number {
-  const core = (v: string): number[] =>
-    (v.split('+')[0] ?? '').split('-')[0]!
+export function compareVersions(a: string | null | undefined, b: string | null | undefined): number {
+  const core = (v: string | null | undefined): number[] =>
+    (v ?? '').split('+')[0]!.split('-')[0]!
       .split('.')
       .map((part) => Number.parseInt(part.replace(/^[^\d]+/, ''), 10))
       .filter((n) => !Number.isNaN(n))
-  const pre = (v: string): string[] => {
-    const rest = (v.split('+')[0] ?? '').split('-').slice(1)
+  const pre = (v: string | null | undefined): string[] => {
+    const rest = (v ?? '').split('+')[0]!.split('-').slice(1)
     return rest.length === 0 ? [] : rest.join('-').split('.')
   }
   const va = core(a)

package/src/server/services/profile/installed-versions.ts

@@ -38,10 +38,25 @@ export function versionsFilePath(profile: string): string {
   return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'profiles', profile, 'gro.ngilp-hsd-versions.json')
 }
 
+/** 读取某 profile 的版本账本；缺失/损坏/字段不全一律归一化成完整形状。
+ *  安装一开始只会写入 npm 包名映射（版本要等任务结束才知道），所以磁盘上可能存在
+ *  只有 npmPackage 的记录 —— 原样下发会让客户端的版本比较拿到 undefined 直接抛错。 */
 export function readInstalledVersions(profile: string): InstalledVersionTable {
   try {
     const raw = JSON.parse(readFileSync(versionsFilePath(profile), 'utf8')) as unknown
-    return raw !== null && typeof raw === 'object' ? raw as InstalledVersionTable : {}
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) return {}
+    const table: InstalledVersionTable = {}
+    for (const [key, value] of Object.entries(raw as Record<string, unknown>)) {
+      if (value === null || typeof value !== 'object') continue
+      const rec = value as Partial<InstalledVersionRecord>
+      table[key] = {
+        version: typeof rec.version === 'string' ? rec.version : '',
+        updatedAt: typeof rec.updatedAt === 'string' ? rec.updatedAt : '',
+        installedAt: typeof rec.installedAt === 'string' ? rec.installedAt : '',
+        ...(typeof rec.npmPackage === 'string' && rec.npmPackage !== '' ? { npmPackage: rec.npmPackage } : {}),
+      }
+    }
+    return table
   } catch {
     return {}
   }
@@ -64,7 +79,14 @@ export function recordInstalledVersion(profile: string, repo: string, version: s
 export function recordResolvedNpmPackage(profile: string, repo: string, npmPackage: string): void {
   const table = readInstalledVersions(profile)
   const key = repo.toLowerCase()
-  table[key] = { ...table[key], npmPackage }
+  // 显式写全字段：这一步发生在安装开始时，版本还不知道 —— 但落盘记录必须是完整形状，
+  // 否则只带 npmPackage 的残缺记录会在客户端版本比较时崩掉整块界面
+  table[key] = {
+    version: table[key]?.version ?? '',
+    updatedAt: table[key]?.updatedAt ?? '',
+    installedAt: table[key]?.installedAt ?? '',
+    npmPackage,
+  }
   writeVersions(profile, table)
 }