About Work Review

帮你自动记录一天中使用了哪些应用、浏览了哪些网页、在每个应用上花了多少时间

Published by

wm94i

Visit View Profile

Work Review

View on GitHub

Work Review

面向个人的、本地优先的工作记录与复盘工具。

自动整理你一天里使用过的应用、访问过的网站、窗口标题和可选截图记录，生成一条可回看、可追问的工作时间线。

所有数据默认仅保存在本地设备，不上传任何服务器。AI 功能完全可选；关闭后照常使用。

中文 · 繁體中文 · English

License

它适合做什么

Work Review 适合个人用户用来回答这些问题：

我今天到底做了什么？
这几天主要在推进什么？
某个任务大概花了多少时间？
我当时看过哪个页面、哪个窗口、哪些上下文？
今天的日报怎么快速整理出来？

它的重点不是"监督"，而是帮助你回忆、整理和复盘自己的工作过程。

核心特点

自动记录工作轨迹 — 自动整理前台应用、网站访问、窗口标题、可选截图和 OCR 文本，尽量减少手动补记和事后回忆
一条统一的工作时间线 — 概览、时间线、工作助手、日报共用同一份底层记录，既能看统计，也能追到具体页面和上下文
直接回答工作问题 — 基于本地记录回答"今天做了什么""哪个应用用得最多""对比上个月和这个月的效率"等
日报生成与导出 — 结构化日报、历史回看、Markdown 导出与自动导出、AI 增强下的附加提示词和段落级编辑
桌面化身 Beta — 迈向个人工作 Agent 的第一步，未来将成为能感知工作上下文、主动提醒和辅助决策的桌面伙伴
隐私优先，本地可控 — 数据存本地 SQLite；AI 默认可不启用，模型调用使用你自己的 API Key，不经第三方中转

界面预览

工作助手

隐私与边界

Work Review 从设计上面向个人使用，不适用于：员工监控 · 团队考勤 · 绩效考核 · 隐形追踪

你可以按需控制记录范围：

按应用设置为「正常 / 脱敏 / 忽略」，脱敏模式自动跳过截图和 OCR
敏感关键词自动过滤 · 域名黑名单
锁屏自动暂停 · 手动暂停/恢复
AI 仅在你主动配置模型后启用，默认关闭

主要功能

自动记录

自动识别前台应用，记录使用时长、窗口标题和分类
识别浏览器 URL，按站点/页面聚合访问记录
定时截图并提取 OCR 文本，支持多屏策略
键鼠 + 屏幕空闲检测，减少挂机误记
时间线回看某个时段的具体上下文

智能整理

工作助手：基于本地记录做问答，支持多模型切换
支持时长统计、分类筛选、趋势对比等分析能力
自动识别"昨天""本周""最近 N 天"等自然语言时间范围
碎片活动聚合为连续工作 Session
从页面、窗口标题和上下文中提炼可能的后续待办
基础模板与 AI 增强两种回答模式

日报与复盘

生成结构化日报，支持历史回看
Markdown 导出与自动导出
按小时活跃度汇总
AI 增强下的附加提示词与段落编辑
网站语义分类：修改域名分类后自动回填历史
多段工作时间：如上午 + 下午，休息时间不计入

AI 模式

Work Review 的核心始终是本地记录。AI 的作用是让记录更容易阅读和复盘，而不是使用前提。

模式	说明
基础模板	零配置，输出稳定的结构化结果
AI 增强	调用你自行配置的模型服务，让问答和总结更自然

支持的提供商：Ollama (本地) / OpenAI 兼容 / DeepSeek / 通义千问 / 智谱 / Kimi / 豆包 / MiniMax / SiliconFlow / Gemini / Claude

快速开始

从 Releases 下载对应平台安装包
macOS 需授予屏幕录制、辅助功能权限
保持后台运行一段时间
回到概览 / 时间线 / 日报查看当天记录

平台	安装包
macOS (Apple Silicon / Intel)	`.dmg`
Windows	`.exe`
Linux x86_64 (X11 / Wayland)	`.deb` / `.AppImage`
Linux ARM64 (aarch64)	`.deb`

macOS： 截图需「屏幕录制」权限，桌宠联动需「辅助功能 + 输入监控」。首次提示"已损坏"时：sudo xattr -rd com.apple.quarantine "/Applications/Work Review.app"

Windows： 依赖 Microsoft Edge WebView2 Runtime。

Linux： 截图和窗口追踪依赖当前会话类型与工具链。

依赖说明

# 基础
sudo apt install xprintidle tesseract-ocr
# X11
sudo apt install xdotool x11-utils scrot
# Wayland: gdbus (GNOME) / kdotool (KDE) / swaymsg (Sway) / hyprctl (Hyprland)
# 截图: grim / gnome-screenshot / spectacle

Ubuntu 24.04 / 24.10 Wayland (GNOME 46–47) 用户如遇截图闪屏/快门声问题，可使用一键安装脚本自动修复：

bash scripts/deb/reinstall.sh      # deb 方案（推荐）
bash scripts/deb/reinstall.sh --dry-run  # 预览操作

详见 scripts/ubuntu-wayland-README.md。

扩展能力（Beta）

桌面化身

用独立桌宠窗口反馈待机/办公/阅读/会议/音乐/视频等状态。

当前仍在持续完善中，会继续补齐交互联动、表情和预设细节。

Bot 联动（Telegram / 飞书）

通过本地 API + 多设备注册，从 Telegram / 飞书远程查询记录与生成日报。支持命令：/devices、/report、/generate 等。仅限个人和本人多设备联动使用。

Localhost API

应用启动后自动在本地开放 HTTP API（默认 127.0.0.1:47831），鉴权方式为 Bearer Token（首次启动自动生成，保存在数据目录的 localhost_api_token.txt）。

认证

所有请求（/health 和飞书回调除外）需携带 Token：

Authorization: Bearer <token>

或通过 Query 参数：?token=<token>

接口列表

方法	路径	说明
GET	`/health`	健康检查（免鉴权）
GET	`/v1/device`	设备信息
GET	`/v1/timeline/{date}`	时间线（`date` 格式 `YYYY-MM-DD`，支持 `?limit=&offset=`）
GET	`/v1/activities/{date}`	活动列表（支持 `?limit=&offset=&category=`）
GET	`/v1/stats/today`	今日统计
GET	`/v1/stats/overview`	综合统计（`?mode=today
GET	`/v1/stats/daily/{date}`	指定日期统计
GET	`/v1/reports`	日报列表（`?limit=`）
GET	`/v1/reports/{date}`	指定日期日报（`?locale=`）
GET	`/v1/reports/generate`	生成日报（`?date=&locale=&force=true`）
POST	`/v1/reports/export-markdown`	导出日报 Markdown（body: `{ date, locale }`）
GET	`/v1/apps/recent`	最近使用的应用
GET	`/v1/apps/category-overview`	应用分类概览
GET	`/v1/categories`	应用分类列表
GET	`/v1/categories/semantic`	语义分类列表
GET	`/v1/hourly-summaries/{date}`	按小时汇总
GET	`/v1/hourly-app-breakdown/{date}`	按小时应用分布
GET	`/v1/weekly-review`	周报（`?date_from=&date_to=&limit=`）
GET	`/v1/storage/stats`	存储统计

示例

# 获取今日时间线
curl -H "Authorization: Bearer $(cat ~/work-review/localhost_api_token.txt)" \
  http://127.0.0.1:47831/v1/timeline/2026-05-20

# 生成日报
curl -H "Authorization: Bearer $(cat ~/work-review/localhost_api_token.txt)" \
  "http://127.0.0.1:47831/v1/reports/generate?date=2026-05-20"

MCP Server

通过 stdio 协议将工作记录接入 AI 编码工具（Claude Code / Cursor / VS Code Copilot 等）。

cargo build --release -p work-review-mcp-server

{
  "mcpServers": {
    "work-review": {
      "command": "/path/to/work-review-mcp-server",
      "env": {
        "WORK_REVIEW_DB_PATH": "/path/to/work_review.db",
        "WORK_REVIEW_CONFIG_PATH": "/path/to/config.json"
      }
    }
  }
}

开发

npm install
npm run tauri:dev    # 开发
npm run tauri:build  # 构建

要求：Node.js 18+ / Rust stable / Tauri 2 CLI · 技术栈：Tauri 2 + Rust + Svelte 4 + SQLite

社区交流

微信群

微信群

如果二维码失效，关注下方公众号获取最新进群方式，或者进 TG 群吐槽

公众号

公众号

致谢

感谢 linux.do 社区的交流与讨论支持
桌面化身 BongoCat 资源改编自 ayangweb/BongoCat (MIT License)，详见 THIRD_PARTY_NOTICES.md

License

MIT

Work Review

About Work Review

Platforms

Languages

Links

Need Help Installing Work Review?

Work Review

Work Review

它适合做什么

核心特点

界面预览

隐私与边界

主要功能

自动记录

智能整理

日报与复盘

AI 模式

快速开始

扩展能力（Beta）

认证

接口列表

示例

开发

社区交流

致谢

License

历史星标