illusion-agent 0.3.3__tar.gz

illusion_agent-0.3.3/.github/workflows/publish.yml

@@ -0,0 +1,47 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine pytest pytest-timeout ruff
+          pip install -e ".[dev,all]"
+
+      - name: Lint
+        run: ruff check src/
+
+      - name: Test
+        run: pytest tests/ -q --timeout=300
+
+      - name: Build
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

illusion_agent-0.3.3/.gitignore

@@ -0,0 +1,72 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Type checking
+.mypy_cache/
+
+# Ruff
+.ruff_cache/
+
+# Project specific
+.illusion/
+temp/
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+
+# uv
+uv.lock
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Frontend build artifacts
+frontend/terminal/dist/
+frontend/web/dist/
+
+temp_test_data/
+temp_test_config/

illusion_agent-0.3.3/.python-version

@@ -0,0 +1 @@
+3.12

illusion_agent-0.3.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 YunTai (YunTaiHua)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

illusion_agent-0.3.3/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: illusion-agent
+Version: 0.3.3
+Summary: Open-source Python port of Claude Code - an AI-powered CLI coding assistant
+Project-URL: Homepage, https://github.com/YunTaiHua/illusion-agent
+Project-URL: Repository, https://github.com/YunTaiHua/illusion-agent
+Project-URL: Issues, https://github.com/YunTaiHua/illusion-agent/issues
+Author-email: YunTaiHua <3597489498@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude-code,cli,coding-agent,llm,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: croniter>=2.0.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: uvicorn[standard]>=0.34.0
+Requires-Dist: watchfiles>=0.20.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: all
+Requires-Dist: aiohttp>=3.9.0; extra == 'all'
+Requires-Dist: cryptography>=42.0.0; extra == 'all'
+Requires-Dist: lark-oapi>=1.4.0; extra == 'all'
+Requires-Dist: qrcode>=7.4.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pexpect>=4.9.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Provides-Extra: feishu
+Requires-Dist: lark-oapi>=1.4.0; extra == 'feishu'
+Provides-Extra: weixin
+Requires-Dist: aiohttp>=3.9.0; extra == 'weixin'
+Requires-Dist: cryptography>=42.0.0; extra == 'weixin'
+Requires-Dist: qrcode>=7.4.0; extra == 'weixin'
+Description-Content-Type: text/markdown
+
+# IllusionAgent
+
+<div align="center">
+
+**Where fantasy meets functionality.**
+
+*The best of many worlds, refined into one intelligent agent*
+
+[中文版](README.zh-CN.md) | English
+
+</div>
+
+---
+
+## 📖 Introduction
+
+IllusionAgent is an open-source AI agent platform. It unifies a multi-provider
+LLM gateway, a bilingual (Chinese/English) CLI, a browser-based Web UI, and
+a flexible extension ecosystem into a single intelligent agent — at home
+on Windows, macOS, and Linux.
+
+Whether you prefer the discipline of the terminal or the ease of the browser,
+IllusionAgent resonates with your workflow: 42 built-in tools, 49 slash
+commands, 7 specialized sub-agents, MCP server support, hooks, plugins, and
+a cron scheduler for unattended automation — spanning Feishu, WeChat, and QQ.
+
+> Standing on the shoulders of giants — Claude Code prompts, OpenHarness
+> architecture, OpenClaw scheduling, kimi-cli infrastructure, hermes-agent
+> channels, cc-switch routing.
+
+### Core Features
+
+- 🤖 **Multi AI Provider Support** - Anthropic, OpenAI, Copilot, Codex, and any compatible endpoint
+- 🧠 **Multi-Agent Collaboration** - 7 built-in specialized Agents
+- 🛠️ **Rich Toolset** - 42 built-in tools (29 base + 13 channel) + MCP dynamic tool extension
+- ⌨️ **49 Slash Commands** - Session, config, project, scheduling
+- 🌐 **Web UI Interface** - Browser-based chat interface with `illusion web`, independently usable alongside the terminal
+- 🌍 **Bilingual Interface** - Chinese/English auto-switch via `ui_language` setting
+- 📝 **Comprehensive Markdown Rendering** - Tables, code blocks, rich text
+- 🔌 **Flexible Extension System** - Plugins, hooks, skills, MCP servers
+- 🔐 **Comprehensive Permission Control** - Three modes + fine-grained rules
+- 🎯 **Reasoning Effort Control** - low/medium/high/xhigh/max levels
+- 🪟 **Deep Windows Optimization** - Auto-detect Git, PowerShell support
+- 🖥️ **Zero Terminal Flicker** - Stable rendering based on Ink Static component
+
+### Interface Preview
+
+<div align="center">
+  <p>Welcome screen & rich text rendering</p>
+  <img src="docs/images/image1.png" alt="IllusionAgent welcome screen" width="48%" />
+  <img src="docs/images/image2.png" alt="IllusionAgent rich text rendering" width="48%" />
+</div>
+
+<div align="center">
+  <p>Demo video</p>
+  <a href="https://www.youtube.com/watch?v=ExrzKVjWPls">
+    <img src="docs/images/illusion-agent.png" alt="Click to watch demo video" width="720" />
+  </a>
+  <p><a href="https://www.youtube.com/watch?v=ExrzKVjWPls">📺 Watch demo on YouTube</a></p>
+</div>
+
+---
+
+## 🚀 Quick Start
+
+### Requirements
+
+- Python >= 3.10
+- Supports Windows, macOS, Linux
+- Node.js 18+ (only for source install; `pip install illusion-agent` does not require Node.js)
+
+### Installation
+
+```bash
+# Recommended: pip install from PyPI (no Node.js required)
+pip install illusion-agent
+
+# Alternative: from source (requires Node.js 18+)
+git clone https://github.com/YunTaiHua/illusion-agent.git
+cd illusion-agent
+pip install .
+```
+
+### Basic Usage
+
+```bash
+# First-time: configure authentication
+illusion auth login
+
+# Start interactive session (recommended)
+illusion
+
+# Launch Web UI in browser
+illusion web
+
+# Non-interactive print mode
+illusion -p "Analyze the structure of this project"
+```
+
+### Print Mode Notes
+
+`-p` / `--print` runs a single non-interactive request and exits:
+
+```bash
+# Read-only analysis (safe, default permission mode)
+illusion -p "Analyze the structure of this project"
+
+# Allow file writes / command execution without interactive approval
+illusion --permission-mode full_auto -p "Fix the failing tests"
+
+# Resume after the process exits with code 2 (pending question/permission/plan)
+illusion -c -p "Y"
+
+# Specify model and effort for print mode
+illusion -m env_1.model_2 -e high -p "Refactor this module"
+```
+
+Important details:
+
+- The prompt value must be the **last argument** because typer parses `-p` greedily.
+- In default permission mode, mutating tools exit with code **2** and persist a pending approval; answer it with `illusion -c -p "Y"`, `"F"`, or `"N"`.
+- Exit codes: `0` success, `1` error, `2` waiting for cross-turn input.
+
+### Interface Notes
+
+The terminal (`illusion`) and Web UI (`illusion web`) are two independent, first-class interfaces. They share the same backend runtime, settings, and session storage — use whichever fits your workflow.
+
+---
+
+## 📚 Detailed Documentation
+
+| Topic | English | 中文 |
+|-------|---------|------|
+| Introduction | [docs/en/introduction.md](docs/en/introduction.md) | [docs/zh-CN/introduction.md](docs/zh-CN/introduction.md) |
+| Getting Started | [docs/en/getting-started.md](docs/en/getting-started.md) | [docs/zh-CN/getting-started.md](docs/zh-CN/getting-started.md) |
+| Commands | [docs/en/commands.md](docs/en/commands.md) | [docs/zh-CN/commands.md](docs/zh-CN/commands.md) |
+| Settings & Credentials | [docs/en/settings.md](docs/en/settings.md) | [docs/zh-CN/settings.md](docs/zh-CN/settings.md) |
+| Project Files & Memory | [docs/en/project-files.md](docs/en/project-files.md) | [docs/zh-CN/project-files.md](docs/zh-CN/project-files.md) |
+| Extensions (MCP, Plugins, Skills, Hooks) | [docs/en/extensions.md](docs/en/extensions.md) | [docs/zh-CN/extensions.md](docs/zh-CN/extensions.md) |
+| Architecture | [docs/en/architecture.md](docs/en/architecture.md) | [docs/zh-CN/architecture.md](docs/zh-CN/architecture.md) |
+| Messaging Channels | [docs/en/channels.md](docs/en/channels.md) | [docs/zh-CN/channels.md](docs/zh-CN/channels.md) |
+
+---
+
+## 📄 License
+
+This project is open-sourced under the [MIT](LICENSE) license.
+
+---
+
+## 🤝 Contributing
+
+Welcome to submit Issues and Pull Requests!
+
+---
+
+</div>

illusion_agent-0.3.3/README.md

@@ -0,0 +1,157 @@
+# IllusionAgent
+
+<div align="center">
+
+**Where fantasy meets functionality.**
+
+*The best of many worlds, refined into one intelligent agent*
+
+[中文版](README.zh-CN.md) | English
+
+</div>
+
+---
+
+## 📖 Introduction
+
+IllusionAgent is an open-source AI agent platform. It unifies a multi-provider
+LLM gateway, a bilingual (Chinese/English) CLI, a browser-based Web UI, and
+a flexible extension ecosystem into a single intelligent agent — at home
+on Windows, macOS, and Linux.
+
+Whether you prefer the discipline of the terminal or the ease of the browser,
+IllusionAgent resonates with your workflow: 42 built-in tools, 49 slash
+commands, 7 specialized sub-agents, MCP server support, hooks, plugins, and
+a cron scheduler for unattended automation — spanning Feishu, WeChat, and QQ.
+
+> Standing on the shoulders of giants — Claude Code prompts, OpenHarness
+> architecture, OpenClaw scheduling, kimi-cli infrastructure, hermes-agent
+> channels, cc-switch routing.
+
+### Core Features
+
+- 🤖 **Multi AI Provider Support** - Anthropic, OpenAI, Copilot, Codex, and any compatible endpoint
+- 🧠 **Multi-Agent Collaboration** - 7 built-in specialized Agents
+- 🛠️ **Rich Toolset** - 42 built-in tools (29 base + 13 channel) + MCP dynamic tool extension
+- ⌨️ **49 Slash Commands** - Session, config, project, scheduling
+- 🌐 **Web UI Interface** - Browser-based chat interface with `illusion web`, independently usable alongside the terminal
+- 🌍 **Bilingual Interface** - Chinese/English auto-switch via `ui_language` setting
+- 📝 **Comprehensive Markdown Rendering** - Tables, code blocks, rich text
+- 🔌 **Flexible Extension System** - Plugins, hooks, skills, MCP servers
+- 🔐 **Comprehensive Permission Control** - Three modes + fine-grained rules
+- 🎯 **Reasoning Effort Control** - low/medium/high/xhigh/max levels
+- 🪟 **Deep Windows Optimization** - Auto-detect Git, PowerShell support
+- 🖥️ **Zero Terminal Flicker** - Stable rendering based on Ink Static component
+
+### Interface Preview
+
+<div align="center">
+  <p>Welcome screen & rich text rendering</p>
+  <img src="docs/images/image1.png" alt="IllusionAgent welcome screen" width="48%" />
+  <img src="docs/images/image2.png" alt="IllusionAgent rich text rendering" width="48%" />
+</div>
+
+<div align="center">
+  <p>Demo video</p>
+  <a href="https://www.youtube.com/watch?v=ExrzKVjWPls">
+    <img src="docs/images/illusion-agent.png" alt="Click to watch demo video" width="720" />
+  </a>
+  <p><a href="https://www.youtube.com/watch?v=ExrzKVjWPls">📺 Watch demo on YouTube</a></p>
+</div>
+
+---
+
+## 🚀 Quick Start
+
+### Requirements
+
+- Python >= 3.10
+- Supports Windows, macOS, Linux
+- Node.js 18+ (only for source install; `pip install illusion-agent` does not require Node.js)
+
+### Installation
+
+```bash
+# Recommended: pip install from PyPI (no Node.js required)
+pip install illusion-agent
+
+# Alternative: from source (requires Node.js 18+)
+git clone https://github.com/YunTaiHua/illusion-agent.git
+cd illusion-agent
+pip install .
+```
+
+### Basic Usage
+
+```bash
+# First-time: configure authentication
+illusion auth login
+
+# Start interactive session (recommended)
+illusion
+
+# Launch Web UI in browser
+illusion web
+
+# Non-interactive print mode
+illusion -p "Analyze the structure of this project"
+```
+
+### Print Mode Notes
+
+`-p` / `--print` runs a single non-interactive request and exits:
+
+```bash
+# Read-only analysis (safe, default permission mode)
+illusion -p "Analyze the structure of this project"
+
+# Allow file writes / command execution without interactive approval
+illusion --permission-mode full_auto -p "Fix the failing tests"
+
+# Resume after the process exits with code 2 (pending question/permission/plan)
+illusion -c -p "Y"
+
+# Specify model and effort for print mode
+illusion -m env_1.model_2 -e high -p "Refactor this module"
+```
+
+Important details:
+
+- The prompt value must be the **last argument** because typer parses `-p` greedily.
+- In default permission mode, mutating tools exit with code **2** and persist a pending approval; answer it with `illusion -c -p "Y"`, `"F"`, or `"N"`.
+- Exit codes: `0` success, `1` error, `2` waiting for cross-turn input.
+
+### Interface Notes
+
+The terminal (`illusion`) and Web UI (`illusion web`) are two independent, first-class interfaces. They share the same backend runtime, settings, and session storage — use whichever fits your workflow.
+
+---
+
+## 📚 Detailed Documentation
+
+| Topic | English | 中文 |
+|-------|---------|------|
+| Introduction | [docs/en/introduction.md](docs/en/introduction.md) | [docs/zh-CN/introduction.md](docs/zh-CN/introduction.md) |
+| Getting Started | [docs/en/getting-started.md](docs/en/getting-started.md) | [docs/zh-CN/getting-started.md](docs/zh-CN/getting-started.md) |
+| Commands | [docs/en/commands.md](docs/en/commands.md) | [docs/zh-CN/commands.md](docs/zh-CN/commands.md) |
+| Settings & Credentials | [docs/en/settings.md](docs/en/settings.md) | [docs/zh-CN/settings.md](docs/zh-CN/settings.md) |
+| Project Files & Memory | [docs/en/project-files.md](docs/en/project-files.md) | [docs/zh-CN/project-files.md](docs/zh-CN/project-files.md) |
+| Extensions (MCP, Plugins, Skills, Hooks) | [docs/en/extensions.md](docs/en/extensions.md) | [docs/zh-CN/extensions.md](docs/zh-CN/extensions.md) |
+| Architecture | [docs/en/architecture.md](docs/en/architecture.md) | [docs/zh-CN/architecture.md](docs/zh-CN/architecture.md) |
+| Messaging Channels | [docs/en/channels.md](docs/en/channels.md) | [docs/zh-CN/channels.md](docs/zh-CN/channels.md) |
+
+---
+
+## 📄 License
+
+This project is open-sourced under the [MIT](LICENSE) license.
+
+---
+
+## 🤝 Contributing
+
+Welcome to submit Issues and Pull Requests!
+
+---
+
+</div>

illusion_agent-0.3.3/README.zh-CN.md

@@ -0,0 +1,154 @@
+# IllusionAgent
+
+<div align="center">
+
+**幻想与实用，于此交融**
+
+*融合多个开源项目精华，构建统一智能代理*
+
+中文 | [English](README.md)
+
+</div>
+
+---
+
+## 📖 项目简介
+
+IllusionAgent 是一款开源的 AI 智能体平台。它将多模型语言模型网关、
+中英双语命令行、浏览器端 Web 界面与可扩展的插件生态融为一体，
+在 Windows、macOS、Linux 之上皆能从容运行。
+
+无论你习惯终端的克制，还是偏爱浏览器的舒展，IllusionAgent 都能与你的工作流共振：
+42 项内置工具、49 条斜杠命令、7 类专业子代理、MCP 服务器支持、
+钩子、插件，以及面向无人值守场景的 Cron 调度器，贯通飞书、微信、QQ 三大渠道。
+
+> 站在巨人之肩 —— Claude Code 提示词体系、OpenHarness 架构理念、
+> OpenClaw 调度设计、kimi-cli 基础设施、hermes-agent 渠道模式、cc-switch 路由方案。
+
+### 核心特性
+
+- 🤖 **多 AI 提供商支持** - Anthropic Claude、OpenAI、GitHub Copilot、OpenAI Codex 及任意 OpenAI 兼容端点
+- 🧠 **多智能体协作** - 7 种内置专业 Agent，支持任务编排
+- 🛠️ **丰富的工具集** - 42 内置工具（29 基础 + 13 渠道）+ MCP 动态工具扩展
+- ⌨️ **49 个斜杠命令** - 覆盖会话管理、配置、项目操作、任务调度等
+- 🌐 **Web UI 界面** - 通过 `illusion web` 启动浏览器聊天界面，与终端界面相互独立、同等可用
+- 🌍 **中英双语支持** - 所有 CLI 输出根据 `ui_language` 设置自动切换中英文
+- 📝 **全面 Markdown 渲染** - 直角边框表格、圆角卡片代码块、多色富文本
+- 🔌 **灵活扩展系统** - 插件、钩子、技能、MCP 服务器
+- 🔐 **完善权限控制** - 三种模式 + 细粒度规则 + Always Allow 一键放行
+- 🎯 **推理强度控制** - 支持 low/medium/high/xhigh/max 五种推理强度级别
+- 🪟 **Windows 系统深度优化** - 自动查找 Git、PowerShell 支持
+- 🖥️ **终端渲染零闪烁** - 基于 Ink Static 组件的稳定渲染
+
+### 界面展示
+
+<div align="center">
+  <p>欢迎界面 & 富文本渲染</p>
+  <img src="docs/images/image1.png" alt="IllusionAgent 欢迎界面" width="48%" />
+  <img src="docs/images/image2.png" alt="IllusionAgent 富文本渲染" width="48%" />
+</div>
+
+<div align="center">
+  <p>演示视频</p>
+  <a href="https://b23.tv/3mWe9It">
+    <img src="docs/images/illusion-agent.png" alt="点击观看演示视频" width="720" />
+  </a>
+  <p><a href="https://b23.tv/3mWe9It">📺 B站观看演示视频</a></p>
+</div>
+
+---
+
+## 🚀 快速开始
+
+### 环境要求
+
+- Python >= 3.10
+- 支持 Windows、macOS、Linux
+- Node.js 18+（仅源码安装需要，`pip install illusion-agent` 无需 Node.js）
+
+### 安装
+
+```bash
+# 推荐方式：从 PyPI 安装（无需 Node.js）
+pip install illusion-agent
+
+# 备选方式：从源码安装（需要 Node.js 18+）
+git clone https://github.com/YunTaiHua/illusion-agent.git
+cd illusion-agent
+pip install .
+```
+
+### 基本使用
+
+```bash
+# 首次使用：配置认证
+illusion auth login
+
+# 启动交互式会话（推荐）
+illusion
+
+# 启动 Web UI 浏览器界面
+illusion web
+
+# 非交互式打印模式
+illusion -p "帮我分析这个项目的结构"
+```
+
+### Print 模式说明
+
+`-p` / `--print` 以非交互方式执行单次请求并立即退出：
+
+```bash
+# 只读分析（安全，默认权限模式）
+illusion -p "帮我分析这个项目的结构"
+
+# 允许写入文件 / 执行命令，无需交互式审批
+illusion --permission-mode full_auto -p "修复失败的测试"
+
+# 进程以退出码 2 结束后，继续回答待处理的问题 / 权限 / 计划
+illusion -c -p "Y"
+
+# 指定模型和 effort 等级用于 print 模式
+illusion -m env_1.model_2 -e high -p "重构此模块"
+```
+
+重要细节：
+
+- 提示词值必须放在 **最后一个参数**，因为 typer 会贪婪解析 `-p`。
+- 默认权限模式下，变更类工具会以退出码 **2** 退出并保留待审批项；使用 `illusion -c -p "Y"`、`"F"` 或 `"N"` 继续回答。
+- 退出码：`0` 成功，`1` 错误，`2` 等待跨轮次输入。
+
+### 界面说明
+
+终端（`illusion`）与 Web UI（`illusion web`）是两个相互独立、同等重要的界面。它们共享同一个后端运行时、设置和会话存储，按你的工作流选择即可。
+
+---
+
+## 📚 详细文档
+
+| 主题 | English | 中文 |
+|------|---------|------|
+| 项目简介 | [docs/en/introduction.md](docs/en/introduction.md) | [docs/zh-CN/introduction.md](docs/zh-CN/introduction.md) |
+| 快速开始 | [docs/en/getting-started.md](docs/en/getting-started.md) | [docs/zh-CN/getting-started.md](docs/zh-CN/getting-started.md) |
+| 命令系统 | [docs/en/commands.md](docs/en/commands.md) | [docs/zh-CN/commands.md](docs/zh-CN/commands.md) |
+| 设置与凭据 | [docs/en/settings.md](docs/en/settings.md) | [docs/zh-CN/settings.md](docs/zh-CN/settings.md) |
+| 项目文件与记忆 | [docs/en/project-files.md](docs/en/project-files.md) | [docs/zh-CN/project-files.md](docs/zh-CN/project-files.md) |
+| 扩展系统 (MCP, 插件, 技能, 钩子) | [docs/en/extensions.md](docs/en/extensions.md) | [docs/zh-CN/extensions.md](docs/zh-CN/extensions.md) |
+| 项目架构 | [docs/en/architecture.md](docs/en/architecture.md) | [docs/zh-CN/architecture.md](docs/zh-CN/architecture.md) |
+| 消息渠道 | [docs/en/channels.md](docs/en/channels.md) | [docs/zh-CN/channels.md](docs/zh-CN/channels.md) |
+
+---
+
+## 📄 许可证
+
+本项目采用 [MIT](LICENSE) 许可证开源。
+
+---
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+---
+
+</div>