ygc-dsh-plugin-autoupdate 1.1.1 → 1.2.1

package/README.md

@@ -5,10 +5,12 @@
 - **定时检查**：间隔自己设（最短 5 分钟，默认 360 分钟）
 - **逐个插件定策略**：某个插件可以「发布后立即更新」，也可以「发布后等 N 小时」（默认 2 小时）
 - **更新完是否自动重启**：独立开关，可设「只在没有会话跑的时候重启」和「重启前等待秒数」
+- **本地装的插件也能更新**（1.2.0）：本机是 `file:` 装的、上游其实是 GitHub 仓库的包，识别出来一起检查
 
 ## 打开位置
 
-侧栏图标「插件自动更新」→ 主面板。面板分五块：总开关与频率、默认策略、插件列表、重启设置、最近记录。
+侧栏图标「插件自动更新」→ 主面板。面板分六块：总开关与频率、默认策略、
+本地装的插件的 Git 上游识别、插件列表、重启设置、最近记录。
 
 ## 怎么判断「等够时间了」
 
@@ -20,6 +22,59 @@
 发布时间从 npm registry 的 packument `time[version]` 取；取不到才退回「本次检查时间」。
 本地路径（`file:`）和 Git 来源的包不参与检查 —— 它们没有「发布」这个概念。
 
+> **1.2.0 起改了这一条**：本地装、但上游其实是 Git 仓库的包，现在也会联网检查。
+> 见下面「本地装的插件，上游在 GitHub」一节。
+
+## 本地装的插件，上游在 GitHub（1.2.0）
+
+### 为什么会有这一条
+
+`dsh-knowledge-wiki`、`dsh-purge-community` 这类包在本机是用本地 tgz 装的：
+
+```json
+"dsh-knowledge-wiki": "file:C:/DSH-Work/local-plugins/dsh-knowledge-wiki-0.39.1.tgz"
+```
+
+来源判定只看这个写法 → 判成 `local` → **不检查、不更新**，面板上只写一句
+「本地路径来源，不参与版本检查」。可它们的仓库在 GitHub 上有 tag，
+`dsh-purge` 甚至自己就会检查更新。结果就是「能更新的插件永远停在装机那天」。
+
+### 怎么识别的（判据只有一条是不放宽的）
+
+1. 从**已装副本**的 `package.json` 里读 `repository` / `homepage`，解析出 `owner/repo`；
+2. 到远端核实「仓库根就是这个包」——**远端 `package.json` 的 `name` 必须与本地包名逐字相同**。
+   仓库名与包名常常不一样（`dsh-knowledge-wiki` 的仓库叫 `dsh-knowledge-base`），
+   所以既不能靠仓库名，也不能靠「名字像不像」。放宽这一条会立刻误认一堆无关仓库；
+3. 取远端最新版本：优先 semver tag（`v0.43.1` → `0.43.1`），没有 tag 才退回 HEAD 的 `version`。
+
+核实通过后，`updateKind()` 把这类包判成 **`git-local`**：参与联网检查、出现在
+「已装插件」那一组，面板标「Git 上游·本地装」。
+
+### 检查与升级各做什么
+
+| 阶段 | 做什么 |
+|---|---|
+| 检查 | 比**版本号**（本机 `0.39.1` vs 上游 tag `0.43.1`）。本机是 tgz 装出来的，没有 commit 可比 |
+| 升级（手动点） | 把依赖写法换成 `github:owner/repo#v0.43.1`，走 `installSpec` 装；装不成**原样还原**写法 |
+| 升级（定时任务） | **默认不自动装**，只报到面板。要自动就在设置里开「定时任务也自动装这类更新」 |
+
+为什么定时默认不装：这一步会改 profile 的 `package.json`，属于「换安装方式」而不只是升版本。
+装出来的那份可能不再带本机的定制，也可能缺 peer 依赖。换成功之后这个包就变成正常的
+`git` 来源（此后比 commit），不再是 `git-local`。
+
+### 面板上的开关
+
+- **识别本地来源的 Git 上游**（默认开）：关掉即回到旧行为，本地来源一律不查；
+- **定时任务也自动装这类更新**（默认关）：见上表；
+- 每个识别结果都能单独「停用」（回到本地来源）或「恢复」；
+- 「重新识别上游」强制重探（忽略 24 小时缓存）。
+
+### 为什么识别结果要落盘
+
+探测是联网动作（`git ls-remote` + 一个 `raw.githubusercontent.com` 请求）。
+结果存进 `~/.dsh/storages/plugin-autoupdate.json` 的 `gitOrigins`，带 `checkedAt`，
+24 小时内不重复打网络；重启 DSH 也不会把识别结果丢掉。
+
 ## 更新怎么执行
 
 1. 先把 profile 的 `package.json` / `pnpm-lock.yaml` / `pnpm-workspace.yaml` 快照到

package/client.js

@@ -176,7 +176,13 @@ function makePanel(React) {
     const registryPlugins = managed.filter((p) => p.kind === 'registry');
     // git 与 registry 一样参与自动更新，只是比的是 commit 而不是版本号
     const gitPlugins = managed.filter((p) => p.kind === 'git');
-    const otherPlugins = managed.filter((p) => p.kind !== 'registry' && p.kind !== 'git');
+    // git-local：本机是 file: 装的，但上游核实过就是这个包的 GitHub 仓库。
+    // 它和 registry / git 一样参与联网检查（比 tag 版本号），所以归进「已装插件」那一组；
+    // 区别只在于升级时会把依赖写法换成 github:owner/repo#tag。
+    const gitLocalPlugins = managed.filter((p) => p.kind === 'git-local');
+    const otherPlugins = managed.filter(
+      (p) => p.kind !== 'registry' && p.kind !== 'git' && p.kind !== 'git-local',
+    );
     const available = plugins.filter((p) => p.updateAvailable);
     const ready = available.filter((p) => !p.waitMs);
     // 被隐藏的本体插件数量：宿主报了就用宿主的，没报就按本地筛掉的差值兜底。
@@ -319,8 +325,137 @@ function makePanel(React) {
       ),
     );
 
+    /**
+     * 「本地装、上游是 Git」识别卡片。
+     *
+     * 为什么要有它：这类包（dsh-knowledge-wiki、dsh-purge-community）以前被判成
+     * local 之后既不显示、也不检查，用户完全看不到原因。这里把识别结果摊开：
+     * 认出了哪个仓库、最新是哪个 tag、认不出来的那句 error 也照实写。
+     */
+    const origins = Array.isArray(snap.gitOrigins) ? snap.gitOrigins : [];
+    const originCard = h(
+      'div',
+      { className: 'pau-card' },
+      h(
+        'div',
+        { className: 'pau-card-h' },
+        h('h3', { className: 'pau-card-t' }, '本地装的插件 · Git 上游识别'),
+        h(
+          'span',
+          { className: snap.detectGitOrigins ? 'pau-tag pau-tag-ok' : 'pau-tag' },
+          snap.detectGitOrigins ? '已开启' : '已关闭',
+        ),
+      ),
+      h(
+        'p',
+        { className: 'pau-sub' },
+        '有些插件本机是用本地 tgz 装的，但上游其实在 GitHub 发 tag。开启后会对这类插件核对仓库，识别成功的按 Git 参与联网检查与升级（升级时依赖写法会换成 github: 地址）。',
+      ),
+      h(
+        'label',
+        { className: 'pau-switch' },
+        h('input', {
+          type: 'checkbox',
+          checked: !!snap.detectGitOrigins,
+          onChange: (e) => patchSettings({ detectGitOrigins: e.target.checked }),
+        }),
+        '识别本地来源的 Git 上游',
+      ),
+      h(
+        'label',
+        { className: 'pau-switch' },
+        h('input', {
+          type: 'checkbox',
+          disabled: !snap.detectGitOrigins,
+          checked: !!snap.autoApplyGitLocal,
+          onChange: (e) => patchSettings({ autoApplyGitLocal: e.target.checked }),
+        }),
+        '定时任务也自动装这类更新（默认只提示，因为升级会把依赖写法从 file: 换成 github:）',
+      ),
+      h(
+        'div',
+        { className: 'pau-field' },
+        h(
+          'button',
+          {
+            className: 'pau-btn',
+            disabled: !!busy || !snap.detectGitOrigins,
+            onClick: () =>
+              run('origins', async () => {
+                const next = await call('/origins/refresh', { force: true });
+                const n = next.result && next.result.changed;
+                setNote(n ? `已重新识别 ${n} 个本地来源` : '没有需要重新识别的本地来源');
+                return next;
+              }),
+          },
+          busy === 'origins' ? '识别中…' : '重新识别上游',
+        ),
+        h(
+          'span',
+          { className: 'pau-row-d' },
+          origins.length ? `已记录 ${origins.length} 个候选（含识别失败的）` : '还没有识别记录',
+        ),
+      ),
+      origins.length
+        ? h(
+            'div',
+            { className: 'pau-scroll' },
+            origins.map((item) =>
+              h(
+                'div',
+                { className: 'pau-other', key: item.name },
+                h(
+                  'div',
+                  { className: 'pau-other-main' },
+                  h(
+                    'div',
+                    { className: 'pau-row-t' },
+                    h('span', { className: 'pau-mono' }, item.name),
+                    item.ok
+                      ? h('span', { className: 'pau-tag pau-tag-ok' }, '已识别')
+                      : h('span', { className: 'pau-tag pau-tag-err' }, '未识别'),
+                    item.disabled ? h('span', { className: 'pau-tag' }, '已停用') : null,
+                    item.ok && item.latestRef ? h('span', { className: 'pau-tag' }, item.latestRef) : null,
+                  ),
+                  h(
+                    'div',
+                    { className: 'pau-row-d' },
+                    item.ok
+                      ? `${item.owner}/${item.repo}${item.latest ? ` · 最新 v${item.latest}` : ' · 上游没打版本 tag（只比 commit）'}`
+                      : item.error || '未识别',
+                  ),
+                ),
+                item.ok
+                  ? h(
+                      'button',
+                      {
+                        className: 'pau-btn pau-btn-sm',
+                        disabled: !!busy,
+                        title: item.disabled ? '重新参与检查' : '停用后这个包回到「本地来源」，不再联网检查',
+                        onClick: () =>
+                          run(`origin-toggle:${item.name}`, async () => {
+                            const next = await call('/origins/toggle', {
+                              name: item.name,
+                              disabled: !item.disabled,
+                            });
+                            setNote(`${item.name} 上游识别已${item.disabled ? '恢复' : '停用'}`);
+                            return next;
+                          }),
+                      },
+                      busy === `origin-toggle:${item.name}` ? '处理中…' : item.disabled ? '恢复' : '停用',
+                    )
+                  : null,
+              ),
+            ),
+          )
+        : null,
+    );
+
     const pluginRow = (plugin) => {
       const isGit = plugin.kind === 'git';
+      // git-local：本机 file: 装着，但上游核实过就是这个包的 GitHub 仓库。
+      // 参与联网检查（比 tag 版本号），升级时把依赖写法换成 github:owner/repo#tag。
+      const isGitLocal = plugin.kind === 'git-local';
       // 三种特殊行，各自的状态文案必须诚实：
       //   system  —— 随 DSH 安装（本体插件已整组隐藏，这里只作兜底）
       //   missing —— 宿主知道但没装，不是「已是最新」
@@ -346,17 +481,24 @@ function makePanel(React) {
               : plugin.latestError
                 ? '查询失败'
                 : '已是最新';
-      // git 来源没有版本号可比：当前版本只认 commit，「最新」也只写短 sha
+      // git 来源没有版本号可比：当前版本只认 commit，「最新」也只写短 sha。
+      // git-local 反而是靠版本号比的（本机是 tag 打出来的 tgz），
+      // 所以它的「最新」写成 tag 更直观：最新 v0.43.1。
       const currentCommit = plugin.git && plugin.git.commit ? String(plugin.git.commit).slice(0, 10) : '';
       const showLatest = isGit
         ? Boolean(plugin.latest && plugin.latest !== currentCommit)
         : Boolean(plugin.latest && plugin.latest !== plugin.version);
-      const latestLabel = isGit ? `远端 ${plugin.latest}` : `最新 v${plugin.latest}`;
-      // npm 上有同名包才算「能切换」；查不到就明确说没有，免得用户反复猜
+      const latestLabel = isGit
+        ? `远端 ${plugin.latest}`
+        : isGitLocal && plugin.latestTag
+          ? `最新 ${plugin.latestTag}`
+          : `最新 v${plugin.latest}`;
+      // npm 上有同名包才算「能切换」；查不到就明确说没有，免得用户反复猜。
+      // git / git-local 一律不给这个按钮：它们已经能联网更新了，切 npm 只会丢掉信息。
       const migration = plugin.npmMigration;
-      const canMigrate = !isGit && plugin.kind === 'local' && migration && migration.available;
+      const canMigrate = !isGit && !isGitLocal && plugin.kind === 'local' && migration && migration.available;
       const migrationNote =
-        !isGit && plugin.kind === 'local' && migration
+        !isGit && !isGitLocal && plugin.kind === 'local' && migration
           ? migration.available
             ? `npm 上有同名包 ${migration.latest}${migration.upgradable ? '（更高）' : ''}，可切换来源`
             : 'npm 上没有同名包，保持原来源'
@@ -372,6 +514,8 @@ function makePanel(React) {
             { className: 'pau-row-t' },
             h('span', { className: 'pau-mono' }, plugin.name),
             isGit ? h('span', { className: 'pau-tag' }, 'Git') : null,
+            // git-local 要标出来：不然用户看到「本地 tgz 装的包也会联网检查」会以为是 bug
+            isGitLocal ? h('span', { className: 'pau-tag pau-tag-mine' }, 'Git 上游·本地装') : null,
             h('span', { className: 'pau-tag' }, plugin.version ? `v${plugin.version}` : '未装'),
             isGit && currentCommit ? h('span', { className: 'pau-tag' }, currentCommit) : null,
             showLatest ? h('span', { className: 'pau-tag' }, latestLabel) : null,
@@ -381,11 +525,22 @@ function makePanel(React) {
             ? h('div', { className: 'pau-row-d' }, `查询失败：${plugin.latestError}`)
             : isGit && plugin.latestMessage
               ? h('div', { className: 'pau-row-d' }, `${plugin.latestTag ? `${plugin.latestTag} · ` : ''}${plugin.latestMessage}`)
-              : migrationNote
-                ? h('div', { className: 'pau-row-d' }, migrationNote)
-                : plugin.description
-                  ? h('div', { className: 'pau-row-d' }, plugin.description.slice(0, 160))
-                  : null,
+              : isGitLocal
+                ? h(
+                    'div',
+                    { className: 'pau-row-d' },
+                    `Git 上游 ${plugin.origin && plugin.origin.owner ? `${plugin.origin.owner}/${plugin.origin.repo}` : '（已识别）'}` +
+                      `${plugin.origin && plugin.origin.latestRef ? ` · 最新 ${plugin.origin.latestRef}` : ''}` +
+                      `${plugin.origin && plugin.origin.latest ? `（v${plugin.origin.latest}）` : ''}` +
+                      ' · 升级时依赖写法会换成 github: 地址',
+                  )
+                : migrationNote
+                  ? h('div', { className: 'pau-row-d' }, migrationNote)
+                  : plugin.originError && plugin.kind === 'local'
+                    ? h('div', { className: 'pau-row-d' }, `上游识别：${plugin.originError}`)
+                    : plugin.description
+                      ? h('div', { className: 'pau-row-d' }, plugin.description.slice(0, 160))
+                      : null,
         ),
         // 系统插件 / 未安装 / 直链来源的策略与「立即更新」都是假的：
         // 一个版本跟桌面端走，一个根本没装，一个没有版本号可比。
@@ -431,7 +586,11 @@ function makePanel(React) {
               {
                 className: 'pau-btn pau-btn-sm',
                 disabled: !!busy || !plugin.updateAvailable,
-                title: isGit ? '安装远端最新提交' : '安装最新版本',
+                title: isGitLocal
+                  ? `切到 Git 上游 ${plugin.latestTag || plugin.latest || ''}（会把依赖写法换成 github: 地址）`
+                  : isGit
+                    ? '安装远端最新提交'
+                    : '安装最新版本',
                 onClick: () =>
                   run(`update:${plugin.name}`, async () => {
                     const body = isGit
@@ -541,14 +700,19 @@ function makePanel(React) {
         h(
           'h3',
           { className: 'pau-card-t' },
-          // 只数「真正参与自动更新」的（registry + git）。local / 直链 / 系统 / 未装
-          // 各自单列，混进这个数字会让「已装插件（N）」与实际能自动更新的数量不符。
-          `已装插件（${registryPlugins.length + gitPlugins.length}）`,
+          // 只数「真正参与自动更新」的（registry + git + git-local）。
+          // local / 直链 / 系统 / 未装各自单列，混进这个数字会让「已装插件（N）」
+          // 与实际能自动更新的数量不符。
+          `已装插件（${registryPlugins.length + gitPlugins.length + gitLocalPlugins.length}）`,
+        ),
+        h(
+          'span',
+          { className: 'pau-row-d' },
+          available.length ? `${available.length} 个可更新` : '全部最新',
         ),
-        h('span', { className: 'pau-row-d' }, available.length ? `${available.length} 个可更新` : '全部最新'),
       ),
-      registryPlugins.length + gitPlugins.length
-        ? registryPlugins.concat(gitPlugins).map(pluginRow)
+      registryPlugins.length + gitPlugins.length + gitLocalPlugins.length
+        ? registryPlugins.concat(gitPlugins).concat(gitLocalPlugins).map(pluginRow)
         : h('div', { className: 'pau-empty' }, '没有可联网检查的插件'),
       otherPlugins.length
         ? h(
@@ -689,6 +853,7 @@ function makePanel(React) {
         : null,
       masterCard,
       policyCard,
+      originCard,
       pluginsCard,
       restartCard,
       historyCard,