agentworkshop 0.7.49 → 0.7.50

package/sdk/index.mjs

@@ -13,13 +13,13 @@
 //           → server:close
 //   客户端: client.mjs setup(ctx) → client:init → event:*/page:change
 // ============================================================
-import { SDK_VERSION, definePlugin, createPluginContext, createRouteTable, validatePluginModule, validatePluginSettings, validatePluginGroups, resolvePluginGroupId, pluginKvExists } from './context.mjs'
+import { SDK_VERSION, TWIN_BRIDGE_KEY, TwinRegistryUnavailableError, getTwinRegistryBridge, definePlugin, createPluginContext, createRouteTable, validatePluginModule, validatePluginSettings, validatePluginGroups, resolvePluginGroupId, pluginKvExists } from './context.mjs'
 import { HookBus } from './hooks.mjs'
 import { createPlatformClient } from './api.mjs'
 import { CLIENT_SDK_VERSION, createClientContext, el } from './client.mjs'
 import { LIFECYCLE_EVENTS, CLIENT_EVENTS } from './lifecycle.mjs'
 
-export { SDK_VERSION, definePlugin, createPluginContext, createRouteTable, validatePluginModule, validatePluginSettings, validatePluginGroups, resolvePluginGroupId, pluginKvExists, isPathInside } from './context.mjs'
+export { SDK_VERSION, TWIN_BRIDGE_KEY, TwinRegistryUnavailableError, getTwinRegistryBridge, definePlugin, createPluginContext, createRouteTable, validatePluginModule, validatePluginSettings, validatePluginGroups, resolvePluginGroupId, pluginKvExists, isPathInside } from './context.mjs'
 export { HookBus } from './hooks.mjs'
 export { createPlatformClient } from './api.mjs'
 export { CLIENT_SDK_VERSION, createClientContext, el } from './client.mjs'
@@ -27,6 +27,9 @@ export { LIFECYCLE_EVENTS, CLIENT_EVENTS } from './lifecycle.mjs'
 
 export default {
   SDK_VERSION,
+  TWIN_BRIDGE_KEY,
+  TwinRegistryUnavailableError,
+  getTwinRegistryBridge,
   definePlugin,
   HookBus,
   createPluginContext,

package/server/api/system/timezone.get.ts

@@ -0,0 +1,20 @@
+/**
+ * GET /api/system/timezone —— 当前系统时区只读信息。
+ * 普通登录用户可读取，用于浏览器显式时区格式化；修改仍走管理员系统设置 PATCH。
+ */
+import { resolveUser } from '../workshop/caller'
+import { defineApiHandler } from '../../utils/response'
+import { configuredTimeZoneOffset, getConfiguredTimeZone, supportedTimeZones } from '@/shared/local-time.mjs'
+
+export default defineApiHandler((event) => {
+  resolveUser(event)
+  const timeZone = getConfiguredTimeZone()
+  const offsetMinutes = configuredTimeZoneOffset(new Date(), timeZone)
+  const sign = offsetMinutes >= 0 ? '+' : '-'
+  const absolute = Math.abs(offsetMinutes)
+  return {
+    timeZone,
+    supportedTimeZones: supportedTimeZones(),
+    offset: `${sign}${String(Math.floor(absolute / 60)).padStart(2, '0')}:${String(absolute % 60).padStart(2, '0')}`,
+  }
+})

package/server/api/workshop/agent-tools/bindings/[id].patch.ts

@@ -1,23 +1,28 @@
-/**
- * PATCH /api/workshop/agent-tools/bindings/:id —— 切换控制模式(auto/manual)。
- *
- * 鉴权(与 index.post.ts 同口径):manual→auto 等于**摘掉人类审批闸门**,
- * 所以必须先证明调用者可支配该绑定所属产线的节点,否则任意登录用户都能
- * 关掉别人的 HITL。早先此处只有 resolveUser。
- */
-import { createError, getRouterParam, readBody } from 'h3'
-import { resolveUser } from '@/server/api/workshop/caller'
-import { defineApiHandler } from '@/server/utils/response'
-import { getAgentNodeBindingRepo } from '@/server/services/workshop/agents/node-bindings.repo'
-import { requireBindingAccess } from '@/server/services/workshop/agents/binding-authz'
-
-export default defineApiHandler(async (event) => {
-  const user = resolveUser(event)
-  const id = getRouterParam(event, 'id')!
-  const body = await readBody<{ mode?: 'auto' | 'manual' }>(event) ?? {}
-  const repo = getAgentNodeBindingRepo()
-  const binding = repo.all().find(b => b.id === id)
-  if (!binding) throw createError({ statusCode: 404, statusMessage: 'binding not found' })
-  requireBindingAccess(user, binding)
-  return { binding: repo.setMode(id, body.mode ?? 'auto') }
-})
+/**
+ * PATCH /api/workshop/agent-tools/bindings/:id —— 切换控制模式(auto/manual)/设置调试元数据。
+ * body: { mode?, tuning?: { min?, max?, step?, note? } }
+ * tuning = 绑定级调试元数据(工况提示词与探索步长来源,优先于节点自带元数据)。
+ *
+ * 鉴权(与 index.post.ts 同口径):manual→auto 等于**摘掉人类审批闸门**,
+ * 所以必须先证明调用者可支配该绑定所属产线的节点,否则任意登录用户都能
+ * 关掉别人的 HITL。早先此处只有 resolveUser。
+ */
+import { createError, getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getAgentNodeBindingRepo, type AgentNodeBindingTuning } from '@/server/services/workshop/agents/node-bindings.repo'
+import { requireBindingAccess } from '@/server/services/workshop/agents/binding-authz'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id')!
+  const body = await readBody<{ mode?: 'auto' | 'manual', tuning?: AgentNodeBindingTuning }>(event) ?? {}
+  const repo = getAgentNodeBindingRepo()
+  const binding = repo.all().find(b => b.id === id)
+  if (!binding) throw createError({ statusCode: 404, statusMessage: 'binding not found' })
+  requireBindingAccess(user, binding)
+  if (body.tuning !== undefined) {
+    return { binding: repo.setTuning(id, body.tuning) }
+  }
+  return { binding: repo.setMode(id, body.mode ?? 'auto') }
+})

package/server/api/workshop/aml/jobs/index.post.ts

@@ -1,44 +1,74 @@
-/**
- * POST /api/workshop/aml/jobs —— 提交训练作业(可内联 train.py 代码,平台写入作业工作区)。
- * body: { datasetId, purpose?, parentExperimentId?, changeNote?, params?, seed?, budget?, code? }
- */
-import { readBody } from 'h3'
-import { defineApiHandler } from '@/server/utils/response'
-import { resolveUser } from '@/server/api/workshop/caller'
-import { requireLineMode } from '@/server/services/workshop/permissions'
-import { AppError } from '@/server/utils/errors'
-import { getAmlRuntime } from '@/server/services/workshop/aml/runtime'
-import { submitJob } from '@/server/services/workshop/aml/job-orchestrator'
-
-export default defineApiHandler(async (event) => {
-  const user = resolveUser(event)
-  const body = await readBody<{
-    datasetId?: string
-    purpose?: 'mpc_surrogate' | 'quality_predict'
-    parentExperimentId?: string
-    changeNote?: string
-    params?: Record<string, unknown>
-    seed?: number
-    budget?: { maxExperiments?: number }
-    code?: string
-  }>(event) ?? {}
-  if (!body.datasetId) throw new AppError(422, 'AML_SPEC_INVALID', '缺少 datasetId')
-  if (body.code && body.code.length > 512_000) throw new AppError(422, 'AML_CODE_TOO_LARGE', '训练代码超过 500KB 上限')
-  const rt = getAmlRuntime()
-  const ds = rt.repo.dataset.get(body.datasetId)
-  if (!ds) throw new AppError(404, 'AML_DATASET_MISSING', `数据集 ${body.datasetId} 不存在`)
-  requireLineMode(user, ds.lineId, 'readonly')
-  const job = submitJob({
-    datasetId: body.datasetId,
-    purpose: body.purpose,
-    parentExperimentId: body.parentExperimentId ?? null,
-    changeNote: body.changeNote ?? '',
-    params: body.params ?? {},
-    seed: body.seed,
-    budget: body.budget,
-    code: body.code,
-    agent: { id: user.id },
-    byKind: 'user',
-  })
-  return { job }
-})
+/**
+ * POST /api/workshop/aml/jobs —— 提交训练作业(可内联 train.py 代码,平台写入作业工作区)。
+ * body: { datasetId, purpose?, parentExperimentId?, changeNote?, params?, seed?, budget?, code?,
+ *         sceneId?, sceneVersion?, objectiveId?, jobKind?, physicsSpec?, twinSnapshot?, objectiveProfile?,
+ *         providerId?, providerVersion?, providerHash?, providerGeneration?, modelName?, modelDescription? }
+ * Hybrid Twin 字段进入不可变 budget_json(谱系);jobKind=hybrid_residual 且无 code 时
+ * 平台使用内置参考训练器(物理参数校准→残差集成→UQ 校准)。
+ */
+import { readBody } from 'h3'
+import { defineApiHandler } from '@/server/utils/response'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { requireLineMode } from '@/server/services/workshop/permissions'
+import { AppError } from '@/server/utils/errors'
+import { getAmlRuntime } from '@/server/services/workshop/aml/runtime'
+import { submitJob } from '@/server/services/workshop/aml/job-orchestrator'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readBody<{
+    datasetId?: string
+    purpose?: 'mpc_surrogate' | 'quality_predict'
+    parentExperimentId?: string
+    changeNote?: string
+    params?: Record<string, unknown>
+    seed?: number
+    budget?: { maxExperiments?: number }
+    code?: string
+    sceneId?: string
+    sceneVersion?: string
+    objectiveId?: string
+    jobKind?: 'supervised' | 'physics_calibration' | 'hybrid_residual' | 'uncertainty_calibration'
+    physicsSpec?: Record<string, unknown>
+    twinSnapshot?: Record<string, unknown>
+    objectiveProfile?: Record<string, unknown>
+    providerId?: string
+    providerVersion?: string
+    providerHash?: string
+    providerGeneration?: number
+    modelName?: string
+    modelDescription?: string
+  }>(event) ?? {}
+  if (!body.datasetId) throw new AppError(422, 'AML_SPEC_INVALID', '缺少 datasetId')
+  if (body.code && body.code.length > 512_000) throw new AppError(422, 'AML_CODE_TOO_LARGE', '训练代码超过 500KB 上限')
+  const rt = getAmlRuntime()
+  const ds = rt.repo.dataset.get(body.datasetId)
+  if (!ds) throw new AppError(404, 'AML_DATASET_MISSING', `数据集 ${body.datasetId} 不存在`)
+  requireLineMode(user, ds.lineId, 'readonly')
+  const job = submitJob({
+    datasetId: body.datasetId,
+    purpose: body.purpose,
+    parentExperimentId: body.parentExperimentId ?? null,
+    changeNote: body.changeNote ?? '',
+    params: body.params ?? {},
+    seed: body.seed,
+    budget: body.budget,
+    code: body.code,
+    sceneId: body.sceneId,
+    sceneVersion: body.sceneVersion,
+    objectiveId: body.objectiveId,
+    jobKind: body.jobKind,
+    physicsSpec: body.physicsSpec,
+    twinSnapshot: body.twinSnapshot,
+    objectiveProfile: body.objectiveProfile,
+    providerId: body.providerId,
+    providerVersion: body.providerVersion,
+    providerHash: body.providerHash,
+    providerGeneration: body.providerGeneration,
+    modelName: body.modelName,
+    modelDescription: body.modelDescription,
+    agent: { id: user.id },
+    byKind: 'user',
+  })
+  return { job }
+})

package/server/api/workshop/aml/training-plans/[id]/train.post.ts

@@ -0,0 +1,18 @@
+/** POST /api/workshop/aml/training-plans/:id/train —— 立即触发一次修正训练(界面按钮/训练 Channel 工具共用) */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { runPlanTraining, getTrainingPlan } from '@/server/services/workshop/aml/twin/training-plans'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  if (!id) throw new AppError(400, 'VALIDATION_ERROR', 'plan id 必填')
+  const plan = getTrainingPlan(id)
+  if (!plan) throw new AppError(404, 'AML_PLAN_MISSING', `建模任务 ${id} 不存在`)
+  const r = await runPlanTraining(id, { id: user.id, kind: 'user' })
+  broadcastSceneEvent('aml.plan', { action: 'training', planId: id, jobId: r.jobId, datasetId: r.datasetId, rowCount: r.rowCount })
+  return r
+})

package/server/api/workshop/aml/training-plans/[id].delete.ts

@@ -0,0 +1,18 @@
+/** DELETE /api/workshop/aml/training-plans/:id —— 删除建模任务 */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { deleteTrainingPlan, getTrainingPlan } from '@/server/services/workshop/aml/twin/training-plans'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+
+export default defineApiHandler((event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  if (!id) throw new AppError(400, 'VALIDATION_ERROR', 'plan id 必填')
+  if (!getTrainingPlan(id)) throw new AppError(404, 'AML_PLAN_MISSING', `建模任务 ${id} 不存在`)
+  if (user.role !== 'admin' && user.role !== 'editor') throw new AppError(403, 'FORBIDDEN', '建模任务删除需 admin/editor。')
+  const ok = deleteTrainingPlan(id)
+  broadcastSceneEvent('aml.plan', { action: 'deleted', planId: id })
+  return { ok }
+})

package/server/api/workshop/aml/training-plans/[id].patch.ts

@@ -0,0 +1,30 @@
+/** PATCH /api/workshop/aml/training-plans/:id —— 更新建模任务(固化训练 spec/策略/启停/目标) */
+import { z } from 'zod'
+import { getRouterParam, readValidatedBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { zValidator } from '@/server/utils/validate'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getTrainingPlan, updateTrainingPlan } from '@/server/services/workshop/aml/twin/training-plans'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+
+const schema = z.object({
+  name: z.string().min(1).max(120).optional(),
+  strategy: z.enum(['auto', 'manual']).optional(),
+  trainingSpec: z.record(z.string(), z.unknown()).nullable().optional(),
+  objectiveId: z.string().min(1).nullable().optional(),
+  minIntervalSec: z.number().int().min(60).optional(),
+  enabled: z.boolean().optional(),
+})
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readValidatedBody(event, zValidator(schema))
+  if (!id) throw new AppError(400, 'VALIDATION_ERROR', 'plan id 必填')
+  if (!getTrainingPlan(id)) throw new AppError(404, 'AML_PLAN_MISSING', `建模任务 ${id} 不存在`)
+  if (user.role !== 'admin' && user.role !== 'editor') throw new AppError(403, 'FORBIDDEN', '建模任务更新需 admin/editor。')
+  const plan = updateTrainingPlan(id, body)
+  broadcastSceneEvent('aml.plan', { action: 'updated', planId: plan.id, name: plan.name, status: plan.lastStatus })
+  return { plan }
+})

package/server/api/workshop/aml/training-plans/index.get.ts

@@ -0,0 +1,9 @@
+/** GET /api/workshop/aml/training-plans —— 建模任务列表(AML 界面「建模任务」区块数据源) */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { listTrainingPlans } from '@/server/services/workshop/aml/twin/training-plans'
+
+export default defineApiHandler((event) => {
+  resolveUser(event)
+  return { plans: listTrainingPlans() }
+})

package/server/api/workshop/aml/training-plans/index.post.ts

@@ -0,0 +1,43 @@
+/**
+ * POST /api/workshop/aml/training-plans —— 创建建模任务。
+ * body: { name, lineId, productId, recipeId, sceneId?, sceneVersion?, objectiveId?,
+ *         purpose?, strategy?, datasetSpec(AmlDatasetSpec), trainingSpec?(PhysicsSpec),
+ *         modelNamePrefix?, params?, seed?, minIntervalSec? }
+ * strategy=auto 需已固化 trainingSpec 才会在新批次时自动修正训练;manual 仅界面/工具触发。
+ */
+import { z } from 'zod'
+import { readValidatedBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { zValidator } from '@/server/utils/validate'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { createTrainingPlan } from '@/server/services/workshop/aml/twin/training-plans'
+import { parseDatasetSpec } from '@/server/services/workshop/aml/spec'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+
+const schema = z.object({
+  name: z.string().min(1).max(120),
+  lineId: z.string().min(1),
+  productId: z.string().min(1),
+  recipeId: z.string().min(1),
+  sceneId: z.string().min(1).optional(),
+  sceneVersion: z.string().min(1).optional(),
+  objectiveId: z.string().min(1).optional(),
+  purpose: z.enum(['mpc_surrogate', 'quality_predict']).optional(),
+  strategy: z.enum(['auto', 'manual']).optional(),
+  datasetSpec: z.record(z.string(), z.unknown()),
+  trainingSpec: z.record(z.string(), z.unknown()).optional(),
+  modelNamePrefix: z.string().max(80).optional(),
+  params: z.record(z.string(), z.unknown()).optional(),
+  seed: z.number().int().optional(),
+  minIntervalSec: z.number().int().min(60).optional(),
+})
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readValidatedBody(event, zValidator(schema))
+  if (user.role !== 'admin' && user.role !== 'editor') throw new AppError(403, 'FORBIDDEN', '建模任务创建需 admin/editor。')
+  const plan = createTrainingPlan({ ...body, datasetSpec: parseDatasetSpec(body.datasetSpec), createdBy: user.id })
+  broadcastSceneEvent('aml.plan', { action: 'created', planId: plan.id, name: plan.name, status: plan.lastStatus })
+  return { plan }
+})

package/server/api/workshop/aml/twin/providers.get.ts

@@ -0,0 +1,33 @@
+/**
+ * GET /api/workshop/aml/twin/providers
+ *
+ * Provider catalog for Channel designers, Agent discovery and hot-load
+ * observability. This endpoint is read-only; it never changes model or DCW state.
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getTwinProviderRegistry } from '@/server/services/workshop/aml/twin/provider-registry'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const query = getQuery(event)
+  const registry = getTwinProviderRegistry()
+  const providerId = typeof query.providerId === 'string' ? query.providerId : undefined
+  const version = typeof query.version === 'string' ? query.version : undefined
+  const providers = registry.listProviders({
+    ...(providerId ? { providerId } : {}),
+    ...(version ? { version } : {}),
+    includeDraining: query.includeDraining === 'true',
+    includeRetired: query.includeRetired === 'true',
+    includeFailed: true,
+  })
+  const health = providerId ? await registry.checkProviderHealth(providerId, version).catch(err => ({ status: 'failed', detail: err instanceof Error ? err.message : String(err) })) : null
+  return {
+    apiVersion: 'twin-provider.v1',
+    providers,
+    scenePacks: registry.listScenePacks(),
+    solverAdapters: registry.listSolverAdapters(),
+    ...(health ? { health } : {}),
+  }
+})

package/server/api/workshop/channel-templates/[id]/instantiate.post.ts

@@ -15,8 +15,14 @@ const instantiateSchema = z.object({
   scene: z.record(z.unknown()).optional(),
   promptVariables: z.record(z.unknown()).optional(),
   objective: z.record(z.unknown()).optional(),
-  toolProfile: z.string().optional(),
+  toolProfile: z.enum(['legacy', 'hybrid_twin', 'aml_training', 'aml_optimization']).optional(),
   controlPolicy: z.enum(['recommendation_only', 'hitl_governed', 'bounded_auto']).optional(),
+  providerId: z.string().min(1).optional(),
+  providerVersion: z.string().min(1).optional(),
+  providerHash: z.string().min(1).optional(),
+  scenePackId: z.string().min(1).optional(),
+  optimizationMode: z.enum(['exploration', 'aml']).optional(),
+  boundModelId: z.string().min(1).optional(),
 })
 
 export default defineApiHandler(async (event) => {
@@ -24,7 +30,7 @@ export default defineApiHandler(async (event) => {
   const user = resolveUser(event)
   const body = await readValidatedBody(event, zValidator(instantiateSchema))
   const manager = getWorkshopManager()
-  const result = await manager.instantiateChannelTemplate(templateId, user, body.name, { scene: body.scene, promptVariables: body.promptVariables, objective: body.objective, toolProfile: body.toolProfile, controlPolicy: body.controlPolicy })
+  const result = await manager.instantiateChannelTemplate(templateId, user, body.name, { scene: body.scene, promptVariables: body.promptVariables, objective: body.objective, toolProfile: body.toolProfile, controlPolicy: body.controlPolicy, providerId: body.providerId, providerVersion: body.providerVersion, providerHash: body.providerHash, scenePackId: body.scenePackId, optimizationMode: body.optimizationMode, boundModelId: body.boundModelId })
   // 模板含 lead 时直接启动调度循环(可提交任务)
   if (result.leadAgentId) {
     ensureLeadSchedulerLoop(manager, result.channelId)

package/server/api/workshop/channels/[id]/twin-profile.get.ts

@@ -0,0 +1,45 @@
+/**
+ * GET /api/workshop/channels/:id/twin-profile —— 读 Channel 的 AML 孪生 profile。
+ * 返回 profile/optimization_mode/objective/boundModelId/controlPolicy 与派生状态
+ * (mode: exploration|model_backed;绑定模型的概要)。供前端 Channel 设置面与徽章消费。
+ *
+ * ?agentId=<成员实例id> 时附加 promptPreview:该成员当前组装的工况提示词
+ * (prompt-composer 产出;模式/goal/绑定节点调试元数据),供设置面核对与验收断言。
+ */
+import { getRouterParam, getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getChannelTwinProfile } from '@/server/services/workshop/aml/twin/channel-profile'
+import { getAmlRuntime } from '@/server/services/workshop/aml/runtime'
+import { composeChannelSystemPrompt } from '@/server/services/workshop/aml/twin/prompt-composer'
+import { getWorkshopManager } from '@/server/plugins/workshop'
+
+export default defineApiHandler((event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  if (!id) throw new AppError(400, 'VALIDATION_ERROR', 'channel id 必填')
+  const q = getQuery(event)
+  const agentId = typeof q.agentId === 'string' ? q.agentId : ''
+  const p = getChannelTwinProfile(id)
+  const model = p.boundModelId ? getAmlRuntime().repo.model.get(p.boundModelId) : null
+  const mode = p.profile === 'aml_optimization'
+    ? (p.optimizationMode === 'aml' && p.boundModelId ? 'model_backed' : 'exploration')
+    : (p.profile === 'hybrid_twin' ? 'model_backed' : 'none')
+  let promptPreview: string | null = null
+  if (agentId) {
+    try {
+      const scenarioPrompt = getWorkshopManager().channelScenarioPrompt?.(id) ?? ''
+      promptPreview = composeChannelSystemPrompt(id, agentId, scenarioPrompt)
+    }
+    catch { /* manager 未就绪:预览缺省 */ }
+  }
+  return {
+    profile: p,
+    derived: {
+      mode,
+      boundModel: model ? { id: model.id, label: model.label, stage: model.stage, objectiveId: model.objectiveId } : null,
+      promptPreview,
+    },
+  }
+})

package/server/api/workshop/channels/[id]/twin-profile.patch.ts

@@ -0,0 +1,72 @@
+/**
+ * PATCH /api/workshop/channels/:id/twin-profile —— 更新 Channel 的 AML 孪生 profile。
+ *
+ * 支持三组互不冲突的更新(均可单独提交):
+ *  - optimizationMode: 'exploration'|'aml'(仅 aml_optimization profile;切 aml 需已有绑定或同请求绑定)
+ *  - objective: ObjectiveProfile(goal 下发;补齐历史缺口 —— 此前 objective 只能模板注入)
+ *  - boundModelId: 绑定/解绑模型。绑定 fail-closed 校验:谱系(产线)与场景一致 + Twin Gate
+ *    全过(recommendationEligible/uq/ood/physics)+ stage ∈ production/shadow,否则 409。
+ *    解绑(boundModelId=null)自动回落探索模式。
+ * controlPolicy 同步可改(治理档位)。
+ */
+import { z } from 'zod'
+import { getRouterParam, readValidatedBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { zValidator } from '@/server/utils/validate'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getChannelTwinProfile, setHybridChannelProfile, assertModelBindableToChannel } from '@/server/services/workshop/aml/twin/channel-profile'
+import { getWorkshopManager } from '@/server/plugins/workshop'
+
+const patchSchema = z.object({
+  optimizationMode: z.enum(['exploration', 'aml']).optional(),
+  controlPolicy: z.enum(['recommendation_only', 'hitl_governed', 'bounded_auto']).optional(),
+  objective: z.record(z.string(), z.unknown()).optional(),
+  boundModelId: z.string().min(1).nullable().optional(),
+})
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  if (!id) throw new AppError(400, 'VALIDATION_ERROR', 'channel id 必填')
+  const body = await readValidatedBody(event, zValidator(patchSchema))
+  const prev = getChannelTwinProfile(id)
+  if (prev.profile !== 'aml_optimization' && prev.profile !== 'hybrid_twin') {
+    throw new AppError(409, 'AML_PROFILE_NOT_TUNABLE', `Channel profile=${prev.profile} 无优化控制配置可更新(仅 aml_optimization/hybrid_twin)。`)
+  }
+  const next = { ...prev }
+
+  if (body.objective !== undefined) next.objective = body.objective
+  if (body.controlPolicy !== undefined) next.controlPolicy = body.controlPolicy
+
+  if (body.boundModelId !== undefined) {
+    if (body.boundModelId === null) {
+      next.boundModelId = undefined
+      next.boundAt = undefined
+      if (next.profile === 'aml_optimization') next.optimizationMode = 'exploration'
+    }
+    else {
+      if (prev.profile !== 'aml_optimization' && prev.profile !== 'hybrid_twin') throw new AppError(409, 'AML_BIND_NOT_OPTIMIZATION', '仅工艺优化 Channel 可绑定模型。')
+      const ok = assertModelBindableToChannel(id, body.boundModelId)
+      next.boundModelId = ok.modelId
+      next.boundAt = new Date().toISOString()
+      if (prev.profile === 'aml_optimization') next.optimizationMode = 'aml'
+    }
+  }
+  if (body.optimizationMode !== undefined) {
+    if (prev.profile !== 'aml_optimization') throw new AppError(409, 'AML_MODE_NOT_OPTIMIZATION', 'optimizationMode 仅适用于工艺优化 Channel。')
+    if (body.optimizationMode === 'aml' && !next.boundModelId) {
+      throw new AppError(409, 'AML_MODE_REQUIRES_MODEL', '切换到 aml 模式前需先绑定通过门禁的模型(同请求可一并提交 boundModelId)。')
+    }
+    next.optimizationMode = body.optimizationMode
+  }
+
+  setHybridChannelProfile({ ...next, createdBy: 'api' })
+  // 模式/绑定/goal 变更 → 回收成员运行时:下次装配由 prompt-composer 注入新工况提示词
+  try {
+    await getWorkshopManager().recycleChannelForTwinProfile(id)
+  }
+  catch { /* runtime 未就绪(如单测):跳过回收 */ }
+  const saved = getChannelTwinProfile(id)
+  return { profile: saved, mode: saved.optimizationMode === 'aml' && saved.boundModelId ? 'model_backed' : 'exploration' }
+})

package/server/plugins/00-local-time.ts

@@ -1,10 +1,13 @@
-/**
- * 本地时间安装(nitro 最早装载,文件名 00- 前缀保证排序第一):
- * 全项目 ISO 时间输出统一为本地系统时区(见 shared/local-time.mjs)。
- * 必须先于一切业务插件/路由/日志装载,否则启动期日志仍会输出 UTC。
- */
-import { installLocalIso } from '@/shared/local-time.mjs'
-
-export default function localTimePlugin(): void {
-  installLocalIso()
-}
+/**
+ * 本地时间安装(nitro 最早装载,文件名 00- 前缀保证排序第一):
+ * 全项目 ISO 时间输出统一为本地系统时区(见 shared/local-time.mjs)。
+ * 必须先于一切业务插件/路由/日志装载,否则启动期日志仍会输出 UTC。
+ */
+import { installLocalIso, setConfiguredTimeZone, DEFAULT_TIME_ZONE } from '@/shared/local-time.mjs'
+
+export default function localTimePlugin(): void {
+  // 00 插件必须保持纯启动底座:不能提前创建 SystemConfigService 单例,
+  // 否则后续 system-config 插件会误判已初始化而跳过 descriptor 加载。
+  setConfiguredTimeZone(DEFAULT_TIME_ZONE)
+  installLocalIso()
+}

package/server/plugins/aml-twin-worker.ts

@@ -0,0 +1,32 @@
+/**
+ * AML Twin 持续校准 worker 定时插件。
+ *
+ * 每 60s 消费 twin_update_runs 的 queued 信号 → 自动提交 hybrid_residual 重训候选
+ * (冻结场景 + 最新编译 PhysicsSpec + 该配方最新数据集);只产 candidate,晋升仍走
+ * HITL + Twin Gate。调度模式同 retention/backup:setInterval + globalThis key 防
+ * HMR 重复 + unref();AML_TWIN_WORKER_DISABLED=1 可整体关闭。
+ */
+import { processQueuedTwinUpdates } from '@/server/services/workshop/aml/twin/calibration-worker'
+import { processTrainingPlans } from '@/server/services/workshop/aml/twin/training-plans'
+import { amlTwinFeatureFlags } from '@/server/services/workshop/aml/twin/feature-flags'
+
+const g = globalThis as typeof globalThis & { __awAmlTwinWorkerTimer?: NodeJS.Timeout }
+
+function tick(): void {
+  try {
+    const flags = amlTwinFeatureFlags()
+    if (!flags.channelEnabled || !flags.trainingEnabled) return
+    processQueuedTwinUpdates()
+    // 建模任务编排(解耦计划):auto 策略的 plan 检测新批次 → 修正训练
+    processTrainingPlans()
+  }
+  catch { // AML runtime 未就绪(极早启动)或单测环境:静默跳过,下一拍重试
+  }
+}
+
+export default defineNitroPlugin(() => {
+  if (process.env.AML_TWIN_WORKER_DISABLED === '1') return
+  if (g.__awAmlTwinWorkerTimer) return
+  g.__awAmlTwinWorkerTimer = setInterval(tick, 60_000)
+  g.__awAmlTwinWorkerTimer.unref()
+})

package/server/plugins/aw-plugins.ts

@@ -4,10 +4,26 @@
  * 装载细节见 server/services/workshop/plugins/host.mjs(错误隔离:单插件失败不拖垮主服务)。
  */
 import { initPluginHost, shutdownPluginHost } from '@/server/services/workshop/plugins/host.mjs'
+import { attachTwinPluginBridge } from '@/server/services/workshop/aml/twin/provider-loader'
+import { servicesExt } from '@/server/services/workshop/plugins/host/services.mjs'
+import { InjectionGreyboxProvider, defaultInjectionScene } from '@/server/services/workshop/aml/twin/physics-runtime'
 import { fileURLToPath } from 'node:url'
 import { existsSync } from 'node:fs'
 import { dirname, resolve } from 'node:path'
 
+// Attach the Twin Provider Registry before plugin setup so external scene providers
+// registered by ctx.twin are replayed immediately (or queued safely when startup order changes).
+attachTwinPluginBridge()
+
+// Make the core implementation available to the bundled default plugin through
+// the same service boundary that external plugins use. The plugin itself owns
+// registration and disposal in the Twin Registry, so disable/reload semantics
+// are identical for bundled and external providers.
+servicesExt.register('twinCore', async () => ({
+  createInjectionProvider: () => new InjectionGreyboxProvider(),
+  defaultInjectionScene,
+}))
+
 // packageRoot = 本包根。nitro 打包后 import.meta.url 位于 .output/server/chunks/ 内,
 // 且 chunk 相对包根的层级随 nitro 版本变化(如 chunks/build/xxx.mjs 比源码布局深一层),
 // 固定 2/3 级上溯在**全局安装布局**(node_modules/agentworkshop/)下探测不到包根,