agentworkshop 0.7.12 → 0.7.14

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop-prod",
-  "version": "0.7.12",
+  "version": "0.7.14",
   "type": "module",
   "private": true,
   "dependencies": {

package/app/composables/workshop/useWorkshopApi.ts

@@ -33,7 +33,7 @@ export interface AgentInfoDto {
   enabled?: number
 }
 
-/** harness 注册表元信息(GET /workshop/harnesses) */
+/** harness 注册表元信息(GET /workshop/harnesses;含环境可用性探测结果) */
 export interface HarnessMetaDto {
   id: string
   label: string
@@ -46,6 +46,16 @@ export interface HarnessMetaDto {
     contextStats: boolean
     compact: boolean
   }
+  /** 环境探测:引擎可立即使用(进程内引擎恒 true;进程型引擎 = CLI 在 PATH 中) */
+  available?: boolean
+  /** 进程内引擎(无外部 CLI) */
+  inprocess?: boolean
+  /** 进程型引擎声明将拉起的命令 */
+  command?: string | null
+  /** PATH 解析出的可执行文件绝对路径 */
+  resolvedPath?: string | null
+  /** 不可用原因(available=false 时的人话提示) */
+  error?: string | null
 }
 
 export interface TaskDto {

package/app/pages/index.vue

@@ -9,6 +9,7 @@
 import { useDaqStream } from '@/app/composables/workshop/useDaqStream'
 import { useDcwStream } from '@/app/composables/workshop/useDcwStream'
 import { useVisibleInterval } from '@/app/composables/workshop/useVisibleInterval'
+import { useWorkshopApi, type HarnessMetaDto } from '@/app/composables/workshop/useWorkshopApi'
 import AwChart from '@/app/components/AwChart.vue'
 import type { EChartsOption } from 'echarts'
 
@@ -30,13 +31,27 @@ onMounted(() => {
   daq.ensureWsFeed()
   dcw.ensureWsFeed()
   void Promise.all([daq.load(), dcw.load()]).then(() => pushTrend())
+  void loadHarnesses()
   useVisibleInterval(() => {
     void daq.load()
     void dcw.load()
+    void loadHarnesses()
     pushTrend()
   }, 5000, { bgMs: 30000 })
 })
 
+// ---------- Harness 可用性(引擎 CLI 环境探测;服务端 30s 探测缓存,随兜底节拍刷新) ----------
+const api = useWorkshopApi()
+const harnesses = ref<HarnessMetaDto[]>([])
+const loadHarnesses = async (): Promise<void> => {
+  try {
+    const res = await api.listHarnesses()
+    harnesses.value = (res as unknown as { data?: { harnesses?: HarnessMetaDto[] } })?.data?.harnesses ?? []
+  }
+  catch { /* 探测不可得时面板留空,不阻塞大屏 */ }
+}
+const harnessOk = computed(() => harnesses.value.filter(h => h.available !== false).length)
+
 // ---------- KPI ----------
 const linesActive = computed(() => dcw.lines.filter(l => dcw.lineStateOf(l.id).active))
 const daqOnline = computed(() => daq.nodes.filter(n => n.enabled && n.state !== 'offline').length)
@@ -351,6 +366,31 @@ const fleetOverflow = computed(() => Math.max(lineCards.value.length - FLEET_CAP
     </div>
 
     <!-- 大屏图阵 -->
+    <!-- 执行引擎可用性(Harness CLI 环境探测;未安装不可选,派工前强校验) -->
+    <section
+      v-if="harnesses.length > 0"
+      class="dpanel harness aw-stagger"
+    >
+      <header class="dp-hd">
+        <h3>{{ t('home.harness.title') }}</h3>
+        <small>{{ t('home.harness.sub') }}</small>
+        <small class="mono fleet-total">{{ harnessOk }}/{{ harnesses.length }}</small>
+      </header>
+      <div class="harness-row">
+        <div
+          v-for="h in harnesses"
+          :key="h.id"
+          class="h-item"
+          :class="{ off: h.available === false }"
+          :title="h.available === false ? (h.error ?? '') : (h.resolvedPath ?? h.command ?? '')"
+        >
+          <span class="h-dot" />
+          <span class="h-name">{{ h.label }}</span>
+          <span class="h-cmd mono">{{ h.available === false ? t('home.harness.missing') : (h.inprocess ? 'in-process' : h.command) }}</span>
+        </div>
+      </div>
+    </section>
+
     <div class="grid aw-stagger">
       <section class="dpanel span8">
         <header class="dp-hd">
@@ -790,6 +830,38 @@ const fleetOverflow = computed(() => Math.max(lineCards.value.length - FLEET_CAP
   font-size: 11px;
   color: var(--ink-faint);
 }
+/* ---------- Harness 可用性条:墨色药丸式引擎清单,未安装灰化 ---------- */
+.harness-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  padding: 4px 0 6px;
+}
+.h-item {
+  display: flex;
+  gap: 7px;
+  align-items: center;
+  padding: 5px 12px;
+  font-size: 11.5px;
+  cursor: default;
+  background: color-mix(in srgb, var(--ink) 3%, transparent);
+  border: 1px solid var(--divider-hair);
+  border-radius: var(--radius-pill);
+  transition: border-color 0.15s, background 0.15s;
+}
+.h-item:hover { border-color: var(--line-strong); }
+.h-dot {
+  flex: none;
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--tone-success-dot, #4a6b57);
+}
+.h-item.off { opacity: 0.55; }
+.h-item.off .h-dot { background: var(--tone-danger-dot, #c25a4e); }
+.h-name { font-weight: 600; color: var(--ink); }
+.h-item.off .h-name { color: var(--ink-soft); }
+.h-cmd { font-size: 10px; color: var(--ink-faint); }
 /* 全部产线入口:虚线幽灵卡,聚合清单外的余量 */
 .fleet-all {
   display: flex;

package/app/pages/logs/index.vue

@@ -3,7 +3,9 @@
     <!-- 页头:标题 + 手动记录入口 -->
     <header class="head">
       <div>
-        <p class="aw-kicker">agentworkshop / audit log</p>
+        <p class="aw-kicker">
+          agentworkshop / audit log
+        </p>
         <h1 class="h1">
           {{ $t('logs.title') }}
         </h1>

package/app/pages/tokens.vue

@@ -272,7 +272,9 @@ useHead({ title: () => tt('titles.tokens') })
     <template v-else>
       <div class="head">
         <div>
-          <p class="aw-kicker">agentworkshop / api tokens</p>
+          <p class="aw-kicker">
+            agentworkshop / api tokens
+          </p>
           <h2>API Token</h2>
           <p class="sub">
             {{ userStore.user?.name }} · {{ $t('tokens.k1upppaw026') }}

package/app/pages/workshop/agents.vue

@@ -26,7 +26,9 @@ const load = async (): Promise<void> => {
     loading.value = false
   }
 }
-void load()
+// SSR 安全:setup 期 $http(axios)无法在服务端发相对地址请求,拒绝会变成未处理
+// rejection 直杀渲染进程;页面数据一律客户端装载
+if (import.meta.client) void load()
 
 // ===== 过滤(全部/我的/公开/内置;admin 另有"他人私有") =====
 type Filter = 'all' | 'mine' | 'public' | 'builtin' | 'others'
@@ -64,8 +66,10 @@ const visTag = (t: AgentTemplateDto): { text: string, color: string, icon?: stri
   return { text: tt('agents.k447jj019'), color: 'default' }
 }
 
-// ===== harness 选项(引擎注册表动态拉取;失败回退静态表) =====
+// ===== harness 选项(引擎注册表动态拉取,含环境可用性探测;失败回退静态表) =====
 const harnesses = ref<HarnessMetaDto[]>([])
+const harnessById = computed(() => new Map(harnesses.value.map(h => [h.id, h])))
+const isUnavailable = (id: string): boolean => harnessById.value.get(id)?.available === false
 const harnessOptions = computed(() =>
   (harnesses.value.length > 0
     ? harnesses.value
@@ -73,7 +77,10 @@ const harnessOptions = computed(() =>
         { id: 'mock', label: 'mock(测试)', description: '', capabilities: { steer: true, supervise: false, hitl: false, terminal: false, contextStats: false, compact: false } },
         { id: 'omp', label: 'omp(真实 LLM)', description: '', capabilities: { steer: true, supervise: true, hitl: true, terminal: true, contextStats: true, compact: true } },
         { id: 'claude', label: 'claude', description: '', capabilities: { steer: false, supervise: false, hitl: false, terminal: false, contextStats: false, compact: false } },
-      ] as HarnessMetaDto[]).map(h => ({ value: h.id, label: h.label })),
+      ] as HarnessMetaDto[]).map((h) => {
+    const unavailable = h.available === false
+    return { value: h.id, label: unavailable ? `${h.label}(${tt('agents.notInstalled')})` : h.label, disabled: unavailable }
+  }),
 )
 const capBadges = (id: string): string[] => {
   const caps = harnesses.value.find(h => h.id === id)?.capabilities
@@ -93,7 +100,7 @@ const loadHarnesses = async (): Promise<void> => {
   }
   catch { /* 回退静态表 */ }
 }
-void loadHarnesses()
+if (import.meta.client) void loadHarnesses()
 
 const editOpen = ref(false)
 const editing = ref<AgentTemplateDto | null>(null)
@@ -123,6 +130,11 @@ const save = async (): Promise<void> => {
     message.error('config 不是合法 JSON')
     return
   }
+  // 前端兜底:引擎未安装禁止保存(与后端 assertHarnessUsable 同判据)
+  if (isUnavailable(form.harness)) {
+    message.error(harnessById.value.get(form.harness)?.error ?? tt('agents.notInstalled'))
+    return
+  }
   try {
     if (editing.value) {
       await api.updateTemplate(editing.value.id, { name: form.name, harness: form.harness, config, visibility: form.visibility })
@@ -220,8 +232,21 @@ useHead({ title: () => tt('titles.agents') })
       <a-table-column
         title="harness"
         data-index="harness"
-        :width="100"
-      />
+        :width="120"
+      >
+        <template #default="{ record }">
+          <span
+            class="h-cell"
+            :class="{ off: isUnavailable(record.harness) }"
+            :title="isUnavailable(record.harness) ? (harnessById.get(record.harness)?.error ?? '') : (harnessById.get(record.harness)?.resolvedPath ?? '')"
+          >
+            <span class="h-dot" />{{ record.harness }}<span
+              v-if="isUnavailable(record.harness)"
+              class="h-miss"
+            >({{ tt('agents.notInstalled') }})</span>
+          </span>
+        </template>
+      </a-table-column>
       <a-table-column
         :title="$t('agents.k3lrqn0002')"
         :width="120"
@@ -346,6 +371,21 @@ useHead({ title: () => tt('titles.agents') })
             v-model:value="form.harness"
             :options="harnessOptions"
           />
+          <div
+            v-if="harnesses.length > 0"
+            class="harness-status"
+            :class="{ off: isUnavailable(form.harness) }"
+          >
+            <template v-if="isUnavailable(form.harness)">
+              <span class="i-tabler-plug-off" /> {{ harnessById.get(form.harness)?.error }}
+            </template>
+            <template v-else-if="harnessById.get(form.harness)?.inprocess">
+              <span class="i-tabler-plug-connected" /> {{ tt('agents.harnessInprocess') }}
+            </template>
+            <template v-else-if="harnessById.get(form.harness)?.resolvedPath">
+              <span class="i-tabler-plug-connected" /> <span class="mono">{{ harnessById.get(form.harness)?.resolvedPath }}</span>
+            </template>
+          </div>
           <div
             v-if="capBadges(form.harness).length"
             class="harness-caps"
@@ -388,6 +428,31 @@ useHead({ title: () => tt('titles.agents') })
   border-radius: 3px;
   opacity: 0.75;
 }
+.harness-status {
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  margin-top: 6px;
+  font-size: 11px;
+  color: var(--ink-faint);
+}
+.harness-status.off { color: var(--danger, #c25a4e); }
+.h-cell {
+  display: inline-flex;
+  gap: 6px;
+  align-items: center;
+  font-family: var(--font-mono);
+  font-size: 12px;
+}
+.h-dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--ok, #4a6b57);
+}
+.h-cell.off .h-dot { background: var(--danger, #c25a4e); }
+.h-cell.off { opacity: 0.75; }
+.h-miss { color: var(--danger, #c25a4e); font-family: var(--font-sans); font-size: 11px; }
 .page { padding: 4px; }
 .head {
   display: flex;

package/app/pages/workshop/channel-templates.vue

@@ -31,7 +31,8 @@ const load = async (): Promise<void> => {
     loading.value = false
   }
 }
-void load()
+// SSR 安全:setup 期 $http(axios)无法在服务端发相对地址请求(同 agents 页注释)
+if (import.meta.client) void load()
 
 type Filter = 'all' | 'mine' | 'public' | 'builtin'
 const filter = ref<Filter>('all')

package/app/pages/workshop/teams.vue

@@ -31,7 +31,29 @@ const load = async (): Promise<void> => {
     loading.value = false
   }
 }
-void load()
+// SSR 安全:setup 期 $http(axios)无法在服务端发相对地址请求(同 agents 页注释)
+if (import.meta.client) void load()
+
+// ===== harness 可用性(成员选择禁用引擎未安装的模板;deploy 由后端 assert 兜底) =====
+const harnessAvail = ref<Record<string, boolean>>({})
+const loadHarnessAvail = async (): Promise<void> => {
+  try {
+    const res = await api.listHarnesses()
+    const list = (res as unknown as { data?: { harnesses?: Array<{ id: string, available?: boolean }> } })?.data?.harnesses
+    if (Array.isArray(list)) {
+      const m: Record<string, boolean> = {}
+      for (const h of list) m[h.id] = h.available !== false
+      harnessAvail.value = m
+    }
+  }
+  catch { /* 探测不可得时不限制选项(后端仍有强校验) */ }
+}
+if (import.meta.client) void loadHarnessAvail()
+const tplUnavailable = (tpl: AgentTemplateDto): boolean => harnessAvail.value[tpl.harness] === false
+const memberOptions = computed(() => templates.value.map((t) => {
+  const un = tplUnavailable(t)
+  return { value: t.id, label: un ? `${t.name}(${t.harness} · ${t('agents.notInstalled')})` : `${t.name}(${t.harness})`, disabled: un }
+}))
 
 // ===== 过滤 =====
 type Filter = 'all' | 'mine' | 'public' | 'builtin'
@@ -323,7 +345,7 @@ useHead({ title: () => t('titles.teams') })
         <a-form-item :label="$t('teams.k41ds5006')">
           <a-select
             v-model:value="addTemplateId"
-            :options="templates.map(t => ({ value: t.id, label: `${t.name}(${t.harness})` }))"
+            :options="memberOptions"
           />
         </a-form-item>
         <a-form-item :label="$t('teams.k479op007')">

package/app/plugins/http.ts

@@ -52,17 +52,18 @@ export default defineNuxtPlugin((nuxtApp) => {
         catch { /* 无 pinia 上下文(极端时序) */ }
         if (!g.__awShown401) {
           g.__awShown401 = true
-          message.error('登录已过期,请重新登录')
+          // SSR 安全:ant-design message 依赖 DOM,服务端调用会炸掉渲染进程
+          if (import.meta.client) message.error('登录已过期,请重新登录')
           setTimeout(() => {
             g.__awShown401 = false
           }, 3000)
         }
       }
       else if (status >= 500) {
-        message.error('服务器异常，请稍后重试')
+        if (import.meta.client) message.error('服务器异常，请稍后重试')
       }
       else {
-        message.error(msg)
+        if (import.meta.client) message.error(msg)
       }
 
       return Promise.reject(error)

package/i18n/locales/en.ts

@@ -81,6 +81,11 @@ export default {
     fleetAll: 'View all lines',
     fleetHint: 'Running first · top 8 shown',
     writesFailed: 'failed',
+    harness: {
+      title: 'Agent Harnesses',
+      sub: 'CLI availability probe · ready to dispatch',
+      missing: 'not installed',
+    },
     fields: {
       name: 'App Name',
       version: 'Version',
@@ -342,6 +347,8 @@ export default {
     hitlSubmit: 'Submit',
   },
   agents: {
+    notInstalled: 'not installed',
+    harnessInprocess: 'In-process engine · always available',
     k3pa5h4025: 'Templates',
     k3xhia001: 'Name',
     k3lrqn0002: 'Visibility',
@@ -1119,7 +1126,7 @@ export default {
     ke16e53026: '\'s resources (user-isolated; persisted server-side)',
     k41ds5027: 'Template',
     k1ggoa45028: 'Members / Busy',
-    k48h2c001: 'Email',
+    k48h2c001: 'Email or username',
     k3yvgs002: 'Password',
     kwgbai9003: 'Username (unique)',
     kizjkbo004: 'Email (unique)',

package/i18n/locales/zh-CN.ts

@@ -81,6 +81,11 @@ export default {
     fleetAll: '查看全部产线',
     fleetHint: '运行中优先 · 最多展示 8 条',
     writesFailed: '失败',
+    harness: {
+      title: '执行引擎',
+      sub: 'Harness CLI 环境探测 · 就绪即可派工',
+      missing: '未安装',
+    },
     fields: {
       name: '应用名称',
       version: '版本',
@@ -342,6 +347,8 @@ export default {
     hitlSubmit: '提交',
   },
   agents: {
+    notInstalled: '未安装',
+    harnessInprocess: '进程内引擎 · 恒可用',
     k3pa5h4025: '模板库',
     k3xhia001: '名称',
     k3lrqn0002: '可见性',
@@ -1118,7 +1125,7 @@ export default {
     ke16e53026: '的资源(用户级隔离;服务端持久化)',
     k41ds5027: '模板',
     k1ggoa45028: '成员 / 忙',
-    k48h2c001: '邮箱',
+    k48h2c001: '邮箱 / 用户名',
     k3yvgs002: '密码',
     kwgbai9003: '用户名(唯一)',
     kizjkbo004: '邮箱(唯一)',