内容
<div align="center">
<img src="assets/icon.svg" width="88" alt="Iris" />
# Iris
**一款极简主义、优先支持Windows的Chromium浏览器，由您的AI代理驱动，同时您也可以主动操作。**
专为登录态网页设计，这些网页没有公开的API暴露。支持多MCP服务端，本地化运行。
</div>
<p align="center">
<img src="assets/screenshot.png" width="860" alt="Iris: 代理在空间中工作，站点周围有活动光环" />
</p>
## 概述
Iris 是您机器上的真正Chromium浏览器（Electron）。您的编程代理（Claude Code、Cursor、Codex，任何MCP客户端）通过您的真实登录会话操作它，而您可以在任何时候实时查看并接管。这是为人类和代理工作流设计的浏览器：代理在其自己的空间中运行任务，而您在您的空间中继续浏览。
## 亮点
- **空间**：隔离的、持久的会话（拥有自己的cookie和登录信息），人类和代理并行工作。
- **与MCP服务端无关**：一个服务端，可以连接到任何MCP客户端。附带Iris技能。
- **语义快照**：一个紧凑的、可访问性树形结构，带有引用，而不是截图或原始DOM。
- **您始终知道它在做什么**：实时活动轨迹和工作时的星云光环。
- **交接**：检测到验证码、OTP和登录信息；它会暂停并将标签页交给您。
- **审批门控和自主权切换**：在未经您同意的情况下，不会执行不可逆操作，除非您允许。
- **显示**：它会将引用的内容带入您的视野并高亮显示。
- **导出**：保存页面并写入磁盘报告或CSV文件。
- **本地和私有**：您的浏览器，您的机器，无云，无遥测。
## 安装（用户和测试人员）
1. 从 [Releases](https://github.com/marvitphy/iris/releases/latest) 下载安装程序并运行。在第一次启动时，Iris会自动安装MCP服务端和Iris技能。
2. 启动Iris并保持打开状态。登录您希望它使用的网站。
3. 将MCP服务端添加到Claude Code：
```bash
claude mcp add iris -- node %LOCALAPPDATA%\Iris\iris-mcp.mjs
```
4. 重启Claude Code（加载技能和工具）。
5. 告诉您的代理该做什么。
## 开发
```bash
npm install
npm run dev # 运行应用程序（electron-vite）
npm run build:mcp # 构建MCP服务端捆绑包（dist-mcp/iris-mcp.mjs）
npm run build:icons # 从assets/重新生成build/icon.ico和PNG文件
npm run typecheck
```
### 打包Windows安装程序
```bash
npm run dist:win # 生成release/Iris-Setup-<version>.exe
```
或者，推送一个标签（`git tag v0.1.0 && git push --tags`），GitHub Actions会自动构建安装程序并将其附加到发布版本中。
## 架构（简要）
- **Electron外壳**：亚克力UI、空间（持久会话分区）、标签页、活动光环。
- **引擎**：`playwright-core`连接到Iris自己的Chromium浏览器，通过CDP、`ariaSnapshot({mode:'ai'})`引用、点击/输入/滚动/评估/截图/显示。
- **控制服务端**：本地HTTP，MCP服务端通信，在`%LOCALAPPDATA%\Iris`中发布握手信息。
- **MCP服务端**：stdio，约26种工具，与代理无关。源码位于`src/mcp`，打包到`dist-mcp`。
## 许可证
MIT。使用 [ai-motion](https://github.com/gaomeng1900/ai-motion) （MIT）进行活动光环。
