agentworkshop 0.7.4 → 0.7.5

package/cli/commands/stop.mjs

@@ -0,0 +1,108 @@
+// ============================================================
+// 指令:stop —— 终止当前配置根下运行中的 aw 实例(读单实例锁 → 终止进程树)。
+// 用法:aw stop [--home]   (--home 强制以 home 配置根为目标;默认随 cwd 解析)
+// ============================================================
+import { existsSync, readFileSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { color } from '../core/logger.mjs'
+
+export const meta = {
+  name: 'stop',
+  aliases: [],
+  group: '服务',
+  summary: '终止运行中的 aw 服务实例(读单实例锁)',
+  usage: 'aw stop [--home]',
+  needsProject: false,
+}
+
+function pidAlive(pid) {
+  try {
+    process.kill(pid, 0)
+    return true
+  }
+  catch (err) {
+    return err?.code === 'EPERM'
+  }
+}
+
+/** 终止进程树:Windows taskkill /T /F;POSIX 先 SIGTERM 宽限 5s 再 SIGKILL */
+function killTree(pid) {
+  if (process.platform === 'win32') {
+    const r = spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { encoding: 'utf8' })
+    if (r.status !== 0) throw new Error((r.stderr || r.stdout || 'taskkill 失败').trim().split(/\r?\n/)[0])
+    return
+  }
+  try {
+    process.kill(pid, 'SIGTERM')
+  }
+  catch { /* 已死 */ }
+  const deadline = Date.now() + 5000
+  while (Date.now() < deadline && pidAlive(pid)) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 200)
+  }
+  if (pidAlive(pid)) {
+    try {
+      process.kill(pid, 'SIGKILL')
+    }
+    catch { /* 已死 */ }
+  }
+}
+
+export async function run(argv, ctx) {
+  // argv 为 parseArgs 结果({ flags, positionals, unknown });兼容裸数组调用
+  const flags = argv?.flags ?? {}
+  const positionals = Array.isArray(argv?.positionals) ? argv.positionals : (Array.isArray(argv) ? argv : [])
+  const forceHome = flags.home === true || positionals.includes('--home')
+
+  const configRoot = forceHome
+    ? ctx.home
+    : (ctx.mode === 'repo' ? join(ctx.root, '.AgentWorkShop') : ctx.home)
+  const lockPath = join(configRoot, '.runtime', 'aw.lock')
+
+  if (!existsSync(lockPath)) {
+    console.log(`${color.blue('ℹ')} 未发现运行中的实例(无锁文件:${lockPath})`)
+    return 0
+  }
+  let holder
+  try {
+    holder = JSON.parse(readFileSync(lockPath, 'utf8'))
+  }
+  catch {
+    rmSync(lockPath, { force: true })
+    console.log(`${color.blue('ℹ')} 锁文件损坏,已清除:${lockPath}`)
+    return 0
+  }
+
+  const pid = Number(holder?.pid)
+  if (!Number.isInteger(pid) || pid <= 0) {
+    rmSync(lockPath, { force: true })
+    console.log(`${color.blue('ℹ')} 锁内 PID 无效,已清除锁文件`)
+    return 0
+  }
+  if (!pidAlive(pid)) {
+    rmSync(lockPath, { force: true })
+    console.log(`${color.blue('ℹ')} 持锁进程已不存在(pid=${pid},残留锁),已清除锁文件`)
+    return 0
+  }
+
+  console.log(`› 终止实例 pid=${pid}(mode=${holder.mode ?? '?'}${holder.port ? `,端口=${holder.port}` : ''},启动于 ${holder.startedAt ?? '?'})`)
+  try {
+    killTree(pid)
+  }
+  catch (err) {
+    console.error(`${color.red('✖')} 终止失败:${err.message}`)
+    console.error(`  可手动执行:taskkill /PID ${pid} /T /F(Windows)`)
+    return 1
+  }
+  // 锁文件由退出钩子自清;残留则手动兜底
+  for (let i = 0; i < 20 && existsSync(lockPath); i++) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 200)
+  }
+  try {
+    if (existsSync(lockPath)) rmSync(lockPath, { force: true })
+  }
+  catch { /* ignore */ }
+  console.log(`${color.green('✔')} 实例已停止(pid=${pid})`)
+  return 0
+}

package/config.yml

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

package/package.json

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

package/scripts/e2e-aw-tui-global.mjs

@@ -0,0 +1,277 @@
+/**
+ * 全局 `aw tui` 完整 E2E(用户真实路径:npm i -g agentworkshop → aw tui):
+ *   node scripts/e2e-aw-tui-global.mjs [--base http://127.0.0.1:3000]
+ *
+ * 前置:全局已安装 agentworkshop@0.7.4(npm root -g 可解析);dev/prod 服务运行。
+ * 场景:加载【全局包】的 tui 入口(非仓库源码)→ 建频道(内联 omp lead)→
+ *       成员列表 → 任务下发(触发 omp spawn)→ /monitor 独立监控接入 →
+ *       /send 注入 ask → /hitl 定位作答 → REST 确认落定 → 终端帧证实答案
+ *       回传 agent → /task 正式任务 + /tasks 列表 → /monitor off → 清理。
+ */
+import { execSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { pathToFileURL } from 'node:url'
+import { join } from 'node:path'
+
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3000'
+})()
+// --repo:加载仓库源码的 tui(开发验证新交互);默认加载全局安装包(用户真实路径)
+const USE_REPO = process.argv.includes('--repo')
+const WS_BASE = BASE.replace(/^http/, 'ws')
+const TAG = Date.now().toString(36)
+const ASK_INSTRUCTION = 'Use the ask tool NOW to ask me: Deploy? with options go and abort. After I answer, call complete_task with the deliverable set to my answer.'
+
+let failures = 0
+let passed = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) passed += 1
+  else failures += 1
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function waitUntil(name, cond, timeoutMs = 300_000, intervalMs = 1000) {
+  const deadline = Date.now() + timeoutMs
+  let last = null
+  while (Date.now() < deadline) {
+    try {
+      last = await cond()
+      if (last) return last
+    }
+    catch (e) { last = e }
+    await sleep(intervalMs)
+  }
+  throw new Error(`waitUntil timeout: ${name} (last=${String(last).slice(0, 200)})`)
+}
+
+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(() => ({}))) }
+}
+
+/** 终端 WS(答案回传验证用) */
+function openTerm(agentId, channelId, token) {
+  const messages = []
+  const ws = new WebSocket(`${WS_BASE}/api/system/monitor/terminal/ws?agentId=${agentId}&channelId=${channelId}&token=${encodeURIComponent(token)}`)
+  ws.addEventListener('message', (ev) => {
+    try {
+      messages.push(JSON.parse(ev.data))
+    }
+    catch { /* ignore */ }
+  })
+  return { ws, messages, frames: () => messages.filter(m => m.type === 'term.frames').flatMap(m => m.frames) }
+}
+
+/** 解析 TUI 入口:--repo = 仓库源码;默认 = 全局安装包(用户 `aw tui` 的真实加载路径) */
+function tuiEntry() {
+  if (USE_REPO) {
+    const entry = join(process.cwd(), 'tui', 'aw-tui.mjs')
+    return { entry, ok: existsSync(entry), repo: true }
+  }
+  const root = execSync('npm root -g', { encoding: 'utf8' }).trim()
+  const entry = join(root, 'agentworkshop', 'tui', 'aw-tui.mjs')
+  return { entry, ok: existsSync(entry), repo: false }
+}
+
+async function main() {
+  console.log(`\n━━━ 全局 aw tui 完整 E2E @ ${BASE} ━━━`)
+
+  // 0. 入口存在(全局包 = 0.7.4 发布包含 tui/;repo = 源码)
+  const g = tuiEntry()
+  check(`0.1 TUI 入口存在(${g.repo ? '仓库源码' : '全局包'})`, g.ok, g.entry)
+  if (!g.ok) process.exit(1)
+
+  // 登录
+  const reg = await api('POST', '/api/users/register', {
+    body: { email: `awtui-${TAG}@test.local`, password: 'Passw0rd!123', name: `awtui-${TAG}` },
+  })
+  const token = reg.data?.token
+  if (!token) throw new Error(`注册失败: ${JSON.stringify(reg).slice(0, 160)}`)
+
+  // 0.2 预建一个频道(启动频道选择器需要至少一个可选项;全局包模式同样受益)
+  const bootCh = (await api('POST', '/api/workshop/channels', {
+    body: { name: `awtui-boot-${TAG}`, description: '启动选择器测试频道' },
+    token,
+  })).data
+  check('0.2 预建启动频道', Boolean(bootCh?.channelId), `id=${bootCh?.channelId?.slice(0, 8)}`)
+
+  // 1. 加载 TUI,headless 驱动
+  const mod = await import(pathToFileURL(g.entry).href)
+  await mod.main(['--headless', '--url', BASE, '--token', token, '--channel', ''])
+  const vt = globalThis.__tuiSmokeTerminal
+  const type = async (text) => {
+    for (const c of text) vt.emitInput(c)
+    await sleep(50)
+    vt.emitInput('\r')
+    await sleep(400)
+  }
+  const waitTui = async (needle, timeoutMs = 300_000) => {
+    const deadline = Date.now() + timeoutMs
+    while (Date.now() < deadline) {
+      if (vt.text().includes(needle)) return true
+      await sleep(500)
+    }
+    return false
+  }
+  check('1.1 TUI 启动就绪', await waitTui('TUI 已就绪', 30_000), g.entry.slice(-60))
+
+  // 1.2 [新交互] 启动频道选择器:↑↓ + Enter 选择预建频道;Esc 自动进第一个
+  if (USE_REPO) {
+    check('1.2 启动弹出频道选择器', await waitTui('选择要进入的频道', 20_000))
+    vt.emitInput('\x1b[B') // 下移一次,选中第二个(证明方向键导航)
+    await sleep(200)
+    vt.emitInput('\r')
+    check('1.3 Enter 进入所选频道', await waitTui('已切换到频道「', 30_000))
+  }
+  else {
+    check('1.2 (全局包)自动接入频道', await waitTui('已切换到频道「', 30_000))
+  }
+
+  // 2. Channel 操作:列表 + 创建(内联 omp lead)+ 自动切换
+  await type('/channels')
+  check('2.1 /channels 列出频道', await waitTui('个:', 15_000))
+  const channelName = `awtui-e2e-${TAG}`
+  await type(`/channel new ${channelName} --lead 领航员 全局tui端到端频道`)
+  check('2.2 /channel new 创建成功', await waitTui('✔ 频道已创建', 30_000))
+  check('2.3 自动切换到新频道', await waitTui(`已切换到频道「${channelName}」`, 30_000))
+
+  // 2.4 [新交互] /channel use 无参 → 频道选择器 → 方向键导航到目标频道 → Enter
+  // (SelectList 的可打印字符过滤不生效,导航用方向键;序号按 REST 顺序计算)
+  if (USE_REPO) {
+    await type('/channel use')
+    check('2.4 /channel use 弹出频道选择器', await waitTui('选择要进入的频道', 20_000))
+    const order = (await api('GET', '/api/workshop/channels', { token })).data ?? []
+    const downTimes = Math.max(0, order.findIndex(c => c.name === channelName))
+    for (let i = 0; i < downTimes; i++) {
+      vt.emitInput('\x1b[B')
+      await sleep(150)
+    }
+    await sleep(200)
+    vt.emitInput('\r')
+    await sleep(800)
+    check('2.5 方向键选择后频道正确', await waitTui(`已切换到频道「${channelName}」`, 20_000))
+  }
+
+  // 3. Agent 操作:成员列表出现内联建的 omp lead(选择器切换后刷新有竞态,轮询重发)
+  {
+    const ok = await waitUntil('3.1 /agents 出现 lead 成员', async () => {
+      await type('/agents')
+      return vt.text().includes('领航员(lead)') ? true : null
+    }, 30_000).catch(() => null)
+    check('3.1 /agents 出现 lead 成员', ok === true)
+  }
+
+  // 4. 任务下发:普通文本 → lead(触发 omp spawn)
+  await type('请保持待命,等待操作员通过终端下达进一步指令。')
+  console.log('  … 等待 omp spawn(冷启动可达 2-3 分钟)…')
+  const ch = (await api('GET', '/api/workshop/channels', { token })).data?.find?.(c => c.name === channelName)
+    ?? (await api('GET', '/api/workshop/channels', { token })).data?.at(-1)
+  const channelId = ch?.id
+  const members = channelId ? (await api('GET', `/api/workshop/channels/${channelId}/agents`, { token })).data ?? [] : []
+  const lead = members.find(a => a.role === 'lead')
+  check('4.1 频道/lead 实例可查(REST 交叉核对)', Boolean(lead?.id), `lead=${lead?.id?.slice(0, 8)}`)
+
+  const spawnOk = await waitUntil('4.2 omp 进程 spawn', async () => {
+    const mon = await api('GET', '/api/system/monitor', { token })
+    return (mon.data?.processes ?? []).find(p => p.harness === 'omp' && p.alive && p.agentId === lead?.id) ? true : null
+  }, 300_000).catch(() => null)
+  check('4.2 omp 进程 spawn(REST 监控)', spawnOk === true)
+
+  // 5. 独立 monitor:/monitor 领航员 → 终端面板接入
+  await type('/monitor 领航员')
+  check('5.1 /monitor 面板开启', await waitTui('监控已开启:领航员', 20_000))
+  const termConnected = await waitTui('已接入 领航员', 120_000)
+  check('5.2 监控面板接入 omp 会话(term.init)', termConnected)
+
+  // 6. HITL:等首回合结束 → /send 注入 ask → /hitl 定位作答
+  const idleOk = await waitUntil('6.1 lead 首回合结束(idle)', async () => {
+    const terms = await api('GET', `/api/workshop/channels/${channelId}/terminals`, { token })
+    const mine = (terms.data ?? []).find(t2 => t2.agentId === lead?.id)
+    return mine && mine.running === false ? true : null
+  }, 300_000).catch(() => null)
+  check('6.1 lead 空闲(可注入)', idleOk === true)
+  await sleep(1500)
+  await type(`/send 领航员 ${ASK_INSTRUCTION}`)
+  check('6.2 /send 直发回执', await waitTui('✔ 已直发 领航员', 30_000))
+
+  const item = await waitUntil('6.3 HITL 待办到达(REST Deploy?)', async () => {
+    const p = await api('GET', `/api/workshop/hitl/pending?channelId=${channelId}`, { token })
+    return (p.data?.items ?? []).find(i => String(i.title).includes('Deploy?')) ?? null
+  }, 300_000).catch(() => null)
+  check('6.3 omp ask → 全局待办(Deploy?)', Boolean(item), item ? `method=${item.method} options=${JSON.stringify(item.options)}` : 'timeout')
+
+  await type('/hitl')
+  check('6.4 /hitl 列表渲染', await waitTui('待人工处理', 20_000))
+  const row = await waitUntil('6.5 列表出现 Deploy? 行', () => {
+    const m = vt.text().match(/(\d+)\. \[omp-dialog\] Deploy\?/)
+    return m ? m[1] : null
+  }, 60_000).catch(() => null)
+  check('6.5 目标待办行定位', Boolean(row), `序号=${row}`)
+  await type(`/hitl ${row}`)
+  check('6.6 进入作答卡', await waitTui('HITL 作答', 20_000))
+  await type('1')
+  check('6.7 应答提交回执(选项 1 = go)', await waitTui('应答已提交', 30_000))
+  if (failures > 0) console.log('[diag 6.7 tail]', JSON.stringify(vt.text().slice(-700)))
+
+  const cleared = await waitUntil('6.8 REST 待办不再含 Deploy?', async () => {
+    const p = await api('GET', `/api/workshop/hitl/pending?channelId=${channelId}`, { token })
+    return ((p.data?.items ?? []).every(i => !String(i.title).includes('Deploy?'))) ? true : null
+  }, 60_000).catch(() => null)
+  check('6.8 应答写入服务端(待办落定)', cleared === true)
+
+  // 6.9 答案回传 agent 铁证:ask 工具结果含 go(独立终端 WS 帧)
+  const term = openTerm(lead.id, channelId, token)
+  const askFed = await waitUntil('6.9 ask 工具收到 go(终端帧)', () => {
+    const list = term.frames().filter(f => f.frame.type === 'tool_execution_end' && String(f.frame.toolName) === 'ask')
+    const lastAsk = list.at(-1)
+    return lastAsk ? String(lastAsk.frame.result ?? '').toLowerCase().includes('go') : null
+  }, 120_000).catch(() => null)
+  check('6.9 闭环:答案回传 agent(ask 结果含 go)', Boolean(askFed))
+
+  // 6.10-6.14 [新交互] Tab 目标选择器 + 通信/任务分流(仓库源码特性)
+  if (USE_REPO) {
+    vt.emitInput('\t')
+    check('6.10 Tab 呼出目标选择器', await waitTui('选择对话目标', 20_000))
+    vt.emitInput('\x1b[B')
+    await sleep(200)
+    vt.emitInput('\r')
+    check('6.11 选成员 → 通信模式 + 自动开监控', await waitTui('监控已开启:领航员', 20_000) && await waitTui('@领航员(通信)', 20_000))
+    await type('你在吗?看到请回应')
+    check('6.12 普通文本按通信直发目标', await waitTui('通信消息已发 → @领航员', 30_000))
+    vt.emitInput('\t')
+    await waitTui('选择对话目标', 20_000)
+    vt.emitInput('\r')
+    await sleep(400)
+    check('6.13 选频道 → 重置任务模式', await waitTui('频道(任务)', 20_000))
+    await type('/msg 心跳检查,请确认收到')
+    check('6.14 /msg 通信消息(目标重置后路由 lead)', await waitTui('通信消息已发 → @', 30_000))
+  }
+
+  // 7. 正式任务 + 任务列表
+  await type('/task 汇报当前待命状态')
+  check('7.1 /task 正式任务提交', await waitTui('✔ 任务已发布', 30_000))
+  await type('/tasks')
+  check('7.2 /tasks 列表出现任务', await waitTui('汇报当前待命状态', 30_000))
+
+  // 8. monitor 关闭 + 清理
+  await type('/monitor off')
+  check('8.1 /monitor off 关闭', await waitTui('监控面板已关闭', 20_000))
+  await api('DELETE', `/api/workshop/channels/${channelId}?purge=1`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/channels/${bootCh.channelId}?purge=1`, { token }).catch(() => {})
+
+  console.log(`\n━━━ 结果: ${passed} passed / ${failures} failed ━━━`)
+  console.log('(经 /quit 退出全局 TUI 进程)')
+  if (failures > 0) process.exit(1)
+  await type('/quit')
+  console.log('[warn] /quit 未按预期退出,兜底退出')
+  process.exit(0)
+}
+
+main().catch((err) => {
+  console.error('FATAL', err.message)
+  process.exit(1)
+})

package/scripts/test-tui-commands.mjs

@@ -39,6 +39,7 @@ function mockCtx() {
     tasks: [],
     hitl: [],
     hitlAnswering: null,
+    target: null,
     log: [],
     userName: '张伟',
   }
@@ -123,6 +124,22 @@ ctx.state.hitl = [{ kind: 'omp-dialog', id: 'd1', method: 'confirm', title: '确
 await dispatchCommand(ctx, '/hitl 1')
 check('/hitl 进入作答模式', ctx.state.hitlAnswering?.id === 'd1')
 
+ctx = mockCtx()
+await dispatchCommand(ctx, '/msg 心跳检查,请确认')
+const msg = ctx.calls.find(c => c.send)
+check('/msg 缺省路由 lead(immediate)', msg?.send?.toAgentId === 'agt-1' && msg?.send?.priority === 'immediate')
+
+ctx = mockCtx()
+await dispatchCommand(ctx, '/msg 调度长 收到请回答')
+const msg2 = ctx.calls.find(c => c.send)
+check('/msg 指定成员', msg2?.send?.toAgentId === 'agt-1')
+
+ctx = mockCtx()
+ctx.state.target = { agentId: 'agt-1', name: '调度长' }
+await dispatchCommand(ctx, '/task 检查设备')
+const tsk = ctx.calls.find(c => c.task)
+check('/task 目标成员自动成为 assignee', tsk?.task?.assigneeId === 'agt-1')
+
 ctx = mockCtx()
 await dispatchCommand(ctx, '/quit')
 check('/quit 触发退出', ctx.calls.some(c => c.quit))

package/scripts/tui-smoke.mjs

@@ -46,7 +46,14 @@ const type = async (text) => {
 }
 
 check('TUI 启动就绪横幅', await waitText('TUI 已就绪'))
-check('启动自动接入首个频道', await waitText('已切换到频道「', 12_000))
+// 启动频道选择器(新交互):有频道 → Esc 自动进第一个;空账户 → 提示创建
+if (await waitText('选择要进入的频道', 8000)) {
+  vt.emitInput('\x1b')
+  check('启动自动接入首个频道', await waitText('已切换到频道「', 12_000))
+}
+else {
+  check('空账户提示创建频道', await waitText('尚无频道', 12_000))
+}
 
 await type('/channels')
 check('/channels 列出频道(计数行)', await waitText('个:'))
@@ -61,7 +68,7 @@ await type('/agents')
 check('/agents 成员面渲染(lead 成员行)', await waitText('smoke-调度长(lead)'))
 
 await type('你好,这是一条 smoke 测试任务')
-check('普通文本发送(服务端回显用户章)', await waitText('◆ 你', 12_000))
+check('普通文本 = 发布正式任务(回执)', await waitText('✔ 任务已发布', 12_000))
 
 await type('/hitl')
 check('/hitl 无待办提示', await waitText('没有待人工处理'))
@@ -83,9 +90,11 @@ try {
 }
 catch { /* 清理失败不判失败 */ }
 
-console.log(failures === 0 ? '\n[tui-smoke] 全部通过,/quit 退出' : `\n[tui-smoke] ${failures} 项失败,/quit 退出`)
+// 退出码必须反映断言结果:失败时直接非零退出(不走 /quit 的 process.exit(0))
 const ok = failures === 0
+console.log(ok ? '\n[tui-smoke] 全部通过,/quit 退出' : `\n[tui-smoke] ${failures} 项失败,直接退出`)
+if (!ok) process.exit(1)
 await type('/quit')
 // /quit 内部 process.exit(0);若未退出(异常)则在此兜底收口
 console.log('[tui-smoke] /quit 未按预期退出进程(异常),兜底退出')
-process.exit(ok ? 0 : 1)
+process.exit(0)

package/tui/README.md

@@ -21,10 +21,18 @@ aw tui --url http://127.0.0.1:3000 --token ut-xxxx --channel <名>
 ┌ 会话时间线(左)                          ┌ 监控面板(右,/monitor 开启)
 │ ◆ 你 消息 · ◆ Agent 回复 · 任务状态行    │ ┌─ 监控 <agent> · 流式中
 ├ HITL 作答卡(/hitl <n> 进入作答时出现)
-├ 状态条:频道 · 成员(忙 n) · HITL 待处理 n · 连接态
+├ 状态条:频道 · 输入目标 · 成员(忙 n) · HITL 待处理 n · 连接态
 └ 输入框(/ 命令补全 · ↑↓ 历史)
 ```
 
+## 交互
+
+- **启动频道选择器**:TUI 就绪后弹出频道列表(↑↓ 移动 · Enter 进入 · Esc 自动进第一个);
+  随时可用 `/channel use`(无参)再次呼出。
+- **Tab 选择对话目标**:呼出成员选择器 —— 选「频道(发布任务)」= 普通文本发布正式任务;
+  选某成员 = 切换为**通信对话**并自动打开其独立监控面板。状态条实时显示当前输入目标。
+- **输入框语义**:普通文本按目标分流(频道 → 任务 / 成员 → 通信);`/task`、`/msg` 可显式指定。
+
 ## 命令
 
 | 命令 | 说明 |
@@ -32,9 +40,10 @@ aw tui --url http://127.0.0.1:3000 --token ut-xxxx --channel <名>
 | `/help` | 命令列表 |
 | `/channels` | 列出我的频道 |
 | `/channel new <名> [--desc …] [--lead <名>]` | 创建频道(可选内联建 lead) |
-| `/channel use <名\|序号>` | 切换频道(WS 断点续传) |
+| `/channel use [名\|序号]` | 切换频道(无参 = 交互选择器;WS 断点续传) |
 | `/channel add <模板\|名> [--role lead\|worker] [--harness omp] [--config JSON]` | 放置 Agent 实例 |
 | `/agents` | 当前频道成员与实时状态 |
+| `/msg [<agent>] <文本…>` | 发布通信消息(缺省收件人 = 当前目标或 lead) |
 | `/send <agent\|序号> <文本…>` | 向指定 Agent 直发(忙碌时 steer 注入) |
 | `/task <标题…> [--mode goal\|loop\|pipeline] [--assignee <agent>]` | 提交正式任务 |
 | `/tasks` | 任务列表与七态/进度 |

package/tui/aw-tui.mjs

@@ -16,6 +16,7 @@ import { createApi } from './lib/api.mjs'
 import { connectAep, connectTerm } from './lib/ws.mjs'
 import { createState, pushLog, withLog } from './lib/state.mjs'
 import { reduceEnvelope, reduceTermFrame } from './lib/reducers.mjs'
+import { openChannelPicker, openTargetPicker } from './lib/pickers.mjs'
 import { dispatchCommand, slashCommandCompletions } from './commands/index.mjs'
 import { ChatLog } from './components/chat-log.mjs'
 import { StatusBar } from './components/status-bar.mjs'
@@ -244,10 +245,24 @@ export async function main(argv = process.argv.slice(2)) {
       tui.stop()
       process.exit(0)
     },
+    /** 交互式频道选择(启动/`/channel use` 无参) */
+    pickChannel() {
+      openChannelPicker(tui, state, {
+        onSelect: async (id) => {
+          tui.setFocus(editor)
+          await actions.switchChannel(id)
+        },
+        onCancel: async () => {
+          tui.setFocus(editor)
+          // Esc 兜底:未进入任何频道时自动进第一个
+          if (!state.activeChannelId && state.channels[0]) await actions.switchChannel(state.channels[0].id)
+        },
+      })
+    },
   }
   const ctx = { state, store, api, echo, push, actions }
 
-  // ── 编辑器提交路由:HITL 作答 → 命令 → 普通文本发任务 ──
+  // ── 编辑器提交路由:HITL 作答 → 命令 → 普通文本按目标分流 ──
   editor.onSubmit = async (text) => {
     const trimmed = text.trim()
     editor.setText('')
@@ -263,25 +278,53 @@ export async function main(argv = process.argv.slice(2)) {
       return
     }
     if (!state.activeChannelId) {
-      push('error', '未选择频道:先 /channels + /channel use <名|序号>')
+      push('error', '未选择频道:Tab 或 /channel use 打开选择器')
       return
     }
-    // messages 端点要求 toAgentId:普通文本缺省路由 lead
-    const ch = state.channels.find(c => c.id === state.activeChannelId)
-    const leadId = ch?.leadAgentId ?? state.agents.find(a => a.role === 'lead')?.id
-    if (!leadId) {
-      push('error', '当前频道没有 lead:用 /channel new --lead <名> 重建,或 /send <成员> 指定收件人。')
+    // 普通文本按目标分流:选定了成员 = 通信消息(immediate);频道 = 发布正式任务
+    if (state.target) {
+      const to = state.agents.find(a => a.id === state.target.agentId)
+      if (!to) {
+        state.target = null
+        push('error', '对话目标已失效(成员被移除),已重置为频道模式')
+        store.notify()
+        return
+      }
+      try {
+        await api.sendMessage(state.activeChannelId, { toAgentId: to.id, text: trimmed, priority: 'immediate', requireReply: true, fromLabel: state.userName || '用户' })
+        push('system', `✔ 通信消息已发 → @${to.name}`)
+      }
+      catch (err) {
+        push('error', `发送失败:${err.message}`)
+      }
+      store.notify()
       return
     }
+    // 频道模式 = 发布正式任务(状态经 /tasks 跟踪)
     try {
-      await api.sendMessage(state.activeChannelId, { toAgentId: leadId, text: trimmed, priority: 'task', fromLabel: state.userName || '用户' })
+      const task = await api.submitTask(state.activeChannelId, { title: trimmed, mode: 'goal' })
+      push('system', `✔ 任务已发布:${task?.id?.slice(0, 8) ?? ''}「${trimmed}」`)
     }
     catch (err) {
-      push('error', `发送失败:${err.message}`)
+      push('error', `任务发布失败:${err.message}`)
     }
     store.notify()
   }
 
+  // ── Tab:呼出对话目标选择器(成员 + 频道模式;选定成员自动开独立监控) ──
+  tui.addInputListener((data) => {
+    if (data !== '\t' || state.targetPickerOpen) return undefined
+    openTargetPicker(tui, state, {
+      onPick: (agent) => {
+        tui.setFocus(editor)
+        if (agent) actions.openMonitor(agent)
+        store.notify()
+      },
+      onCancel: () => tui.setFocus(editor),
+    })
+    return { consume: true }
+  })
+
   // ── AEP 事件流 ──
   const seqCursor = new Map()
   const aep = connectAep({
@@ -311,14 +354,17 @@ export async function main(argv = process.argv.slice(2)) {
   push('system', `AgentWorkShop TUI 已就绪 ${state.baseUrl}`)
   push('system', '普通文本 = 发任务到当前频道;/help 命令列表;/hitl 处理待办。')
 
-  // ── 启动:频道自动选择 → 订阅 ──
+  // ── 启动:显式 --channel 直接进入;否则 TUI 就绪后弹出频道选择器 ──
+  let needPick = false
   try {
     const channels = await api.listChannels()
     state.channels = channels
-    // 空字符串 --channel 视为未指定('' 非 nullish,?? 不会走右侧)
-    const target = (opts.channel ? channels.find(c => c.name === opts.channel || c.id === opts.channel) : undefined)
-      ?? channels[0]
-    if (target) await actions.switchChannel(target.id)
+    if (opts.channel) {
+      const target = channels.find(c => c.name === opts.channel || c.id === opts.channel)
+      if (target) await actions.switchChannel(target.id)
+      else push('warn', `频道不存在:${opts.channel}(/channels 查看)`)
+    }
+    else if (channels.length > 0) needPick = true
     else push('warn', '尚无频道:/channel new <名称> 创建一个。')
     const me = await api.get('/api/workshop/users/me').catch(() => null)
     state.userName = me?.user?.name ?? me?.name ?? '用户'
@@ -328,6 +374,10 @@ export async function main(argv = process.argv.slice(2)) {
   }
 
   tui.start()
+  if (needPick) {
+    push('system', '↑↓ 选择要进入的频道,Enter 确认(Esc 自动进入第一个)。')
+    actions.pickChannel()
+  }
   return tui
 }
 

package/tui/commands/index.mjs

@@ -34,7 +34,7 @@ export const commands = [
     description: '命令列表',
     handler(ctx) {
       const rows = commands.map(c => `  /${c.name}${c.usage ? ` ${c.usage}` : ''}  — ${c.description}`)
-      ctx.echo('system', `可用命令:\n${rows.join('\n')}\n普通文本 = 发送任务到当前频道(lead);以 Agent 身份发信走 /send。`)
+      ctx.echo('system', `可用命令:\n${rows.join('\n')}\n普通文本按当前目标发送:频道 → 发布正式任务;@成员(Tab 选择) → 通信消息。/msg /task 可显式指定。`)
     },
   },
   {
@@ -51,8 +51,8 @@ export const commands = [
   },
   {
     name: 'channel',
-    usage: 'new <name> [--desc …] [--lead <名>] | use <名|序号> | add <模板|名> [--role lead] [--harness omp] [--config JSON]',
-    description: '创建/切换频道、向频道放置 Agent',
+    usage: 'new <name> [--desc …] [--lead <名>] | use [名|序号] | add <模板|名> [--role lead] [--harness omp] [--config JSON]',
+    description: '创建/切换频道(use 不带参数 = 交互选择)、向频道放置 Agent',
     async handler(ctx, args, flags) {
       const sub = args.shift()
       if (sub === 'new') {
@@ -69,7 +69,11 @@ export const commands = [
       }
       else if (sub === 'use') {
         const key = args.shift()
-        if (!key) return ctx.echo('error', '用法:/channel use <名|序号>(/channels 查看列表)')
+        if (!key) {
+          // 交互式选择(浮层)
+          ctx.actions.pickChannel?.()
+          return
+        }
         const ch = resolveChannel(ctx.state, key)
         if (!ch) return ctx.echo('error', `频道不存在:${key}`)
         await ctx.actions.switchChannel(ch.id)
@@ -126,10 +130,33 @@ export const commands = [
       ctx.echo('system', `✔ 已直发 ${agent.name}`)
     },
   },
+  {
+    name: 'msg',
+    usage: '[<agent>] <文本…>',
+    description: '发布通信消息(即时送达,忙碌时 steer 注入;缺省收件人 = 当前对话目标或 lead)',
+    async handler(ctx, args) {
+      let target = ctx.state.target
+      const first = args[0]
+      if (first && !ctx.state.agents.some(a => a.name === first || a.id === first) && !/^\d+$/.test(first)) {
+        // 首参不是成员 → 整段是文本
+      }
+      else if (first) {
+        const key = args.shift()
+        target = resolveAgent(ctx.state, key)
+        if (!target) return ctx.echo('error', `成员不存在:${key}(/agents 查看)`)
+      }
+      const text = args.join(' ')
+      if (!text) return ctx.echo('error', '用法:/msg [<agent>] <文本…>')
+      const to = target ?? leadOf(ctx.state)
+      if (!to) return ctx.echo('error', '频道没有 lead,请指定收件人:/msg <agent> <文本…>')
+      await ctx.api.sendMessage(ctx.state.activeChannelId, { toAgentId: to.id, text, priority: 'immediate', requireReply: true, fromLabel: ctx.state.userName || '用户' })
+      ctx.echo('system', `✔ 通信消息已发 → @${to.name}`)
+    },
+  },
   {
     name: 'task',
     usage: '<标题…> [--mode goal|loop|pipeline] [--assignee <agent>]',
-    description: '提交正式任务(缺省路由 lead,状态经 /tasks 跟踪)',
+    description: '发布正式任务(缺省路由 lead,状态经 /tasks 跟踪)',
     async handler(ctx, args, flags) {
       const title = args.join(' ')
       if (!title) return ctx.echo('error', '用法:/task <标题…> [--mode goal|loop|pipeline] [--assignee <agent>]')
@@ -139,8 +166,11 @@ export const commands = [
         if (!a) return ctx.echo('error', `assignee 不存在:${flags.assignee}`)
         body.assigneeId = a.id
       }
+      else if (ctx.state.target) {
+        body.assigneeId = ctx.state.target.agentId
+      }
       const task = await ctx.api.submitTask(ctx.state.activeChannelId, body)
-      ctx.echo('system', `✔ 任务已提交:${task?.id?.slice(0, 8) ?? ''}「${title}」`)
+      ctx.echo('system', `✔ 任务已发布:${task?.id?.slice(0, 8) ?? ''}「${title}」`)
     },
   },
   {
@@ -215,6 +245,13 @@ function resolveAgent(state, key) {
   return state.agents.find(a => a.name === key || a.id === key) ?? (Number.isInteger(Number.parseInt(key, 10)) ? byIdx : undefined)
 }
 
+/** 当前对话目标的收件人解析:目标成员 → lead */
+function leadOf(state) {
+  const ch = state.channels.find(c => c.id === state.activeChannelId)
+  const leadId = ch?.leadAgentId ?? state.agents.find(a => a.role === 'lead')?.id
+  return state.agents.find(a => a.id === leadId) ?? null
+}
+
 function parseConfigFlag(raw) {
   if (!raw || raw === true) return undefined
   try {

package/tui/components/status-bar.mjs

@@ -16,8 +16,12 @@ export class StatusBar {
     const channel = s.channels.find(c => c.id === s.activeChannelId)
     const members = s.agents.length
     const busy = Object.values(s.agentStates).filter(a => a.state === 'busy').length
+    const target = s.target
+      ? theme.info(`@${s.target.name}(通信)`)
+      : theme.accent('频道(任务)')
     const parts = [
       theme.accent(`▣ ${channel?.name ?? '未选择频道'}`),
+      `${theme.faint('输入→')} ${target}`,
       members > 0 ? theme.faint(`成员 ${members}(忙 ${busy})`) : theme.faint('成员 0'),
       s.hitl.length > 0 ? theme.warn(`⏸ HITL 待处理 ${s.hitl.length}(/hitl)`) : theme.faint('HITL 0'),
       s.monitor.agentId ? theme.info(`监控:${s.monitor.waiting ? '等待进程' : s.monitor.name}`) : null,

package/tui/lib/pickers.mjs

@@ -0,0 +1,102 @@
+// ============================================================
+// 交互选择器(浮层)—— 频道选择 / Agent 选择。
+// 基于 pi-tui showOverlay + SelectList:方向键移动、Enter 选择、Esc 取消。
+// ============================================================
+import { SelectList } from '@earendil-works/pi-tui'
+import { theme } from '../theme.mjs'
+
+/** 组合"标题 + SelectList"的浮层组件。返回 handle { hide, list, component, __bindHandle } */
+function pickerComponent(title, items, maxVisible, onSelect, onCancel) {
+  const list = new SelectList(items, maxVisible, theme.editor.selectList)
+  const wrap = {
+    render(width) {
+      return [theme.accent(`┌─ ${title}`), ...list.render(Math.max(width - 2, 24))]
+    },
+  }
+  const handle = { hide() {}, list, component: wrap }
+  list.onSelect = (item) => {
+    handle.hide()
+    onSelect(item)
+  }
+  list.onCancel = () => {
+    handle.hide()
+    onCancel?.()
+  }
+  // 二次装配:showOverlay 返回真实 handle 后回填 hide(调用方调 picker.__bindHandle(real))
+  handle.__bindHandle = (h) => {
+    handle.hide = () => h.hide()
+  }
+  return handle
+}
+
+/**
+ * 频道选择浮层。Enter 选择并切换;Esc 取消(fallback 频道由调用方决定)。
+ * @returns handle { close }
+ */
+export function openChannelPicker(tui, state, { onSelect, onCancel } = {}) {
+  const items = state.channels.map(c => ({
+    value: c.id,
+    label: c.name,
+    description: c.leadAgentId ? 'lead 已配置' : '无 lead(仅收发消息)',
+  }))
+  const picker = pickerComponent('选择要进入的频道(↑↓ 移动 · Enter 进入 · Esc 取消)', items, Math.min(10, items.length),
+    (item) => {
+      state.channelPickerOpen = false
+      onSelect?.(item.value)
+    },
+    () => {
+      state.channelPickerOpen = false
+      onCancel?.()
+    })
+  state.channelPickerOpen = true
+  const handle = tui.showOverlay(picker.component, { anchor: 'center' })
+  picker.__bindHandle(handle)
+  tui.setFocus(picker.list)
+  return handle
+}
+
+/**
+ * Agent/对话目标选择浮层(Tab 触发)。首项 = 频道(发布任务模式);
+ * 选具体成员 = 切换通信目标并自动打开其独立监控。
+ */
+export function openTargetPicker(tui, state, { onPick, onCancel } = {}) {
+  const s = state.agents
+    .filter(a => a.enabled !== 0)
+    .map(a => ({
+      value: a.id,
+      label: `${a.name}${a.role === 'lead' ? '(lead)' : ''}`,
+      description: `通信对话 + 独立监控 · ${state.agentStates[a.id]?.state ?? 'idle'}`,
+    }))
+  const items = [{ value: '__channel__', label: '频道(发布任务)', description: '普通文本 = 向频道发布正式任务' }, ...s]
+  if (items.length === 1 && s.length === 0) {
+    onCancel?.()
+    return null
+  }
+  const picker = pickerComponent('选择对话目标(Tab 呼出 · ↑↓ 移动 · Enter 确认 · Esc 取消)', items, Math.min(10, items.length),
+    (item) => {
+      if (process.env.AW_TUI_DEBUG) console.error('[picker-debug] item=', JSON.stringify(item), 'agentIds=', JSON.stringify(s.map(x => x.value)))
+      state.targetPickerOpen = false
+      if (item.value === '__channel__') {
+        state.target = null
+        onPick?.(null)
+      }
+      else {
+        const a = state.agents.find(x => x.id === item.value)
+        if (!a) {
+          onCancel?.()
+          return
+        }
+        state.target = { agentId: a.id, name: a.name }
+        onPick?.(a)
+      }
+    },
+    () => {
+      state.targetPickerOpen = false
+      onCancel?.()
+    })
+  state.targetPickerOpen = true
+  const handle = tui.showOverlay(picker.component, { anchor: 'center' })
+  picker.__bindHandle(handle)
+  tui.setFocus(picker.list)
+  return handle
+}

package/tui/lib/state.mjs

@@ -28,6 +28,12 @@ export function createState() {
     /** 正在作答的条目(index → /hitl <n>;null = 常规输入) */
     hitlAnswering: null,
 
+    /** 对话目标:null = 频道(普通文本=发布任务);{agentId,name} = 成员(普通文本=通信消息) */
+    target: null,
+    /** 浮层开关(按键路由用:Tab 呼出目标选择;启动/`/channel` 呼出频道选择) */
+    channelPickerOpen: false,
+    targetPickerOpen: false,
+
     monitor: {
       agentId: null,
       name: null,