Uptier

🚀 UpTier

UpTier 是一款桌面待辦應用程序，它結合了簡潔的 Microsoft To Do 風格界面與 Claude AI 的強大功能，可實現智能任務優先級排序。通過模型上下文協議 (MCP)，Claude 能夠分析你的任務，並幫助你專注於最重要的事情。

🚀 快速開始

前提條件

• Node.js 20+（建議使用 LTS 版本）
• pnpm 8+
• Claude Desktop（用於 AI 功能）

安裝

# 克隆倉庫
git clone https://github.com/foxintheloop/uptier.git
cd uptier

# 安裝 pnpm（如果尚未安裝）
npm install -g pnpm

# 安裝依賴項
pnpm install

# 批准原生模塊（canvas、sharp、electron）的構建腳本
pnpm approve-builds

# 重建原生模塊
pnpm rebuild

# 構建包
pnpm --filter @uptier/shared build
pnpm --filter @uptier/mcp-server build

運行應用程序

# 開發模式
pnpm dev:electron

# 生產構建
pnpm --filter @uptier/electron build

Claude Desktop 集成

部署適用於 Claude Desktop 的 MCP 服務器：

# 將 MCP 服務器部署到獨立目錄
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 中可用。

手動配置（備用方法）

如果自動部署不起作用，可以手動將 UpTier 添加到你的 Claude Desktop 配置中：

• 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"]
    }
  }
}

✨ 主要特性

任務管理

• 列表與任務：創建自定義列表、帶有子任務的任務，並組織你的工作。
• 智能列表：內置“今日任務”“重要任務”“計劃任務”和“已完成任務”視圖。
• 標籤：使用彩色標籤對任務進行分類，以便輕鬆過濾。
• 截止日期：設置帶有通知和逾期跟蹤的截止日期。
• 拖放操作：在列表中重新排序任務。

AI 驅動功能

• 智能優先級排序：讓 Claude 分析併為你的任務排序。
• 多種策略：艾森豪威爾矩陣、速贏策略、高影響力策略等。
• 自動建議：獲取 AI 對任務組織的建議。

組織管理

• 目標跟蹤：將任務與目標關聯，並跟蹤進度。
• 優先級層級：三級系統（立即執行、儘快執行、待辦事項）。
• 優先級評分：根據工作量、影響力、緊急程度和重要性對任務進行評分。
• 數據導出：導出數據以進行備份或分析。

多數據庫支持

• 多個配置文件：為工作、個人和項目創建單獨的數據庫。
• 輕鬆切換：從側邊欄切換數據庫配置文件。
• 數據隔離：每個配置文件都維護自己的列表、任務和設置。

專注計時器

• 無干擾模式：全屏計時器覆蓋，幫助你保持專注。
• 靈活的時長：預設選項（30、45、60、90 分鐘）或自定義時長。
• 任務上下文：工作時查看任務標題和備註。
• 鍵盤控制：空格鍵暫停/恢復，Esc 鍵結束會話。

用戶體驗

• 黑暗模式：現代的黑暗主題界面。
• 鍵盤快捷鍵：使用 Ctrl+F（搜索）、Ctrl+N（新建任務）等快速操作。
• 系統托盤：最小化到托盤以便快速訪問。
• 併發訪問：採用 WAL 模式的 SQLite 允許應用程序和 Claude 同時工作。

📚 詳細文檔

架構

uptier/
├── apps/
│   ├── electron/          # 桌面應用程序（React + Electron）
│   └── mcp-server/        # 適用於 Claude Desktop 的 MCP 服務器
├── packages/
│   └── shared/            # 共享類型和數據庫架構
└── pnpm-workspace.yaml

MCP 工具

UpTier 向 Claude 提供強大的工具來管理你的任務：

列表

任務

優先級排序

目標

子任務與標籤

優先級排序策略

當要求 Claude 為你的任務排序時，你可以請求不同的策略：

優先級層級

任務分為三個層級：

• 一級（立即執行）：高影響力、緊急或阻礙其他工作的任務。
• 二級（儘快執行）：重要但不緊急的任務。
• 三級（待辦事項）：優先級較低，未來可能執行的任務。

數據存儲

你的數據存儲在本地：

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

其他數據庫配置文件存儲在同一目錄下，使用自定義名稱。

數據庫使用採用 WAL 模式的 SQLite，允許 Electron 應用程序和 MCP 服務器同時訪問而不衝突。

日誌

應用程序日誌存儲在以下位置：

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

鍵盤快捷鍵

專注計時器快捷鍵

路線圖

• [x] 智能列表（今日任務、重要任務、計劃任務、已完成任務）
• [x] 黑暗模式
• [x] 鍵盤快捷鍵
• [x] 標籤
• [x] 截止日期通知
• [x] 多個數據庫配置文件
• [x] 數據導出
• [x] 列表重命名/刪除
• [x] 專注計時器
• [ ] 重複任務
• [ ] 自定義智能列表過濾器
• [ ] 日曆集成
• [ ] 任務模板
• [ ] 移動伴侶應用程序

故障排除

"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 期間看到關於“忽略構建腳本”的警告，請運行：

pnpm approve-builds

然後選擇需要運行構建腳本的包（canvas、sharp、electron）。

貢獻

歡迎貢獻代碼！以下是開始的步驟：

1. 分叉倉庫。
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. 打開拉取請求。

尋求幫助：macOS 和 Linux 測試

UpTier 目前僅在 Windows 上進行了測試。如果你使用的是 macOS 或 Linux，我們非常希望得到你的幫助來測試並報告任何特定於平臺的問題！

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE。

使用 Electron、React 和 Claude 構建