agentworkshop 0.7.39 → 0.7.41

package/app/composables/useResponsive.ts

@@ -0,0 +1,88 @@
+/**
+ * 视口断点(browser-only,SSR 安全) —— 全站响应式布局的唯一判据。
+ *
+ * 为什么需要它:CSS 媒体查询能改样式,但改不了**行为**——
+ * 窄屏的侧栏不是"收窄的侧栏",而是一个抽屉(开合状态、焦点陷阱、滚动锁定
+ * 都是行为)。行为必须由 JS 知道当前处于哪一档。
+ *
+ * 断点值与 main.css v5 响应式层注释一一对应(那里是数值的唯一出处):
+ *   ≥1024 桌面 / 900–1023 图标轨 / 640–899 抽屉 / <640 单列
+ *
+ * SSR 期间一律返回桌面档:服务端没有视口,猜一个"手机"会让桌面首帧闪一下抽屉。
+ * 首帧由 CSS 媒体查询兜住布局,客户端挂载后再由本 composable 接管行为。
+ */
+import { onBeforeUnmount, onMounted, ref } from 'vue'
+
+export type ViewportTier = 'desktop' | 'compact' | 'tablet' | 'mobile'
+
+/** 断点常量(唯一出处见 main.css v5 注释) */
+export const BREAKPOINTS = {
+  /** 三栏仪表台下限 */
+  desktop: 1024,
+  /** 抽屉导航阈值 */
+  drawer: 900,
+  /** 单列阈值 */
+  single: 640,
+} as const
+
+const width = ref(0)
+let listeners = 0
+let onResize: (() => void) | null = null
+
+function ensureListener() {
+  if (typeof window === 'undefined' || onResize) return
+  onResize = () => {
+    width.value = window.innerWidth
+  }
+  window.addEventListener('resize', onResize, { passive: true })
+  window.addEventListener('orientationchange', onResize, { passive: true })
+  width.value = window.innerWidth
+}
+
+function releaseListener() {
+  if (typeof window === 'undefined' || !onResize) return
+  window.removeEventListener('resize', onResize)
+  window.removeEventListener('orientationchange', onResize)
+  onResize = null
+}
+
+export function useResponsive() {
+  // 客户端 setup 期就取一次真实视口:不能只等 onMounted ——
+  // 依赖方(侧栏/顶栏)的判断会在首帧就求值,晚一拍就会渲染出桌面结构再翻转。
+  if (typeof window !== 'undefined' && !width.value) {
+    width.value = window.innerWidth
+  }
+
+  onMounted(() => {
+    listeners += 1
+    ensureListener()
+  })
+  onBeforeUnmount(() => {
+    listeners = Math.max(0, listeners - 1)
+    if (listeners === 0) releaseListener()
+  })
+
+  /** 未挂载(=SSR/首帧)时按桌面档渲染,避免首屏结构抖动 */
+  const w = computed(() => (width.value || 1440))
+
+  const isMobile = computed(() => w.value < BREAKPOINTS.single)
+  const isDrawer = computed(() => w.value < BREAKPOINTS.drawer)
+  const isTablet = computed(() => w.value >= BREAKPOINTS.drawer && w.value < BREAKPOINTS.desktop)
+  const isDesktop = computed(() => w.value >= BREAKPOINTS.desktop)
+
+  const tier = computed<ViewportTier>(() => {
+    if (isDrawer.value) return isMobile.value ? 'mobile' : 'compact'
+    if (isTablet.value) return 'tablet'
+    return 'desktop'
+  })
+
+  // 把当前档位镜像到 <html data-vp-tier>:E2E 与视觉走查脚本据此断言,
+  // 不必反推"这一屏到底该不该有抽屉"。
+  if (import.meta.client) {
+    watchEffect(() => {
+      document.documentElement.dataset.vpTier = tier.value
+    })
+  }
+
+  return { width: w, tier, isMobile, isTablet, isDesktop, isDrawer }
+}

package/app/composables/useRouteMeta.ts

@@ -28,6 +28,9 @@ export function useRouteMeta() {
     '/tokens': { key: 'menu.tokens', icon: 'i-tabler-key' },
     '/daq': { key: 'menu.daq', icon: 'i-tabler-activity' },
     '/dcw': { key: 'menu.dcw', icon: 'i-tabler-settings-automation' },
+    // ⚠️ 漏了这条时 /aml 会落到 slug 兜底,顶栏标题显示成「Aml」—— 实测破相。
+    // 新增路由必须同时登记进这张表,否则标题就是"路径首字母大写"。
+    '/aml': { key: 'menu.aml', icon: 'i-tabler-flask' },
     '/logs': { key: 'menu.logs', icon: 'i-tabler-list-details' },
     '/permissions': { key: 'menu.permissions', icon: 'i-tabler-shield-lock' },
     '/plugins': { key: 'menu.plugins', icon: 'i-tabler-puzzle' },

package/app/composables/workshop/useDaqStream.ts

@@ -10,7 +10,7 @@ import { reactive } from 'vue'
 import { useTownBus } from './useTownBus'
 import { apiFetch } from './apiClient'
 import type { AepEnvelope } from '#shared/workshop-protocol'
-import { DAQ_TEMPLATES, type AepDaqControllerState, type AepDaqFrame, type AepDaqReading, type AepDaqNodeChange, type AepDaqTemplateChange, type DaqNodeView, type DaqTemplateDef, type DaqTemplateInput } from '#shared/daq-protocol'
+import { DAQ_TEMPLATES, DAQ_DRIVERS, type AepDaqControllerState, type AepDaqFrame, type AepDaqReading, type AepDaqNodeChange, type AepDaqTemplateChange, type DaqDriverCatalogEntry, type DaqNodeView, type DaqTemplateDef, type DaqTemplateInput } from '#shared/daq-protocol'
 
 /** 历史缓冲长度(1s 默认周期 ≈ 最近 5 分钟趋势) */
 const HIST_CAP = 60
@@ -57,7 +57,8 @@ interface DaqControllerState {
 interface DaqBackendMeta {
   tsdb: string
   queue: string
-  drivers: Array<{ kind: string, label: string, status: 'builtin' | 'planned' | 'real' }>
+  /** 驱动目录(REST `drivers` 权威收敛:内置 + 协议插件自描述;首帧先用内置目录) */
+  drivers: DaqDriverCatalogEntry[]
   produced: number
   consumed: number
   dropped: number
@@ -110,7 +111,7 @@ const createStore = () => {
   const alarms = reactive<DaqAlarmRow[]>([]) // S5:未确认报警(轮询 + ack 后刷新)
   const controller = reactive<DaqControllerState>({ running: true, defaultIntervalMs: 1000, defaultPublishIntervalMs: 0, queryDisplayIntervalMs: 5000, nodesTotal: 0, nodesOnline: 0 })
   const meta = reactive<DaqBackendMeta>({
-    tsdb: '…', queue: '…', drivers: [], driverAvailable: {},
+    tsdb: '…', queue: '…', drivers: DAQ_DRIVERS.map(d => ({ kind: d.kind, label: d.label, status: d.status, configFields: d.configFields })), driverAvailable: {},
     infra: undefined,
     produced: 0, consumed: 0, dropped: 0, samplesStored: 0,
   })
@@ -266,7 +267,7 @@ const createStore = () => {
 
   async function load(): Promise<void> {
     try {
-      const data = await api<{ controller: DaqControllerState, nodes: DaqNodeView[], meta: DaqBackendMeta, driverAvailable?: Record<string, boolean>, infra?: DaqInfraState, templates?: DaqTemplateDef[] }>('')
+      const data = await api<{ controller: DaqControllerState, nodes: DaqNodeView[], meta: DaqBackendMeta, driverAvailable?: Record<string, boolean>, drivers?: DaqDriverCatalogEntry[], infra?: DaqInfraState, templates?: DaqTemplateDef[] }>('')
       // 快照合并:hist 是客户端读数流资产,轮询重载不得清零;
       // 已有节点就地 assign(保留对象身份 → Vue 只补丁变化字段,不触发整表数组级失效),hist 自然保留
       const prev = new Map(nodes.map(n => [n.id, n]))
@@ -291,6 +292,8 @@ const createStore = () => {
       Object.assign(controller, data.controller)
       Object.assign(meta, data.meta ?? {})
       meta.driverAvailable = data.driverAvailable ?? {}
+      // 驱动目录 server 权威(含协议插件);server 未下发(旧版)时保留内置目录
+      if (data.drivers?.length) meta.drivers = data.drivers
       meta.infra = data.infra
       if (data.templates?.length) applyTemplates(data.templates)
       store.loaded = true

package/app/composables/workshop/useDcwStream.ts

@@ -8,7 +8,8 @@ import { reactive } from 'vue'
 import { useTownBus } from './useTownBus'
 import { apiFetch } from './apiClient'
 import type { AepEnvelope } from '#shared/workshop-protocol'
-import { DCW_TEMPLATES, type AepDcwControllerState, type AepDcwNodeChange, type AepDcwRead, type AepDcwWritten, type DcwNodeView, type DcwParamLedger, type DcwTemplateDef, type DcwTemplateInput, type LineInput, type LineQueryOpts, type LineQueryResult, type LineRunState, type LineView, type OptimizationRecord, type OptimizationVerdict, type ProductInput, type ProductView, type RecipeInput, type RecipeRunView, type RecipeView, type RecipeRunData } from '#shared/dcw-protocol'
+import { DCW_TEMPLATES, DCW_DRIVERS, type AepDcwControllerState, type AepDcwNodeChange, type AepDcwRead, type AepDcwWritten, type DcwNodeView, type DcwParamLedger, type DcwTemplateDef, type DcwTemplateInput, type LineInput, type LineQueryOpts, type LineQueryResult, type LineRunState, type LineView, type OptimizationRecord, type OptimizationVerdict, type ProductInput, type ProductView, type RecipeInput, type RecipeParam, type RecipeRunView, type RecipeView, type RecipeRunData } from '#shared/dcw-protocol'
+import type { DaqDriverCatalogEntry } from '#shared/daq-protocol'
 
 export type { DcwNodeView }
 
@@ -35,6 +36,8 @@ function createStore() {
   const lineStates = reactive<Record<string, LineRunState>>({})
   /** Agent 优化记录(调控闭环;dcw.optimization.changed 实时收敛) */
   const optimizations = reactive<OptimizationRecord[]>([])
+  /** 写驱动目录(REST `drivers` 权威:内置 + 协议插件自描述;首帧先用内置目录) */
+  const driverCatalog = reactive<DaqDriverCatalogEntry[]>(DCW_DRIVERS.map(d => ({ kind: d.kind, label: d.label, status: d.status, configFields: d.configFields })))
 
   function upsert(node: DcwNodeView): void {
     const i = nodes.findIndex(x => x.id === node.id)
@@ -112,12 +115,14 @@ function createStore() {
 
   async function load(): Promise<void> {
     try {
-      const data = await api<{ controller: AepDcwControllerState, nodes: DcwNodeView[], templates?: DcwTemplateDef[], recipes?: RecipeView[], runs?: RecipeRunView[], history?: DcwWriteHistoryEntry[], products?: ProductView[], lines?: LineView[], lineStates?: LineRunState[] }>('')
+      const data = await api<{ controller: AepDcwControllerState, nodes: DcwNodeView[], templates?: DcwTemplateDef[], drivers?: DaqDriverCatalogEntry[], recipes?: RecipeView[], runs?: RecipeRunView[], history?: DcwWriteHistoryEntry[], products?: ProductView[], lines?: LineView[], lineStates?: LineRunState[] }>('')
       nodes.splice(0, nodes.length, ...data.nodes)
       nodeIndex.clear()
       for (const n of nodes) nodeIndex.set(n.id, n)
       Object.assign(controller, data.controller)
       if (data.templates?.length) templates.splice(0, templates.length, ...data.templates.map(t => ({ ...t })))
+      // 写驱动目录 server 权威(含协议插件);server 未下发(旧版)时保留内置目录
+      if (data.drivers?.length) driverCatalog.splice(0, driverCatalog.length, ...data.drivers)
       recipes.splice(0, recipes.length, ...(data.recipes ?? []))
       runs.splice(0, runs.length, ...(data.runs ?? []))
       history.splice(0, history.length, ...(data.history ?? []))
@@ -144,6 +149,7 @@ function createStore() {
     lines,
     lineStates,
     optimizations,
+    driverCatalog,
     loaded: false,
     error: '',
     ensureWsFeed,

package/app/composables/workshop/useVisibleInterval.ts

@@ -13,9 +13,9 @@ export function useVisibleInterval(
   const bgMs = opts.bgMs === undefined ? ms * 3 : opts.bgMs
   let timer: ReturnType<typeof setInterval> | null = null
 
-  function start(interval: number): void {
+  function start(interval: number | null): void {
     stop()
-    if (interval > 0) timer = setInterval(fn, interval)
+    if (interval !== null && interval > 0) timer = setInterval(fn, interval)
   }
   function stop(): void {
     if (timer) {

package/app/composables/workshop/useWorkshopApi.ts

@@ -109,7 +109,7 @@ export function useWorkshopApi() {
       http.post<{ data: { channelId: string, leadAgentId?: string, workspace: string } }>('/workshop/channels', body),
     deleteChannel: (id: string) => http.delete<{ data: unknown }>(`/workshop/channels/${id}`),
     /** 修改 Channel 实例设置(场景 prompt / 工作目录热更新;成员运行时自动回收重装配) */
-    patchChannel: (id: string, body: { name?: string, description?: string, scenarioPrompt?: string, workspace?: string, enabled?: number }) =>
+    patchChannel: (id: string, body: { name?: string, description?: string, scenarioPrompt?: string, workspace?: string, enabled?: number, llm?: { provider?: string, model?: string, effort?: string } | null }) =>
       http.request<{ data: ChannelDto }>({ method: 'PATCH', url: `/workshop/channels/${id}`, data: body }),
     // channel agents
     listChannelAgents: (id: string) => http.get<{ data: AgentInfoDto[] }>(`/workshop/channels/${id}/agents`),

package/app/layouts/default.vue

@@ -44,9 +44,25 @@ const site = useSiteConfig()
       >
         <span class="footer-title aw-serif-accent">{{ site.title }}</span>
         <span class="sep">/</span>
-        <span>v{{ site.version }}</span>
-        <span class="sep">/</span>
         <span>mode={{ site.mode }}</span>
+        <!-- 右下角:版本 + 开源地址 + 文档(弱化铭牌,hover 才现交互态) -->
+        <span class="footer-corner">
+          <span>v{{ site.version }}</span>
+          <span class="sep">·</span>
+          <a
+            class="footer-link"
+            href="https://github.com/kingdol666/AgentWorkShop"
+            target="_blank"
+            rel="noopener"
+          >GitHub</a>
+          <span class="sep">·</span>
+          <a
+            class="footer-link"
+            href="https://kingdol666.github.io/AgentWorkShop/"
+            target="_blank"
+            rel="noopener"
+          >Docs</a>
+        </span>
       </a-layout-footer>
     </a-layout>
 
@@ -91,6 +107,7 @@ const site = useSiteConfig()
 
 /* 页脚:mono 铭牌行(固定高度,供 harness 页计算视口高度);壳层玻璃收边 */
 .app-footer {
+  position: relative;
   background: var(--mat-chrome-bg);
   backdrop-filter: var(--vibrancy-chrome);
   border-top: 1px solid var(--glass-line);
@@ -114,4 +131,31 @@ const site = useSiteConfig()
 .footer-title {
   font-size: 13px;
 }
+
+/* 右下角铭牌:版本/开源地址/文档 —— 与中央铭牌同色系弱化,hover 才亮起,不抢视觉 */
+.footer-corner {
+  position: absolute;
+  right: 24px;
+  bottom: 0;
+  display: inline-flex;
+  gap: 8px;
+  align-items: center;
+  height: 100%;
+  color: var(--ink-faint);
+  font-size: 10px;
+  letter-spacing: 0.06em;
+}
+
+.footer-corner .footer-link {
+  color: inherit;
+  text-decoration: none;
+  border-bottom: 1px solid transparent;
+  transition: color 0.15s ease, border-color 0.15s ease;
+}
+
+.footer-corner .footer-link:hover {
+  color: inherit;
+  opacity: 0.85;
+  border-bottom-color: currentColor;
+}
 </style>