@chenpu17/cc-gw 0.2.1 → 0.2.2

package/README.md

@@ -13,7 +13,7 @@ cc-gw 是一个面向 Claude Code 与同类客户端的本地多模型网关，
 
 | 模块 | 说明 |
 | ---- | ---- |
-| `@cc-gw/server` | Fastify 服务，实现协议转换、模型路由、Provider 适配与日志存储 |
+| `@cc-gw/server` | Fastify 服务，实现协议转换、模型路由、Provider 适配与日志存储（支持 Anthropic 原生 payload/headers 透传与缓存统计） |
 | `@cc-gw/web` | React + Vite Web UI，包含仪表盘、日志面板、模型管理、系统设置 |
 | `@cc-gw/cli` | CLI 守护工具，封装 start/stop/restart/status 并托管 PID/日志 |
 
@@ -28,6 +28,8 @@ cc-gw start --daemon --port 4100
 
 首启会在 `~/.cc-gw/config.json` 生成配置模板，推荐直接通过 Web UI (`http://127.0.0.1:4100/ui`) 完成所有后续配置与调整。`cc-gw status`、`cc-gw stop`、`cc-gw restart` 可用于日常运维。
 
+> ⚠️ **Linux 安装提示**：如果未命中 sqlite3 的预编译二进制，需要系统具备 `build-essential`、`python3`、`python3-gyp` 等编译依赖。可执行 `sudo apt install build-essential python3 python3-gyp` 后，再运行 `npm install -g @chenpu17/cc-gw --unsafe-perm --build-from-source`。
+
 ### 从源码构建（开发者）
 
 前置：Node.js 18.18+（推荐 20 LTS）、pnpm 8+
@@ -89,7 +91,9 @@ pnpm --filter @cc-gw/cli exec tsx index.ts start --daemon --port 4100
     "claude-opus-4-1-20250805": "anthropic:claude-3-5-sonnet-latest"
   },
   "logRetentionDays": 30,
-  "storePayloads": true
+  "storePayloads": true,
+  "logLevel": "info",
+  "requestLogging": true
 }
 ```
 
@@ -99,8 +103,16 @@ pnpm --filter @cc-gw/cli exec tsx index.ts start --daemon --port 4100
 - 模型标识使用 `providerId:modelId` 形式供路由引用。
 - `modelRoutes`：将 Claude 发起的模型名映射到上游模型；未命中时使用 `defaults`。
 - `storePayloads`：是否在 SQLite 中压缩保存原始请求/响应（Brotli），关闭后仅保留元信息。
+- `logLevel`：控制 Fastify/Pino 控制台日志级别（`fatal`/`error`/`warn`/`info`/`debug`/`trace`）。
+- `requestLogging`：是否输出每个 HTTP 请求的访问日志，关闭后终端更加安静。
 - 推荐通过 Web UI 的“模型管理 / 系统设置”在线编辑并热加载，无需手工修改文件。
 
+#### Anthropic Provider 额外说明
+
+- 当 Provider `type` 设置为 `anthropic` 时，网关会保留 Claude Code 发来的完整 payload，并将其原样转发到 `<baseUrl>/v1/messages`，无需转换工具调用或 metadata 字段。
+- 所有自定义 Header（如 `x-stainless-*`、`anthropic-beta`、`anthropic-dangerous-direct-browser-access`）会自动透传到下游，确保 Claude Code 的诊断与调试能力不受影响。
+- usage 统计会解析 `cache_read_input_tokens` / `cache_creation_input_tokens`，从而在日志与 Web UI 的 Token 指标中显示缓存命中或写入量；Moonshot / Anthropic 若未返回上述字段，则 `cached` 会继续显示为空。
+
 ### 环境变量
 
 | 变量 | 说明 |
@@ -116,7 +128,7 @@ pnpm --filter @cc-gw/cli exec tsx index.ts start --daemon --port 4100
 - **Dashboard**：展示请求量、Token 使用、缓存命中、各模型 TTFT（Time To First Token）/TPOT（Total Processing Time）、SQLite 数据库占用。
 - **请求日志**：多条件筛选（时间、Provider、模型、状态），查看压缩日志详情，支持分页导出与清理。
 - **模型管理**：维护 Provider 列表、预置模型、路由策略；一键测试连通性（发送诊断 PROMPT）。
-- **系统设置**：端口、日志保留策略、是否存储请求 payload、日志清理工具。
+- **系统设置**：端口、日志保留策略、是否存储请求 payload、日志级别与访问日志开关、日志清理工具。
 
 UI 支持中英文、深色/浅色主题以及移动端响应式布局，提供键盘可达性（Skip Link、焦点管理）。
 
@@ -134,7 +146,7 @@ pnpm --filter @cc-gw/cli exec tsx index.ts status
 
 ## 数据与日志
 
-- 数据库：`~/.cc-gw/data/gateway.db`（`better-sqlite3`）。
+- 数据库：`~/.cc-gw/data/gateway.db`（`sqlite3`）。
   - `request_logs`：请求摘要、路由结果、耗时、TTFT/TPOT。
   - `request_payloads`：压缩的请求/响应正文（Brotli）。
   - `daily_metrics`：按日聚合的调用次数与 Token 统计。
@@ -171,6 +183,8 @@ cc-gw start --daemon --port 4100
 
 The first launch writes `~/.cc-gw/config.json`. Manage everything through the Web UI at `http://127.0.0.1:4100/ui`. Use `cc-gw status`, `cc-gw stop`, and `cc-gw restart` to control the daemon.
 
+> ⚠️ **Linux build note**: `sqlite3` may fall back to building from source. Install toolchain packages such as `build-essential`, `python3`, `python3-gyp`, then rerun `npm install -g @chenpu17/cc-gw --unsafe-perm --build-from-source` if needed.
+
 ### From Source (contributors)
 
 ```bash
@@ -190,14 +204,17 @@ claude "help me review this file"
 ### Configuration Snapshot
 
 - Providers include `type`, `baseUrl`, `apiKey`, and `models` descriptions.
+- When `type` is `anthropic`, cc-gw forwards the original Claude payload and all headers to `<baseUrl>/v1/messages`, so tool calls/metadata remain intact.
 - Model routes use `providerId:modelId` syntax to remap Claude requests.
 - `storePayloads` toggles compressed body retention; disable to keep only metadata.
+- `logLevel` adjusts Fastify/Pino verbosity (`fatal` → `trace`).
+- `requestLogging` controls whether per-request access logs are emitted to the console.
 - Web UI allows editing without restarting; CLI restart will pick up bundle changes after rebuilds.
 
 ### Observability & Storage
 
 - SQLite file under `~/.cc-gw/data/gateway.db` tracks logs and aggregated metrics.
-- Dashboard surfaces per-model TTFT/TPOT, cache hits, and DB size.
+- Dashboard surfaces per-model TTFT/TPOT, cache hits（including Anthropic `cache_read_input_tokens` / `cache_creation_input_tokens`）, and DB size.
 - Logs can be filtered/exported/cleaned directly from the UI.
 
 ### CLI Reference

package/package.json

@@ -1,23 +1,8 @@
 {
   "name": "@chenpu17/cc-gw",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "type": "module",
-  "scripts": {
-    "dev": "pnpm --filter server dev",
-    "build": "pnpm run build:server && pnpm run build:web",
-    "build:server": "pnpm --filter @cc-gw/server build",
-    "build:cli": "pnpm --filter @cc-gw/cli build",
-    "build:web": "pnpm --filter @cc-gw/web build",
-    "build:all": "pnpm run build:server && pnpm run build:cli && pnpm run build:web",
-    "release:bundle": "pnpm run build:all && node scripts/build-release.mjs",
-    "prepack": "pnpm run build:all",
-    "lint": "pnpm exec eslint .",
-    "format": "pnpm exec prettier --check .",
-    "format:write": "pnpm exec prettier --write .",
-    "typecheck": "pnpm -r exec tsc --noEmit",
-    "test": "pnpm exec vitest run"
-  },
   "bin": {
     "cc-gw": "src/cli/dist/index.js"
   },
@@ -28,15 +13,6 @@
     "README.md",
     "LICENSE"
   ],
-  "pnpm": {
-    "peerDependencyRules": {
-      "ignoreMissing": [
-        "react",
-        "react-dom"
-      ]
-    }
-  },
-  "packageManager": "pnpm@9.0.0",
   "engines": {
     "node": ">=18.18.0"
   },
@@ -55,7 +31,7 @@
   "dependencies": {
     "@fastify/cors": "^9.0.1",
     "@fastify/static": "^7.0.4",
-    "better-sqlite3": "^9.0.0",
+    "sqlite3": "^5.1.7",
     "commander": "^12.0.0",
     "colorette": "^2.0.20",
     "fastify": "^4.26.2",
@@ -71,6 +47,21 @@
     "prettier": "^3.2.5",
     "typescript": "^5.4.3",
     "typescript-eslint": "^7.5.0",
-    "vitest": "^1.6.0"
+    "vitest": "^1.6.0",
+    "@types/sqlite3": "^3.1.11"
+  },
+  "scripts": {
+    "dev": "pnpm --filter server dev",
+    "build": "pnpm run build:server && pnpm run build:web",
+    "build:server": "pnpm --filter @cc-gw/server build",
+    "build:cli": "pnpm --filter @cc-gw/cli build",
+    "build:web": "pnpm --filter @cc-gw/web build",
+    "build:all": "pnpm run build:server && pnpm run build:cli && pnpm run build:web",
+    "release:bundle": "pnpm run build:all && node scripts/build-release.mjs",
+    "lint": "pnpm exec eslint .",
+    "format": "pnpm exec prettier --check .",
+    "format:write": "pnpm exec prettier --write .",
+    "typecheck": "pnpm -r exec tsc --noEmit",
+    "test": "pnpm exec vitest run"
   }
-}
+}

package/src/cli/dist/index.js

@@ -69,7 +69,9 @@ async function ensureConfigTemplate(port) {
       },
       logRetentionDays: 30,
       modelRoutes: {},
-      storePayloads: true
+      storePayloads: true,
+      logLevel: "info",
+      requestLogging: true
     };
     await fsp.mkdir(path.dirname(CONFIG_FILE), { recursive: true });
     await fsp.writeFile(CONFIG_FILE, JSON.stringify(template, null, 2), "utf-8");
@@ -156,6 +158,28 @@ async function handleStart(options) {
     console.log(green(`\u5DF2\u5728 ${CONFIG_FILE} \u751F\u6210\u9ED8\u8BA4\u914D\u7F6E`));
     console.log(yellow(`\u9996\u6B21\u542F\u52A8\uFF1A\u5F85\u670D\u52A1\u5C31\u7EEA\u540E\uFF0C\u8BF7\u5728\u6D4F\u89C8\u5668\u8BBF\u95EE http://127.0.0.1:${effectivePort}/ui \u8FDB\u884C\u914D\u7F6E\u3002`));
   }
+  if (!options.daemon) {
+    const forwardSignal = (signal) => {
+      if (!child.killed) {
+        try {
+          child.kill(signal);
+        } catch {
+        }
+      }
+    };
+    process.on("SIGINT", forwardSignal);
+    process.on("SIGTERM", forwardSignal);
+    await new Promise((resolve) => {
+      child.on("exit", () => resolve());
+      child.on("close", () => resolve());
+    });
+    process.off("SIGINT", forwardSignal);
+    process.off("SIGTERM", forwardSignal);
+    await removePid();
+    if (child.exitCode && child.exitCode !== 0) {
+      process.exitCode = child.exitCode;
+    }
+  }
 }
 async function handleStop() {
   const pid = await readPid();