@cc-monitoring/proxy-core 0.1.4 → 0.1.5

package/README.md

@@ -1,8 +1,6 @@
 # @cc-monitoring/proxy-core
 
-Claude Code 代理 + 监控 CLI。Fastify 应用层转发 + PM2 守护进程 + Web 管理面板 + 完整请求记录。
-
-一站式解决国内网络访问 Claude Code 的问题，同时提供请求日志、Token 统计、供应商切换、SSE 流式抓包等运维能力。
+Claude Code 代理工具 + Token 消耗监控面板。一行命令启动代理，实时追踪每次请求的模型、Token 用量和响应状态。
 
 [![npm version](https://img.shields.io/npm/v/@cc-monitoring/proxy-core.svg)](https://www.npmjs.com/package/@cc-monitoring/proxy-core)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -27,7 +25,7 @@ ccm start
 ccm ui
 
 # 3. 把 Claude Code 的 ANTHROPIC_BASE_URL 指向本地代理
-export ANTHROPIC_BASE_URL=http://localhost:3000
+export ANTHROPIC_BASE_URL=http://localhost:9527
 ```
 
 首次运行会在 `~/.cc-monitoring/` 生成配置文件和数据库：
@@ -67,20 +65,21 @@ ccm config set proxy.target https://xxx   # 修改上游地址
 
 ```json
 {
-  "server": { "port": 3000, "host": "localhost" },
+  "server": { "port": 9527, "host": "localhost" },
   "proxy": {
-    "target": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic",
-    "changeOrigin": true,
-    "rewritePrefix": ""
+    "target": "https://ark.cn-beijing.volces.com/api/coding",
+    "changeOrigin": true
   },
-  "logging": { "level": "info", "file": "logs/proxy.log" },
-  "auth": { "token": "" }
+  "logging": { "level": "info", "file": "logs/proxy.log", "maxSize": "10m", "interval": "1d", "compress": true },
+  "storage": { "type": "sqlite", "path": "logs/proxy.db", "maxDays": 7 }
 }
 ```
 
+> `logs/` 路径相对于 config 所在目录解析，实际存 `~/.cc-monitoring/logs/` 下。
+
 | 字段 | 类型 | 说明 |
 |------|------|------|
-| `server.port` | number (1-65535) | 监听端口，默认 3000 |
+| `server.port` | number (1-65535) | 监听端口，默认 9527 |
 | `server.host` | string | 监听主机 |
 | `proxy.target` | URL | 上游 AI 供应商 API |
 | `proxy.changeOrigin` | boolean | 是否重写 Origin 头 |
@@ -92,7 +91,7 @@ ccm config set proxy.target https://xxx   # 修改上游地址
 
 ## Web 管理面板
 
-`ccm ui` 或访问 `http://localhost:3000/ui`：
+`ccm ui` 或访问 `http://localhost:9527/ui`：
 
 - **状态监控**：CPU / 内存 / 运行时间 / 重启次数（5s 刷新）
 - **实时日志**：WebSocket 推流、级别过滤、关键字搜索
@@ -100,29 +99,6 @@ ccm config set proxy.target https://xxx   # 修改上游地址
 - **配置编辑**：可视化改 `config.json`，Zod 实时校验
 - **供应商管理**：多供应商配置，一键切换 baseUrl / apiKey / model
 
-## 架构要点
-
-**应用层转发**（Controller + Fetch + SSE Pipe），非透明代理：
-
-```
-Claude Code
-   ↓ POST /v1/messages
-Fastify（解析 body）
-   ↓ saveRequest（记录完整 payload）
-fetch → 上游 API
-   ↓ Web ReadableStream
-reply.hijack() + Readable.fromWeb().pipe(reply.raw)
-   ↓ 原样 SSE 转发
-Claude Code
-```
-
-为什么不用透明代理：`@fastify/http-proxy` 内部消费 request stream，无法同时完成「记录 body + 转发 SSE + 未来鉴权/统计」。HTTP stream 只能消费一次。
-
-**关键处理**：
-- Web Stream → Node Stream：`Readable.fromWeb(response.body)`
-- 头处理：删 `host`（阿里云 404）、`content-length`（长度变化），保留 `anthropic-version` / `x-api-key` / `accept: text/event-stream`
-- SSE 记录：`nodeStream.on('end')` 落盘完整 events 数组
-
 ## 环境变量
 
 | 变量 | 说明 |

package/dist/cli/commands/doc.d.ts

@@ -0,0 +1,4 @@
+export interface DocOptions {
+    build?: boolean;
+}
+export declare function docCommand(options: DocOptions): Promise<void>;

package/dist/cli/commands/doc.js

@@ -0,0 +1,31 @@
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { loadConfig } from '../../config/index.js';
+import { getProcessStatus } from '../../utils/pm2.js';
+import { getCallerDirname } from '../../utils/esm-dirname.js';
+const commandsDirname = getCallerDirname('../cli/commands');
+export async function docCommand(options) {
+    const status = await getProcessStatus('cc-monitoring');
+    if (!status || status.status !== 'online') {
+        console.error('Server not running. Use "ccm start" first.');
+        return;
+    }
+    // 发布产物：dist/docs；本地开发：monorepo 的 proxy-docs/dist
+    const bundledDocs = path.join(commandsDirname, '../../docs');
+    const monorepoDocs = path.join(commandsDirname, '../../../../proxy-docs/dist');
+    const docsExists = fs.existsSync(bundledDocs) || fs.existsSync(monorepoDocs);
+    const needsBuild = options.build || !docsExists;
+    if (needsBuild) {
+        console.log('Building docs...');
+        execSync('pnpm --filter @cc-monitoring/docs build', {
+            stdio: 'inherit',
+            cwd: path.join(commandsDirname, '../../../..')
+        });
+    }
+    const config = await loadConfig();
+    const url = `http://${config.server.host}:${config.server.port}/docs/`;
+    console.log(`Opening docs: ${url}`);
+    const open = (await import('open')).default;
+    await open(url);
+}

package/dist/cli/index.js

@@ -111,6 +111,13 @@ program.command('ui')
     const { uiCommand } = await import('./commands/ui.js');
     await uiCommand(options);
 });
+program.command('doc')
+    .description('Open architecture docs')
+    .option('--build', 'Force rebuild docs')
+    .action(async (options) => {
+    const { docCommand } = await import('./commands/doc.js');
+    await docCommand(options);
+});
 program.command('clean-requests')
     .description('清理旧的请求日志（SQLite）')
     .option('--days <days>', '保留最近N天的数据', '7')

package/dist/config/index.js

@@ -51,7 +51,8 @@ export async function resetConfig(configPath = getConfigPath()) {
             type: 'sqlite',
             path: 'logs/proxy.db',
             maxDays: 7
-        }
+        },
+        mcpServers: []
     };
     await saveConfig(defaultConfig, configPath);
 }

package/dist/config/schema.d.ts

@@ -65,6 +65,34 @@ export declare const AppConfigSchema: z.ZodObject<{
     }, {
         token: string;
     }>>;
+    mcpServers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        transport_type: z.ZodEnum<["stdio", "sse", "streamable-http"]>;
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        url: z.ZodOptional<z.ZodString>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        transport_type: "stdio" | "sse" | "streamable-http";
+        enabled: boolean;
+        command?: string | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        headers?: Record<string, string> | undefined;
+    }, {
+        name: string;
+        transport_type: "stdio" | "sse" | "streamable-http";
+        command?: string | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        enabled?: boolean | undefined;
+    }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
     server: {
         port: number;
@@ -88,6 +116,16 @@ export declare const AppConfigSchema: z.ZodObject<{
         type: "sqlite";
         maxDays: number;
     };
+    mcpServers: {
+        name: string;
+        transport_type: "stdio" | "sse" | "streamable-http";
+        enabled: boolean;
+        command?: string | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        headers?: Record<string, string> | undefined;
+    }[];
     auth?: {
         token: string;
     } | undefined;
@@ -117,6 +155,16 @@ export declare const AppConfigSchema: z.ZodObject<{
     auth?: {
         token: string;
     } | undefined;
+    mcpServers?: {
+        name: string;
+        transport_type: "stdio" | "sse" | "streamable-http";
+        command?: string | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        enabled?: boolean | undefined;
+    }[] | undefined;
 }>;
 export type AppConfig = z.infer<typeof AppConfigSchema>;
 export declare function validateConfig(config: unknown): ValidationResult;

package/dist/config/schema.js

@@ -24,7 +24,17 @@ export const AppConfigSchema = z.object({
     }).optional().default({ type: 'sqlite', path: 'logs/proxy.db', maxDays: 7 }),
     auth: z.object({
         token: z.string().min(1)
-    }).optional()
+    }).optional(),
+    mcpServers: z.array(z.object({
+        name: z.string().min(1),
+        transport_type: z.enum(['stdio', 'sse', 'streamable-http']),
+        command: z.string().optional(),
+        args: z.array(z.string()).optional(),
+        env: z.record(z.string()).optional(),
+        url: z.string().optional(),
+        headers: z.record(z.string()).optional(),
+        enabled: z.boolean().default(true)
+    })).optional().default([])
 });
 export function validateConfig(config) {
     const result = AppConfigSchema.safeParse(config);

package/dist/parsers/docx-loader.d.ts

@@ -0,0 +1,5 @@
+import type { ParserLoader } from './types.js';
+export declare class DocxLoader implements ParserLoader {
+    supportedExtensions: string[];
+    parse(buffer: Buffer, _filename: string): Promise<string>;
+}

package/dist/parsers/docx-loader.js

@@ -0,0 +1,15 @@
+export class DocxLoader {
+    constructor() {
+        Object.defineProperty(this, "supportedExtensions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ['.docx']
+        });
+    }
+    async parse(buffer, _filename) {
+        const mammoth = await import('mammoth');
+        const result = await mammoth.extractRawText({ buffer });
+        return result.value;
+    }
+}

package/dist/parsers/index.d.ts

@@ -0,0 +1,3 @@
+import { ParserRegistry } from './registry.js';
+declare const registry: ParserRegistry;
+export { registry };

package/dist/parsers/index.js

@@ -0,0 +1,10 @@
+// apps/proxy-core/src/parsers/index.ts
+import { ParserRegistry } from './registry.js';
+import { MdLoader } from './md-loader.js';
+import { DocxLoader } from './docx-loader.js';
+import { XlsxLoader } from './xlsx-loader.js';
+const registry = new ParserRegistry();
+registry.register(new MdLoader());
+registry.register(new DocxLoader());
+registry.register(new XlsxLoader());
+export { registry };

package/dist/parsers/md-loader.d.ts

@@ -0,0 +1,5 @@
+import type { ParserLoader } from './types.js';
+export declare class MdLoader implements ParserLoader {
+    supportedExtensions: string[];
+    parse(buffer: Buffer, _filename: string): Promise<string>;
+}

package/dist/parsers/md-loader.js

@@ -0,0 +1,13 @@
+export class MdLoader {
+    constructor() {
+        Object.defineProperty(this, "supportedExtensions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ['.md', '.markdown']
+        });
+    }
+    async parse(buffer, _filename) {
+        return buffer.toString('utf-8');
+    }
+}

package/dist/parsers/registry.d.ts

@@ -0,0 +1,8 @@
+import type { ParserLoader } from './types.js';
+export declare class ParserRegistry {
+    private loaders;
+    register(loader: ParserLoader): void;
+    getSupportedExtensions(): string[];
+    parse(buffer: Buffer, filename: string): Promise<string>;
+    private getExtension;
+}

package/dist/parsers/registry.js

@@ -0,0 +1,32 @@
+export class ParserRegistry {
+    constructor() {
+        Object.defineProperty(this, "loaders", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    register(loader) {
+        for (const ext of loader.supportedExtensions) {
+            this.loaders.set(ext.toLowerCase(), loader);
+        }
+    }
+    getSupportedExtensions() {
+        return Array.from(this.loaders.keys());
+    }
+    async parse(buffer, filename) {
+        const ext = this.getExtension(filename);
+        const loader = this.loaders.get(ext);
+        if (!loader) {
+            throw new Error(`Unsupported file type: "${ext}". Supported types: ${this.getSupportedExtensions().join(', ')}`);
+        }
+        return loader.parse(buffer, filename);
+    }
+    getExtension(filename) {
+        const dotIndex = filename.lastIndexOf('.');
+        if (dotIndex === -1)
+            throw new Error(`File has no extension: "${filename}"`);
+        return filename.slice(dotIndex).toLowerCase();
+    }
+}

package/dist/parsers/types.d.ts

@@ -0,0 +1,4 @@
+export interface ParserLoader {
+    supportedExtensions: string[];
+    parse(buffer: Buffer, filename: string): Promise<string>;
+}

package/dist/parsers/types.js

@@ -0,0 +1 @@
+export {};

package/dist/parsers/xlsx-loader.d.ts

@@ -0,0 +1,5 @@
+import type { ParserLoader } from './types.js';
+export declare class XlsxLoader implements ParserLoader {
+    supportedExtensions: string[];
+    parse(buffer: Buffer, _filename: string): Promise<string>;
+}

package/dist/parsers/xlsx-loader.js

@@ -0,0 +1,34 @@
+export class XlsxLoader {
+    constructor() {
+        Object.defineProperty(this, "supportedExtensions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ['.xlsx', '.xls']
+        });
+    }
+    async parse(buffer, _filename) {
+        const XLSX = await import('xlsx');
+        const workbook = XLSX.read(buffer, { type: 'buffer' });
+        const parts = [];
+        for (const sheetName of workbook.SheetNames) {
+            const sheet = workbook.Sheets[sheetName];
+            const csv = XLSX.utils.sheet_to_csv(sheet);
+            // 转 CSV 为 markdown table
+            const mdTable = csvToMarkdownTable(csv);
+            parts.push(`## ${sheetName}\n\n${mdTable}`);
+        }
+        return parts.join('\n\n');
+    }
+}
+function csvToMarkdownTable(csv) {
+    const lines = csv.split('\n').filter(line => line.length > 0);
+    if (lines.length === 0)
+        return '';
+    const rows = lines.map(line => line.split(','));
+    // Header row
+    const header = `| ${rows[0].join(' | ')} |`;
+    const separator = `| ${rows[0].map(() => '---').join(' | ')} |`;
+    const body = rows.slice(1).map(row => `| ${row.join(' | ')} |`).join('\n');
+    return [header, separator, body].join('\n');
+}

package/dist/server/__tests__/providers-route.test.js

@@ -39,15 +39,16 @@ jest.mock('@utils/db', () => {
     CREATE TABLE IF NOT EXISTS providers (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       name TEXT UNIQUE NOT NULL,
-      base_url TEXT NOT NULL,
-      api_key TEXT NOT NULL,
-      model TEXT NOT NULL,
+      base_url TEXT,
+      api_key TEXT,
+      model TEXT,
       haiku_model TEXT,
       sonnet_model TEXT,
       opus_model TEXT,
       subagent_model TEXT,
       provider TEXT NOT NULL,
       is_default INTEGER NOT NULL DEFAULT 0,
+      is_openai_compatible INTEGER NOT NULL DEFAULT 0,
       created_at TEXT DEFAULT CURRENT_TIMESTAMP,
       updated_at TEXT DEFAULT CURRENT_TIMESTAMP
     )

package/dist/server/__tests__/proxy.test.js

@@ -66,7 +66,7 @@ describe('resolveProxyTarget', () => {
     beforeEach(() => {
         jest.clearAllMocks();
         db = new Database(':memory:');
-        db.exec(`CREATE TABLE providers (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT UNIQUE NOT NULL, base_url TEXT, api_key TEXT, model TEXT, haiku_model TEXT, sonnet_model TEXT, opus_model TEXT, subagent_model TEXT, provider TEXT NOT NULL, is_default INTEGER NOT NULL DEFAULT 0, created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`);
+        db.exec(`CREATE TABLE providers (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT UNIQUE NOT NULL, base_url TEXT, api_key TEXT, model TEXT, haiku_model TEXT, sonnet_model TEXT, opus_model TEXT, subagent_model TEXT, provider TEXT NOT NULL, is_default INTEGER NOT NULL DEFAULT 0, is_openai_compatible INTEGER NOT NULL DEFAULT 0, created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`);
         getDatabase.mockReturnValue(db);
     });
     afterEach(() => {
@@ -92,4 +92,14 @@ describe('resolveProxyTarget', () => {
         expect(result.targetPath).toBe('/apps/anthropic');
         expect(result.apiKey).toBe('config-key');
     });
+    test('returns is_openai_compatible from active provider', () => {
+        db.prepare('INSERT INTO providers (name, base_url, api_key, model, provider, is_default, is_openai_compatible) VALUES (?, ?, ?, ?, ?, ?, ?)').run('openai-provider', 'https://api.openai.com/v1', 'openai-key', 'gpt-4', 'openai', 1, 1);
+        const result = resolveProxyTarget(config);
+        expect(result.is_openai_compatible).toBe(true);
+    });
+    test('returns is_openai_compatible as false when not set', () => {
+        db.prepare('INSERT INTO providers (name, base_url, api_key, model, provider, is_default, is_openai_compatible) VALUES (?, ?, ?, ?, ?, ?, ?)').run('claude-provider', 'https://provider.example.com/v1', 'provider-key', 'test-model', 'anthropic', 1, 0);
+        const result = resolveProxyTarget(config);
+        expect(result.is_openai_compatible).toBe(false);
+    });
 });

package/dist/server/chat-route.d.ts

@@ -0,0 +1,3 @@
+import { FastifyInstance } from 'fastify';
+import { ProxyConfig } from '../types/config.js';
+export declare function setupChatRoute(fastify: FastifyInstance, proxyConfig: ProxyConfig): Promise<void>;