uptier

UpTier

通过 Claude Desktop 实现由 MCP 驱动的任务管理和智能优先级排序

UpTier 是一款桌面待办事项应用，将简洁的 Microsoft To Do 风格界面与 Claude AI 的强大功能相结合，帮助智能安排任务优先级。借助 Model Context Protocol（MCP），Claude 可以分析你的任务，帮你专注于最重要的事情。

演示

https://github.com/user-attachments/assets/71264f79-3f54-4b45-9d7e-dcef26f54f94

下载

下载适用于 Windows 的 UpTier

提供预构建的安装程序，无需构建。

功能

任务管理

• 列表和任务 - 创建自定义列表和带有子任务的任务，并整理工作
• 智能列表 - 内置「我的一天」「重要」「计划」「日历」「仪表板」和「已完成」视图
• 自定义筛选器 - 使用可视化筛选规则（截止日期、优先级、标签、精力等）创建自己的智能列表
• 标签 - 使用彩色标签对任务进行分类，方便筛选
• 截止日期 - 设置截止日期，并启用通知和逾期跟踪
• 重复任务 - 支持按日、工作日、周、双周和月重复，并可设置结束日期
• 日历视图 - 提供按日、工作周、整周和按月视图，并可安排任务
• 日程规划器 - 按小时划分的时间区块网格，支持拖放安排和 15 分钟间隔吸附
• 每日规划 - 引导式的 4 步规划流程：回顾昨天、创建列表、安排任务、确认计划
• 任务时长 - 为任务设置预估时长，以便在日历中安排时间区块
• 拖放 - 在列表中调整任务顺序，并将任务拖到日历上进行安排

AI 驱动的功能

• 智能优先级排序 - 通过 MCP 让 Claude 分析并排列任务优先级
• 多种策略 - 艾森豪威尔矩阵、快速完成项、高影响力任务等
• 截止日期建议 - 应用内 AI 会根据相似任务和优先级建议截止日期
• 任务拆分 - AI 为常见任务类型生成子任务建议（无需 Claude）
• 风险提醒 - 为可能无法按时完成的任务显示琥珀色和红色警告

组织管理

• 目标跟踪 - 将任务关联到目标，并通过层级支持跟踪进度
• 优先级层级 - 三层优先级系统（立即处理、尽快处理、待办）
• 优先级评分 - 按任务所需精力、影响、紧迫性和重要性进行评分
• 数据导出 - 将数据导出为 JSON（完整备份）或 CSV（任务）

效率与分析

• 仪表板 - 展示完成统计、每周趋势和优先级分布的效率分析
• 连续记录与庆祝效果 - 跟踪每日连续完成记录，并在达到里程碑时显示彩纸庆祝效果
• 专注时间跟踪 - 设置每日专注目标，并在仪表板上跟踪进度
• 功能级别 - 为新用户提供引导向导，包含基础、中级和高级预设

多数据库支持

• 多个配置文件 - 为工作、个人事务和项目创建独立数据库
• 轻松切换 - 在侧边栏中切换数据库配置文件
• 数据隔离 - 每个配置文件都拥有自己的列表、任务和设置

专注计时器

• 免干扰模式 - 全屏计时器覆盖层，帮助你保持专注
• 灵活时长 - 可选择预设时长（30、45、60、90 分钟）或自定义时长
• 任务上下文 - 工作时查看任务标题和备注
• 键盘控制 - 按空格键暂停或继续，按 Esc 键结束会话

用户体验

• 主题 - 深色、浅色、大地深色、大地浅色、赛博朋克和系统主题
• 命令面板 - 使用 Ctrl+K 进行全局搜索和导航
• 键盘快捷键 - 使用 Ctrl+F（搜索）、Ctrl+N（新建任务）、?（帮助）快速操作
• 系统托盘 - 最小化到托盘，方便快速访问
• 并发访问 - SQLite 的 WAL 模式支持应用和 Claude 同时工作

架构

uptier/
├── apps/
│   ├── electron/          # Desktop application (React + Electron)
│   └── mcp-server/        # MCP server for Claude Desktop
├── packages/
│   └── shared/            # Shared types and database schema
└── pnpm-workspace.yaml

组件	描述
MCP 服务	通过 MCP 提供 25+ 个任务管理工具的 Node.js 服务
Electron 应用	使用 React UI 的桌面应用
SQLite 数据库	使用 WAL 模式支持并发访问的共享数据库

开始使用

前提条件

• Node.js 20+（推荐 LTS）
• pnpm 8+
• Claude Desktop（用于 AI 功能）

安装

# Clone the repository
git clone https://github.com/foxintheloop/uptier.git
cd uptier

# Install pnpm (if not already installed)
npm install -g pnpm

# Install dependencies
pnpm install

# Approve build scripts for native modules (canvas, sharp, electron)
pnpm approve-builds

# Rebuild native modules
pnpm rebuild

# Rebuild better-sqlite3 for Electron's bundled Node.js
npx electron-rebuild -f -w better-sqlite3

# Build packages
pnpm --filter @uptier/shared build
pnpm --filter @uptier/mcp-server build

注意： Electron 应用捆绑了自己的 Node.js 运行时（v20.x），这与系统的 Node.js 不同。electron-rebuild 步骤会为 Electron 的版本编译 better-sqlite3。MCP 服务部署（如下）会单独为 Claude Desktop 使用的系统 Node.js 编译它。

运行应用

# Development mode
pnpm dev:electron

# Production build
pnpm --filter @uptier/electron build

Claude Desktop 集成

为 Claude Desktop 部署 MCP 服务：

# Deploy MCP server to standalone directory
pnpm --filter @uptier/mcp-server deploy

这会将 MCP 服务部署到 ~/.uptier/mcp-server/，其中包含独立的 node_modules，并针对当前 Node.js 版本自动完成编译。Claude Desktop 配置也会自动更新。

为何采用独立部署？ Electron 应用使用 Node.js 22（捆绑版本），而 Claude Desktop 可能使用不同版本的 Node.js。独立部署会针对正确的版本编译原生模块（如 better-sqlite3），以避免冲突。

部署后：

1. 重启 Claude Desktop
2. UpTier 工具将在 Claude 中可用

手动配置（替代方案）

如果自动部署不起作用，请在 Claude Desktop 配置中手动添加 UpTier：

Windows： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "uptier": {
      "command": "node",
      "args": ["/path/to/.uptier/mcp-server/index.js"]
    }
  }
}

MCP 工具

UpTier 向 Claude 提供强大的工具来管理任务：

列表

工具	描述
create_list	创建新的任务列表
get_lists	获取所有列表及其任务数量
update_list	更新列表名称、颜色或图标
delete_list	删除列表
reorder_lists	更改列表顺序

任务

工具	描述
create_task	创建带有可选属性的新任务
get_tasks	获取任务并使用筛选选项
update_task	更新任务属性
complete_task	将任务标记为已完成
delete_task	删除任务
bulk_create_tasks	一次创建多个任务
move_task	将任务移至其他列表

优先级排序

工具	描述
prioritize_list	分析任务并获取优先级排序建议
bulk_set_priorities	为多个任务设置优先级等级
get_prioritization_summary	获取任务优先级概览
suggest_next_task	获取关于接下来处理哪项任务的 AI 建议

目标

工具	描述
create_goal	创建目标
get_goals	获取所有目标及其进度
update_goal	更新目标属性
link_tasks_to_goal	将任务关联到目标
get_goal_progress	获取目标完成情况统计

日程规划

工具	描述
get_day_schedule	获取指定日期的已安排任务、未安排任务和空闲时间段
schedule_tasks	将任务安排到日程规划器的时间网格中
unschedule_task	将任务从时间网格移至未安排任务侧边栏

子任务与标签

工具	描述
add_subtask	为任务添加子任务
update_subtask	更新子任务属性
create_tag	创建新标签
get_tags	获取所有标签
add_tag_to_task	为任务添加标签

优先级策略

让 Claude 为任务确定优先级时，你可以指定不同的策略：

策略	适用场景
均衡	一般用途——平等权衡所有因素
紧急优先	以截止日期为驱动的工作
快速见效	通过低投入、高成效的任务积累动力
高影响力	不考虑投入，追求最大成效
艾森豪威尔法	经典的紧急／重要决策矩阵

优先级层级

任务分为三个层级：

• 层级 1（立即处理） - 影响重大、紧急，或会阻碍其他工作的任务
• 层级 2（尽快处理） - 重要但不受时间限制的任务
• 层级 3（待办事项） - 优先级较低、以后再处理或不确定是否处理的事项

数据存储

你的数据存储在本地：

• Windows： %APPDATA%\.uptier\tasks.db
• macOS/Linux： ~/.uptier/tasks.db

其他数据库配置文件以自定义名称存储在同一目录中。

数据库使用 SQLite 的 WAL 模式，Electron 应用和 MCP 服务可同时访问数据库而不会发生冲突。

日志

应用程序日志存储于：

• Windows： %APPDATA%\UpTier\logs\
• macOS： ~/Library/Application Support/UpTier/logs/
• Linux： ~/.config/UpTier/logs/

键盘快捷键

快捷键	操作
Ctrl+K	打开命令面板
Ctrl+N	创建新任务
Ctrl+F	聚焦搜索框
↑ / ↓	浏览任务
Space	切换任务完成状态
Delete	删除选中的任务
Escape	关闭详情面板
?	显示键盘快捷键

专注计时器快捷键

快捷键	操作
Space	暂停／继续计时器
Escape	结束专注时段

路线图

• 智能列表（我的一天、重要、已计划、已完成）
• 主题（深色、浅色、大地、赛博朋克、系统）
• 键盘快捷键
• 标签
• 截止日期通知
• 多个数据库配置文件
• 数据导出与导入
• 重命名／删除列表
• 专注计时器
• 可调整大小的面板
• 循环任务
• 自定义智能列表筛选条件
• 日历视图（天、工作周、整周、月）
• 每日计划仪式
• 效率仪表板与分析
• 连续记录与庆祝
• 截止日期风险提醒
• 功能层级与引导向导
• 带层级结构的目标跟踪
• 任务模板
• 移动端配套应用

故障排除

“Electron uninstall”错误

如果运行 pnpm dev:electron 时看到 Error: Electron uninstall，说明 Electron 二进制文件未下载。运行：

node node_modules/electron/install.js

MCP 服务的原生模块错误

如果 Claude Desktop 显示关于 better-sqlite3 或 NODE_MODULE_VERSION 不匹配的错误，请使用独立部署：

pnpm --filter @uptier/mcp-server deploy

这会在 ~/.uptier/mcp-server/ 创建一个独立的 MCP 服务安装目录，其中的原生模块针对你当前的 Node.js 版本编译，从而避免与 Electron 应用冲突。

如果问题仍未解决，请确保运行部署命令时使用的 Node.js 版本与 Claude Desktop 使用的版本相同（通常为 Node.js 23）。

构建脚本警告

如果在运行 pnpm install 时看到关于“Ignored build scripts”的警告，请运行：

pnpm approve-builds

然后选择需要运行构建脚本的包（canvas、sharp、electron）。

Electron 应用中的“NODE_MODULE_VERSION mismatch”错误

如果 Electron 应用因 NODE_MODULE_VERSION 不匹配而崩溃（例如，出现“was compiled against a different Node.js version”），请针对 Electron 重新构建 better-sqlite3：

npx electron-rebuild -f -w better-sqlite3

这通常发生在升级 Node.js 或运行 pnpm install 后，因为这会针对系统的 Node.js 重新编译原生模块，而非针对 Electron 内置的版本。

Claude Desktop 中的“未找到架构”错误

如果 MCP 服务报告找不到 schema.sql，则已部署的文件已过时。请重新构建并部署：

pnpm --filter @uptier/shared build
pnpm --filter @uptier/mcp-server build
pnpm --filter @uptier/mcp-server deploy

升级 Node.js 后

升级系统的 Node.js 版本后，需要重新编译原生模块：

1. Electron 应用： npx electron-rebuild -f -w better-sqlite3
2. MCP 服务： 重新构建并部署：

   pnpm --filter @uptier/shared build
   pnpm --filter @uptier/mcp-server build
   pnpm --filter @uptier/mcp-server deploy
   

参与贡献

欢迎贡献！以下是开始参与的步骤：

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 进行更改
4. 运行应用进行测试（pnpm dev:electron）
5. 提交更改（git commit -m 'Add amazing feature'）
6. 推送到分支（git push origin feature/amazing-feature）
7. 创建 Pull Request

征集帮助：macOS 和 Linux 测试

目前，UpTier 仅在 Windows 上经过测试。如果你使用 macOS 或 Linux，我们非常希望你能帮忙测试并报告任何特定于平台的问题！

许可证

MIT 许可证 - 详情请参阅 LICENSE。

---

使用 Electron、React 和 Claude 构建