@walkhi/code-relax 0.1.0-beta.30 → 0.1.0-beta.32

package/dist/bin/manage-relay-admin.mjs

@@ -1,20 +1,20 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import mysql from 'mysql2/promise';
-
-const path = process.env.RELAY_MYSQL_CONFIG_FILE;
-const action = process.argv[2];
-const email = (process.argv[3] || '').trim().toLowerCase();
-if (!path || !['--grant', '--revoke', '--list'].includes(action) ||
-    (action !== '--list' && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email))) {
-  throw new Error('Use --grant EMAIL, --revoke EMAIL or --list with RELAY_MYSQL_CONFIG_FILE');
-}
-const db = await mysql.createConnection({ ...JSON.parse(fs.readFileSync(path, 'utf8')),
-  dateStrings: true, timezone: 'Z', multipleStatements: false });
-try {
-  if (action === '--grant') await db.execute(`INSERT INTO relay_admin_emails (email,granted_at)
-    VALUES (?,UTC_TIMESTAMP(3)) ON DUPLICATE KEY UPDATE email=VALUES(email)`, [email]);
-  else if (action === '--revoke') await db.execute('DELETE FROM relay_admin_emails WHERE email=?', [email]);
-  const [rows] = await db.query('SELECT email FROM relay_admin_emails ORDER BY email');
-  console.log(JSON.stringify({ admins: rows.map(row => row.email) }));
-} finally { await db.end(); }
+#!/usr/bin/env node
+import fs from 'node:fs';
+import mysql from 'mysql2/promise';
+
+const path = process.env.RELAY_MYSQL_CONFIG_FILE;
+const action = process.argv[2];
+const email = (process.argv[3] || '').trim().toLowerCase();
+if (!path || !['--grant', '--revoke', '--list'].includes(action) ||
+    (action !== '--list' && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email))) {
+  throw new Error('Use --grant EMAIL, --revoke EMAIL or --list with RELAY_MYSQL_CONFIG_FILE');
+}
+const db = await mysql.createConnection({ ...JSON.parse(fs.readFileSync(path, 'utf8')),
+  dateStrings: true, timezone: 'Z', multipleStatements: false });
+try {
+  if (action === '--grant') await db.execute(`INSERT INTO relay_admin_emails (email,granted_at)
+    VALUES (?,UTC_TIMESTAMP(3)) ON DUPLICATE KEY UPDATE email=VALUES(email)`, [email]);
+  else if (action === '--revoke') await db.execute('DELETE FROM relay_admin_emails WHERE email=?', [email]);
+  const [rows] = await db.query('SELECT email FROM relay_admin_emails ORDER BY email');
+  console.log(JSON.stringify({ admins: rows.map(row => row.email) }));
+} finally { await db.end(); }

package/dist/bin/migrate-relay-db.mjs

@@ -1,109 +1,109 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import { createHash } from 'node:crypto';
-import { fileURLToPath } from 'node:url';
-import mysql from 'mysql2/promise';
-import { relaySchemaVersions } from '../database/versions.mjs';
-import { deviceStore } from '../src/self-relay/device-store.mjs';
-import { relayAdminState } from '../src/self-relay/admin-state.mjs';
-
-const command = process.argv[2];
-if (!['--schema', '--import', '--check'].includes(command) || !process.env.RELAY_MYSQL_CONFIG_FILE) {
-  throw new Error('Use --schema, --import or --check with RELAY_MYSQL_CONFIG_FILE');
-}
-const config = JSON.parse(fs.readFileSync(process.env.RELAY_MYSQL_CONFIG_FILE, 'utf8'));
-const db = await mysql.createConnection({ ...config, dateStrings: true, timezone: 'Z', multipleStatements: false });
-const sqlTime = value => value.replace('T', ' ').replace(/Z$/, '');
-const migrations = relaySchemaVersions;
-try {
-  if (command === '--schema') {
-    const [existing] = await db.query("SHOW TABLES LIKE 'schema_migrations'");
-    const [applied] = existing.length ? await db.query('SELECT version, sha256 FROM schema_migrations') : [[]];
-    const known = new Map(applied.map(row => [row.version, row.sha256]));
-    if (known.size !== applied.length || [...known.keys()].some(version => !migrations.includes(version))) throw new Error('Unexpected schema version');
-    for (const version of migrations) {
-      const source = fs.readFileSync(fileURLToPath(new URL(`../database/${version}.sql`, import.meta.url)), 'utf8');
-      const sha256 = createHash('sha256').update(source).digest('hex');
-      if (known.has(version)) {
-        if (known.get(version) !== sha256) throw new Error(`Migration changed: ${version}`);
-        continue;
-      }
-      if (version !== migrations[0] && !known.has(migrations[migrations.indexOf(version) - 1])) throw new Error('Previous migration missing');
-      const statements = source.split('\n').filter(line => !line.trimStart().startsWith('--')).join('\n');
-      for (const statement of statements.split(';').map(item => item.trim()).filter(Boolean)) await db.query(statement);
-      await db.execute('INSERT INTO schema_migrations (version, sha256) VALUES (?,?)', [version, sha256]);
-      known.set(version, sha256);
-      console.log(JSON.stringify({ schema: version, sha256 }));
-    }
-  } else {
-    const [versions] = await db.query('SELECT version FROM schema_migrations');
-    if (!versions.some(row => row.version === '001_relay_core') || versions.some(row => !migrations.includes(row.version))) throw new Error('Unexpected schema version');
-    if (command === '--check') {
-      const names = ['computers', 'mobile_authorizations', 'official_computers', 'announcements', 'relay_settings', 'users', 'user_login_identities'];
-      if (versions.some(row => row.version === '002_email_accounts')) names.push('email_login_challenges', 'user_sessions', 'email_send_limits');
-      if (versions.some(row => row.version === '003_relay_usage')) names.push('relay_admin_emails', 'relay_usage_settings', 'relay_usage_totals', 'relay_usage_computer_totals', 'relay_usage_entitlements', 'relay_usage_budgets', 'relay_usage_computer_budgets', 'relay_usage_sessions');
-      if (versions.some(row => row.version === '004_relay_usage_actions')) names.push('relay_usage_actions');
-      if (versions.some(row => row.version === '006_relay_diagnostics')) names.push('relay_diagnostics');
-      if (versions.some(row => row.version === '007_relay_usage_daily')) names.push('relay_usage_user_days', 'relay_usage_computer_days');
-      const counts = {};
-      for (const name of names) { const [rows] = await db.query(`SELECT COUNT(*) AS count FROM ${name}`); counts[name] = rows[0].count; }
-      if (process.env.RELAY_STATE_FILE && process.env.RELAY_ADMIN_STATE_FILE) {
-        const devices = deviceStore(process.env.RELAY_STATE_FILE).entries();
-        const admin = relayAdminState(process.env.RELAY_ADMIN_STATE_FILE, 8).read();
-        const expected = { computers: devices.length,
-          mobile_authorizations: devices.reduce((sum, item) => sum + item.clients.length, 0),
-          official_computers: devices.filter(item => item.officialComputer).length,
-          announcements: admin.announcements.length, relay_settings: 1 };
-        if (Object.keys(expected).some(name => counts[name] !== expected[name])) throw new Error('Imported row counts differ from JSON');
-        const [saved] = await db.query('SELECT id,host_hash,status,revision FROM computers');
-        const original = new Map(devices.map(item => [item.id, item]));
-        for (const row of saved) {
-          const item = original.get(row.id);
-          if (!item || item.hostHash !== row.host_hash || item.status !== row.status || item.revision !== Number(row.revision)) {
-            throw new Error('Imported computer identity differs from JSON');
-          }
-        }
-        const [authorized] = await db.query('SELECT computer_id,client_id,credential_hash FROM mobile_authorizations');
-        for (const row of authorized) {
-          const item = original.get(row.computer_id)?.clients.find(client => client.id === row.client_id);
-          if (!item || item.hash !== row.credential_hash) throw new Error('Imported mobile authorization differs from JSON');
-        }
-        const [settings] = await db.query('SELECT max_relay_sessions FROM relay_settings WHERE id=1');
-        if (settings[0]?.max_relay_sessions !== admin.maxRelaySessions) throw new Error('Imported relay setting differs from JSON');
-        console.log(JSON.stringify({ verified: true, counts }));
-      } else console.log(JSON.stringify(counts));
-    } else {
-      const stateFile = process.env.RELAY_STATE_FILE, adminFile = process.env.RELAY_ADMIN_STATE_FILE;
-      if (!stateFile || !adminFile) throw new Error('RELAY_STATE_FILE and RELAY_ADMIN_STATE_FILE required for import');
-      const devices = deviceStore(stateFile).entries();
-      const admin = relayAdminState(adminFile, 8).read();
-      const [existing] = await db.query('SELECT (SELECT COUNT(*) FROM computers) AS computers, (SELECT COUNT(*) FROM relay_settings) AS settings');
-      if (existing[0].computers || existing[0].settings) throw new Error('Import target is not empty');
-      await db.beginTransaction();
-      try {
-        for (const item of devices) {
-          await db.execute('INSERT INTO computers (id,host_hash,status,revision,created_at,updated_at) VALUES (?,?,?,?,?,?)',
-            [item.id, item.hostHash, item.status, item.revision, sqlTime(item.createdAt), sqlTime(item.updatedAt)]);
-          for (const client of item.clients) await db.execute(
-            'INSERT INTO mobile_authorizations (computer_id,client_id,credential_hash,created_at,updated_at) VALUES (?,?,?,?,?)',
-            [item.id, client.id, client.hash, sqlTime(client.createdAt), sqlTime(client.updatedAt)]);
-          if (item.officialComputer) {
-            const official = item.officialComputer;
-            await db.execute('INSERT INTO official_computers (computer_id,environment_id,name,hostname,updated_at) VALUES (?,?,?,?,?)',
-              [item.id, official.environmentId, official.name, official.hostname, sqlTime(official.updatedAt)]);
-          }
-        }
-        await db.execute('INSERT INTO relay_settings (id,max_relay_sessions,updated_at) VALUES (1,?,UTC_TIMESTAMP(3))', [admin.maxRelaySessions]);
-        for (const item of admin.announcements) await db.execute(
-          'INSERT INTO announcements (id,title,message,status,created_at,updated_at,published_at) VALUES (?,?,?,?,?,?,?)',
-          [item.id, item.title, item.message, item.status, sqlTime(item.createdAt), sqlTime(item.updatedAt),
-            item.publishedAt ? sqlTime(item.publishedAt) : null]);
-        await db.commit();
-      } catch (error) { await db.rollback(); throw error; }
-      console.log(JSON.stringify({ imported: true, computers: devices.length,
-        mobileAuthorizations: devices.reduce((sum, item) => sum + item.clients.length, 0),
-        officialComputers: devices.filter(item => item.officialComputer).length,
-        announcements: admin.announcements.length }));
-    }
-  }
-} finally { await db.end(); }
+#!/usr/bin/env node
+import fs from 'node:fs';
+import { createHash } from 'node:crypto';
+import { fileURLToPath } from 'node:url';
+import mysql from 'mysql2/promise';
+import { relaySchemaVersions } from '../database/versions.mjs';
+import { deviceStore } from '../src/self-relay/device-store.mjs';
+import { relayAdminState } from '../src/self-relay/admin-state.mjs';
+
+const command = process.argv[2];
+if (!['--schema', '--import', '--check'].includes(command) || !process.env.RELAY_MYSQL_CONFIG_FILE) {
+  throw new Error('Use --schema, --import or --check with RELAY_MYSQL_CONFIG_FILE');
+}
+const config = JSON.parse(fs.readFileSync(process.env.RELAY_MYSQL_CONFIG_FILE, 'utf8'));
+const db = await mysql.createConnection({ ...config, dateStrings: true, timezone: 'Z', multipleStatements: false });
+const sqlTime = value => value.replace('T', ' ').replace(/Z$/, '');
+const migrations = relaySchemaVersions;
+try {
+  if (command === '--schema') {
+    const [existing] = await db.query("SHOW TABLES LIKE 'schema_migrations'");
+    const [applied] = existing.length ? await db.query('SELECT version, sha256 FROM schema_migrations') : [[]];
+    const known = new Map(applied.map(row => [row.version, row.sha256]));
+    if (known.size !== applied.length || [...known.keys()].some(version => !migrations.includes(version))) throw new Error('Unexpected schema version');
+    for (const version of migrations) {
+      const source = fs.readFileSync(fileURLToPath(new URL(`../database/${version}.sql`, import.meta.url)), 'utf8');
+      const sha256 = createHash('sha256').update(source).digest('hex');
+      if (known.has(version)) {
+        if (known.get(version) !== sha256) throw new Error(`Migration changed: ${version}`);
+        continue;
+      }
+      if (version !== migrations[0] && !known.has(migrations[migrations.indexOf(version) - 1])) throw new Error('Previous migration missing');
+      const statements = source.split('\n').filter(line => !line.trimStart().startsWith('--')).join('\n');
+      for (const statement of statements.split(';').map(item => item.trim()).filter(Boolean)) await db.query(statement);
+      await db.execute('INSERT INTO schema_migrations (version, sha256) VALUES (?,?)', [version, sha256]);
+      known.set(version, sha256);
+      console.log(JSON.stringify({ schema: version, sha256 }));
+    }
+  } else {
+    const [versions] = await db.query('SELECT version FROM schema_migrations');
+    if (!versions.some(row => row.version === '001_relay_core') || versions.some(row => !migrations.includes(row.version))) throw new Error('Unexpected schema version');
+    if (command === '--check') {
+      const names = ['computers', 'mobile_authorizations', 'official_computers', 'announcements', 'relay_settings', 'users', 'user_login_identities'];
+      if (versions.some(row => row.version === '002_email_accounts')) names.push('email_login_challenges', 'user_sessions', 'email_send_limits');
+      if (versions.some(row => row.version === '003_relay_usage')) names.push('relay_admin_emails', 'relay_usage_settings', 'relay_usage_totals', 'relay_usage_computer_totals', 'relay_usage_entitlements', 'relay_usage_budgets', 'relay_usage_computer_budgets', 'relay_usage_sessions');
+      if (versions.some(row => row.version === '004_relay_usage_actions')) names.push('relay_usage_actions');
+      if (versions.some(row => row.version === '006_relay_diagnostics')) names.push('relay_diagnostics');
+      if (versions.some(row => row.version === '007_relay_usage_daily')) names.push('relay_usage_user_days', 'relay_usage_computer_days');
+      const counts = {};
+      for (const name of names) { const [rows] = await db.query(`SELECT COUNT(*) AS count FROM ${name}`); counts[name] = rows[0].count; }
+      if (process.env.RELAY_STATE_FILE && process.env.RELAY_ADMIN_STATE_FILE) {
+        const devices = deviceStore(process.env.RELAY_STATE_FILE).entries();
+        const admin = relayAdminState(process.env.RELAY_ADMIN_STATE_FILE, 8).read();
+        const expected = { computers: devices.length,
+          mobile_authorizations: devices.reduce((sum, item) => sum + item.clients.length, 0),
+          official_computers: devices.filter(item => item.officialComputer).length,
+          announcements: admin.announcements.length, relay_settings: 1 };
+        if (Object.keys(expected).some(name => counts[name] !== expected[name])) throw new Error('Imported row counts differ from JSON');
+        const [saved] = await db.query('SELECT id,host_hash,status,revision FROM computers');
+        const original = new Map(devices.map(item => [item.id, item]));
+        for (const row of saved) {
+          const item = original.get(row.id);
+          if (!item || item.hostHash !== row.host_hash || item.status !== row.status || item.revision !== Number(row.revision)) {
+            throw new Error('Imported computer identity differs from JSON');
+          }
+        }
+        const [authorized] = await db.query('SELECT computer_id,client_id,credential_hash FROM mobile_authorizations');
+        for (const row of authorized) {
+          const item = original.get(row.computer_id)?.clients.find(client => client.id === row.client_id);
+          if (!item || item.hash !== row.credential_hash) throw new Error('Imported mobile authorization differs from JSON');
+        }
+        const [settings] = await db.query('SELECT max_relay_sessions FROM relay_settings WHERE id=1');
+        if (settings[0]?.max_relay_sessions !== admin.maxRelaySessions) throw new Error('Imported relay setting differs from JSON');
+        console.log(JSON.stringify({ verified: true, counts }));
+      } else console.log(JSON.stringify(counts));
+    } else {
+      const stateFile = process.env.RELAY_STATE_FILE, adminFile = process.env.RELAY_ADMIN_STATE_FILE;
+      if (!stateFile || !adminFile) throw new Error('RELAY_STATE_FILE and RELAY_ADMIN_STATE_FILE required for import');
+      const devices = deviceStore(stateFile).entries();
+      const admin = relayAdminState(adminFile, 8).read();
+      const [existing] = await db.query('SELECT (SELECT COUNT(*) FROM computers) AS computers, (SELECT COUNT(*) FROM relay_settings) AS settings');
+      if (existing[0].computers || existing[0].settings) throw new Error('Import target is not empty');
+      await db.beginTransaction();
+      try {
+        for (const item of devices) {
+          await db.execute('INSERT INTO computers (id,host_hash,status,revision,created_at,updated_at) VALUES (?,?,?,?,?,?)',
+            [item.id, item.hostHash, item.status, item.revision, sqlTime(item.createdAt), sqlTime(item.updatedAt)]);
+          for (const client of item.clients) await db.execute(
+            'INSERT INTO mobile_authorizations (computer_id,client_id,credential_hash,created_at,updated_at) VALUES (?,?,?,?,?)',
+            [item.id, client.id, client.hash, sqlTime(client.createdAt), sqlTime(client.updatedAt)]);
+          if (item.officialComputer) {
+            const official = item.officialComputer;
+            await db.execute('INSERT INTO official_computers (computer_id,environment_id,name,hostname,updated_at) VALUES (?,?,?,?,?)',
+              [item.id, official.environmentId, official.name, official.hostname, sqlTime(official.updatedAt)]);
+          }
+        }
+        await db.execute('INSERT INTO relay_settings (id,max_relay_sessions,updated_at) VALUES (1,?,UTC_TIMESTAMP(3))', [admin.maxRelaySessions]);
+        for (const item of admin.announcements) await db.execute(
+          'INSERT INTO announcements (id,title,message,status,created_at,updated_at,published_at) VALUES (?,?,?,?,?,?,?)',
+          [item.id, item.title, item.message, item.status, sqlTime(item.createdAt), sqlTime(item.updatedAt),
+            item.publishedAt ? sqlTime(item.publishedAt) : null]);
+        await db.commit();
+      } catch (error) { await db.rollback(); throw error; }
+      console.log(JSON.stringify({ imported: true, computers: devices.length,
+        mobileAuthorizations: devices.reduce((sum, item) => sum + item.clients.length, 0),
+        officialComputers: devices.filter(item => item.officialComputer).length,
+        announcements: admin.announcements.length }));
+    }
+  }
+} finally { await db.end(); }

package/dist/bin/publish-android-release.mjs

@@ -1,58 +1,63 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import path from 'node:path';
-import { createHash } from 'node:crypto';
-import { androidReleaseStorage } from '../relay-admin/android-release-storage.mjs';
-import { readAndroidCatalog } from '../src/self-relay/android-releases.mjs';
-
-// This administrative command runs only on the deployment host; no keys cross SSH.
-const [apkFile, metadataFile] = process.argv.slice(2);
-if (!apkFile || !metadataFile) throw new Error('Usage: publish-android-release.mjs APK METADATA');
-const storage = androidReleaseStorage('/etc/codex-relay/android-releases.json', '/etc/codex-relay/tencent-monitor.json');
-const metadata = JSON.parse(fs.readFileSync(metadataFile, 'utf8'));
-if (metadata.packageName !== 'cn.walkhi.coderelax' || !/^[a-f0-9]{64}$/.test(metadata.certificateSha256)) throw new Error('Invalid APK identity');
-const bytes = fs.readFileSync(apkFile), sha256 = createHash('sha256').update(bytes).digest('hex');
-if (sha256 !== metadata.sha256 || bytes.length !== metadata.size) throw new Error('Uploaded APK integrity mismatch');
-const { versionCode, versionName, size, notes, certificateSha256 } = metadata;
-const release = { versionCode, versionName, size, sha256, notes, certificateSha256,
-  objectKey: `code-relax/android/${versionCode}/Code-Relax-${sha256.slice(0, 16)}.apk` };
-const catalogFile = storage.catalogFile, temporary = catalogFile + '.new', lock = catalogFile + '.lock';
-const lockHandle = fs.openSync(lock, 'wx', 0o600);
-try {
-  const catalog = fs.existsSync(catalogFile) ? readAndroidCatalog(catalogFile) : { releases: [] };
-  const previous = catalog.releases.find(item => item.versionCode === versionCode);
-  if (previous && previous.sha256 !== sha256) throw new Error('A different APK already uses this versionCode');
-  if (catalog.latestVersionCode > versionCode) throw new Error('Refusing to publish an older version as latest');
-  if (catalog.releases.length && catalog.releases.some(item => item.certificateSha256 !== certificateSha256)) throw new Error('APK signing certificate changed');
-  const next = { latestVersionCode: versionCode, releases: [...catalog.releases.filter(item => item.versionCode !== versionCode), release] };
-  fs.writeFileSync(temporary, JSON.stringify(next, null, 2) + '\n', { mode: 0o640 });
-  readAndroidCatalog(temporary);
-  if (!previous) {
-    await new Promise((resolve, reject) => storage.cos.putObject({ ...storage.object(release), Body: bytes,
-      ContentLength: bytes.length, ContentType: 'application/vnd.android.package-archive',
-      ContentDisposition: `attachment; filename="Code-Relax-${versionName}.apk"`
-    }, (error, value) => error ? reject(error) : resolve(value)));
-  }
-  // Validate the exact signed GET that website and App use, before switching latest.
-  const ticket = await storage.signDownload(release);
-  const response = await fetch(ticket.url, { signal: AbortSignal.timeout(120000) });
-  if (!response.ok) throw new Error(`Signed download failed: HTTP ${response.status}`);
-  const downloaded = Buffer.from(await response.arrayBuffer());
-  if (downloaded.length !== size || createHash('sha256').update(downloaded).digest('hex') !== sha256) throw new Error('Stored APK integrity mismatch');
-  const unsigned = new URL(ticket.url); unsigned.search = '';
-  const denied = await fetch(unsigned, { method: 'HEAD', signal: AbortSignal.timeout(15000) });
-  if (denied.status !== 403) throw new Error(`Private object check failed: HTTP ${denied.status}`);
-  const owner = fs.statSync(path.dirname(catalogFile));
-  fs.chownSync(temporary, owner.uid, owner.gid);
-  fs.renameSync(temporary, catalogFile);
-  console.log(JSON.stringify({ published: true, versionCode, versionName, size, sha256, unsignedStatus: denied.status,
-    entry: 'https://www.coderelax.cn/code-relax/android' }));
-} catch (error) {
-  // COS errors can carry signed request details. Keep CLI output credential-free.
-  console.error('Android publication failed:', error?.code || (error?.name === 'Error' ? error.message : 'storage-request-failed'));
-  process.exitCode = 1;
-} finally {
-  fs.closeSync(lockHandle);
-  fs.unlinkSync(lock);
-  if (fs.existsSync(temporary)) fs.unlinkSync(temporary);
-}
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { androidReleaseStorage } from '../relay-admin/android-release-storage.mjs';
+import { readAndroidCatalog } from '../src/self-relay/android-releases.mjs';
+import { readPublicManifest, updatePublicAndroid } from '../src/self-relay/public-releases.mjs';
+
+// This administrative command runs only on the deployment host; no keys cross SSH.
+const [apkFile, metadataFile, mode] = process.argv.slice(2);
+if (mode && mode !== '--existing-object') throw new Error('Invalid publication mode');
+if (!apkFile || !metadataFile) throw new Error('Usage: publish-android-release.mjs APK METADATA');
+const storage = androidReleaseStorage('/etc/codex-relay/android-releases.json', '/etc/codex-relay/tencent-monitor.json');
+const metadata = JSON.parse(fs.readFileSync(metadataFile, 'utf8'));
+if (metadata.packageName !== 'com.walkhi.codexremote' || !/^[a-f0-9]{64}$/.test(metadata.certificateSha256)) throw new Error('Invalid APK identity');
+const { certificateSha256: expectedCertificate } = JSON.parse(fs.readFileSync('/etc/codex-relay/android-releases.json', 'utf8'));
+if (!/^[a-f0-9]{64}$/.test(expectedCertificate) || metadata.certificateSha256 !== expectedCertificate) throw new Error('APK signing certificate does not match release configuration');
+const bytes = fs.readFileSync(apkFile), sha256 = createHash('sha256').update(bytes).digest('hex');
+if (sha256 !== metadata.sha256 || bytes.length !== metadata.size) throw new Error('Uploaded APK integrity mismatch');
+const { versionCode, versionName, size, notes, certificateSha256 } = metadata;
+const release = { versionCode, versionName, size, sha256, notes, certificateSha256,
+  objectKey: `code-relax/android/${versionCode}/Code-Relax-${sha256.slice(0, 16)}.apk` };
+const catalogFile = storage.catalogFile, temporary = catalogFile + '.new', lock = catalogFile + '.lock';
+const lockHandle = fs.openSync(lock, 'wx', 0o600);
+try {
+  readPublicManifest();
+  const catalog = fs.existsSync(catalogFile) ? readAndroidCatalog(catalogFile) : { releases: [] };
+  const previous = catalog.releases.find(item => item.versionCode === versionCode);
+  if (previous && previous.sha256 !== sha256) throw new Error('A different APK already uses this versionCode');
+  if (catalog.latestVersionCode > versionCode) throw new Error('Refusing to publish an older version as latest');
+  const next = { latestVersionCode: versionCode, releases: [...catalog.releases.filter(item => item.versionCode !== versionCode), release] };
+  fs.writeFileSync(temporary, JSON.stringify(next, null, 2) + '\n', { mode: 0o640 });
+  readAndroidCatalog(temporary);
+  if (!previous && mode !== '--existing-object') {
+    await new Promise((resolve, reject) => storage.cos.putObject({ ...storage.object(release), Body: bytes,
+      ContentLength: bytes.length, ContentType: 'application/vnd.android.package-archive',
+      ContentDisposition: `attachment; filename="Code-Relax-${versionName}.apk"`
+    }, (error, value) => error ? reject(error) : resolve(value)));
+  }
+  // Validate the exact signed GET that website and App use, before switching latest.
+  const ticket = await storage.signDownload(release);
+  const response = await fetch(ticket.url, { signal: AbortSignal.timeout(120000) });
+  if (!response.ok) throw new Error(`Signed download failed: HTTP ${response.status}`);
+  const downloaded = Buffer.from(await response.arrayBuffer());
+  if (downloaded.length !== size || createHash('sha256').update(downloaded).digest('hex') !== sha256) throw new Error('Stored APK integrity mismatch');
+  const unsigned = new URL(ticket.url); unsigned.search = '';
+  const denied = await fetch(unsigned, { method: 'HEAD', signal: AbortSignal.timeout(15000) });
+  if (denied.status !== 403) throw new Error(`Private object check failed: HTTP ${denied.status}`);
+  const owner = fs.statSync(path.dirname(catalogFile));
+  fs.chownSync(temporary, owner.uid, owner.gid);
+  fs.renameSync(temporary, catalogFile);
+  updatePublicAndroid(release);
+  console.log(JSON.stringify({ published: true, versionCode, versionName, size, sha256, unsignedStatus: denied.status,
+    entry: 'https://www.coderelax.cn/code-relax/android' }));
+} catch (error) {
+  // COS errors can carry signed request details. Keep CLI output credential-free.
+  console.error('Android publication failed:', error?.code || (error?.name === 'Error' ? error.message : 'storage-request-failed'));
+  process.exitCode = 1;
+} finally {
+  fs.closeSync(lockHandle);
+  fs.unlinkSync(lock);
+  if (fs.existsSync(temporary)) fs.unlinkSync(temporary);
+}

package/dist/bin/publish-harmony-release.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { androidReleaseStorage } from '../relay-admin/android-release-storage.mjs';
+import { readHarmonyConfig, hapName, validateHarmonyMetadata, checkHarmonyVersion,
+  verifyHarmony, activateHarmony } from '../relay-admin/harmony-release.mjs';
+
+// Local PowerShell releases use the same verifier, COS objects and activation as GitHub CD.
+const directory = path.resolve(process.argv[2] || '');
+if (!process.argv[2]) throw Error('Usage: publish-harmony-release.mjs DIRECTORY');
+let stage = 'metadata';
+try {
+  const manifest = JSON.parse(fs.readFileSync(path.join(directory, 'manifest.json5'), 'utf8')).app;
+  const config = readHarmonyConfig();
+  const metadata = { packageName: manifest.bundleName, versionCode: manifest.versionCode,
+    versionName: manifest.versionName, certificateSha256: config.certificateSha256 };
+  if (!Number.isSafeInteger(metadata.versionCode) || metadata.versionCode <= 0
+    || !/^\d+\.\d+\.\d+$/.test(metadata.versionName)) throw Error();
+  metadata.files = [hapName(metadata), 'manifest.json5', 'icon.png'].map(name => {
+    const bytes = fs.readFileSync(path.join(directory, name));
+    return { name, size: bytes.length, sha256: createHash('sha256').update(bytes).digest('hex'),
+      contentMd5: createHash('md5').update(bytes).digest('base64') };
+  });
+  Object.assign(metadata, { size: metadata.files[0].size, sha256: metadata.files[0].sha256,
+    contentMd5: metadata.files[0].contentMd5 });
+  validateHarmonyMetadata(metadata, config);
+  checkHarmonyVersion(metadata);
+  stage = 'signature';
+  await verifyHarmony(directory, metadata, config);
+  const storage = androidReleaseStorage('/etc/codex-relay/android-releases.json', '/etc/codex-relay/tencent-monitor.json');
+  const keys = metadata.files.map(f => `code-relax/harmony/${metadata.versionCode}/${f.name}`);
+  stage = 'upload';
+  for (const [i, file] of metadata.files.entries()) {
+    await new Promise((resolve, reject) => storage.cos.putObject({ ...storage.object({ objectKey: keys[i] }),
+      Body: fs.createReadStream(path.join(directory, file.name)), ContentLength: file.size,
+      ContentMD5: file.contentMd5, ContentType: i === 1 ? 'application/json' : i === 2 ? 'image/png' : 'application/octet-stream',
+      Headers: { 'x-cos-forbid-overwrite': 'true' }
+    }, (error, result) => error ? reject(error) : resolve(result)));
+  }
+  stage = 'publication';
+  console.log(JSON.stringify(await activateHarmony(metadata, storage, keys)));
+} catch {
+  console.error(`Harmony publication failed at ${stage}; inspect objects and current version before retrying.`);
+  process.exitCode = 1;
+}