bhg-helper 1.0.0

package/src/lib/api.ts

@@ -0,0 +1,120 @@
+// BHG-helper API client
+import type {
+  BackupInfo,
+  ConfigPayload,
+  Credentials,
+  BridgeConfig,
+  Settings,
+  ProviderPreset,
+  LogEntry,
+} from './types'
+
+const BASE = '/api'
+
+async function request<T>(path: string, init?: RequestInit): Promise<T> {
+  const res = await fetch(BASE + path, {
+    headers: { 'Content-Type': 'application/json' },
+    ...init,
+  })
+  const json = await res.json().catch(() => ({ ok: false, error: 'invalid JSON' }))
+  if (!res.ok || !json.ok) {
+    throw new Error(json.error || `HTTP ${res.status}`)
+  }
+  return json.data as T
+}
+
+export interface RelayStatus {
+  running: boolean
+  info: { port: number; running: boolean; baseUrl: string; modelMap: Record<string, string>; deepseekApiKey: string } | null
+  config: {
+    port: number
+    deepseekBaseUrl: string
+    spoofProvider: string
+    verbose: boolean
+    deepseekApiKey: string
+    modelMap: Record<string, string>
+    configPath?: string
+    apiKeyConfigured?: boolean
+  }
+}
+
+export const api = {
+  getConfig: () => request<ConfigPayload>('/config'),
+
+  saveBridge: (bridge: BridgeConfig) =>
+    request<{ ok: true; backup: string | null; size: number }>('/config/bridge', {
+      method: 'PUT',
+      body: JSON.stringify(bridge),
+    }),
+
+  saveCredentials: (credentials: Credentials) =>
+    request<{ ok: true; backup: string | null; size: number }>('/config/credentials', {
+      method: 'PUT',
+      body: JSON.stringify(credentials),
+    }),
+
+  saveSettings: (settings: Settings) =>
+    request<{ ok: true; backup: string | null; size: number }>('/config/settings', {
+      method: 'PUT',
+      body: JSON.stringify(settings),
+    }),
+
+  listBackups: () => request<BackupInfo[]>('/backups'),
+
+  createBackup: (scope: 'bridge' | 'credentials' | 'settings') =>
+    request<{ filename: string }>('/backups', {
+      method: 'POST',
+      body: JSON.stringify({ scope }),
+    }),
+
+  restoreBackup: (filename: string) =>
+    request<{ scope: string }>('/backups/restore', {
+      method: 'POST',
+      body: JSON.stringify({ filename }),
+    }),
+
+  deleteBackup: (filename: string) =>
+    request<{ ok: true }>(`/backups/${encodeURIComponent(filename)}`, {
+      method: 'DELETE',
+    }),
+
+  listProviderPresets: () => request<ProviderPreset[]>('/providers/presets'),
+
+  resetCatalog: () =>
+    request<{ ok: true; backup: string | null; size: number; modelCount: number; switchedActiveFrom: string | null }>(
+      '/config/reset-catalog',
+      { method: 'POST' }
+    ),
+
+  listLogs: () => request<LogEntry[]>('/logs'),
+
+  // Relay
+  getRelayStatus: () => request<RelayStatus>('/relay/status'),
+  startRelay: () => request<{ ok: true }>('/relay/start', { method: 'POST' }),
+  stopRelay: () => request<{ ok: true }>('/relay/stop', { method: 'POST' }),
+  restartRelay: () => request<{ ok: true }>('/relay/restart', { method: 'POST' }),
+  updateRelayConfig: (patch: Record<string, unknown>) =>
+    request<{ port: number; deepseekBaseUrl: string }>('/relay/config', {
+      method: 'PUT',
+      body: JSON.stringify(patch),
+    }),
+
+
+  // Install
+  getInstallStatus: () =>
+    request<{
+      projectRoot: string
+      hasNodeModules: boolean
+      hasPackageJson: boolean
+      needsInstall: boolean
+      isRunning: boolean
+      logCount: number
+      node: { ok: boolean; version?: string; error?: string }
+      npm: { ok: boolean; version?: string; error?: string }
+    }>('/install/status'),
+  runInstall: () =>
+    request<{ started: boolean; pid?: number }>('/install/run', { method: 'POST' }),
+  cancelInstall: () =>
+    request<{ killed: boolean }>('/install/cancel', { method: 'POST' }),
+}
+

package/src/lib/store.ts

@@ -0,0 +1,166 @@
+// BHG-helper — zustand store
+import { create } from 'zustand'
+import { api } from './api'
+import type {
+  BackupInfo,
+  BridgeConfig,
+  ConfigPayload,
+  Credentials,
+  LogEntry,
+  ProviderPreset,
+  Settings,
+} from './types'
+
+interface CockpitState {
+  // data
+  config: ConfigPayload | null
+  presets: ProviderPreset[]
+  logs: LogEntry[]
+  // ui
+  loading: boolean
+  saving: boolean
+  lastSavedAt: string | null
+  errorMessage: string | null
+
+  // actions
+  loadAll: () => Promise<void>
+  saveBridge: (bridge: BridgeConfig) => Promise<void>
+  saveCredentials: (c: Credentials) => Promise<void>
+  saveSettings: (s: Settings) => Promise<void>
+  setActiveModel: (id: string) => Promise<void>
+  refreshBackups: () => Promise<void>
+  createBackup: (scope: 'bridge' | 'credentials' | 'settings') => Promise<void>
+  restoreBackup: (filename: string) => Promise<void>
+  deleteBackup: (filename: string) => Promise<void>
+  appendLog: (entry: LogEntry) => void
+  clearError: () => void
+}
+
+export const useStore = create<CockpitState>((set, get) => ({
+  config: null,
+  presets: [],
+  logs: [],
+  loading: false,
+  saving: false,
+  lastSavedAt: null,
+  errorMessage: null,
+
+  loadAll: async () => {
+    set({ loading: true, errorMessage: null })
+    try {
+      const [config, presets, logs] = await Promise.all([
+        api.getConfig(),
+        api.listProviderPresets(),
+        api.listLogs(),
+      ])
+      set({ config, presets, logs, loading: false })
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      set({ loading: false, errorMessage: msg })
+    }
+  },
+
+  saveBridge: async (bridge) => {
+    set({ saving: true, errorMessage: null })
+    try {
+      await api.saveBridge(bridge)
+      const config = await api.getConfig()
+      set({ config, saving: false, lastSavedAt: new Date().toISOString() })
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      set({ saving: false, errorMessage: msg })
+    }
+  },
+
+  saveCredentials: async (credentials) => {
+    set({ saving: true, errorMessage: null })
+    try {
+      await api.saveCredentials(credentials)
+      const config = await api.getConfig()
+      set({ config, saving: false, lastSavedAt: new Date().toISOString() })
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      set({ saving: false, errorMessage: msg })
+    }
+  },
+
+  saveSettings: async (settings) => {
+    set({ saving: true, errorMessage: null })
+    try {
+      await api.saveSettings(settings)
+      const config = await api.getConfig()
+      set({ config, saving: false, lastSavedAt: new Date().toISOString() })
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      set({ saving: false, errorMessage: msg })
+    }
+  },
+
+  setActiveModel: async (id) => {
+    const cur = get().config?.settings
+    if (!cur) return
+    const next: Settings = { ...cur, model: id }
+    await get().saveSettings(next)
+  },
+
+  refreshBackups: async () => {
+    try {
+      const backups = await api.listBackups()
+      const config = get().config
+      if (config) set({ config: { ...config, backups } })
+    } catch {
+      // ignore
+    }
+  },
+
+  createBackup: async (scope) => {
+    try {
+      await api.createBackup(scope)
+      await get().refreshBackups()
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      set({ errorMessage: msg })
+    }
+  },
+
+  restoreBackup: async (filename) => {
+    try {
+      await api.restoreBackup(filename)
+      await get().loadAll()
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      set({ errorMessage: msg })
+    }
+  },
+
+  deleteBackup: async (filename) => {
+    try {
+      await api.deleteBackup(filename)
+      await get().refreshBackups()
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      set({ errorMessage: msg })
+    }
+  },
+
+  appendLog: (entry) => set((s) => ({ logs: [...s.logs, entry].slice(-300) })),
+  clearError: () => set({ errorMessage: null }),
+}))
+
+// SSE log stream subscriber
+export function startLogStream(): () => void {
+  const es = new EventSource('/api/logs/stream')
+  const handler = (e: MessageEvent) => {
+    try {
+      const data = JSON.parse(e.data) as LogEntry
+      useStore.getState().appendLog(data)
+    } catch {
+      // ignore
+    }
+  }
+  es.onmessage = handler
+  es.onerror = () => {
+    // silent — server will retry
+  }
+  return () => es.close()
+}

package/src/lib/types.ts

@@ -0,0 +1,117 @@
+// BHG-helper — TypeScript types
+
+export interface ModelEntry {
+  id: string
+  label: string
+  tier: 'large' | 'middle' | 'small'
+  provider: string
+  context_window: number
+  default_max_tokens: number
+  max_tokens: number
+  pricing: {
+    currency: string
+    quota_type: string
+    pricing_group: string
+    input_per_1m_tokens: number
+    output_per_1m_tokens: number
+    cache_read_per_1m_tokens: number
+    cache_write_per_1m_tokens: number
+  }
+  description: string
+  protocol: 'anthropic' | 'openai'
+  enabled: boolean
+  available: boolean
+}
+
+export interface BridgeModelCatalogCache {
+  models: ModelEntry[]
+  defaults: { large: string; middle: string; small: string }
+  pricing_version?: string
+  pricing_group?: string
+}
+
+export interface BridgeConfig {
+  bridgeModelCatalogCache?: BridgeModelCatalogCache
+  additionalModelOptionsCache?: Array<{
+    value: string
+    label: string
+    description: string
+    descriptionForModel: string
+  }>
+  oauthAccount?: null | {
+    accountUuid: string
+    organizationUuid: string
+    hasExtraUsageEnabled?: boolean
+    billingType?: string
+    subscriptionCreatedAt?: string
+    displayName?: string
+  }
+  [key: string]: unknown
+}
+
+export interface Credentials {
+  claudeAiOauth?: {
+    accessToken: string
+    newApiApiKey: string
+    refreshToken: string
+    expiresAt: number
+    scopes: string[]
+    subscriptionType: string
+    rateLimitTier: string
+    newApiSessionUserId: number
+    newApiSessionCookie: string
+  }
+  [key: string]: unknown
+}
+
+export interface Settings {
+  env?: Record<string, string>
+  includeCoAuthoredBy?: boolean
+  model: string
+  skipDangerousModePermissionPrompt?: boolean
+  hasCompletedOnboarding?: boolean
+  language?: string
+  [key: string]: unknown
+}
+
+export interface BackupInfo {
+  filename: string
+  scope: 'bridge' | 'credentials' | 'settings' | 'unknown'
+  size: number
+  createdAt: string
+}
+
+export interface ConfigPayload {
+  bhgHelperDir: string
+  files: {
+    bridge: string
+    credentials: string
+    settings: string
+  }
+  bridge: BridgeConfig | null
+  credentials: Credentials | null
+  settings: Settings | null
+  backups: BackupInfo[]
+}
+
+export interface ProviderPreset {
+  id: string
+  name: string
+  protocol: 'anthropic' | 'openai'
+  baseUrl?: string
+  notes: string
+  models: Array<{
+    id: string
+    label: string
+    tier: 'large' | 'middle' | 'small'
+    description: string
+  }>
+}
+
+export interface LogEntry {
+  id: number
+  ts: string
+  level: 'INFO' | 'OK' | 'WARN' | 'ERR'
+  scope: string
+  message: string
+}

package/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/src/main.tsx

@@ -0,0 +1,10 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import App from './App'
+import './index.css'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)

package/src/pages/ConsolePage.tsx

@@ -0,0 +1,48 @@
+import { useEffect, useRef } from 'react'
+import { useStore } from '../lib/store'
+import Page, { Panel } from '../components/Page'
+import { Trash2 } from 'lucide-react'
+
+export default function ConsolePage() {
+  const logs = useStore((s) => s.logs)
+  const bodyRef = useRef<HTMLDivElement | null>(null)
+
+  useEffect(() => {
+    if (bodyRef.current) bodyRef.current.scrollTop = bodyRef.current.scrollHeight
+  }, [logs.length])
+
+  return (
+    <Page title="事件日志" code="06" subtitle="所有文件读写 / API 调用 / 备份事件实时回放">
+      <Panel title={`EVENT STREAM · ${logs.length} 条`}>
+        <div
+          ref={bodyRef}
+          style={{
+            maxHeight: 'calc(100vh - 280px)',
+            overflowY: 'auto',
+            background: 'var(--bg-0)',
+            border: '1px solid var(--line-2)',
+            padding: 'var(--sp-2)',
+            fontFamily: 'var(--font-mono)',
+            fontSize: 11,
+          }}
+        >
+          {logs.length === 0 ? (
+            <div className="empty">
+              <div className="empty-title">— 还没有事件 —</div>
+              <div>所有操作会实时显示在此处</div>
+            </div>
+          ) : (
+            logs.map((l) => (
+              <div key={l.id} className={'log-row ' + l.level}>
+                <span className="log-ts">{l.ts}</span>
+                <span className={'log-level ' + l.level}>{l.level}</span>
+                <span className="log-scope">{l.scope}</span>
+                <span className="log-msg">{l.message}</span>
+              </div>
+            ))
+          )}
+        </div>
+      </Panel>
+    </Page>
+  )
+}

package/src/pages/Dashboard.tsx

@@ -0,0 +1,101 @@
+import { useStore } from '../lib/store'
+import Page, { Panel, StatusCard } from '../components/Page'
+import { RefreshCw, Server, ExternalLink, Terminal } from 'lucide-react'
+import { api } from '../lib/api'
+import { useEffect, useState } from 'react'
+
+export default function Dashboard() {
+  const loadAll = useStore((s) => s.loadAll)
+  const [relay, setRelay] = useState<{ running: boolean; hasKey: boolean; models: string[] } | null>(null)
+
+  async function refresh() {
+    try {
+      const s = await api.getRelayStatus()
+      const m = await fetch('http://127.0.0.1:8787/v1/models').then(r => r.json()).catch(() => null)
+      setRelay({
+        running: s.running,
+        hasKey: !!(s.info?.deepseekApiKey || s.config?.deepseekApiKey),
+        models: m?.data?.map((d: { id: string }) => d.id) ?? [],
+      })
+    } catch {
+      setRelay({ running: false, hasKey: false, models: [] })
+    }
+  }
+
+  useEffect(() => {
+    void refresh()
+    const t = setInterval(refresh, 5000)
+    return () => clearInterval(t)
+  }, [])
+
+  return (
+    <Page
+      title="主控台"
+      code="01"
+      subtitle="Claude Code → DeepSeek 本地中转"
+      actions={
+        <button className="btn" onClick={() => { void loadAll(); void refresh() }}>
+          <RefreshCw size={14} /> 刷新
+        </button>
+      }
+    >
+      <div className="panel-grid cols-3" style={{ marginBottom: 'var(--sp-5)' }}>
+        <StatusCard
+          tone={relay?.running ? 'green' : 'amber'}
+          label="中转服务"
+          value={relay?.running ? 'RUNNING :8787' : 'STOPPED'}
+          meta={relay?.running ? 'claude.exe 可用' : '去「中转服务」启动'}
+        />
+        <StatusCard
+          tone={relay?.hasKey ? 'green' : 'amber'}
+          label="DeepSeek API Key"
+          value={relay?.hasKey ? '已配置' : '未配置'}
+          meta={relay?.hasKey ? '中转可调用' : '需要填入 Key'}
+        />
+        <StatusCard
+          tone={(relay?.models?.length ?? 0) > 0 ? 'green' : 'amber'}
+          label="可用模型"
+          value={`${relay?.models?.length ?? 0} 个`}
+          meta={relay?.models?.[0] || '中转未启'}
+        />
+      </div>
+
+      <Panel title="HOW IT WORKS · 工作原理">
+        <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr 1fr', gap: 16, alignItems: 'center', padding: 'var(--sp-3) 0' }}>
+          <Block title="claude.exe" sub="官方 CLI" body="读 ~/.claude/settings.json" />
+          <Block title="中转 :8787" sub="本地服务" body="Anthropic → OpenAI 翻译" highlight />
+          <Block title="DeepSeek" sub="api.deepseek.com" body="真实模型调用" />
+        </div>
+      </Panel>
+
+      <Panel title="QUICK START · 3 步">
+        <ol style={{ margin: 0, paddingLeft: 20, lineHeight: 1.9, fontSize: 13, color: 'var(--ink-1)' }}>
+          <li>去 <a href="https://platform.deepseek.com" target="_blank" rel="noreferrer" style={{ color: 'var(--accent-green)' }}>platform.deepseek.com <ExternalLink size={11} /></a> 申请 API Key</li>
+          <li>进 <a href="#/relay" style={{ color: 'var(--accent-green)' }}>「中转服务」</a> 填 Key → 保存 → 启动</li>
+          <li>新开终端跑 <code style={{ background: 'var(--bg-2)', padding: '2px 6px', borderRadius: 3, fontSize: 12 }}>claude</code></li>
+        </ol>
+      </Panel>
+
+      <div style={{ marginTop: 'var(--sp-3)', color: 'var(--ink-3)', fontSize: 11, display: 'flex', gap: 12, alignItems: 'center', fontFamily: 'var(--font-mono)' }}>
+        <Terminal size={12} />
+        端口: Vite 5173 · API 3001 · 中转 8787 · 全部仅本机监听
+      </div>
+    </Page>
+  )
+}
+
+function Block({ title, sub, body, highlight }: { title: string; sub: string; body: string; highlight?: boolean }) {
+  return (
+    <div style={{
+      padding: 'var(--sp-3)',
+      background: highlight ? 'rgba(16, 185, 129, 0.08)' : 'var(--bg-1)',
+      border: `1px solid ${highlight ? 'rgba(16, 185, 129, 0.3)' : 'var(--line-1)'}`,
+      borderRadius: 8,
+      textAlign: 'center',
+    }}>
+      <div style={{ fontSize: 14, fontWeight: 600, color: highlight ? 'var(--accent-green)' : 'var(--ink-0)' }}>{title}</div>
+      <div style={{ fontSize: 10, color: 'var(--ink-3)', marginTop: 2, textTransform: 'uppercase', letterSpacing: 0.5 }}>{sub}</div>
+      <div style={{ fontSize: 11, color: 'var(--ink-2)', marginTop: 6, fontFamily: 'var(--font-mono)' }}>{body}</div>
+    </div>
+  )
+}