Work Review跨平台部署指南：macOS、Windows、Linux完整教程
项目地址: https://gitcode.com/gh_mirrors/wo/Work-Review Work Review是一款功能强大的工作时间跟踪工具，能够自动记录您使用的应用程序、访问的网站以及在每个应用上花费的时间。本指南将详细介绍如何在macOS、Windows和Linux三大主流操作系统上部署和配置Work Review，帮助您轻松开始工作效率分析之旅。
准备工作：环境与依赖
在开始部署前，请确保您的系统满足以下基本要求：
- 操作系统版本：
- macOS 10.15+ (Catalina及以上)
- Windows 10 64位或更高版本
- Linux内核4.15+ (Ubuntu 18.04+, Fedora 30+, Debian 10+)
- 硬件要求：至少4GB内存，100MB可用磁盘空间
- 必要工具：Git、Node.js (v16+)、npm (v7+)
首先克隆项目仓库：
git clone https://gitcode.com/gh_mirrors/wo/Work-Review
cd Work-Review
macOS系统部署步骤
1. 安装依赖与构建
macOS用户需先安装Xcode命令行工具：
xcode-select --install
然后安装项目依赖并构建应用：
npm install
npm run tauri build
构建完成后，可在src-tauri/target/release/bundle/dmg/目录下找到DMG安装包。
2. 系统权限配置
Work Review需要以下系统权限才能正常工作：
- 辅助功能权限：用于跟踪应用使用情况
- 屏幕录制权限：用于活动分类（可选）
安装完成后，首次启动应用时会自动请求这些权限。您也可以手动在 系统偏好设置 > 安全性与隐私 中配置。
3. 验证安装
成功安装后，应用会自动启动并在菜单栏显示图标。点击图标打开主界面，您将看到类似以下的概览面板：
Windows系统部署步骤
1. 安装依赖与构建
Windows用户需要先安装Microsoft Visual Studio C++ 生成工具：
- 访问 Visual Studio下载页面
- 勾选"使用C++的桌面开发"选项并安装
然后在项目目录中执行：
npm install
npm run tauri build
构建完成后，可在src-tauri/target/release/bundle/msi/目录下找到MSI安装包。
2. 防火墙与安全设置
安装过程中，Windows Defender可能会弹出安全警告，请点击"更多信息"并选择"运行 anyway"。安装完成后，应用会自动添加到防火墙例外列表。
3. 开机启动配置
Work Review默认会配置开机启动。如需修改此设置，可在应用内的 设置 > 常规 页面中调整。
Linux系统部署步骤
1. 安装依赖与构建
不同Linux发行版需要安装的依赖略有不同：
Ubuntu/Debian:
sudo apt update
sudo apt install -y libwebkit2gtk-4.0-dev build-essential curl wget libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev
Fedora/RHEL:
sudo dnf install -y webkit2gtk4.0-devel gcc-c++ curl wget openssl-devel gtk3-devel libappindicator-gtk3 librsvg2-devel
然后构建应用：
npm install
npm run tauri build
构建完成后，可在src-tauri/target/release/bundle/deb/（Debian系）或src-tauri/target/release/bundle/rpm/（RPM系）目录下找到对应安装包。
2. 安装与权限配置
Debian/Ubuntu:
sudo dpkg -i src-tauri/target/release/bundle/deb/*.deb
sudo apt install -f # 安装可能缺少的依赖
Fedora/RHEL:
sudo rpm -i src-tauri/target/release/bundle/rpm/*.rpm
Linux用户需要授予应用访问系统活动的权限：
sudo setcap cap_net_raw,cap_net_admin=eip $(which work-review)
基础配置与使用
1. 初始设置向导
首次启动Work Review后，会引导您完成初始设置：
- 选择语言（支持中文、英文、繁体中文）
- 配置数据存储位置
- 设置隐私偏好（哪些应用/网站需要排除跟踪）
2. 接入管理与API配置
Work Review支持通过API与外部工具集成。在 设置 > 接入管理 页面中，您可以配置本地API服务：
默认情况下，本地API服务会在http://127.0.0.1:47831运行，您可以使用生成的token进行身份验证。
3. 工作助手功能
Work Review内置AI工作助手，可以基于您的工作记录提供分析和建议。点击左侧导航栏中的"助手"即可打开：
您可以提问如"我这周主要做了什么？"或"帮我总结一下今天的工作会话"，助手会基于您的使用数据生成回答。
常见问题解决
应用无法启动
- macOS: 检查是否已授予必要权限，或尝试右键点击应用选择"打开"
- Windows: 确认已安装所有系统更新，尝试以管理员身份运行
- Linux: 检查依赖是否安装完整，运行
work-review --debug查看日志
数据不更新
- 确认应用正在运行（系统托盘/菜单栏应有图标）
- 检查是否在"设置 > 隐私"中排除了相关应用
- 尝试在"设置 > 存储"中点击"重新扫描"
性能问题
如果应用占用资源过高，可尝试：
- 在"设置 > 高级"中降低更新频率
- 增加排除跟踪的应用数量
- 清理历史数据（"设置 > 存储 > 清理历史"）
总结
通过本指南，您已经成功在macOS、Windows或Linux系统上部署了Work Review。这款工具将帮助您更好地了解自己的工作习惯，提高时间管理效率。如需更多帮助，请查阅项目中的官方文档或探索应用内的帮助中心。
开始您的工作效率分析之旅吧！Work Review将成为您的得力助手，让每一分钟都更有价值。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
