deepseek-tui 0.8.31 → 0.8.33

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "deepseek-tui",
-  "version": "0.8.31",
-  "deepseekBinaryVersion": "0.8.31",
+  "version": "0.8.33",
+  "deepseekBinaryVersion": "0.8.33",
   "description": "Install and run deepseek and deepseek-tui binaries from GitHub release artifacts.",
   "author": "Hmbown",
   "license": "MIT",

package/scripts/artifacts.js

@@ -17,14 +17,21 @@ const ASSET_MATRIX = {
   },
 };
 
+// HarmonyPC (openharmony) is an x86_64 Linux-compatible environment; map it to
+// the linux binary family so npm install succeeds without a separate build target.
+const PLATFORM_ALIASES = {
+  openharmony: "linux",
+};
+
 function detectBinaryNames() {
-  const platform = os.platform();
+  const rawPlatform = os.platform();
+  const platform = PLATFORM_ALIASES[rawPlatform] || rawPlatform;
   const arch = os.arch();
   const defaults = ASSET_MATRIX[platform];
   if (!defaults) {
     const supported = Object.keys(ASSET_MATRIX).map(p => `'${p}'`).join(', ');
     throw new Error(
-      `Unsupported platform: ${platform}. Supported platforms: ${supported}.\n\n` +
+      `Unsupported platform: ${rawPlatform}. Supported platforms: ${supported}.\n\n` +
       unsupportedBuildHint(),
     );
   }

package/scripts/install.js

@@ -195,7 +195,7 @@ function installFailureHint(error) {
     "  If GitHub is unavailable on this network, mirror the release assets and set:",
     "    DEEPSEEK_TUI_RELEASE_BASE_URL=https://<mirror>/<release-asset-directory>/",
     "  The directory must contain deepseek-artifacts-sha256.txt and the platform binaries.",
-    "  See docs/INSTALL.md#npm-download-is-slow-or-times-out-from-mainland-china.",
+    "  See docs/INSTALL.md#npm-binary-download-times-out.",
   ].join("\n");
 }
 
@@ -790,6 +790,12 @@ async function withRetry(label, fn, context = "runtime") {
       logInfo(
         `${label} failed (attempt ${attempt}/${attemptLimit}): ${err.message}; retrying in ${wait} ms`,
       );
+      if (attempt === 1) {
+        const hint = installFailureHint(err);
+        if (hint) {
+          process.stderr.write(`${hint}\n`);
+        }
+      }
       await sleep(wait);
     }
   }

package/test/artifacts.test.js

@@ -0,0 +1,66 @@
+const assert = require("node:assert/strict");
+const path = require("node:path");
+const test = require("node:test");
+const os = require("os");
+
+const ARTIFACTS_PATH = path.join(__dirname, "..", "scripts", "artifacts.js");
+
+function withMockedOs(platform, arch, fn) {
+  const origPlatform = os.platform;
+  const origArch = os.arch;
+  os.platform = () => platform;
+  os.arch = () => arch;
+  delete require.cache[ARTIFACTS_PATH];
+  try {
+    return fn();
+  } finally {
+    os.platform = origPlatform;
+    os.arch = origArch;
+    delete require.cache[ARTIFACTS_PATH];
+  }
+}
+
+test("openharmony x64 resolves to linux x64 binaries", () => {
+  withMockedOs("openharmony", "x64", () => {
+    const { detectBinaryNames } = require(ARTIFACTS_PATH);
+    const result = detectBinaryNames();
+    assert.equal(result.deepseek, "deepseek-linux-x64");
+    assert.equal(result.tui, "deepseek-tui-linux-x64");
+  });
+});
+
+test("openharmony arm64 resolves to linux arm64 binaries", () => {
+  withMockedOs("openharmony", "arm64", () => {
+    const { detectBinaryNames } = require(ARTIFACTS_PATH);
+    const result = detectBinaryNames();
+    assert.equal(result.deepseek, "deepseek-linux-arm64");
+    assert.equal(result.tui, "deepseek-tui-linux-arm64");
+  });
+});
+
+test("genuinely unsupported platform throws with raw platform name", () => {
+  withMockedOs("freebsd", "x64", () => {
+    const { detectBinaryNames } = require(ARTIFACTS_PATH);
+    assert.throws(
+      () => detectBinaryNames(),
+      (err) => {
+        assert.match(err.message, /Unsupported platform: freebsd/);
+        return true;
+      },
+    );
+  });
+});
+
+test("known platforms are unaffected by alias map", () => {
+  for (const [platform, arch, expectedDeepseek] of [
+    ["linux", "x64", "deepseek-linux-x64"],
+    ["darwin", "arm64", "deepseek-macos-arm64"],
+    ["win32", "x64", "deepseek-windows-x64.exe"],
+  ]) {
+    withMockedOs(platform, arch, () => {
+      const { detectBinaryNames } = require(ARTIFACTS_PATH);
+      const result = detectBinaryNames();
+      assert.equal(result.deepseek, expectedDeepseek);
+    });
+  }
+});

package/test/install.test.js

@@ -39,6 +39,7 @@ test("install failure hint explains release base override for blocked GitHub dow
     assert.match(hint, /DEEPSEEK_TUI_RELEASE_BASE_URL/);
     assert.match(hint, /deepseek-artifacts-sha256\.txt/);
     assert.match(hint, /platform binaries/);
+    assert.match(hint, /#npm-binary-download-times-out/);
   } finally {
     if (previous === undefined) {
       delete process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;

package/test/postinstall.test.js

@@ -89,3 +89,42 @@ test("optional install still swallows wrapped http 5xx failures", async () => {
     }
   }
 });
+
+test("withRetry prints install hint on first retryable failure", async () => {
+  const previousWrite = process.stderr.write;
+  const previousSetTimeout = global.setTimeout;
+  let stderr = "";
+  let attempts = 0;
+  process.stderr.write = (chunk) => {
+    stderr += String(chunk);
+    return true;
+  };
+  global.setTimeout = (callback) => {
+    callback();
+    return 0;
+  };
+
+  try {
+    const result = await _internal.withRetry(
+      "fetch https://github.com/example",
+      async () => {
+        attempts += 1;
+        if (attempts === 1) {
+          const err = new Error("connect ETIMEDOUT 20.205.243.166:443");
+          err.code = "ETIMEDOUT";
+          throw err;
+        }
+        return "ok";
+      },
+      "runtime",
+    );
+
+    assert.equal(result, "ok");
+    assert.equal(attempts, 2);
+    assert.match(stderr, /deepseek-tui install hint:/);
+    assert.match(stderr, /#npm-binary-download-times-out/);
+  } finally {
+    process.stderr.write = previousWrite;
+    global.setTimeout = previousSetTimeout;
+  }
+});