跨平台活动监控与状态展示系统
ShikenMatrix 是一个跨平台活动监控系统，支持桌面端窗口/媒体信息采集、移动端设备状态采集，通过中心服务器汇聚数据并向上游转发，同时提供 Web 管理面板和公开状态展示页。
本项目是 Kizuna 项目的继任者，在 Tauri 2.0 架构基础之上扩展为 多端协同 的完整监控解决方案。
本项目采用 GNU Affero General Public License v3.0 开源协议。
- 实时窗口监控：自动获取当前活动窗口的标题、图标、进程名、PID
- 媒体播放集成：支持显示播放中的音乐/视频信息（标题、艺术家、专辑、封面、播放进度）
- macOS：MediaRemote 框架（MediaRemote-rs）
- Windows：System Media Transport Controls (SMTC)
- WebSocket 上报：实时将窗口和媒体数据上报至 ShikenMatrix Server
- 智能去重与缓存：Hash 去重 + LRU 图标/封面缓存
- 系统托盘：最小化到托盘、关闭行为可选（隐藏/退出）
- 自适应主题：自动适配系统亮色/暗色模式
- 前台应用检测：通过 UsageStatsManager 获取当前前台 App 包名与名称
- 媒体播放监控：通过 MediaSession 获取播放中的标题、艺术家、专辑、进度
- 设备状态采集：电池电量/充电状态、网络类型（WiFi/蜂窝/VPN）、粗略位置
- 后台保活：前台 Service + 开机自启，持续上报
- 可选 Root 增强：通过
su获取更强的前台应用检测能力 / 没啥用
- 多客户端接入：同时支持 Desktop Reporter 和 Mobile 客户端 WebSocket 连接
- 上游转发：将汇聚的数据实时转发到外部服务
- Native WebSocket：转发到任意 WebSocket 服务器
- Mix-Space：HTTP POST 到兼容 Mix-Space 协议的服务
- S3 上传：应用图标 + 媒体封面上传至 S3 兼容存储，AWS SigV4 签名
- API Key 管理：为客户端签发/撤销认证密钥
- SQLite 持久化：活动记录、运行状态、配置持久存储
- JWT 认证：管理面板 API 的登录鉴权
- 实时仪表盘：系统状态概览、消息统计、在线客户端、活动流
- 客户端管理：创建/吊销客户端 API Key
- 上游配置：可视化配置转发协议与参数
- 公开状态页 (
/)：游客可见的当前窗口/媒体/活跃状态
- Monorepo 架构：Turborepo + pnpm workspaces，统一脚本与依赖管理
- Solid.js 驱动：panel 和 desktop 前端均使用高性能响应式 UI
- Rust 后端：server 和 desktop 后端均使用 Rust，零成本抽象与内存安全
- Tailwind CSS 4：panel 使用 Utility-First 样式，玻璃拟态设计
┌──────────────────────────┐ ┌──────────────────────────────┐
│ apps/desktop │ │ apps/android │
│ (Tauri 2.0 + Solid.js) │ │ (Kotlin/Compose) │
│ │ │ │
│ 窗口监控 / 媒体采集 │ │ 前台App / 媒体 / 电池 │
│ Monitor → Reporter │ │ 网络 / 位置 │
│ │ │ │ │ │
└─────────┼────────────────┘ └─────────┼────────────────────┘
│ WebSocket │ WebSocket
│ /reporter?key= │ /mobile
└──────────┬──────────────────┘
▼
┌────────────────────────────────────────────────────────────────┐
│ apps/server (Rust/Axum) :4317 │
│ │
│ ┌──────────┐ ┌───────────┐ ┌──────────┐ ┌─────────────┐ │
│ │ Reporter │ │ Mobile │ │ REST │ │ Admin │ │
│ │ Handler │ │ Handler │ │ API │ │ Auth │ │
│ └────┬─────┘ └─────┬─────┘ └────┬─────┘ └──────┬──────┘ │
│ └──────┬───────┘ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────────┐ ┌──────────────────┐ ┌───────────┐ │
│ │ DashboardState │ │ SQLite Storage │ │ JWT Auth │ │
│ └────────┬─────────┘ └──────────────────┘ └───────────┘ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Upstream Relay (Native WS / Mix-Space HTTP / S3) │ │
│ └──────────────────────────────────────────────────────┘ │
│ │ │
│ ┌────────▼──────────┐ │
│ │ 嵌入 Panel 前端 │ ← rust-embed 编译时嵌入 dist/ │
│ └───────────────────┘ │
└───────────────────────────────────────────────────────────────┘
│ HTTP (REST API + 静态资源)
▼
┌────────────────────────────────────────────────────────────────┐
│ apps/panel (Solid.js + Tailwind CSS 4) │
│ │
│ / → Share 公开页 (当前窗口/媒体/活跃状态) │
│ /admin/* → 管理仪表盘 (统计/客户端/上游配置/活动流) │
└────────────────────────────────────────────────────────────────┘
- Node.js ≥ 18 + pnpm ≥ 9
- Rust ≥ 1.70（rustup）
- macOS ≥ 11.0 + Xcode Command Line Tools
- Windows ≥ 10 (1809) + Visual Studio Build Tools
- Android（仅移动端）：Android Studio + Android SDK
git clone https://github.com/AlienFamilyHub/ShikenMatrix.git
cd ShikenMatrix
pnpm install# 启动所有应用（Turborepo 并行）
pnpm dev
# 单独启动
pnpm dev --filter=@shikenmatrix/desktop # 桌面端前端 (Vite :1420)
pnpm dev --filter=@shikenmatrix/panel # 管理面板 (Vite :1430)
pnpm dev --filter=@shikenmatrix/server # 服务端 (Rust :4317)
# 桌面端 Tauri 完整开发（前端 + Rust 后端）
cd apps/desktop && pnpm dev:tauri# 构建所有应用
pnpm build
# 单独构建
pnpm build --filter=@shikenmatrix/panel # panel → dist/
pnpm build --filter=@shikenmatrix/server # server → target/release/
cd apps/desktop && pnpm build:tauri # desktop → .dmg/.msi
cd apps/android && ./gradlew assembleDebug # android → APK服务端默认监听 0.0.0.0:4317，可通过环境变量配置：
SHIKENMATRIX_SERVER_ADDR=127.0.0.1:8080 # 监听地址
SHIKENMATRIX_DB_PATH=/path/to/data.db # 数据库路径（默认 shikenmatrix.sqlite3）
RUST_LOG=debug # 日志级别首次启动会在控制台输出初始管理员密码。
ShikenMatrix/
├── apps/
│ ├── desktop/ # 桌面端 (Tauri 2.0 + Solid.js)
│ │ ├── src/ # 前端 Web UI
│ │ │ ├── pages/ # MonitorPage / SettingsPage / AboutPage
│ │ │ ├── components/ # AppHeader / RunControls / RuntimeCards / LogPanel
│ │ │ ├── App.tsx
│ │ │ └── index.tsx
│ │ ├── src-tauri/ # Tauri Rust 后端
│ │ │ └── src/
│ │ │ ├── platform/ # macOS / Windows / Linux 平台抽象
│ │ │ ├── services/ # Monitor + Reporter + Config
│ │ │ └── main.rs
│ │ └── package.json
│ │
│ ├── server/ # 中心服务端 (Rust/Axum + SQLite)
│ │ ├── src/
│ │ │ ├── main.rs # 启动入口 + 路由
│ │ │ ├── state.rs # 全局状态管理
│ │ │ ├── storage.rs # SQLite 存储层
│ │ │ ├── mobile.rs # 移动端 WS 处理
│ │ │ ├── reporter/ # 上游转发 (WS / Mix-Space / S3)
│ │ │ └── admin.rs # 管理 API + JWT 认证
│ │ └── package.json
│ │
│ ├── panel/ # Web 管理面板 (Solid.js + Tailwind CSS 4)
│ │ ├── src/
│ │ │ ├── pages/ # Share / Login / Admin
│ │ │ ├── components/ # StatCard / ClientList / ActivityFeed 等
│ │ │ └── lib/ # API 客户端 + 工具函数
│ │ └── package.json
│ │
│ └── android/ # 移动端 (Kotlin/Compose)
│ ├── app/src/main/java/.../
│ │ └── nativebridge/ # DeviceSnapshotCollector / BackgroundReporter
│ └── build.gradle
│
├── packages/ # 共享包（预留）
├── package.json # Monorepo 根配置
├── pnpm-workspace.yaml # pnpm 工作区
├── turbo.json # Turborepo 任务编排
└── README.md
| 层 | 技术 |
|---|---|
| 桌面端前端 | Solid.js + TypeScript + Vite |
| 桌面端后端 | Tauri 2.0 + Rust (tokio) |
| 管理面板 | Solid.js + Tailwind CSS 4 + Vite |
| 服务端 | Rust (Axum) + SQLite (rusqlite) |
| 移动端 | Kotlin + Jetpack Compose + OkHttp |
| 构建工具 | Turborepo + pnpm workspaces |
Q: 无法获取窗口信息？
前往 系统设置 > 隐私与安全性 > 辅助功能，勾选 ShikenMatrix。
Q: 不受信任的开发者提示？
xattr -d com.apple.quarantine /Applications/ShikenMatrix.appQ: 网易云音乐等应用媒体信息不显示？
部分国内播放器未接入 SMTC。对于网易云，可安装 BetterNCM + InfinityLink 插件修复。
Q: 前台应用检测不到？ 确保已授予 使用情况访问权限。如需更强检测，可授予 Root 权限。
Q: 媒体信息不显示？ 确保已开启 通知监听器权限，这是获取 MediaSession 所必需的。
GNU Affero General Public License v3.0
- Tauri — 跨平台桌面应用框架
- Solid.js — 响应式 UI 库
- Axum — Rust Web 框架
- tokio — Rust 异步运行时
- objc2 / windows-rs
- MediaRemote-rs — macOS 媒体控制绑定