illusion-code 0.1.0__tar.gz → 0.1.1__tar.gz

{illusion_code-0.1.0 → illusion_code-0.1.1}/.github/workflows/publish.yml

@@ -34,15 +34,7 @@ jobs:
         run: ruff check src/
 
       - name: Test
-        run: |
-          pytest tests/ -q \
-            --deselect tests/test_mcp/test_stdio_flow.py::test_stdio_mcp_manager_connects_and_executes_real_server \
-            --deselect tests/test_plugins/test_lifecycle_flow.py::test_plugin_install_load_and_uninstall_flow \
-            --deselect tests/test_skills/test_loader.py::test_load_skill_registry_includes_bundled \
-            --deselect tests/test_tools/test_core_tools.py::test_glob_and_grep \
-            --deselect tests/test_tools/test_integration_flows.py::test_search_edit_flow_across_registry \
-            --deselect tests/test_auth/test_external.py::test_external_binding_for_codex_without_switching \
-            --deselect tests/test_commands/test_registry.py::test_agents_session_files_and_reload_plugins_commands
+        run: pytest tests/ -q
 
       - name: Build
         run: python -m build

{illusion_code-0.1.0 → illusion_code-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: illusion-code
-Version: 0.1.0
+Version: 0.1.1
 Summary: Open-source Python port of Claude Code - an AI-powered CLI coding assistant
 Project-URL: Homepage, https://github.com/YunTaiHua/illusion-code
 Project-URL: Repository, https://github.com/YunTaiHua/illusion-code
@@ -133,17 +133,27 @@ IllusionCode is an open-source AI-powered command-line programming assistant tha
 
 ### Installation
 
-#### Recommended: pip install (one-step setup)
+#### Recommended: pip install from PyPI
 
-`pip install .` triggers the hatch build hook to automatically build both frontends (terminal TUI and Web UI), and registers the `illusion` command globally. This is the simplest way to get started.
+The simplest way to install IllusionCode. Automatically installs both frontends and registers the `illusion` command globally.
 
 ```bash
-git clone https://github.com/your-repo/illusion-code.git
+pip install illusion-code
+```
+
+No git clone or Node.js required — everything is included in the package.
+
+#### Alternative: pip install from source
+
+Clone the repository and install locally. Triggers the hatch build hook to build frontends automatically.
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
 cd illusion-code
 pip install .
 ```
 
-After installation, `illusion` is available globally from any directory. Requires Node.js 18+ (for frontend build).
+Requires Node.js 18+ (for frontend build).
 
 #### Alternative: uv sync (for development)
 
@@ -178,9 +188,11 @@ python scripts/build_frontend.py --web        # Web UI only
 > pip install .
 > ```
 
-#### Manual frontend build (for both methods)
+#### Manual frontend build (for source installs only)
 
-If you need to rebuild frontends manually (e.g., after updating frontend code):
+If you installed from source and need to rebuild frontends (e.g., after updating frontend code). PyPI users do not need this step.
+
+**Build script (recommended)**
 
 **Build script (recommended)**
 
@@ -208,12 +220,14 @@ cd ../..
 
 #### Key differences
 
-| | `pip install .` | `uv sync` |
-|---|---|---|
-| Frontend build | Automatic (hatch hook) | Manual |
-| `illusion` command | Global | Project-only (via `uv run` or venv activation) | 
-| Install type | Standard | Editable |
-| Best for | End users | Developers |
+| | `pip install illusion-code` | `pip install .` | `uv sync` |
+|---|---|---|---|
+| Source | PyPI | Local git clone | Local git clone |
+| Frontend build | Pre-built (included) | Automatic (hatch hook) | Manual |
+| Node.js required | No | Yes (18+) | Yes (18+) |
+| `illusion` command | Global | Global | Project-only (via `uv run` or venv activation) |
+| Install type | Standard | Standard | Editable |
+| Best for | End users | Contributors | Developers |
 
 ### Basic Usage
 

{illusion_code-0.1.0 → illusion_code-0.1.1}/README.md

@@ -85,17 +85,27 @@ IllusionCode is an open-source AI-powered command-line programming assistant tha
 
 ### Installation
 
-#### Recommended: pip install (one-step setup)
+#### Recommended: pip install from PyPI
 
-`pip install .` triggers the hatch build hook to automatically build both frontends (terminal TUI and Web UI), and registers the `illusion` command globally. This is the simplest way to get started.
+The simplest way to install IllusionCode. Automatically installs both frontends and registers the `illusion` command globally.
 
 ```bash
-git clone https://github.com/your-repo/illusion-code.git
+pip install illusion-code
+```
+
+No git clone or Node.js required — everything is included in the package.
+
+#### Alternative: pip install from source
+
+Clone the repository and install locally. Triggers the hatch build hook to build frontends automatically.
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
 cd illusion-code
 pip install .
 ```
 
-After installation, `illusion` is available globally from any directory. Requires Node.js 18+ (for frontend build).
+Requires Node.js 18+ (for frontend build).
 
 #### Alternative: uv sync (for development)
 
@@ -130,9 +140,11 @@ python scripts/build_frontend.py --web        # Web UI only
 > pip install .
 > ```
 
-#### Manual frontend build (for both methods)
+#### Manual frontend build (for source installs only)
 
-If you need to rebuild frontends manually (e.g., after updating frontend code):
+If you installed from source and need to rebuild frontends (e.g., after updating frontend code). PyPI users do not need this step.
+
+**Build script (recommended)**
 
 **Build script (recommended)**
 
@@ -160,12 +172,14 @@ cd ../..
 
 #### Key differences
 
-| | `pip install .` | `uv sync` |
-|---|---|---|
-| Frontend build | Automatic (hatch hook) | Manual |
-| `illusion` command | Global | Project-only (via `uv run` or venv activation) | 
-| Install type | Standard | Editable |
-| Best for | End users | Developers |
+| | `pip install illusion-code` | `pip install .` | `uv sync` |
+|---|---|---|---|
+| Source | PyPI | Local git clone | Local git clone |
+| Frontend build | Pre-built (included) | Automatic (hatch hook) | Manual |
+| Node.js required | No | Yes (18+) | Yes (18+) |
+| `illusion` command | Global | Global | Project-only (via `uv run` or venv activation) |
+| Install type | Standard | Standard | Editable |
+| Best for | End users | Contributors | Developers |
 
 ### Basic Usage
 

{illusion_code-0.1.0 → illusion_code-0.1.1}/README.zh-CN.md

@@ -85,17 +85,27 @@ IllusionCode 是一个开源的 AI 驱动命令行编程助手，集成了众多
 
 ### 安装
 
-#### 推荐方式：pip install（一步到位）
+#### 推荐方式：从 PyPI 安装
 
-`pip install .` 会触发 hatch build hook 自动构建两个前端（终端 TUI 和 Web UI），并将 `illusion` 命令注册到全局 PATH。这是最简单的安装方式。
+最简单的安装方式，自动安装前端并注册 `illusion` 命令到全局 PATH。
 
 ```bash
-git clone https://github.com/your-repo/illusion-code.git
+pip install illusion-code
+```
+
+无需克隆仓库或安装 Node.js，所有内容已包含在包中。
+
+#### 备选方式：从源码安装
+
+克隆仓库后本地安装，hatch build hook 会自动构建前端。
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
 cd illusion-code
 pip install .
 ```
 
-安装完成后，`illusion` 命令在任意目录均可直接使用。需要 Node.js 18+（用于前端构建）。
+需要 Node.js 18+（用于前端构建）。
 
 #### 开发方式：uv sync（适合开发者）
 
@@ -130,9 +140,9 @@ python scripts/build_frontend.py --web        # 只构建 Web UI
 > pip install .
 > ```
 
-#### 手动构建前端
+#### 手动构建前端（仅源码安装需要）
 
-如需手动重新构建前端（例如更新了前端代码）：
+如从源码安装后需要重新构建前端（例如更新了前端代码）。PyPI 用户无需此步骤。
 
 **构建脚本（推荐）**
 
@@ -158,14 +168,16 @@ npm run build
 cd ../..
 ```
 
-#### 两种方式对比
+#### 三种方式对比
 
-| | `pip install .` | `uv sync` |
-|---|---|---|
-| 前端构建 | 自动（hatch hook） | 手动 |
-| `illusion` 命令 | 全局可用 | 仅项目内（需 `uv run` 或激活虚拟环境） |
-| 安装类型 | 标准安装 | Editable 安装 |
-| 适用场景 | 终端用户 | 开发者 |
+| | `pip install illusion-code` | `pip install .` | `uv sync` |
+|---|---|---|---|
+| 来源 | PyPI | 本地 git clone | 本地 git clone |
+| 前端构建 | 预构建（已包含） | 自动（hatch hook） | 手动 |
+| 需要 Node.js | 否 | 是（18+） | 是（18+） |
+| `illusion` 命令 | 全局可用 | 全局可用 | 仅项目内（需 `uv run` 或激活虚拟环境） |
+| 安装类型 | 标准安装 | 标准安装 | Editable 安装 |
+| 适用场景 | 终端用户 | 贡献者 | 开发者 |
 
 ### 基本使用
 

{illusion_code-0.1.0 → illusion_code-0.1.1}/frontend/terminal/src/App.tsx

@@ -47,6 +47,11 @@ const PERMISSION_PROMPT_OPTIONS: SelectOption[] = [
 	{value: 'deny', label: 'Deny', description: 'Reject this tool execution'},
 ];
 
+const PLAN_APPROVAL_OPTIONS: SelectOption[] = [
+	{value: 'approve', label: 'Approve', description: 'Approve plan and start implementation'},
+	{value: 'reject', label: 'Reject', description: 'Reject plan and provide feedback'},
+];
+
 
 export function App({config}: {config: FrontendConfig}): React.JSX.Element {
 	return (
@@ -67,12 +72,24 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 	const [selectIndex, setSelectIndex] = useState(0);
 	const [permissionIndex, setPermissionIndex] = useState(2);
 	const [pendingPermissionAck, setPendingPermissionAck] = useState(false);
+	const [planApprovalIndex, setPlanApprovalIndex] = useState(0);
+	const [planFeedbackMode, setPlanFeedbackMode] = useState(false);
+	const [planFeedback, setPlanFeedback] = useState('');
 	const [cursorReset, setCursorReset] = useState(0);
 	const session = useBackendSession(config, () => exit());
 	const isPermissionModal = session.modal?.kind === 'permission';
+	const isPlanApprovalModal = session.modal?.kind === 'plan_approval';
 	const language = normalizeLanguage(session.status.ui_language);
 	const permissionRequestId =
 		isPermissionModal && typeof session.modal?.request_id === 'string' ? String(session.modal.request_id) : '';
+	const planApprovalRequestId =
+		isPlanApprovalModal && typeof session.modal?.request_id === 'string' ? String(session.modal.request_id) : '';
+	const localizedPlanApprovalOptions = PLAN_APPROVAL_OPTIONS.map((opt) => {
+		if (opt.value === 'approve') {
+			return {...opt, label: t(language, 'approve')};
+		}
+		return {...opt, label: t(language, 'reject')};
+	});
 	const localizedPermissionOptions = PERMISSION_PROMPT_OPTIONS.map((opt) => {
 		if (opt.value === 'allow') {
 			return {...opt, label: t(language, 'allow')};
@@ -159,6 +176,18 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 		setPendingPermissionAck(false);
 	}, [permissionRequestId, isPermissionModal]);
 
+	useEffect(() => {
+		if (!isPlanApprovalModal) {
+			setPlanApprovalIndex(0);
+			setPlanFeedbackMode(false);
+			setPlanFeedback('');
+			return;
+		}
+		setPlanApprovalIndex(0);
+		setPlanFeedbackMode(false);
+		setPlanFeedback('');
+	}, [planApprovalRequestId, isPlanApprovalModal]);
+
 	// Intercept special commands that need interactive UI
 	const handleCommand = (cmd: string): boolean => {
 		const trimmed = cmd.trim();
@@ -262,7 +291,7 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 		// /version → 显示版本信息（前端处理，不发送到后端）
 		if (trimmed === '/version') {
 			session.setCommandResult({
-				text: 'IllusionCode 0.1.0',
+				text: 'IllusionCode 0.1.1',
 				type: 'info',
 			});
 			return true;
@@ -386,6 +415,78 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 			return;
 		}
 
+		// --- Plan approval modal (MUST be before busy check — modal appears while busy) ---
+		if (isPlanApprovalModal) {
+			// Feedback input mode
+			if (planFeedbackMode) {
+				if (key.return) {
+					// Submit rejection with feedback
+					if (planApprovalRequestId) {
+						session.sendRequest({
+							type: 'plan_approval_response',
+							request_id: planApprovalRequestId,
+							allowed: false,
+							feedback: planFeedback,
+						});
+					}
+					setPlanFeedbackMode(false);
+					setPlanFeedback('');
+					return;
+				}
+				if (key.escape) {
+					// Cancel feedback, go back to options
+					setPlanFeedbackMode(false);
+					setPlanFeedback('');
+					return;
+				}
+				if (key.backspace || key.delete) {
+					setPlanFeedback((f) => f.slice(0, -1));
+					return;
+				}
+				// Append printable characters
+				if (chunk && !key.ctrl && !key.meta) {
+					setPlanFeedback((f) => f + chunk);
+				}
+				return;
+			}
+			if (key.upArrow || key.downArrow) {
+				setPlanApprovalIndex((i) => {
+					if (key.upArrow) return i <= 0 ? localizedPlanApprovalOptions.length - 1 : i - 1;
+					return i >= localizedPlanApprovalOptions.length - 1 ? 0 : i + 1;
+				});
+				return;
+			}
+			if (key.return) {
+				if (!planApprovalRequestId) {
+					return;
+				}
+				const selected = localizedPlanApprovalOptions[planApprovalIndex]?.value;
+				if (selected === 'approve') {
+					session.sendRequest({
+						type: 'plan_approval_response',
+						request_id: planApprovalRequestId,
+						allowed: true,
+					});
+				} else {
+					// Enter feedback mode for rejection
+					setPlanFeedbackMode(true);
+				}
+				return;
+			}
+			if (key.escape) {
+				// Escape = reject without feedback
+				if (planApprovalRequestId) {
+					session.sendRequest({
+						type: 'plan_approval_response',
+						request_id: planApprovalRequestId,
+						allowed: false,
+					});
+				}
+				return;
+			}
+			return;
+		}
+
 		// --- Question modal (also appears while busy) ---
 		if (session.modal?.kind === 'question') {
 			return;
@@ -497,7 +598,7 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 					clearCount={session.clearCount}
 					assistantBuffer={session.assistantBuffer}
 					showWelcome={session.ready}
-					showThinking={session.showThinking}
+					showThinking={session.showThinking && !isPlanApprovalModal}
 					language={language}
 					pendingToolCalls={session.pendingToolCalls}
 					commandPickerOpen={showPicker}
@@ -505,6 +606,40 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 			</Box>
 
 			<Box flexDirection="column" paddingX={1}>
+			{/* Plan approval modal — lightweight, plan content rendered in conversation */}
+			{isPlanApprovalModal ? (
+				<Box flexDirection="column" marginTop={1} paddingX={1}>
+					{planFeedbackMode ? (
+						<Box flexDirection="column">
+							<Text color={theme.colors.warning}>{t(language, 'planFeedbackPrompt')}</Text>
+							<Box marginTop={1}>
+								<Text color={theme.colors.muted}>{'>'} </Text>
+								<Text>{planFeedback}</Text>
+								<Text color={theme.colors.muted}>{'_'}</Text>
+							</Box>
+						</Box>
+					) : (
+						<Box flexDirection="column">
+							{localizedPlanApprovalOptions.map((opt, i) => (
+								<Box key={opt.value}>
+									<Text color={i === planApprovalIndex ? theme.colors.info : theme.colors.muted}>
+										{i === planApprovalIndex ? theme.icons.check : ' '} {opt.label}
+									</Text>
+									<Text dimColor> - {opt.description}</Text>
+								</Box>
+							))}
+							<Box marginTop={1}>
+								<Text dimColor>
+									<Text color={theme.colors.muted}>enter</Text> {t(language, 'approve')}
+									<Text> {theme.icons.middleDot} </Text>
+									<Text color={theme.colors.muted}>esc</Text> {t(language, 'reject')}
+								</Text>
+							</Box>
+						</Box>
+					)}
+				</Box>
+			) : null}
+
 			{/* Permission confirm modal */}
 			{isPermissionModal ? (
 				<SelectModal
@@ -515,7 +650,7 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 			) : null}
 
 			{/* Backend modal (question, mcp auth) */}
-			{session.modal && !isPermissionModal ? (
+			{session.modal && !isPermissionModal && !isPlanApprovalModal ? (
 				<ModalHost
 					modal={session.modal}
 					modalInput={modalInput}
@@ -548,18 +683,18 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 				/>
 			) : null}
 
-			{/* Todo panel */}
-			{session.ready && session.todoItems.length > 0 ? (
+			{/* Todo panel — hidden during plan approval */}
+			{!isPlanApprovalModal && session.ready && session.todoItems.length > 0 ? (
 				<TodoPanel items={session.todoItems} />
 			) : null}
 
-			{/* Swarm panel */}
-			{session.ready && (session.swarmTeammates.length > 0 || session.swarmNotifications.length > 0) ? (
+			{/* Swarm panel — hidden during plan approval */}
+			{!isPlanApprovalModal && session.ready && (session.swarmTeammates.length > 0 || session.swarmNotifications.length > 0) ? (
 				<SwarmPanel teammates={session.swarmTeammates} notifications={session.swarmNotifications} />
 			) : null}
 
-			{/* Status bar (only after backend is ready) */}
-			{session.ready ? (
+			{/* Status bar — hidden during plan approval */}
+			{!isPlanApprovalModal && session.ready ? (
 				<StatusBar status={session.status} tasks={session.tasks} />
 			) : null}
 

{illusion_code-0.1.0 → illusion_code-0.1.1}/frontend/terminal/src/components/ConversationView.tsx

@@ -509,6 +509,18 @@ function MessageRow({
 			);
 		}
 
+		case 'plan':
+			return (
+				<Box marginTop={1} flexDirection="column" borderStyle="round" borderColor={theme.colors.info} paddingX={1}>
+					<Box marginBottom={0}>
+						<Text bold color={theme.colors.info}>{t(language, 'planReview')}</Text>
+					</Box>
+					<Box flexDirection="column">
+						<MarkdownContent text={item.text} availableWidth={Math.max(40, terminalWidth - 6)} />
+					</Box>
+				</Box>
+			);
+
 		case 'log':
 			return (
 				<Box>

{illusion_code-0.1.0 → illusion_code-0.1.1}/frontend/terminal/src/i18n.ts

@@ -31,6 +31,12 @@ const ZH: Dict = {
 	assistantReply: '助手回复',
 	bgAgentWaiting: '等待后台代理完成',
 	bgAgentResuming: '后台代理已完成，继续执行',
+	planReview: '计划审批',
+	approve: '批准',
+	reject: '拒绝',
+	planApproved: '计划已批准，开始实施。',
+	planRejected: '计划已拒绝。',
+	planFeedbackPrompt: '请输入修改意见（可选，Enter 提交，Esc 跳过）：',
 };
 
 const EN: Dict = {
@@ -62,6 +68,12 @@ const EN: Dict = {
 	assistantReply: 'Response',
 	bgAgentWaiting: 'Waiting for background agent',
 	bgAgentResuming: 'Background agent completed, resuming',
+	planReview: 'Plan Review',
+	approve: 'Approve',
+	reject: 'Reject',
+	planApproved: 'Plan approved. Starting implementation.',
+	planRejected: 'Plan rejected.',
+	planFeedbackPrompt: 'Enter feedback (optional, Enter to submit, Esc to skip): ',
 };
 
 const ALL: Record<UiLanguage, Dict> = {

{illusion_code-0.1.0 → illusion_code-0.1.1}/frontend/terminal/src/types.ts

@@ -10,7 +10,7 @@ export type FrontendConfig = {
 };
 
 export type TranscriptItem = {
-	role: 'system' | 'user' | 'assistant' | 'assistant_streaming' | 'tool' | 'tool_result' | 'log';
+	role: 'system' | 'user' | 'assistant' | 'assistant_streaming' | 'tool' | 'tool_result' | 'log' | 'plan';
 	text: string;
 	tool_name?: string;
 	tool_input?: Record<string, unknown>;

{illusion_code-0.1.0 → illusion_code-0.1.1}/frontend/web/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@illusion/web",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@illusion/web",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "dependencies": {
         "highlight.js": "^11.11.0",
         "react": "^18.3.1",

{illusion_code-0.1.0 → illusion_code-0.1.1}/frontend/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illusion/web",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": true,
   "type": "module",
   "scripts": {

{illusion_code-0.1.0 → illusion_code-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "illusion-code"
-version = "0.1.0"
+version = "0.1.1"
 description = "Open-source Python port of Claude Code - an AI-powered CLI coding assistant"
 readme = "README.md"
 license = "MIT"

{illusion_code-0.1.0 → illusion_code-0.1.1}/src/illusion/cli.py

@@ -41,7 +41,7 @@ if hasattr(sys.stderr, "reconfigure"):
     sys.stderr.reconfigure(encoding="utf-8", errors="replace")
 
 # 应用程序版本
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 
 def _version_callback(value: bool) -> None:

{illusion_code-0.1.0 → illusion_code-0.1.1}/src/illusion/commands/__init__.py

@@ -15,16 +15,16 @@
     >>> from illusion.commands import CommandRegistry, SlashCommand
 """
 
+from illusion.commands.types import CommandContext, CommandHandler, CommandResult
 from illusion.commands.registry import (
-    CommandContext,
     CommandRegistry,
-    CommandResult,
     SlashCommand,
     create_default_command_registry,
 )
 
 __all__ = [
     "CommandContext",
+    "CommandHandler",
     "CommandRegistry",
     "CommandResult",
     "SlashCommand",

illusion_code-0.1.1/src/illusion/commands/auth.py

@@ -0,0 +1,55 @@
+"""
+认证相关斜杠命令
+================
+
+/login, /logout
+"""
+
+from __future__ import annotations
+
+from illusion.commands.types import CommandContext, CommandResult
+from illusion.api.provider import auth_status, detect_provider
+from illusion.config.settings import load_settings, save_settings
+
+
+async def login_handler(args: str, context: CommandContext) -> CommandResult:
+    """显示认证状态或存储 API Key"""
+    del context
+    settings = load_settings()
+    provider = detect_provider(settings)
+    api_key = args.strip()
+    if not api_key:
+        masked = (
+            f"{settings.api_key[:6]}...{settings.api_key[-4:]}"
+            if settings.api_key
+            else "(not configured)"
+        )
+        return CommandResult(
+            message=(
+                f"Auth status:\n"
+                f"- provider: {provider.name}\n"
+                f"- auth_status: {auth_status(settings)}\n"
+                f"- base_url: {settings.base_url or '(default)'}\n"
+                f"- model: {settings.model}\n"
+                f"- api_key: {masked}\n"
+                "Usage: /login API_KEY"
+            )
+        )
+    env_key = settings._active_env_key
+    env = settings._active_env
+    env.api_key = api_key
+    settings.model_extra[env_key] = env.model_dump()
+    save_settings(settings)
+    return CommandResult(message="Stored API key in ~/.illusion/settings.json")
+
+
+async def logout_handler(_: str, context: CommandContext) -> CommandResult:
+    """清除已存储的 API Key"""
+    del context
+    settings = load_settings()
+    env_key = settings._active_env_key
+    env = settings._active_env
+    env.api_key = ""
+    settings.model_extra[env_key] = env.model_dump()
+    save_settings(settings)
+    return CommandResult(message="Cleared stored API key.")