ZeroClaw 桌面应用Tauri启动流程、内核打包与跨平台测试全指南【免费下载链接】zeroclawFast, small, and fully autonomous AI personal assistant infrastructure, any OS, any platform — deploy anywhere, swap anything 项目地址: https://gitcode.com/gh_mirrors/ze/zeroclawZeroClaw Desktop 是一款基于 Tauri 构建的轻量桌面外壳它本身不内置业务逻辑而是作为运行中 ZeroClaw Web Gateway守护进程的薄壳负责启动守护进程、健康探测、令牌配对与仪表盘窗口的拉起。本篇以仓库内 apps/tauri/TESTING.md 为骨架结合apps/tauri/src下的 Rust 源码与打包脚本完整梳理桌面端的启动时序、自包含bundled kernel构建流程、macOS/Linux/Windows 的验证方法以及安全边界帮助读者掌握如何测试、如何打包、如何排障的完整闭环。启动流程Splash → Gateway 健康探测 → 仪表盘交接整体架构定位桌面应用是一个运行中 ZeroClawweb gateway的薄壳。仓库已不再提供 macOS/Windows/Linux 的平台权限设置向导——应用启动后直接对接 gateway首次配置Quickstart完全在 Web 界面内完成。这一点从 apps/tauri/src/lib.rs 的结构可以得到印证run()中依次完成托盘设置、splash 窗口显示、ensure_daemon异步任务启动与健康轮询任务挂载全程没有任何权限引导窗口。三步启动时序按 apps/tauri/TESTING.md 的 Startup flow 描述应用启动分三步Splash 窗口出现并轮询/health一个小型启动窗口apps/tauri/splash/index.html每约1.2s调用一次get_healthIPC 命令对应 apps/tauri/src/commands/gateway.rs 中的#[tauri::command] get_health底层经 apps/tauri/src/gateway_client.rs 的GET {base}/health探测。splash 页面通过setInterval(tick, 1200)驱动轮询并监听zeroclaw://splash-status事件接收后端状态starting/error/missing。Gateway 健康后调用open_dashboard该命令在 apps/tauri/src/lib.rs 中实现。当需要配对时执行自动配对auto_pair经requires_pairing()→request_new_paircode()→pair_with_code()换取 Bearer token随后创建指向 gateway根路径http://127.0.0.1:42617/的主窗口通过initialization_script将 token 写入localStorage[zeroclaw_token]最后关闭 splash。Web 应用的新装重定向web/src/App.tsx中的FreshInstallRedirect组件会查询GET /api/quickstart/state见 web/src/lib/api.ts 中的QuickstartState类型含quickstart_completed与 agents 列表。若quickstart_completedfalse且 agents 为空则navigate(/quickstart, { replace: true })将首启用户送入 Quickstart返回用户则直接落在仪表盘。端口约定应用硬编码使用回环端口42617apps/tauri/src/lib.rs 中const GATEWAY_PORT: u16 42617;与AppState::default的gateway_url一致。复用已有守护进程还是启动新的ensure_daemonapps/tauri/src/lib.rs的策略是先给已运行的 gateway/daemon至多 3 次、每次 700ms的应答机会避免与正在启动的 daemon 竞态若仍无响应则通过 apps/tauri/src/daemon.rs 的find_zeroclaw_binary()查找内核可执行文件并执行zeroclaw service run-desktop-daemon --port 42617find_zeroclaw_binary()的查找顺序源码可证应用可执行文件同目录的兄弟文件Windows 上为zeroclaw.exe其余平台为zeroclaw系统PATH的每个目录常见安装位置$HOME/.cargo/bin、$HOME/.local/bin、/opt/homebrew/bin、/usr/local/bin、/usr/bin——GUI 启动Finder/Dock继承的PATH通常很精简往往会漏掉~/.cargo/bin与 Homebrew 前缀因此这一步对桌面端至关重要。找不到内核时后端通过zeroclaw://splash-status发出missing事件splash 显示 Couldnt find thezeroclawbinary… 提示。能力探测与就绪帧协议在拉起守护进程前桌面端会先探测内核是否支持桌面监督命令。ensure_desktop_supervisor_capability()apps/tauri/src/daemon.rs以2s 超时运行service run-desktop-daemon --help校验成功退出码若内核过旧不支持该命令则给出包含具体二进制路径的、可操作的启动错误而不是退回不可控的裸 daemon。spawn_daemon()随后读取监督进程 stdout 上的就绪帧READY或ERROR detail帧上限 4096 字节10s 超时任何失败路径都会调用terminate_supervisor_tree()清理整个进程组Unix 上以负 PID 向独立进程组发 SIGTERM/SIGKILLWindows 上使用taskkill /PID pid /T [/F]。apps/tauri/src/daemon.rs 自带的 8 个单元测试如unsupported_kernel_reports_selected_path_and_matching_version_action、capability_probe_times_out_and_reaps_stale_kernel、spawn_daemon_cleans_supervisor_tree_after_log_open_failure等覆盖了这些异常路径。为什么必须跑zeroclaw daemon而不是zeroclaw gateway startTESTING.md 用醒目的提示强调Runzeroclaw daemon, notzeroclaw gateway start.两者都在 42617 端口提供仪表盘但只有 daemon 挂载了桌面监督器supervisor后者支撑就地热重载。Quickstart 应用配置后会调用/admin/reload独立的gateway start没有监督器会返回503 no daemon supervisor — running as standalone gateway新 agent 要等进程重启才生效而 daemon 可以热重载。监督日志捕获桌面监督器把 daemon 的 stdoutstderr 合并写入config-dir/logs/zeroclaw-desktop-daemon.log其中config-dir遵循规范配置解析优先级ZEROCLAW_CONFIG_DIR→ZEROCLAW_DATA_DIR→ 已废弃的ZEROCLAW_WORKSPACE→ Homebrew/默认解析。日志捕获上限8 MiB超过后仅保留最新尾部。排障时先看这个文件就能确认启动时守护进程是否正常就绪。自包含构建把内核打进安装包bundled kernel普通cargo tauri build产出的应用只会寻找已安装的zeroclaw。要得到零安装依赖的产物在什么都没装的机器上双击即可跑起 agent需要把内核作为Tauri sidecar一起打包。构建步骤# 1. 先构建仪表盘再把它嵌入到 staged 内核中 cargo web build scripts/desktop/prepare-kernel.sh --features embedded-web scripts/desktop/prepare-kernel.sh --target universal-apple-darwin --features embedded-web # 2. 使用 sidecar 覆盖层打包追加 bundle.externalBin cd apps/tauri cargo tauri build --config tauri.bundled.conf.jsonscripts/desktop/prepare-kernel.sh负责构建或复用zeroclaw内核二进制并将其剥壳strip后放到 Tauri 打包器期望的 sidecar 位置apps/tauri/binaries/zeroclaw-target-triple[.exe]。macOS 上 strip 会使 arm64 的 ad-hoc 签名失效脚本会重新codesign --force --sign -。覆盖层配置文件 apps/tauri/tauri.bundled.conf.json 仅追加externalBin: [binaries/zeroclaw]不触碰默认配置因此不带 staged 内核的cargo tauri build照常可用。Tauri 会把 sidecar 放在应用可执行文件旁边名为zeroclaw——这正是find_zeroclaw_binary()首先查找的位置所以打包应用会从自己的内核启动自己的 daemon。ZEROCLAW_KERNEL_PATH复用预构建内核ZEROCLAW_KERNEL_PATH环境变量可以复用已构建的单目标内核但该二进制必须已经用--features embedded-web构建过——staging 脚本无法向既有可执行文件追加嵌入资源embedded assets。此外该变量对 universal 目标无效两个切片必须分别构建再lipo融合脚本中会强制清空。验证自包含在zeroclaw不在PATH、也不在~/.cargo/bin的机器或 shell上启动应用然后检查 daemon 进程路径是否落在应用包内pgrep -fl zeroclaw daemon # 期望输出 .../ZeroClaw.app/Contents/MacOS/zeroclaw体积说明内核是产物体积的绝对主导者TESTING.md 原注剥壳后的 release 内核约146 MB/架构压缩后 dmg 约 55–65 MBuniversal双切片内核大约翻倍未剥壳的 dev 内核约228 MB——务必让prepare-kernel.sh负责 strip。macOS当前主要目标平台测试方法重置到全新安装状态pkill -f target/debug/zeroclaw-desktop rm $HOME/Library/Application Support/ai.zeroclawlabs.desktop/settings.json killall Dock # 若 dock 图标显示陈旧 bash dev/run-tauri-dev.shai.zeroclawlabs.desktop对应 apps/tauri/tauri.conf.json 中的identifier。要完整演练首次运行路径还需重置 gateway 配置使 Quickstart 自动拉起gateway 通过GET /api/quickstart/state上报quickstart_completedfalse与空 agents 列表。真实安装包测试cd apps/tauri cargo tauri build cp -R target/release/bundle/macos/ZeroClaw.app /Applications/ xattr -dr com.apple.quarantine /Applications/ZeroClaw.app open /Applications/ZeroClaw.app复制到/Applications后需去除 quarantine 属性否则 Gatekeeper 会拦截。验证清单TESTING.md 原列无 gateway 运行splash 显示 Connecting to your ZeroClaw gateway…数秒后出现 make sure the gateway is running 提示托盘图标为 Disconnected。启动 daemoncargo run -p zeroclaw -- daemon或zeroclaw daemon约1–2s内 splash 交接——仪表盘窗口打开、splash 关闭。首次运行全新 gateway 配置仪表盘直接进入Quickstart完成后 gateway 变为可用之后重启应用落在仪表盘。返回运行已配置 agent打开普通仪表盘而非 Quickstart。托盘退出 → 重启splash → 仪表盘全流程重现托盘图标常驻菜单栏。日志检查启动后查看config-dir/logs/zeroclaw-desktop-daemon.log确认合并 stdout/stderr 捕获持续输出时文件保持在 8 MiB 以内并保留最新尾部。这些行为背后的实现web/src/App.tsx的FreshInstallRedirect决定 Quickstart 重定向托盘图标状态由 apps/tauri/src/health.rs 的后台轮询任务驱动——每5s轮询一次GET /health按connected与agent_status切换托盘图标/工具提示对应apps/tauri/icons/下的tray-idle.png、tray-working.png、tray-disconnected.png、tray-error.png。原生命令边界安全相关Rust 侧仍然注册了take_screenshot与run_applescript两个命令见 apps/tauri/src/lib.rs 的invoke_handler实现位于 apps/tauri/src/capabilities/screenshot.rs 与 apps/tauri/src/capabilities/applescript.rs但由 gateway 提供的主窗口不接收任何远程 Tauri capability无法调用它们。这条边界由集成测试 apps/tauri/tests/capability_security.rs 强制保障该测试解析apps/tauri/capabilities下所有 capability 文件断言没有任何 capability 带有remote远程内容访问 IPC权限且所有权限均以core:为前缀。TESTING.md 明确开放任一命令都需要单独、窄范围的审批与 ACL 设计。Linux / Windows桌面应用在三个平台跑相同的 splash → gateway → Quickstart 流程。打包目标不变Linux 为.deb/.AppImageWindows 为.exe/.msi。屏幕捕获与 AppleScript 能力保持 macOS 独占其他平台注册的是返回不支持的平台错误的 stub。构建方法cd apps/tauri cargo tauri build # 各平台原生构建 # 或用目标三元组 工具链交叉编译 # cargo build --release --target x86_64-unknown-linux-gnu # cargo build --release --target x86_64-pc-windows-msvc注意 apps/tauri/src/daemon.rs 中 Windows 特有实现能力探测使用process_wrap的JobObject/KillOnDrop包装守护进程以DETACHED_PROCESS | CREATE_NEW_PROCESS_GROUP | CREATE_NO_WINDOW标志分离启动清理路径则依赖taskkill /PID /T [/F]递归终止进程树。待补充的 CI 矩阵独立 issueTESTING.md 末尾给出了建议的 CI 矩阵供 #6501 落地后在cargo check上三平台并行运行# Suggested when #6501 lands — run all three at minimum on cargo check matrix: os: [macos-14, ubuntu-22.04, windows-2022]排障速查从现象到结论splash 一直转圈、数秒后出现 make sure the gateway is running说明 3 次 × 700ms 内无人应答且find_zeroclaw_binary()未找到内核或找到的内核无法通过service run-desktop-daemon --help能力探测过旧内核。可先手动zeroclaw daemon复测并检查zeroclaw-desktop-daemon.log。配置了 agent 却不生效确认跑的是zeroclaw daemon而非zeroclaw gateway start——后者对/admin/reload返回503需重启进程。安装包在其他机器上找不到内核检查pgrep -fl zeroclaw daemon的进程路径是否在应用包内若不在多半是打包时未用--config tauri.bundled.conf.json缺少externalBin或prepare-kernel.sh未带--features embedded-web。主窗口无法调用截图/AppleScript这是设计使然的边界而非缺陷——gateway 提供的主窗口不持有远程 capability详见 apps/tauri/tests/capability_security.rs。相关代码索引主题仓库路径启动时序 / open_dashboard / auto_pairapps/tauri/src/lib.rs内核查找 / 能力探测 / 就绪帧 / 进程树清理apps/tauri/src/daemon.rs健康轮询与托盘状态apps/tauri/src/health.rsGateway HTTP 客户端配对、健康、设备apps/tauri/src/gateway_client.rsIPC 命令get_status / get_healthapps/tauri/src/commands/gateway.rsSplash 前端轮询逻辑apps/tauri/splash/index.html默认 Tauri 配置splash 窗口 480×380、CSPapps/tauri/tauri.conf.jsonSidecar 打包覆盖层apps/tauri/tauri.bundled.conf.json内核 staging 脚本strip / 签名 / universalscripts/desktop/prepare-kernel.sh前端新装重定向到 /quickstartweb/src/App.tsxQuickstart 状态 API 类型web/src/lib/api.tsCapability 安全集成测试apps/tauri/tests/capability_security.rs【免费下载链接】zeroclawFast, small, and fully autonomous AI personal assistant infrastructure, any OS, any platform — deploy anywhere, swap anything 项目地址: https://gitcode.com/gh_mirrors/ze/zeroclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
ZeroClaw 桌面应用（Tauri）启动流程、内核打包与跨平台测试全指南
ZeroClaw 桌面应用Tauri启动流程、内核打包与跨平台测试全指南【免费下载链接】zeroclawFast, small, and fully autonomous AI personal assistant infrastructure, any OS, any platform — deploy anywhere, swap anything 项目地址: https://gitcode.com/gh_mirrors/ze/zeroclawZeroClaw Desktop 是一款基于 Tauri 构建的轻量桌面外壳它本身不内置业务逻辑而是作为运行中 ZeroClaw Web Gateway守护进程的薄壳负责启动守护进程、健康探测、令牌配对与仪表盘窗口的拉起。本篇以仓库内 apps/tauri/TESTING.md 为骨架结合apps/tauri/src下的 Rust 源码与打包脚本完整梳理桌面端的启动时序、自包含bundled kernel构建流程、macOS/Linux/Windows 的验证方法以及安全边界帮助读者掌握如何测试、如何打包、如何排障的完整闭环。启动流程Splash → Gateway 健康探测 → 仪表盘交接整体架构定位桌面应用是一个运行中 ZeroClawweb gateway的薄壳。仓库已不再提供 macOS/Windows/Linux 的平台权限设置向导——应用启动后直接对接 gateway首次配置Quickstart完全在 Web 界面内完成。这一点从 apps/tauri/src/lib.rs 的结构可以得到印证run()中依次完成托盘设置、splash 窗口显示、ensure_daemon异步任务启动与健康轮询任务挂载全程没有任何权限引导窗口。三步启动时序按 apps/tauri/TESTING.md 的 Startup flow 描述应用启动分三步Splash 窗口出现并轮询/health一个小型启动窗口apps/tauri/splash/index.html每约1.2s调用一次get_healthIPC 命令对应 apps/tauri/src/commands/gateway.rs 中的#[tauri::command] get_health底层经 apps/tauri/src/gateway_client.rs 的GET {base}/health探测。splash 页面通过setInterval(tick, 1200)驱动轮询并监听zeroclaw://splash-status事件接收后端状态starting/error/missing。Gateway 健康后调用open_dashboard该命令在 apps/tauri/src/lib.rs 中实现。当需要配对时执行自动配对auto_pair经requires_pairing()→request_new_paircode()→pair_with_code()换取 Bearer token随后创建指向 gateway根路径http://127.0.0.1:42617/的主窗口通过initialization_script将 token 写入localStorage[zeroclaw_token]最后关闭 splash。Web 应用的新装重定向web/src/App.tsx中的FreshInstallRedirect组件会查询GET /api/quickstart/state见 web/src/lib/api.ts 中的QuickstartState类型含quickstart_completed与 agents 列表。若quickstart_completedfalse且 agents 为空则navigate(/quickstart, { replace: true })将首启用户送入 Quickstart返回用户则直接落在仪表盘。端口约定应用硬编码使用回环端口42617apps/tauri/src/lib.rs 中const GATEWAY_PORT: u16 42617;与AppState::default的gateway_url一致。复用已有守护进程还是启动新的ensure_daemonapps/tauri/src/lib.rs的策略是先给已运行的 gateway/daemon至多 3 次、每次 700ms的应答机会避免与正在启动的 daemon 竞态若仍无响应则通过 apps/tauri/src/daemon.rs 的find_zeroclaw_binary()查找内核可执行文件并执行zeroclaw service run-desktop-daemon --port 42617find_zeroclaw_binary()的查找顺序源码可证应用可执行文件同目录的兄弟文件Windows 上为zeroclaw.exe其余平台为zeroclaw系统PATH的每个目录常见安装位置$HOME/.cargo/bin、$HOME/.local/bin、/opt/homebrew/bin、/usr/local/bin、/usr/bin——GUI 启动Finder/Dock继承的PATH通常很精简往往会漏掉~/.cargo/bin与 Homebrew 前缀因此这一步对桌面端至关重要。找不到内核时后端通过zeroclaw://splash-status发出missing事件splash 显示 Couldnt find thezeroclawbinary… 提示。能力探测与就绪帧协议在拉起守护进程前桌面端会先探测内核是否支持桌面监督命令。ensure_desktop_supervisor_capability()apps/tauri/src/daemon.rs以2s 超时运行service run-desktop-daemon --help校验成功退出码若内核过旧不支持该命令则给出包含具体二进制路径的、可操作的启动错误而不是退回不可控的裸 daemon。spawn_daemon()随后读取监督进程 stdout 上的就绪帧READY或ERROR detail帧上限 4096 字节10s 超时任何失败路径都会调用terminate_supervisor_tree()清理整个进程组Unix 上以负 PID 向独立进程组发 SIGTERM/SIGKILLWindows 上使用taskkill /PID pid /T [/F]。apps/tauri/src/daemon.rs 自带的 8 个单元测试如unsupported_kernel_reports_selected_path_and_matching_version_action、capability_probe_times_out_and_reaps_stale_kernel、spawn_daemon_cleans_supervisor_tree_after_log_open_failure等覆盖了这些异常路径。为什么必须跑zeroclaw daemon而不是zeroclaw gateway startTESTING.md 用醒目的提示强调Runzeroclaw daemon, notzeroclaw gateway start.两者都在 42617 端口提供仪表盘但只有 daemon 挂载了桌面监督器supervisor后者支撑就地热重载。Quickstart 应用配置后会调用/admin/reload独立的gateway start没有监督器会返回503 no daemon supervisor — running as standalone gateway新 agent 要等进程重启才生效而 daemon 可以热重载。监督日志捕获桌面监督器把 daemon 的 stdoutstderr 合并写入config-dir/logs/zeroclaw-desktop-daemon.log其中config-dir遵循规范配置解析优先级ZEROCLAW_CONFIG_DIR→ZEROCLAW_DATA_DIR→ 已废弃的ZEROCLAW_WORKSPACE→ Homebrew/默认解析。日志捕获上限8 MiB超过后仅保留最新尾部。排障时先看这个文件就能确认启动时守护进程是否正常就绪。自包含构建把内核打进安装包bundled kernel普通cargo tauri build产出的应用只会寻找已安装的zeroclaw。要得到零安装依赖的产物在什么都没装的机器上双击即可跑起 agent需要把内核作为Tauri sidecar一起打包。构建步骤# 1. 先构建仪表盘再把它嵌入到 staged 内核中 cargo web build scripts/desktop/prepare-kernel.sh --features embedded-web scripts/desktop/prepare-kernel.sh --target universal-apple-darwin --features embedded-web # 2. 使用 sidecar 覆盖层打包追加 bundle.externalBin cd apps/tauri cargo tauri build --config tauri.bundled.conf.jsonscripts/desktop/prepare-kernel.sh负责构建或复用zeroclaw内核二进制并将其剥壳strip后放到 Tauri 打包器期望的 sidecar 位置apps/tauri/binaries/zeroclaw-target-triple[.exe]。macOS 上 strip 会使 arm64 的 ad-hoc 签名失效脚本会重新codesign --force --sign -。覆盖层配置文件 apps/tauri/tauri.bundled.conf.json 仅追加externalBin: [binaries/zeroclaw]不触碰默认配置因此不带 staged 内核的cargo tauri build照常可用。Tauri 会把 sidecar 放在应用可执行文件旁边名为zeroclaw——这正是find_zeroclaw_binary()首先查找的位置所以打包应用会从自己的内核启动自己的 daemon。ZEROCLAW_KERNEL_PATH复用预构建内核ZEROCLAW_KERNEL_PATH环境变量可以复用已构建的单目标内核但该二进制必须已经用--features embedded-web构建过——staging 脚本无法向既有可执行文件追加嵌入资源embedded assets。此外该变量对 universal 目标无效两个切片必须分别构建再lipo融合脚本中会强制清空。验证自包含在zeroclaw不在PATH、也不在~/.cargo/bin的机器或 shell上启动应用然后检查 daemon 进程路径是否落在应用包内pgrep -fl zeroclaw daemon # 期望输出 .../ZeroClaw.app/Contents/MacOS/zeroclaw体积说明内核是产物体积的绝对主导者TESTING.md 原注剥壳后的 release 内核约146 MB/架构压缩后 dmg 约 55–65 MBuniversal双切片内核大约翻倍未剥壳的 dev 内核约228 MB——务必让prepare-kernel.sh负责 strip。macOS当前主要目标平台测试方法重置到全新安装状态pkill -f target/debug/zeroclaw-desktop rm $HOME/Library/Application Support/ai.zeroclawlabs.desktop/settings.json killall Dock # 若 dock 图标显示陈旧 bash dev/run-tauri-dev.shai.zeroclawlabs.desktop对应 apps/tauri/tauri.conf.json 中的identifier。要完整演练首次运行路径还需重置 gateway 配置使 Quickstart 自动拉起gateway 通过GET /api/quickstart/state上报quickstart_completedfalse与空 agents 列表。真实安装包测试cd apps/tauri cargo tauri build cp -R target/release/bundle/macos/ZeroClaw.app /Applications/ xattr -dr com.apple.quarantine /Applications/ZeroClaw.app open /Applications/ZeroClaw.app复制到/Applications后需去除 quarantine 属性否则 Gatekeeper 会拦截。验证清单TESTING.md 原列无 gateway 运行splash 显示 Connecting to your ZeroClaw gateway…数秒后出现 make sure the gateway is running 提示托盘图标为 Disconnected。启动 daemoncargo run -p zeroclaw -- daemon或zeroclaw daemon约1–2s内 splash 交接——仪表盘窗口打开、splash 关闭。首次运行全新 gateway 配置仪表盘直接进入Quickstart完成后 gateway 变为可用之后重启应用落在仪表盘。返回运行已配置 agent打开普通仪表盘而非 Quickstart。托盘退出 → 重启splash → 仪表盘全流程重现托盘图标常驻菜单栏。日志检查启动后查看config-dir/logs/zeroclaw-desktop-daemon.log确认合并 stdout/stderr 捕获持续输出时文件保持在 8 MiB 以内并保留最新尾部。这些行为背后的实现web/src/App.tsx的FreshInstallRedirect决定 Quickstart 重定向托盘图标状态由 apps/tauri/src/health.rs 的后台轮询任务驱动——每5s轮询一次GET /health按connected与agent_status切换托盘图标/工具提示对应apps/tauri/icons/下的tray-idle.png、tray-working.png、tray-disconnected.png、tray-error.png。原生命令边界安全相关Rust 侧仍然注册了take_screenshot与run_applescript两个命令见 apps/tauri/src/lib.rs 的invoke_handler实现位于 apps/tauri/src/capabilities/screenshot.rs 与 apps/tauri/src/capabilities/applescript.rs但由 gateway 提供的主窗口不接收任何远程 Tauri capability无法调用它们。这条边界由集成测试 apps/tauri/tests/capability_security.rs 强制保障该测试解析apps/tauri/capabilities下所有 capability 文件断言没有任何 capability 带有remote远程内容访问 IPC权限且所有权限均以core:为前缀。TESTING.md 明确开放任一命令都需要单独、窄范围的审批与 ACL 设计。Linux / Windows桌面应用在三个平台跑相同的 splash → gateway → Quickstart 流程。打包目标不变Linux 为.deb/.AppImageWindows 为.exe/.msi。屏幕捕获与 AppleScript 能力保持 macOS 独占其他平台注册的是返回不支持的平台错误的 stub。构建方法cd apps/tauri cargo tauri build # 各平台原生构建 # 或用目标三元组 工具链交叉编译 # cargo build --release --target x86_64-unknown-linux-gnu # cargo build --release --target x86_64-pc-windows-msvc注意 apps/tauri/src/daemon.rs 中 Windows 特有实现能力探测使用process_wrap的JobObject/KillOnDrop包装守护进程以DETACHED_PROCESS | CREATE_NEW_PROCESS_GROUP | CREATE_NO_WINDOW标志分离启动清理路径则依赖taskkill /PID /T [/F]递归终止进程树。待补充的 CI 矩阵独立 issueTESTING.md 末尾给出了建议的 CI 矩阵供 #6501 落地后在cargo check上三平台并行运行# Suggested when #6501 lands — run all three at minimum on cargo check matrix: os: [macos-14, ubuntu-22.04, windows-2022]排障速查从现象到结论splash 一直转圈、数秒后出现 make sure the gateway is running说明 3 次 × 700ms 内无人应答且find_zeroclaw_binary()未找到内核或找到的内核无法通过service run-desktop-daemon --help能力探测过旧内核。可先手动zeroclaw daemon复测并检查zeroclaw-desktop-daemon.log。配置了 agent 却不生效确认跑的是zeroclaw daemon而非zeroclaw gateway start——后者对/admin/reload返回503需重启进程。安装包在其他机器上找不到内核检查pgrep -fl zeroclaw daemon的进程路径是否在应用包内若不在多半是打包时未用--config tauri.bundled.conf.json缺少externalBin或prepare-kernel.sh未带--features embedded-web。主窗口无法调用截图/AppleScript这是设计使然的边界而非缺陷——gateway 提供的主窗口不持有远程 capability详见 apps/tauri/tests/capability_security.rs。相关代码索引主题仓库路径启动时序 / open_dashboard / auto_pairapps/tauri/src/lib.rs内核查找 / 能力探测 / 就绪帧 / 进程树清理apps/tauri/src/daemon.rs健康轮询与托盘状态apps/tauri/src/health.rsGateway HTTP 客户端配对、健康、设备apps/tauri/src/gateway_client.rsIPC 命令get_status / get_healthapps/tauri/src/commands/gateway.rsSplash 前端轮询逻辑apps/tauri/splash/index.html默认 Tauri 配置splash 窗口 480×380、CSPapps/tauri/tauri.conf.jsonSidecar 打包覆盖层apps/tauri/tauri.bundled.conf.json内核 staging 脚本strip / 签名 / universalscripts/desktop/prepare-kernel.sh前端新装重定向到 /quickstartweb/src/App.tsxQuickstart 状态 API 类型web/src/lib/api.tsCapability 安全集成测试apps/tauri/tests/capability_security.rs【免费下载链接】zeroclawFast, small, and fully autonomous AI personal assistant infrastructure, any OS, any platform — deploy anywhere, swap anything 项目地址: https://gitcode.com/gh_mirrors/ze/zeroclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
