agentworkshop 0.2.1

package/scripts/test-persistence-lazy.ts

@@ -0,0 +1,323 @@
+/**
+ * 持久化 + 懒加载 Runtime 测试
+ *
+ * 验证:
+ *  A. 数据驱动持久化:channel/agent 创建即落库,重启(重建 manager)后可读回
+ *  B. 懒加载:创建后不装配运行时;任务提交才装配 lead + 调度循环;dispatch 才装配 worker
+ *  C. 卸载:任务完成后 unloadIdleAgents 释放运行时(杀 omp 进程),DB 行保留
+ *  D. CRUD:channel 增删改查 + agent 增删改查
+ *  E. restore:重建 manager 后,有待办任务的 channel 自动激活
+ *
+ * 运行: npx tsx scripts/test-persistence-lazy.ts
+ */
+import { rmSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
+import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { createTaskRepo } from '../server/services/workshop/db/task.repo'
+import { createMemoryRepo } from '../server/services/workshop/db/memory.repo'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+import { createTeamRepo } from '../server/services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createAgentChannelManager } from '../server/services/workshop/runtime/manager'
+import type { AgentChannelManager } from '../server/services/workshop/runtime/manager'
+import { createAgentImpl } from '../server/services/workshop/agents/factory'
+import type { WorkspaceTask } from '../server/services/workshop/types/task'
+
+let failures = 0
+let testCount = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  testCount += 1
+  console.log(`  ${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+async function waitUntil(cond: () => boolean | Promise<boolean>, timeoutMs: number): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (await cond()) return true
+    await sleep(50)
+  }
+  return false
+}
+
+function buildRepos(db: ReturnType<typeof openWorkshopDb>) {
+  return {
+    channels: createChannelRepo(db),
+    agents: createAgentRepo(db),
+    channelAgents: createChannelAgentRepo(db),
+    messages: createMessageRepo(db),
+    subscriptions: createSubscriptionRepo(db),
+    tasks: createTaskRepo(db),
+    memories: createMemoryRepo(db),
+
+    channelEvents: createChannelEventRepo(db),
+
+    teams: createTeamRepo(db),
+
+    teamMembers: createTeamMemberRepo(db),
+  }
+}
+
+function makeManager(db: ReturnType<typeof openWorkshopDb>): AgentChannelManager {
+  return createAgentChannelManager({ repos: buildRepos(db), implFactory: createAgentImpl, db })
+}
+
+function getEngine(manager: AgentChannelManager) {
+  return (manager as unknown as {
+    getTaskEngine(): {
+      get(id: string): WorkspaceTask | undefined
+      list(channelId: string): WorkspaceTask[]
+    }
+  }).getTaskEngine()
+}
+
+// ===== 测试 A+B: 持久化 + 懒加载 =====
+async function testPersistenceAndLazy(): Promise<void> {
+  console.log('\n━━━ 测试 A+B: 数据持久化 + 懒加载装配 ━━━')
+
+  const dbPath = resolve(process.cwd(), '.tmp-persist-test.sqlite')
+  rmSync(dbPath, { force: true })
+  rmSync(`${dbPath}-wal`, { force: true })
+  rmSync(`${dbPath}-shm`, { force: true })
+
+  const db1 = openWorkshopDb(dbPath)
+  const manager1 = makeManager(db1)
+  let channelId!: string
+  let leadId!: string
+  let workerId!: string
+
+  try {
+    // 1. 创建 channel + agents → 仅持久化,不装配
+    const ch = await manager1.createChannel({
+      name: '持久化测试',
+      leadAgent: { name: 'lead', harness: 'mock', config: { delayMs: 30 } },
+    })
+    channelId = ch.channelId
+    leadId = ch.leadAgentId!
+    const wTpl = await manager1.createAgent({ name: 'worker', harness: 'mock', config: { delayMs: 30 } })
+    const w = await manager1.addAgentToChannel({ channelId, agentId: wTpl.id, role: 'worker' })
+    workerId = w.id
+
+    const st1 = manager1.runtimeStatus()
+    check('创建后未装配任何运行时(懒加载)', st1.wiredAgents.length === 0 && st1.activeChannels.length === 0, `wired=${st1.wiredAgents.length}, active=${st1.activeChannels.length}`)
+
+    // 2. 提交任务 → 装配 lead + 调度循环
+    const task = await manager1.submitChannelTask({ channelId, title: '懒加载任务' })
+    const st2 = manager1.runtimeStatus()
+    check('任务提交后装配了 lead 运行时', st2.wiredAgents.includes(leadId), `wired=${st2.wiredAgents.length}`)
+    check('任务提交后 channel 活跃', st2.activeChannels.includes(channelId))
+
+    // 3. lead dispatch → worker 装配
+    await waitUntil(() => getEngine(manager1).get(task.id)?.state === 'COMPLETED', 10_000)
+    const st3 = manager1.runtimeStatus()
+    check('worker 执行期间被装配(懒加载)', st3.wiredAgents.includes(workerId) || st3.wiredAgents.includes(leadId), `wired=[${st3.wiredAgents.map(id => id.slice(0, 6)).join(',')}]`)
+
+    // 4. 任务完成后卸载
+    await sleep(100)
+    await manager1.unloadIdleAgents()
+    const st4 = manager1.runtimeStatus()
+    check('任务完成后可卸载(内存回收)', st4.wiredAgents.length === 0, `wired=${st4.wiredAgents.length}`)
+
+    // 5. 卸载后 DB 行保留(数据驱动)
+    const agentAfterUnload = manager1.getChannelAgent(workerId)
+    check('卸载后 agent DB 行保留', !!agentAfterUnload, `name=${agentAfterUnload?.name}`)
+    const chAfter = await manager1.getChannel(channelId)
+    check('卸载后 channel DB 行保留', chAfter.id === channelId)
+  }
+  finally {
+    // 完整关闭:busy 的 agent 仍在跑 consumeLoop,直接 close db 会用到已 finalize 的语句
+    await manager1.shutdown()
+    db1.close()
+  }
+
+  // 6. 重建 manager(模拟重启)→ 数据可读回
+  const db2 = openWorkshopDb(dbPath)
+  const manager2 = makeManager(db2)
+  try {
+    const channels = await manager2.listChannels()
+    check('重启后 channel 持久化读回', channels.length === 1 && channels[0]!.id === channelId)
+    const agents = await manager2.listChannelAgents(channelId)
+    check('重启后 agent 持久化读回', agents.length === 2)
+    check('重启后不自动装配(无待办任务)', manager2.runtimeStatus().wiredAgents.length === 0)
+  }
+  finally {
+    await manager2.shutdown()
+    db2.close()
+    rmSync(dbPath, { force: true })
+    rmSync(`${dbPath}-wal`, { force: true })
+    rmSync(`${dbPath}-shm`, { force: true })
+  }
+}
+
+// ===== 测试 C: restore 激活有待办任务的 channel =====
+async function testRestoreWithPending(): Promise<void> {
+  console.log('\n━━━ 测试 C: restore 激活有待办任务的 channel ━━━')
+
+  const dbPath = resolve(process.cwd(), '.tmp-restore-test.sqlite')
+  rmSync(dbPath, { force: true })
+  rmSync(`${dbPath}-wal`, { force: true })
+  rmSync(`${dbPath}-shm`, { force: true })
+
+  // 创建含未完成任务的 channel
+  const db1 = openWorkshopDb(dbPath)
+  const manager1 = makeManager(db1)
+  let channelId!: string
+  try {
+    const ch = await manager1.createChannel({ name: 'restore', leadAgent: { name: 'lead', harness: 'mock', config: { delayMs: 200 } } })
+    channelId = ch.channelId
+    const wTpl = await manager1.createAgent({ name: 'w', harness: 'mock', config: { delayMs: 200 } })
+    await manager1.addAgentToChannel({ channelId, agentId: wTpl.id, role: 'worker' })
+    // 提交一个任务但不完成(不等它完成就关闭)
+    const task = await manager1.submitChannelTask({ channelId, title: '未完成任务' })
+    // 等它被 dispatch 进入工作状态
+    await sleep(100)
+    check('关闭前有未完成任务', getEngine(manager1).get(task.id)?.state !== 'COMPLETED')
+  }
+  finally {
+    // 完整关闭:busy 的 agent 仍在跑 consumeLoop,直接 close db 会用到已 finalize 的语句
+    await manager1.shutdown()
+    db1.close()
+  }
+
+  // 重启:restore 应激活该 channel(有待办任务),且任务恢复执行至完成
+  const db2 = openWorkshopDb(dbPath)
+  const manager2 = makeManager(db2)
+  try {
+    manager2.restore()
+    const st = manager2.runtimeStatus()
+    check('restore 激活有待办任务的 channel', st.activeChannels.includes(channelId), `active=[${st.activeChannels.map(c => c.slice(0, 6)).join(',')}]`)
+    // 非终态任务经 restore 后必须恢复执行:调度循环重派 + worker 消费重投的 assign 消息
+    const done = await waitUntil(async () => {
+      const tasks = getEngine(manager2).list(channelId)
+      return tasks.some(t => t.state === 'COMPLETED')
+    }, 10_000)
+    check('restore 后任务恢复执行至 COMPLETED', done, '中途崩溃的任务不应滞留 ASSIGNED/WORKING')
+  }
+  finally {
+    await manager2.shutdown()
+    db2.close()
+    rmSync(dbPath, { force: true })
+    rmSync(`${dbPath}-wal`, { force: true })
+    rmSync(`${dbPath}-shm`, { force: true })
+  }
+}
+
+// ===== 测试 D: CRUD 完整 =====
+async function testCrud(): Promise<void> {
+  console.log('\n━━━ 测试 D: Channel + Agent CRUD ━━━')
+
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  const tmpWs = resolve(process.cwd(), '.tmp-crud-ws')
+  try {
+    // Channel create/list/get/update/delete
+    const ch = await manager.createChannel({ name: 'crud', description: '初始描述' })
+    check('channel create', !!ch.channelId)
+
+    const listed = await manager.listChannels()
+    check('channel list', listed.some(c => c.id === ch.channelId))
+
+    const got = await manager.getChannel(ch.channelId)
+    check('channel get', got.name === 'crud' && got.workspace.length > 0)
+
+    const updated = await manager.updateChannel(ch.channelId, { name: 'renamed', workspace: tmpWs })
+    check('channel update(name+workspace)', updated.name === 'renamed' && updated.workspace === tmpWs)
+
+    // Agent(模板)+ 实例 create/list/get/update/delete
+    const tpl = await manager.createAgent({ name: 'agent1', harness: 'mock', config: { k: 'v' } })
+    const agent = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: tpl.id, role: 'worker' })
+    check('agent create', !!agent.id && agent.id !== tpl.id)
+
+    const agentList = await manager.listChannelAgents(ch.channelId)
+    check('agent list', agentList.some(a => a.id === agent.id))
+
+    const agentGot = manager.getChannelAgent(agent.id)
+    check('agent get', agentGot?.name === 'agent1' && (agentGot.config as { k: string }).k === 'v')
+
+    const agentUpdated = await manager.updateChannelAgent(agent.id, { name: 'agent1-renamed', config: { k: 'v2' } })
+    check('agent update', agentUpdated.name === 'agent1-renamed' && (agentUpdated.config as { k: string }).k === 'v2')
+
+    await manager.removeAgentFromChannel(ch.channelId, agent.id)
+    check('agent delete', manager.getChannelAgent(agent.id) === undefined)
+
+    await manager.removeChannel(ch.channelId)
+    check('channel delete', (await manager.listChannels()).every(c => c.id !== ch.channelId))
+  }
+  finally {
+    await manager.unloadIdleAgents()
+    db.close()
+    rmSync(tmpWs, { recursive: true, force: true })
+  }
+}
+
+// ===== 测试 E: 禁用/启用 channel 与 agent =====
+async function testEnableDisable(): Promise<void> {
+  console.log('\n━━━ 测试 E: 启用/禁用控制 ━━━')
+
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  try {
+    const ch = await manager.createChannel({ name: 'en', leadAgent: { name: 'lead', harness: 'mock', config: {} } })
+    const wTpl = await manager.createAgent({ name: 'w', harness: 'mock', config: {} })
+    const w = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wTpl.id, role: 'worker' })
+
+    // 禁用实例
+    await manager.updateChannelAgent(w.id, { enabled: 0 })
+    const wDisabled = manager.getChannelAgent(w.id)
+    check('agent 禁用持久化', wDisabled?.wired === false)
+
+    // 禁用 channel
+    await manager.updateChannel(ch.channelId, { enabled: 0 })
+    const chDisabled = (await manager.listChannels()).find(c => c.id === ch.channelId)
+    check('channel 禁用持久化', chDisabled?.enabled === 0)
+
+    // 禁用的 channel 提交任务应失败(NO_LEAD_AGENT 之前会先检查 channel 是否有效)
+    let threw = false
+    try {
+      await manager.submitChannelTask({ channelId: ch.channelId, title: 'x' })
+    }
+    catch {
+      threw = true
+    }
+    check('禁用 channel 无法提交任务', threw)
+
+    // 重新启用
+    await manager.updateChannel(ch.channelId, { enabled: 1 })
+    await manager.updateChannelAgent(w.id, { enabled: 1 })
+    const chRe = (await manager.listChannels()).find(c => c.id === ch.channelId)
+    check('channel 重新启用', chRe?.enabled === 1)
+  }
+  finally {
+    await manager.unloadIdleAgents()
+    db.close()
+  }
+}
+
+// ===== main =====
+async function main(): Promise<void> {
+  console.log('╔════════════════════════════════════════════════════════════╗')
+  console.log('║  持久化 + 懒加载 Runtime 测试                               ║')
+  console.log('╚════════════════════════════════════════════════════════════╝')
+
+  await testPersistenceAndLazy()
+  await testRestoreWithPending()
+  await testCrud()
+  await testEnableDisable()
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log(`  ${failures === 0 ? `🎉 全部通过(${testCount} 项检查)` : `❌ ${failures}/${testCount} 项失败`}`)
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('测试异常:', e)
+  process.exit(1)
+})

package/scripts/test-prompt-system.mjs

@@ -0,0 +1,181 @@
+/**
+ * 提示词系统真实验证 —— 「发布说明团队」场景:
+ *
+ * 集成路径(模板管理 × Channel 场景 × 组合注入):
+ *  1. 创建 Agent 模板(模板库):tech-writer(专长:中文技术写作/要点式)——验证模板 config 注入
+ *  2. 创建 Channel(带 scenarioPrompt):发布说明规范(中文交付/[REL-DONE] 标记/百字内)
+ *  3. 从模板克隆 worker 进 channel(模板管理集成)
+ *  4. 终端镜像直接观测 worker 回合的完整 prompt:
+ *     五段式组合(Scenario Brief → Your Profile → 记忆 → System Manual → Assignment)
+ *  5. 任务交付验证:同时满足场景规范(中文/[REL-DONE]/简洁)与专长(要点式)
+ * 运行:node scripts/test-prompt-system.mjs
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3101'
+const PROVIDER = 'zhipu-coding-plan'
+const MODEL = 'glm-5-turbo'
+
+let failures = 0
+let passed = 0
+const check = (n, ok, d = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${n}${d ? ` — ${d}` : ''}`)
+  if (ok) passed += 1
+  else failures += 1
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+async function waitUntil(name, cond, timeoutMs, intervalMs = 3000) {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    const v = await cond().catch(() => null)
+    if (v) return v
+    await sleep(intervalMs)
+  }
+  throw new Error(`timeout: ${name}`)
+}
+const api = async (method, path, { body, token } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+async function main() {
+  console.log(`目标: ${BASE}(「发布说明团队」场景验证)\n`)
+  const user = await api('POST', '/api/workshop/users/register', { body: { name: `prompt-sys-${Date.now().toString(36)}` } })
+  const token = user.data.token
+
+  // ===== 1. Agent 模板(模板库):tech-writer 专长 prompt =====
+  const tpl = await api('POST', '/api/workshop/agents', {
+    token,
+    body: {
+      name: `tech-writer-${Date.now().toString(36)}`,
+      harness: 'omp',
+      config: {
+        provider: PROVIDER,
+        model: MODEL,
+        systemPromptPrefix: 'You are a senior technical writer. You ALWAYS write deliverables as markdown bullet points (- item), never long paragraphs. Your writing style is precise and minimal.',
+      },
+    },
+  })
+  const tplId = tpl.data?.id
+  check('1. Agent 模板创建(带专长 systemPromptPrefix)', tpl.code === 0 && !!tplId, `id=${tplId?.slice(0, 8)}`)
+
+  // ===== 2. Channel:发布说明团队场景 =====
+  const SCENARIO = [
+    '本团队负责产品发布说明(release notes)的撰写。',
+    '硬性规范:',
+    '1. 所有交付内容必须使用中文。',
+    '2. 每份最终交付的最后一行必须是指定标记 [REL-DONE]。',
+    '3. 交付正文不超过 100 字,聚焦用户可感知的变化。',
+    '4. 禁止出现实现细节(类名/函数名/内部术语)。',
+  ].join('\n')
+  const ch = await api('POST', '/api/workshop/channels', {
+    token,
+    body: {
+      name: `release-notes-${Date.now().toString(36)}`,
+      description: '发布说明团队',
+      scenarioPrompt: SCENARIO,
+      leadAgent: { name: 'rel-lead', harness: 'omp', config: { provider: PROVIDER, model: MODEL } },
+    },
+  })
+  const channelId = ch.data.channelId
+  check('2. Channel 创建(带 scenarioPrompt)', ch.code === 0 && !!channelId, `channel=${channelId.slice(0, 8)}`)
+
+  // ===== 3. 从模板克隆 worker(模板管理集成) =====
+  const w = await api('POST', `/api/workshop/channels/${channelId}/agents`, {
+    token,
+    body: { agentId: tplId, role: 'worker' },
+  })
+  const workerId = w.data?.id
+  check('3. 模板克隆 worker 进 channel', w.code === 0 && !!workerId, `worker=${workerId?.slice(0, 8)}`)
+  const members = await api('GET', `/api/workshop/channels/${channelId}/agents`, { token })
+  const workerMeta = (members.data ?? []).find(m => m.id === workerId)
+  check('3. 克隆实例携带模板 config(专长 prompt)', String(workerMeta?.config?.systemPromptPrefix ?? '').includes('markdown bullet points'))
+
+  // ===== 4. 提交任务 + 终端观测注入 =====
+  const task = await api('POST', `/api/workshop/channels/${channelId}/tasks`, {
+    token,
+    body: {
+      title: '撰写 v2.1 发布说明',
+      description: '基于以下变化撰写发布说明:新增深色主题、修复导出失败问题、性能提升约 30%。',
+    },
+  })
+  const parentId = task.data.id
+  check('4. 任务提交', task.code === 0)
+
+  // 等 worker 进程 spawn,然后经终端镜像读取其回合并 prompt
+  const termWs = async () => {
+    const t = await api('GET', `/api/workshop/channels/${channelId}/terminals`, { token })
+    const worker = (t.data ?? []).find(x => x.agentId === workerId)
+    if (!worker) return null
+    return new Promise((resolve) => {
+      const frames = []
+      const ws = new WebSocket(`ws://127.0.0.1:3101/api/system/monitor/terminal/ws?agentId=${workerId}&channelId=${channelId}&token=${token}`)
+      ws.onmessage = (ev) => {
+        const m = JSON.parse(ev.data)
+        if (m.type === 'term.frames') frames.push(...m.frames)
+      }
+      ws.onopen = () => setTimeout(() => {
+        ws.close()
+        resolve(frames)
+      }, 1500)
+      ws.onerror = () => resolve(null)
+    })
+  }
+  const promptFrames = await waitUntil('worker prompt 帧出现', async () => {
+    const frames = await termWs()
+    if (!frames) return null
+    const userMsg = frames.find(f => f.frame.type === 'message_start' && f.frame.role === 'user'
+      && String(f.frame.text ?? '').includes('Your Assignment'))
+    return userMsg ? String(userMsg.frame.text) : null
+  }, 300_000, 8000)
+
+  // ===== 五段式注入观测(直接证据) =====
+  check('4a. Scenario Brief 段注入(channel 场景)', promptFrames.includes('Scenario Brief') && promptFrames.includes('[REL-DONE]') && promptFrames.includes('不超过 100 字'))
+  check('4b. Your Profile 段注入(模板专长)', promptFrames.includes('Your Profile') && promptFrames.includes('markdown bullet points'))
+  check('4c. Workshop System Manual 段注入', promptFrames.includes('Workshop System Manual') && promptFrames.includes('complete_task'))
+  check('4d. 段序正确(场景 → 专长 → 手册 → 任务)', (() => {
+    const iScenario = promptFrames.indexOf('Scenario Brief')
+    const iProfile = promptFrames.indexOf('Your Profile')
+    const iManual = promptFrames.indexOf('Workshop System Manual')
+    const iAssign = promptFrames.indexOf('Your Assignment')
+    return iScenario >= 0 && iScenario < iProfile && iProfile < iManual && iManual < iAssign
+  })())
+
+  // ===== 5. 交付验证 =====
+  const final = await waitUntil('父任务终态', async () => {
+    const ts = (await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })).data ?? []
+    const t = ts.find(x => x.id === parentId)
+    return ['COMPLETED', 'FAILED', 'CANCELED'].includes(t?.state ?? '') ? t.state : null
+  }, 480_000)
+  check('5a. 任务完成(host tool 声明式)', final === 'COMPLETED', `state=${final}`)
+
+  const ts = (await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })).data ?? []
+  const child = ts.find(t => t.parentId === parentId && t.state === 'COMPLETED' && (t.artifacts?.length ?? 0) > 0)
+  /** 交付原始正文(artifact parts 文本,非 JSON 转义——转义会破坏行首匹配) */
+  const deliverableRaw = child
+    ? (child.artifacts ?? []).map(a => (a.parts ?? []).map(p => p.text ?? '').join('\n')).join('\n')
+    : ''
+  const deliverable = deliverableRaw
+  const evs = (await api('GET', `/api/workshop/channels/${channelId}/events?limit=300`, { token })).data?.items ?? []
+  const corpus = deliverable + JSON.stringify(evs.flatMap(e => [e.payload?.delta, e.payload?.parts]))
+  check('5b. 交付为中文(场景规范 1)', /[\u4e00-\u9fa5]{6,}/.test(deliverable) && !/^[ -~\s]*$/.test(deliverable.trim()))
+  check('5c. 交付末尾含 [REL-DONE](场景规范 2)', deliverable.trimEnd().endsWith('[REL-DONE]'))
+  check('5d. 要点式交付(模板专长:bullet)', /(^|\n)\s*[-•]\s/.test(corpus))
+  const deliverableBody = deliverable.replace(/\\n/g, '\n').replace(/[^\u4e00-\u9fa5]/g, '')
+  check('5e. 正文简洁 ≤100 字量级(场景规范 3)', deliverableBody.length <= 220, `汉字数=${deliverableBody.length}`)
+  check('5f. 无实现细节泄漏(场景规范 4:无类名/函数名)', !/[A-Za-z]+\.(ts|vue|js)|function\s+\w+|class\s+\w+/.test(deliverable))
+
+  // ===== 清理 =====
+  for (const m of members.data ?? []) {
+    await api('POST', '/api/system/monitor/terminate', { token, body: { channelId, agentId: m.id } }).catch(() => {})
+  }
+  await api('DELETE', `/api/workshop/agents/${tplId}`, { token })
+  await api('DELETE', `/api/workshop/channels/${channelId}`, { token })
+  console.log(`\n★ 提示词系统验证: ${passed} passed, ${failures} failed`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('异常:', err.message)
+  process.exit(1)
+})

package/scripts/test-prompts-loader.ts

@@ -0,0 +1,56 @@
+/**
+ * Prompt 外置化回归 — 验证 `.AgentWorkShop/prompts/` 加载与渲染完整性:
+ *  R1. 全部必需 prompt 文件存在(12 md + host-tools.json)
+ *  R2. renderPrompt 变量替换正确(值注入/缺省空串/空白容忍)
+ *  R3. host-tools.json 可解析:20 个工具、字段完整、lead 专属集合覆盖
+ *  R4. 渲染结果无残留 {{}} 占位(缺 var 检测)
+ *  R5. 内容完整性:关键指令标记在各 prompt 中存在
+ * 运行:pnpm exec tsx scripts/test-prompts-loader.ts
+ */
+import { renderPrompt, loadHostToolDefs, listPromptNames } from '../server/services/workshop/prompts/loader'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  [${ok ? 'PASS' : 'FAIL'}] ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const REQUIRED = [
+  'scenario-default', 'system-manual', 'worker-workflow', 'lead-supervise',
+  'peer-message', 'peer-reply-required', 'peer-reply-optional', 'peer-lead-roster',
+  'team-roster', 'mode-goal', 'mode-loop', 'mode-pipeline',
+]
+
+console.log('R1. 文件完整性')
+const names = listPromptNames()
+check('全部必需 md 存在', REQUIRED.every(r => names.includes(r)), `found=${names.length}: ${names.join(',')}`)
+
+console.log('R2. 模板渲染')
+const w = renderPrompt('worker-workflow', { agentName: 'w1', channelId: 'c1', taskId: 't1', taskText: '写发布说明' })
+check('变量注入', w.includes('"w1"') && w.includes('c1') && w.includes('t1') && w.includes('写发布说明'))
+check('无残留占位', !/\{\{/.test(w))
+const partial = renderPrompt('peer-message', { fromId: 'x' })
+check('缺省变量 → 空串(不残留)', !/\{\{/.test(partial) && partial.includes('from: x'))
+
+console.log('R3. host-tools.json')
+const tools = loadHostToolDefs()
+check('20 个工具', tools.length === 20, `count=${tools.length}`)
+check('字段完整', tools.every(t => t.name && t.description && t.parameters && typeof t.parameters === 'object'))
+const LEAD_ONLY = ['dispatch_task', 'get_queue_overview', 'read_channel_mail', 'reassign_task', 'update_task', 'create_team_agent', 'update_team_agent', 'remove_team_agent']
+check('lead 专属工具全部在列', LEAD_ONLY.every(n => tools.some(t => t.name === n)))
+
+console.log('R4. 关键内容标记')
+check('scenario-default 含通用作业规范', renderPrompt('scenario-default').includes('General operating rules'))
+check('system-manual 含平台机制', renderPrompt('system-manual').includes('Task lifecycle') && renderPrompt('system-manual').includes('Anti-duplicate'))
+check('system-manual 含信箱 FIFO/实时模型', renderPrompt('system-manual').includes('FIFO') && renderPrompt('system-manual').includes('wait_seconds'))
+check('lead-supervise 含协调纪律', renderPrompt('lead-supervise').includes('COORDINATOR'))
+check('lead-supervise 含委托质量契约', renderPrompt('lead-supervise').includes('Delegation Quality') && renderPrompt('lead-supervise').includes('Boundaries'))
+check('lead-supervise 含路由纪律(route_reason + 证据选人)', renderPrompt('lead-supervise').includes('route_reason') && renderPrompt('lead-supervise').includes('capability profile'))
+check('dispatch_task 含 route_reason 参数', loadHostToolDefs().some(t => t.name === 'dispatch_task' && JSON.stringify(t.parameters).includes('route_reason')))
+check('worker-workflow 含协作等待规范', renderPrompt('worker-workflow', { agentName: 'w', channelId: 'c', taskId: 't', taskText: 'x' }).includes('wait_seconds'))
+check('team-roster 名册含通信规范', renderPrompt('team-roster', { rosterLines: '- id: a1 | w1 | role=worker' }).includes('role=worker') && renderPrompt('team-roster', { rosterLines: 'x' }).includes('wait_seconds'))
+check('mode-goal 含结语要求', renderPrompt('mode-goal', { criteria: 'X' }).includes('FINAL CONCLUSION') && renderPrompt('mode-goal', { criteria: 'X' }).includes('X'))
+check('mode-loop 间隔注入', renderPrompt('mode-loop', { interval: 5 }).includes('every 5s'))
+
+console.log(failures === 0 ? '\n★ prompt 外置化回归通过' : `\n${failures} 项失败`)
+process.exit(failures === 0 ? 0 : 1)