桌面应用程序

​

概述

​

功能特性

• 实时任务流 - 活动任务的实时 SSE 事件源
• 任务管理 - 提交、监控和取消任务
• 会话历史 - 浏览和继续之前的对话
• 多平台支持 - macOS（通用版）、Windows、Linux、iOS

​

支持的平台

​

安装

​

macOS

1. 从发布页面下载最新的 DMG
2. 打开 DMG 文件
3. 将 Shannon 拖到应用程序文件夹
4. 从应用程序启动

# 或通过命令行安装
open shannon-desktop_0.2.0_universal.dmg

​

从源代码构建

# 安装用于通用二进制文件的 Rust 目标（macOS）
rustup target add aarch64-apple-darwin x86_64-apple-darwin

git clone https://github.com/Kocoro-lab/Shannon.git
cd Shannon/desktop
npm install

cp .env.local.example .env.local
# 编辑 .env.local 设置您的 Shannon API URL
# 默认：http://localhost:8080

npm run tauri:dev

npm run tauri:build

​

配置

​

API 端点

# .env.local
NEXT_PUBLIC_API_URL=http://localhost:8080

NEXT_PUBLIC_API_URL=https://api.your-domain.com

​

使用方法

​

主界面

1. 聊天界面 - 提交查询并查看响应
2. 运行视图 - 监控活动和已完成的任务
3. 运行详情 - 查看特定任务的完整事件流
4. 设置 - 配置 API 端点和偏好设置

​

提交任务

1. 打开应用
2. 在聊天输入框中输入您的查询
3. 按 Enter 或点击发送
4. 观看任务执行时的实时事件

​

监控任务

• 带有实时状态的活动任务
• 带有结果的已完成任务
• 带有错误详情的失败任务

​

故障排除

​

构建失败：模块未找到

npm install @tauri-apps/plugin-shell

​

通用二进制文件要求（macOS）

rustup target list --installed
# 应该显示：
# aarch64-apple-darwin
# x86_64-apple-darwin

​

连接问题

1. 验证 Shannon 服务正在运行
2. 检查 .env.local 中的 API URL
3. 确保防火墙没有阻止端口 8080

​

清理重建

rm -rf .next out src-tauri/target/release/bundle
npm run tauri:build

​

技术栈

​

下一步