refactor: restructure project for multi-agent extensibility

- Migrate source to packages/client and packages/server directories - Namespace all Hermes-specific code under hermes/ subdirectories (api/hermes/, components/hermes/, views/hermes/, stores/hermes/) - Add hermes.* route names and /hermes/* path prefixes - Upgrade @koa/router to v15, adapt path-to-regexp v8 syntax - Fix proxy path rewriting: /api/hermes/v1/* → /v1/*, /api/hermes/* → /api/* - Fix frontend API paths to match backend /api/hermes/* routes - Fix WebSocket terminal path to /api/hermes/terminal - Add proxyMiddleware for reliable unmatched route proxying - Add profiles route module and hermes-cli profile commands - Update CLAUDE.md development guide with new architecture - Add Chinese README (README_zh.md) - Add Web Terminal feature to README Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-16 08:38:18 +08:00
parent 4917242dca
commit 351c861777
106 changed files with 1409 additions and 317 deletions
@@ -0,0 +1,190 @@
+import Router from '@koa/router'
+import * as hermesCli from '../../services/hermes-cli'
+
+export const profileRoutes = new Router()
+
+// GET /api/profiles - List all profiles
+profileRoutes.get('/api/hermes/profiles', async (ctx) => {
+  try {
+    const profiles = await hermesCli.listProfiles()
+    ctx.body = { profiles }
+  } catch (err: any) {
+    ctx.status = 500
+    ctx.body = { error: err.message }
+  }
+})
+
+// POST /api/profiles - Create a new profile
+profileRoutes.post('/api/hermes/profiles', async (ctx) => {
+  const { name, clone } = ctx.request.body as { name?: string; clone?: boolean }
+
+  if (!name) {
+    ctx.status = 400
+    ctx.body = { error: 'Missing profile name' }
+    return
+  }
+
+  try {
+    const output = await hermesCli.createProfile(name, clone)
+    ctx.body = { success: true, message: output.trim() }
+  } catch (err: any) {
+    ctx.status = 500
+    ctx.body = { error: err.message }
+  }
+})
+
+// GET /api/profiles/:name - Get profile details
+profileRoutes.get('/api/hermes/profiles/:name', async (ctx) => {
+  const { name } = ctx.params
+
+  try {
+    const profile = await hermesCli.getProfile(name)
+    ctx.body = { profile }
+  } catch (err: any) {
+    ctx.status = err.message.includes('not found') ? 404 : 500
+    ctx.body = { error: err.message }
+  }
+})
+
+// DELETE /api/profiles/:name - Delete a profile
+profileRoutes.delete('/api/hermes/profiles/:name', async (ctx) => {
+  const { name } = ctx.params
+
+  if (name === 'default') {
+    ctx.status = 400
+    ctx.body = { error: 'Cannot delete the default profile' }
+    return
+  }
+
+  try {
+    const ok = await hermesCli.deleteProfile(name)
+    if (ok) {
+      ctx.body = { success: true }
+    } else {
+      ctx.status = 500
+      ctx.body = { error: 'Failed to delete profile' }
+    }
+  } catch (err: any) {
+    ctx.status = 500
+    ctx.body = { error: err.message }
+  }
+})
+
+// POST /api/profiles/:name/rename - Rename a profile
+profileRoutes.post('/api/hermes/profiles/:name/rename', async (ctx) => {
+  const { name } = ctx.params
+  const { new_name } = ctx.request.body as { new_name?: string }
+
+  if (!new_name) {
+    ctx.status = 400
+    ctx.body = { error: 'Missing new_name' }
+    return
+  }
+
+  try {
+    const ok = await hermesCli.renameProfile(name, new_name)
+    if (ok) {
+      ctx.body = { success: true }
+    } else {
+      ctx.status = 500
+      ctx.body = { error: 'Failed to rename profile' }
+    }
+  } catch (err: any) {
+    ctx.status = 500
+    ctx.body = { error: err.message }
+  }
+})
+
+// PUT /api/profiles/active - Switch active profile
+profileRoutes.put('/api/hermes/profiles/active', async (ctx) => {
+  const { name } = ctx.request.body as { name?: string }
+
+  if (!name) {
+    ctx.status = 400
+    ctx.body = { error: 'Missing profile name' }
+    return
+  }
+
+  try {
+    // 1. Stop gateway (try launchd/systemd first, ignore if unavailable e.g. WSL)
+    try { await hermesCli.stopGateway() } catch { }
+
+    // 2. Kill gateway by port if still running (for WSL / background mode)
+    try {
+      const { execSync } = await import('child_process')
+      const isWin = process.platform === 'win32'
+      let pids = ''
+      if (isWin) {
+        const out = execSync('netstat -aon | findstr :8642', { encoding: 'utf-8', timeout: 5000 }).trim()
+        const lines = out.split('\n').filter(l => l.includes('LISTENING'))
+        pids = Array.from(new Set(lines.map(l => l.trim().split(/\s+/).pop()).filter(Boolean))).join(' ')
+      } else {
+        pids = execSync('lsof -ti:8642', { encoding: 'utf-8', timeout: 5000 }).trim()
+      }
+      if (pids) {
+        if (isWin) {
+          execSync(`taskkill /F /PID ${pids.split(' ').join(' /PID ')}`, { timeout: 5000 })
+        } else {
+          execSync(`kill -9 ${pids}`, { timeout: 5000 })
+        }
+        await new Promise(r => setTimeout(r, 2000))
+      }
+    } catch { }
+
+    // 3. Switch profile
+    const output = await hermesCli.useProfile(name)
+    await new Promise(r => setTimeout(r, 1000))
+
+    // 4. Start gateway — try launchd/systemd first, fall back to background mode
+    try {
+      await hermesCli.restartGateway()
+    } catch {
+      // Fallback for WSL / environments without launchd/systemd
+      try {
+        const pid = await hermesCli.startGatewayBackground()
+        await new Promise(r => setTimeout(r, 3000))
+        console.log(`[Profile] Gateway started in background mode (PID: ${pid})`)
+      } catch (err: any) {
+        console.error('[Profile] Gateway start failed:', err.message)
+      }
+    }
+
+    ctx.body = { success: true, message: output.trim() }
+  } catch (err: any) {
+    ctx.status = 500
+    ctx.body = { error: err.message }
+  }
+})
+
+// POST /api/profiles/:name/export - Export profile to archive
+profileRoutes.post('/api/hermes/profiles/:name/export', async (ctx) => {
+  const { name } = ctx.params
+  const { output } = ctx.request.body as { output?: string }
+
+  try {
+    const result = await hermesCli.exportProfile(name, output)
+    ctx.body = { success: true, message: result.trim() }
+  } catch (err: any) {
+    ctx.status = 500
+    ctx.body = { error: err.message }
+  }
+})
+
+// POST /api/profiles/import - Import profile from archive
+profileRoutes.post('/api/hermes/profiles/import', async (ctx) => {
+  const { archive, name } = ctx.request.body as { archive?: string; name?: string }
+
+  if (!archive) {
+    ctx.status = 400
+    ctx.body = { error: 'Missing archive path' }
+    return
+  }
+
+  try {
+    const result = await hermesCli.importProfile(archive, name)
+    ctx.body = { success: true, message: result.trim() }
+  } catch (err: any) {
+    ctx.status = 500
+    ctx.body = { error: err.message }
+  }
+})