精巧全面的智能体 IllusionAgentWhere fantasy meets functionality. The best of many worlds, refined into one intelligent agent.幻想与实用于此交融。融合多个开源项目精华构建统一智能代理。项目简介IllusionAgent 是一款开源的 AI 智能体平台GitHub它将多模型 LLM 网关、中英双语命令行CLI、浏览器端 Web 界面与可扩展的插件生态融为一体在 Windows、macOS、Linux 三大操作系统上皆能从容运行。核心架构IllusionAgent 站在巨人之肩融合了多个开源项目的精华Claude Code的提示词体系OpenHarness的架构理念OpenClaw的调度设计kimi-cli的基础设施hermes-agent的渠道模式cc-switch的路由方案核心特性多 AI 提供商支持— 原生支持 Anthropic Claude、OpenAI、GitHub Copilot、OpenAI Codex以及任意 OpenAI 兼容端点。通过env_N分组格式可轻松接入数十个第三方模型提供商多智能体协作— 7 种内置专业子代理general-purpose、explore、plan、worker、verification 等支持复杂任务的分解与编排丰富的工具集— 35 项内置工具文件读写、代码搜索、LSP 智能跳转、后台任务、定时任务等通过 MCP 协议可动态扩展更多工具上下文压缩— 微压缩清除旧工具结果 全压缩LLM 摘要上下文窗口占满时自动触发支持超长对话中英双语支持— 所有 CLI 输出根据ui_language设置自动切换中英文Web UI 界面— 通过illusion web启动浏览器聊天界面与终端界面相互独立、共享同一后端和会话全面 Markdown 渲染— 直角边框表格、圆角卡片代码块、多色富文本输出灵活扩展系统— 插件Plugins、钩子Hooks、技能Skills、MCP 服务器四大扩展机制完善权限控制— 三种模式default/plan/full_auto 细粒度路径规则 Always Allow 一键放行推理强度控制— 支持 low/medium/high/xhigh/max 五种推理强度级别平衡速度与深度消息渠道集成— 贯通飞书、微信、QQ 三大渠道支持跨渠道消息投递Cron 调度器— 内置定时任务系统支持无人值守的自动化场景记忆系统— 持久化记忆目录跨会话保持上下文和偏好快速安装# 安装 IllusionAgentpipinstallillusion-agent# 验证安装成功应输出版本号如 illusion-agent x.y.zillusion--version3. 首次运行与交互式配置引导# 首次运行进入交互式配置引导illusion推荐使用方式以下按推荐程度排序介绍几种免费或极其便宜的使用方式。每种方式均附有实际可用的模型名称和端点配置。方式一商汤 SenseNova配置方法OpenAI 格式{env_1:{api_format:openai,base_url:https://token.sensenova.cn/v1,api_key:your_sensenova_api_key,model_1:deepseek-v4-flash,model_2:sensenova-6.7-flash-lite},model:env_1.model_1}实际可用模型deepseek-v4-flash、sensenova-6.7-flash-lite等方式二OpenCode Zen 订阅配置方法OpenAI 格式{env_1:{api_format:openai,base_url:https://opencode.ai/zen/v1,api_key:your_opencode_api_key,model_1:deepseek-v4-flash-free,model_2:north-mini-code-free,model_3:ling-3.0-flash-free,model_4:laguna-s-2.1-free,model_5:mimo-v2.5-free,model_6:big-pickle},model:env_1.model_1}实际可用模型deepseek-v4-flash-free、north-mini-code-free、ling-3.0-flash-free、laguna-s-2.1-free、mimo-v2.5-free、big-pickle等方式三美团 LongCat配置方法Anthropic 格式 auth_token{env_1:{api_format:anthropic,base_url:https://api.longcat.chat/anthropic,auth_token:ak_your_longcat_api_key,model_1:LongCat-2.0},model:env_1.model_1}注意LongCat 使用Authorization: Bearer认证必须使用auth_token字段而非api_key。方式四DeepSeek 官方配置方法Anthropic 格式{env_1:{api_format:anthropic,base_url:https://api.deepseek.com/anthropic,api_key:your_deepseek_api_key,model_1:deepseek-v4-pro,model_2:deepseek-v4-flash},model:env_1.model_1}实际可用模型deepseek-v4-pro、deepseek-v4-flash方式五英伟达 NVIDIA配置方法OpenAI 格式{env_1:{api_format:openai,base_url:https://integrate.api.nvidia.com/v1,api_key:your_nvidia_api_key,model_1:z-ai/glm-5.2,model_2:deepseek-ai/deepseek-v4-pro,model_3:minimaxai/minimax-m2.7},model:env_1.model_1}实际可用模型z-ai/glm-5.2、deepseek-ai/deepseek-v4-pro、minimaxai/minimax-m2.7方式七谷歌 Gemini配置方法OpenAI 格式{env_1:{api_format:openai,base_url:https://generativelanguage.googleapis.com/v1beta/openai/,api_key:your_gemini_api_key,model_1:gemini-3.5-flash},model:env_1.model_1}附加方式 1GitHub Copilot特点如果你已有 GitHub Copilot 订阅可直接接入 IllusionAgent使用 Claude Haiku 等模型。配置方法illusion auth login# 选择 GitHub Copilot在浏览器完成授权{env_1:{api_format:copilot,base_url:https://api.githubcopilot.com,model_1:claude-haiku-4.5,model_2:auto},model:env_1.model_1}附加方式 2智谱 GLM配置方法Anthropic 格式{env_1:{api_format:anthropic,base_url:https://open.bigmodel.cn/api/anthropic,api_key:your_zhipu_api_key,model_1:glm-5.2},model:env_1.model_1}配置通用说明配置文件位置全局配置位于~/.illusion/settings.json。切换模型# 交互式切换/model# CLI 参数指定illusion-menv_1.model_2多环境混合配置示例{env_1:{api_format:openai,base_url:https://token.sensenova.cn/v1,api_key:sk-xxx,model_1:deepseek-v4-flash,model_2:sensenova-6.7-flash-lite},env_2:{api_format:anthropic,base_url:https://api.longcat.chat/anthropic,auth_token:ak-xxx,model_1:LongCat-2.0},env_3:{api_format:anthropic,base_url:https://api.deepseek.com/anthropic,api_key:sk-xxx,model_1:deepseek-v4-pro,model_2:deepseek-v4-flash},env_4:{api_format:openai,base_url:https://opencode.ai/zen/v1,api_key:sk-xxx,model_1:deepseek-v4-flash-free,model_2:north-mini-code-free},model:env_1.model_1}认证方式对比字段认证方式适用提供商api_keyx-api-key请求头OpenAI、商汤、NVIDIA、DeepSeek、Gemini 等auth_tokenAuthorization: Bearer请求头LongCat 等上下文窗口与推理强度调节上下文窗口context_window上下文窗口决定单次对话能容纳的 token 数量。当上下文占满时IllusionAgent 会自动触发压缩微压缩清除旧工具结果全压缩由 LLM 摘要因此设置较大值可支持更长的对话。配置方法settings.json{context_window:1000000}推荐值适用场景200000默认值适合大多数场景500000长对话、大型项目分析1000000超长对话、全项目代码审查注意context_window 不应超过模型本身支持的最大上下文长度。例如 DeepSeek-V4 支持 128KGLM-5.2 支持 1M。超出模型限制会导致请求失败。推理强度efforteffort 控制模型的推理深度影响输出质量和响应速度。配置方法settings.json{effort:max}运行时切换# 通过 CLI 参数指定illusion-ehigh-p分析这段代码# 通过 /effort 命令切换交互式会话中/effort max级别说明适用场景low最快速度浅层推理简单查询、快速补全medium平衡模式默认日常编码、一般任务high深度推理复杂逻辑、架构设计xhigh深度思考算法难题、调试疑难max最强推理速度最慢关键任务、复杂重构常用命令速查# 安装pipinstallillusion-agent# 首次配置认证illusion auth login# 启动交互式会话illusion# 启动 Web UIillusion web# 非交互式打印模式illusion-p帮我分析这个项目的结构# 设置工作目录illusionsetE:\Projects\my-project# 切换模型/model项目地址https://github.com/YunTaiHua/illusion-agent