agent-loft 0.2.29 → 0.2.31

package/web/settings/users.js

@@ -0,0 +1,189 @@
+import { fill, h, toast } from "../lib/dom.js";
+import { api } from "../lib/api.js";
+import { relTime } from "../lib/time.js";
+import { confirmDialog } from "../lib/overlay.js";
+import { field } from "./common.js";
+import { networkSection, serverVersionSection } from "./general.js";
+
+// ---------- 用户（管理员） ----------
+
+export async function usersTab(panel) {
+  const box = h("div", { class: "section" }, h("h4", {}, "用户"), h("span", { class: "spinner" }));
+  const addBox = h("div", { class: "section" });
+  fill(panel, box, addBox);
+  const reload = () => {
+    fill(panel);
+    void usersTab(panel);
+  };
+  let data;
+  try {
+    data = await api("/api/users");
+  } catch (err) {
+    fill(box, h("h4", {}, "用户"), h("div", { class: "error-text" }, err.message));
+    return;
+  }
+  const act = (btn, fn) => async () => {
+    btn.disabled = true;
+    try {
+      if ((await fn()) !== false) reload();
+    } catch (err) {
+      toast(err.message);
+    }
+    btn.disabled = false;
+  };
+  const patch = (u, body) => api(`/api/users/${encodeURIComponent(u.id)}`, { method: "PATCH", body });
+
+  /** 重置密码：就地展开一个输入框 */
+  const resetRow = (u, holder) => {
+    const pw = h("input", { type: "password", autocomplete: "new-password", placeholder: "新密码（至少 8 位）" });
+    const ok = h("button", { class: "btn small primary" }, "确定");
+    ok.onclick = act(ok, async () => {
+      await patch(u, { password: pw.value });
+      toast(`已重置「${u.name}」的密码，他的设备已下线`);
+    });
+    fill(holder, h("div", { class: "row" }, pw, ok));
+    pw.focus();
+  };
+
+  fill(
+    box,
+    h("h4", {}, "用户"),
+    h(
+      "div",
+      { class: "muted" },
+      "每个人只看得到自己的对话、授权和通知。管理员能改所有设置，还能看到飞书机器人的对话。",
+    ),
+    h(
+      "div",
+      { class: "error-text" },
+      "注意：账号不是安全隔离。所有 agent 都以服务器上的同一个系统用户运行，任何用户都能让 agent 读到这台机器上的文件（包括别人的对话记录和配置里的密钥），用的也是同一个 Claude / Codex 订阅。只把账号给你信任的人。",
+    ),
+    data.users.map((u) => {
+      const self = u.id === data.me;
+      const extra = h("div");
+      const pwBtn = h("button", { class: "btn small" }, "重置密码");
+      pwBtn.onclick = () => resetRow(u, extra);
+      const roleBtn = h("button", { class: "btn small", disabled: self }, u.role === "admin" ? "设为成员" : "设为管理员");
+      roleBtn.onclick = act(roleBtn, () => patch(u, { role: u.role === "admin" ? "member" : "admin" }));
+      const disBtn = h("button", { class: "btn small", disabled: self }, u.disabled ? "启用" : "停用");
+      disBtn.onclick = act(disBtn, () => patch(u, { disabled: !u.disabled }));
+      const memBtn = h("button", { class: "btn small", title: "删除他的「关于我」和所有记住的事。管理员看不到记忆的内容" }, "清空记忆");
+      memBtn.onclick = act(memBtn, async () => {
+        const sure = await confirmDialog({
+          title: `清空「${u.name}」的记忆？`,
+          message: "他的「关于我」和所有记住的事都会删除，不能恢复。",
+          confirmText: "清空",
+          danger: true,
+        });
+        if (!sure) return false;
+        await api(`/api/users/${encodeURIComponent(u.id)}/memory`, { method: "DELETE" });
+        toast("已清空");
+      });
+      const linkBtn = u.feishuLinks ? h("button", { class: "btn small" }, "解除飞书绑定") : null;
+      if (linkBtn) {
+        linkBtn.onclick = act(linkBtn, async () => {
+          await api(`/api/users/${encodeURIComponent(u.id)}/feishu`, { method: "DELETE" });
+          toast("已解除，他和机器人的私聊交还给管理员");
+        });
+      }
+      const rmBtn = h("button", { class: "btn small danger", disabled: self }, "删除");
+      rmBtn.onclick = act(rmBtn, async () => {
+        const sure = await confirmDialog({
+          title: `删除用户「${u.name}」？`,
+          message: "他的设备会立刻下线，记忆和飞书绑定一起删除。他的对话不会删除，之后归管理员。",
+          confirmText: "删除",
+          danger: true,
+        });
+        if (!sure) return false;
+        await api(`/api/users/${encodeURIComponent(u.id)}`, { method: "DELETE" });
+        toast("已删除");
+      });
+      return h(
+        "div",
+        { class: "list-item", style: { flexWrap: "wrap" } },
+        h(
+          "div",
+          { class: "grow" },
+          h(
+            "div",
+            { class: "t" },
+            u.name,
+            self ? "（你）" : "",
+            " ",
+            h("span", { class: "status-tag" }, u.role === "admin" ? "管理员" : "成员"),
+            u.disabled ? h("span", { class: "status-tag bad" }, "已停用") : null,
+          ),
+          h("div", { class: "s" }, `创建于 ${relTime(u.createdAt)} · ${u.devices} 台设备已登录${u.feishuLinks ? ` · 绑定了 ${u.feishuLinks} 个飞书账号` : ""}`),
+          extra,
+        ),
+        pwBtn,
+        roleBtn,
+        disBtn,
+        memBtn,
+        linkBtn,
+        rmBtn,
+      );
+    }),
+  );
+
+  const name = h("input", { autocomplete: "off", autocapitalize: "off", spellcheck: "false", placeholder: "登录用的名字" });
+  const pw = h("input", { type: "password", autocomplete: "new-password", placeholder: "至少 8 位" });
+  const role = h("select", {}, h("option", { value: "member" }, "成员"), h("option", { value: "admin" }, "管理员"));
+  const add = h("button", { class: "btn primary" }, "添加");
+  add.onclick = act(add, async () => {
+    await api("/api/users", { method: "POST", body: { name: name.value.trim(), password: pw.value, role: role.value } });
+    toast(`已添加「${name.value.trim()}」`);
+  });
+  fill(
+    addBox,
+    h("h4", {}, "添加用户"),
+    field("用户名", name),
+    field("密码", pw, "告诉对方，让他登录后在 设置 → 账号 里自己改掉"),
+    field("角色", role, "成员只能用自己的对话；管理员能改所有设置、管理用户"),
+    h("div", { class: "row" }, add),
+  );
+}
+
+export async function systemTab(cfg, panel) {
+  // 系统信息要等接口返回，先占好位置，版本和网络访问两节不用等它
+  const sysBox = h("div", { class: "section" }, h("h4", {}, "系统", h("span", { class: "grow" }), h("span", { class: "spinner" })));
+  panel.append(sysBox, serverVersionSection(), networkSection(cfg));
+  let sys;
+  try {
+    sys = await api("/api/system");
+  } catch (err) {
+    fill(sysBox, h("h4", {}, "系统"), h("div", { class: "error-text" }, err.message));
+    return;
+  }
+  fill(
+    sysBox,
+    h("h4", {}, "系统"),
+    h("div", {}, `版本 ${sys.version} · Node ${sys.node} · 已运行 ${Math.round(sys.uptimeMs / 60000)} 分钟`),
+    h("div", { class: "muted" }, sys.underSystemd ? "以系统服务运行" : "前台运行（重启需要在终端里操作）"),
+    h(
+      "div",
+      { class: "row" },
+      h(
+        "button",
+        {
+          class: "btn",
+          disabled: !sys.underSystemd,
+          onclick: async () => {
+            if (!(await confirmDialog({ title: "重启 agent-loft？", message: "进行中的对话会被中断。", confirmText: "重启", danger: true }))) return;
+            try {
+              await api("/api/system/restart", { method: "POST" });
+              toast("正在重启…");
+              setTimeout(() => location.reload(), 5000);
+            } catch (err) {
+              toast(err.message);
+            }
+          },
+        },
+        "重启服务",
+      ),
+      "Notification" in window && Notification.permission !== "granted"
+        ? h("button", { class: "btn", onclick: () => Notification.requestPermission() }, "开启浏览器通知")
+        : null,
+    ),
+  );
+}

package/web/state.js

@@ -0,0 +1,46 @@
+// ---------- 状态 ----------
+
+export const S = {
+  agents: [],
+  bots: [],
+  convs: new Map(),
+  pending: new Map(),
+  current: null,
+  draftAgent: localStorage.getItem("aim.agent") || null,
+  /** 新对话用聊天模式还是工作模式，记住上次的选择 */
+  draftMode: localStorage.getItem("aim.mode") === "chat" ? "chat" : "work",
+  /** 新对话（还没发消息）选的工作目录，null 表示工作区根目录。开新对话时沿用上次选的 */
+  draftCwd: null,
+  items: [],
+  turnAi: null,
+  seq: new Map(),
+  uploads: [],
+  busy: false,
+  allowedAgents: [],
+  search: "",
+  loadToken: 0,
+  /** 登录的用户 { id, name, role } */
+  user: null,
+  /** 主区域在显示什么：null 是对话（或新对话），"tasks" 是定时任务页 */
+  view: null,
+};
+
+export const isAdmin = () => S.user?.role === "admin";
+
+export const ui = {};
+
+/**
+ * 运行在 macOS 桌面端（agent-loft-desktop）里时，由它的 preload 注入。
+ * 桌面端收不到 Web Push，系统通知、Dock 角标、菜单栏的待处理数都交给它。
+ */
+export const desktop = window.agentLoftDesktop ?? null;
+/** 新版桌面端：额度由它统一查好推过来，页面自己不查（老版本桌面端没有 onQuota，照旧自己查） */
+export const desktopQuota = typeof desktop?.onQuota === "function";
+// 桌面端里：顶栏、侧栏顶部可以按住拖动窗口（样式见 css/topbar.css 的 .in-desktop）
+if (desktop) document.documentElement.classList.add("in-desktop");
+/**
+ * 新版桌面端顶栏的「更多」里能打开每台服务器的设置：侧栏底部的设置按钮就不显示了（额度照常显示，数据由桌面端推）。
+ * 老版本桌面端没有这个入口，照旧显示，免得设置打不开。
+ */
+export const desktopSettings = typeof desktop?.onOpenSettings === "function";
+if (desktopSettings) document.documentElement.classList.add("desktop-settings");

package/web/views/auth.js

@@ -0,0 +1,61 @@
+import { $app, fill, h } from "../lib/dom.js";
+import { api } from "../lib/api.js";
+import { WS } from "../lib/ws.js";
+import { boot } from "./layout.js";
+
+// ---------- 登录 ----------
+
+export async function showAuth() {
+  WS.stopped = true;
+  WS.sock?.close();
+  let me = { needsSetup: false };
+  try {
+    me = await api("/api/me");
+  } catch {
+    // 网络问题时按登录处理
+  }
+  const err = h("div", { class: "error-text" });
+  const pw = h("input", { type: "password", placeholder: "密码", autocomplete: me.needsSetup ? "new-password" : "current-password" });
+  const token = h("input", { placeholder: "设置码（在启动日志里）", autocomplete: "off" });
+  // 只有一个用户时和以前一样只要密码；多个用户才要填用户名
+  const askName = me.needsSetup || me.multiUser;
+  const name = h("input", {
+    placeholder: me.needsSetup ? "admin" : "用户名",
+    autocomplete: "username",
+    autocapitalize: "off",
+    spellcheck: "false",
+  });
+  const btn = h("button", { class: "btn primary", type: "submit" }, me.needsSetup ? "设置密码并进入" : "登录");
+  const form = h(
+    "form",
+    {
+      class: "auth-card",
+      onsubmit: async (e) => {
+        e.preventDefault();
+        err.textContent = "";
+        btn.disabled = true;
+        try {
+          if (me.needsSetup) {
+            await api("/api/setup", { method: "POST", body: { token: token.value, name: name.value.trim() || "admin", password: pw.value } });
+          } else {
+            await api("/api/login", { method: "POST", body: { ...(askName ? { name: name.value.trim() } : {}), password: pw.value } });
+          }
+          await boot();
+        } catch (e2) {
+          err.textContent = e2.message;
+        } finally {
+          btn.disabled = false;
+        }
+      },
+    },
+    h("h1", {}, "Agent Loft"),
+    h("p", {}, me.needsSetup ? "首次使用：输入启动日志里的设置码，建一个管理员账号（密码至少 8 位）" : "登录以继续"),
+    me.needsSetup ? h("label", { class: "field" }, h("span", {}, "设置码"), token) : null,
+    askName ? h("label", { class: "field" }, h("span", {}, me.needsSetup ? "管理员用户名" : "用户名"), name) : null,
+    h("label", { class: "field" }, h("span", {}, me.needsSetup ? "新密码" : "密码"), pw),
+    btn,
+    err,
+  );
+  fill($app, h("div", { class: "auth" }, form));
+  (me.needsSetup ? token : askName ? name : pw).focus();
+}

package/web/views/composer.js

@@ -0,0 +1,324 @@
+import { fill, h, icon, ICON, isTouch, toast } from "../lib/dom.js";
+import { api } from "../lib/api.js";
+import { desktop, S, ui } from "../state.js";
+import { WS } from "../lib/ws.js";
+import { agentLabel, renderSidebar } from "./sidebar.js";
+import { draftPick, renderContext, renderTopbar, sentKeys, updateCtxVisibility } from "./topbar.js";
+import { addItem, openConversation, openLightbox, renderEmpty, scrollToBottom } from "./messages.js";
+import { renderScheduled } from "./schedule.js";
+import { cancelVoice, SpeechRec, toggleVoice } from "./voice.js";
+import { closeSlashMenu, commandUsage, oneLine, slashKeydown, updateSlashMenu } from "./slash.js";
+import { doAction, openModelPicker, openSessions } from "./conv-actions.js";
+
+// ---------- 输入框 ----------
+
+export function renderComposer() {
+  cancelVoice();
+  ui.input = h("textarea", {
+    rows: 1,
+    placeholder: "随心输入",
+    oninput: () => {
+      // 识别过程中用户自己动了输入框，以用户为准，停掉识别
+      cancelVoice();
+      autosize();
+      void updateSlashMenu();
+    },
+    onblur: () => setTimeout(closeSlashMenu, 150),
+    onkeydown: (e) => {
+      if (slashKeydown(e)) {
+        e.preventDefault();
+        return;
+      }
+      if (e.key === "Enter" && !e.shiftKey && !e.isComposing && !isTouch) {
+        e.preventDefault();
+        void sendMessage();
+      }
+    },
+    onpaste: (e) => {
+      const files = [...(e.clipboardData?.files ?? [])];
+      if (files.length) {
+        e.preventDefault();
+        void addFiles(files);
+      }
+    },
+  });
+  ui.fileInput = h("input", {
+    type: "file",
+    multiple: true,
+    style: { display: "none" },
+    onchange: (e) => {
+      void addFiles([...e.target.files]);
+      e.target.value = "";
+    },
+  });
+  ui.sendBtn = h("button", { class: "send-btn", title: "发送", onclick: () => (S.busy && !hasDraft() ? stopTurn() : sendMessage()) });
+  // 桌面端（Electron）里不放语音输入
+  ui.micBtn = SpeechRec && !desktop
+    ? h("button", { class: "icon-btn mic-btn", title: "语音输入", onclick: toggleVoice }, icon("mic"))
+    : null;
+  ui.ctxBar = h("div", { class: "ctx-bar" });
+  ui.modelSlot = h("span", { class: "model-slot" });
+  ui.ctxRing = h("span", { class: "ctx-ring-slot" });
+  ui.chips = h("div", { class: "chips" });
+  ui.schedBar = h("div", { class: "sched-bar", hidden: true });
+  ui.slashMenu = h("div", { class: "slash-menu", hidden: true });
+  ui.composer = h(
+    "div",
+    {
+      class: "composer",
+      ondragover: (e) => {
+        e.preventDefault();
+        ui.composer.classList.add("drag");
+      },
+      ondragleave: () => ui.composer.classList.remove("drag"),
+      ondrop: (e) => {
+        e.preventDefault();
+        ui.composer.classList.remove("drag");
+        void addFiles([...(e.dataTransfer?.files ?? [])]);
+      },
+    },
+    ui.slashMenu,
+    ui.chips,
+    ui.input,
+    h(
+      "div",
+      { class: "composer-row" },
+      h("button", { class: "icon-btn add-btn", title: "添加附件", onclick: () => ui.fileInput.click() }, icon("plus")),
+      ui.fileInput,
+      h("span", { class: "spacer" }),
+      ui.ctxRing,
+      ui.modelSlot,
+      ui.micBtn,
+      ui.sendBtn,
+    ),
+  );
+  fill(ui.composerWrap,
+    ui.toBottom,
+    h("div", { class: "composer-box" }, ui.schedBar, ui.ctxBar, ui.composer),
+  );
+  ui.input.addEventListener("input", updateSendBtn);
+  updateSendBtn();
+  renderContext();
+  renderScheduled();
+}
+
+export function autosize() {
+  ui.input.style.height = "auto";
+  ui.input.style.height = `${Math.min(ui.input.scrollHeight, innerHeight * 0.4)}px`;
+}
+
+function hasDraft() {
+  return !!ui.input?.value.trim() || S.uploads.length > 0;
+}
+
+export function updateSendBtn() {
+  if (!ui.sendBtn) return;
+  // 已经点了发送、还在等服务器确认：转圈，不能再点，避免以为没点上又点一次
+  if (S.sending) {
+    ui.sendBtn.innerHTML = '<span class="send-spinner"></span>';
+    ui.sendBtn.title = "发送中…";
+    ui.sendBtn.disabled = true;
+    return;
+  }
+  const stop = S.busy && !hasDraft();
+  ui.sendBtn.innerHTML = stop ? ICON.stop : ICON.send;
+  ui.sendBtn.title = stop ? "停止" : "发送";
+  ui.sendBtn.disabled = !stop && !hasDraft();
+}
+
+export function setBusy(busy) {
+  S.busy = !!busy;
+  updateSendBtn();
+}
+
+export function renderChips() {
+  if (!ui.chips) return;
+  const remove = (u) => {
+    S.uploads = S.uploads.filter((x) => x !== u);
+    if (u.url) URL.revokeObjectURL(u.url);
+    renderChips();
+  };
+  fill(ui.chips, 
+    ...S.uploads.map((u) =>
+      u.url
+        ? h(
+            "span",
+            { class: `chip-img${u.uploading ? " uploading" : ""}`, title: u.name },
+            h("img", { src: u.url, alt: u.name, onclick: () => openLightbox(u.url, u.name) }),
+            u.uploading ? h("span", { class: "spinner" }) : null,
+            h("button", { class: "chip-x", title: "移除", onclick: () => remove(u) }, "×"),
+          )
+        : h(
+            "span",
+            { class: "chip" },
+            u.uploading ? h("span", { class: "spinner" }) : "📄",
+            h("span", {}, u.name),
+            h("button", { title: "移除", onclick: () => remove(u) }, "×"),
+          ),
+    ),
+  );
+  updateSendBtn();
+}
+
+export async function ensureConversation() {
+  if (S.current) return S.current;
+  if (!S.draftAgent) throw new Error("没有可用的 agent");
+  let info;
+  try {
+    info = await api("/api/conversations", {
+      method: "POST",
+      body: { agent: S.draftAgent, cwd: S.draftCwd ?? undefined, mode: S.draftMode },
+    });
+  } catch (err) {
+    // 选的目录没了（被删、或工作区改了）：退回根目录，让用户重新确认
+    if (err.status === 400 && S.draftCwd) {
+      S.draftCwd = null;
+      renderEmpty();
+    }
+    throw err;
+  }
+  // 新对话里选过模型 / 思考程度：建好会话后先切过去再发消息
+  const pick = { ...draftPick() };
+  for (const [action, value] of [["model", pick.model], ["effort", pick.effort]]) {
+    if (!value) continue;
+    try {
+      const res = await api(`/api/conversations/${encodeURIComponent(info.key)}/action`, { method: "POST", body: { action, value } });
+      info = res.info;
+    } catch (err) {
+      toast(`${action === "model" ? "切换模型" : "切换思考程度"}失败：${err.message}`);
+    }
+  }
+  S.convs.set(info.key, info);
+  S.current = info.key;
+  S.allowedAgents = S.agents.filter((a) => a.enabled).map((a) => a.id);
+  S.seq.set(info.key, 0);
+  history.replaceState(null, "", `#${encodeURIComponent(info.key)}`);
+  WS.presence();
+  fill(ui.msgInner, );
+  WS.subscribe(info.key, 0);
+  renderTopbar();
+  renderSidebar();
+  return info.key;
+}
+
+async function addFiles(files) {
+  if (!files.length) return;
+  let key;
+  try {
+    key = await ensureConversation();
+  } catch (err) {
+    toast(err.message);
+    return;
+  }
+  for (const file of files) {
+    const u = { name: file.name || "粘贴的图片.png", kind: file.type.startsWith("image/") ? "image" : "file", uploading: true };
+    // 图片用本地文件直接做缩略图，不用等上传完、也不用再从服务器取
+    if (u.kind === "image") u.url = URL.createObjectURL(file);
+    S.uploads.push(u);
+    renderChips();
+    try {
+      const res = await api(`/api/conversations/${encodeURIComponent(key)}/upload?name=${encodeURIComponent(u.name)}`, {
+        method: "POST",
+        body: file,
+        headers: { "Content-Type": file.type || "application/octet-stream" },
+      });
+      Object.assign(u, { id: res.id, kind: res.kind, uploading: false, serverName: res.name });
+      if (u.kind !== "image" && u.url) (URL.revokeObjectURL(u.url), delete u.url);
+    } catch (err) {
+      S.uploads = S.uploads.filter((x) => x !== u);
+      if (u.url) URL.revokeObjectURL(u.url);
+      toast(`${u.name} 上传失败：${err.message}`);
+    }
+    renderChips();
+  }
+}
+
+/** 发送中：按钮转圈、输入框只读（确认后要清空它，期间再打的字会丢） */
+function setSending(on) {
+  S.sending = on;
+  if (ui.input) {
+    ui.input.readOnly = on;
+    ui.input.classList.toggle("sending", on);
+  }
+  updateSendBtn();
+}
+
+export async function sendMessage() {
+  if (S.sending) return;
+  cancelVoice();
+  const text = ui.input.value;
+  if (!text.trim() && S.uploads.length === 0) return;
+  if (S.uploads.some((u) => u.uploading)) {
+    toast("附件还在上传，稍等");
+    return;
+  }
+  closeSlashMenu();
+  let key;
+  let res;
+  setSending(true);
+  // 发出去之后恢复自动滚动；回显的那条用户消息到了就顶到最上面（见 applyEvent）
+  S.pinNext = true;
+  try {
+    key = await ensureConversation();
+    if ("Notification" in window && Notification.permission === "default") void Notification.requestPermission();
+    // 命令（比如 /status 要现读额度）可能比普通发送慢，多给点时间
+    res = await WS.request({ t: "send", key, text, uploads: S.uploads.map((u) => u.id) }, 45000);
+  } catch (err) {
+    S.pinNext = false;
+    toast(err.message);
+    return;
+  } finally {
+    setSending(false);
+  }
+  if (!res?.reply) {
+    sentKeys.add(key);
+    updateCtxVisibility();
+  }
+  ui.input.value = "";
+  autosize();
+  for (const u of S.uploads) if (u.url) URL.revokeObjectURL(u.url);
+  S.uploads = [];
+  renderChips();
+  updateSendBtn();
+  if (res?.reply) {
+    // 命令不进会话记录，没有回显：直接贴到底看结果
+    S.pinNext = false;
+    await showCommandReply(text.trim(), res.reply, res.info);
+    scrollToBottom();
+  } else if (!ui.pinEl) ui.follow = true;
+}
+
+/** 会改变当前会话（换会话、换目录、换 agent）的命令，执行完要重拉一遍 */
+const RELOADING_COMMANDS = new Set(["new", "fork", "resume", "agent", "claude", "codex", "cd"]);
+
+/** agent-loft 命令的结果：只显示给发命令的这个页面，不进会话记录 */
+async function showCommandReply(text, reply, info) {
+  if (info) S.convs.set(info.key, info);
+  renderTopbar();
+  const head = text.slice(1).split(/\s+/)[0]?.toLowerCase() ?? "";
+  if (RELOADING_COMMANDS.has(head) && S.current) await openConversation(S.current);
+  const note = (md) => addItem({ type: "notice", text: md });
+  switch (reply.type) {
+    case "text":
+      note(`\`${text}\`\n\n${reply.text}`);
+      return;
+    case "sessions":
+      await openSessions(reply.allDirs);
+      return;
+    case "models":
+      await openModelPicker();
+      return;
+    case "agents":
+      note(
+        `当前 agent：**${agentLabel(reply.current)}**\n\n可切换：${reply.agents.map((a) => `\`/${a.id}\` ${a.label}`).join("　")}`,
+      );
+      return;
+    case "commands":
+      note(reply.commands.map((c) => `\`${commandUsage(c)}\` ${oneLine(c.description)}`).join("\n\n") || "没有可用命令");
+      return;
+  }
+}
+
+async function stopTurn() {
+  await doAction("stop");
+}