bhg-helper 1.0.0

package/api/routes/backups.ts

@@ -0,0 +1,73 @@
+/**
+ * GET    /api/backups            列出所有快照
+ * POST   /api/backups            手动创建备份 { scope }
+ * POST   /api/backups/restore    恢复 { filename }
+ * DELETE /api/backups/:filename  删除
+ */
+import { Router, type Request, type Response } from 'express'
+import {
+  createManualBackup,
+  deleteBackup,
+  listBackups,
+  restoreBackup,
+  type Scope,
+} from '../lib/repository.js'
+import { log } from '../lib/logger.js'
+
+const router = Router()
+
+router.get('/', async (_req: Request, res: Response) => {
+  try {
+    const list = await listBackups()
+    res.json({ ok: true, data: list })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+router.post('/', async (req: Request, res: Response) => {
+  const scope = req.body?.scope as Scope | undefined
+  if (!scope || !['bridge', 'credentials', 'settings'].includes(scope)) {
+    res.status(400).json({ ok: false, error: 'scope must be bridge | credentials | settings' })
+    return
+  }
+  try {
+    const result = await createManualBackup(scope)
+    res.json({ ok: true, data: result })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'backups', msg)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+router.post('/restore', async (req: Request, res: Response) => {
+  const filename = req.body?.filename
+  if (typeof filename !== 'string' || !filename) {
+    res.status(400).json({ ok: false, error: 'filename required' })
+    return
+  }
+  try {
+    const result = await restoreBackup(filename)
+    res.json({ ok: true, data: result })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'backups', msg)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+router.delete('/:filename', async (req: Request, res: Response) => {
+  const filename = req.params.filename
+  try {
+    await deleteBackup(filename)
+    res.json({ ok: true })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'backups', msg)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+export default router

package/api/routes/config.ts

@@ -0,0 +1,197 @@
+/**
+ * GET /api/config — 读取 bridge / credentials / settings 三个文件
+ * PUT /api/bridge — 写回 bridge（model catalog、defaults、oauth）
+ * PUT /api/credentials — 写回 credentials
+ * PUT /api/settings — 写回 settings
+ * POST /api/config/reset-catalog — 重置模型目录为 DeepSeek 官方
+ */
+import { Router, type Request, type Response } from 'express'
+import {
+  BRIDGE_FILE,
+  CREDENTIALS_FILE,
+  BHG_HELPER_DIR,
+  SETTINGS_FILE,
+} from '../lib/paths.js'
+import { listBackups, readJson, writeJson } from '../lib/repository.js'
+import { log } from '../lib/logger.js'
+import type { BridgeConfig, ModelEntry } from '../lib/types.js'
+
+const router = Router()
+
+router.get('/', async (_req: Request, res: Response) => {
+  const [bridge, credentials, settings] = await Promise.all([
+    readJson(BRIDGE_FILE),
+    readJson(CREDENTIALS_FILE),
+    readJson(SETTINGS_FILE),
+  ])
+  const backups = await listBackups().catch(() => [])
+  res.json({
+    ok: true,
+    data: {
+      bhgHelperDir: BHG_HELPER_DIR,
+      files: {
+        bridge: BRIDGE_FILE,
+        credentials: CREDENTIALS_FILE,
+        settings: SETTINGS_FILE,
+      },
+      bridge,
+      credentials,
+      settings,
+      backups,
+    },
+  })
+})
+
+router.put('/bridge', async (req: Request, res: Response) => {
+  const body = req.body
+  if (!body || typeof body !== 'object') {
+    res.status(400).json({ ok: false, error: 'body must be an object' })
+    return
+  }
+  try {
+    const result = await writeJson('bridge', body)
+    log('OK', 'config', 'bridge config updated via UI')
+    res.json({ ok: true, data: result })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'config', `bridge write failed: ${msg}`)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+router.put('/credentials', async (req: Request, res: Response) => {
+  const body = req.body
+  if (!body || typeof body !== 'object') {
+    res.status(400).json({ ok: false, error: 'body must be an object' })
+    return
+  }
+  try {
+    const result = await writeJson('credentials', body)
+    log('OK', 'config', 'credentials updated via UI')
+    res.json({ ok: true, data: result })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'config', `credentials write failed: ${msg}`)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+router.put('/settings', async (req: Request, res: Response) => {
+  const body = req.body
+  if (!body || typeof body !== 'object') {
+    res.status(400).json({ ok: false, error: 'body must be an object' })
+    return
+  }
+  try {
+    const result = await writeJson('settings', body)
+    log('OK', 'config', 'settings updated via UI')
+    res.json({ ok: true, data: result })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'config', `settings write failed: ${msg}`)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+/**
+ * POST /api/config/reset-catalog
+ * 用 DeepSeek 官方模型目录替换 bridge 的 bridgeModelCatalogCache.models
+ * 保留 oauthAccount 等其他字段
+ * 如果当前激活模型已不存在，自动切到新的 middle default (deepseek-chat)
+ */
+router.post('/reset-catalog', async (_req: Request, res: Response) => {
+  try {
+    const cur = (await readJson(BRIDGE_FILE)) as BridgeConfig | null
+    if (!cur) {
+      res.status(404).json({ ok: false, error: 'bridge config not found' })
+      return
+    }
+
+    const dsModels: ModelEntry[] = [
+      mkModel('deepseek-chat', 'DeepSeek V3', 'middle', 'DeepSeek V3 · 通用对话与代码，128K 上下文', 128000, 32000, 64000, 2, 8),
+      mkModel('deepseek-reasoner', 'DeepSeek R1', 'large', 'DeepSeek R1 · 强推理，64K 上下文', 64000, 16000, 32000, 4, 16),
+      mkModel('deepseek-v4-flash', 'DeepSeek V4 Flash', 'small', 'DeepSeek V4 Flash · 高速低成本版本', 128000, 32000, 64000, 0.5, 2),
+    ]
+
+    const newDefaults = { large: 'deepseek-reasoner', middle: 'deepseek-chat', small: 'deepseek-v4-flash' }
+    const validIds = new Set(dsModels.map((m) => m.id))
+
+    const next: BridgeConfig = {
+      ...cur,
+      bridgeModelCatalogCache: {
+        ...(cur.bridgeModelCatalogCache ?? { models: [], defaults: { large: '', middle: '', small: '' } }),
+        models: dsModels,
+        defaults: newDefaults,
+      },
+      additionalModelOptionsCache: dsModels.map((m) => ({
+        value: m.id,
+        label: m.label,
+        description: m.description,
+        descriptionForModel: m.description,
+      })),
+    }
+
+    const result = await writeJson('bridge', next)
+    log('OK', 'config', 'model catalog reset to DeepSeek official')
+
+    // 检查 settings.json 的激活模型是否仍然有效，无效则改写
+    let switchedFrom: string | null = null
+    try {
+      const settings = (await readJson(SETTINGS_FILE)) as { model?: string } | null
+      if (settings && typeof settings.model === 'string' && !validIds.has(settings.model)) {
+        switchedFrom = settings.model
+        const newSettings = { ...settings, model: newDefaults.middle }
+        await writeJson('settings', newSettings)
+        log('OK', 'config', `active model switched ${settings.model} → ${newDefaults.middle}`)
+      }
+    } catch {
+      // settings 不存在或读不动就不管
+    }
+
+    res.json({
+      ok: true,
+      data: { ...result, modelCount: dsModels.length, switchedActiveFrom: switchedFrom },
+    })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'config', `reset-catalog failed: ${msg}`)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+function mkModel(
+  id: string,
+  label: string,
+  tier: 'large' | 'middle' | 'small',
+  description: string,
+  context_window: number,
+  default_max_tokens: number,
+  max_tokens: number,
+  inputPer1M: number,
+  outputPer1M: number
+): ModelEntry {
+  return {
+    id,
+    label,
+    tier,
+    provider: 'DeepSeek',
+    context_window,
+    default_max_tokens,
+    max_tokens,
+    pricing: {
+      currency: 'CNY',
+      quota_type: 'token',
+      pricing_group: 'deepseek-official',
+      input_per_1m_tokens: inputPer1M,
+      output_per_1m_tokens: outputPer1M,
+      cache_read_per_1m_tokens: 0,
+      cache_write_per_1m_tokens: 0,
+    },
+    description,
+    protocol: 'openai',
+    enabled: true,
+    available: true,
+  }
+}
+
+export default router

package/api/routes/install.ts

@@ -0,0 +1,158 @@
+/**
+ * 安装管理：在 UI 里跑 `npm install`，实时拉日志
+ */
+import { Router } from 'express'
+import { spawn, type ChildProcess } from 'node:child_process'
+import { existsSync, statSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { log } from '../lib/logger.js'
+
+const router = Router()
+
+// Cockpit 后端跑在 api/dist/ 或 api/ 下，项目根是上一级
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const PROJECT_ROOT = resolve(__dirname, '..', '..')
+const NODE_MODULES = resolve(PROJECT_ROOT, 'node_modules')
+const PACKAGE_JSON = resolve(PROJECT_ROOT, 'package.json')
+
+// 单实例：同一时间只允许一个 npm install
+let running: ChildProcess | null = null
+let logBuffer: { ts: number; line: string }[] = []
+let sseClients: Set<import('express').Response> = new Set()
+
+function pushLog(line: string) {
+  if (!line) return
+  const entry = { ts: Date.now(), line: line.replace(/\r$/, '') }
+  logBuffer.push(entry)
+  if (logBuffer.length > 2000) logBuffer.splice(0, logBuffer.length - 2000)
+  for (const res of sseClients) {
+    try {
+      res.write(`data: ${JSON.stringify(entry)}\n\n`)
+    } catch { /* dead client */ }
+  }
+}
+
+async function checkNode() {
+  return new Promise<{ ok: boolean; version?: string; error?: string }>((resolveP) => {
+    const p = spawn(process.platform === 'win32' ? 'node.exe' : 'node', ['-v'], { shell: false })
+    let out = ''
+    p.stdout.on('data', (c) => out += c.toString())
+    p.on('error', (e) => resolveP({ ok: false, error: e.message }))
+    p.on('close', (code) => {
+      if (code === 0) resolveP({ ok: true, version: out.trim() })
+      else resolveP({ ok: false, error: `node exited with code ${code}` })
+    })
+  })
+}
+
+async function checkNpm() {
+  return new Promise<{ ok: boolean; version?: string; error?: string }>((resolveP) => {
+    const p = spawn(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['-v'], { shell: true })
+    let out = ''
+    p.stdout.on('data', (c) => out += c.toString())
+    p.on('error', (e) => resolveP({ ok: false, error: e.message }))
+    p.on('close', (code) => {
+      if (code === 0) resolveP({ ok: true, version: out.trim() })
+      else resolveP({ ok: false, error: `npm exited with code ${code}` })
+    })
+  })
+}
+
+router.get('/status', async (_req, res) => {
+  const hasNodeModules = existsSync(NODE_MODULES)
+  const hasPackageJson = existsSync(PACKAGE_JSON)
+  // 检查 node_modules 是否真的完整安装（有 react 包确认不是空壳）
+  const hasReact = hasNodeModules && existsSync(resolve(NODE_MODULES, 'react'))
+  const nodeModMtime = hasNodeModules ? statSync(NODE_MODULES).mtimeMs : 0
+  const pkgMtime = hasPackageJson ? statSync(PACKAGE_JSON).mtimeMs : 0
+  // 需要安装的条件：node_modules 不存在、关键包缺失、或 package.json 更新时间晚于 node_modules
+  const needsInstall = !hasNodeModules || !hasReact || (pkgMtime > nodeModMtime)
+
+  const node = await checkNode()
+  const npm = await checkNpm()
+
+  res.json({
+    ok: true,
+    data: {
+      projectRoot: PROJECT_ROOT,
+      hasNodeModules,
+      hasPackageJson,
+      needsInstall,
+      isRunning: !!running,
+      logCount: logBuffer.length,
+      node: { ok: node.ok, version: node.version, error: node.error },
+      npm: { ok: npm.ok, version: npm.version, error: npm.error },
+    },
+  })
+})
+
+router.get('/logs', (req, res) => {
+  res.setHeader('Content-Type', 'text/event-stream')
+  res.setHeader('Cache-Control', 'no-cache')
+  res.setHeader('Connection', 'keep-alive')
+  res.setHeader('X-Accel-Buffering', 'no')
+  res.flushHeaders?.()
+
+  // 重放历史日志
+  for (const e of logBuffer) {
+    res.write(`data: ${JSON.stringify(e)}\n\n`)
+  }
+
+  sseClients.add(res)
+  const heartbeat = setInterval(() => {
+    try { res.write(':heartbeat\n\n') } catch { /* ignore */ }
+  }, 15000)
+
+  req.on('close', () => {
+    clearInterval(heartbeat)
+    sseClients.delete(res)
+  })
+})
+
+router.post('/run', (_req, res) => {
+  if (running) {
+    res.status(409).json({ ok: false, error: 'install already running' })
+    return
+  }
+
+  pushLog(`[bridge] spawning npm install in ${PROJECT_ROOT}`)
+  const cmd = process.platform === 'win32' ? 'npm.cmd' : 'npm'
+  const child = spawn(cmd, ['install', '--no-audit', '--no-fund', '--loglevel=error'], {
+    cwd: PROJECT_ROOT,
+    shell: true,
+    env: { ...process.env, FORCE_COLOR: '0', NPM_CONFIG_COLOR: 'false' },
+  })
+  running = child
+
+  child.stdout.on('data', (b) => {
+    for (const line of b.toString().split(/\r?\n/)) pushLog(line)
+  })
+  child.stderr.on('data', (b) => {
+    for (const line of b.toString().split(/\r?\n/)) pushLog('[stderr] ' + line)
+  })
+  child.on('error', (e) => {
+    pushLog('[error] ' + e.message)
+    log('ERR', 'install', e.message)
+  })
+  child.on('close', (code) => {
+    pushLog(code === 0 ? '[bridge] npm install completed ✓' : `[bridge] npm install failed (exit ${code})`)
+    log(code === 0 ? 'OK' : 'ERR', 'install', `npm install exited ${code}`)
+    running = null
+  })
+
+  res.json({ ok: true, data: { started: true, pid: child.pid } })
+})
+
+router.post('/cancel', (_req, res) => {
+  if (!running) {
+    res.status(400).json({ ok: false, error: 'no install running' })
+    return
+  }
+  running.kill('SIGTERM')
+  pushLog('[bridge] cancel requested')
+  res.json({ ok: true, data: { killed: true } })
+})
+
+export default router

package/api/routes/logs.ts

@@ -0,0 +1,20 @@
+/**
+ * GET /api/logs        最近 200 条
+ * GET /api/logs/stream SSE 实时推送
+ */
+import { Router, type Request, type Response } from 'express'
+import { addSseClient, listLogs } from '../lib/logger.js'
+
+const router = Router()
+
+router.get('/', (_req: Request, res: Response) => {
+  res.json({ ok: true, data: listLogs() })
+})
+
+router.get('/stream', (req: Request, res: Response) => {
+  addSseClient(res)
+  // 不结束响应；客户端断开会触发 close 事件
+  void req
+})
+
+export default router

package/api/routes/providers.ts

@@ -0,0 +1,13 @@
+/**
+ * GET /api/providers/presets — 列出预置的 Provider 配置
+ */
+import { Router, type Request, type Response } from 'express'
+import { PROVIDER_PRESETS } from '../lib/providers.js'
+
+const router = Router()
+
+router.get('/presets', (_req: Request, res: Response) => {
+  res.json({ ok: true, data: PROVIDER_PRESETS })
+})
+
+export default router

package/api/routes/relay.ts

@@ -0,0 +1,106 @@
+/**
+ * GET    /api/relay/status         中转服务运行状态
+ * POST   /api/relay/start          启动
+ * POST   /api/relay/stop           停止
+ * POST   /api/relay/restart        重启
+ * GET    /api/relay/config         读配置（Key 脱敏）
+ * PUT    /api/relay/config         写配置
+ */
+import { Router, type Request, type Response } from 'express'
+import { isRelayRunning, getRelayInfo, startRelay, stopRelay, restartRelay } from '../relay/server.js'
+import { getRelayConfigPath, loadRelayConfig, saveRelayConfig } from '../relay/config.js'
+import { log } from '../lib/logger.js'
+
+const router = Router()
+
+router.get('/status', async (_req: Request, res: Response) => {
+  const cfg = await loadRelayConfig()
+  res.json({
+    ok: true,
+    data: {
+      running: isRelayRunning(),
+      info: getRelayInfo(),
+      config: {
+        port: cfg.port,
+        deepseekBaseUrl: cfg.deepseekBaseUrl,
+        spoofProvider: cfg.spoofProvider,
+        verbose: cfg.verbose,
+        deepseekApiKey: cfg.deepseekApiKey ? maskKey(cfg.deepseekApiKey) : '',
+        modelMap: cfg.modelMap,
+        configPath: getRelayConfigPath(),
+        apiKeyConfigured: !!cfg.deepseekApiKey,
+      },
+    },
+  })
+})
+
+router.get('/config', async (_req: Request, res: Response) => {
+  const cfg = await loadRelayConfig()
+  res.json({
+    ok: true,
+    data: {
+      port: cfg.port,
+      deepseekBaseUrl: cfg.deepseekBaseUrl,
+      spoofProvider: cfg.spoofProvider,
+      verbose: cfg.verbose,
+      deepseekApiKey: cfg.deepseekApiKey ? maskKey(cfg.deepseekApiKey) : '',
+      modelMap: cfg.modelMap,
+    },
+  })
+})
+
+router.put('/config', async (req: Request, res: Response) => {
+  const body = req.body
+  if (!body || typeof body !== 'object') {
+    res.status(400).json({ ok: false, error: 'body must be object' })
+    return
+  }
+  // 接受部分字段
+  const update: Record<string, unknown> = {}
+  if (typeof body.port === 'number' && body.port > 0 && body.port < 65535) update.port = body.port
+  if (typeof body.deepseekBaseUrl === 'string') update.deepseekBaseUrl = body.deepseekBaseUrl.trim()
+  if (typeof body.deepseekApiKey === 'string') update.deepseekApiKey = body.deepseekApiKey.trim()
+  if (typeof body.spoofProvider === 'string') update.spoofProvider = body.spoofProvider.trim()
+  if (typeof body.verbose === 'boolean') update.verbose = body.verbose
+  if (body.modelMap && typeof body.modelMap === 'object') update.modelMap = body.modelMap
+
+  const next = await saveRelayConfig(update as never)
+  // 端口或 baseUrl 变了 → 自动重启
+  if (isRelayRunning() && (update.port || update.deepseekBaseUrl)) {
+    await restartRelay()
+  }
+  res.json({ ok: true, data: { port: next.port, deepseekBaseUrl: next.deepseekBaseUrl } })
+})
+
+router.post('/start', async (_req: Request, res: Response) => {
+  try {
+    await startRelay()
+    res.json({ ok: true })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    log('ERR', 'relay', `start failed: ${msg}`)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+router.post('/stop', async (_req: Request, res: Response) => {
+  await stopRelay()
+  res.json({ ok: true })
+})
+
+router.post('/restart', async (_req: Request, res: Response) => {
+  try {
+    await restartRelay()
+    res.json({ ok: true })
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    res.status(500).json({ ok: false, error: msg })
+  }
+})
+
+function maskKey(k: string): string {
+  if (k.length <= 8) return '••••'
+  return k.slice(0, 4) + '••••' + k.slice(-4)
+}
+
+export default router

package/api/server.ts

@@ -0,0 +1,40 @@
+/**
+ * BHG-helper 后端入口
+ * - 3001 端口：API (BHG-helper UI 用)
+ * - 8787 端口：中转服务 (Claude Code 用)
+ */
+import app from './app.js'
+import { loadRelayConfig } from './relay/config.js'
+import { startRelay, stopRelay } from './relay/server.js'
+import { log } from './lib/logger.js'
+
+const PORT = Number(process.env.PORT || 3001)
+
+const server = app.listen(PORT, () => {
+  log('OK', 'http', `BHG-helper api listening on http://127.0.0.1:${PORT}`)
+})
+
+// 启动时如果 BHG-helper relay 配置里有 Key，就自动跑中转
+loadRelayConfig().then((cfg) => {
+  if (cfg.deepseekApiKey) {
+    startRelay().catch((err) => {
+      log('ERR', 'relay', `auto-start failed: ${err instanceof Error ? err.message : String(err)}`)
+    })
+  } else {
+    log('INFO', 'relay', 'no deepseek key configured, relay not auto-started')
+  }
+})
+
+process.on('SIGTERM', () => {
+  log('INFO', 'http', 'SIGTERM received, shutting down')
+  stopRelay().catch(() => {})
+  server.close(() => process.exit(0))
+})
+
+process.on('SIGINT', () => {
+  log('INFO', 'http', 'SIGINT received, shutting down')
+  stopRelay().catch(() => {})
+  server.close(() => process.exit(0))
+})
+
+export default app