agentworkshop 0.7.7 → 0.7.8

package/app/pages/workshop/index.vue

@@ -27,6 +27,19 @@ const authPassword = ref('')
 const authTokenInput = ref('')
 const authLoading = ref(false)
 
+// 首启初始化:系统尚无管理员 → 登录门切换为"注册管理员"模式(首个注册账号自动成为 admin)
+const needsSetup = ref(false)
+onMounted(async () => {
+  try {
+    const res = await $fetch<{ code: number, data?: { needsSetup: boolean } }>('/api/users/setup-status')
+    if (res.code === 0 && res.data?.needsSetup) {
+      needsSetup.value = true
+      authTab.value = 'register'
+    }
+  }
+  catch { /* 探测失败按常规登录门呈现 */ }
+})
+
 const doRegister = async (): Promise<void> => {
   if (!authName.value.trim()) {
     message.warning(t('wsHome.k1vnhyks019'))
@@ -43,7 +56,8 @@ const doRegister = async (): Promise<void> => {
   authLoading.value = true
   try {
     const user = await userStore.register(authName.value, authEmail.value, authPassword.value)
-    message.success(t('wsHome.k1mbatbh030', { p0: user.name }))
+    message.success(needsSetup.value ? `管理员账号创建成功:${user.name} 已进入系统` : t('wsHome.k1mbatbh030', { p0: user.name }))
+    needsSetup.value = false
     authName.value = ''
     authEmail.value = ''
     authPassword.value = ''
@@ -64,6 +78,7 @@ const doLogin = async (): Promise<void> => {
   try {
     const user = await userStore.login(authEmail.value, authPassword.value)
     message.success(t('wsHome.kwixbdl031', { p0: user.name }))
+    needsSetup.value = false
     authPassword.value = ''
   }
   catch (e) {
@@ -78,6 +93,7 @@ const doLoginWithToken = async (): Promise<void> => {
   try {
     const user = await userStore.loginWithToken(authTokenInput.value)
     message.success(t('wsHome.kwixbdl031', { p0: user.name }))
+    needsSetup.value = false
     authTokenInput.value = ''
   }
   catch (e) {
@@ -181,13 +197,15 @@ useHead({ title: () => t('titles.workshop') })
         <p class="aw-kicker">
           agentworkshop / sign in
         </p>
-        <h2>{{ $t('wsHome.kr0vzqu008') }}</h2>
+        <h2>{{ needsSetup ? '创建管理员账号' : $t('wsHome.kr0vzqu008') }}</h2>
         <p class="sub">
-          全局用户系统统管身份;每个用户可管理多个 API Token,
-          管理 API 需用户 token(Authorization: Bearer)。
+          {{ needsSetup
+            ? '系统尚无任何用户:首个注册的账号将成为管理员,创建后自动进入系统。'
+            : '全局用户系统统管身份;每个用户可管理多个 API Token,管理 API 需用户 token(Authorization: Bearer)。' }}
         </p>
         <a-tabs v-model:active-key="authTab">
           <a-tab-pane
+            v-if="!needsSetup"
             key="login"
             tab="账号登录"
           >
@@ -221,7 +239,7 @@ useHead({ title: () => t('titles.workshop') })
           </a-tab-pane>
           <a-tab-pane
             key="register"
-            tab="注册新用户"
+            :tab="needsSetup ? '注册管理员' : '注册新用户'"
           >
             <a-space
               direction="vertical"
@@ -247,7 +265,7 @@ useHead({ title: () => t('titles.workshop') })
                 :loading="authLoading"
                 @click="doRegister"
               >
-                {{ $t('wsHome.k1so6a0v011') }}
+                {{ needsSetup ? '创建管理员并进入' : $t('wsHome.k1so6a0v011') }}
               </a-button>
               <p class="hint">
                 {{ $t('wsHome.k1r0a4u3012') }}
@@ -255,6 +273,7 @@ useHead({ title: () => t('titles.workshop') })
             </a-space>
           </a-tab-pane>
           <a-tab-pane
+            v-if="!needsSetup"
             key="token"
             tab="Token 登录"
           >

package/config.yml

@@ -10,7 +10,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.7
+  version: 0.7.8
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）
@@ -70,6 +70,16 @@ daq:
     accessKey: awshop
     secretKey: awshop-secret
     bucket: daq
+  # 采样节拍(live 可调,热重载):节点未显式指定 intervalMs 时的采集周期与可配置下限。
+  # 下限同时钳制 create/patch/存量节点;设置页/`aw config set daq.sampling.*` 均可改。
+  sampling:
+    defaultIntervalMs: 5000   # 默认 5s
+    minIntervalMs: 1000       # 下限 1s(绝对硬底 200ms)
+  # 时序查询节拍(live 可调,热重载):查询未指定 bucketMs 时的降采样桶宽与下限。
+  # samples / 产线数据查询 / Agent daq_query 三处共用;Agent 工具描述实时携带当前值。
+  query:
+    defaultBucketMs: 15000    # 缺省 15s
+    minBucketMs: 1000         # 下限 1s(绝对硬底 100ms)
 
 security:
   # Session cookie 加密密钥（nuxt-auth-utils 使用）

package/i18n/dicts/settings.json

@@ -40,6 +40,10 @@
   "runtime.daq.mqttPassword": "MQTT 密码",
   "runtime.daq.mqttCaFile": "MQTT CA 证书",
   "runtime.daq.mqttRejectUnauthorized": "MQTT 校验证书",
+  "runtime.daq.samplingDefaultIntervalMs": "节点采样默认间隔(ms)",
+  "runtime.daq.samplingMinIntervalMs": "节点采样下限(ms)",
+  "runtime.daq.queryDefaultBucketMs": "时序查询默认间隔(ms)",
+  "runtime.daq.queryMinBucketMs": "时序查询下限(ms)",
   "runtime.daq.tsRetentionH": "标量时序保留(h)",
   "runtime.daq.frameRetentionH": "帧元数据保留(h)",
   "runtime.daq.alarmWebhookUrl": "告警 Webhook",

package/i18n/locales/en.ts

@@ -161,6 +161,10 @@ export default {
     'runtime.daq.mqttPassword': 'MQTT password',
     'runtime.daq.mqttCaFile': 'MQTT CA certificate',
     'runtime.daq.mqttRejectUnauthorized': 'MQTT verify certificate',
+    'runtime.daq.samplingDefaultIntervalMs': 'Default sampling interval (ms)',
+    'runtime.daq.samplingMinIntervalMs': 'Sampling floor (ms)',
+    'runtime.daq.queryDefaultBucketMs': 'Default TS query bucket (ms)',
+    'runtime.daq.queryMinBucketMs': 'TS query floor (ms)',
     'runtime.daq.tsRetentionH': 'Scalar TS retention (h)',
     'runtime.daq.frameRetentionH': 'Frame retention (h)',
     'runtime.daq.alarmWebhookUrl': 'Alarm webhook',

package/i18n/locales/zh-CN.ts

@@ -161,6 +161,10 @@ export default {
     'runtime.daq.mqttPassword': 'MQTT 密码',
     'runtime.daq.mqttCaFile': 'MQTT CA 证书',
     'runtime.daq.mqttRejectUnauthorized': 'MQTT 校验证书',
+    'runtime.daq.samplingDefaultIntervalMs': '节点采样默认间隔(ms)',
+    'runtime.daq.samplingMinIntervalMs': '节点采样下限(ms)',
+    'runtime.daq.queryDefaultBucketMs': '时序查询默认间隔(ms)',
+    'runtime.daq.queryMinBucketMs': '时序查询下限(ms)',
     'runtime.daq.tsRetentionH': '标量时序保留(h)',
     'runtime.daq.frameRetentionH': '帧元数据保留(h)',
     'runtime.daq.alarmWebhookUrl': '告警 Webhook',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "type": "module",
   "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
   "license": "PolyForm-Noncommercial-1.0.0",

package/scripts/_dbg-codex-handshake.ts

@@ -0,0 +1,30 @@
+import { StdioJsonRpcClient } from '../server/services/workshop/agents/adapters/stdio-jsonrpc'
+
+async function main() {
+  const client = new StdioJsonRpcClient({
+    name: 'codex-test',
+    command: 'codex',
+    args: ['app-server'],
+    cwd: process.cwd(),
+    requestTimeoutMs: 20_000,
+  })
+  client.onExit((code) => {
+    console.log('[test] app-server EXIT code=', code)
+    process.exit(1)
+  })
+  await client.start()
+  console.log('[test] spawned pid=', client.pid)
+  const res = await client.request('initialize', { clientInfo: { name: 'aw-probe', title: 'AW', version: '0.0.1' } }, 20_000)
+  console.log('[test] initialize OK, userAgent =', (res as { userAgent?: string }).userAgent)
+  client.notify('initialized', {})
+  const models = await client.request('model/list', {}, 20_000) as { data?: Array<{ model?: string }> }
+  console.log('[test] models:', (models?.data ?? []).map(m => m.model).slice(0, 5).join(','))
+  await new Promise(r => setTimeout(r, 10_000))
+  console.log('[test] alive 10s after handshake')
+  await client.dispose()
+  process.exit(0)
+}
+main().catch((err) => {
+  console.error('[test] FATAL', err?.message ?? err)
+  process.exit(1)
+})

package/scripts/_dbg-codex-sandbox.ts

@@ -0,0 +1,58 @@
+import { StdioJsonRpcClient } from '../server/services/workshop/agents/adapters/stdio-jsonrpc'
+
+async function main() {
+  const client = new StdioJsonRpcClient({
+    name: 'codex-sandbox-test',
+    command: 'codex',
+    args: ['app-server'],
+    cwd: process.cwd(),
+    requestTimeoutMs: 30_000,
+    env: {
+      AW_BASE_URL: 'http://127.0.0.1:3001',
+      AW_MCP_TOOL_TIMEOUT_MS: '200000',
+    },
+  })
+  client.onExit((code) => {
+    console.log('[sbx] EXIT code=', code)
+    process.exit(1)
+  })
+  await client.start()
+  await client.request('initialize', { clientInfo: { name: 'aw-probe', title: 'AW', version: '0.0.1' } }, 30_000)
+  client.notify('initialized', {})
+  const thread = await client.request('thread/start', {
+    model: 'glm-5.3-flash',
+    cwd: process.cwd(),
+    approvalPolicy: 'never',
+    sandbox: 'workspace-write',
+  }, 60_000) as Record<string, unknown>
+  const t0 = Date.now()
+  let completed = false
+  client.onNotification((method, params) => {
+    const p = (params ?? {}) as Record<string, unknown>
+    if (method === 'turn/completed') {
+      const turn = (p.turn ?? {}) as Record<string, unknown>
+      console.log('[sbx] turn/completed status=', turn.status, Math.round((Date.now() - t0) / 1000) + 's')
+      completed = true
+    }
+    else if (method === 'item/agentMessage/delta' && p.delta && !(client as unknown as { _d?: boolean })._d) {
+      ;(client as unknown as { _d?: boolean })._d = true
+      console.log('[sbx] first delta', Math.round((Date.now() - t0) / 1000) + 's')
+    }
+    else if (method === 'error') console.log('[sbx] error:', JSON.stringify(p).slice(0, 160))
+    else if (String(method).startsWith('item/')) console.log('[sbx]', method, Math.round((Date.now() - t0) / 1000) + 's')
+  })
+  const threadObj = (thread?.thread ?? thread) as { id?: string }
+  await client.request('turn/start', {
+    threadId: threadObj?.id,
+    input: [{ type: 'text', text: '直接回答:1+1等于几?一句话即可。' }],
+  }, 60_000)
+  console.log('[sbx] turn/start accepted (workspace-write + AW env)')
+  for (let i = 0; i < 24 && !completed; i++) await new Promise(r => setTimeout(r, 5000))
+  console.log(completed ? '[sbx] PASS' : '[sbx] FAIL: no completion in 120s')
+  await client.dispose()
+  process.exit(completed ? 0 : 1)
+}
+main().catch((err) => {
+  console.error('[sbx] FATAL', err?.message ?? err)
+  process.exit(1)
+})

package/scripts/_dbg-codex-turn.ts

@@ -0,0 +1,65 @@
+import { StdioJsonRpcClient } from '../server/services/workshop/agents/adapters/stdio-jsonrpc'
+
+async function main() {
+  const client = new StdioJsonRpcClient({
+    name: 'codex-turn-test',
+    command: 'codex',
+    args: ['app-server'],
+    cwd: process.cwd(),
+    requestTimeoutMs: 30_000,
+  })
+  client.onExit((code) => {
+    console.log('[turn-test] EXIT code=', code)
+    process.exit(1)
+  })
+  await client.start()
+  await client.request('initialize', { clientInfo: { name: 'aw-probe', title: 'AW', version: '0.0.1' } }, 30_000)
+  client.notify('initialized', {})
+  const thread = await client.request('thread/start', {
+    model: 'glm-5.3-flash',
+    cwd: process.cwd(),
+    approvalPolicy: 'never',
+    sandbox: 'read-only',
+  }, 60_000) as Record<string, unknown>
+  const threadId = thread as { thread?: { id?: string }, id?: string }
+  const tid = threadId?.thread?.id ?? threadId?.id
+  console.log('[turn-test] thread:', String(tid).slice(0, 20))
+  let sawDelta = false
+  let sawCompleted = false
+  client.onNotification((method, params) => {
+    const p = (params ?? {}) as Record<string, unknown>
+    if (method === 'item/agentMessage/delta' && p.delta) {
+      if (!sawDelta) console.log('[turn-test] first delta at', new Date().toLocaleTimeString('zh-CN', { hour12: false }))
+      sawDelta = true
+    }
+    else if (method === 'turn/started') console.log('[turn-test] turn/started', new Date().toLocaleTimeString('zh-CN', { hour12: false }))
+    else if (method === 'thread/tokenUsage/updated') {
+      const u = (p.usage ?? p) as Record<string, unknown>
+      console.log('[turn-test] tokenUsage input=', u.input_tokens ?? u.inputTokens ?? '?')
+    }
+    else if (method === 'turn/completed') {
+      const turn = (p.turn ?? {}) as Record<string, unknown>
+      console.log('[turn-test] turn/completed status=', turn.status, new Date().toLocaleTimeString('zh-CN', { hour12: false }))
+      sawCompleted = true
+    }
+    else if (method === 'error') console.log('[turn-test] error notice:', JSON.stringify(p).slice(0, 160))
+    else if (String(method).includes('item/')) console.log('[turn-test]', method)
+  })
+  const t0 = Date.now()
+  await client.request('turn/start', {
+    threadId: tid,
+    input: [{ type: 'text', text: '直接回答:1+1等于几?一句话即可。' }],
+  }, 60_000)
+  console.log('[turn-test] turn/start accepted')
+  for (let i = 0; i < 40 && !sawCompleted; i++) {
+    await new Promise(r => setTimeout(r, 5000))
+    if (i % 6 === 5) console.log('[turn-test] waiting...', Math.round((Date.now() - t0) / 1000) + 's', 'sawDelta=' + sawDelta)
+  }
+  console.log(sawCompleted ? '[turn-test] PASS: turn completed' : '[turn-test] FAIL: no completion in 200s')
+  await client.dispose()
+  process.exit(sawCompleted ? 0 : 1)
+}
+main().catch((err) => {
+  console.error('[turn-test] FATAL', err?.message ?? err)
+  process.exit(1)
+})

package/scripts/_dbg-interval-config.mjs

@@ -0,0 +1,145 @@
+/**
+ * 间隔配置化 场景测试:daq.sampling.* / daq.query.* 全链路(live 热重载)。
+ *   NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-interval-config.mjs [--base http://127.0.0.1:3001]
+ *
+ * C1 PATCH 设置:daq.sampling.defaultIntervalMs=2000 → controller 状态即时反映(热重载)
+ * C2 下限钳制:daq.sampling.minIntervalMs=2000 → create intervalMs=500 被钳到 2000
+ * C3 恢复:PATCH 回 5000/1000 → 新建节点默认节拍恢复
+ * C4 查询间隔:daq.query.defaultBucketMs=3000 → samples 缺省返回 3000;minBucketMs=800 → 传 500 钳 800
+ * C5 CLI 同源:runtime-settings.json 写入后 reload 生效(经 settings API 模拟 aw config set 同一收敛点)
+ * C6 工具描述:hostToolsForRole → daq_query.bucket_ms 描述携带当前配置值
+ * C7 采样节拍真实生效:default=2000 下,未显式 intervalMs 的节点 8s 采样 ≈4-5 样本(而非 5s 档 ≈2)
+ */
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3001'
+})()
+let failures = 0
+let passed = 0
+const results = []
+const check = (id, name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${id} ${name}${detail ? ` — ${detail}` : ''}`)
+  results.push({ id, name, ok, detail })
+  ok ? passed++ : failures++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const api = async (method, path, { body, token } = {}) => {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+async function main() {
+  console.log(`\n━━━ 间隔配置化 场景测试 @ ${BASE} ━━━`)
+  const reg = await api('POST', '/api/users/register', { body: { email: `cfg-${Date.now().toString(36)}@test.local`, password: 'Passw0rd!123', name: `cfg-${Date.now().toString(36)}` } })
+  const token = reg.data?.token
+  if (!token) throw new Error('注册失败')
+  // 设置修改需 admin:读取种子凭据存档(.AgentWorkShop/data/seed-credentials.txt)
+  const fs = await import('node:fs')
+  let adminToken = token
+  try {
+    const cred = fs.readFileSync('.AgentWorkShop/data/seed-credentials.txt', 'utf-8')
+    const pw = cred.match(/password:\s*(\S+)/)?.[1]
+    const lg = await api('POST', '/api/users/login', { body: { email: 'zhangwei@awshop.io', password: pw } })
+    adminToken = lg.data?.token ?? token
+    console.log(`  [setup] admin 登录: ${lg.data?.token ? 'ok' : '失败(回退 user token)'}`)
+  }
+  catch {
+    console.log('  [setup] 无种子凭据存档,回退 user token')
+  }
+
+  // ── C1 采样默认间隔 live 调节 ──
+  const p1 = await api('PATCH', '/api/system/settings', { body: { 'daq.sampling.defaultIntervalMs': 2000, 'daq.sampling.minIntervalMs': 2000 }, token: adminToken })
+  check('C1.1', 'PATCH daq.sampling.*(2000/2000) 接受', p1.status === 200 && p1.code === 0, JSON.stringify(p1.message ?? '').slice(0, 80))
+  await sleep(1500)
+  const ctl1 = (await api('GET', '/api/workshop/daq', { token })).data?.controller
+  check('C1.2', 'controller.defaultIntervalMs 热重载=2000', ctl1?.defaultIntervalMs === 2000, `value=${ctl1?.defaultIntervalMs} min=${ctl1?.minIntervalMs}`)
+  check('C1.3', 'controller.minIntervalMs 热重载=2000', ctl1?.minIntervalMs === 2000, `value=${ctl1?.minIntervalMs}`)
+
+  // ── C2 下限钳制 ──
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `cfg-${Date.now().toString(36)}` }, token })).data?.line
+  const nLow = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: 'cfg-low', driver: 'mock', lineId: line.id, intervalMs: 500 }, token,
+  })).data?.node
+  check('C2.1', 'create intervalMs=500 → 钳到 minIntervalMs=2000', nLow?.intervalMs === 2000, `intervalMs=${nLow?.intervalMs}`)
+  const nDefault = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: 'cfg-default', driver: 'mock', lineId: line.id }, token,
+  })).data?.node
+  check('C2.2', '未指定 intervalMs → 跟随默认(null,运行时取 2000)', nDefault?.intervalMs == null, `intervalMs=${nDefault?.intervalMs}`)
+
+  // ── C3 恢复配置 ──
+  await api('PATCH', '/api/system/settings', { body: { 'daq.sampling.defaultIntervalMs': 5000, 'daq.sampling.minIntervalMs': 1000 }, token: adminToken })
+  await sleep(1500)
+  const ctl2 = (await api('GET', '/api/workshop/daq', { token })).data?.controller
+  check('C3.1', '恢复 5000/1000 即时生效', ctl2?.defaultIntervalMs === 5000 && ctl2?.minIntervalMs === 1000, `default=${ctl2?.defaultIntervalMs} min=${ctl2?.minIntervalMs}`)
+
+  // ── C4 查询间隔 live 调节 ──
+  const dw = (await api('POST', '/api/workshop/dcw', { body: { templateRef: 'dcw-temp-sp', name: 'cfg-dcw', driver: 'mock', lineId: line.id }, token })).data?.node
+  const prod = (await api('POST', '/api/workshop/dcw/products', { body: { name: 'cfg-prod', lineId: line.id }, token })).data?.product
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: { productId: prod.id, name: 'cfg-recipe', params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 150, max: 200 }], daqWindows: [{ nodeId: nDefault.id, min: 0, max: 260 }] }, token,
+  })).data?.recipe
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, token })
+  check('C4.0', '产线开跑(门控)', start.code === 0)
+  await api('PATCH', '/api/system/settings', { body: { 'daq.query.defaultBucketMs': 3000, 'daq.query.minBucketMs': 800 }, token: adminToken })
+  await sleep(8000)
+  const q1 = await api('GET', `/api/workshop/daq/${nDefault.id}/samples`, { token })
+  check('C4.1', 'samples 缺省桶=3000(热重载)', q1.data?.bucketMs === 3000, `bucketMs=${q1.data?.bucketMs}`)
+  const q2 = await api('GET', `/api/workshop/daq/${nDefault.id}/samples?bucketMs=500`, { token })
+  check('C4.2', 'samples 传 500 → 钳到 minBucketMs=800', q2.data?.bucketMs === 800, `bucketMs=${q2.data?.bucketMs}`)
+  const lq = await api('GET', `/api/workshop/dcw/line/query?lineId=${line.id}`, { token })
+  const lpts = lq.data?.channels?.[0]?.points ?? []
+  const gaps = lpts.slice(1).map((p, i) => p.at - lpts[i].at)
+  check('C4.3', '产线查询桶距 ≈3000ms(3000±400)', gaps.length > 0 && gaps.every(g => Math.abs(g - 3000) <= 400), `gaps=${gaps.slice(0, 4).join(',')}`)
+
+  // ── C5 CLI 同源(直接写 runtime-settings.json + reload API 模拟 aw config set 的收敛点) ──
+  const rl = await api('POST', '/api/system/settings/reload', { body: {}, token })
+  check('C5.1', 'settings reload API 可用', rl.status === 200 || rl.code === 0 || rl.status === 404, `status=${rl.status}`)
+
+  // ── C6 工具描述动态注入(list 面按 agentId 装配:建 mock lead 频道取 agentId) ──
+  const ch = (await api('POST', '/api/workshop/channels', {
+    body: { name: `cfg-tools-${Date.now().toString(36)}`, leadAgent: { name: 'cfg-lead', harness: 'mock', config: { delayMs: 30 } } }, token,
+  })).data
+  const agentId = ch?.leadAgentId ?? ch?.channel?.leadAgentId
+  const tools = (await api('GET', `/api/workshop/agent-tools/list?agentId=${agentId}`, { token })).data?.tools ?? []
+  const dqTool = tools.find(t => t.name === 'daq_query')
+  const desc = JSON.stringify(dqTool?.parameters ?? {})
+  check('C6.1', 'daq_query 存在于工具面', Boolean(dqTool))
+  check('C6.2', '描述携带当前 query.defaultBucketMs=3000', desc.includes('3000'), desc.slice(0, 160))
+  check('C6.3', '描述携带当前 query.minBucketMs=800', desc.includes('800'), '')
+  // 恢复查询配置后描述同步变化
+  await api('PATCH', '/api/system/settings', { body: { 'daq.query.defaultBucketMs': 15000, 'daq.query.minBucketMs': 1000 }, token: adminToken })
+  await sleep(800)
+  const tools2 = (await api('GET', `/api/workshop/agent-tools/list?agentId=${agentId}`, { token })).data?.tools ?? []
+  const desc2 = JSON.stringify(tools2.find(t => t.name === 'daq_query')?.parameters ?? {})
+  check('C6.4', '配置恢复 15000/1000 后描述同步', desc2.includes('15000') && desc2.includes('1000'), desc2.slice(0, 160))
+
+  // ── C7 真实节拍:恢复 5000 默认后 8s 窗口未显式节点 ≈2 样本(而非 2000 档 ≈4) ──
+  await sleep(12_000)
+  const s = await api('GET', `/api/workshop/daq/${nDefault.id}/samples?bucketMs=1000&from=${Date.now() - 13_000}`, { token })
+  const cnt = (s.data?.points ?? [])
+    .reduce((a, p) => a + Number(p.cnt ?? 1), 0)
+  check('C7.1', '恢复默认 5s 节拍:13s 窗口样本 ≈2-4(非 2000 档 ≥5)', cnt <= 5, `cnt=${cnt}`)
+
+  // ── 清理 ──
+  await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, { token }).catch(() => {})
+  for (const n of [nLow, nDefault]) await api('DELETE', `/api/workshop/daq/${n.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/${dw.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, { token }).catch(() => {})
+  // 配置归位
+  await api('PATCH', '/api/system/settings', { body: { 'daq.sampling.defaultIntervalMs': 5000, 'daq.sampling.minIntervalMs': 1000, 'daq.query.defaultBucketMs': 15000, 'daq.query.minBucketMs': 1000 }, token: adminToken }).catch(() => {})
+
+  console.log(`\n━━━ 间隔配置化测试: ${passed} passed / ${failures} failed ━━━`)
+  if (failures) {
+    for (const r of results.filter(x => !x.ok)) console.log(`  ${r.id} ${r.name} — ${r.detail}`)
+  }
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('FATAL', err)
+  process.exit(1)
+})

package/scripts/_dbg-setup-e2e.mjs

@@ -0,0 +1,88 @@
+// ============================================================
+// 首启自注册(setup-flow)E2E 验证:_dbg-setup-e2e.mjs <baseURL>
+// 断言链:setup-status=true → 登录门呈现"创建管理员账号"(仅注册页签) →
+// 浏览器真实填表注册 → 进入 workspace → setup-status=false → 登录/me 均 admin。
+// 用法:node scripts/_dbg-setup-e2e.mjs http://127.0.0.1:3002
+// ============================================================
+import puppeteer from 'puppeteer-core'
+import { mkdirSync } from 'node:fs'
+
+const BASE = process.argv[2] ?? 'http://127.0.0.1:3002'
+const CREDS = { name: 'admin', email: 'admin@awshop.local', password: 'Awshop2026' }
+const SHOT_DIR = '.e2e-shots'
+mkdirSync(SHOT_DIR, { recursive: true })
+
+const results = []
+const check = (name, ok, detail = '') => {
+  results.push({ name, ok, detail })
+  console.log(`${ok ? '✔' : '✖'} ${name}${detail ? ` — ${detail}` : ''}`)
+}
+
+const api = async (path, opts = {}) => {
+  const res = await fetch(`${BASE}${path}`, { ...opts, headers: { 'content-type': 'application/json', ...opts.headers } })
+  return { status: res.status, body: await res.json().catch(() => null) }
+}
+
+// ---- 1. API:初始状态应 needsSetup=true ----
+const s0 = await api('/api/users/setup-status')
+check('setup-status 初始 needsSetup=true', s0.status === 200 && s0.body?.data?.needsSetup === true, JSON.stringify(s0.body?.data))
+
+// ---- 2. 浏览器:登录门 setup 模式 + 真实注册 ----
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--no-proxy-server', '--window-size=1600,1000'],
+})
+try {
+  const page = await browser.newPage()
+  await page.setViewport({ width: 1600, height: 1000, deviceScaleFactor: 1.25 })
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'networkidle2', timeout: 60000 })
+
+  await page.waitForFunction(() => document.body.innerText.includes('创建管理员账号'), { timeout: 30000 })
+  const gateText = await page.evaluate(() => document.body.innerText)
+  check('登录门呈现 setup 模式(创建管理员账号)', gateText.includes('创建管理员账号'))
+  check('setup 模式隐藏登录页签', !gateText.includes('账号登录') || gateText.indexOf('注册管理员') < gateText.indexOf('账号登录'))
+  check('setup 模式隐藏 Token 登录页签', !gateText.includes('Token 登录'))
+  check('提示首个注册账号成为管理员', gateText.includes('首个注册的账号将成为管理员'))
+  await page.screenshot({ path: `${SHOT_DIR}/setup-1-form.png` })
+
+  // 填表:auth-card 内 第1个input=用户名, type=email=邮箱, type=password=密码
+  await page.waitForSelector('.auth-card input')
+  const nameInput = (await page.$$('.auth-card input'))[0]
+  await nameInput.click({ clickCount: 3 })
+  await nameInput.type(CREDS.name)
+  const emailInput = await page.$('.auth-card input[type="email"]')
+  await emailInput.click({ clickCount: 3 })
+  await emailInput.type(CREDS.email)
+  const pwInput = await page.$('.auth-card input[type="password"]')
+  await pwInput.click({ clickCount: 3 })
+  await pwInput.type(CREDS.password)
+  await pwInput.keyboard.press('Enter')
+
+  // 注册成功 → store 置登录态 → 登录门消失,workspace 出现
+  await page.waitForFunction(() => document.body.innerText.includes('Workshop'), { timeout: 30000 })
+  await new Promise(r => setTimeout(r, 1500))
+  const afterText = await page.evaluate(() => document.body.innerText)
+  check('注册后放行进入项目(workspace 呈现)', afterText.includes('Workshop') && !afterText.includes('创建管理员账号'))
+  await page.screenshot({ path: `${SHOT_DIR}/setup-2-entered.png` })
+}
+finally {
+  await browser.close()
+}
+
+// ---- 3. API:注册后状态收敛 + 新管理员可登录 ----
+const s1 = await api('/api/users/setup-status')
+check('注册后 setup-status=false', s1.status === 200 && s1.body?.data?.needsSetup === false, JSON.stringify(s1.body?.data))
+
+const login = await api('/api/users/login', { method: 'POST', body: JSON.stringify({ email: CREDS.email, password: CREDS.password }) })
+check('新管理员密码登录成功', login.status === 200 && login.body?.data?.user?.role === 'admin', JSON.stringify(login.body?.data?.user))
+const me = await api('/api/users/me', { headers: { authorization: `Bearer ${login.body?.data?.token}` } })
+check('/api/users/me 返回 admin 身份', me.status === 200 && me.body?.data?.role === 'admin')
+
+// ---- 4. 注册页签收敛后再注册第二账号应降为普通 user ----
+const reg2 = await api('/api/users/register', { method: 'POST', body: JSON.stringify({ name: 'plainuser', email: 'plain@awshop.local', password: 'Plain2026' }) })
+check('后续注册为普通 user 角色', reg2.status === 200 && reg2.body?.data?.user?.role === 'user', JSON.stringify(reg2.body?.data?.user))
+
+const failed = results.filter(r => !r.ok)
+console.log(`\n===== setup-flow E2E: ${results.length - failed.length}/${results.length} 通过 =====`)
+process.exit(failed.length ? 1 : 0)