GSD Task Manager Vibe 项目

项目简介

GSD Task Manager 是一款隐私优先的艾森豪威尔四象限任务管理工具，由开发者 vscarpenter 开源发布在 GitHub，当前版本 13.9.2。它把"紧急/重要"两维度的决策框架落到一个支持拖拽的四象限画布里：立即去做（Do First）、安排日程（Schedule）、委派他人（Delegate）、直接放弃（Eliminate），通过"先决定、再动手"的工作流，帮助个人与小团队结束"待办事项清单越堆越长"的焦虑。产品以本地存储为默认形态，云同步可关闭，已通过 npm 发布配套的 gsd-mcp-server 包，让任何 AI 智能体（Claude、Codex 等）都能直接读取、新增、调度任务矩阵。

核心功能

1. 响应式四象限矩阵：可拖拽的任务卡片在"重要/紧急"四区间平滑移动，支持快速添加、编辑、检索、键盘导航，并内置智能视图（如"今日重点"等）。
2. 任务结构与依赖关系：每条任务可设置截止日期、标签、依赖项，并内置循环依赖自动阻止机制，避免任务卡死、无法推进。
3. 隐私优先本地存储：使用 IndexedDB（Dexie 封装）保存全部任务数据，支持 JSON 一键导入导出，配套 PWA 离线体验，无需注册即可使用。
4. 可选多端云同步：通过自托管或托管 PocketBase 进行跨设备同步，支持 Google、Apple、GitHub OAuth 与服务器推送事件；不启用时云端零数据上传。
5. MCP 工具集成：独立 npm 包 gsd-mcp-server 暴露 19 个任务、分析、诊断工具，支持预演（dry-run）与参数校验的写入，AI 智能体可在不破坏用户既有工作流的前提下完成任务调度。
6. 辅助能力：仪表盘与复盘分析、归档视图、可控更新提示；明暗双主题，符合 WCAG AA 无障碍基线。
7. 稳健的工程流水线：使用 Bun workspaces 组织 packages/mcp-server 等子包；CI 集成 Vitest 单测、Playwright 三浏览器（Chromium/Firefox/WebKit）覆盖与许可审计。

技术实现

项目基于 Next.js 16 App Router 进行静态导出，前端使用 React 19、TypeScript、Tailwind CSS，并以"紫霜墨水"（Violet Frost Inkwell）作为主题令牌。数据层方面，本地侧使用 Dexie/IndexedDB 以离线优先的方式持久化所有任务；云端侧使用 PocketBase 做可选的多端同步，并支持 Google、Apple、GitHub OAuth 登录。仓库通过 Bun workspaces 组织代码库，主要子包包括 packages/mcp-server，通过 Model Context Protocol 提供 19 个任务、分析、诊断相关工具，写入操作均经过校验与 dry-run 模式，避免破坏既有任务状态。测试方面使用 Vitest 写单元和集成覆盖，使用 Playwright 写浏览器端覆盖，并可选地接入 PocketBase 鉴权做系统级集成测试。仓库还包含 docs/adr/ 记录架构决策、docs/security-trust-boundaries.md 明确本地与云端之间的信任边界、SECURITY.md 说明 token 存储与加密静止策略。生产构建产物为静态文件 out/，部署由 bun run build 与 bun run deploy 脚本共同驱动，目前唯一生产目标是 gsd.vinny.dev。

快速上手

1. 安装 Bun 1.3.14、Node.js 22.22.2+（或 24.15+/26+）以及最新版本浏览器（bun run 会在 Node 上执行脚本）；
2. 克隆仓库并安装依赖：git clone https://github.com/vscarpenter/gsd-task-manager，cd 进入目录后执行 bun install；
3. 启动本地开发环境：bun dev，随后打开 http://localhost:3000，新会话从 /about 进入，点击"打开应用"进入四象限画布；
4. 启用 MCP 集成（让 Claude Code、Codex 等智能体读写任务）：在其他项目执行 bun add gsd-mcp-server，按 npm 页面配置客户端；
5. 配置云同步（可选）：阅读 docker/ 下的自托管说明，自行部署 PocketBase 并填入客户端；
6. 运行质量检查：bun run test、bun typecheck、bun lint、bun audit、bun run build、bun run test:e2e。

适用人群

• 个人开发者：希望用四象限法则约束自己无尽的 TODO，但又拒绝把数据交给云端的人；
• 自由职业者与远程协作者：需要一个跨设备、跨操作系统的本地优先任务中枢；
• AI 编程工具的重度用户：希望让 Claude Code / Codex 这类智能体不只是停留在陪聊层面，而是真实地把待办事项接进来、读得出、改得动；
• 隐私敏感的小团队：希望掌握数据主权，可以自托管 PocketBase、用 OAuth 而不用广告追踪；
• 效率方法论爱好者：想落地执行艾森豪威尔矩阵而不仅停留在读书笔记层级的人。

官方链接

• 仓库：https://github.com/vscarpenter/gsd-task-manager
• 在线应用：https://gsd.vinny.dev
• MCP 包：https://www.npmjs.com/package/gsd-mcp-server
• 安全策略：见仓库 SECURITY.md 与 docs/security-trust-boundaries.md