v0.3.1:macOS 电脑控制反馈升级。 新增平滑陶土红边缘氛围灯、飞镖光标和动作状态提示,延长操作后的可见驻留,简化控制页与 MCP 参数;Windows 保留 v0.3.0 的原生电脑操纵和约 5 MiB 离线安装包。完整更新记录。
Windows 与 macOS 均支持应用内更新。在“设置 → YTray 更新”点击“更新”,完成下载、校验和安装后自动重新打开,保留浏览器配置、实例和已安装运行时。更新与发布说明。
![]()
多身份浏览器实例工作台
把独立用户目录、HTTP 代理、调试端口、本地插件和历史恢复,放进一个原生桌面应用。
YTray 面向安全测试、开发联调和多账号运营:管理员、普通用户、访客或不同租户可以同时保持登录,不需要反复退出,也不会把 Cookie、缓存和插件状态混在一起。
macOS 版本使用 Swift、AppKit 与 SwiftUI;Windows 版本使用 C# 与 WPF。两端都直接使用平台原生窗口、托盘和开机启动机制。
- 每个实例使用独立用户目录,隔离 Cookie、Local Storage、缓存、插件数据与登录态。
- 显式区分“无代理启动”和“使用 HTTP 代理启动”,避免网络路径含糊。
- 调试服务只绑定
127.0.0.1,端口占用时自动向后选择。 - 运行实例提供页面缩略图、PID、浏览器版本、调试端口、停止和截图入口。
- 内置 MCP 服务允许本机 agent 列出运行时与实例,并打开、聚焦或停止浏览器实例。
- 历史记录可以恢复同一个身份环境、用户目录、插件、角标与最近页面。
- 支持本机 Chrome、Chrome Beta、Chrome Canary、Chrome for Testing、Chromium 与 Edge。
- 安装包使用当前提交的 Yakit Browser Agent 源码构建默认内置插件,打包时校验版本、大小和 SHA-256。
- YTray 会在后台检查正式版本;发现更新后可在应用内查看进度、校验并安装,不需要重新打开网站手动下载。
YTray 不修改系统浏览器的名称、Bundle ID、签名或默认浏览器设置。它只用隔离参数启动用户明确选择的浏览器。
安装版第一次启动时,YTray 会尝试默认开启开机启动,并把结果明确告诉用户:
- macOS 使用系统 Login Items;
- Windows 使用当前用户的启动项注册表;
- 登录系统时只启动 YTray 并进入菜单栏或系统托盘,不会自动打开浏览器;
- 自动开启失败不会阻断其他功能,侧栏页面和小组件都可以重试;
- 关闭前必须二次确认,避免误触。
从源码直接运行属于开发构建,不会修改 macOS Login Items。这个边界可以避免本地调试意外污染系统启动项。
小组件把高频动作放在一起:
- 编辑、保存和检测 HTTP/HTTPS 代理;
- 无代理或使用预设代理启动实例;
- 查看运行状态和最近页面缩略图;
- 聚焦、截图或停止浏览器;
- 恢复、重命名或删除历史;
- 直接查看与控制开机启动状态。
桌面贴边入口提供同一个面板,也可以只展开直连与代理两个启动按钮。面板默认失焦隐藏,PIN 后保持显示。
macOS 小组件提供“电脑控制”开关和“MCP 复制”入口。AI 可以通过浏览器 CDP 读取页面或执行 JavaScript,也可以在用户开启会话并授予系统权限后,通过 Swift 原生后端读取 AX 树、截图、点击、输入、按键、滚动、启动应用和切换窗口。电脑控制默认关闭,支持权限引导、重开应用和临时会话;陶土红边缘氛围灯、飞镖光标、动作提示与最近操作让执行过程清晰可见。
完整功能、三组 MCP 地址与函数、配置示例、AX 文本与坐标解释、权限排查和开发验证见 macOS 使用说明。已有的浏览器实例管理 MCP 继续使用下文的 19222/mcp;新增页面与电脑控制网关默认使用 51373。
最新版本由 GitHub Releases 和 Yaklang OSS 同步提供。
| 平台 | 架构 | 安装包 |
|---|---|---|
| macOS 14+ | Apple Silicon / arm64 | YTray-<version>-darwin-arm64.dmg |
| macOS 14+ | Intel / amd64 | YTray-<version>-darwin-amd64.dmg |
| Windows 10/11 | x64 / amd64 | YTray-<version>-windows-amd64-setup.exe |
| Windows 10/11 | x86 / 386 | YTray-<version>-windows-386-setup.exe |
Windows on ARM 当前可以通过系统兼容层运行 x64 版;项目暂未发布原生 Windows ARM64 安装包。
安装版会通过 OSS latest.json 自动检查 YTray 自身更新。Windows 下载对应架构的官方 Setup,校验大小和 SHA-256 后静默安装并重新启动;macOS 下载对应架构的官方 DMG,校验大小、SHA-256、Bundle ID、版本与开发者签名后替换当前 .app,失败时恢复旧版本。写入 /Applications 时仍会显示 macOS 的系统管理员授权窗口。
Release CI 支持 Developer ID hardened runtime 签名,并在 Apple 账号凭据齐全时分别公证、装订 .app 与 DMG;Windows 也支持与 CapTray 相同的 Azure 代码签名凭据。若仓库没有配置相应 secrets,流程会明确降级为临时签名或未签名安装包。此时若 Gatekeeper 阻止首次打开,请在 Finder 中右键 YTray,选择“打开”,并确认只从本仓库 Release 或上述 OSS 路径下载。
- 打开“浏览器运行时”,选择系统浏览器、其他本地浏览器,或安装 Chrome for Testing。
- 在“快速配置”中选择直连、预设 HTTP 代理,或进入自定义启动向导。
- YTray 为新实例分配独立用户目录和本地调试端口,并加载选择的插件。
- 在小组件或“运行与历史”中管理实例;停止后可从历史恢复同一个身份。
YTray 默认随应用启动 Streamable HTTP MCP 服务,也可以在侧栏的 MCP 页面随时启动、停止或关闭自动启动。端点为:
http://127.0.0.1:19222/mcp
把该 URL 添加到支持远程 MCP URL 的 agent 客户端即可。服务提供以下工具:
list_browser_runtimes:列出可用浏览器及默认运行时;list_browser_instances:列出运行中实例,可选包含历史实例;open_browser_instance:用默认或指定运行时打开新实例,或按实例 ID 恢复历史实例;focus_browser_instance:把指定运行中实例切到前台;stop_browser_instance:停止实例并保留历史记录。
MCP 只监听 127.0.0.1,并校验 HTTP Host 与 Origin。启动 URL 仅接受 http、https、chrome 和 about 协议;代理密码不会出现在工具返回值中。端口被其他程序占用时,YTray 继续正常运行,并在 MCP 页面和诊断日志中显示启动失败原因。
macOS:
~/Library/Application Support/YTray/
├── Profiles/ # 独立浏览器用户目录
├── Plugins/ # 本地与内置插件
├── Runtimes/ # 可选 Chrome for Testing
├── Screenshots/ # 用户导出的页面截图
├── Logs/ # YTray 运行日志、错误日志与浏览器实例日志
├── MCP/token # 仅当前用户可读的浏览器 MCP 令牌(系统会话令牌仅在内存中)
└── state.json # 配置和历史
Windows 使用当前用户的 Local Application Data 下的 YTray 目录,保持相同的数据分区语义。
本地插件需要已解压目录。macOS 会先检查实际加载状态,并尝试通过 Chrome 的 CDP 扩展接口补载,确认后再打开目标页面。普通 Chrome、Beta 和 Canary 也可以选择本地或内置插件;只有实际加载失败时才询问是否“不加载插件并启动”。这个选择只修改本次启动配置,不会关闭全局插件默认设置。带账号或密码的代理依赖认证插件,不能跳过插件继续启动。
旧版浏览器缺少新扩展接口时,会保留其支持的命令行加载方式。带插件的历史恢复会在验证后打开保存的最近页面,并保留原 Profile、身份和主题。测试步骤与兼容边界见 macOS Chrome 插件验证。
Windows 主线目前仍受官方 Chrome 命令行插件限制;对应的 CDP 加载改动见 PR #14。
Yakit Browser Agent 源码位于 browser-extension。使用 Node.js 22 和 browser-extension/package.json 指定的 pnpm 版本。
pnpm --dir browser-extension install --frozen-lockfile
pnpm --dir browser-extension devWindows 和 macOS 打包时也使用这套工具链构建内置插件。已打包的桌面应用可直接使用内置插件。
要求 macOS 14+ 和 Xcode Command Line Tools:
./script/startup.sh该脚本以前台 Debug 模式运行,按 Ctrl-C 结束。完整测试:
swift test --package-path darwin构建本机架构的 DMG 时会内置当前源码的插件。
./script/package-macos.sh --dmg也可以显式指定 --arch arm64、--arch amd64 或 --arch universal。
本机桌面控制开发请构建 .app:
./script/package-macos.sh --dev --arch arm64
open dist/darwin-arm64-dev/YTrayDev.app开发包固定使用已有代码签名身份,避免重建后系统权限归属变化。证书选择、旧授权迁移和一键重开应用见 macOS 稳定开发签名说明。
构建要求 Windows、.NET 10 SDK(版本由 windows/global.json 选择)和 PowerShell 7;生成安装包还需要 Inno Setup 6。发布包使用 Windows 10 1809 及更新系统自带的 .NET Framework 4.7.2 或更高兼容版本,用户无需另装运行库。系统基线、电脑控制架构及完整验证步骤见 Windows README:
./windows/build.ps1 -Release -Test -Package -Installer -Architecture amd64将 -Architecture 改为 386 可构建 32 位版本。-Package 会先从 browser-extension/ 构建企业版插件,校验并嵌入 EXE。
官网位于 site/,使用 Next.js、React、Tailwind CSS v4 与 shadcn/ui,构建时静态导出到 site/out/:
cd site
npm install
mkdir -p public/assets
cp ../docs/images/v0.1.0/*.png public/assets/
npm run dev生产构建使用 /ytray 作为 GitHub Pages 基础路径:
YTRAY_BASE_PATH=/ytray NEXT_PUBLIC_BASE_PATH=/ytray npm run buildReact Bits Pro 授权只保存在本机的 site/.env.local;其授权信息、Skill 与设计配方均已被 Git 忽略,不能提交到仓库。
生产应用图标的唯一源文件是 assets/app-icon/YTray.png。它会派生出 macOS .icns、Windows 多尺寸 PNG/ICO、系统托盘资源,以及官网 favicon、Apple Touch Icon 和 PWA 图标。更换源文件后统一执行:
./script/generate-app-icons.sh生成脚本最后会运行 script/verify-app-icons.py,验证各尺寸、ICO 帧、官网展示图与源码引用;CI 和正式发版也会再次执行同一校验。
macOS在 macOS 15 和 Tahoe 26 上执行 Swift Release 构建、测试、真实 UI 渲染、更新器验证、本仓库插件打包、通用 DMG 挂载及真实启动检查。Windows:WPF 构建、测试、独立 EXE 冒烟、真实设计截图和 Inno Setup 安装包。Pages:安装锁定依赖、装配版本化真实截图、静态导出 Next.js 官网,发布后用deploy-meta.json验证线上 commit。Browser extension在插件改动时运行测试、类型检查及四种构建变体的审计。Release为 macOS arm64/amd64 与 Windows amd64/386 构建安装包,核对四个包内置的插件与当前提交生成的企业版 ZIP 一致。桌面发布使用v*标签。
OSS 版本产物使用不可变路径:
https://aliyun-oss.yaklang.com/ytray/<version>/<filename>
发布流程先上传并公开校验所有版本化文件,再更新 latest.json、latest.txt 与 releases.json。若相同版本路径已经存在不同内容,CI 会拒绝覆盖。每个安装包同时提供 SHA-256 文件,完整信息记录在版本 manifest.json 中。
桌面端更新器只读取这个最终发布的 latest.json,并严格选择当前平台与进程架构的安装包;未通过大小、SHA-256 或平台签名检查的文件不会执行。
darwin/ Swift / AppKit / SwiftUI 应用与测试
windows/ C# / WPF 应用、测试与 Inno Setup
script/ macOS 打包、插件准备和发布索引
site/ Next.js / React / shadcn 官方网站(静态导出)
assets/app-icon/ 跨平台应用图标的 1024px 核心美术源文件
docs/images/v0.1.0/ 由应用真实渲染的版本化截图
.github/workflows/ macOS、Windows、Pages 与 Release 流程
- YTray 不上传浏览器配置、Cookie、历史或代理凭据。
- macOS 状态文件限制为当前用户读写;代理认证临时扩展在浏览器退出或启动失败后清理。
- Windows 开机启动只写当前用户范围,不修改系统级启动服务。
- 浏览器调试端口只监听回环地址。
- MCP 服务只监听
127.0.0.1:19222,并拒绝非本机 Host 与 Origin。 - 下载的 Chrome for Testing 和内置插件在使用前校验清单与 SHA-256。
源码公开于本仓库。仓库当前未包含单独的 LICENSE 文件;复用或分发前请先确认适用授权。



