agentworkshop 0.7.8 → 0.7.9

package/app/pages/dcw/[id].vue

@@ -124,7 +124,7 @@ async function doWrite(nodeId: string, value: number): Promise<void> {
     }
   }
   catch (err) {
-    writeError.value = err instanceof Error ? err.message : String(err)
+    writeError.value = apiErrorMessage(err)
   }
   finally {
     writingId.value = ''
@@ -141,7 +141,7 @@ async function doRead(nodeId: string): Promise<void> {
     await dcw.readNode(nodeId)
   }
   catch (err) {
-    writeError.value = err instanceof Error ? err.message : String(err)
+    writeError.value = apiErrorMessage(err)
   }
   finally {
     readingId.value = ''
@@ -164,7 +164,7 @@ async function toggleControl(nodeId: string, enabled: boolean): Promise<void> {
     }
   }
   catch (err) {
-    writeError.value = err instanceof Error ? err.message : String(err)
+    writeError.value = apiErrorMessage(err)
   }
   finally {
     togglingId.value = ''
@@ -207,7 +207,7 @@ async function doTestConnection(): Promise<void> {
     addTest.value = await dcw.testDriver(addDriver.value, addCfg.value)
   }
   catch (err) {
-    addTest.value = { ok: false, message: err instanceof Error ? err.message : String(err) }
+    addTest.value = { ok: false, message: apiErrorMessage(err) }
   }
   finally {
     addTesting.value = false
@@ -241,7 +241,7 @@ async function doAddNode(): Promise<void> {
     addSemantics.value = ''
   }
   catch (err) {
-    addError.value = err instanceof Error ? err.message : String(err)
+    addError.value = apiErrorMessage(err)
   }
   finally {
     addSaving.value = false
@@ -304,7 +304,7 @@ async function doCreateTemplate(): Promise<void> {
     tplForm.semantics = ''
   }
   catch (err) {
-    tplError.value = err instanceof Error ? err.message : String(err)
+    tplError.value = apiErrorMessage(err)
   }
   finally {
     tplSaving.value = false
@@ -332,7 +332,7 @@ async function doLineStart(): Promise<void> {
     lineMsg.value = t('dcwDetail.k17jteb9186', { p0: ls.value.productName, p1: ls.value.recipeName, p2: ls.value.runId })
   }
   catch (err) {
-    lineErr.value = err instanceof Error ? err.message : String(err)
+    lineErr.value = apiErrorMessage(err)
   }
   finally {
     lineBusy.value = false
@@ -349,7 +349,7 @@ async function doLineStop(): Promise<void> {
     lineMsg.value = t('dcwDetail.kzl49pd187', { p0: was })
   }
   catch (err) {
-    lineErr.value = err instanceof Error ? err.message : String(err)
+    lineErr.value = apiErrorMessage(err)
   }
   finally {
     lineBusy.value = false
@@ -375,7 +375,7 @@ async function doCreateProduct(): Promise<void> {
     productForm.description = ''
   }
   catch (err) {
-    productError.value = err instanceof Error ? err.message : String(err)
+    productError.value = apiErrorMessage(err)
   }
   finally {
     productSaving.value = false
@@ -421,7 +421,7 @@ async function doQuery(): Promise<void> {
     if (queryResult.value.channels.length === 0) queryError.value = t('dcwDetail.kszv5sq136')
   }
   catch (err) {
-    queryError.value = err instanceof Error ? err.message : String(err)
+    queryError.value = apiErrorMessage(err)
   }
   finally {
     queryBusy.value = false
@@ -509,7 +509,7 @@ async function saveRecipe(): Promise<void> {
     recipeOpen.value = false
   }
   catch (err) {
-    recipeError.value = err instanceof Error ? err.message : String(err)
+    recipeError.value = apiErrorMessage(err)
   }
   finally {
     recipeSaving.value = false
@@ -526,7 +526,7 @@ async function doApplyRecipe(id: string): Promise<void> {
     if (ok < run.results.length) writeError.value = t('dcwDetail.ks7szkt188', { p0: run.results.filter(r => !r.ok).map(r => r.message).join(';') })
   }
   catch (err) {
-    writeError.value = err instanceof Error ? err.message : String(err)
+    writeError.value = apiErrorMessage(err)
   }
 }
 
@@ -537,7 +537,7 @@ async function doViewRun(id: string): Promise<void> {
     runDataView.value = { runId: id, data }
   }
   catch (err) {
-    writeError.value = err instanceof Error ? err.message : String(err)
+    writeError.value = apiErrorMessage(err)
   }
   finally {
     runDataLoading.value = false

package/app/pages/dcw/index.vue

@@ -69,7 +69,7 @@ async function doCreateLine(): Promise<void> {
     createOpen.value = false
   }
   catch (err) {
-    createError.value = err instanceof Error ? err.message : String(err)
+    createError.value = apiErrorMessage(err)
   }
   finally {
     createSaving.value = false
@@ -90,7 +90,7 @@ async function quickStart(card: LineCard): Promise<void> {
     await dcw.startLine(card.line.id, rid)
   }
   catch (err) {
-    quickErr.value = err instanceof Error ? err.message : String(err)
+    quickErr.value = apiErrorMessage(err)
   }
   finally {
     quickBusy.value = ''
@@ -104,7 +104,7 @@ async function quickStop(card: LineCard): Promise<void> {
     await dcw.stopLine(card.line.id)
   }
   catch (err) {
-    quickErr.value = err instanceof Error ? err.message : String(err)
+    quickErr.value = apiErrorMessage(err)
   }
   finally {
     quickBusy.value = ''
@@ -140,7 +140,7 @@ async function doDeleteLine(): Promise<void> {
     delOpen.value = false
   }
   catch (err) {
-    delErr.value = err instanceof Error ? err.message : String(err)
+    delErr.value = apiErrorMessage(err)
   }
   finally {
     delBusy.value = false
@@ -174,7 +174,7 @@ async function doEditLine(): Promise<void> {
     editOpen.value = false
   }
   catch (err) {
-    editError.value = err instanceof Error ? err.message : String(err)
+    editError.value = apiErrorMessage(err)
   }
   finally {
     editSaving.value = false
@@ -218,7 +218,7 @@ async function doCreateTemplate(): Promise<void> {
     tplForm.max = ''
   }
   catch (err) {
-    tplError.value = err instanceof Error ? err.message : String(err)
+    tplError.value = apiErrorMessage(err)
   }
 }
 
@@ -236,7 +236,7 @@ async function doRemoveTemplate(key: string): Promise<void> {
     if (i >= 0) dcw.templates.splice(i, 1)
   }
   catch (err) {
-    tplError.value = err instanceof Error ? err.message : String(err)
+    tplError.value = apiErrorMessage(err)
   }
 }
 

package/app/pages/logs/index.vue

@@ -436,7 +436,7 @@ async function submitManual(): Promise<void> {
     doQuery()
   }
   catch (err) {
-    message.error(err instanceof Error ? err.message : String(err))
+    message.error(apiErrorMessage(err))
   }
 }
 

package/app/pages/plugins/index.vue

@@ -17,6 +17,8 @@ interface PluginInfo {
   version: string
   description: string
   scope: 'project' | 'user'
+  /** 内置示例插件(随项目检出提供);false/undefined = 用户级扩展 */
+  builtin?: boolean
   enabled: boolean
   hasClient: boolean
   routes: PluginRoute[]
@@ -43,8 +45,8 @@ async function load() {
     plugins.value = d.plugins ?? []
     failures.value = d.failures ?? []
   }
-  catch {
-    message.error(t('plugins.enableFail'))
+  catch (err) {
+    message.error(apiErrorMessage(err, t('plugins.loadFail')))
   }
   finally {
     loading.value = false
@@ -54,13 +56,15 @@ async function load() {
 async function toggle(p: PluginInfo) {
   busyName.value = p.name
   try {
-    const d = await $fetch<{ enabled: boolean }>(`/api/workshop/plugins/${p.name}/${p.enabled ? 'disable' : 'enable'}`, { method: 'POST', headers: authHeaders() })
-    p.enabled = d.enabled
-    message.success(`${p.name} · ${d.enabled ? t('plugins.enabled') : t('plugins.disabled')}`)
+    const d = await $fetch<{ code: number, data?: { enabled: boolean } }>(`/api/workshop/plugins/${p.name}/${p.enabled ? 'disable' : 'enable'}`, { method: 'POST', headers: authHeaders() })
+    if (d.code !== 0 || !d.data) throw new Error(t('plugins.enableFail'))
+    p.enabled = d.data.enabled
+    message.success(`${p.name} · ${d.data.enabled ? t('plugins.enabled') : t('plugins.disabled')}`)
     setTimeout(load, 800) // 热重载完成后刷新路由/客户端状态
   }
   catch (err) {
-    message.error(`${t('plugins.enableFail')}: ${(err as Error)?.message ?? ''}`)
+    // 403 权限不足/404 插件不存在等:信封 message 直出人话,不再渲染码式文本
+    message.error(apiErrorMessage(err, t('plugins.enableFail')))
   }
   finally {
     busyName.value = ''
@@ -189,6 +193,9 @@ onMounted(load)
         <dl class="detail">
           <dt>version</dt><dd>{{ current.version }}</dd>
           <dt>scope</dt><dd>{{ scopeLabel(current.scope) }}</dd>
+          <dd class="scope-hint">
+            {{ current.scope === 'project' ? $t('plugins.scopeBuiltinHint') : $t('plugins.scopeUserHint') }}
+          </dd>
           <dt>enabled</dt><dd>{{ current.enabled }}</dd>
           <dt>client</dt><dd>{{ current.hasClient ? '✓' : '—' }}</dd>
           <dt v-if="current.error">
@@ -252,6 +259,7 @@ onMounted(load)
 .card-routes code { font-size: 10px; opacity: .65; }
 .detail dt { margin-top: 10px; font-size: 11px; opacity: .5; }
 .detail dd { margin: 2px 0 0; font-family: ui-monospace, monospace; font-size: 12px; }
+.detail .scope-hint { font-family: inherit; font-size: 11px; opacity: .6; margin-bottom: 6px; }
 .detail-route { display: block; font-size: 11px; opacity: .8; margin-bottom: 4px; }
 h4 { margin: 16px 0 6px; }
 .dim { opacity: .45; }

package/app/pages/tokens.vue

@@ -62,7 +62,7 @@ const doCreate = async (): Promise<void> => {
     await load()
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     createLoading.value = false
@@ -84,7 +84,7 @@ const doRename = async (): Promise<void> => {
     message.success(tt('tokens.k3n9aij015'))
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     renameLoading.value = false
@@ -103,7 +103,7 @@ const doRevoke = (t: { id?: string }): void => {
       await load()
     }
     catch (e) {
-      message.error(e instanceof Error ? e.message : String(e))
+      message.error(apiErrorMessage(e))
     }
   })()
 }

package/app/pages/workshop/agents.vue

@@ -136,7 +136,7 @@ const save = async (): Promise<void> => {
     void load()
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
 }
 const remove = async (t: AgentTemplateDto): Promise<void> => {
@@ -158,7 +158,7 @@ const toggleVisibility = async (t: AgentTemplateDto, pub: boolean): Promise<void
     void load()
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
 }
 

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

@@ -104,7 +104,7 @@ const create = async (): Promise<void> => {
     void load()
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
 }
 
@@ -116,7 +116,7 @@ const toggleVisibility = async (t: ChannelTemplateDto, pub: boolean): Promise<vo
     void load()
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
 }
 
@@ -130,7 +130,7 @@ const instantiate = async (t: ChannelTemplateDto): Promise<void> => {
     message.success(tt('ctpl.kefkfnl030', { p0: t.name, p1: data?.agentCount ?? 0 }))
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     instantiating.value = null

package/app/pages/workshop/index.vue

@@ -63,7 +63,7 @@ const doRegister = async (): Promise<void> => {
     authPassword.value = ''
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     authLoading.value = false
@@ -82,7 +82,7 @@ const doLogin = async (): Promise<void> => {
     authPassword.value = ''
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     authLoading.value = false
@@ -97,7 +97,7 @@ const doLoginWithToken = async (): Promise<void> => {
     authTokenInput.value = ''
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     authLoading.value = false
@@ -157,7 +157,7 @@ const create = async (): Promise<void> => {
     navigateTo(`/workshop/w/${ws.id}`)
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     createLoading.value = false

package/app/pages/workshop/teams.vue

@@ -79,7 +79,7 @@ const toggleVisibility = async (team: TeamDto, pub: boolean): Promise<void> => {
     void load()
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
 }
 
@@ -105,7 +105,7 @@ const addMember = async (): Promise<void> => {
     void load()
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
 }
 const removeMember = async (team: TeamDto, templateId: string): Promise<void> => {
@@ -135,7 +135,7 @@ const deploy = async (): Promise<void> => {
     deployOpen.value = false
   }
   catch (e) {
-    message.error(e instanceof Error ? e.message : String(e))
+    message.error(apiErrorMessage(e))
   }
   finally {
     deploying.value = false

package/app/utils/api-error.ts

@@ -0,0 +1,75 @@
+/**
+ * 统一错误文案解析 —— 任何 fetch/axios/业务异常 → 面向用户的可读提示。
+ *
+ * 项目约定:API 错误一律走 {code, message} 信封(defineApiHandler/AppError),
+ * 服务端 message 本就是人话;但 ofetch/axios 抛出的错误对象把 "[POST] /api/x
+ * 403 (forbidden)" 这类码式文本放在 err.message 上,信封在 err.data 里。
+ * 本解析器统一取值顺序:
+ *   1. 服务端信封 message(人话,优先);
+ *   2. HTTP 状态码 → 本地化映射(errors.* i18n,取不到回退内置中文);
+ *   3. 网络层失败特征 → "无法连接服务器";
+ *   4. 原始 message(最后兜底,通常已可读)。
+ * 永远返回非空字符串;message.error(messageError(err)) 即可替换一切裸 err.message 渲染。
+ */
+interface ErrLike {
+  data?: unknown
+  statusCode?: number
+  status?: number
+  message?: string
+  code?: string | number
+}
+
+/** i18n 取不到时的内置回退(与 locales errors.* 保持一致,zh 优先项目) */
+const FALLBACK: Record<string, string> = {
+  http400: '请求参数有误,请检查后重试',
+  http401: '登录已过期,请重新登录',
+  http403: '权限不足:该操作需要管理员权限',
+  http404: '目标不存在或已被删除',
+  http409: '操作冲突:资源已存在或状态不允许',
+  http5xx: '服务器内部错误,请稍后重试',
+  network: '无法连接服务器,请检查网络与服务状态',
+  fallback: '操作失败,请稍后重试',
+}
+
+/** 事件回调里 useI18n 不可靠,经 nuxt app 取 $i18n;任何失败静默回退内置文案 */
+function tt(key: string): string | null {
+  try {
+    const nuxt = useNuxtApp()
+    const i18n = (nuxt as { $i18n?: { t?: (k: string) => string } }).$i18n
+    const v = i18n?.t?.(key)
+    return typeof v === 'string' && v && !v.startsWith('errors.') ? v : null
+  }
+  catch {
+    return null
+  }
+}
+
+function statusKey(status: number): keyof typeof FALLBACK | null {
+  if (status === 400) return 'http400'
+  if (status === 401) return 'http401'
+  if (status === 403) return 'http403'
+  if (status === 404) return 'http404'
+  if (status === 409) return 'http409'
+  if (status >= 500) return 'http5xx'
+  return null
+}
+
+export function apiErrorMessage(err: unknown, fallback?: string): string {
+  const e = (err ?? {}) as ErrLike
+  // 1. 服务端信封(ofetch: err.data = {code,message};axios: err.response.data)
+  const data = (e.data ?? null) as { message?: unknown } | null
+  if (data && typeof data.message === 'string' && data.message.trim()) return data.message.trim()
+  // 2. HTTP 状态码 → 本地化映射
+  const status = Number(e.statusCode ?? e.status ?? 0)
+  const key = statusKey(status)
+  if (key) return tt(`errors.${key}`) ?? FALLBACK[key]
+  // 3. 网络层失败(fetch failed / ECONNREFUSED / 超时)
+  const raw = String(e.message ?? '')
+  if (/fetch failed|network|ECONNREFUSED|ENOTFOUND|ECONNRESET|aborted|timeout/i.test(raw)) {
+    return tt('errors.network') ?? FALLBACK.network
+  }
+  // 4. 原始 message 兜底(裸 Error 等通常已可读;剥掉 "Error: " 前缀)
+  const cleaned = raw.replace(/^Error:\s*/, '').trim()
+  if (cleaned) return cleaned
+  return fallback ?? tt('errors.fallback') ?? FALLBACK.fallback
+}

package/cli/commands/plugin.mjs

@@ -158,8 +158,8 @@ function findPluginDir(ctx, name) {
 
 function scopes(ctx) {
   return [
-    { scope: 'project', dir: ctx.root ? join(ctx.root, '.AgentWorkShop', 'plugins') : null, label: '项目级' },
-    { scope: 'user', dir: ctx.commandsDir?.global ? join(ctx.home, 'plugins') : join(ctx.home, 'plugins'), label: '用户级' },
+    { scope: 'project', dir: ctx.root ? join(ctx.root, '.AgentWorkShop', 'plugins') : null, label: '内置示例' },
+    { scope: 'user', dir: ctx.commandsDir?.global ? join(ctx.home, 'plugins') : join(ctx.home, 'plugins'), label: '用户级扩展' },
   ]
 }
 

package/config.yml

@@ -10,7 +10,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.8
+  version: 0.7.9
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）

package/i18n/locales/en.ts

@@ -1872,12 +1872,15 @@ export default {
   },
   plugins: {
     title: 'Plugins',
-    subtitle: 'Config-root plugins/ · toggles hot-reload instantly',
+    subtitle: 'Built-in samples & user extensions · toggles hot-reload instantly',
     refresh: 'Refresh',
     enabled: 'Enabled',
     disabled: 'Disabled',
-    scopeProject: 'Project',
-    scopeUser: 'User',
+    scopeProject: 'Built-in sample',
+    scopeUser: 'User extension',
+    scopeBuiltinHint: 'Built-in sample plugin: shipped with the project checkout (repo .AgentWorkShop/plugins), can be toggled',
+    scopeUserHint: 'User extension plugin: lives in ~/.AgentWorkShop/plugins, created and maintained by you',
+    loadFail: 'Failed to load plugin list',
     hasClient: 'Client enhancer',
     routes: 'API routes',
     empty: 'No plugins yet — aw plugin create <name>, or aw plugin enable to turn on examples',
@@ -1886,6 +1889,16 @@ export default {
     enableFail: 'Toggle failed',
     detail: 'Plugin detail',
   },
+  errors: {
+    http400: 'Invalid request, please check and retry',
+    http401: 'Session expired, please sign in again',
+    http403: 'Insufficient permission: this action requires an administrator',
+    http404: 'Target not found or already removed',
+    http409: 'Conflict: resource already exists or state does not allow it',
+    http5xx: 'Server error, please retry later',
+    network: 'Cannot reach the server, check network and service status',
+    fallback: 'Action failed, please retry later',
+  },
   error: {
     backHome: 'Back to Home',
     lost: 'Page lost',

package/i18n/locales/zh-CN.ts

@@ -1871,12 +1871,15 @@ export default {
   },
   plugins: {
     title: '插件管理',
-    subtitle: '配置根 plugins/ 目录 · 启停即时热重载',
+    subtitle: '内置示例与用户级扩展插件 · 启停即时热重载',
     refresh: '刷新',
     enabled: '已启用',
     disabled: '已停用',
-    scopeProject: '项目级',
-    scopeUser: '用户级',
+    scopeProject: '内置示例',
+    scopeUser: '用户级扩展',
+    scopeBuiltinHint: '内置示例插件:随项目检出提供(仓库 .AgentWorkShop/plugins),可启停',
+    scopeUserHint: '用户级扩展插件:位于 ~/.AgentWorkShop/plugins,由使用者自行创建维护',
+    loadFail: '插件列表加载失败',
     hasClient: '浏览器增强',
     routes: 'API 路由',
     empty: '暂无插件 —— aw plugin create <name> 创建,或 aw plugin enable 开启示例',
@@ -1885,6 +1888,16 @@ export default {
     enableFail: '启停操作失败',
     detail: '插件详情',
   },
+  errors: {
+    http400: '请求参数有误,请检查后重试',
+    http401: '登录已过期,请重新登录',
+    http403: '权限不足:该操作需要管理员权限',
+    http404: '目标不存在或已被删除',
+    http409: '操作冲突:资源已存在或状态不允许',
+    http5xx: '服务器内部错误,请稍后重试',
+    network: '无法连接服务器,请检查网络与服务状态',
+    fallback: '操作失败,请稍后重试',
+  },
   error: {
     backHome: '返回首页',
     lost: '页面走失了',

package/package.json

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

package/scripts/_dbg-interval-config.mjs

@@ -37,15 +37,19 @@ async function main() {
   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)
+  // 设置修改需 admin:凭据存档支持两种格式 —— 旧版「password: <pw>」(zhangwei@awshop.io)
+  // 与新版「admin@awshop.local / <pw>」(首注册自注册制);env AW_ADMIN_PW 可直接覆盖
   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 } })
+    const legacyPw = cred.match(/password:\s*(\S+)/)?.[1]
+    const newFmt = cred.match(/admin@awshop\.local\s*\/\s*(\S+)/)
+    const email = legacyPw && !newFmt ? 'zhangwei@awshop.io' : 'admin@awshop.local'
+    const pw = process.env.AW_ADMIN_PW ?? (legacyPw && !newFmt ? legacyPw : newFmt?.[1])
+    const lg = await api('POST', '/api/users/login', { body: { email, password: pw } })
     adminToken = lg.data?.token ?? token
-    console.log(`  [setup] admin 登录: ${lg.data?.token ? 'ok' : '失败(回退 user token)'}`)
+    console.log(`  [setup] admin 登录(${email}): ${lg.data?.token ? 'ok' : '失败(回退 user token)'}`)
   }
   catch {
     console.log('  [setup] 无种子凭据存档,回退 user token')
@@ -92,8 +96,15 @@ async function main() {
   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(',')}`)
+  // 桶宽生效的数学证据:同一 time_bucket 调用产出的桶必然落在同一网格,
+  // 任意两点差 = 桶宽整数倍(±2ms 浮点尾差);跨网格点会破坏该性质
+  const B = 3000
+  let mult = true
+  for (let i = 1; i < lpts.length && mult; i++) {
+    const d = lpts[i].at - lpts[0].at
+    if (Math.abs(d / B - Math.round(d / B)) * B > 2) mult = false
+  }
+  check('C4.3', `产线查询桶间距均为 ${B}ms 整数倍(同网格)`, lpts.length > 1 && mult, `pts=${lpts.length} firstDiff=${lpts.length > 1 ? (lpts[1].at - lpts[0].at).toFixed(1) : '-'}`)
 
   // ── C5 CLI 同源(直接写 runtime-settings.json + reload API 模拟 aw config set 的收敛点) ──
   const rl = await api('POST', '/api/system/settings/reload', { body: {}, token })