feique 1.4.0 → 1.5.1

package/dist/backend/qwen.js

@@ -0,0 +1,372 @@
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { registerBackend } from './registry.js';
+export class QwenBackend {
+    config;
+    qwenHomeDir;
+    name = 'qwen';
+    constructor(config, qwenHomeDir = resolveQwenHomeDir()) {
+        this.config = config;
+        this.qwenHomeDir = qwenHomeDir;
+    }
+    async run(options) {
+        const args = this.buildArgs(options);
+        const spawnSpec = this.buildSpawnSpec(args);
+        options.logger.info({ command: spawnSpec.command, args: spawnSpec.args, workdir: options.workdir }, 'Starting Qwen turn');
+        return await new Promise((resolve, reject) => {
+            const processRef = spawn(spawnSpec.command, spawnSpec.args, {
+                cwd: options.workdir,
+                env: {
+                    ...process.env,
+                    NO_COLOR: '1',
+                },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stderr = '';
+            let stdoutBuffer = '';
+            let sessionId = options.sessionId;
+            let finalMessage = '';
+            let inputTokens;
+            let outputTokens;
+            let settled = false;
+            let timeoutHandle;
+            let abortCleanup;
+            const finishReject = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(error);
+            };
+            const finishResolve = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                resolve(result);
+            };
+            const cleanup = () => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                abortCleanup?.();
+                abortCleanup = undefined;
+            };
+            const abortRun = (reason) => {
+                if (processRef.killed)
+                    return;
+                const message = typeof reason === 'string' ? reason : reason instanceof Error ? reason.message : 'Qwen run aborted';
+                const error = new Error(message);
+                error.name = 'AbortError';
+                processRef.kill('SIGTERM');
+                setTimeout(() => {
+                    if (!processRef.killed)
+                        processRef.kill('SIGKILL');
+                }, 3000).unref();
+                finishReject(error);
+            };
+            if (options.timeoutMs && options.timeoutMs > 0) {
+                timeoutHandle = setTimeout(() => {
+                    abortRun(`Qwen timed out after ${options.timeoutMs}ms`);
+                }, options.timeoutMs);
+                timeoutHandle.unref();
+            }
+            if (options.signal) {
+                const onAbort = () => abortRun(options.signal?.reason ?? 'Qwen run aborted');
+                if (options.signal.aborted) {
+                    onAbort();
+                    return;
+                }
+                options.signal.addEventListener('abort', onAbort, { once: true });
+                abortCleanup = () => options.signal?.removeEventListener('abort', onAbort);
+            }
+            if (typeof processRef.pid === 'number') {
+                void options.onSpawn?.(processRef.pid);
+            }
+            processRef.stdout.on('data', async (chunk) => {
+                stdoutBuffer += chunk.toString('utf8');
+                const lines = stdoutBuffer.split(/\r?\n/);
+                stdoutBuffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed.startsWith('{'))
+                        continue;
+                    try {
+                        const event = JSON.parse(trimmed);
+                        // Session id is emitted on both init and result events.
+                        if (event.session_id) {
+                            sessionId = event.session_id;
+                        }
+                        // Extract final text + usage from result event.
+                        if (event.type === 'result') {
+                            if (typeof event.result === 'string') {
+                                finalMessage = event.result;
+                            }
+                            if (event.usage) {
+                                if (typeof event.usage.input_tokens === 'number')
+                                    inputTokens = event.usage.input_tokens;
+                                if (typeof event.usage.output_tokens === 'number')
+                                    outputTokens = event.usage.output_tokens;
+                            }
+                        }
+                        // Fall back to assistant text content if result event never arrives.
+                        if (event.type === 'assistant' && event.message?.content) {
+                            const texts = event.message.content
+                                .filter(c => c.type === 'text' && typeof c.text === 'string')
+                                .map(c => c.text)
+                                .join('\n');
+                            if (texts) {
+                                finalMessage = texts;
+                            }
+                        }
+                        const backendEvent = {
+                            type: event.type,
+                            session_id: event.session_id ?? sessionId,
+                            message: typeof event.result === 'string' ? event.result : undefined,
+                        };
+                        await options.onEvent?.(backendEvent);
+                    }
+                    catch {
+                        options.logger.debug({ line }, 'Ignoring unparsable Qwen line');
+                    }
+                }
+            });
+            processRef.stderr.on('data', (chunk) => {
+                stderr += chunk.toString('utf8');
+            });
+            processRef.on('error', (error) => {
+                finishReject(error instanceof Error ? error : new Error(String(error)));
+            });
+            processRef.on('close', (exitCode) => {
+                if (settled)
+                    return;
+                if ((exitCode ?? 1) !== 0 && !finalMessage) {
+                    finishReject(new Error(`Qwen exited with code ${exitCode ?? 1}: ${stderr.trim() || 'no stderr output'}`));
+                    return;
+                }
+                finishResolve({
+                    sessionId,
+                    finalMessage: finalMessage.trim(),
+                    stderr: stderr.trim(),
+                    exitCode: exitCode ?? 0,
+                    inputTokens,
+                    outputTokens,
+                });
+            });
+        });
+    }
+    summarizeEvent(event) {
+        if (event.type === 'error' && typeof event.message === 'string') {
+            return `Qwen 错误：${event.message}`;
+        }
+        return null;
+    }
+    async listProjectSessions(projectRoot, limit = 10) {
+        const sessions = await this.scanSessions();
+        const matches = [];
+        for (const session of sessions) {
+            const match = scoreSessionMatch(projectRoot, session.cwd);
+            if (!match)
+                continue;
+            matches.push({
+                ...session,
+                matchKind: match.kind,
+                matchScore: match.score,
+            });
+        }
+        return matches
+            .sort((a, b) => {
+            const scoreDelta = (b.matchScore ?? 0) - (a.matchScore ?? 0);
+            if (scoreDelta !== 0)
+                return scoreDelta;
+            return b.updatedAt.localeCompare(a.updatedAt);
+        })
+            .slice(0, limit);
+    }
+    async findLatestSession(projectRoot) {
+        const [session] = await this.listProjectSessions(projectRoot, 1);
+        return session ?? null;
+    }
+    async findSessionById(projectRoot, sessionId) {
+        const sessions = await this.scanSessions();
+        const candidate = sessions.find(s => s.sessionId === sessionId);
+        if (!candidate)
+            return null;
+        const match = scoreSessionMatch(projectRoot, candidate.cwd);
+        if (!match)
+            return null;
+        return { ...candidate, matchKind: match.kind, matchScore: match.score };
+    }
+    buildArgs(options) {
+        const args = ['-p'];
+        args.push('--output-format', 'stream-json');
+        const approvalMode = options.projectConfig?.approvalMode ?? this.config.defaultApprovalMode;
+        args.push('--approval-mode', approvalMode);
+        const model = options.projectConfig?.model ?? this.config.defaultModel;
+        if (model) {
+            args.push('--model', model);
+        }
+        const allowedTools = options.projectConfig?.allowedTools ?? this.config.allowedTools;
+        if (allowedTools && allowedTools.length > 0) {
+            args.push('--allowed-tools', ...allowedTools);
+        }
+        const systemPromptAppend = options.projectConfig?.systemPromptAppend ?? this.config.systemPromptAppend;
+        if (systemPromptAppend) {
+            args.push('--append-system-prompt', systemPromptAppend);
+        }
+        if (options.sessionId) {
+            args.push('--resume', options.sessionId);
+        }
+        args.push(options.prompt);
+        return args;
+    }
+    buildSpawnSpec(qwenArgs) {
+        if (!this.config.preExec) {
+            return { command: this.config.bin, args: qwenArgs };
+        }
+        const shell = this.config.shell ?? process.env.SHELL ?? '/bin/zsh';
+        const chainedCommand = `${this.config.preExec} && ${quoteShellCommand([this.config.bin, ...qwenArgs])}`;
+        return { command: shell, args: ['-ic', chainedCommand] };
+    }
+    /**
+     * Walk `~/.qwen/projects/<slug>/chats/*.jsonl` and parse the first
+     * line of each file to extract `sessionId` + `cwd` + `timestamp`.
+     *
+     * Qwen encodes the project directory as the slug (e.g. `/Users/dh` →
+     * `-Users-dh`). We don't depend on that mapping — we walk every slug
+     * and match by parsed `cwd`.
+     */
+    async scanSessions() {
+        const projectsDir = path.join(this.qwenHomeDir, 'projects');
+        const sessions = new Map();
+        let slugEntries;
+        try {
+            slugEntries = await fs.readdir(projectsDir);
+        }
+        catch {
+            return [];
+        }
+        for (const slug of slugEntries) {
+            const chatsDir = path.join(projectsDir, slug, 'chats');
+            const chatFiles = await fs.readdir(chatsDir).catch(() => []);
+            for (const chatFile of chatFiles) {
+                if (!chatFile.endsWith('.jsonl'))
+                    continue;
+                const filePath = path.join(chatsDir, chatFile);
+                const stat = await fs.stat(filePath).catch(() => null);
+                if (!stat?.isFile())
+                    continue;
+                try {
+                    const content = await fs.readFile(filePath, 'utf8');
+                    const firstLine = content.split(/\r?\n/, 1)[0]?.trim();
+                    if (!firstLine)
+                        continue;
+                    const parsed = JSON.parse(firstLine);
+                    const sessionId = parsed.sessionId;
+                    const cwd = parsed.cwd;
+                    if (!sessionId || !cwd)
+                        continue;
+                    const createdAt = parsed.timestamp;
+                    const updatedAt = new Date(stat.mtimeMs).toISOString();
+                    const existing = sessions.get(sessionId);
+                    if (!existing || existing.updatedAt < updatedAt) {
+                        const record = {
+                            sessionId,
+                            cwd,
+                            updatedAt,
+                            filePath,
+                            source: 'sessions',
+                            backend: 'qwen',
+                        };
+                        if (createdAt) {
+                            record.createdAt = createdAt;
+                        }
+                        sessions.set(sessionId, record);
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        return [...sessions.values()].sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    }
+}
+function resolveQwenHomeDir() {
+    const configured = process.env.QWEN_HOME?.trim();
+    if (!configured)
+        return path.join(os.homedir(), '.qwen');
+    if (configured === '~')
+        return os.homedir();
+    if (configured.startsWith('~/'))
+        return path.join(os.homedir(), configured.slice(2));
+    return path.resolve(configured);
+}
+function quoteShellArg(value) {
+    if (value.length === 0)
+        return "''";
+    return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+function quoteShellCommand(parts) {
+    return parts.map(quoteShellArg).join(' ');
+}
+const FUZZY_SUFFIX_TOKENS = new Set(['bridge', 'repo', 'project', 'workspace']);
+function scoreSessionMatch(projectRoot, sessionCwd) {
+    const normalizedProjectRoot = path.resolve(projectRoot).replace(/\/+$/, '').toLowerCase();
+    const normalizedSessionRoot = path.resolve(sessionCwd).replace(/\/+$/, '').toLowerCase();
+    if (normalizedProjectRoot === normalizedSessionRoot) {
+        return { kind: 'exact-root', score: 100 };
+    }
+    const projectBase = path.basename(normalizedProjectRoot);
+    const sessionBase = path.basename(normalizedSessionRoot);
+    if (projectBase === sessionBase) {
+        return { kind: 'basename', score: 80 };
+    }
+    const normalizedProjectName = normalizeProjectName(projectBase);
+    const normalizedSessionName = normalizeProjectName(sessionBase);
+    if (normalizedProjectName && normalizedProjectName === normalizedSessionName) {
+        return { kind: 'normalized-name', score: 60 };
+    }
+    if (normalizedProjectName.length >= 5 && normalizedSessionName.includes(normalizedProjectName)) {
+        return { kind: 'basename-contains', score: 40 };
+    }
+    return null;
+}
+function normalizeProjectName(input) {
+    const tokens = input
+        .toLowerCase()
+        .replace(/\.git$/, '')
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+    const filtered = tokens.filter(token => !FUZZY_SUFFIX_TOKENS.has(token));
+    return (filtered.length > 0 ? filtered : tokens).join('-');
+}
+// ---------------------------------------------------------------------------
+// Registry definition
+// ---------------------------------------------------------------------------
+export const qwenBackendDefinition = {
+    name: 'qwen',
+    create(config) {
+        return new QwenBackend({
+            bin: config.qwen?.bin ?? 'qwen',
+            shell: config.qwen?.shell ?? config.codex.shell,
+            preExec: config.qwen?.pre_exec ?? config.codex.pre_exec,
+            defaultApprovalMode: config.qwen?.default_approval_mode ?? 'default',
+            defaultModel: config.qwen?.default_model,
+            allowedTools: config.qwen?.allowed_tools,
+            systemPromptAppend: config.qwen?.system_prompt_append,
+            runTimeoutMs: config.qwen?.run_timeout_ms ?? config.codex.run_timeout_ms,
+        });
+    },
+    probeSpec(config) {
+        return {
+            bin: config.qwen?.bin ?? 'qwen',
+            shell: config.qwen?.shell ?? config.codex.shell,
+            preExec: config.qwen?.pre_exec ?? config.codex.pre_exec,
+        };
+    },
+    defaultFallback: ['claude', 'codex'],
+};
+registerBackend(qwenBackendDefinition);
+//# sourceMappingURL=qwen.js.map

package/dist/backend/qwen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen.js","sourceRoot":"","sources":["../../src/backend/qwen.ts"],"names":[],"mappings":"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"}

package/dist/backend/registry.d.ts

@@ -0,0 +1,58 @@
+import type { BridgeConfig } from '../config/schema.js';
+import type { Backend, BackendName } from './types.js';
+import type { ProbeSpec } from './probe.js';
+import type { CodexSessionIndex } from '../codex/session-index.js';
+/**
+ * Extensible backend registry.
+ *
+ * Every backend (codex, claude, qwen, ...) contributes a BackendDefinition
+ * that knows how to construct itself from BridgeConfig and how to expose
+ * its probe spec for startup failover. Adding a new backend is purely an
+ * additive change: drop a new file under src/backend/, export its
+ * definition, call registerBackend() at module load, and wire it into
+ * src/backend/factory.ts's side-effect import list.
+ *
+ * BackendName is intentionally widened to `string` (see types.ts) —
+ * compile-time literal unions were incompatible with a registry because
+ * every new backend would require touching the type. Runtime validation
+ * happens in requireBackendDefinition().
+ */
+export interface BackendDependencies {
+    /**
+     * Shared CodexSessionIndex, passed in by FeiqueService. Any backend
+     * that wants access can read it from here; codex relies on it for
+     * resume semantics.
+     */
+    codexSessionIndex?: CodexSessionIndex;
+}
+export interface BackendDefinition {
+    /** Unique registry key, e.g. 'codex', 'claude', 'qwen'. */
+    readonly name: string;
+    /**
+     * Build a live Backend instance from config. Called on every run so
+     * hot-reloaded config is picked up immediately.
+     */
+    create(config: BridgeConfig, deps: BackendDependencies): Backend;
+    /**
+     * Extract the probe spec (bin + shell + pre_exec) from config.
+     * Used by the failover resolver before each run.
+     */
+    probeSpec(config: BridgeConfig): ProbeSpec;
+    /**
+     * Optional default fallback chain. Used when neither the project nor
+     * the global config supplies an explicit fallback list. If omitted,
+     * the resolver falls back to "every other registered backend" in
+     * registration order.
+     *
+     * Example: codex's default fallback is ['claude'] so that when codex
+     * is broken on a box, users get claude automatically without needing
+     * to set anything.
+     */
+    readonly defaultFallback?: readonly string[];
+}
+export declare function registerBackend(definition: BackendDefinition): void;
+export declare function getBackendDefinition(name: string): BackendDefinition | undefined;
+export declare function requireBackendDefinition(name: string): BackendDefinition;
+export declare function listBackendNames(): BackendName[];
+/** Visible for tests only. */
+export declare function clearBackendRegistry(): void;

package/dist/backend/registry.js

@@ -0,0 +1,23 @@
+const registry = new Map();
+export function registerBackend(definition) {
+    registry.set(definition.name, definition);
+}
+export function getBackendDefinition(name) {
+    return registry.get(name);
+}
+export function requireBackendDefinition(name) {
+    const def = registry.get(name);
+    if (!def) {
+        const known = [...registry.keys()].join(', ') || '(none)';
+        throw new Error(`Unknown backend: ${name}. Registered backends: ${known}`);
+    }
+    return def;
+}
+export function listBackendNames() {
+    return [...registry.keys()];
+}
+/** Visible for tests only. */
+export function clearBackendRegistry() {
+    registry.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/backend/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/backend/registry.ts"],"names":[],"mappings":"AA2DA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD,MAAM,UAAU,eAAe,CAAC,UAA6B;IAC3D,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,0BAA0B,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,oBAAoB;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/backend/types.d.ts

@@ -1,5 +1,10 @@
 import type { Logger } from '../logging.js';
-export type BackendName = 'codex' | 'claude';
+/**
+ * Backend identifier. Intentionally typed as `string` (not a literal union)
+ * because backends are registered at runtime via src/backend/registry.ts.
+ * Use requireBackendDefinition() to validate at the boundary.
+ */
+export type BackendName = string;
 export interface BackendEvent {
     type?: string;
     session_id?: string;

package/dist/bridge/commands.d.ts

@@ -90,6 +90,7 @@ export type BridgeCommand = {
     value?: string;
 } | {
     kind: 'backend';
+    action?: 'list';
     name?: string;
 } | {
     kind: 'team';

package/dist/bridge/commands.js

@@ -38,8 +38,13 @@ export function parseBridgeCommand(input) {
             return parseSessionCommand(argument);
         case '/admin':
             return parseAdminCommand(argument);
-        case '/backend':
-            return { kind: 'backend', name: argument || undefined };
+        case '/backend': {
+            const arg = (argument || '').trim().toLowerCase();
+            if (arg === 'list' || arg === 'ls' || arg === '列表' || arg === '所有') {
+                return { kind: 'backend', action: 'list' };
+            }
+            return { kind: 'backend', name: arg || undefined };
+        }
         case '/team':
             return { kind: 'team' };
         case '/learn':
@@ -85,7 +90,7 @@ export function buildHelpText() {
         '/projects 查看可用项目',
         '/project <名称> 切换项目',
         '/status 查看当前状态',
-        '/backend codex|claude 切换后端',
+        '/backend codex|claude|qwen 切换后端',
         '/team 查看团队成员活动',
         '/learn <内容> 记录团队知识',
         '/recall <关键词> 检索知识',
@@ -113,8 +118,10 @@ export function buildFullHelpText() {
         '',
         '后端切换',
         '/backend 查看当前项目的活跃后端',
+        '/backend list 列出所有已注册后端 + fallback 链 + failover 开关',
         '/backend codex 切换当前项目到 Codex 后端',
         '/backend claude 切换当前项目到 Claude Code 后端',
+        '/backend qwen 切换当前项目到 Qwen Code 后端',
         '',
         '会话管理',
         '/session list 列出当前项目保存过的会话',
@@ -283,6 +290,8 @@ export function describeBridgeCommand(command) {
             }
             return `管理员操作: ${command.resource} ${command.action}${'value' in command && command.value ? ` ${command.value}` : ''}`;
         case 'backend':
+            if (command.action === 'list')
+                return '列出所有已注册后端';
             return command.name ? `切换后端到 ${command.name}` : '查看当前后端';
         case 'team':
             return '查看团队协作态势';
@@ -337,7 +346,7 @@ export function isReadOnlyCommand(command) {
         case 'session':
             return command.action === 'list';
         case 'backend':
-            return !command.name;
+            return command.action === 'list' || !command.name;
         case 'team':
         case 'recall':
         case 'insights':
@@ -498,17 +507,17 @@ function parseNaturalLanguageCommand(input) {
     }
     // ── /backend: 后端切换（必须在项目切换之前，否则 "切到 claude" 会被误判为切换项目）──
     // Pattern 1: 带"后端"关键词 — "切换后端到 claude" / "后端换成 codex"
-    const backendWithKeyword = normalized.match(/^(?:切换(?:到|为)?|使用|换(?:到|成)?|改(?:到|为|用)?)?\s*(?:后端(?:(?:切换)?(?:到|为)?)?)\s*(codex|claude)\s*(?:后端)?$/i);
+    const backendWithKeyword = normalized.match(/^(?:切换(?:到|为)?|使用|换(?:到|成)?|改(?:到|为|用)?)?\s*(?:后端(?:(?:切换)?(?:到|为)?)?)\s*(codex|claude|qwen)\s*(?:后端)?$/i);
     if (backendWithKeyword) {
         return { kind: 'backend', name: backendWithKeyword[1].toLowerCase() };
     }
     // Pattern 2: 不带"后端"— "用 claude" / "换成 codex" / "切到 claude" / "改用 codex"
-    const backendDirect = normalized.match(/^(?:用|使用|换(?:成|到)?|切(?:换?(?:到|成)?)?|改(?:用|成|到)?|转(?:到|成)?)\s*(codex|claude)(?:\s*(?:吧|看看|试试|帮我|来))?$/i);
+    const backendDirect = normalized.match(/^(?:用|使用|换(?:成|到)?|切(?:换?(?:到|成)?)?|改(?:用|成|到)?|转(?:到|成)?)\s*(codex|claude|qwen)(?:\s*(?:吧|看看|试试|帮我|来))?$/i);
     if (backendDirect) {
         return { kind: 'backend', name: backendDirect[1].toLowerCase() };
     }
     // Pattern 3: "codex/claude + 动词" — "claude 来" / "codex 帮我"
-    const backendNameFirst = normalized.match(/^(codex|claude)\s*(?:来(?:吧)?|帮我|试试|处理|干活|上)$/i);
+    const backendNameFirst = normalized.match(/^(codex|claude|qwen)\s*(?:来(?:吧)?|帮我|试试|处理|干活|上)$/i);
     if (backendNameFirst) {
         return { kind: 'backend', name: backendNameFirst[1].toLowerCase() };
     }
@@ -520,13 +529,27 @@ function parseNaturalLanguageCommand(input) {
     if (/^(?:现在|当前)?用的(?:什么|哪个)(?:后端|backend)?$/.test(normalized)) {
         return { kind: 'backend' };
     }
+    // Pattern 5b: 列出所有后端 / 有哪些后端 / 后端有哪些 / 支持哪些后端
+    if (/^(?:列出|列|查看|看|看看|显示|给我看|show|list)?\s*(?:所有|全部|已(?:注册|支持))?\s*(?:(?:可用|支持)(?:的)?)?\s*(?:后端|backend)s?$/i.test(normalized)
+        || /^(?:有|支持)哪些(?:后端|backend)s?$/.test(normalized)
+        || /^(?:后端|backend)s?\s*(?:有|列表|清单|列出)$/i.test(normalized)
+        || /^(?:后端|backend)s?\s*有哪些$/i.test(normalized)
+        || /^(?:list|show)\s+(?:all\s+)?backends?$/i.test(normalized)
+        || /^(?:which|what)\s+backends?(?:\s+are\s+(?:available|supported))?\??$/i.test(normalized)) {
+        return { kind: 'backend', action: 'list' };
+    }
+    // Pattern 5c: 查看 fallback 链 / 降级顺序
+    if (/^(?:查看?|看|显示)?\s*(?:fallback|降级|备用|故障转移)\s*(?:链|顺序|列表|配置)?$/i.test(normalized)
+        || /^fallback\s*chain\??$/i.test(normalized)) {
+        return { kind: 'backend', action: 'list' };
+    }
     // Pattern 6: English — "switch to claude" / "use codex" / "change to claude"
-    const backendEnglish = normalized.match(/^(?:switch(?:\s+backend)?(?:\s+to)?|use|change(?:\s+backend)?(?:\s+to)?|backend)\s+(codex|claude)$/i);
+    const backendEnglish = normalized.match(/^(?:switch(?:\s+backend)?(?:\s+to)?|use|change(?:\s+backend)?(?:\s+to)?|backend)\s+(codex|claude|qwen)$/i);
     if (backendEnglish) {
         return { kind: 'backend', name: backendEnglish[1].toLowerCase() };
     }
     // Pattern 7: English name-first — "claude please" / "codex go"
-    const backendEnglishNameFirst = normalized.match(/^(codex|claude)\s+(?:please|go|now|backend)$/i);
+    const backendEnglishNameFirst = normalized.match(/^(codex|claude|qwen)\s+(?:please|go|now|backend)$/i);
     if (backendEnglishNameFirst) {
         return { kind: 'backend', name: backendEnglishNameFirst[1].toLowerCase() };
     }