Pārlūkot izejas kodu

管理员设置恢复「模型服务」:供应商、账号登录、API Key 与辅助模型

只保留 Bot 模式后设置中心不再有模型配置入口,内置 Hermes 也没有了 Dashboard 页面。
新增管理员页面与 /api/app/admin/hermes/* 接口,直接调用内置 hermes_service:
- 供应商与默认模型(沿用原面板,可选 Profile)
- 订阅账号登录(设备码、粘贴凭据、退出)
- API Key 与工具密钥(隐藏消息渠道变量,默认显示各供应商主密钥)
- 视觉、压缩、标题等辅助模型

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HvtCVfyjw1NDNZsVHYZJZA
Claude 3 stundas atpakaļ
vecāks
revīzija
a592dab1f8

+ 3 - 2
README.md

@@ -29,7 +29,7 @@ npm run build
 npm start
 ```
 
-默认 Web 地址为 `http://127.0.0.1:15300`。首次打开 Web 时自行创建管理员账号;服务不会生成固定的默认账号或密码。之后在“系统设置 → 模型服务”中配置模型供应商和默认模型。
+默认 Web 地址为 `http://127.0.0.1:15300`。首次打开 Web 时自行创建管理员账号;服务不会生成固定的默认账号或密码。之后在“我的设置 → 管理 → 模型服务”中配置模型供应商和默认模型。
 
 ### 内置 Hermes
 
@@ -37,6 +37,7 @@ npm start
 - 数据保存在 `<数据目录>/hermes`:默认 Profile 即该目录,具名 Profile 在 `hermes/profiles/<名称>`;每个 Bot 使用独立的 `bots/<Bot ID>/runtime`,以所选 Profile 为父级读取配置和凭据。
 - 首次启动时如果检测到原有 `~/.hermes`(或 `YAOYAO_IMPORT_HERMES_HOME` 指定的目录),会只读导入会话、Profile、配置、凭据、技能和附件,不修改原目录;导入失败时从空数据启动并在日志中提示。设置 `YAOYAO_IMPORT_HERMES=0` 可跳过导入。
 - Hermes 原生终端、文件和代码工具在服务器上执行,按系统设置中的审批策略逐次确认。
+- 管理员在「我的设置 → 管理 → 模型服务」中配置供应商与默认模型、订阅账号登录(设备码 / 粘贴凭据)、API Key 与工具密钥,以及视觉、压缩、标题等辅助模型,替代原来的 Hermes Dashboard 页面。可按 Profile 分别配置。
 - 不再支持:连接外部 9119、工具桥插件 `yaoyao-bot-bridge`、Hermes 看板(Kanban)、直连远程 Hermes 的节点。设置 `HERMES_YAOYAO_UPSTREAM*`、`HERMES_YAOYAO_SUPERVISE_DASHBOARD`、`HERMES_YAOYAO_BRIDGE_*` 后,启动时会提示这些变量已停用。
 - 迁移方案与实施记录见 [内置 Hermes 迁移](docs/embedded-hermes-migration.md)。
 
@@ -94,7 +95,7 @@ docker compose --env-file docker.env config --quiet
 docker compose --env-file docker.env up -d --build
 ```
 
-默认访问 `http://127.0.0.1:15300`。应用数据保存在 `yaoyao-data` 命名卷,容器内路径为 `/home/node/.yaoyao`。首次打开页面创建管理员账号,并在“系统设置 → 模型服务”中配置模型。
+默认访问 `http://127.0.0.1:15300`。应用数据保存在 `yaoyao-data` 命名卷,容器内路径为 `/home/node/.yaoyao`。首次打开页面创建管理员账号,并在“我的设置 → 管理 → 模型服务”中配置模型。
 
 宿主机连接、局域网访问、验证及升级步骤见 [Docker 部署说明](docs/docker-install.md)。
 

+ 1 - 1
docs/agent-install.md

@@ -9,7 +9,7 @@
 
 在仓库执行 `npm ci`、`npm run build`,然后执行 `npm start`。Web 默认监听 `127.0.0.1:15300`。
 
-模型供应商、默认模型和凭据在 Web 的“系统设置 → 模型服务”中配置,保存在数据目录的 `hermes/` 下。首次启动会只读导入原有 `~/.hermes`。
+模型供应商、默认模型和凭据在 Web 的“我的设置 → 管理 → 模型服务”中配置,保存在数据目录的 `hermes/` 下。首次启动会只读导入原有 `~/.hermes`。
 
 首次打开 Web 时创建管理员账号和至少 8 位的密码。服务不会生成固定的默认账号或密码;iOS 使用 Web 账号或手机登录二维码。
 

+ 1 - 1
docs/docker-install.md

@@ -40,7 +40,7 @@ cp docker.env.example docker.env
 | `HERMES_YAOYAO_PUBLISHED_PORT` | 宿主机 Web 端口,默认 `15300` |
 | `HERMES_YAOYAO_ALLOWED_HOSTS` | 使用域名访问时填写对应域名,多个值用英文逗号分隔 |
 
-内置 Hermes 的会话、Profile、模型配置和凭据都保存在 `yaoyao-data` 数据卷的 `hermes/` 目录;首次登录后在“系统设置 → 模型服务”中配置模型。
+内置 Hermes 的会话、Profile、模型配置和凭据都保存在 `yaoyao-data` 数据卷的 `hermes/` 目录;首次登录后在“我的设置 → 管理 → 模型服务”中配置模型。
 
 使用远程镜像时,在 `docker.env` 设置上述镜像标签后执行:
 

+ 101 - 0
src/client/api/hermesAdmin.ts

@@ -0,0 +1,101 @@
+import { apiRequest } from './client'
+
+export interface HermesCredential {
+  key: string
+  isSet: boolean
+  preview: string | null
+  description: string
+  url: string | null
+  category: string
+  secret: boolean
+  advanced: boolean
+  provider: string
+  providerLabel: string
+  custom: boolean
+  readonly: boolean
+}
+
+export interface AuxiliaryTask {
+  task: string
+  provider: string
+  model: string
+  base_url?: string
+  label?: string
+  hint?: string
+}
+
+export interface AuxiliaryModels {
+  tasks: AuxiliaryTask[]
+  main?: { provider?: string; model?: string }
+  providers?: Array<{ id: string; label: string }>
+}
+
+export interface OAuthProvider {
+  id: string
+  name: string
+  flow: string
+  web_flow?: string
+  cli_command?: string | null
+  docs_url?: string | null
+  disconnectable?: boolean
+  disconnect_hint?: string | null
+  status?: { logged_in?: boolean; source_label?: string | null; token_preview?: string | null }
+}
+
+export interface OAuthSession {
+  session_id: string
+  status?: string
+  flow?: string
+  user_code?: string
+  verification_url?: string
+  expires_in?: number
+  error_message?: string | null
+}
+
+const query = (profile: string) => profile && profile !== 'default' ? `?profile=${encodeURIComponent(profile)}` : ''
+
+export async function listHermesCredentials(profile: string): Promise<HermesCredential[]> {
+  return (await apiRequest<{ variables: HermesCredential[] }>(`/api/app/admin/hermes/credentials${query(profile)}`)).variables ?? []
+}
+
+export async function saveHermesCredential(profile: string, key: string, value: string): Promise<void> {
+  await apiRequest('/api/app/admin/hermes/credentials', { method: 'PUT', body: { profile, key, value } })
+}
+
+export async function deleteHermesCredential(profile: string, key: string): Promise<void> {
+  await apiRequest('/api/app/admin/hermes/credentials', { method: 'DELETE', body: { profile, key } })
+}
+
+export async function getAuxiliaryModels(profile: string): Promise<AuxiliaryModels> {
+  return apiRequest<AuxiliaryModels>(`/api/app/admin/hermes/auxiliary${query(profile)}`)
+}
+
+export async function setAuxiliaryModel(profile: string, task: string, provider: string, model: string): Promise<AuxiliaryModels> {
+  return apiRequest<AuxiliaryModels>('/api/app/admin/hermes/auxiliary', { method: 'PUT', body: { profile, task, provider, model } })
+}
+
+export async function listOAuthProviders(profile: string): Promise<OAuthProvider[]> {
+  return (await apiRequest<{ providers?: OAuthProvider[] }>(`/api/app/admin/hermes/oauth${query(profile)}`)).providers ?? []
+}
+
+const oauthPath = (provider: string, action = '') => `/api/app/admin/hermes/oauth/${encodeURIComponent(provider)}${action ? `/${action}` : ''}`
+
+export async function startOAuth(profile: string, provider: string): Promise<OAuthSession> {
+  return apiRequest<OAuthSession>(oauthPath(provider, 'start'), { method: 'POST', body: { profile } })
+}
+
+export async function pollOAuth(profile: string, provider: string, sessionId: string): Promise<OAuthSession> {
+  return apiRequest<OAuthSession>(oauthPath(provider, 'poll'), { method: 'POST', body: { profile, sessionId } })
+}
+
+export async function cancelOAuth(profile: string, provider: string, sessionId: string): Promise<void> {
+  await apiRequest(oauthPath(provider, 'cancel'), { method: 'POST', body: { profile, sessionId } })
+}
+
+export async function submitOAuthToken(profile: string, provider: string, token: string): Promise<void> {
+  await apiRequest(oauthPath(provider, 'token'), { method: 'POST', body: { profile, token } })
+}
+
+export async function disconnectOAuth(profile: string, provider: string): Promise<void> {
+  await apiRequest(oauthPath(provider), { method: 'DELETE', body: { profile } })
+}

+ 362 - 0
src/client/components/app/HermesModelSettingsPanel.vue

@@ -0,0 +1,362 @@
+<script setup lang="ts">
+import { computed, onBeforeUnmount, ref, watch } from 'vue'
+import type { Profile } from '@shared/types'
+import ModelServicesPanel from './ModelServicesPanel.vue'
+import { listModelCatalog, type ModelCatalogProvider } from '@/api/agentManagement'
+import {
+  cancelOAuth, deleteHermesCredential, disconnectOAuth, getAuxiliaryModels, listHermesCredentials, listOAuthProviders,
+  pollOAuth, saveHermesCredential, setAuxiliaryModel, startOAuth, submitOAuthToken,
+  type AuxiliaryModels, type AuxiliaryTask, type HermesCredential, type OAuthProvider, type OAuthSession,
+} from '@/api/hermesAdmin'
+import { notifyModelCatalogChanged } from '@/utils/modelCatalogEvents'
+
+type Tab = 'models' | 'accounts' | 'keys' | 'auxiliary'
+const props = defineProps<{ profiles?: Profile[] }>()
+const emit = defineEmits<{ 'dirty-change': [dirty: boolean] }>()
+
+const tabs: Array<{ id: Tab; label: string }> = [
+  { id: 'models', label: '供应商与模型' },
+  { id: 'accounts', label: '账号登录' },
+  { id: 'keys', label: '密钥与变量' },
+  { id: 'auxiliary', label: '辅助模型' },
+]
+const tab = ref<Tab>('models')
+const profile = ref('default')
+const profileOptions = computed(() => {
+  const names = new Set(['default', ...(props.profiles ?? []).map(item => item.name).filter(Boolean)])
+  return [...names]
+})
+const busy = ref(false)
+const error = ref('')
+const notice = ref('')
+
+async function run(work: () => Promise<void>, success = '') {
+  if (busy.value) return
+  busy.value = true; error.value = ''; notice.value = ''
+  try { await work(); if (success) notice.value = success }
+  catch (cause) { error.value = cause instanceof Error ? cause.message : '操作失败' }
+  finally { busy.value = false }
+}
+
+// ── 密钥与变量 ───────────────────────────────────────────────────────────────
+const credentials = ref<HermesCredential[]>([])
+const keyQuery = ref('')
+const showAdvanced = ref(false)
+const editingKey = ref('')
+const editingValue = ref('')
+const customKey = ref('')
+const customValue = ref('')
+const CATEGORY_LABELS: Record<string, string> = { provider: '模型供应商', tool: '工具', skill: '技能', setting: '设置', custom: '自定义' }
+const CATEGORY_ORDER = ['provider', 'tool', 'skill', 'setting', 'custom']
+const credentialGroups = computed(() => {
+  const query = keyQuery.value.trim().toLocaleLowerCase()
+  const rows = credentials.value.filter(row => (showAdvanced.value || !row.advanced || row.isSet || query)
+    && (!query || `${row.key} ${row.description} ${row.providerLabel}`.toLocaleLowerCase().includes(query)))
+  const groups = new Map<string, HermesCredential[]>()
+  for (const row of rows) groups.set(row.category, [...(groups.get(row.category) ?? []), row])
+  return [...groups.entries()]
+    .sort(([a], [b]) => (CATEGORY_ORDER.indexOf(a) + 1 || 99) - (CATEGORY_ORDER.indexOf(b) + 1 || 99))
+    .map(([category, items]) => ({ category, label: CATEGORY_LABELS[category] ?? category, items: items.sort((a, b) => Number(b.isSet) - Number(a.isSet) || a.key.localeCompare(b.key)) }))
+})
+async function loadCredentials() { credentials.value = await listHermesCredentials(profile.value) }
+function editCredential(row: HermesCredential) { editingKey.value = row.key; editingValue.value = '' }
+function saveCredential(key: string, value: string) {
+  return run(async () => {
+    await saveHermesCredential(profile.value, key, value)
+    editingKey.value = ''; editingValue.value = ''; customKey.value = ''; customValue.value = ''
+    await loadCredentials(); notifyModelCatalogChanged(profile.value)
+  }, `已保存 ${key}`)
+}
+function clearCredential(row: HermesCredential) {
+  if (!window.confirm(`清除 ${row.key}?`)) return
+  return run(async () => { await deleteHermesCredential(profile.value, row.key); await loadCredentials(); notifyModelCatalogChanged(profile.value) }, `已清除 ${row.key}`)
+}
+
+// ── 账号登录 ────────────────────────────────────────────────────────────────
+const oauthProviders = ref<OAuthProvider[]>([])
+const login = ref<{ provider: string; session: OAuthSession } | null>(null)
+const tokenProvider = ref('')
+const tokenValue = ref('')
+let pollTimer: ReturnType<typeof setTimeout> | undefined
+async function loadOAuth() { oauthProviders.value = await listOAuthProviders(profile.value) }
+function loginFlow(provider: OAuthProvider): 'device' | 'token' | 'external' {
+  const flow = provider.web_flow || provider.flow
+  if (flow === 'paste_token') return 'token'
+  if (flow === 'device_code' || flow === 'process') return 'device'
+  return 'external'
+}
+function stopPolling() { if (pollTimer) clearTimeout(pollTimer); pollTimer = undefined }
+function schedulePoll() {
+  stopPolling()
+  pollTimer = setTimeout(async () => {
+    const current = login.value
+    if (!current) return
+    try {
+      const result = await pollOAuth(profile.value, current.provider, current.session.session_id)
+      if (login.value?.session.session_id !== current.session.session_id) return
+      login.value = { provider: current.provider, session: { ...current.session, ...result } }
+      if (!result.status || result.status === 'pending') { schedulePoll(); return }
+      if (result.status === 'approved') { notice.value = '登录成功'; login.value = null; await loadOAuth(); notifyModelCatalogChanged(profile.value) }
+      else error.value = result.error_message || ({ denied: '登录被拒绝', expired: '登录已过期,请重新开始' } as Record<string, string>)[result.status] || '登录失败'
+    } catch (cause) { error.value = cause instanceof Error ? cause.message : '登录状态查询失败' }
+  }, 3000)
+}
+function beginLogin(provider: OAuthProvider) {
+  if (loginFlow(provider) === 'token') { tokenProvider.value = provider.id; tokenValue.value = ''; return }
+  return run(async () => {
+    const session = await startOAuth(profile.value, provider.id)
+    login.value = { provider: provider.id, session }
+    schedulePoll()
+  })
+}
+function cancelLogin() {
+  const current = login.value
+  stopPolling(); login.value = null
+  if (current) void cancelOAuth(profile.value, current.provider, current.session.session_id).catch(() => undefined)
+}
+function submitToken() {
+  return run(async () => {
+    await submitOAuthToken(profile.value, tokenProvider.value, tokenValue.value)
+    tokenProvider.value = ''; tokenValue.value = ''
+    await loadOAuth(); notifyModelCatalogChanged(profile.value)
+  }, '凭据已保存')
+}
+function logout(provider: OAuthProvider) {
+  if (!window.confirm(`退出 ${provider.name}?`)) return
+  return run(async () => { await disconnectOAuth(profile.value, provider.id); await loadOAuth(); notifyModelCatalogChanged(profile.value) }, `已退出 ${provider.name}`)
+}
+
+// ── 辅助模型 ────────────────────────────────────────────────────────────────
+const AUX_LABELS: Record<string, [string, string]> = {
+  vision: ['视觉识别', '图片理解与截图分析'],
+  compression: ['上下文压缩', '长对话接近上限时整理历史'],
+  approval: ['审批判断', '自动审批模式下判断命令风险'],
+  mcp: ['MCP 工具', 'MCP 工具的辅助调用'],
+  title_generation: ['标题生成', '为会话生成标题'],
+  review: ['复核', '回合结束后的记忆与技能复核'],
+  voice_chat: ['语音对话', '语音模式下的快速回复'],
+  triage_specifier: ['任务分诊', '拆解并细化任务说明'],
+  kanban_decomposer: ['任务拆解', '把目标拆成可执行步骤'],
+  profile_describer: ['Profile 描述', '生成 Profile 简介'],
+  curator: ['技能整理', '后台整理与维护技能'],
+  session_search: ['会话搜索', '总结检索到的历史会话'],
+  web_extract: ['网页提取', '总结抓取的网页内容'],
+}
+const auxiliary = ref<AuxiliaryTask[]>([])
+const auxMain = ref('')
+const auxDrafts = ref<Record<string, { provider: string; model: string }>>({})
+const catalog = ref<ModelCatalogProvider[]>([])
+const allProviders = ref<Array<{ id: string; label: string }>>([])
+/** Providers with a loaded model list first, then the rest of Hermes's providers. */
+const auxProviders = computed(() => {
+  const seen = new Set(catalog.value.map(item => item.slug))
+  return [...catalog.value.map(item => ({ id: item.slug, label: item.name })), ...allProviders.value.filter(item => !seen.has(item.id))]
+})
+function auxLabel(task: AuxiliaryTask): [string, string] { return AUX_LABELS[task.task] ?? [task.label || task.task, task.hint || ''] }
+function modelsFor(provider: string) { return catalog.value.find(item => item.slug === provider)?.models ?? [] }
+function applyAuxiliary(value: AuxiliaryModels) {
+  auxiliary.value = value.tasks ?? []
+  if (value.providers?.length) allProviders.value = value.providers
+  auxMain.value = value.main?.model ? `${value.main.provider || ''} / ${value.main.model}` : '未设置'
+  auxDrafts.value = Object.fromEntries(auxiliary.value.map(task => [task.task, { provider: task.provider || 'auto', model: task.model || '' }]))
+}
+async function loadAuxiliary() {
+  const [value, providers] = await Promise.all([getAuxiliaryModels(profile.value), listModelCatalog(profile.value).catch(() => [])])
+  catalog.value = providers
+  applyAuxiliary(value)
+}
+const auxDirty = computed(() => auxiliary.value.some(task => {
+  const draft = auxDrafts.value[task.task]
+  return draft && (draft.provider !== (task.provider || 'auto') || (draft.provider !== 'auto' && draft.model !== (task.model || '')))
+}))
+function saveAuxiliary(task: AuxiliaryTask) {
+  const draft = auxDrafts.value[task.task]
+  if (!draft) return
+  if (draft.provider !== 'auto' && !draft.model.trim()) { error.value = '请填写模型名称'; return }
+  return run(async () => applyAuxiliary(await setAuxiliaryModel(profile.value, task.task, draft.provider, draft.model.trim())), `已保存「${auxLabel(task)[0]}」`)
+}
+function resetAuxiliary() {
+  if (!window.confirm('把全部辅助模型恢复为自动?')) return
+  return run(async () => applyAuxiliary(await setAuxiliaryModel(profile.value, '__reset__', 'auto', '')), '已全部恢复为自动')
+}
+
+// ── 加载 ───────────────────────────────────────────────────────────────────
+const modelsDirty = ref(false)
+const dirty = computed(() => (tab.value === 'models' && modelsDirty.value) || (tab.value === 'auxiliary' && auxDirty.value) || !!editingKey.value || !!customValue.value || !!tokenValue.value)
+watch(dirty, value => emit('dirty-change', value), { immediate: true })
+
+async function load() {
+  stopPolling(); login.value = null; editingKey.value = ''; tokenProvider.value = ''
+  error.value = ''; notice.value = ''
+  if (tab.value === 'models') return
+  busy.value = true
+  try {
+    if (tab.value === 'keys') await loadCredentials()
+    else if (tab.value === 'accounts') await loadOAuth()
+    else await loadAuxiliary()
+  } catch (cause) { error.value = cause instanceof Error ? cause.message : '读取失败' }
+  finally { busy.value = false }
+}
+function selectTab(next: Tab) {
+  if (next === tab.value) return
+  if (dirty.value && !window.confirm('放弃当前未保存的更改?')) return
+  modelsDirty.value = false
+  tab.value = next
+}
+watch([tab, profile], () => { void load() }, { immediate: true })
+onBeforeUnmount(stopPolling)
+</script>
+
+<template>
+  <section class="hermes-settings" aria-label="模型服务">
+    <p class="intro">Hermes 已内置在夭夭服务中,这里替代原来的 Hermes Dashboard:配置模型供应商、账号登录、API Key 和辅助模型。Bot 使用所选 Profile 的这些配置。</p>
+    <div class="toolbar">
+      <div class="tabs" role="tablist" aria-label="模型服务分类">
+        <button v-for="item in tabs" :key="item.id" type="button" role="tab" :aria-selected="tab === item.id" :class="{ active: tab === item.id }" @click="selectTab(item.id)">{{ item.label }}</button>
+      </div>
+      <label v-if="profileOptions.length > 1" class="profile-select">Profile
+        <select v-model="profile" :disabled="busy || dirty"><option v-for="name in profileOptions" :key="name" :value="name">{{ name === 'default' ? 'default(系统)' : name }}</option></select>
+      </label>
+    </div>
+    <p v-if="error" class="panel-error" role="alert">{{ error }}</p>
+    <p v-if="notice" class="panel-notice" role="status">{{ notice }}</p>
+
+    <ModelServicesPanel v-if="tab === 'models'" :key="profile" :profile="profile" @dirty-change="modelsDirty = $event" />
+
+    <template v-else-if="tab === 'accounts'">
+      <p class="hint">适用于用订阅账号或设备码登录的供应商;普通 API Key 请在「密钥与变量」中填写。</p>
+      <p v-if="busy && !oauthProviders.length" class="panel-empty">正在读取…</p>
+      <ul class="rows">
+        <li v-for="provider in oauthProviders" :key="provider.id">
+          <div class="row-main">
+            <strong>{{ provider.name }}</strong>
+            <small :class="{ ok: provider.status?.logged_in }">{{ provider.status?.logged_in ? `已登录${provider.status.source_label ? ` · ${provider.status.source_label}` : ''}${provider.status.token_preview ? ` · …${provider.status.token_preview}` : ''}` : '未登录' }}</small>
+            <small v-if="loginFlow(provider) === 'external' && !provider.status?.logged_in" class="muted">需要在服务器上运行 <code>{{ provider.cli_command }}</code> 登录。</small>
+          </div>
+          <div class="row-actions">
+            <a v-if="provider.docs_url" :href="provider.docs_url" target="_blank" rel="noopener noreferrer" class="text-button">说明</a>
+            <button v-if="provider.status?.logged_in && provider.disconnectable" type="button" class="text-button danger" :disabled="busy" @click="logout(provider)">退出</button>
+            <button v-else-if="!provider.status?.logged_in && loginFlow(provider) !== 'external'" type="button" class="quiet-button" :disabled="busy || !!login" @click="beginLogin(provider)">登录</button>
+          </div>
+          <div v-if="login?.provider === provider.id" class="flow-box">
+            <p>在浏览器打开 <a :href="login.session.verification_url" target="_blank" rel="noopener noreferrer">{{ login.session.verification_url }}</a>,输入代码:</p>
+            <code class="user-code">{{ login.session.user_code }}</code>
+            <p class="muted">完成后这里会自动更新。</p>
+            <button type="button" class="text-button" @click="cancelLogin">取消</button>
+          </div>
+          <form v-if="tokenProvider === provider.id" class="flow-box" @submit.prevent="submitToken">
+            <label>粘贴 API Key 或 setup-token<input v-model="tokenValue" type="password" autocomplete="off" required :disabled="busy"></label>
+            <div class="row-actions"><button type="button" class="text-button" @click="tokenProvider = ''; tokenValue = ''">取消</button><button type="submit" class="primary-button" :disabled="busy || !tokenValue.trim()">保存</button></div>
+          </form>
+        </li>
+      </ul>
+    </template>
+
+    <template v-else-if="tab === 'keys'">
+      <div class="filter-row">
+        <input v-model="keyQuery" type="search" placeholder="搜索变量名、说明或供应商" aria-label="搜索变量">
+        <label class="check"><input v-model="showAdvanced" type="checkbox">显示高级项</label>
+      </div>
+      <p class="hint">值只保存在服务器的 Hermes 数据目录,保存后不会再回传到浏览器。</p>
+      <p v-if="busy && !credentials.length" class="panel-empty">正在读取…</p>
+      <p v-else-if="!credentialGroups.length" class="panel-empty">没有匹配的变量。</p>
+      <section v-for="group in credentialGroups" :key="group.category" class="group">
+        <h4>{{ group.label }}</h4>
+        <ul class="rows">
+          <li v-for="row in group.items" :key="row.key">
+            <div class="row-main">
+              <strong class="mono">{{ row.key }}</strong>
+              <small v-if="row.description || row.providerLabel" class="muted">{{ row.providerLabel && !row.description.includes(row.providerLabel) ? `${row.providerLabel} · ` : '' }}{{ row.description }}<a v-if="row.url" :href="row.url" target="_blank" rel="noopener noreferrer"> 获取</a></small>
+              <small :class="{ ok: row.isSet }">{{ row.isSet ? `已设置${row.preview ? ` · ${row.preview}` : ''}` : '未设置' }}</small>
+            </div>
+            <div class="row-actions">
+              <span v-if="row.readonly" class="muted">由运行环境管理</span>
+              <template v-else>
+                <button v-if="row.isSet" type="button" class="text-button danger" :disabled="busy" @click="clearCredential(row)">清除</button>
+                <button type="button" class="quiet-button" :disabled="busy" @click="editCredential(row)">{{ row.isSet ? '修改' : '设置' }}</button>
+              </template>
+            </div>
+            <form v-if="editingKey === row.key" class="flow-box" @submit.prevent="saveCredential(row.key, editingValue)">
+              <label>{{ row.key }}<input v-model="editingValue" :type="row.secret ? 'password' : 'text'" autocomplete="off" required :disabled="busy"></label>
+              <div class="row-actions"><button type="button" class="text-button" @click="editingKey = ''; editingValue = ''">取消</button><button type="submit" class="primary-button" :disabled="busy || !editingValue.trim()">保存</button></div>
+            </form>
+          </li>
+        </ul>
+      </section>
+      <form class="flow-box custom" @submit.prevent="saveCredential(customKey.trim(), customValue)">
+        <strong>添加自定义变量</strong>
+        <div class="form-grid">
+          <label>变量名<input v-model="customKey" pattern="[A-Za-z_][A-Za-z0-9_]*" placeholder="MY_API_KEY" autocomplete="off" :disabled="busy"></label>
+          <label>值<input v-model="customValue" type="password" autocomplete="off" :disabled="busy"></label>
+        </div>
+        <div class="row-actions"><button type="submit" class="primary-button" :disabled="busy || !customKey.trim() || !customValue.trim()">添加</button></div>
+      </form>
+    </template>
+
+    <template v-else>
+      <p class="hint">辅助模型负责压缩、视觉、标题等后台任务。选「自动」时使用主模型(当前:{{ auxMain }})或 Hermes 自动选择的可用模型。</p>
+      <p v-if="busy && !auxiliary.length" class="panel-empty">正在读取…</p>
+      <ul class="rows">
+        <li v-for="task in auxiliary" :key="task.task" class="aux-row">
+          <div class="row-main"><strong>{{ auxLabel(task)[0] }}</strong><small class="muted">{{ auxLabel(task)[1] }}</small></div>
+          <div v-if="auxDrafts[task.task]" class="aux-fields">
+            <select v-model="auxDrafts[task.task].provider" :aria-label="`${auxLabel(task)[0]} Provider`" :disabled="busy">
+              <option value="auto">自动</option>
+              <option v-if="task.provider && task.provider !== 'auto' && !auxProviders.some(item => item.id === task.provider)" :value="task.provider">{{ task.provider }}</option>
+              <option v-for="item in auxProviders" :key="item.id" :value="item.id">{{ item.label }}</option>
+            </select>
+            <input v-if="auxDrafts[task.task].provider !== 'auto'" v-model="auxDrafts[task.task].model" :list="`aux-models-${task.task}`" placeholder="模型名称" :aria-label="`${auxLabel(task)[0]} 模型`" :disabled="busy">
+            <datalist :id="`aux-models-${task.task}`"><option v-for="model in modelsFor(auxDrafts[task.task].provider)" :key="model" :value="model" /></datalist>
+            <button type="button" class="quiet-button" :disabled="busy" @click="saveAuxiliary(task)">保存</button>
+          </div>
+        </li>
+      </ul>
+      <div v-if="auxiliary.length" class="row-actions"><button type="button" class="text-button" :disabled="busy" @click="resetAuxiliary">全部恢复为自动</button></div>
+    </template>
+  </section>
+</template>
+
+<style scoped>
+.hermes-settings{display:grid;gap:16px}
+.intro,.hint{margin:0;color:var(--text-muted);font-size:12px;line-height:1.6}
+.toolbar{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:12px}
+.tabs{display:flex;flex-wrap:wrap;gap:4px;padding:3px;border:1px solid var(--line);border-radius:10px;background:var(--surface-soft)}
+.tabs button{min-height:34px;padding:0 12px;border:0;border-radius:8px;background:transparent;color:var(--text-secondary);cursor:pointer;font-size:13px;font-weight:600}
+.tabs button.active{background:var(--surface-raised);color:var(--text-primary);box-shadow:0 1px 2px rgb(0 0 0 / 8%)}
+.profile-select{display:flex;align-items:center;gap:8px;color:var(--text-secondary);font-size:13px}
+select,input:not([type=checkbox]){min-width:0;height:38px;box-sizing:border-box;padding:0 10px;border:1px solid var(--line);border-radius:9px;outline:0;background:var(--surface-raised);color:var(--text-primary);font:13px var(--font-ui)}
+select:focus,input:focus{border-color:var(--line-strong);box-shadow:0 0 0 3px var(--focus-ring)}
+.rows{display:grid;margin:0;padding:0;list-style:none;border-top:1px solid var(--line)}
+.rows li{display:flex;flex-wrap:wrap;align-items:center;gap:10px 14px;padding:14px 4px;border-bottom:1px solid var(--line)}
+.row-main{display:grid;min-width:0;flex:1;gap:4px}
+.row-main strong{font-size:14px}
+.row-main small{color:var(--text-secondary);font-size:12px;overflow-wrap:anywhere}
+.row-main small.ok{color:var(--success,#21845b)}
+.muted{color:var(--text-muted)!important;font-size:12px}
+.mono{font-family:var(--font-code);font-size:13px!important}
+.row-actions{display:flex;flex:0 0 auto;align-items:center;justify-content:flex-end;gap:8px}
+.flow-box{display:grid;flex-basis:100%;gap:10px;padding:14px;border:1px solid var(--line-strong);border-radius:11px;background:var(--surface-soft)}
+.flow-box p{margin:0;font-size:13px}
+.flow-box label{display:grid;gap:6px;color:var(--text-secondary);font-size:13px;font-weight:600}
+.user-code{justify-self:start;padding:8px 14px;border-radius:8px;background:var(--surface-raised);font:600 20px var(--font-code);letter-spacing:.12em}
+.custom{flex-basis:auto}
+.form-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}
+.group h4{margin:8px 0;color:var(--text-secondary);font-size:13px}
+.filter-row{display:flex;align-items:center;gap:12px}
+.filter-row input[type=search]{flex:1}
+.check{display:flex;align-items:center;gap:6px;color:var(--text-secondary);font-size:13px;white-space:nowrap}
+.aux-fields{display:flex;flex-wrap:wrap;align-items:center;gap:8px}
+.aux-fields select{width:170px}.aux-fields input{width:220px}
+.primary-button,.quiet-button{display:inline-flex;min-height:36px;align-items:center;justify-content:center;padding:0 14px;border:0;border-radius:9px;cursor:pointer;font-size:13px;font-weight:600}
+.primary-button{background:var(--accent);color:var(--text-on-solid)}
+.quiet-button{border:1px solid var(--line);background:var(--surface-raised);color:var(--text-secondary)}
+.text-button{min-height:32px;padding:0 7px;border:0;border-radius:7px;background:transparent;color:var(--text-secondary);cursor:pointer;font-size:12px;text-decoration:none;display:inline-flex;align-items:center}
+.text-button:hover{background:var(--surface-soft)}.text-button.danger{color:var(--danger)}
+button:disabled{cursor:wait;opacity:.5}
+.panel-error,.panel-notice,.panel-empty{margin:0;padding:11px 12px;border-radius:9px;font-size:13px}
+.panel-error{background:color-mix(in srgb,var(--danger) 8%,transparent);color:var(--danger)}
+.panel-notice{background:color-mix(in srgb,var(--success,#21845b) 9%,transparent);color:var(--success,#21845b)}
+.panel-empty{color:var(--text-muted);background:var(--surface-soft)}
+code{font-family:var(--font-code)}
+@media(max-width:600px){.form-grid{grid-template-columns:1fr}.aux-fields,.aux-fields select,.aux-fields input{width:100%}.filter-row{flex-direction:column;align-items:stretch}.rows li{align-items:flex-start}.row-actions{width:100%}}
+</style>

+ 7 - 1
src/client/components/app/SettingsCenterDialog.vue

@@ -8,6 +8,7 @@ import DesktopModePanel from '@/components/app/DesktopModePanel.vue'
 import AgentIdentityPanel from '@/components/app/AgentIdentityPanel.vue'
 import DuplexVoicePanel from '@/components/app/DuplexVoicePanel.vue'
 import ModelServicesPanel from '@/components/app/ModelServicesPanel.vue'
+import HermesModelSettingsPanel from '@/components/app/HermesModelSettingsPanel.vue'
 import NodePairingPanel from '@/components/app/NodePairingPanel.vue'
 import WorkspaceVoiceProviders from '@/components/workspace/WorkspaceVoiceProviders.vue'
 import SystemManagementPanel from '@/components/app/SystemManagementPanel.vue'
@@ -29,6 +30,7 @@ type SettingsPage =
   | 'chat-appearance'
   | 'desktop-mode'
   | 'system-overview'
+  | 'system-models'
   | 'system-users'
   | 'system-connection'
   | 'system-push'
@@ -112,13 +114,15 @@ const accountItems = computed<NavigationItem[]>(() => [
 ])
 const systemItems: NavigationItem[] = [
   { key: 'system-overview', label: '系统概览', icon: 'panel' },
+  { key: 'system-models', label: '模型服务', icon: 'model' },
   { key: 'system-connection', label: 'Hermes 连接', icon: 'link' },
   { key: 'system-users', label: '用户与权限', icon: 'users' },
   { key: 'system-push', label: '消息推送', icon: 'bell' },
   { key: 'system-voice', label: '双流语音', icon: 'audio' },
   { key: 'system-update', label: '更新与回滚', icon: 'refresh' },
 ]
-const matchesSearch = (item: NavigationItem) => (item.key === 'appearance' ? `${item.label} 聊天气泡 Grok Bot Codex 颜色` : item.label).toLocaleLowerCase().includes(settingsQuery.value.trim().toLocaleLowerCase())
+const SEARCH_ALIASES: Partial<Record<SettingsPage, string>> = { appearance: '聊天气泡 Grok Bot Codex 颜色', 'system-models': '模型 供应商 Provider API Key 密钥 辅助模型 OAuth 登录' }
+const matchesSearch = (item: NavigationItem) => `${item.label} ${SEARCH_ALIASES[item.key] ?? ''}`.toLocaleLowerCase().includes(settingsQuery.value.trim().toLocaleLowerCase())
 const visibleAccounts = computed(() => accountItems.value.filter(matchesSearch))
 const visibleSystems = computed(() => systemItems.filter(matchesSearch))
 const visibleAgents = computed(() => agentItems.value.filter(matchesSearch))
@@ -142,6 +146,7 @@ const activeTitle = computed(() => ({
   'chat-appearance': '聊天气泡',
   'desktop-mode': '运行模式',
   'system-overview': '系统概览',
+  'system-models': '模型服务',
   'system-users': '用户与权限',
   'system-connection': 'Hermes 连接',
   'system-push': '消息推送',
@@ -383,6 +388,7 @@ watch(() => [props.open, props.initialPage, props.botMode, props.isAdmin] as con
                 </section>
                 <ChatAppearancePanel v-else-if="activePage === 'chat-appearance'" :theme="theme" />
                 <SystemOverviewPanel v-else-if="activePage === 'system-overview' && isAdmin" :active="true" :upstream-ready="upstreamReady" :upstream-error="upstreamError" @navigate="selectPage" />
+                <HermesModelSettingsPanel v-else-if="activePage === 'system-models' && isAdmin" :profiles="profiles" @dirty-change="setDirty('system-models', $event)" />
                 <SystemManagementPanel v-else-if="activePage === 'system-users' && isAdmin" section="users" :profiles="profiles" :active="true" @dirty-change="setDirty('system-users', $event)" />
                 <SystemManagementPanel v-else-if="activePage === 'system-connection' && isAdmin" section="connection" :active="true" :profiles="profiles" :upstream-ready="upstreamReady" :upstream-error="upstreamError" @dirty-change="setDirty('system-connection', $event)" />
                 <SystemManagementPanel v-else-if="activePage === 'system-push' && isAdmin" section="push" :active="true" @dirty-change="setDirty('system-push', $event)" />

+ 6 - 1
src/client/components/app/SystemOverviewPanel.vue

@@ -6,7 +6,7 @@ import { getDuplexVoiceSettings, type DuplexVoiceSettings } from '@/api/agentMan
 import { getPushSystemStatus, type PushSystemStatus } from '@/api/push'
 import { systemUpdateStatus, type SystemUpdateStatus } from '@/api/systemUpdate'
 
-type Destination = 'system-users' | 'system-connection' | 'system-push' | 'system-voice' | 'system-update'
+type Destination = 'system-models' | 'system-users' | 'system-connection' | 'system-push' | 'system-voice' | 'system-update'
 
 const props = withDefaults(defineProps<{
   active?: boolean
@@ -72,6 +72,11 @@ watch(() => props.active, active => { if (active) void refresh() }, { immediate:
     <p v-if="error" class="overview-warning" role="status">{{ error }}</p>
 
     <div class="overview-list">
+      <button type="button" @click="emit('navigate', 'system-models')">
+        <AppIcon name="model" :size="22" />
+        <span><strong>模型服务</strong><small>供应商、账号登录、API Key 与辅助模型</small></span>
+        <AppIcon class="chevron" name="chevron-left" :size="18" />
+      </button>
       <button type="button" @click="emit('navigate', 'system-users')">
         <AppIcon name="users" :size="22" />
         <span><strong>用户与权限</strong><small>{{ userStatus }}</small></span>

+ 1 - 0
src/client/components/app/WorkspaceShell.vue

@@ -27,6 +27,7 @@ type SettingsPage =
   | 'account-mobile'
   | 'appearance'
   | 'system-overview'
+  | 'system-models'
   | 'system-users'
   | 'system-connection'
   | 'system-push'

+ 131 - 0
src/server/hermesAdminRoutes.ts

@@ -0,0 +1,131 @@
+import type Koa from 'koa'
+import type Router from '@koa/router'
+import { HttpError } from './errors.js'
+import type { EmbeddedHermes } from './hermes/embedded.js'
+import type { HermesScope } from './hermes/service.js'
+
+/**
+ * Admin pages that replace the old Hermes Dashboard (9119): provider keys, account logins and
+ * auxiliary models. Everything is answered by the embedded `hermes_service.py` of the selected
+ * Profile home; nothing here reaches another process over the network.
+ */
+export interface HermesAdminDependencies {
+  auth: { requireAdmin(ctx: Koa.Context): unknown }
+  hermes?: EmbeddedHermes
+}
+
+const PROFILE = /^[a-z0-9][a-z0-9_-]{0,63}$/
+const ENV_KEY = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/
+const PROVIDER = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/
+const TASK = /^(?:__reset__|[a-z0-9][a-z0-9_.-]{0,63})$/
+const SESSION = /^[A-Za-z0-9_-]{1,256}$/
+/** Messaging-channel credentials belong to channel integrations Yaoyao does not ship. */
+const HIDDEN_CATEGORIES = new Set(['messaging'])
+
+function input(ctx: Koa.Context): Record<string, unknown> {
+  const value = (ctx.request as Koa.Request & { body?: unknown }).body
+  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}
+}
+
+function text(value: unknown, field: string, pattern?: RegExp, max = 256): string {
+  const result = typeof value === 'string' ? value.trim() : ''
+  if (!result || result.length > max || (pattern && !pattern.test(result))) throw new HttpError(400, `${field} 无效`, 'invalid_hermes_setting')
+  return result
+}
+
+function scopeOf(raw: unknown): HermesScope {
+  const profile = typeof raw === 'string' && raw.trim() ? raw.trim() : 'default'
+  if (profile === 'default') return 'system'
+  if (!PROFILE.test(profile)) throw new HttpError(400, 'Profile 名称无效', 'invalid_profile')
+  return { profile }
+}
+
+export function registerHermesAdminRoutes(router: Router, dependencies: HermesAdminDependencies): void {
+  const call = async <T = unknown>(ctx: Koa.Context, profile: unknown, op: string, args: Record<string, unknown> = {}, options: { timeoutMs?: number; hold?: boolean } = {}): Promise<T> => {
+    dependencies.auth.requireAdmin(ctx)
+    const hermes = dependencies.hermes
+    if (!hermes) throw new HttpError(503, '内置 Hermes 尚未就绪', 'hermes_unavailable')
+    return hermes.pool.call<T>(scopeOf(profile), op, args, { timeoutMs: options.timeoutMs ?? 60_000, ...(options.hold ? { hold: true } : {}) })
+  }
+  const profileQuery = (ctx: Koa.Context) => ctx.query.profile
+
+  router.get('/api/app/admin/hermes/credentials', async (ctx) => {
+    const rows = await call<Record<string, Record<string, unknown>>>(ctx, profileQuery(ctx), 'env.list')
+    const variables = Object.entries(rows ?? {})
+      .filter(([, row]) => !row.channel_managed && !HIDDEN_CATEGORIES.has(String(row.category ?? '')))
+      .map(([key, row]) => ({
+        key,
+        isSet: row.is_set === true,
+        preview: typeof row.redacted_value === 'string' ? row.redacted_value : null,
+        description: typeof row.description === 'string' ? row.description : '',
+        url: typeof row.url === 'string' ? row.url : null,
+        category: typeof row.category === 'string' && row.category ? row.category : 'custom',
+        secret: row.is_password === true,
+        // Hermes flags most provider keys as advanced; the provider's own main key is what people need.
+        advanced: row.advanced === true && row.provider_primary !== true,
+        provider: typeof row.provider === 'string' ? row.provider : '',
+        providerLabel: typeof row.provider_label === 'string' ? row.provider_label : '',
+        custom: row.custom === true,
+        readonly: row.readonly === true,
+      }))
+    ctx.body = { variables }
+  })
+  router.put('/api/app/admin/hermes/credentials', async (ctx) => {
+    const request = input(ctx)
+    const key = text(request.key, '变量名', ENV_KEY)
+    if (typeof request.value !== 'string' || !request.value.trim() || request.value.length > 16_384) throw new HttpError(400, '请填写变量值', 'invalid_hermes_setting')
+    await call(ctx, request.profile, 'env.set', { key, value: request.value.trim() })
+    ctx.body = { ok: true }
+  })
+  router.delete('/api/app/admin/hermes/credentials', async (ctx) => {
+    const request = input(ctx)
+    await call(ctx, request.profile, 'env.delete', { key: text(request.key, '变量名', ENV_KEY) })
+    ctx.body = { ok: true }
+  })
+
+  /** Auxiliary slots plus every Hermes provider, so a slot can be pinned even before its model list loads. */
+  const auxiliary = async (ctx: Koa.Context, profile: unknown) => {
+    const [value, catalog] = await Promise.all([
+      call<Record<string, unknown>>(ctx, profile, 'model.auxiliary'),
+      call<{ providers?: Array<{ id?: unknown; label?: unknown }> }>(ctx, profile, 'providers.catalog').catch(() => ({ providers: [] })),
+    ])
+    const providers = (catalog.providers ?? []).flatMap(item => typeof item.id === 'string' && item.id ? [{ id: item.id, label: typeof item.label === 'string' && item.label ? item.label : item.id }] : [])
+    return { ...value, providers }
+  }
+  router.get('/api/app/admin/hermes/auxiliary', async (ctx) => {
+    ctx.body = await auxiliary(ctx, profileQuery(ctx))
+  })
+  router.put('/api/app/admin/hermes/auxiliary', async (ctx) => {
+    const request = input(ctx)
+    const task = typeof request.task === 'string' ? request.task.trim() : ''
+    if (task && !TASK.test(task)) throw new HttpError(400, '辅助任务无效', 'invalid_hermes_setting')
+    const provider = task === '__reset__' ? 'auto' : text(request.provider, 'Provider', PROVIDER)
+    const model = task === '__reset__' || provider === 'auto' ? '' : text(request.model, '模型', undefined, 256)
+    await call(ctx, request.profile, 'model.set', { scope: 'auxiliary', task, provider, model })
+    ctx.body = await auxiliary(ctx, request.profile)
+  })
+
+  router.get('/api/app/admin/hermes/oauth', async (ctx) => {
+    ctx.body = await call(ctx, profileQuery(ctx), 'oauth.list')
+  })
+  router.post('/api/app/admin/hermes/oauth/:provider/start', async (ctx) => {
+    const provider = text(ctx.params.provider, 'Provider', PROVIDER)
+    ctx.body = await call(ctx, input(ctx).profile, 'oauth.start', { provider }, { timeoutMs: 60_000, hold: true })
+  })
+  router.post('/api/app/admin/hermes/oauth/:provider/poll', async (ctx) => {
+    const request = input(ctx)
+    ctx.body = await call(ctx, request.profile, 'oauth.poll', { provider: text(ctx.params.provider, 'Provider', PROVIDER), sessionId: text(request.sessionId, '登录会话', SESSION) })
+  })
+  router.post('/api/app/admin/hermes/oauth/:provider/cancel', async (ctx) => {
+    const request = input(ctx)
+    ctx.body = await call(ctx, request.profile, 'oauth.cancel', { provider: text(ctx.params.provider, 'Provider', PROVIDER), sessionId: text(request.sessionId, '登录会话', SESSION) })
+  })
+  router.post('/api/app/admin/hermes/oauth/:provider/token', async (ctx) => {
+    const request = input(ctx)
+    if (typeof request.token !== 'string' || !request.token.trim() || request.token.length > 16_384) throw new HttpError(400, '请粘贴凭据', 'invalid_hermes_setting')
+    ctx.body = await call(ctx, request.profile, 'oauth.submit', { provider: text(ctx.params.provider, 'Provider', PROVIDER), token: request.token.trim() })
+  })
+  router.delete('/api/app/admin/hermes/oauth/:provider', async (ctx) => {
+    ctx.body = await call(ctx, input(ctx).profile, 'oauth.disconnect', { provider: text(ctx.params.provider, 'Provider', PROVIDER) }) ?? { ok: true }
+  })
+}

+ 2 - 0
src/server/routes.ts

@@ -18,6 +18,7 @@ import type { ServerConfig } from './config.js'
 import { isLoopbackHost, isLoopbackUpstream, isPrivateHost } from './config.js'
 import { HttpError } from './errors.js'
 import { kernelPaths, requireKernel } from './hermes/paths.js'
+import { registerHermesAdminRoutes } from './hermesAdminRoutes.js'
 import { compareReleaseVersions } from './releases.js'
 import {
   bearerToken,
@@ -1059,6 +1060,7 @@ export function createApiRouter(dependencies: RouteDependencies): Router {
       method: 'DELETE', search: searchFrom(ctx, ['profile']),
     })
   })
+  registerHermesAdminRoutes(router, dependencies)
   router.get('/api/app/admin/legacy-model-services', async (ctx) => {
     dependencies.auth.requireAdmin(ctx)
     await withJar(ctx, async (jar) => {

+ 69 - 0
tests/client/hermesModelSettingsPanel.test.ts

@@ -0,0 +1,69 @@
+import { flushPromises, mount } from '@vue/test-utils'
+import { describe, expect, it, vi } from 'vitest'
+import HermesModelSettingsPanel from '@/components/app/HermesModelSettingsPanel.vue'
+
+const api = vi.hoisted(() => ({
+  listHermesCredentials: vi.fn(async () => [
+    { key: 'OPENROUTER_API_KEY', isSet: false, preview: null, description: 'OpenRouter API key', url: null, category: 'provider', secret: true, advanced: false, provider: 'openrouter', providerLabel: 'OpenRouter', custom: false, readonly: false },
+    { key: 'HIDDEN_ADVANCED', isSet: false, preview: null, description: '', url: null, category: 'setting', secret: false, advanced: true, provider: '', providerLabel: '', custom: false, readonly: false },
+  ]),
+  saveHermesCredential: vi.fn(async () => undefined),
+  deleteHermesCredential: vi.fn(async () => undefined),
+  getAuxiliaryModels: vi.fn(async () => ({ tasks: [{ task: 'vision', provider: 'auto', model: '' }], main: { provider: 'openrouter', model: 'm1' } })),
+  setAuxiliaryModel: vi.fn(async (_p: string, task: string, provider: string, model: string) => ({ tasks: [{ task, provider, model }], main: {} })),
+  listOAuthProviders: vi.fn(async () => [{ id: 'nous', name: 'Nous Portal', flow: 'device_code', status: { logged_in: false } }]),
+  startOAuth: vi.fn(async () => ({ session_id: 's1', user_code: 'ABCD-1234', verification_url: 'https://example.test/device' })),
+  pollOAuth: vi.fn(async () => ({ session_id: 's1', status: 'pending' })),
+  cancelOAuth: vi.fn(async () => undefined),
+  submitOAuthToken: vi.fn(async () => undefined),
+  disconnectOAuth: vi.fn(async () => undefined),
+}))
+vi.mock('@/api/hermesAdmin', () => api)
+vi.mock('@/api/agentManagement', () => ({ listModelCatalog: vi.fn(async () => [{ slug: 'openrouter', name: 'OpenRouter', models: ['m1', 'm2'], isCurrent: true }]) }))
+
+const stubs = { global: { stubs: { ModelServicesPanel: { template: '<div class="model-services-stub" />' } } } }
+const tab = (wrapper: ReturnType<typeof mount>, label: string) => wrapper.findAll('[role=tab]').find(item => item.text() === label)!.trigger('click')
+
+describe('HermesModelSettingsPanel', () => {
+  it('starts on providers and models', () => {
+    const wrapper = mount(HermesModelSettingsPanel, stubs)
+    expect(wrapper.find('.model-services-stub').exists()).toBe(true)
+    wrapper.unmount()
+  })
+
+  it('saves an API key and hides advanced variables until requested', async () => {
+    const wrapper = mount(HermesModelSettingsPanel, stubs)
+    await tab(wrapper, '密钥与变量'); await flushPromises()
+    expect(wrapper.text()).toContain('OPENROUTER_API_KEY')
+    expect(wrapper.text()).not.toContain('HIDDEN_ADVANCED')
+    await wrapper.findAll('button').find(button => button.text() === '设置')!.trigger('click')
+    await wrapper.find('.flow-box input').setValue('sk-test')
+    await wrapper.find('.flow-box').trigger('submit'); await flushPromises()
+    expect(api.saveHermesCredential).toHaveBeenCalledWith('default', 'OPENROUTER_API_KEY', 'sk-test')
+    await wrapper.find('.check input').setValue(true)
+    expect(wrapper.text()).toContain('HIDDEN_ADVANCED')
+    wrapper.unmount()
+  })
+
+  it('assigns an auxiliary model', async () => {
+    const wrapper = mount(HermesModelSettingsPanel, stubs)
+    await tab(wrapper, '辅助模型'); await flushPromises()
+    expect(wrapper.text()).toContain('视觉识别')
+    await wrapper.find('select[aria-label="视觉识别 Provider"]').setValue('openrouter')
+    await wrapper.find('input[aria-label="视觉识别 模型"]').setValue('m2')
+    await wrapper.findAll('button').find(button => button.text() === '保存')!.trigger('click'); await flushPromises()
+    expect(api.setAuxiliaryModel).toHaveBeenCalledWith('default', 'vision', 'openrouter', 'm2')
+    wrapper.unmount()
+  })
+
+  it('shows the device code for an OAuth login', async () => {
+    const wrapper = mount(HermesModelSettingsPanel, stubs)
+    await tab(wrapper, '账号登录'); await flushPromises()
+    await wrapper.findAll('button').find(button => button.text() === '登录')!.trigger('click'); await flushPromises()
+    expect(api.startOAuth).toHaveBeenCalledWith('default', 'nous')
+    expect(wrapper.find('.user-code').text()).toBe('ABCD-1234')
+    await wrapper.findAll('button').find(button => button.text() === '取消')!.trigger('click')
+    expect(api.cancelOAuth).toHaveBeenCalledWith('default', 'nous', 's1')
+    wrapper.unmount()
+  })
+})

+ 82 - 0
tests/server/hermesAdminRoutes.test.ts

@@ -0,0 +1,82 @@
+import Koa from 'koa'
+import Router from '@koa/router'
+import { bodyParser } from '@koa/bodyparser'
+import request from 'supertest'
+import { describe, expect, it, vi } from 'vitest'
+import { HttpError } from '../../src/server/errors.js'
+import { registerHermesAdminRoutes } from '../../src/server/hermesAdminRoutes.js'
+
+function fixture(admin = true) {
+  const call = vi.fn(async (_scope: unknown, op: string, _args?: Record<string, unknown>) => {
+    if (op === 'env.list') return {
+      OPENROUTER_API_KEY: { is_set: true, redacted_value: 'sk-…abcd', description: 'OpenRouter', url: 'https://openrouter.ai/keys', category: 'provider', is_password: true, advanced: false, provider: 'openrouter', provider_label: 'OpenRouter', custom: false, readonly: false },
+      TELEGRAM_BOT_TOKEN: { is_set: false, category: 'messaging', is_password: true },
+      SLACK_TOKEN: { is_set: false, category: 'tool', channel_managed: true },
+    }
+    if (op === 'model.auxiliary') return { tasks: [{ task: 'vision', provider: 'auto', model: '' }], main: { provider: 'openrouter', model: 'x' } }
+    if (op === 'providers.catalog') return { providers: [{ id: 'openrouter', label: 'OpenRouter' }, { id: '' }] }
+    return { ok: true }
+  })
+  const app = new Koa()
+  app.use(async (ctx, next) => { try { await next() } catch (error) { ctx.status = error instanceof HttpError ? error.status : 500; ctx.body = { error: (error as Error).message } } })
+  app.use(bodyParser({ parsedMethods: ['POST', 'PUT', 'PATCH', 'DELETE'] }))
+  const router = new Router()
+  registerHermesAdminRoutes(router, {
+    auth: { requireAdmin: () => { if (!admin) throw new HttpError(403, 'forbidden') } },
+    hermes: { pool: { call } } as never,
+  })
+  app.use(router.routes())
+  return { server: app.callback(), call }
+}
+
+describe('Hermes admin routes', () => {
+  it('lists credentials without messaging or channel-managed variables', async () => {
+    const { server, call } = fixture()
+    const response = await request(server).get('/api/app/admin/hermes/credentials?profile=writer').expect(200)
+    expect(response.body.variables.map((row: { key: string }) => row.key)).toEqual(['OPENROUTER_API_KEY'])
+    expect(response.body.variables[0]).toMatchObject({ isSet: true, preview: 'sk-…abcd', secret: true, providerLabel: 'OpenRouter' })
+    expect(call).toHaveBeenCalledWith({ profile: 'writer' }, 'env.list', {}, expect.anything())
+  })
+
+  it('saves and deletes variables on the system home by default', async () => {
+    const { server, call } = fixture()
+    await request(server).put('/api/app/admin/hermes/credentials').send({ key: 'OPENROUTER_API_KEY', value: ' sk-1 ' }).expect(200)
+    expect(call).toHaveBeenLastCalledWith('system', 'env.set', { key: 'OPENROUTER_API_KEY', value: 'sk-1' }, expect.anything())
+    await request(server).delete('/api/app/admin/hermes/credentials').send({ key: 'OPENROUTER_API_KEY' }).expect(200)
+    expect(call).toHaveBeenLastCalledWith('system', 'env.delete', { key: 'OPENROUTER_API_KEY' }, expect.anything())
+    await request(server).put('/api/app/admin/hermes/credentials').send({ key: 'bad key', value: 'x' }).expect(400)
+    await request(server).put('/api/app/admin/hermes/credentials').send({ key: 'A', value: ' ' }).expect(400)
+  })
+
+  it('assigns auxiliary models and resets them to auto', async () => {
+    const { server, call } = fixture()
+    const response = await request(server).put('/api/app/admin/hermes/auxiliary').send({ task: 'vision', provider: 'openrouter', model: 'gpt-x' }).expect(200)
+    expect(call).toHaveBeenCalledWith('system', 'model.set', { scope: 'auxiliary', task: 'vision', provider: 'openrouter', model: 'gpt-x' }, expect.anything())
+    expect(response.body.tasks[0].task).toBe('vision')
+    expect(response.body.providers).toEqual([{ id: 'openrouter', label: 'OpenRouter' }])
+    await request(server).put('/api/app/admin/hermes/auxiliary').send({ task: '__reset__' }).expect(200)
+    expect(call).toHaveBeenCalledWith('system', 'model.set', { scope: 'auxiliary', task: '__reset__', provider: 'auto', model: '' }, expect.anything())
+    await request(server).put('/api/app/admin/hermes/auxiliary').send({ task: 'vision', provider: 'openrouter' }).expect(400)
+  })
+
+  it('runs OAuth sign-in with a held service process', async () => {
+    const { server, call } = fixture()
+    await request(server).post('/api/app/admin/hermes/oauth/nous/start').send({}).expect(200)
+    expect(call).toHaveBeenLastCalledWith('system', 'oauth.start', { provider: 'nous' }, expect.objectContaining({ hold: true }))
+    await request(server).post('/api/app/admin/hermes/oauth/nous/poll').send({ sessionId: 'abc' }).expect(200)
+    expect(call).toHaveBeenLastCalledWith('system', 'oauth.poll', { provider: 'nous', sessionId: 'abc' }, expect.anything())
+    await request(server).post('/api/app/admin/hermes/oauth/anthropic/token').send({ token: 'sk-ant' }).expect(200)
+    expect(call).toHaveBeenLastCalledWith('system', 'oauth.submit', { provider: 'anthropic', token: 'sk-ant' }, expect.anything())
+    await request(server).delete('/api/app/admin/hermes/oauth/nous').send({}).expect(200)
+    expect(call).toHaveBeenLastCalledWith('system', 'oauth.disconnect', { provider: 'nous' }, expect.anything())
+  })
+
+  it('rejects non-admins and invalid profiles before reaching Hermes', async () => {
+    const denied = fixture(false)
+    await request(denied.server).get('/api/app/admin/hermes/credentials').expect(403)
+    expect(denied.call).not.toHaveBeenCalled()
+    const { server, call } = fixture()
+    await request(server).get('/api/app/admin/hermes/auxiliary?profile=../x').expect(400)
+    expect(call).not.toHaveBeenCalled()
+  })
+})