deepharness 0.0.2 → 0.0.3

package/README.md

@@ -4,74 +4,54 @@
 
 ## 安装
 
-`deepharness` npm 包是一个轻量级 JS 包装器，它需要本地 `dh` 二进制文件才能工作。
-
-### 1. 先安装 `dh` 二进制文件（必须）
-
-选择以下任一方式：
-
-#### 方式 A：安装 DeepHarness Desktop
-
-从发布页下载并安装桌面应用，它会自动将 `dh` 放入 PATH：
+`deepharness` npm 包会在安装时自动下载对应平台的原生 `dh` 二进制文件。
 
 ```bash
-https://github.com/deepharness/deepharness-ent-desktop
-```
-
-#### 方式 B：从源码编译（需要 Rust 工具链）
-
-```bash
-git clone https://github.com/deepharness/deepharness-ent-desktop.git
-cd deepharness-ent-desktop
-cargo build --release -p deepharness-cli
-
-# 安装到用户级可执行目录
-mkdir -p ~/.local/bin
-cp target/release/dh ~/.local/bin/dh
-
-# 确保 ~/.local/bin 在 PATH 中
-export PATH="$HOME/.local/bin:$PATH"
+npm install -g deepharness
 ```
 
-### 2. 再安装 npm 包
+安装完成后验证：
 
 ```bash
-# 全局安装（推荐安装到用户目录，避免权限问题）
-npm install -g deepharness
+dh --version
 ```
 
-> **权限问题？** 如果看到 `EACCES` 错误，说明 npm 默认全局目录需要 root 权限。推荐以下两种方案：
+### 权限问题
 
-#### 方案 1：更改 npm 全局目录到用户主目录
+如果 `npm install -g` 出现 `EACCES` 权限错误，推荐将 npm 全局目录改到用户主目录：
 
 ```bash
 mkdir -p ~/.npm-global
 npm config set prefix '~/.npm-global'
 export PATH="$HOME/.npm-global/bin:$PATH"
-# 将上面这行 export 也加入 ~/.bashrc 或 ~/.zshrc
+# 将上面 export 加入 ~/.bashrc 或 ~/.zshrc
 
 npm install -g deepharness
 ```
 
-#### 方案 2：使用 `npx`（无需全局安装）
+或者使用 `npx`（无需全局安装）：
 
 ```bash
 npx deepharness --version
 ```
 
-### 3. 验证安装
-
-```bash
-dh --version
-```
+### 手动指定二进制路径
 
-如果包装器找不到二进制文件，可以通过环境变量显式指定：
+如果自动下载失败，或你想使用自己编译的 `dh`，可通过环境变量指定：
 
 ```bash
 export DH_BINARY_PATH=/path/to/dh
 dh --version
 ```
 
+## 支持的平台
+
+安装脚本会根据当前系统自动下载对应二进制：
+
+- Linux x64 / arm64
+- macOS x64 / arm64
+- Windows x64
+
 ## 使用
 
 ```bash

package/bin/dh.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { spawn, execSync } from 'child_process';
-import { existsSync, realpathSync } from 'fs';
+import { existsSync, realpathSync, readFileSync } from 'fs';
 import { dirname, join, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
@@ -8,7 +8,7 @@ import { homedir } from 'os';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-const SYSTEM_INSTALL_URL = 'https://github.com/deepharness/deepharness-ent-desktop';
+const SYSTEM_INSTALL_URL = 'https://github.com/WraithN/deepharness-ent-desktop';
 
 /**
  * Resolve the real path of the wrapper script, following symlinks created by
@@ -22,13 +22,13 @@ function resolveWrapperPath() {
   }
 }
 
+const WRAPPER_PATH = resolveWrapperPath();
+
 /**
  * Check whether a candidate path resolves to this wrapper script itself.
  * This prevents `which dh` from returning the npm-installed JS wrapper and
  * causing an infinite subprocess loop.
  */
-const WRAPPER_PATH = resolveWrapperPath();
-
 function isWrapperItself(candidate) {
   try {
     return realpathSync(candidate) === WRAPPER_PATH;
@@ -59,7 +59,7 @@ function findProjectRoot() {
 }
 
 /**
- * Build a list of candidate paths where the `dh` native binary may live.
+ * Build a list of candidate paths where the `dh` binary may live.
  */
 function buildSearchPaths() {
   const paths = [];
@@ -113,6 +113,16 @@ function findDhBinary() {
   return null;
 }
 
+function readPackageVersion() {
+  try {
+    const pkgPath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    return pkg.version;
+  } catch {
+    return null;
+  }
+}
+
 function printInstallInstructions() {
   console.error('Error: `dh` binary not found.');
   console.error('');
@@ -131,22 +141,44 @@ function printInstallInstructions() {
   console.error('     export DH_BINARY_PATH=/path/to/dh');
 }
 
-const dhBin = findDhBinary();
+async function ensureDhBinary() {
+  const existing = findDhBinary();
+  if (existing) return existing;
+
+  // Try to download the binary from GitHub release on first use.
+  try {
+    const { downloadDhBinary } = await import('../scripts/download-binary.js');
+    const version = readPackageVersion();
+    if (!version) {
+      throw new Error('Cannot determine package version');
+    }
+    return await downloadDhBinary(version);
+  } catch (err) {
+    console.error(`[deepharness] Failed to download dh binary: ${err.message}`);
+    return null;
+  }
+}
+
+async function main() {
+  const dhBin = await ensureDhBinary();
+
+  if (!dhBin) {
+    printInstallInstructions();
+    process.exit(1);
+  }
 
-if (!dhBin) {
-  printInstallInstructions();
-  process.exit(1);
+  const args = process.argv.slice(2);
+  const proc = spawn(dhBin, args, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: { ...process.env, DH_NPM_WRAPPER: '1' },
+  });
+
+  proc.on('exit', (code) => process.exit(code ?? 1));
+  proc.on('error', (err) => {
+    console.error(`Failed to start dh from ${dhBin}:`, err.message);
+    process.exit(1);
+  });
 }
 
-const args = process.argv.slice(2);
-const proc = spawn(dhBin, args, {
-  stdio: 'inherit',
-  cwd: process.cwd(),
-  env: { ...process.env, DH_NPM_WRAPPER: '1' },
-});
-
-proc.on('exit', (code) => process.exit(code ?? 1));
-proc.on('error', (err) => {
-  console.error(`Failed to start dh from ${dhBin}:`, err.message);
-  process.exit(1);
-});
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepharness",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "description": "DeepHarness CLI - Connect to AI coding agents with Claude Code, OpenCode, and more",
   "bin": {
@@ -27,17 +27,20 @@
   ],
   "author": "DeepHarness Team",
   "license": "MIT",
+  "dependencies": {
+    "undici": "^6.0.0"
+  },
   "engines": {
     "node": ">= 18"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/deepharness/deepharness-ent-desktop.git"
+    "url": "git+https://github.com/WraithN/deepharness-ent-desktop.git"
   },
   "bugs": {
-    "url": "https://github.com/deepharness/deepharness-ent-desktop/issues"
+    "url": "https://github.com/WraithN/deepharness-ent-desktop/issues"
   },
-  "homepage": "https://github.com/deepharness/deepharness-ent-desktop",
+  "homepage": "https://github.com/WraithN/deepharness-ent-desktop",
   "publishConfig": {
     "access": "public"
   }

package/scripts/download-binary.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * Download the native `dh` binary from the GitHub release that matches the
+ * current platform and architecture.
+ */
+import { existsSync, mkdirSync, writeFileSync, chmodSync, readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+
+const GITHUB_OWNER = 'WraithN';
+const GITHUB_REPO = 'deepharness-ent-desktop';
+const DOWNLOAD_TIMEOUT_MS = 60_000;
+
+const PLATFORM_ASSET_NAMES = {
+  'linux:x64': 'dh-linux-x64',
+  'linux:arm64': 'dh-linux-arm64',
+  'darwin:x64': 'dh-darwin-x64',
+  'darwin:arm64': 'dh-darwin-arm64',
+  'win32:x64': 'dh-windows-x64.exe',
+};
+
+function getProxyUrl() {
+  return process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy || null;
+}
+
+async function fetchWithProxy(url) {
+  const proxyUrl = getProxyUrl();
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), DOWNLOAD_TIMEOUT_MS);
+
+  try {
+    if (proxyUrl) {
+      try {
+        const { ProxyAgent } = await import('undici');
+        return await fetch(url, {
+          signal: controller.signal,
+          dispatcher: new ProxyAgent(proxyUrl),
+        });
+      } catch (err) {
+        // If undici/ProxyAgent fails, fall back to default fetch so users
+        // without a problematic proxy still work.
+        console.warn(`[deepharness] Proxy download failed (${err.message}), retrying without proxy.`);
+      }
+    }
+
+    return await fetch(url, { signal: controller.signal });
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+function getPackageVersion() {
+  const __filename = fileURLToPath(import.meta.url);
+  const packageJsonPath = join(dirname(__filename), '..', 'package.json');
+  try {
+    const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    return pkg.version;
+  } catch {
+    return null;
+  }
+}
+
+function getAssetName() {
+  const key = `${process.platform}:${process.arch}`;
+  const assetName = PLATFORM_ASSET_NAMES[key];
+  if (!assetName) {
+    throw new Error(`Unsupported platform/architecture: ${key}. Supported platforms: ${Object.keys(PLATFORM_ASSET_NAMES).join(', ')}`);
+  }
+  return assetName;
+}
+
+function getBinaryName() {
+  return process.platform === 'win32' ? 'dh.exe' : 'dh';
+}
+
+function getInstallDir() {
+  return join(homedir(), '.local', 'bin');
+}
+
+function getBinaryPath() {
+  return join(getInstallDir(), getBinaryName());
+}
+
+function getDownloadUrl(version, assetName) {
+  return `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/releases/download/dh-v${version}/${assetName}`;
+}
+
+/**
+ * Download the binary for the current platform and install it to ~/.local/bin.
+ * Returns the path to the installed binary.
+ */
+export async function downloadDhBinary(version) {
+  const assetName = getAssetName();
+  const binaryPath = getBinaryPath();
+  const downloadUrl = getDownloadUrl(version, assetName);
+
+  console.log(`[deepharness] Downloading dh ${version} for ${process.platform}-${process.arch}...`);
+  console.log(`[deepharness] URL: ${downloadUrl}`);
+
+  const response = await fetchWithProxy(downloadUrl);
+  if (!response.ok) {
+    throw new Error(`Download failed: ${response.status} ${response.statusText} (${downloadUrl})`);
+  }
+
+  const buffer = Buffer.from(await response.arrayBuffer());
+
+  mkdirSync(getInstallDir(), { recursive: true });
+  writeFileSync(binaryPath, buffer);
+
+  if (process.platform !== 'win32') {
+    chmodSync(binaryPath, 0o755);
+  }
+
+  console.log(`[deepharness] Installed dh to ${binaryPath}`);
+  return binaryPath;
+}
+
+/**
+ * Check whether the installed binary is present.
+ */
+export function isBinaryInstalled() {
+  return existsSync(getBinaryPath());
+}
+
+export { getBinaryPath, getPackageVersion };
+
+// CLI entry point for testing or manual download.
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const version = process.argv[2] || getPackageVersion();
+  if (!version) {
+    console.error('Usage: node download-binary.js <version>');
+    process.exit(1);
+  }
+  downloadDhBinary(version).catch((err) => {
+    console.error(err.message);
+    process.exit(1);
+  });
+}

package/scripts/postinstall.js

@@ -4,10 +4,10 @@
  *
  * The npm package is only a wrapper; it needs the native `dh` binary to be
  * present on the system. This script verifies that the binary exists and,
- * when the package is installed from the source repository, attempts to build
- * it automatically so that `dh --version` works immediately after `npm link`.
+ * when possible, installs it automatically by downloading from the matching
+ * GitHub release or by building from source.
  */
-import { existsSync, realpathSync } from 'fs';
+import { existsSync, realpathSync, readFileSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
@@ -16,7 +16,7 @@ import { execSync } from 'child_process';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-const SYSTEM_INSTALL_URL = 'https://github.com/deepharness/deepharness-ent-desktop';
+const SYSTEM_INSTALL_URL = 'https://github.com/WraithN/deepharness-ent-desktop';
 
 function resolveWrapperPath() {
   try {
@@ -72,8 +72,14 @@ function findExistingDhBinary() {
   return null;
 }
 
-function isBinaryUsable() {
-  return !!findExistingDhBinary();
+function readPackageVersion() {
+  try {
+    const pkgPath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    return pkg.version;
+  } catch {
+    return null;
+  }
 }
 
 function buildFromSource(projectRoot) {
@@ -84,22 +90,32 @@ function buildFromSource(projectRoot) {
       stdio: 'inherit',
     });
     return true;
-  } catch (err) {
+  } catch {
     console.error('[deepharness] Failed to build dh from source.');
     return false;
   }
 }
 
-function main() {
+async function downloadBinary() {
+  const { downloadDhBinary } = await import('./download-binary.js');
+  const version = readPackageVersion();
+  if (!version) {
+    throw new Error('Cannot determine package version');
+  }
+  return downloadDhBinary(version);
+}
+
+async function main() {
   // If a usable binary already exists, nothing more to do.
-  if (isBinaryUsable()) {
-    const location = findExistingDhBinary();
-    console.log(`[deepharness] Found dh binary at ${location}`);
+  const existing = findExistingDhBinary();
+  if (existing) {
+    console.log(`[deepharness] Found dh binary at ${existing}`);
     return;
   }
 
   const projectRoot = findProjectRoot();
 
+  // Prefer building from source when installed inside the repository.
   if (projectRoot) {
     console.log('[deepharness] dh binary not found; attempting to build from source...');
     const built = buildFromSource(projectRoot);
@@ -114,10 +130,20 @@ function main() {
     }
   }
 
+  // Otherwise try to download the matching release binary.
+  try {
+    await downloadBinary();
+    return;
+  } catch (err) {
+    console.warn(`[deepharness] Could not download binary: ${err.message}`);
+  }
+
   console.warn('[deepharness] The native `dh` binary is not installed.');
   console.warn('[deepharness] The `dh` command will not work until it is available.');
   console.warn(`[deepharness] Install DeepHarness Desktop from: ${SYSTEM_INSTALL_URL}`);
   console.warn('[deepharness] Or build from source: cargo build --release -p deepharness-cli');
 }
 
-main();
+main().catch((err) => {
+  console.warn(`[deepharness] Post-install hook failed: ${err.message}`);
+});