illusion-agent 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：仓库根目录及浅层子目录均无 dsh 插件清单，无法用 dsh 插件安装命令安装。

illusion-agent 兼容性怎么样？

暂不能直接安装（需源码编译或环境不满足）：仓库根目录及浅层子目录均无 dsh 插件清单，无法用 dsh 插件安装命令安装。

illusion-agent 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

illusion-agent 还在维护吗？

GitHub 80 星。最近一次上游提交在 2026/10/29。

幻境智能体 YunTaiHua/illusion-agent

DeepSeek Harness

YunTaiHua5 天前有提交已提供中文文档扫描：高危

在 GitHub 查看 ↗

幻想与实用，于此交融。融合多个开源项目精华，构建统一智能代理。

56.2/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/30 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过：仓库根目录及浅层子目录均无 dsh 插件清单，无法用 dsh 插件安装命令安装。以下命令仍可尝试，但可能失败。

无法用 dsh 插件命令安装（仓库内无 dsh 插件清单）

git clone https://github.com/YunTaiHua/illusion-agent.git

按该仓库 README 的原生方式安装；若作者另行发布了 DSH 插件包，请以其文档为准

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么

dsh 原生插件 · browser

装得上吗

作者未把包发布到 npm，只能用源码安装

插件本身没问题，是分发方式不同

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 5 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查需源码安装

仓库根目录及浅层子目录均无 dsh 插件清单，无法用 dsh 插件安装命令安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包illusion-agent（未发布到 npm，仅可源码安装）

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/2 04:32:14

🔴 安全扫描发现高危能力自动 · 静态分析源码

v2.7.0

🔴 扫描：高危尚无人工评估

静态扫描发现安装期即执行代码，或命令参数由运行时变量拼接（参数来源无法静态判定，从严处理）。

命令参数由运行时变量拼接读写/删除本地文件发起外部网络请求

查看扫描证据（共 17 处，展示前 17 条）

发起网络请求
desktop/src/backend.ts:64
const req = http.get(`http://${host}:${port}/`, (res) => {
执行外部命令来自配置/变量
desktop/src/backend.ts:125
this.proc = child_process.spawn(this.opts.pythonPath, args, {
执行外部命令运行时拼接
desktop/src/backend.ts:188
child_process.execSync(`taskkill /pid ${this.proc.pid} /T /F`, {
读取本地文件
desktop/src/main.ts:51
return candidates.find((c) => fs.existsSync(c));
执行外部命令固定命令
desktop/src/main.ts:132
spawn('cmd', ['/k', 'title IllusionAgent Terminal'], { detached: true, shell: true });
执行外部命令固定命令
desktop/src/main.ts:134
spawn('open', ['-a', 'Terminal'], { detached: true });
执行外部命令固定命令
desktop/src/main.ts:136
spawn('x-terminal-emulator', [], { detached: true });
读取本地文件
desktop/src/main.ts:245
const b64 = fs.readFileSync(splashIconPath).toString('base64');
读取本地文件
desktop/src/main.ts:294
if (fs.existsSync(scriptsDir)) extraPaths.push(scriptsDir);
读取本地文件
desktop/src/runtime.ts:76
return candidates.find((c) => fs.existsSync(c)) ?? null;
读取本地文件
desktop/src/runtime.ts:87
return candidates.find((c) => fs.existsSync(c)) ?? null;
执行外部命令运行时拼接
desktop/src/runtime.ts:93
const out = child_process.execSync(`"${bin}" --version`, {
执行外部命令来自配置/变量
desktop/src/runtime.ts:120
const out = child_process.execSync(cmd, {
读取本地文件
desktop/src/settings.ts:48
const raw = fs.readFileSync(getSettingsPath(), 'utf8');
读取本地文件
desktop/src/tray.ts:34
return candidates.find((c) => fs.existsSync(c)) ?? candidates[0];
读取本地文件
desktop/src/tray.ts:46
return candidates.find((c) => fs.existsSync(c)) ?? '';
发起网络请求
frontend/web/src/api.ts:448
const res = await fetch(url, {

扫描于 2026/11/2（1 天前） · 范围全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

3 张 · 点击查看大图

功能亮点

终端与浏览器通用
支持任意模型
跨任意系统

Illusion-Agent：幻想照进现实——一个 AI 智能体平台，终端、浏览器通吃，任意模型、任意系统。

README

由 DeepSeek 最新模型翻译生成

IllusionAgent _幻想与实用，于此交融。融合多个开源项目精华，构建统一智能代理。_ 📖 项目简介 IllusionAgent 是一款开源的 AI 智能体平台。它将多模型语言模型网关、中英双语命令行、浏览器端 Web 界面与可扩展的插件生态融为一体，在 Windows、macOS、Linux 之上皆能从容运行。无论你习惯终端的克制，还是偏爱浏览器的舒展，IllusionAgent 都能与你的工作流共振：丰富的内置工具集、专业子代理、2 种压缩方法、MCP 服务器支持、钩子、插件，以及面向无人值守场景的 Cron 调度器，贯通飞书、微信、QQ 三大渠道。站在巨人之肩 —— Claude Code 提示词体系、OpenHarness 架构理念、 OpenClaw 调度设计、kimi-cli 基础设施、hermes-agent 渠道模式、cc-switch 路由方案。

展开完整文档（README 剩余 1 节）

IllusionAgent

_幻想与实用，于此交融。融合多个开源项目精华，构建统一智能代理。_

📖 项目简介

IllusionAgent 是一款开源的 AI 智能体平台。它将多模型语言模型网关、中英双语命令行、浏览器端 Web 界面与可扩展的插件生态融为一体，在 Windows、macOS、Linux 之上皆能从容运行。

无论你习惯终端的克制，还是偏爱浏览器的舒展，IllusionAgent 都能与你的工作流共振：丰富的内置工具集、专业子代理、2 种压缩方法、MCP 服务器支持、钩子、插件，以及面向无人值守场景的 Cron 调度器，贯通飞书、微信、QQ 三大渠道。

站在巨人之肩 —— Claude Code 提示词体系、OpenHarness 架构理念、 OpenClaw 调度设计、kimi-cli 基础设施、hermes-agent 渠道模式、cc-switch 路由方案。

核心特性

- 🤖 多 AI 提供商支持 - Anthropic Claude、OpenAI、GitHub Copilot、OpenAI Codex 及任意 OpenAI 兼容端点
- 🧠 多智能体协作 - 内置通用、探索、验证等专业子代理，支持任务编排
- 🛠️ 丰富的工具集 - 完整的基础 + 渠道工具集 + MCP 动态工具扩展
- 📦 上下文压缩 - 微压缩（清除旧工具结果）+ 全压缩（LLM 摘要），上下文占满时自动触发
- 🌐 Web UI 界面 - 通过 illusion web 启动浏览器聊天界面，与终端界面相互独立、同等可用
- 🌍 中英双语支持 - 所有 CLI 输出根据 ui_language 设置自动切换中英文
- 📝 全面 Markdown 渲染 - 直角边框表格、圆角卡片代码块、多色富文本
- 🔌 灵活扩展系统 - 插件、钩子、技能、MCP 服务器
- 🌐 内置浏览器 - agent 可驱动的浏览器：桌面版实时画面 / Web 版截图流，ARIA 快照、ref 交互、自由尺寸视口、元素拾取
- 🔐 完善权限控制 - 三种模式 + 细粒度规则 + Always Allow 一键放行
- 🎯 推理强度控制 - 支持 low/medium/high/xhigh/max 五种推理强度级别
- 🪟 Windows 系统深度优化 - 自动查找 Git、PowerShell 支持
- 🖥️ 终端渲染零闪烁 - 基于 Ink Static 组件的稳定渲染
- 📦 桌面版 - Electron 壳内置 Python/Node.js 运行时，三端安装包分发，零环境配置，支持应用内自动更新

界面展示

欢迎界面 & 富文本渲染

演示视频

📺 B站观看演示视频

🚀 快速开始

环境要求

- Python >= 3.10
- 支持 Windows、macOS、Linux
- Node.js 18+（仅源码安装需要，pip install illusion-agent 无需 Node.js）

安装

推荐方式：从 PyPI 安装（无需 Node.js）
pip install illusion-agent

备选方式：从源码安装（需要 Node.js 18+）
git clone https://github.com/YunTaiHua/illusion-agent.git
cd illusion-agent
pip install .

桌面版

不想安装 Python 或 Node.js？直接下载对应平台的安装包，内置运行时，零环境配置：

| 平台 | 下载文件 |
| Windows | IllusionAgent-Setup-<版本>.exe（NSIS 安装器） |
| macOS | IllusionAgent-<版本>-arm64.dmg |
| Linux | IllusionAgent-<版本>-amd64.deb 或 IllusionAgent-<版本>-x86_64.AppImage |

👉 从 GitHub Release 下载

桌面版内置 Python 3.12 和 Node.js 24 运行时，详见桌面版文档。

基本使用

首次使用：配置认证（登录后会引导设置工作目录） illusion auth login

启动交互式会话（推荐） illusion

启动 Web UI 浏览器界面 illusion web

非交互式打印模式 illusion -p "帮我分析这个项目的结构"

设置或更新工作目录 illusion set "E:\Projects\my-project"

Print 模式说明

-p / --print 以非交互方式执行单次请求并立即退出：

只读分析（安全，默认权限模式） 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/zh-CN/introduction.md |
| 快速开始 | docs/en/getting-started.md | docs/zh-CN/getting-started.md |
| 命令系统 | docs/en/commands.md | docs/zh-CN/commands.md |
| Goal 自动续跑目标 | docs/en/goal.md | docs/zh-CN/goal.md |
| 设置与凭据 | docs/en/settings.md | docs/zh-CN/settings.md |
| 项目文件与记忆 | docs/en/project-files.md | docs/zh-CN/project-files.md |
| 扩展系统 (MCP, 插件, 技能, 钩子) | docs/en/extensions.md | docs/zh-CN/extensions.md |
| 项目架构 | docs/en/architecture.md | docs/zh-CN/architecture.md |
| Web UI 安全 | docs/en/security.md | docs/zh-CN/security.md |
| Token 计量与压缩 | docs/en/token-metering.md | docs/zh-CN/token-metering.md |
| 消息渠道 | docs/en/channels.md | docs/zh-CN/channels.md |
| @ 提及（技能 / 会话 / 文件） | docs/en/mentions.md | docs/zh-CN/mentions.md |
| 桌面版 | docs/en/desktop.md | docs/zh-CN/desktop.md |
| 内置浏览器（browser-use） | docs/en/browser.md | docs/zh-CN/browser.md |

📄 许可证

本项目采用 MIT 许可证开源。

🤝 贡献

欢迎提交 Issue 和 Pull Request！