@cubeai/dsh-feishu-channels 0.0.0-stage → 0.2.0

package/src/engine/chat-commands.js

@@ -0,0 +1,752 @@
+import { exportSession } from './session-export.js';
+import { replyText, withReplyLocale, localizeStatus } from './command-locale.js';
+/** IM 对 Chat 的薄适配：控制操作走 Host Controller，斜杠命令走同一注册表。 */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+import { commandNavigation, extensionHelp, extensionReply, oneLine, related } from './command-replies.js';
+import { readSessionHistory } from './session-history.js';
+const modelDefaultHint = () => replyText('与 Chat 一致，此操作也会尝试保存后续 Chat 新会话的默认模型选择；已有其他会话不会主动修改。');
+export const chatControlHelp = () => [
+    replyText('飞书助手已连接 DeepSeek Harness。直接发送文字即可开始任务。'), replyText('例如：帮我整理今天的待办。'), '',
+    replyText('**入口**'),
+    replyText('/menu（或 /m）— 打开带按钮的操作菜单，和下面的列表命令等价'),
+    replyText('/help — 显示本说明'), '',
+    replyText('**会话与工作区**'),
+    replyText('/new（或 /clear）— 新开会话；旧会话保留在飞书频道列表'),
+    replyText('/sessions — 列出会话，点按钮或回序号接续'),
+    replyText('/session 序号或ID — 直接接续指定会话'),
+    replyText('/workspaces — 列出工作区，点按钮或回序号在其中新建'),
+    replyText('/workspace 序号或路径 — 直接在该工作区新建会话'),
+    replyText('/history — 当前会话最近的文字记录'),
+    replyText('/rename 新名称 — 给当前会话改名'),
+    replyText('/fork — 分叉当前会话'), '',
+    replyText('**模型与推理**'),
+    replyText('/models — 列出可选模型并选择'),
+    replyText('/model — 只看当前模型'),
+    replyText('/reasoning — 列出推理等级并选择'),
+    replyText('/presets — 列出 Agent 预设并选择'),
+    replyText('/preset 序号或ID — 直接用该预设新建会话'), '',
+    replyText('**任务与交付**'),
+    replyText('/status（或 /current）— 当前状态'),
+    replyText('/stop — 请求停止，保留队列'),
+    replyText('/steer 补充要求 — 提交补充指令'),
+    replyText('/queue — 查看队列和操作方法'),
+    replyText('/delivery — 查看交付记录和补发方法'),
+    replyText('/unbind [序号|ID|all] — 解除本聊天对旧会话的登记，不再推送其输出'),
+    replyText('/mute 序号或ID — 静音指定会话的推送；/unmute 恢复'),
+    replyText('/export — 导出当前会话 ZIP 并发送'), '',
+    replyText('命令单独发送为文字；图片说明按普通消息处理。'),
+].join('\n');
+export class ChatCommands {
+    host;
+    router;
+    pending;
+    onSession;
+    showChoices;
+    lifetime = new AsyncLocalStorage();
+    choices = new Map();
+    reasoningChoices = new Map();
+    constructor(host, router, pending, onSession = () => { }, showChoices) {
+        this.host = host;
+        this.router = router;
+        this.pending = pending;
+        this.onSession = onSession;
+        this.showChoices = showChoices;
+    }
+    clear() { this.choices.clear(); this.reasoningChoices.clear(); }
+    service(name) {
+        const value = this.host.get(name);
+        if (!value)
+            throw new Error(replyText('当前 Host 未提供 {0}，请升级 DSH。', name));
+        return value;
+    }
+    async call(service, method, ...args) {
+        this.lifetime.getStore()?.throwIfAborted();
+        const target = this.service(service);
+        if (typeof target[method] !== 'function')
+            throw new Error(replyText('当前 Host 不支持 {0}。', method));
+        const value = (await target[method](...args));
+        this.lifetime.getStore()?.throwIfAborted();
+        return value;
+    }
+    async presets() {
+        const listed = await this.call('agentPresets', 'remoteExportList');
+        return listed?.presets ?? [];
+    }
+    permissionLabel(permissions) {
+        const named = permissions.options?.find((item) => item.value === permissions.currentValue)?.name;
+        if (named)
+            return named;
+        const presets = this.host.get('permissionPresets');
+        try {
+            const option = presets?.optionOf?.(permissions.currentValue);
+            if (option?.name)
+                return option.name;
+        }
+        catch { /* 未知预设不能让状态查询失败。 */ }
+        return permissions.currentValue;
+    }
+    async agent(sessionId) {
+        const result = await this.call('sessionController', 'resolveAgent', sessionId);
+        if (!result.agent)
+            throw new Error(result.error?.message || replyText('无法打开会话。'));
+        return result.agent;
+    }
+    async snapshot(sessionId, signal) {
+        const stream = await this.call('sessionController', 'follow', { address: { kind: 'session', sessionId }, maxMessages: 10 }, signal);
+        for await (const frame of stream)
+            return frame;
+        throw new Error(replyText('无法读取会话快照。'));
+    }
+    async workspaces(signal) {
+        const stream = await this.call('workspaceController', 'follow', signal);
+        for await (const frame of stream)
+            return { items: frame.value?.items ?? [], archivedSessionIds: frame.value?.archivedSessionIds ?? [] };
+        throw new Error(replyText('无法读取工作区。'));
+    }
+    async listSessions(signal) {
+        const listed = await this.call('sessionController', 'list', {}, signal);
+        return listed?.items ?? [];
+    }
+    remember(key, values) {
+        if (this.choices.size >= 256)
+            this.choices.delete(this.choices.keys().next().value);
+        this.choices.set(key, { values, time: Date.now() });
+    }
+    reasoningChoice(scope, sessionId, selected, effort) {
+        if (this.reasoningChoices.size >= 512)
+            this.reasoningChoices.delete(this.reasoningChoices.keys().next().value);
+        const token = randomUUID();
+        this.reasoningChoices.set(token, { scope, sessionId, provider: selected.provider, model: selected.model, effort, time: Date.now() });
+        return `--choice ${token}`;
+    }
+    resolve(key, value) {
+        if (!/^\d+$/.test(value))
+            return value;
+        const choice = this.choices.get(key);
+        const selected = choice && Date.now() - choice.time < 15 * 60_000 ? choice.values[Number(value) - 1] : undefined;
+        if (!selected) {
+            if (key.endsWith(':unbind'))
+                throw new Error(replyText('序号无效或已过期，本次操作未执行。请发送 /unbind 获取新列表。'));
+            throw new Error(replyText('序号无效或已过期，尚未切换。请发送 /{0} 获取新列表。', key.endsWith(':reasoning') ? 'reasoning' : key.endsWith(':presets') ? 'presets' : key.endsWith(':models') ? 'models' : key.endsWith(':workspaces') ? 'workspaces' : 'sessions'));
+        }
+        return selected;
+    }
+    async idle(sessionId, signal, command) {
+        if (!sessionId)
+            return;
+        if (this.pending(sessionId))
+            throw new Error(replyText('请先完成当前问题或审批，再执行 /{0}。', command));
+        const rows = await this.listSessions(signal);
+        if (rows.find((row) => row.sessionId === sessionId)?.running)
+            throw new Error(replyText('当前任务正在运行，请先 /stop，等待停止后再执行 /{0}。', command));
+    }
+    execute(channel, msg, signal) {
+        return withReplyLocale(this.host, () => this.lifetime.run(signal, async () => {
+            try {
+                // 原生渠道直接展示选择页，文字渠道沿用原列表及序号契约。
+                const list = /^\/(sessions|sessionlist|workspaces|workspacelist|models|presets|presetlist|reasoning|reasonings|reasoninglist)(?:\s+(\d+))?\s*$/i.exec(msg.text.trim());
+                if (list && !(list[1].toLowerCase().startsWith('reasoning') && list[2]) && channel.sendChoices && this.showChoices && !msg.media?.length) {
+                    const name = list[1].toLowerCase();
+                    const section = name === 'sessionlist' ? 'sessions' : name === 'workspacelist' ? 'workspaces' : name === 'presetlist' ? 'presets' : name === 'reasonings' || name === 'reasoninglist' ? 'reasoning' : name;
+                    // 尚无会话时 /models 仍可浏览目录，不把查询变成必须创建会话的操作。
+                    if (section !== 'models' || this.router.lookup(channel.id, msg.kind ?? 'dm', msg.chatId)) {
+                        msg = { ...msg, text: `/menu ${section} ${list[2] || '1'}` };
+                    }
+                }
+                const navigation = {};
+                const text = await this.run(channel, msg, signal, navigation);
+                if (!text)
+                    return text;
+                const command = /^\/([a-z][a-z0-9_-]*)/i.exec(msg.text.trim())?.[1]?.toLowerCase() ?? '';
+                const current = this.router.lookup(channel.id, msg.kind ?? 'dm', msg.chatId);
+                const choices = navigation.choices ?? commandNavigation(command, !!current);
+                if (!choices.length)
+                    return text;
+                const fallback = text + related(replyText('接下来可以：'), ...choices.map(choice => `${choice.label} — ${choice.value}`));
+                // 导航发送失败不能把已完成的命令改报失败；新会话的按钮绑定切换后的会话。
+                if (channel.sendChoices && this.showChoices && !signal.aborted) {
+                    try {
+                        return await this.showChoices(channel, msg, text, choices, current?.sessionId, false);
+                    }
+                    catch {
+                        return fallback;
+                    }
+                }
+                return fallback;
+            }
+            catch (error) {
+                if (error?.code === 'im/session-in-use')
+                    throw new Error(replyText('该会话已关联其他聊天，不能重复接续。请用 /sessions 选择其他会话，或 /new 新建。'));
+                throw error;
+            }
+        }));
+    }
+    /** 附加查询限时且独立降级，不能把已完成操作改报失败。 */
+    async optional(read, parent) {
+        const scope = new AbortController();
+        const signal = AbortSignal.any([parent, scope.signal]);
+        let timer;
+        try {
+            return await Promise.race([
+                Promise.resolve().then(() => this.lifetime.run(signal, () => read(signal))).catch(() => undefined),
+                new Promise((resolve) => { timer = setTimeout(() => { scope.abort(); resolve(undefined); }, 800); }),
+            ]);
+        }
+        finally {
+            clearTimeout(timer);
+            scope.abort();
+        }
+    }
+    async newDetails(binding, signal) {
+        let cwd;
+        let model;
+        try {
+            const session = binding.handle?.agent?.session;
+            cwd = session?.header?.cwd;
+            model = (await readSessionHistory(this.host, session, signal) ?? []).findLast((event) => event.type === 'model/selection')?.data;
+        }
+        catch { /* 继续尝试宿主快照，不能改用账号默认值冒充实际配置。 */ }
+        const [snapshot, rows] = await Promise.all([
+            model?.provider && model.model ? undefined : this.optional((sig) => this.snapshot(binding.sessionId, sig), signal),
+            cwd ? undefined : this.optional((sig) => this.call('sessionController', 'list', {}, sig), signal),
+        ]);
+        model = model?.provider && model.model ? model : snapshot?.projections?.values?.modelSelection?.next;
+        cwd ||= rows?.items?.find((row) => row.sessionId === binding.sessionId)?.cwd;
+        return [replyText('工作区：{0}', cwd || replyText('暂时无法读取')), model ? replyText('模型：{0}/{1} · {2}', model.provider, model.model, model.reasoningEffort || replyText('默认推理')) : replyText('模型：暂时无法读取')].join('\n');
+    }
+    async run(channel, msg, signal, navigation) {
+        signal.throwIfAborted();
+        const match = /^\/([a-z][a-z0-9_-]*)([\s\S]*)$/i.exec(msg.text.trim());
+        if (!match)
+            throw new Error(replyText('命令格式无效，请发送 /help。'));
+        const command = match[1].toLowerCase();
+        const input = match[2].trim();
+        const kind = msg.kind === 'group' ? 'group' : 'dm';
+        const scope = JSON.stringify([channel.id, kind, msg.chatId, msg.userId ?? '']);
+        if (msg.media?.length && ['preset', 'presets', 'presetlist', 'help', 'new', 'clear', 'sessions', 'sessionlist', 'session', 'unbind', 'mute', 'unmute', 'workspaces', 'workspacelist', 'workspace', 'models', 'status', 'current', 'stop', 'steer', 'rename', 'fork', 'model', 'reasoning', 'reasonings', 'reasoninglist', 'history', 'queue', 'export'].includes(command))
+            throw new Error(replyText('该控制命令不接受附件，请单独发送。'));
+        const current = this.router.lookup(channel.id, kind, msg.chatId);
+        const requireCurrent = () => { if (!current)
+            throw new Error(replyText('当前没有会话，请先发送消息或 /new。')); return current.sessionId; };
+        if (input && ['presets', 'presetlist', 'help', 'new', 'clear', 'workspaces', 'workspacelist', 'models', 'status', 'current', 'stop', 'fork', 'history', 'reasonings', 'reasoninglist', 'export'].includes(command))
+            throw new Error(replyText('/{0} 暂不支持参数。正确用法：/{1}', command, command));
+        if (command === 'menu' || command === 'm') {
+            const parts = input.split(/\s+/);
+            const rootPage = /^\d+$/.test(parts[0] ?? '');
+            const [section = '', pageText = '1', ...extra] = rootPage ? ['', ...parts] : parts;
+            const page = Number(pageText);
+            if (extra.length || !['', 'sessions', 'workspaces', 'models', 'presets', 'reasoning'].includes(section) || !Number.isSafeInteger(page) || page < 1)
+                throw new Error(replyText('用法：/menu [sessions|workspaces|models|presets|reasoning] [页码]'));
+            let choices = [];
+            let text = replyText('助手操作菜单');
+            if (section === 'sessions') {
+                const rows = await this.listSessions(signal);
+                const workspaces = await this.workspaces(signal);
+                choices = rows.filter(row => !row.origin && !row.running && row.sessionId !== current?.sessionId && !workspaces.archivedSessionIds.includes(row.sessionId)
+                    && !this.router.isBoundElsewhere?.(row.sessionId, channel.id, kind, msg.chatId)).map(row => ({ label: oneLine(row.projections?.values?.title || row.sessionId), value: `/session ${row.sessionId}` }));
+            }
+            else if (section === 'workspaces') {
+                choices = (await this.workspaces(signal)).items.map(item => ({ label: oneLine(item.title ? `${item.title} · ${item.path}` : item.path), value: `/workspace ${item.path}` }));
+            }
+            else if (section === 'reasoning') {
+                const sessionId = requireCurrent();
+                const catalog = await this.call('sessionController', 'modelCatalog');
+                const selected = (await this.snapshot(sessionId, signal)).projections?.values?.modelSelection?.next || catalog.default;
+                const model = selected ? catalog.groups?.find(group => group.id === selected.provider)?.models?.find(item => item.id === selected.model) : undefined;
+                const efforts = model?.reasoning?.efforts || [];
+                text = replyText('模型：{0}\n当前推理：{1}', oneLine(model?.name || selected.model), selected.reasoningEffort || replyText('默认'));
+                choices = efforts.map(item => ({ label: oneLine(item.name || item.id) + (item.id === selected.reasoningEffort ? replyText('〔当前〕') : ''), value: `/reasoning ${this.reasoningChoice(scope, sessionId, selected, item.id)}` }));
+                if (efforts.length)
+                    choices.push({ label: replyText('恢复默认推理'), value: `/reasoning ${this.reasoningChoice(scope, sessionId, selected)}` });
+            }
+            else if (section === 'presets') {
+                choices = (await this.presets()).filter(item => !item.broken).map(item => ({ label: oneLine(item.name || item.id) + (item.isDefault ? replyText('〔默认〕') : ''), value: `/preset id:${item.id}` }));
+                choices.push({ label: replyText('跟随默认预设'), value: '/preset --default' });
+            }
+            else if (section === 'models') {
+                requireCurrent();
+                const catalog = await this.call('sessionController', 'modelCatalog');
+                choices = (catalog?.groups ?? []).flatMap(group => (group.models ?? []).map(model => ({ label: oneLine(`${model.name} (${group.id})`), value: `/model ${group.id}/${model.id}` })));
+            }
+            else {
+                if (current)
+                    text += '\n' + await this.newDetails(current, signal);
+                choices = [
+                    { label: replyText('新会话'), value: '/new' }, { label: replyText('选择会话'), value: '/menu sessions' },
+                    { label: replyText('选择工作区'), value: '/menu workspaces' },
+                    ...(current ? [{ label: replyText('选择模型'), value: '/menu models' }, { label: replyText('停止任务'), value: '/stop' },
+                        { label: replyText('导出会话'), value: '/export' }, { label: replyText('查看状态'), value: '/status' }] : []),
+                    { label: replyText('选择预设'), value: '/menu presets' },
+                    { label: replyText('帮助'), value: '/help' },
+                ];
+            }
+            {
+                // 按每页实际需要的导航按钮计算容量，首页不预留不存在的上一页。
+                const limit = channel.choiceLimits?.maxButtons ?? 11;
+                const slices = [];
+                let offset = 0;
+                do {
+                    const back = section ? 1 : slices.length ? 1 : 0;
+                    const previous = slices.length ? 1 : 0;
+                    const remaining = choices.length - offset;
+                    const capacity = Math.max(1, limit - back - previous);
+                    const size = remaining <= capacity ? capacity : Math.max(1, capacity - 1);
+                    slices.push(choices.slice(offset, offset + size));
+                    offset += size;
+                } while (offset < choices.length);
+                const pages = slices.length;
+                if (page > pages)
+                    throw new Error(replyText('没有第 {0} 页，共 {1} 页。', page, pages));
+                const heading = section === 'sessions' ? replyText('选择会话') : section === 'workspaces' ? replyText('选择工作区') : section === 'reasoning' ? text : section === 'presets' ? replyText('选择预设') : section === 'models' ? replyText('选择模型') : replyText('助手操作菜单');
+                // 部分平台正文空间有限，菜单展示导航，配置详情通过 /status 查询。
+                text = channel.choiceLimits || section ? heading : text;
+                text += ` · ${page}/${pages}`;
+                if (section === 'presets')
+                    text += '\n' + replyText('选择后在当前工作区新建并切换会话，旧会话保留。账号默认预设不变。');
+                if (!choices.length)
+                    text += '\n' + replyText('暂无可选项，可返回菜单选择其他操作。');
+                choices = slices[page - 1];
+                if (section === 'reasoning')
+                    choices = choices.map((choice, i) => ({ ...choice, displayValue: `/reasoning ${i + 1}` }));
+                if (section)
+                    this.remember(`${scope}:${section}`, choices.map(choice => choice.value.slice(choice.value.indexOf(' ') + 1)));
+                const pageCommand = section ? `/menu ${section}` : '/menu';
+                if (page > 1)
+                    choices.push({ label: replyText('上一页'), value: `${pageCommand} ${page - 1}` });
+                if (page < pages)
+                    choices.push({ label: replyText('下一页'), value: `${pageCommand} ${page + 1}` });
+                if (current && pages === 1 && choices.length + 3 <= limit && ['models', 'presets', 'reasoning'].includes(section)) {
+                    choices.push(...commandNavigation(section, true).filter(choice => choice.value !== '/menu' && choice.value !== `/menu ${section}`));
+                }
+                if (section || page > 1)
+                    choices.push({ label: replyText('返回菜单'), value: '/menu' });
+            }
+            signal.throwIfAborted();
+            if (!this.showChoices)
+                return text + '\n' + choices.map(choice => `${choice.label}：${choice.displayValue ?? choice.value}`).join('\n');
+            return this.showChoices(channel, msg, text, choices, current?.sessionId);
+        }
+        if (command === 'export') {
+            const sessionId = requireCurrent();
+            return await exportSession(this.host, channel, msg.chatId, sessionId, signal, () => this.router.lookup(channel.id, kind, msg.chatId)?.sessionId === sessionId);
+        }
+        if (command === 'help') {
+            let commands = [];
+            let hint = current ? '' : replyText('\n发送消息创建会话后，可查看该会话的 Chat 命令。');
+            try {
+                if (current && this.host.get('commands') && this.host.get('sessionController'))
+                    commands = await this.call('commands', 'list', await this.agent(current.sessionId));
+            }
+            catch {
+                signal.throwIfAborted();
+                hint = replyText('\n扩展命令暂时无法读取，以上内置帮助仍可使用；稍后重试 /help。');
+            }
+            const descriptions = extensionHelp();
+            const help = chatControlHelp();
+            // 基础帮助里已经列过的命令不再在扩展小节重复出现（例如 /export）。
+            const documented = new Set([...help.matchAll(/\/([a-z][a-z0-9_-]*)/gi)].map((match) => match[1].toLowerCase()));
+            const extras = commands.filter((item) => !documented.has(item.name.toLowerCase()));
+            return `${oneLine(channel.label || replyText('机器人'))}\n` + help
+                + (extras.length ? replyText('\n\n扩展命令：\n') + extras.map((item) => `/${item.name} — ${descriptions[item.name] || oneLine(item.description)}`).join('\n') : '') + hint;
+        }
+        if (command === 'new' || command === 'clear') {
+            if (current && this.host.get('sessionController'))
+                await this.idle(current.sessionId, signal, command);
+            const next = await this.router.rotate(channel.id, kind, msg.chatId, msg.username || msg.chatId, { signal });
+            return [replyText('已开启新会话'), await this.newDetails(next, signal), replyText('旧会话已保留，直接发送消息即可开始。')].filter(Boolean).join('\n')
+                + related(replyText('查看旧会话：/sessions'), replyText('查看当前配置：/status'));
+        }
+        if (command === 'sessions' || command === 'sessionlist') {
+            const page = input ? Number(input) : 1;
+            if (!Number.isInteger(page) || page < 1)
+                throw new Error(replyText('用法：/sessions [页码]'));
+            const rows = (await this.listSessions(signal)).filter((row) => !row.origin);
+            this.remember(scope + ':sessions', rows.map((row) => row.sessionId));
+            if (!rows.length)
+                return replyText('暂无可接续会话。') + related(replyText('直接发送消息，或 /new 开始聊天'));
+            const pages = Math.ceil(rows.length / 10);
+            if (page > pages)
+                return replyText('没有第 {0} 页，共 {1} 页。', page, pages) + related(replyText('返回列表：/sessions {0}', pages));
+            const visible = rows.slice((page - 1) * 10, page * 10);
+            const workspace = await this.optional((sig) => this.workspaces(sig), signal);
+            signal.throwIfAborted();
+            const archived = workspace ? new Set(workspace.archivedSessionIds) : undefined;
+            const occupied = (row) => this.router.isBoundElsewhere?.(row.sessionId, channel.id, kind, msg.chatId) === true;
+            const available = visible.find((row) => row.sessionId !== current?.sessionId && !row.running && !occupied(row) && archived && !archived.has(row.sessionId));
+            return replyText('会话列表 · 第 {0}/{1} 页 · 共 {2} 个\n\n', page, pages, rows.length)
+                + visible.map((row, i) => `${(page - 1) * 10 + i + 1}. ${oneLine(row.projections?.values?.title || replyText('未命名会话'))}${row.sessionId === current?.sessionId ? replyText('〔当前〕') : ''}${archived?.has(row.sessionId) ? replyText('〔已归档，需先在网页恢复〕') : occupied(row) ? replyText('〔已关联其他聊天〕') : row.running ? replyText('〔运行中〕') : ''}\n${row.sessionId}`).join('\n\n')
+                + related(available ? replyText('切换：/session {0}', rows.indexOf(available) + 1) : '', !archived ? replyText('归档状态暂时无法读取，切换时会重新校验。') : '', page < pages ? replyText('下一页：/sessions {0}', page + 1) : '', replyText('序号 15 分钟内有效，也可使用完整会话 ID。'));
+        }
+        if (command === 'session') {
+            if (!input) {
+                if (!current)
+                    return replyText('当前没有会话。直接发送消息或 /new 开始。');
+                const rows = await this.listSessions(signal);
+                const row = rows.find((item) => item.sessionId === current.sessionId);
+                return replyText('当前会话：{0}\n工作区：{1}\n会话 ID：{2}', oneLine(row?.projections?.values?.title || replyText('未命名会话')), row?.cwd || replyText('暂时无法读取'), current.sessionId) + related(replyText('切换会话：/sessions'), replyText('详细状态：/status'));
+            }
+            const id = this.resolve(scope + ':sessions', input);
+            const rows = await this.listSessions(signal);
+            const row = rows.find((item) => item.sessionId === id && !item.origin);
+            if (!row)
+                throw new Error(replyText('会话不存在或不是可接入的普通会话。'));
+            const workspace = await this.workspaces(signal);
+            if (workspace.archivedSessionIds.includes(id))
+                throw new Error(replyText('请先在 Chat 恢复该归档会话。'));
+            if (workspace.items.filter((item) => item.sessionIds?.includes(id)).length !== 1)
+                throw new Error(replyText('会话工作区归属无效。'));
+            if (row.running && id !== current?.sessionId)
+                throw new Error(replyText('目标会话正在运行，请在 Chat 停止后再切换。'));
+            await this.idle(current?.sessionId, signal, command);
+            await this.router.bind(channel.id, kind, msg.chatId, id, row.projections?.values?.title || id, await this.agent(id), row.cwd || workspace.items.find((item) => item.sessionIds?.includes(id))?.path);
+            return replyText('已切换会话：{0}\n工作区：{1}\n接下来的消息会发送到此会话。', oneLine(row.projections?.values?.title || id), row.cwd || workspace.items.find((item) => item.sessionIds?.includes(id))?.path || replyText('暂时无法读取')) + related(replyText('最近记录：/history'), replyText('重新开始：/new'));
+        }
+        if (command === 'unbind' || command === 'mute' || command === 'unmute') {
+            if (command !== 'unbind' && !input)
+                throw new Error(replyText('用法：/{0} 序号或ID。先发送 /unbind 查看本聊天登记的会话。', command));
+            const records = this.router.chatRecords(channel.id, kind, msg.chatId);
+            if (command === 'unbind' && !input) {
+                this.remember(scope + ':unbind', records.map((item) => item.sessionId));
+                if (!records.length)
+                    return replyText('本聊天没有登记任何会话。');
+                return replyText('本聊天登记的会话 · 共 {0} 个\n\n', records.length)
+                    + records.map((item, i) => `${i + 1}. ${oneLine(item.title || '未命名会话')}${item.sessionId === current?.sessionId ? replyText('〔当前〕') : ''}${item.muted ? replyText('〔已静音〕') : ''}\n${item.sessionId}`).join('\n\n')
+                    + related(replyText('解除登记：/unbind 序号或ID；全部解除（当前会话除外）：/unbind all'), replyText('保留登记但暂停推送：/mute 序号或ID；恢复：/unmute 序号或ID'));
+            }
+            if (!records.length)
+                throw new Error(replyText('本聊天没有登记任何会话。'));
+            const target = input.toLowerCase() === 'all' ? 'all' : this.resolve(scope + ':unbind', input);
+            const label = (id) => {
+                const title = records.find(item => item.sessionId === id)?.title;
+                return title && title !== id ? `${oneLine(title)} (${oneLine(id)})` : oneLine(id);
+            };
+            if (command === 'unbind') {
+                if (target === 'all') {
+                    let removed = 0;
+                    for (const item of records) {
+                        if (item.sessionId === current?.sessionId)
+                            continue;
+                        if (this.router.unbindSession(channel.id, kind, msg.chatId, item.sessionId))
+                            removed += 1;
+                    }
+                    return replyText(removed ? '已解除 {0} 个会话的登记，它们不再向本聊天推送输出。' : '没有需要解除的登记。', removed) + related(current ? replyText('当前会话未受影响。') : '');
+                }
+                if (target === current?.sessionId)
+                    throw new Error(replyText('不能解除当前会话；请先 /new 或 /session 切换。'));
+                if (!this.router.unbindSession(channel.id, kind, msg.chatId, target))
+                    throw new Error(replyText('本聊天没有登记该会话，请发送 /unbind 查看。'));
+                return replyText('已解除登记：{0}\n该会话不再向本聊天推送输出；历史仍保留在网页 Chat 中。', label(target)) + related(replyText('查看登记：/unbind'));
+            }
+            const sessionId = this.resolve(scope + ':unbind', input);
+            if (!records.some((item) => item.sessionId === sessionId))
+                throw new Error(replyText('本聊天没有登记该会话，请发送 /unbind 查看。'));
+            if (!this.router.setMuted(sessionId, command === 'mute'))
+                throw new Error(replyText('会话登记异常，请发送 /unbind 查看。'));
+            return command === 'mute'
+                ? replyText('已静音：{0}\n该会话的输出不再推送到本聊天；/unmute {1} 恢复。', label(sessionId), input)
+                : replyText('已恢复推送：{0}', label(sessionId)) + related(replyText('静音：/mute {0}', input));
+        }
+        if (command === 'workspaces' || command === 'workspacelist' || command === 'workspace') {
+            const { items } = await this.workspaces(signal);
+            if (command !== 'workspace' || !input) {
+                this.remember(scope + ':workspaces', items.map((item) => item.workspaceId));
+                const alternative = items.findIndex((item) => !current || !item.sessionIds?.includes(current.sessionId));
+                return items.length ? replyText('工作区列表 · 共 {0} 个\n\n', items.length) + items.map((item, i) => `${i + 1}. ${item.title ? oneLine(item.title) : oneLine(item.path)}${item.title ? `\n${item.path}` : ''}${current && item.sessionIds?.includes(current.sessionId) ? replyText('〔当前〕') : ''}`).join('\n') + related(alternative >= 0
+                    ? replyText('新建并切换：/workspace {0}', alternative + 1)
+                    : replyText('当前只有这个工作区。直接发消息继续，或 /new 开启新会话。'), replyText('也可使用已列出的绝对路径；旧会话保留，账号默认目录不变。'), replyText('别名：/workspacelist；序号 15 分钟内有效。')) : replyText('还没有可用工作区。请先在网页添加，再发送 /workspaces。');
+            }
+            const target = this.resolve(scope + ':workspaces', input);
+            const workspace = items.find((item) => item.workspaceId === target || item.path === target);
+            if (!workspace)
+                throw new Error(replyText('没有找到这个已添加的工作区，尚未切换。发送 /workspaces 查看可选项；新目录请先在网页添加。'));
+            await this.idle(current?.sessionId, signal, command);
+            await this.router.rotate(channel.id, kind, msg.chatId, msg.username || msg.chatId, { cwd: workspace.path, signal });
+            return replyText('已在「{0}」开启新会话。\n工作区：{1}\n旧会话已保留，可以直接发送任务。', oneLine(workspace.title || workspace.path), workspace.path) + related(replyText('查看配置：/status'), replyText('切回旧会话：/sessions'));
+        }
+        if (command === 'models') {
+            const catalog = await this.call('sessionController', 'modelCatalog');
+            const models = (catalog?.groups ?? []).flatMap((group) => (group.models ?? []).map((model) => ({ id: `${group.id}/${model.id}`, name: model.name })));
+            let selected;
+            if (current) {
+                try {
+                    selected = (await this.snapshot(current.sessionId, signal)).projections?.values?.modelSelection?.next;
+                }
+                catch {
+                    signal.throwIfAborted();
+                }
+            }
+            this.remember(scope + ':models', models.map((model) => model.id));
+            const alternative = selected
+                ? models.findIndex((model) => model.id !== `${selected.provider}/${selected.model}`)
+                : -1;
+            return models.length ? replyText('可用模型 · 共 {0} 个\n\n', models.length) + models.map((model, i) => `${i + 1}. ${oneLine(model.name)}${model.id === (selected && `${selected.provider}/${selected.model}`) ? replyText('〔当前〕') : ''}\n${model.id}`).join('\n\n') + related(current && alternative >= 0
+                ? replyText('切换：/model {0}', alternative + 1) : current && selected
+                ? replyText('当前没有其他可切换模型，继续发送消息即可。')
+                : '', current ? replyText('查看当前模型：/model；推理选项：/reasoning') : replyText('先发消息或 /new 创建会话，再切换模型。'), replyText('序号 15 分钟内有效。')) : replyText('暂无可用模型。请在网页配置模型服务，再发送 /models。');
+        }
+        if (command === 'presets' || command === 'presetlist' || command === 'preset') {
+            const presets = await this.presets();
+            const hint = replyText('选择后在当前工作区新建并切换会话，旧会话保留。账号默认预设不变。');
+            if (command !== 'preset') {
+                this.remember(scope + ':presets', presets.map(item => `id:${item.id}`));
+                return replyText('Agent 预设') + '\n' + presets.map((item, i) => `${i + 1}. ${oneLine(item.name || item.id)} (${item.id})${item.isDefault ? replyText('〔默认〕') : ''}${item.broken ? replyText('〔不可用〕') : ''}${item.description ? '\n' + oneLine(item.description) : ''}`).join('\n\n') + related(hint, replyText('用法：/preset 序号或ID；纯数字 ID：/preset id:ID；跟随默认：/preset --default'));
+            }
+            const sessionId = requireCurrent();
+            if (!input) {
+                const id = (await this.snapshot(sessionId, signal)).projections?.values?.agentPreset;
+                return replyText('当前 Agent 预设：{0}', id ? oneLine(presets.find(item => item.id === id)?.name || id) : replyText('暂时无法读取')) + related(hint, replyText('用法：/preset 序号或ID；纯数字 ID：/preset id:ID；跟随默认：/preset --default'));
+            }
+            const resolved = this.resolve(scope + ':presets', input);
+            const id = resolved.startsWith('id:') ? resolved.slice(3) : resolved;
+            const followDefault = resolved === '--default';
+            const preset = followDefault ? presets.find(item => item.isDefault) : presets.find(item => item.id === id);
+            if (!preset || preset.broken)
+                throw new Error(replyText('预设不存在或不可用，请发送 /presets 重新选择。'));
+            await this.idle(sessionId, signal, 'preset');
+            const matches = (await this.workspaces(signal)).items.filter(item => item.sessionIds?.includes(sessionId));
+            if (matches.length !== 1)
+                throw new Error(replyText('无法确定当前工作区，请先用 /workspace 选择工作区。'));
+            const workspace = matches[0];
+            let createdId;
+            try {
+                const controller = this.service('sessionController');
+                if (typeof controller.create !== 'function')
+                    throw new Error(replyText('当前 Host 不支持 {0}。', 'create'));
+                signal.throwIfAborted();
+                const result = await controller.create({ workspaceId: workspace.workspaceId, ...(followDefault ? {} : { agentPreset: id }) });
+                createdId = result.sessionId;
+                signal.throwIfAborted();
+                await this.router.bind(channel.id, kind, msg.chatId, createdId, createdId, await this.agent(createdId), workspace.path, signal);
+                return replyText('已使用预设 {0} 新建并切换会话：{1}', result.agentPreset || preset.id, createdId) + '\n' + await this.newDetails({ sessionId: createdId }, signal) + related(hint);
+            }
+            catch (error) {
+                const partial = error;
+                if (!createdId && partial.code === 'session/workspace-attach-failed')
+                    createdId = partial.details?.sessionId;
+                if (!createdId)
+                    throw error;
+                return replyText('新会话已创建：{0}，但未能接续。请在网页检查工作区后发送 /session {0}；原聊天绑定保留。', createdId);
+            }
+        }
+        // Host 注册命令可直接用于首次会话，控制命令则要求已有目标。
+        const controls = ['status', 'current', 'stop', 'steer', 'rename', 'fork', 'model', 'reasoning', 'reasonings', 'reasoninglist', 'history', 'queue'];
+        const sessionId = current ? current.sessionId : controls.includes(command) ? requireCurrent() : (await this.router.getOrCreate(channel.id, kind, msg.chatId, msg.username || msg.chatId)).sessionId;
+        if (command === 'queue') {
+            if (!input) {
+                const stream = await this.call('sessionController', 'control', signal);
+                for await (const frame of stream) {
+                    const items = frame.value.queues[sessionId] || [];
+                    if (!items.length)
+                        return replyText('当前没有排队消息。') + related(replyText('直接发消息继续'), replyText('查看状态：/status'));
+                    return replyText('排队消息 · 共 {0} 条\n\n', items.length) + items.map((item) => replyText('{0}〔{1}〕\n{2}', item.id, item.placement === 'queued' ? replyText('等待执行') : item.placement === 'steer' ? replyText('补充指令') : replyText('排队中'), oneLine((item.message?.content ?? []).filter((part) => part.type === 'text').map((part) => part.text || '').join('\n')) || replyText('附件消息'))).join('\n\n')
+                        + related(replyText('移除：/queue remove {0}', items[0].id), replyText('修改：/queue edit {0} 新内容', items[0].id), replyText('改为补充指令：/queue steer {0}', items[0].id));
+                }
+                throw new Error(replyText('无法读取队列。'));
+            }
+            const action = /^(remove|steer|edit)\s+(\S+)(?:\s+([\s\S]+))?$/.exec(input);
+            if (!action || (action[1] === 'edit' && !action[3]) || (action[1] !== 'edit' && action[3]))
+                throw new Error(replyText('用法：/queue remove|steer|edit <消息ID> [新内容]'));
+            await this.call('sessionController', 'updateQueue', { sessionId, itemId: action[2], action: action[1] === 'edit' ? { kind: 'edit', content: [{ type: 'text', text: action[3] }] } : { kind: action[1] } });
+            return replyText('{0}：{1}{2}', action[1] === 'remove' ? replyText('已移除排队消息') : action[1] === 'edit' ? replyText('已修改排队消息') : replyText('已将排队消息调整为补充指令'), action[2], action[1] === 'edit' ? replyText('\n新内容：') + oneLine(action[3]) : '') + related(replyText('查看队列：/queue'), replyText('查看状态：/status'));
+        }
+        if (command === 'status' || command === 'current') {
+            const results = await Promise.allSettled([
+                this.call('sessionController', 'list', {}, signal),
+                this.snapshot(sessionId, signal),
+            ]);
+            signal.throwIfAborted();
+            const row = results[0].status === 'fulfilled' ? results[0].value.items?.find((item) => item.sessionId === sessionId) : undefined;
+            const values = results[1].status === 'fulfilled' ? results[1].value.projections?.values : undefined;
+            const model = values?.modelSelection?.next;
+            const details = [];
+            let queueCount;
+            if (values?.agentPreset)
+                details.push(replyText('Agent 预设：{0}', oneLine(values.agentPreset)));
+            if (values?.permissions?.currentValue)
+                details.push(replyText('权限：{0}', oneLine(this.permissionLabel(values.permissions))));
+            if (values && 'goal' in values) {
+                const phases = { active: replyText('活跃'), paused: replyText('已暂停'), blocked: replyText('受阻'), complete: replyText('已完成') };
+                details.push(replyText('目标：{0}', values.goal ? phases[values.goal.goal?.phase] || replyText('暂时无法读取') : replyText('无目标')));
+            }
+            try {
+                const stream = await this.call('sessionController', 'control', signal);
+                for await (const frame of stream) {
+                    queueCount = frame.value.queues[sessionId]?.length || 0;
+                    details.push(replyText('排队消息：{0} 条', queueCount));
+                    break;
+                }
+            }
+            catch {
+                signal.throwIfAborted();
+            }
+            const actions = [];
+            const phase = values?.goal?.goal?.phase;
+            if (phase === 'active' || phase === 'paused' || phase === 'blocked') {
+                const registered = await this.optional(async () => this.call('commands', 'list', await this.agent(sessionId)), signal);
+                if (registered?.some((item) => item.name === 'goal'))
+                    actions.push(phase === 'active'
+                        ? { label: replyText('暂停目标'), value: '/goal pause' }
+                        : { label: replyText('恢复目标'), value: '/goal resume' });
+            }
+            if (row?.running === true)
+                actions.push({ label: replyText('停止任务'), value: '/stop' });
+            if (queueCount)
+                actions.push({ label: replyText('查看队列'), value: '/queue' });
+            if (!actions.length)
+                actions.push({ label: replyText('刷新状态'), value: '/status' }, { label: replyText('最近记录'), value: '/history' });
+            navigation.choices = [...actions.slice(0, 3), { label: replyText('返回菜单'), value: '/menu' }];
+            return [replyText('会话：{0}', oneLine(row?.projections?.values?.title || sessionId)),
+                replyText('状态：{0}', row?.running === true ? replyText('运行中') : row?.running === false ? replyText('空闲') : replyText('暂时无法读取')),
+                replyText('工作区：{0}', row?.cwd || replyText('暂时无法读取')),
+                model ? replyText('模型：{0}/{1}；推理：{2}', model.provider, model.model, model.reasoningEffort || replyText('默认')) : replyText('模型：暂时无法读取'),
+                ...details, replyText('账号：{0}（{1}）', channel.label, localizeStatus(this.host, channel.status())), replyText('会话 ID：{0}', sessionId),
+            ].join('\n') + related(...(row?.running === true ? [replyText('补充要求：/steer 补充内容')] : []), ...actions.slice(0, 3).map(action => replyText('{0}：{1}', action.label, action.value)));
+        }
+        if (command === 'stop') {
+            try {
+                await this.call('sessionController', 'cancel', { sessionId });
+            }
+            catch (error) {
+                if (error?.code !== 'session/not-found')
+                    throw error;
+                // 冷会话没有可取消的 Agent；只接受列表明确确认空闲，不为停止而激活它。
+                const state = await this.optional((sig) => this.call('sessionController', 'list', {}, sig), signal);
+                if (state?.items?.find(row => row.sessionId === sessionId)?.running !== false)
+                    throw new Error(replyText('暂时无法确认当前会话的运行状态，未能请求停止。请用 /status 查看，或到网页检查会话。'));
+                return replyText('当前没有正在执行的任务。') + related(replyText('确认运行状态：/status'));
+            }
+            const after = await this.optional((sig) => this.call('sessionController', 'list', {}, sig), signal);
+            const idleNow = after?.items?.find((row) => row.sessionId === sessionId)?.running === false;
+            let goalHint = '';
+            try {
+                const goals = this.host.get('goals');
+                if (goals) {
+                    const state = await this.optional(async () => ({ goal: goals.get(await this.agent(sessionId)) }), signal);
+                    goalHint = !state || (state.goal && !state.goal.phase)
+                        ? replyText('如已启用目标任务，请用 /goal pause 暂停目标。')
+                        : state.goal?.phase === 'active' ? replyText('当前目标仍处于活跃状态，请用 /goal pause 暂停目标。') : '';
+                }
+            }
+            catch { /* 停止已提交，附加状态查询失败不能把停止报告为失败。 */ }
+            return [idleNow ? replyText('已请求停止。当前没有正在执行的任务；排队消息保留，可用 /queue 查看。') : replyText('已请求停止当前运行；排队消息保留，可用 /queue 查看。'), goalHint].filter(Boolean).join('\n') + related(replyText('确认运行状态：/status'));
+        }
+        if (command === 'steer') {
+            if (!input)
+                throw new Error(replyText('请填写补充要求。例如：/steer 只修改登录页面，保留现有配色\n查看状态：/status'));
+            this.onSession(sessionId, msg);
+            await this.call('sessionController', 'prompt', { sessionId, requestId: randomUUID(), mode: 'steer', content: [{ type: 'text', text: input }] }, signal);
+            return replyText('补充指令已提交。\n{0}', oneLine(input)) + related(replyText('查看状态：/status'), replyText('请求停止：/stop'));
+        }
+        if (command === 'rename') {
+            if (!input)
+                throw new Error(replyText('请填写新名称，例如：/rename 九月出行计划'));
+            const before = await this.optional((sig) => this.call('sessionController', 'list', {}, sig), signal);
+            const oldTitle = before?.items?.find((row) => row.sessionId === sessionId)?.projections?.values?.title;
+            const result = await this.call('sessionController', 'rename', { sessionId, title: input });
+            this.router.rename(sessionId, result.title);
+            // 显式改名：顺带把话题名也改掉，行为才符合直觉。
+            if (oldTitle === result.title)
+                return replyText('当前名称已是：{0}', oneLine(result.title)) +
+                    related(replyText('查看会话列表：/sessions'));
+            return replyText('当前会话已改名：{0}', oldTitle ? `${oneLine(oldTitle)} → ${oneLine(result.title)}` : oneLine(result.title)) + related(replyText('查看会话列表：/sessions'));
+        }
+        if (command === 'fork') {
+            await this.idle(sessionId, signal, command);
+            const workspace = (await this.workspaces(signal)).items.find((item) => item.sessionIds?.includes(sessionId));
+            if (!workspace)
+                throw new Error(replyText('当前会话工作区不可用，无法分叉。'));
+            let createdId;
+            try {
+                signal.throwIfAborted();
+                // 必须先保留创建结果，再检查取消，避免已创建的分叉失去可追踪 ID。
+                const controller = this.service('sessionController');
+                if (typeof controller.fork !== 'function')
+                    throw new Error(replyText('当前 Host 不支持 fork。'));
+                const result = (await controller.fork({ sessionId }));
+                createdId = result.sessionId;
+                signal.throwIfAborted();
+                await this.router.bind(channel.id, kind, msg.chatId, createdId, createdId, await this.agent(createdId), workspace.path, signal);
+                return replyText('已分叉并切换会话：{0}\n工作区：{1}\n新消息将继续这个分叉，原会话保留。', createdId, oneLine(workspace.path)) + related(replyText('查看继承记录：/history'), replyText('切回原会话：/sessions'));
+            }
+            catch (error) {
+                const partial = error;
+                const attachFailed = partial?.code === 'session/workspace-attach-failed';
+                if (!createdId && attachFailed && typeof partial.details?.sessionId === 'string')
+                    createdId = partial.details.sessionId;
+                if (!createdId && partial?.code === 'session/fork-unavailable')
+                    throw new Error(replyText('当前会话还没有可分叉的完整回合。请完成一轮对话后再发送 /fork；也可用 /new 开始。'));
+                if (!createdId)
+                    throw error;
+                return replyText('分叉已创建：{0}，但未能切换，当前绑定仍保留原会话。\n{1}发送 /session {2} 接续。', createdId, attachFailed ? replyText('请先在网页检查并修复该分叉的工作区归属，然后') : replyText('可稍后'), createdId);
+            }
+        }
+        if (command === 'model' || command === 'reasoning' || command === 'reasonings' || command === 'reasoninglist') {
+            const catalog = await this.call('sessionController', 'modelCatalog');
+            const snapshot = await this.snapshot(sessionId, signal);
+            const selected = snapshot.projections?.values?.modelSelection?.next || catalog?.default;
+            if (!selected?.provider || !selected.model)
+                throw new Error(replyText('模型：暂时无法读取'));
+            if (command === 'model') {
+                if (!input) {
+                    const name = catalog.groups?.find((group) => group.id === selected.provider)?.models?.find((item) => item.id === selected.model)?.name;
+                    return replyText('当前模型：{0}\n模型 ID：{1}/{2}\n推理等级：{3}', oneLine(name || selected.model), selected.provider, selected.model, selected.reasoningEffort || replyText('默认')) + related(replyText('选择其他模型：/models'), replyText('查看推理选项：/reasoning'), replyText('切换用法：/model {0}/{1} [推理等级ID]', selected.provider, selected.model));
+                }
+                if (input.split(/\s+/).length > 2)
+                    throw new Error(replyText('参数过多。用法：/model 序号或provider/model [推理等级ID]；可用模型：/models'));
+                const [choice, reasoningEffort] = input.split(/\s+/);
+                const id = this.resolve(scope + ':models', choice);
+                const slash = id.indexOf('/');
+                if (slash < 1)
+                    throw new Error(replyText('用法：/model <序号或provider/model> [推理等级]'));
+                const result = await this.call('sessionController', 'selectModel', { sessionId, provider: id.slice(0, slash), model: id.slice(slash + 1), ...(reasoningEffort ? { reasoningEffort } : {}) });
+                return replyText('已切换模型：{0}/{1}；推理：{2}\n{3}', result.selected.provider, result.selected.model, result.selected.reasoningEffort || replyText('默认'), modelDefaultHint()) + related(replyText('调整推理：/reasoning'), replyText('查看模型：/models'));
+            }
+            const model = catalog.groups?.find((group) => group.id === selected.provider)?.models?.find((item) => item.id === selected.model);
+            const efforts = model?.reasoning?.efforts || [];
+            if (!input || command !== 'reasoning') {
+                this.remember(scope + ':reasoning', efforts.map(item => this.reasoningChoice(scope, sessionId, selected, item.id)));
+                return replyText('模型：{0}\n当前推理：{1}\n{2}', oneLine(model?.name || selected.model), selected.reasoningEffort || replyText('默认'), efforts.length ? replyText('可选等级：\n') + efforts.map((item, i) => `${i + 1}. ${item.id} — ${oneLine(item.name)}`).join('\n') : replyText('当前模型没有可选推理等级。')) + related(...(efforts.length ? [replyText('切换：/reasoning {0}', '1'), replyText('也可使用 /reasoning id:等级ID；序号 15 分钟内有效。'), replyText('恢复默认：/reasoning --default'), replyText('当前模型：/model')] : [replyText('当前模型：/model'), replyText('选择其他模型：/models')]));
+            }
+            const resolved = this.resolve(scope + ':reasoning', input);
+            let effort = resolved.startsWith('id:') ? resolved.slice(3) : resolved;
+            if (resolved.startsWith('--choice ')) {
+                const token = resolved.slice(9);
+                const choice = this.reasoningChoices.get(token);
+                if (!choice || choice.scope !== scope || choice.sessionId !== sessionId || choice.provider !== selected.provider || choice.model !== selected.model || Date.now() - choice.time >= 15 * 60_000)
+                    throw new Error(replyText('选择已过期，或会话、模型已变化。请发送 /reasoning 重新选择。'));
+                effort = choice.effort ?? '--default';
+                this.reasoningChoices.delete(token);
+            }
+            if (effort !== '--default' && !efforts.some(item => item.id === effort))
+                throw new Error(replyText('推理等级无效，请先 /reasoning 查看。'));
+            await this.call('sessionController', 'selectModel', { sessionId, provider: selected.provider, model: selected.model, ...(effort === '--default' ? {} : { reasoningEffort: effort }) });
+            return replyText('推理等级已设为：{0}\n{1}', effort === '--default' ? replyText('默认') : effort, modelDefaultHint()) + related(replyText('查看当前模型：/model'), replyText('查看推理选项：/reasoning'));
+        }
+        if (command === 'history') {
+            const snapshot = await this.snapshot(sessionId, signal);
+            const history = (snapshot.records ?? []).flatMap((record) => record.type === 'event' && record.event ? [record.event] : []).filter((record) => record.type === 'assistant/message' || (record.type === 'user/message' && record.data?.source?.kind === 'user'))
+                .flatMap((record) => {
+                const text = (record.data?.message?.content || record.data?.content || []).filter((part) => part.type === 'text').map((part) => part.text || '').join('\n');
+                return text.trim() ? [replyText('{0}：{1}', record.type === 'assistant/message' ? replyText('助手') : replyText('用户'), text)] : [];
+            }).join('\n\n');
+            return (history ? replyText('最近文字记录（不是完整历史）\n\n') + history : replyText('最近记录中没有可展示的文字，图片或文件请在网页查看。')) + related(replyText('继续此会话：直接发消息'), replyText('换一个会话：/sessions'), replyText('完整记录：在网页打开当前会话'));
+        }
+        const agent = await this.agent(sessionId);
+        const images = (msg.media || []).map((media) => {
+            if (media.kind !== 'image' || !media.data || !media.mediaType)
+                throw new Error(replyText('Chat 命令只支持文字和图片附件。'));
+            return { mediaType: media.mediaType, data: Buffer.from(media.data).toString('base64'), ...(media.name ? { name: media.name } : {}) };
+        });
+        this.onSession(sessionId, msg);
+        const result = await this.call('commands', 'execute', agent, msg.text.trim(), images, signal);
+        let goal;
+        if (command === 'goal') {
+            try {
+                goal = this.host.get('goals')?.get(agent);
+            }
+            catch { /* 保留宿主原始结果，附加状态查询不改变操作结果。 */ }
+        }
+        return result ? extensionReply(command, result.result, goal) : replyText('未知命令 /{0}。发送 /help 查看当前 Chat 支持的命令。', command);
+    }
+}