@cc-monitoring/proxy-core 0.1.5-alpha.1 → 0.1.5

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/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/claude-settings-route.d.ts

@@ -0,0 +1,2 @@
+import { FastifyInstance } from 'fastify';
+export declare function setupClaudeSettingsRoutes(fastify: FastifyInstance, config: any): Promise<void>;

package/dist/server/claude-settings-route.js

@@ -0,0 +1,76 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { isClaudeInstalled } from '../utils/version.js';
+function getClaudeSettingsPath() {
+    return path.join(os.homedir(), '.claude', 'settings.json');
+}
+function buildServerAddress(config) {
+    const host = config.server.host === '0.0.0.0' ? 'localhost' : config.server.host;
+    return `http://${host}:${config.server.port}`;
+}
+export async function setupClaudeSettingsRoutes(fastify, config) {
+    fastify.post('/ui/api/claude-settings/sync', async (request, reply) => {
+        // 1. 检测 Claude Code 是否安装
+        if (!isClaudeInstalled()) {
+            return reply.send({
+                success: false,
+                message: '未检测到 Claude Code，请安装完以后重试'
+            });
+        }
+        // 2. 检测 settings.json 是否存在
+        const settingsPath = getClaudeSettingsPath();
+        if (!fs.existsSync(settingsPath)) {
+            return reply.send({
+                success: false,
+                message: '未检测到配置文件，请手动修改'
+            });
+        }
+        // 3. 读取 settings.json
+        let settings;
+        try {
+            const raw = fs.readFileSync(settingsPath, 'utf-8');
+            settings = JSON.parse(raw);
+        }
+        catch {
+            return reply.code(500).send({
+                success: false,
+                message: '配置文件格式错误，请手动检查'
+            });
+        }
+        // 4. 构建当前 ccm 服务地址
+        const serverAddress = buildServerAddress(config);
+        const currentBaseUrl = settings?.env?.ANTHROPIC_BASE_URL;
+        // 5. 比较
+        if (currentBaseUrl === serverAddress) {
+            return reply.send({
+                success: true,
+                message: '已使用 CCM 的配置，无需改动',
+                alreadyMatched: true
+            });
+        }
+        // 6. 备份旧值 + 设置新值
+        if (!settings.env) {
+            settings.env = {};
+        }
+        if (currentBaseUrl) {
+            settings.env.ANTHROPIC_BASE_URL_CCM_BACKUP = currentBaseUrl;
+        }
+        settings.env.ANTHROPIC_BASE_URL = serverAddress;
+        // 7. 写回 settings.json
+        try {
+            fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+        }
+        catch (err) {
+            return reply.code(500).send({
+                success: false,
+                message: `写入配置文件失败: ${err.message}`
+            });
+        }
+        return reply.send({
+            success: true,
+            message: '修改成功，请重启 Claude 终端生效',
+            alreadyMatched: false
+        });
+    });
+}

package/dist/server/data-push.d.ts

@@ -1,5 +1,7 @@
 import { WebSocket } from 'ws';
 export declare function addDataClient(ws: WebSocket): void;
 export declare function removeDataClient(ws: WebSocket): void;
+export declare function getDataClientCount(): number;
 export declare function pushNewRequest(summary: any, status?: 'pending' | 'completed'): void;
 export declare function pushStatsNotify(): void;
+export declare function broadcastToDataClients(msg: any): void;

package/dist/server/data-push.js

@@ -7,6 +7,9 @@ export function addDataClient(ws) {
 export function removeDataClient(ws) {
     dataClients.delete(ws);
 }
+export function getDataClientCount() {
+    return dataClients.size;
+}
 // Broadcast helpers
 export function pushNewRequest(summary, status = 'completed') {
     broadcast({
@@ -30,3 +33,7 @@ function broadcast(msg) {
         }
     }
 }
+// Expose broadcast for global status timer (ui-route.ts)
+export function broadcastToDataClients(msg) {
+    broadcast(msg);
+}

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

@@ -0,0 +1,2 @@
+import { FastifyInstance } from 'fastify';
+export declare function setupDocsRoutes(fastify: FastifyInstance): Promise<void>;

package/dist/server/docs-route.js

@@ -0,0 +1,63 @@
+import multipart from '@fastify/multipart';
+import fs from 'fs';
+import path from 'path';
+import { registry } from '../parsers/index.js';
+import { dataDir } from '../utils/paths.js';
+const docsDir = path.join(dataDir, 'docs');
+export async function setupDocsRoutes(fastify) {
+    await fastify.register(multipart, { limits: { fileSize: 10 * 1024 * 1024 } });
+    fastify.post('/ui/api/docs/upload', async (request, reply) => {
+        const data = await request.file();
+        if (!data) {
+            return reply.code(400).send({ success: false, error: 'No file uploaded' });
+        }
+        const filename = path.basename(data.filename);
+        const buffer = await data.toBuffer();
+        // 校验扩展名
+        const supported = registry.getSupportedExtensions();
+        const dotIndex = filename.lastIndexOf('.');
+        if (dotIndex === -1) {
+            return reply.code(400).send({
+                success: false,
+                error: `File has no extension. Supported types: ${supported.join(', ')}`
+            });
+        }
+        const ext = filename.slice(dotIndex).toLowerCase();
+        if (!supported.includes(ext)) {
+            return reply.code(400).send({
+                success: false,
+                error: `Unsupported file type: "${ext}". Supported types: ${supported.join(', ')}`
+            });
+        }
+        // 解析文件内容为 md
+        let mdContent;
+        try {
+            mdContent = await registry.parse(buffer, filename);
+        }
+        catch (err) {
+            request.log.error({ err, filename }, 'File parsing failed');
+            return reply.code(500).send({
+                success: false,
+                error: err.message || 'File parsing failed'
+            });
+        }
+        // 确保 docs 目录存在
+        if (!fs.existsSync(docsDir)) {
+            fs.mkdirSync(docsDir, { recursive: true });
+        }
+        // 写入 md 文件
+        const mdFilename = filename.slice(0, dotIndex) + '.md';
+        const mdPath = path.join(docsDir, mdFilename);
+        try {
+            fs.writeFileSync(mdPath, mdContent, 'utf-8');
+        }
+        catch (err) {
+            request.log.error({ err, mdPath }, 'Failed to write md file');
+            return reply.code(500).send({
+                success: false,
+                error: 'Failed to save file'
+            });
+        }
+        return { success: true, path: `docs/${mdFilename}` };
+    });
+}

package/dist/server/index.js

@@ -6,6 +6,7 @@ import { getCurrentModuleUrl } from '../utils/esm-dirname.js';
 import { setupProxy } from './proxy.js';
 import { setupUiRoutes } from './ui-route.js';
 import { setupChatRoute } from './chat-route.js';
+import { setupDocsRoutes } from './docs-route.js';
 import { requestIdMiddleware } from './middleware/request-id.js';
 export async function createServer() {
     const config = await loadConfig();
@@ -21,6 +22,7 @@ export async function createServer() {
     await setupUiRoutes(fastify); // UI routes registered BEFORE proxy to avoid being proxied
     await setupProxy(fastify, config.proxy);
     await setupChatRoute(fastify, config.proxy); // MCP-enhanced chat endpoint
+    await setupDocsRoutes(fastify);
     return fastify;
 }
 export async function startServer() {

package/dist/server/proxy.d.ts

@@ -11,6 +11,7 @@ interface ResolvedTarget {
     haiku_model?: string;
     sonnet_model?: string;
     opus_model?: string;
+    is_openai_compatible?: boolean;
 }
 /**
  * Resolves the proxy target per request:
@@ -18,7 +19,7 @@ interface ResolvedTarget {
  * - Otherwise fall back to config.json proxy.target + proxy.apiKey
  *
  * Called per request for hot-swap support (no server restart needed on activation change).
- * better-sqlite3 is synchronous and ~us-level for a single-row SELECT; no caching needed.
+ * better-sqlite3 is synchronous and ~us-level for a single-row SELECT; cached statement avoids repeated allocation.
  */
 export declare function resolveProxyTarget(proxyConfig: ProxyConfig): ResolvedTarget;
 /**