creative-upload-extension-updater 0.1.2 → 0.1.4

package/README.md

@@ -9,10 +9,9 @@ npm install -g @ttam/creative-upload-extension-updater
 creative-upload-extension-updater install
 ```
 
-过渡期默认使用内网 Devbox 地址 `http://10.37.83.141:3100`，无需额外参数。其他 HTTP 地址必须显式传入 `--allow-insecure`；切换 HTTPS 后请使用 `--registry https://registry.example.com`。
-The command downloads and verifies the first release, then prints the fixed extension directory. In Chrome, enable Developer mode once and choose **Load unpacked** for that directory.
+`npm install` 完成后会提示运行 `creative-upload-updater install`；安装 npm 包本身不会自动下载插件或修改 Chrome。
 
-The extension ID is fixed to `amfhocfbdlbooohhoinhhhgobfdmaljc`. Do not change the manifest public key after users begin using this updater.
+安装成功后，CLI 会输出扩展目录，并引导依次打开 `chrome://extensions`、开启开发者模式、点击「加载已解压的扩展程序」。在 macOS 文件选择器中按 `Command + Shift + G`，粘贴输出的目录即可直接打开。
 
 ## Operations
 
@@ -21,12 +20,11 @@ creative-upload-extension-updater diagnose
 creative-upload-extension-updater update
 creative-upload-extension-updater rollback
 creative-upload-updater uninstall
-creative-upload-updater uninstall --purge
 ```
 
 `update` immediately checks the Registry and applies a newer verified release when available. On macOS it then opens a controlled extension URL so the running extension calls `chrome.runtime.reload()` automatically; pass `--no-reload` to only replace files. `rollback` restores the previous verified extension directory. Chrome must then reload the extension once.
 
-`uninstall` removes the Native Messaging registration and updater configuration but retains the downloaded extension. `uninstall --purge` additionally deletes the extension and rollback files. Both modes require manually removing the loaded extension in `chrome://extensions`; uninstall the CLI itself with `npm uninstall -g creative-upload-extension-updater`.
+`uninstall` removes the Native Messaging registration, updater configuration, downloaded extension, and rollback files. It still requires manually removing the loaded extension in `chrome://extensions`; uninstall the CLI itself with `npm uninstall -g creative-upload-extension-updater`.
 
 ## Security
 

package/bin/creative-upload-extension-updater.js

@@ -4,6 +4,19 @@ const path = require('node:path');
 const { diagnose, install, requestChromeReload, rollback, uninstall, update, TRANSITION_HTTP_REGISTRY_ORIGIN } = require('../lib/updater');
 
 const packageVersion = require('../package.json').version;
+const printJson = (value) => process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+const printResult = (args, value, lines) => {
+  if (args.json === true) return printJson(value);
+  process.stdout.write(`${lines.join('\n')}\n`);
+};
+const printInstallGuide = (extensionDirectory) => {
+  process.stdout.write('\n安装完成。请在 Chrome 完成一次加载：\n\n');
+  process.stdout.write('  1. 打开 chrome://extensions\n');
+  process.stdout.write('  2. 开启右上角「开发者模式」\n');
+  process.stdout.write('  3. 点击「加载已解压的扩展程序」\n');
+  process.stdout.write(`  4. 在文件选择器中按 Command + Shift + G，粘贴并打开：${extensionDirectory}\n\n`);
+  process.stdout.write('后续发布新版本后，扩展会定时检查更新；也可手动运行 creative-upload-updater update。\n');
+};
 const usage = `用法：creative-upload-updater <命令> [选项]
 
 命令：
@@ -11,11 +24,12 @@ const usage = `用法：creative-upload-updater <命令> [选项]
   update [--no-reload]                           下载并应用最新插件版本
   diagnose                                       输出本机安装诊断
   rollback                                       回滚到上一插件版本
-  uninstall [--purge]                            移除更新器注册；--purge 同时删除插件文件
+  uninstall                                      移除更新器注册、插件文件与历史版本
 
 选项：
   --help, -h       显示帮助
-  --version, -v    显示版本`;
+  --version, -v    显示版本
+  --json           以 JSON 输出命令结果`;
 
 const parseArguments = (values) =>
   values.reduce((result, value, index) => {
@@ -49,20 +63,44 @@ const main = async () => {
       allowInsecure: args['allow-insecure'] === true,
       hostPath: path.resolve(__dirname, 'native-host.js'),
     });
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    printResult(args, result, [
+      '插件更新器安装完成。',
+      `已安装插件版本：${result.targetVersion ?? result.currentVersion}`,
+      `扩展目录：${result.extensionDirectory}`,
+    ]);
+    printInstallGuide(result.extensionDirectory);
     return;
   }
-  if (command === 'diagnose') return process.stdout.write(`${JSON.stringify(diagnose(), null, 2)}\n`);
+  if (command === 'diagnose') {
+    const result = diagnose();
+    return printResult(args, result, [
+      '更新器诊断结果：',
+      `扩展目录：${result.extensionDirectory}`,
+      `扩展文件：${result.extensionLoaded ? '已找到' : '未找到'}`,
+      `Native Messaging：${result.nativeHostRegistered ? '已注册' : '未注册'}`,
+      `更新源：${result.registryUrl}`,
+      `扩展 ID：${result.extensionId}`,
+    ]);
+  }
   if (command === 'update') {
     const result = await update();
     if (result.status === 'updated' && args['no-reload'] !== true) {
       const diagnostic = diagnose();
       Object.assign(result, { chromeReload: requestChromeReload(diagnostic.extensionId) });
     }
-    return process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    const changed = result.status === 'updated';
+    return printResult(args, result, changed
+      ? [`更新完成：${result.currentVersion} → ${result.targetVersion}`, 'Chrome 将自动重新加载扩展；如未生效，请在 chrome://extensions 手动重新加载。']
+      : [`已是最新版本：${result.currentVersion}`]);
+  }
+  if (command === 'rollback') {
+    const result = rollback();
+    return printResult(args, result, ['已回滚到上一插件版本。', `扩展目录：${result.extensionDirectory}`, '请在 chrome://extensions 手动重新加载扩展。']);
+  }
+  if (command === 'uninstall') {
+    const result = uninstall();
+    return printResult(args, result, ['卸载完成。', '已删除更新器注册、插件文件与历史版本。', '请在 chrome://extensions 手动移除已加载的扩展。']);
   }
-  if (command === 'rollback') return process.stdout.write(`${JSON.stringify(rollback(), null, 2)}\n`);
-  if (command === 'uninstall') return process.stdout.write(`${JSON.stringify(uninstall({ purge: args.purge === true }), null, 2)}\n`);
   throw new Error(`未知命令：${command}\n\n${usage}`);
 };
 

package/lib/updater.js

@@ -163,17 +163,14 @@ const install = async ({ registryUrl = TRANSITION_HTTP_REGISTRY_ORIGIN, extensio
   fs.writeFileSync(nativeHostManifestPath, `${JSON.stringify({ name: HOST_NAME, description: 'Creative Upload Extension Updater', path: launcherPath, type: 'stdio', allowed_origins: [`chrome-extension://${extensionId}/`] }, null, 2)}\n`, { mode: 0o600 });
   return { ...update, extensionDirectory, extensionId };
 };
-const uninstall = ({ purge = false } = {}) => {
+const uninstall = () => {
   const nativeHostRegistered = fs.existsSync(nativeHostManifestPath);
   fs.rmSync(nativeHostManifestPath, { force: true });
-  fs.rmSync(configPath, { force: true });
-  fs.rmSync(nativeHostLauncherPath, { force: true });
-  if (purge) fs.rmSync(baseDirectory, { recursive: true, force: true });
+  fs.rmSync(baseDirectory, { recursive: true, force: true });
   return {
     nativeHostRemoved: nativeHostRegistered,
     extensionDirectory,
-    extensionRetained: !purge && fs.existsSync(extensionDirectory),
-    purged: purge,
+    extensionRemoved: !fs.existsSync(extensionDirectory),
     chromeAction: '请在 chrome://extensions 手动移除已加载的扩展。',
   };
 };

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "creative-upload-extension-updater",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "private": false,
   "description": "Native Messaging updater for the Creative Upload unpacked Chrome extension.",
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
   "bin": {
     "creative-upload-updater": "bin/creative-upload-extension-updater.js"
   },

package/scripts/postinstall.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+const packageInfo = require('../package.json');
+
+process.stdout.write(`\nCreative Upload Extension Updater v${packageInfo.version} 已安装。\n`);
+process.stdout.write('下一步运行：creative-upload-updater install\n');
+process.stdout.write('该命令会下载已验证的插件版本，并引导你在 Chrome 中加载扩展。\n\n');