creative-upload-extension-updater 0.1.1 → 0.1.3

package/README.md

@@ -5,14 +5,13 @@ macOS Native Messaging updater for the unpacked Creative Upload Chrome extension
 ## First installation
 
 ```bash
-npm install -g creative-upload-extension-updater
+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
 
@@ -20,13 +19,13 @@ The extension ID is fixed to `amfhocfbdlbooohhoinhhhgobfdmaljc`. Do not change t
 creative-upload-extension-updater diagnose
 creative-upload-extension-updater update
 creative-upload-extension-updater rollback
+creative-upload-updater uninstall
 ```
 
-`creative-upload-updater` is kept as a shorter command alias. Both commands
-run the same updater and are supported for backward compatibility.
-
 `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, 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
 
 The updater accepts only the configured Registry URL, checks the release SHA256, verifies the detached Ed25519 signature, and verifies the manifest version and fixed Extension ID before replacing files. HTTP is a temporary internal-network transport exception; the signing private key is never stored in this package or in the Registry.

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

@@ -1,7 +1,29 @@
 #!/usr/bin/env node
 const fs = require('node:fs');
 const path = require('node:path');
-const { diagnose, install, requestChromeReload, rollback, update, TRANSITION_HTTP_REGISTRY_ORIGIN } = require('../lib/updater');
+const { diagnose, install, requestChromeReload, rollback, uninstall, update, TRANSITION_HTTP_REGISTRY_ORIGIN } = require('../lib/updater');
+
+const packageVersion = require('../package.json').version;
+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 <命令> [选项]
+
+命令：
+  install [--registry <url>] [--allow-insecure]  安装更新器与首次插件版本
+  update [--no-reload]                           下载并应用最新插件版本
+  diagnose                                       输出本机安装诊断
+  rollback                                       回滚到上一插件版本
+  uninstall                                      移除更新器注册、插件文件与历史版本
+
+选项：
+  --help, -h       显示帮助
+  --version, -v    显示版本`;
 
 const parseArguments = (values) =>
   values.reduce((result, value, index) => {
@@ -15,6 +37,14 @@ const parseArguments = (values) =>
 const main = async () => {
   const [command] = process.argv.slice(2);
   const args = parseArguments(process.argv.slice(3));
+  if (!command || command === '--help' || command === '-h' || args.help === true) {
+    process.stdout.write(`${usage}\n`);
+    return;
+  }
+  if (command === '--version' || command === '-v' || args.version === true) {
+    process.stdout.write(`${packageVersion}\n`);
+    return;
+  }
   if (command === 'install') {
     const publicKey =
       typeof args['public-key'] === 'string'
@@ -28,6 +58,7 @@ const main = async () => {
       hostPath: path.resolve(__dirname, 'native-host.js'),
     });
     process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    printInstallGuide(result.extensionDirectory);
     return;
   }
   if (command === 'diagnose') return process.stdout.write(`${JSON.stringify(diagnose(), null, 2)}\n`);
@@ -40,9 +71,8 @@ const main = async () => {
     return process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
   }
   if (command === 'rollback') return process.stdout.write(`${JSON.stringify(rollback(), null, 2)}\n`);
-  throw new Error(
-    '用法：creative-upload-extension-updater install [--registry <url>] [--allow-insecure] | update [--no-reload] | diagnose | rollback。默认使用当前 Devbox 过渡地址。',
-  );
+  if (command === 'uninstall') return process.stdout.write(`${JSON.stringify(uninstall(), null, 2)}\n`);
+  throw new Error(`未知命令：${command}\n\n${usage}`);
 };
 
 main().catch((error) => {

package/lib/updater.js

@@ -16,6 +16,15 @@ const configPath = path.join(baseDirectory, 'updater.json');
 const extensionDirectory = path.join(baseDirectory, 'extension');
 const previousDirectory = path.join(baseDirectory, 'previous');
 const nativeHostLauncherPath = path.join(baseDirectory, 'native-host');
+const nativeHostManifestPath = path.join(
+  os.homedir(),
+  'Library',
+  'Application Support',
+  'Google',
+  'Chrome',
+  'NativeMessagingHosts',
+  `${HOST_NAME}.json`,
+);
 
 const readConfig = () => {
   if (!fs.existsSync(configPath)) throw new Error('更新器尚未安装。请运行 creative-upload-extension-updater install。');
@@ -148,12 +157,23 @@ const install = async ({ registryUrl = TRANSITION_HTTP_REGISTRY_ORIGIN, extensio
   const config = { registryUrl: registryUrl.replace(/\/$/, ''), extensionId, signingPublicKey: publicKey, allowInsecure };
   writeConfig(config);
   const update = await checkAndUpdate({ extensionId, currentVersion: '0.0.0' });
-  const manifestDirectory = path.join(os.homedir(), 'Library', 'Application Support', 'Google', 'Chrome', 'NativeMessagingHosts');
+  const manifestDirectory = path.dirname(nativeHostManifestPath);
   fs.mkdirSync(manifestDirectory, { recursive: true, mode: 0o700 });
   const launcherPath = installNativeHostLauncher(hostPath);
-  fs.writeFileSync(path.join(manifestDirectory, `${HOST_NAME}.json`), `${JSON.stringify({ name: HOST_NAME, description: 'Creative Upload Extension Updater', path: launcherPath, type: 'stdio', allowed_origins: [`chrome-extension://${extensionId}/`] }, null, 2)}\n`, { mode: 0o600 });
+  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 = () => {
+  const nativeHostRegistered = fs.existsSync(nativeHostManifestPath);
+  fs.rmSync(nativeHostManifestPath, { force: true });
+  fs.rmSync(baseDirectory, { recursive: true, force: true });
+  return {
+    nativeHostRemoved: nativeHostRegistered,
+    extensionDirectory,
+    extensionRemoved: !fs.existsSync(extensionDirectory),
+    chromeAction: '请在 chrome://extensions 手动移除已加载的扩展。',
+  };
+};
 const rollback = () => {
   if (!fs.existsSync(previousDirectory)) throw new Error('没有可回滚的上一版本。');
   const currentDirectory = `${extensionDirectory}.rollback-${Date.now()}`;
@@ -164,8 +184,7 @@ const rollback = () => {
 };
 const diagnose = () => {
   const config = readConfig();
-  const manifestPath = path.join(os.homedir(), 'Library', 'Application Support', 'Google', 'Chrome', 'NativeMessagingHosts', `${HOST_NAME}.json`);
-  return { extensionDirectory, extensionLoaded: fs.existsSync(path.join(extensionDirectory, 'manifest.json')), nativeHostRegistered: fs.existsSync(manifestPath), registryUrl: config.registryUrl, extensionId: config.extensionId };
+  return { extensionDirectory, extensionLoaded: fs.existsSync(path.join(extensionDirectory, 'manifest.json')), nativeHostRegistered: fs.existsSync(nativeHostManifestPath), registryUrl: config.registryUrl, extensionId: config.extensionId };
 };
 
-module.exports = { DEFAULT_EXTENSION_ID, HOST_NAME, TRANSITION_HTTP_REGISTRY_ORIGIN, checkAndUpdate, diagnose, install, requestChromeReload, rollback, update };
+module.exports = { DEFAULT_EXTENSION_ID, HOST_NAME, TRANSITION_HTTP_REGISTRY_ORIGIN, checkAndUpdate, diagnose, install, requestChromeReload, rollback, uninstall, update };

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "creative-upload-extension-updater",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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",
-    "creative-upload-extension-updater": "bin/creative-upload-extension-updater.js"
+    "creative-upload-updater": "bin/creative-upload-extension-updater.js"
   },
   "engines": {
     "node": ">=18"

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');