@thomas-huang/caosi 0.1.3 → 0.2.0

package/README.md

@@ -2,9 +2,19 @@
 
 [中文](README.zh-CN.md)
 
-A local converter between LLM client protocols and named upstream providers. Point Claude Code, Codex, or Gemini CLI at `http://127.0.0.1:9999/{provider_name}`. Same protocol is passed through; OpenAI Chat, OpenAI Responses, Claude Messages, and Gemini are converted when they differ.
+Keep using Claude Code, Codex, or Gemini CLI. Point them at your own upstream — no client switch.
 
-caosi is a converter, not a gateway.
+Set the Base URL to `http://127.0.0.1:9999/{provider_name}`. Same protocol is passed through; caosi converts when they differ.
+
+- A single static binary
+- npm ships the binaries: no install script, nothing fetched from GitHub
+- macOS, Linux, and Windows
+
+```bash
+npm install -g @thomas-huang/caosi
+```
+
+No Web UI, no OAuth, no key pool, no client-config rewrite. One process, one file, loopback only.
 
 ## Install
 
@@ -13,7 +23,7 @@ npm install -g @thomas-huang/caosi
 caosi --version
 ```
 
-Needs Node.js 18+ on macOS, Linux, or Windows (amd64). The npm package downloads a native binary from GitHub Releases.
+Needs Node.js 18+ on macOS, Linux, or Windows (amd64). The npm package includes native binaries; there is no install script and nothing is fetched from GitHub at install time.
 
 ## Run
 
@@ -23,7 +33,7 @@ The first start writes a sample Provider File and exits. That is intentional: ca
 caosi
 ```
 
-Edit `~/.caosi/providers.jsonc`. Set `api_key` and `base_url`. If Claude Code will talk to an OpenAI-compatible upstream, keep `model` (for example `deepseek-chat`) so the upstream does not see `claude-*`.
+Edit `~/.caosi/providers.jsonc`. Set `api_key` and `base_url`. If Claude Code will talk to an OpenAI-compatible upstream, keep `model` (for example `qwen/qwen3-coder`) so the upstream does not see `claude-*`.
 
 Start again:
 
@@ -35,26 +45,26 @@ curl -s http://127.0.0.1:9999/health
 ## Point Claude Code at it
 
 ```bash
-export ANTHROPIC_BASE_URL=http://127.0.0.1:9999/deepseek
+export ANTHROPIC_BASE_URL=http://127.0.0.1:9999/openrouter
 export ANTHROPIC_API_KEY=dummy
 claude
 ```
 
-Replace `deepseek` with your Provider Name. caosi ignores the client key and uses the Provider's `api_key`. Claude Code sends `/v1/messages`; caosi converts when the upstream is not Claude.
+Replace `openrouter` with your Provider Name. caosi ignores the client key and uses the Provider's `api_key`. Claude Code sends `/v1/messages`; caosi converts when the upstream is not Claude.
 
 ## Codex / OpenAI and Gemini CLI
 
 OpenAI SDK, Chat Completions, and Codex:
 
 ```bash
-export OPENAI_BASE_URL=http://127.0.0.1:9999/deepseek/v1
+export OPENAI_BASE_URL=http://127.0.0.1:9999/openrouter/v1
 export OPENAI_API_KEY=dummy
 ```
 
 Gemini CLI (`~/.gemini/.env` or the environment):
 
 ```bash
-export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
+export GEMINI_API_BASE=http://127.0.0.1:9999/openrouter
 ```
 
 ## Provider File
@@ -63,11 +73,11 @@ export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
 
 ```jsonc
 {
-  "deepseek": {
-    "base_url": "https://api.deepseek.com",
+  "openrouter": {
+    "base_url": "https://openrouter.ai/api",
     "protocol": "openai_chat",
     "api_key": "sk-...",
-    "model": "deepseek-chat"
+    "model": "qwen/qwen3-coder"
   }
 }
 ```
@@ -81,7 +91,7 @@ export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
 
 - `model` is optional: when set, it replaces the client's model name on the upstream request.
 - `headers` is optional extra request headers (for example OpenRouter).
-- `base_url` is a prefix. caosi does not strip `/v1`. Use the root the upstream actually expects (`https://api.deepseek.com`, not `https://api.deepseek.com/v1`).
+- `base_url` is a prefix. caosi does not strip `/v1`. Use the root the upstream actually expects (`https://openrouter.ai/api`, not `https://openrouter.ai/api/v1`).
 
 ## Listen, health, reload
 
@@ -92,6 +102,8 @@ export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
 
 ## What it does not do
 
+caosi is a converter, not a gateway.
+
 No Web UI, OAuth, failover, key pools, or rewriting your Claude Code / Codex / Gemini config files.
 
 ## Without Node.js
@@ -105,7 +117,7 @@ go install github.com/thomas-huang/caosi/cmd/caosi@latest
 go test ./...
 ```
 
-Domain language: [CONTEXT.md](CONTEXT.md). Decisions: [docs/adr](docs/adr).
+Domain language: [CONTEXT.md](CONTEXT.md). Architecture: [docs/architecture.md](docs/architecture.md). Decisions: [docs/adr](docs/adr).
 
 To cut a release, push a tag `vX.Y.Z`. GitHub Actions builds the five binaries, writes checksums, creates the Release, and publishes `@thomas-huang/caosi` to npm with GitHub OIDC trusted publishing (no access token).
 

package/bin/caosi.js

@@ -4,12 +4,38 @@ const fs = require("node:fs");
 const path = require("node:path");
 const { spawn } = require("node:child_process");
 
-const binaryName = process.platform === "win32" ? "caosi.exe" : "caosi";
-const binaryPath = path.join(__dirname, "..", "vendor", binaryName);
+function resolveAssetName() {
+  switch (process.platform) {
+    case "darwin":
+      if (process.arch === "arm64") return "caosi-darwin-arm64";
+      if (process.arch === "x64") return "caosi-darwin-amd64";
+      break;
+    case "linux":
+      if (process.arch === "arm64") return "caosi-linux-arm64";
+      if (process.arch === "x64") return "caosi-linux-amd64";
+      break;
+    case "win32":
+      if (process.arch === "x64") return "caosi-windows-amd64.exe";
+      break;
+    default:
+      break;
+  }
+  return "";
+}
+
+const assetName = resolveAssetName();
+const binaryPath = assetName
+  ? path.join(__dirname, "..", "vendor", assetName)
+  : "";
+
+if (!assetName) {
+  console.error(`caosi: unsupported platform ${process.platform}/${process.arch}`);
+  process.exit(1);
+}
 
 if (!fs.existsSync(binaryPath)) {
   console.error(
-    "caosi: bundled binary is missing. Reinstall with `npm install -g @thomas-huang/caosi` after a GitHub Release exists, or run `npm rebuild @thomas-huang/caosi`."
+    "caosi: bundled binary is missing. Reinstall with `npm install -g @thomas-huang/caosi`."
   );
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thomas-huang/caosi",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Local converter between LLM client protocols and named upstream providers",
   "license": "MIT",
   "homepage": "https://github.com/thomas-huang/caosi",
@@ -16,12 +16,9 @@
   },
   "files": [
     "bin/caosi.js",
-    "scripts/postinstall.js",
+    "vendor/",
     "README.md"
   ],
-  "scripts": {
-    "postinstall": "node ./scripts/postinstall.js"
-  },
   "keywords": [
     "caosi",
     "llm",

package/scripts/postinstall.js

@@ -1,126 +0,0 @@
-#!/usr/bin/env node
-
-const crypto = require("node:crypto");
-const fs = require("node:fs");
-const os = require("node:os");
-const path = require("node:path");
-
-const packageRoot = path.join(__dirname, "..");
-const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
-const vendorDir = path.join(packageRoot, "vendor");
-
-const repoBaseUrl =
-  process.env.CAOSI_NPM_BASE_URL || "https://github.com/thomas-huang/caosi/releases/download";
-const version = String(pkg.version || "").trim();
-const versionTag = version.startsWith("v") ? version : `v${version}`;
-
-function resolveAssetName() {
-  switch (process.platform) {
-    case "darwin":
-      if (process.arch === "arm64") return "caosi-darwin-arm64";
-      if (process.arch === "x64") return "caosi-darwin-amd64";
-      break;
-    case "linux":
-      if (process.arch === "arm64") return "caosi-linux-arm64";
-      if (process.arch === "x64") return "caosi-linux-amd64";
-      break;
-    case "win32":
-      if (process.arch === "x64") return "caosi-windows-amd64.exe";
-      break;
-    default:
-      break;
-  }
-  throw new Error(`unsupported platform ${process.platform}/${process.arch}`);
-}
-
-function skipDownload() {
-  if (process.env.CAOSI_SKIP_DOWNLOAD === "1") {
-    return "CAOSI_SKIP_DOWNLOAD=1";
-  }
-  if (version === "" || version === "0.0.0-dev" || version === "dev") {
-    return `package version ${version || "(empty)"} has no GitHub Release`;
-  }
-  return "";
-}
-
-async function download(url, destination) {
-  const response = await fetch(url, {
-    headers: {
-      "user-agent": `caosi-npm/${version}`
-    },
-    redirect: "follow"
-  });
-  if (!response.ok) {
-    throw new Error(`download failed for ${url}: HTTP ${response.status}`);
-  }
-  const buf = Buffer.from(await response.arrayBuffer());
-  fs.writeFileSync(destination, buf);
-}
-
-function parseChecksums(text) {
-  const map = new Map();
-  for (const line of text.split(/\r?\n/)) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    const match = trimmed.match(/^([a-f0-9]{64})\s+\*?(.+)$/i);
-    if (!match) {
-      throw new Error(`invalid checksums line: ${line}`);
-    }
-    map.set(match[2], match[1].toLowerCase());
-  }
-  return map;
-}
-
-function sha256(filePath) {
-  const hash = crypto.createHash("sha256");
-  hash.update(fs.readFileSync(filePath));
-  return hash.digest("hex");
-}
-
-async function main() {
-  const reason = skipDownload();
-  if (reason) {
-    console.log(`caosi: skipping binary download (${reason})`);
-    return;
-  }
-
-  const assetName = resolveAssetName();
-  const binaryName = process.platform === "win32" ? "caosi.exe" : "caosi";
-  const targetPath = path.join(vendorDir, binaryName);
-  const checksumsUrl = `${repoBaseUrl}/${versionTag}/checksums.txt`;
-
-  fs.mkdirSync(vendorDir, { recursive: true });
-
-  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "caosi-npm-"));
-  const checksumsPath = path.join(tempDir, "checksums.txt");
-  const downloadPath = path.join(tempDir, assetName);
-
-  try {
-    console.log(`caosi: downloading ${assetName} for ${process.platform}/${process.arch}`);
-    await download(checksumsUrl, checksumsPath);
-    const checksums = parseChecksums(fs.readFileSync(checksumsPath, "utf8"));
-    const expectedSha = checksums.get(assetName);
-    if (!expectedSha) {
-      throw new Error(`checksums.txt does not contain ${assetName}`);
-    }
-
-    await download(`${repoBaseUrl}/${versionTag}/${assetName}`, downloadPath);
-    const actualSha = sha256(downloadPath);
-    if (actualSha !== expectedSha) {
-      throw new Error(`checksum mismatch for ${assetName}`);
-    }
-
-    fs.copyFileSync(downloadPath, targetPath);
-    if (process.platform !== "win32") {
-      fs.chmodSync(targetPath, 0o755);
-    }
-    console.log(`caosi: installed binary to ${path.relative(packageRoot, targetPath)}`);
-  } finally {
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  }
-}
-
-main().catch((err) => {
-  console.error(`caosi: postinstall failed: ${err.message}`);
-  process.exit(1);
-});