HEYD66 / facet

# 千面 Facet
**以用户隐私保护为核心、内置 AI 助手的 Windows 开源多实例浏览器。** 用独立会话隔离不同用途的登录与网站存储，自主配置浏览环境和代理网络；在同一个工作台中管理实例、扩展与实时宫格，并让 AI 按授权协助操作实例和网页。
下载最新版 · 版本记录 · 反馈问题
完整项目文档 · 项目总览与维护手册 · 当前待做
> AI 或自动化工具接手本项目时，请先阅读根目录 `AGENTS.md`，再阅读 `docs/AI-CONTROL-HANDOFF.md`。
本版变更见 v0.2.17 更新说明。扩展支持范围与兼容边界见 扩展兼容层，不代表所有 Chrome 插件完整兼容。环境随机方案与组合规则见 指纹候选库。
如果千面对你有帮助，欢迎点一下 **Star**，帮助更多人发现这个项目。
## 隐私与 AI
- **分开使用，减少混用**：各实例独立保存 Cookie 和网站存储，可分别配置代理与浏览环境，帮助区分不同用途的浏览活动；代理失败不自动切回网页直连。
- **数据由你管理**：实例资料和配置保存在本机；AI 密钥、会话和图片使用系统加密保存，不配置模型服务就不会发送 AI 请求。
- **AI 按授权协助操作**：内置助手支持模型选择、图片输入、流式回复、会话管理与上下文压缩，可根据权限管理实例和操作网页。使用前请阅读 AI 助手说明。
- **清楚了解数据去向**：使用 AI 时，任务涉及的网页内容、图片、上下文和工具结果会发送给你配置的模型服务。代理、扩展和模型服务均由你选择，使用时也受这些服务的隐私政策约束。
会话隔离和环境配置不等于物理设备隔离，不保证完全匿名、不可追踪或无 DNS 泄露；请结合实际网络与扩展配置评估隐私风险。
## 功能
| 功能 | 说明 |
| --- | --- |
| 内置 AI 助手 | 自选模型服务，支持图片、流式回复、多会话和持久上下文；按权限管理实例并操作网页 |
| 独立浏览会话 | 各实例拥有独立的 Cookie、网站存储和登录状态，关闭后保留，重新启动可继续使用 |
| 实例管理 | 创建、重命名、启停、备注、随应用启动及批量操作；顶部标签支持滚动查看 |
| 批量创建 | 自定义数量和名称前缀，批量选择可用代理节点 / 出口 IP，为每个实例一键生成独立随机环境；支持进度、取消和逐项结果 |
| 实时宫格 | 多个网页同时实时加载，支持放大查看；另提供省资源模式，由用户选择 |
| 环境配置 | 配置语言、区域、时区和浏览环境参数，支持一键随机生成配置草稿，再确认保存 |
| 环境重置 | 以新 ID 和新存储分区重建随机环境，按实测出口匹配语言和时区；保留名称、代理和扩展启用列表，清除旧登录与扩展数据 |
| 代理管理 | 导入订阅、Clash/Mihomo 配置及常见单节点格式，支持测速、查询出口 IP 和切换节点 |
| 浏览器扩展 | 导入解压目录或 ZIP，确认权限后按实例启用；提供更新检查与更新并重启 |
| 收藏与音量 | 网页书签、快捷入口、节点与 IP 收藏，以及实例音量和静音控制 |
| 开发者工具与本机控制 | 实例右侧 F12 面板可拖动调宽；本机 API 与统一 CDP 开关支持外部自动化 |
| 实例备份与迁移 | 单独或合并导出 `.facetbackup`，校验后可选删除原实例，多文件导入并重新选择网络 |
| 外观主题 | 多套日间与夜间配色，默认「日光 / 黑金」，主题选择跨重启保存 |
| 软件更新 | 启动及运行期间约每 30 分钟检查 GitHub 新版本，同一版本只主动提醒一次；下载及安装由用户确认 |
| 日志与诊断 | 系统日志、实例运行日志、运行输出和网络诊断，便于定位问题 |
当前支持 Windows x64，不设固定的实例数量上限。实际可同时运行的数量取决于硬件和网页负载；实时模式的资源需求随运行实例数量和网页内容增加。
## 下载安装
1. 打开 最新版发布页。
2. 下载 `Facet-Setup- -x64.exe`，运行安装向导。
3. 安装后启动「千面 Facet」，点击「启动当前实例」开始使用。
安装包自带 Electron、Mihomo 和进程保护组件，**无需安装 Node.js**。新安装默认使用 `D:\Facet`，无可访问 D 盘时使用 `C:\Facet`。选择盘符或父文件夹后会自动补上 `Facet` 子目录，安装时创建文件夹；升级保留原安装路径。支持创建桌面与开始菜单快捷方式。
安装包目前**未签名**，Windows 可能显示发布者或安全提示。请从本仓库 Releases 下载；每个版本附带 `.sha256` 校验文件。
 [code] 
## 快速使用
- **新建实例**：点击顶部 `+`，填写名称，选择本机直连或代理节点，按需设置环境。
- **批量创建**：进入「实例管理 → 批量创建」，调整数量、名称前缀和网络方式。代理模式可批量选择节点，按顺序循环分配或每个节点只用一次；点击「一键随机环境」预览各实例的独立草稿，再确认创建。可用状态来自最近检测记录，不保证不同节点具有不同出口 IP；中途停止保留已创建实例。
- **配置环境**：进入「环境配置」，编辑或一键随机后确认保存。保存会停止目标实例，随后手动启动。
- **重置环境**：在环境方案行点击「重置环境」，或在实例管理中执行单项/批量重置。先通过当前网络查询出口，失败保留旧实例；成功后以新 ID、新存储分区和新随机环境重建，匹配语言与时区。保留名称、代理和扩展启用列表，清除旧登录与扩展数据，备注、自启动等恢复默认。数据清除无法普通撤销，重置不代表每个字段都会改变。
- **开发者工具**：运行实例的浏览页面按 F12 或点工具栏按钮，右侧打开开发者工具，拖动中间分隔条调整宽度；停止实例自动关闭。
- **添加代理**：进入「代理管理」导入订阅或节点，测速并查询出口 IP，再分配给实例。
- **查看宫格**：进入「宫格总览」，选择实时模式或省资源模式；放大后可返回宫格。
- **导入扩展**：进入「扩展中心」，选择包含 `manifest.json` 的解压目录或 ZIP，确认权限后导入，再按实例启用。ZIP 可包含唯一嵌套扩展目录，不支持 CRX 或商店直装。
- **内置 AI**：点击顶部「AI」，在设置中填写自己的模型服务、密钥和模型，选择权限后发送任务。支持图片与多会话，重启保留聊天上下文；模型服务的数据处理和费用由该服务决定。
- **应用设置**：分别选择日间和夜间配色，通过顶部按钮切换；同页可开启本机外部控制、设置节点 DNS 与出站网络。
- **隐私检测入口**：浏览页面的快捷网站栏右侧点击「检测」，展开 ipip.la、IPLeak、BrowserLeaks DNS、DNSLeakTest 和 IPPure；点击在当前实例内打开，使用该实例的网络与会话。菜单叠在实时网页上，不增加工具栏高度；停止或代理故障的实例需先启动才能跳转。
- **自动化与 AI 接手**：需要让 Playwright、外部脚本或其他 AI 控制千面时，