agentworkshop 0.7.4 → 0.7.6

package/scripts/start.mjs

@@ -53,21 +53,44 @@ const prodPort = eff.effective['server.prod.port'] ?? 3000
 const portSource = eff.sources['server.prod.port']
 
 // ---- 单实例互斥(hardening ST-1):同配置根双开直接退出码 2,防 SQLite 锁崩溃 ----
-const { acquireLock } = await import('../shared/config/single-instance.mjs')
-const lock = acquireLock(rm.configRoot, { mode: `prod:${rm.mode}`, port: argPort ? Number(argPort) : prodPort })
+// ---- 单实例互斥 + 自动顶替:同配置根已有实例 → 自动停止后重启新实例(防 SQLite 锁崩溃) ----
+const { acquireLock, checkPort, terminatePid } = await import('../shared/config/single-instance.mjs')
+let requestedPort = argPort ? Number(argPort) : prodPort
+let lock = acquireLock(rm.configRoot, { mode: `prod:${rm.mode}`, port: requestedPort })
 if (!lock.ok) {
   const h = lock.holder
-  console.error(`✖ 已有实例在运行(pid=${h.pid}${h.port ? `,端口=${h.port}` : ''},启动于 ${h.startedAt ?? '未知'},模式=${h.mode ?? '未知'})`)
-  console.error(`  › 配置根: ${rm.configRoot}`)
-  console.error(`  › 如确认是残留锁文件,可删除 ${lock.lockPath} 后重试`)
-  process.exit(2)
+  console.log(`› 发现已运行实例(pid=${h.pid}${h.port ? `,端口=${h.port}` : ''},启动于 ${h.startedAt ?? '未知'})— 自动停止后重启 ...`)
+  const stopped = await terminatePid(h.pid).catch(() => false)
+  if (!stopped) {
+    console.error(`✖ 旧实例(pid=${h.pid})自动停止失败,请手动执行 aw stop 或 taskkill /PID ${h.pid} /T /F`)
+    process.exit(2)
+  }
+  lock = acquireLock(rm.configRoot, { mode: `prod:${rm.mode}`, port: requestedPort })
+  if (!lock.ok) {
+    console.error(`✖ 旧实例已停止但锁仍被占用(可能并发启动):pid=${lock.holder?.pid ?? '?'}`)
+    process.exit(2)
+  }
+}
+
+// ---- 端口顺延:配置端口被任意进程占用(含其他配置根的实例)→ 逐个 +1(最多 10 次) ----
+let port = requestedPort
+let bumped = 0
+while (bumped < 10 && await checkPort(host, port)) {
+  console.log(`› 端口 ${port} 被占用,顺延至 ${port + 1} ...`)
+  port += 1
+  bumped += 1
+}
+if (bumped >= 10) {
+  console.error(`✖ ${host} 上 ${requestedPort}-${port} 全部被占用,无法启动`)
+  process.exit(1)
 }
+if (bumped > 0) console.log(`✔ 使用顺延端口 ${port}(配置端口 ${requestedPort} 被占用)`)
 
 process.env.HOST = process.env.HOST || process.env.NITRO_HOST || String(host)
-process.env.PORT = process.env.PORT || process.env.NITRO_PORT || String(prodPort)
+process.env.PORT = process.env.PORT || process.env.NITRO_PORT || String(port)
 process.env.NITRO_HOST = process.env.HOST
 process.env.NITRO_PORT = process.env.PORT
 
-console.log(`[config] 生产服务启动 -> http://${process.env.HOST}:${process.env.PORT}  (模式: ${rm.mode}, port source: ${portSource})`)
+console.log(`[config] 生产服务启动 -> http://${process.env.HOST}:${process.env.PORT}  (模式: ${rm.mode}, port source: ${portSource}${bumped > 0 ? ' + 顺延' : ''})`)
 
 await import('../.output/server/index.mjs')

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/shared/config/single-instance.mjs

@@ -1,86 +1,129 @@
-// ============================================================
-// 单实例互斥(hardening ST-1)—— 零依赖,CLI / 启动脚本通用。
-// 锁文件 <configRoot>/.runtime/aw.lock 原子创建(wx):
-//   { pid, startedAt, mode, port }
-// 已存在且 PID 存活 → 视为已有实例(返回冲突信息,调用方以退出码 2 退出);
-// PID 已死(崩溃/强杀残留) → 自动接管重写。进程退出时 releaseLock 兜底清理。
-// ============================================================
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
-
-function pidAlive(pid) {
-  if (!Number.isInteger(pid) || pid <= 0) return false
-  try {
-    // signal 0 探活:进程存在但不发信号;ESRCH=不存在,EPERM=存在(他人进程)
-    process.kill(pid, 0)
-    return true
-  }
-  catch (err) {
-    return err?.code === 'EPERM'
-  }
-}
-
-/**
- * 尝试获取单实例锁。
- * @returns {{ ok: true, lockPath: string, release: () => void }
- *   | { ok: false, lockPath: string, holder: { pid: number, startedAt: string, mode: string, port: number | null } }}
- */
-export function acquireLock(configRoot, { mode = 'prod', port = null } = {}) {
-  const runtimeDir = join(configRoot, '.runtime')
-  const lockPath = join(runtimeDir, 'aw.lock')
-  mkdirSync(runtimeDir, { recursive: true })
-  if (existsSync(lockPath)) {
-    let holder = null
-    try {
-      holder = JSON.parse(readFileSync(lockPath, 'utf8'))
-    }
-    catch { /* 损坏锁文件按残留处理 */ }
-    if (holder && pidAlive(holder.pid)) {
-      return { ok: false, lockPath, holder: { ...holder, port: holder.port ?? null } }
-    }
-    try { rmSync(lockPath) } catch { /* 抢不掉则下方 wx 再失败 */ }
-  }
-  const me = { pid: process.pid, startedAt: new Date().toISOString(), mode, port }
-  try {
-    writeFileSync(lockPath, JSON.stringify(me, null, 2), { flag: 'wx' })
-  }
-  catch (err) {
-    // 与并发启动者竞态:按冲突处理
-    let holder = null
-    try { holder = JSON.parse(readFileSync(lockPath, 'utf8')) } catch { /* ignore */ }
-    if (holder && pidAlive(holder.pid)) {
-      return { ok: false, lockPath, holder: { ...holder, port: holder.port ?? null } }
-    }
-    throw err
-  }
-  let released = false
-  const release = () => {
-    if (released) return
-    released = true
-    try {
-      const cur = JSON.parse(readFileSync(lockPath, 'utf8'))
-      if (cur?.pid !== process.pid) return // 锁已被他人接管,不误删
-      rmSync(lockPath)
-    }
-    catch { /* 已不存在/损坏,忽略 */ }
-  }
-  process.once('exit', release)
-  process.once('SIGINT', () => { release(); process.exit(130) })
-  process.once('SIGTERM', () => { release(); process.exit(143) })
-  return { ok: true, lockPath, release }
-}
-
-/** 端口占用探测:返回占用进程 PID(未占用返回 null)。TCP try-listen 后立刻释放。 */
-export async function checkPort(host, port) {
-  const net = await import('node:net')
-  return new Promise((resolveProbe) => {
-    const srv = net.createServer()
-    srv.once('error', (err) => {
-      resolveProbe(err?.code === 'EADDRINUSE' ? port : null)
-      srv.close()
-    })
-    srv.listen(port, host, () => {
-      srv.close(() => resolveProbe(null))
-    })
-  })
-}
+// ============================================================
+// 单实例互斥(hardening ST-1)—— 零依赖,CLI / 启动脚本通用。
+// 锁文件 <configRoot>/.runtime/aw.lock 原子创建(wx):
+//   { pid, startedAt, mode, port }
+// 已存在且 PID 存活 → 视为已有实例(返回冲突信息,调用方以退出码 2 退出);
+// PID 已死(崩溃/强杀残留) → 自动接管重写。进程退出时 releaseLock 兜底清理。
+// ============================================================
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+function pidAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false
+  try {
+    // signal 0 探活:进程存在但不发信号;ESRCH=不存在,EPERM=存在(他人进程)
+    process.kill(pid, 0)
+    return true
+  }
+  catch (err) {
+    return err?.code === 'EPERM'
+  }
+}
+
+const waitSync = ms => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms)
+
+/**
+ * 终止进程树并等待其死亡(供 `aw stop` 与 start 的"顶掉旧实例"共用)。
+ * Windows:taskkill /T /F;POSIX:SIGTERM 宽限 5s → SIGKILL。
+ * @returns {Promise<boolean>} 是否已确认死亡
+ */
+export async function terminatePid(pid) {
+  if (!pidAlive(pid)) return true
+  if (process.platform === 'win32') {
+    const { spawnSync } = await import('node:child_process')
+    const r = spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { encoding: 'utf8' })
+    if (r.status !== 0) return !pidAlive(pid)
+  }
+  else {
+    try {
+      process.kill(pid, 'SIGTERM')
+    }
+    catch { /* 已死 */ }
+    const deadline = Date.now() + 5000
+    while (Date.now() < deadline && pidAlive(pid)) waitSync(200)
+    if (pidAlive(pid)) {
+      try {
+        process.kill(pid, 'SIGKILL')
+      }
+      catch { /* 已死 */ }
+    }
+  }
+  const deadline = Date.now() + 5000
+  while (Date.now() < deadline && pidAlive(pid)) waitSync(200)
+  return !pidAlive(pid)
+}
+
+/**
+ * 尝试获取单实例锁。
+ * @returns {{ ok: true, lockPath: string, release: () => void }
+ *   | { ok: false, lockPath: string, holder: { pid: number, startedAt: string, mode: string, port: number | null } }}
+ */
+export function acquireLock(configRoot, { mode = 'prod', port = null } = {}) {
+  const runtimeDir = join(configRoot, '.runtime')
+  const lockPath = join(runtimeDir, 'aw.lock')
+  mkdirSync(runtimeDir, { recursive: true })
+  if (existsSync(lockPath)) {
+    let holder = null
+    try {
+      holder = JSON.parse(readFileSync(lockPath, 'utf8'))
+    }
+    catch { /* 损坏锁文件按残留处理 */ }
+    if (holder && pidAlive(holder.pid)) {
+      return { ok: false, lockPath, holder: { ...holder, port: holder.port ?? null } }
+    }
+    try {
+      rmSync(lockPath)
+    }
+    catch { /* 抢不掉则下方 wx 再失败 */ }
+  }
+  const me = { pid: process.pid, startedAt: new Date().toISOString(), mode, port }
+  try {
+    writeFileSync(lockPath, JSON.stringify(me, null, 2), { flag: 'wx' })
+  }
+  catch (err) {
+    // 与并发启动者竞态:按冲突处理
+    let holder = null
+    try {
+      holder = JSON.parse(readFileSync(lockPath, 'utf8'))
+    }
+    catch { /* ignore */ }
+    if (holder && pidAlive(holder.pid)) {
+      return { ok: false, lockPath, holder: { ...holder, port: holder.port ?? null } }
+    }
+    throw err
+  }
+  let released = false
+  const release = () => {
+    if (released) return
+    released = true
+    try {
+      const cur = JSON.parse(readFileSync(lockPath, 'utf8'))
+      if (cur?.pid !== process.pid) return // 锁已被他人接管,不误删
+      rmSync(lockPath)
+    }
+    catch { /* 已不存在/损坏,忽略 */ }
+  }
+  const releaseAndExit = (code) => {
+    release()
+    process.exit(code)
+  }
+  process.once('exit', release)
+  process.once('SIGINT', () => releaseAndExit(130))
+  process.once('SIGTERM', () => releaseAndExit(143))
+  return { ok: true, lockPath, release }
+}
+
+/** 端口占用探测:返回占用进程 PID(未占用返回 null)。TCP try-listen 后立刻释放。 */
+export async function checkPort(host, port) {
+  const net = await import('node:net')
+  return new Promise((resolveProbe) => {
+    const srv = net.createServer()
+    srv.once('error', (err) => {
+      resolveProbe(err?.code === 'EADDRINUSE' ? port : null)
+      srv.close()
+    })
+    srv.listen(port, host, () => {
+      srv.close(() => resolveProbe(null))
+    })
+  })
+}

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,