全新界面,不包装旧 Web UI。 旧 WPF 客户端保留在 ../src/,这里是独立的 Tauri 2 应用。
React 19 + TypeScript + Vite
│ invoke / event
▼
Tauri 2 (Rust)
├─ reqwest:登录、Cookie、REST、RPC、文件上传
└─ SSE 任务:/api/sse → app.emit("xbot-sse")
│
▼
xbot server(web channel,零改动)
- Windows 使用系统 WebView2,安装包 12 MB(旧 WPF 68 MB),内存更低。
- 前端可以自由重写(本项目使用 React + 自定义 CSS + lucide 图标 + Shiki 代码高亮)。
- Rust 侧负责 Cookie/SSE/文件上传,前端不直接跨域请求,避免 CORS / Cookie 差异。
- 相比 Electron 不捆绑 Chromium;相比 WPF FlowDocument,Markdown/代码高亮/表格生态成熟得多。
- 登录 / 首个账号注册 / Cookie 持久化
- 会话树(含 SubAgent)、搜索、新建、重命名、Fork、删除
- 新建会话支持服务端目录树选择工作目录(懒加载、可输入路径、上一级/根目录)
- 历史分页 + SSE 流式输出
- Markdown(GFM)、深色代码块 + 复制按钮
- 思考过程折叠、工具卡片(参数/输出)、AskUser、待发队列
- 停止生成、模型切换、上下文预算
- 设置:默认模型、订阅/模型启用、智能体参数、工具开关
未实现:Tauri Updater 签名更新(当前是自定义 HTTPS + SHA256 更新)、GenUI 插件渲染、!cmd 历史行恢复、虚拟列表、Mica 自绘标题栏。
前置:Node 20+、Rust 1.90+、Windows 需 MSVC Build Tools、WebView2 Runtime(Win11 自带)。
cd tauri
npm install
npm run tauri dev # 需要桌面会话,WebView2 才能创建窗口npm install
npm run build
cd src-tauri
cargo build --release --features custom-protocol
# 产物:src-tauri/target/release/xbot-desktop.exe--features custom-protocol 不能省。裸 cargo build --release 会走 Tauri 的 dev 模式,
把 http://localhost:1420 嵌进 exe(表现为启动后直接连 localhost / 页面空白)。
也可以使用 Tauri CLI(会自动设置 custom-protocol,但需要完整 npm 依赖):
npm run tauri build -- --no-bundle从 SSH/服务会话启动 GUI 会报
WebView2 error: 无效的窗口句柄;这是没有交互桌面导致的,必须在登录的桌面会话里双击运行。
0.1.2 起接入应用内更新:
- 清单:
https://minio.cjiw.site/uploads/share/xbot-desktop/tauri/latest.json{ "version": "0.1.3", "url": "https://.../xbot-desktop-tauri-0.1.3-win-x64.exe", "sha256": "...", "notes": "..." } - 登录后自动检查;「设置 → 关于 → 检查更新」可手动检查。
- 发现新版本后聊天页顶部出现提示;弹窗里下载(带进度)、校验 SHA256、退出后由
.cmd等待进程退出、替换 exe 并重启。 - 0.1.2 是第一个带更新器的版本,0.1.30 是当前最新版;0.1.29 可直接验证更新到 0.1.30。
- 目前是自定义便携版更新(HTTPS + SHA256),没有 Tauri Updater 的签名校验。
%APPDATA%\site.cjiw.xbot.desktop\session.json(服务端地址 + 会话 Cookie)
src/ React UI
components/ 登录 / 侧栏 / 聊天 / 工具卡 / 设置
chat/reducer.ts 聊天状态机(纯函数,Vitest 覆盖)
state/store.ts Zustand 应用状态 + SSE 桥
src-tauri/ Rust 后端
src/api.rs 登录/Cookie/REST/RPC/上传命令
src/sse.rs SSE 解析 + 重连 + 事件桥
src/state.rs AppState / CookieJar
两个 GitHub Actions 工作流(.github/workflows/):
- check:push / PR 到
main时执行frontend:npm ci→npm test→npm run buildrust:装 Tauri 的 Ubuntu 依赖后cargo check --release --features custom-protocol
- release:推送
v*tag(或手动 dispatch 指定已存在的 tag)时执行- 校验 tag 与
package.json版本一致 - 矩阵构建三个平台:
平台 Runner 产物 Windows x64 windows-latestxbot-desktop-tauri-<ver>-win-x64.exe(便携版,供自动更新)macOS arm64 macos-14xbot-desktop-tauri-<ver>-macos-arm64.dmgLinux amd64 ubuntu-22.04xbot-desktop-tauri-<ver>-linux-amd64.deb - 全部产物 +
SHA256SUMS.txt附加到 GitHub Release - macOS 包使用 ad-hoc 签名(
bundle.macOS.signingIdentity = "-"),否则 Apple Silicon 会报“已损坏”;CI 会先用codesign --verify --deep --strict校验再打包 - 若仓库配置了下列 secrets,则同时上传三个产物到 MinIO 并更新
latest.json(仍指向 Windows exe):
- 校验 tag 与
| Secret | 说明 |
|---|---|
MINIO_ENDPOINT |
例如 https://minio.cjiw.site |
MINIO_ACCESS_KEY |
MinIO access key |
MINIO_SECRET_KEY |
MinIO secret key |
MINIO_BUCKET |
例如 uploads |
MINIO_PREFIX |
例如 share/xbot-desktop/tauri |
发版流程:
# 先把三处版本号改成同一个(package.json / tauri.conf.json / Cargo.toml)
git tag v0.1.25 && git push origin v0.1.25npm run build:TypeScript + Vite 构建通过npm test:19 个测试通过(含缓存、rewind、跨会话串台回归测试)cargo check/cargo build --release:Windows 原生编译通过- CI:
check工作流覆盖前端测试/构建与cargo check