noldoj-cli 0.0.0-stage → 1.1.0

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# NoldOJ CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+NoldOJ 评测平台的跨平台命令行客户端。配置站点地址与私人令牌后，可以在终端管理题目、提交代码、参加比赛，或像 `gh api` 一样直接请求该站点的任意接口。
+
+- 文档：<https://nojc.dxxj.de5.net>
+- 源码：<https://github.com/dxxjudges/noldoj-cli>
+- 发布：<https://github.com/dxxjudges/noldoj-cli/releases>
+
+> CLI 本身不包含题目或数据，也不内置服务器地址：必须先配置一个可访问的 NoldOJ 站点与私人令牌，否则命令无法工作。
+
+## 安装
+
+```bash
+npm install -g noldoj-cli
+```
+
+也可直接从 [Releases](https://github.com/dxxjudges/noldoj-cli/releases) 下载对应平台的二进制：Linux x64/x86/arm64、macOS x64/arm64、Windows x64/x86/arm64 均已提供。Android / Termux 请在 Termux 内从源码编译。
+
+npm 包在首次运行时才会下载对应平台的二进制，缓存在 `~/.noldoj-cli/bin/<版本>/`；可用 `NOLDOJ_CLI_CACHE` 改变缓存位置，或用 `NOLDOJ_CLI_BIN` 直接指定已有可执行文件。
+
+## 快速开始
+
+```bash
+noldoj site add --name main --url https://your-oj.example.com --token <私人令牌>
+noldoj auth tokeninfo
+noldoj problem list --page 1
+noldoj help problem
+```
+
+## 凭据
+
+令牌不会明文落盘：`credentials.json` 使用 AES-256-CTR + HMAC-SHA256 加密，主密钥为首次启动时生成的 256 位随机密钥，保存在系统凭据库（Windows 凭据管理器 / macOS 钥匙串 / Linux Secret Service），不可用时回退到配置目录下权限 0600 的 `master.key`。用 `noldoj config path` 查看实际位置。
+
+## 从源码构建
+
+```bash
+git clone https://github.com/dxxjudges/noldoj-cli.git
+cd noldoj-cli
+cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
+cmake --build build
+python tests/run_tests.py build/noldoj      # Windows 为 build/noldoj.exe
+```
+
+Windows 使用系统 WinHTTP，其余平台使用 libcurl（Linux 需 `libcurl4-openssl-dev`，macOS 使用系统 libcurl）。
+
+## 发布
+
+- 提交信息为 `build X.Y.Z` 或打 `vX.Y.Z` 标签时，GitHub Actions 会构建全部平台并创建 Release。
+- npm 包版本通过 `npm version patch|minor|major` 更新，不要手改 `package.json` 的版本号。

package/bin/noldoj.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+"use strict";
+
+// NoldOJ CLI 的 npm 启动器：按平台下载对应 Release 二进制并缓存，然后透传参数执行。
+// 安装阶段不联网；首次运行（或版本变化后）才下载。
+
+const { spawn } = require("node:child_process");
+const fs = require("node:fs");
+const https = require("node:https");
+const os = require("node:os");
+const path = require("node:path");
+
+const VERSION = require("../package.json").version;
+const REPO = "dxxjudges/noldoj-cli";
+
+const ASSETS = {
+  "win32-x64": "noldoj-windows-x64.exe",
+  "win32-ia32": "noldoj-windows-x86.exe",
+  "win32-arm64": "noldoj-windows-arm64.exe",
+  "linux-x64": "noldoj-linux-x64",
+  "linux-ia32": "noldoj-linux-x86",
+  "linux-arm64": "noldoj-linux-arm64",
+  "darwin-x64": "noldoj-macos-x64",
+  "darwin-arm64": "noldoj-macos-arm64",
+};
+
+function assetName() {
+  const key = `${process.platform}-${process.arch}`;
+  return ASSETS[key] || null;
+}
+
+function cacheDir() {
+  const root = process.env.NOLDOJ_CLI_CACHE || path.join(os.homedir(), ".noldoj-cli", "bin");
+  return path.join(root, VERSION);
+}
+
+function download(url, target, redirects = 0) {
+  return new Promise((resolve, reject) => {
+    if (redirects > 5) {
+      reject(new Error("下载重定向次数过多"));
+      return;
+    }
+    https
+      .get(url, { headers: { "user-agent": `noldoj-cli-npm/${VERSION}` } }, (response) => {
+        const status = response.statusCode || 0;
+        if (status >= 300 && status < 400 && response.headers.location) {
+          response.resume();
+          download(response.headers.location, target, redirects + 1).then(resolve, reject);
+          return;
+        }
+        if (status !== 200) {
+          response.resume();
+          reject(new Error(`下载失败（HTTP ${status}）：${url}`));
+          return;
+        }
+
+        const temporary = `${target}.part`;
+        const stream = fs.createWriteStream(temporary, { mode: 0o755 });
+        response.pipe(stream);
+        stream.on("finish", () => {
+          stream.close(() => {
+            try {
+              fs.renameSync(temporary, target);
+              resolve();
+            } catch (error) {
+              reject(error);
+            }
+          });
+        });
+        stream.on("error", (error) => {
+          fs.rmSync(temporary, { force: true });
+          reject(error);
+        });
+      })
+      .on("error", (error) => {
+        reject(new Error(`无法连接下载服务器：${error.message}`));
+      });
+  });
+}
+
+async function ensureBinary(asset) {
+  const target = path.join(cacheDir(), asset);
+  if (fs.existsSync(target)) return target;
+
+  fs.mkdirSync(cacheDir(), { recursive: true });
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${asset}`;
+  process.stderr.write(`noldoj-cli: 正在下载 ${asset}（v${VERSION}）…\n`);
+  await download(url, target);
+  if (process.platform !== "win32") fs.chmodSync(target, 0o755);
+  return target;
+}
+
+async function main() {
+  const override = process.env.NOLDOJ_CLI_BIN;
+  const asset = assetName();
+
+  if (!override && !asset) {
+    process.stderr.write(
+      `noldoj-cli: 暂不支持 ${process.platform}/${process.arch} 的预编译二进制。\n` +
+        `请从 https://github.com/${REPO} 下载源码编译，或设置 NOLDOJ_CLI_BIN 指向已有可执行文件。\n`
+    );
+    process.exit(1);
+  }
+
+  let binary = override;
+  if (!binary) {
+    try {
+      binary = await ensureBinary(asset);
+    } catch (error) {
+      process.stderr.write(
+        `noldoj-cli: ${error.message}\n` +
+          `可手动下载 v${VERSION} 的 Release 资产，或用 NOLDOJ_CLI_BIN 指定路径。\n`
+      );
+      process.exit(1);
+    }
+  }
+
+  const child = spawn(binary, process.argv.slice(2), { stdio: "inherit" });
+  child.on("error", (error) => {
+    process.stderr.write(`noldoj-cli: 无法启动 ${binary}：${error.message}\n`);
+    process.exit(1);
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code === null ? 1 : code);
+  });
+}
+
+main();

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "noldoj-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "NoldOJ 评测平台的跨平台命令行客户端：配置站点与私人令牌后，即可在终端刷题、出题、打比赛，或直接调用任意 API",
+  "keywords": [
+    "noldoj",
+    "oj",
+    "online-judge",
+    "cli",
+    "competitive-programming"
+  ],
+  "homepage": "https://nojc.dxxj.de5.net",
+  "bugs": {
+    "url": "https://github.com/dxxjudges/noldoj-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dxxjudges/noldoj-cli.git"
+  },
+  "license": "MIT",
+  "bin": {
+    "noldoj": "bin/noldoj.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --check bin/noldoj.js"
+  }
+}