GSD Task Manager：为 AI 智能体提供任务清单的 MCP server

一个隐私优先的艾森豪威尔矩阵，用于决定该做什么、安排什么、委派什么或舍弃什么。

在线应用： gsd.vinny.dev 当前版本： 13.9.2 当前产品： v11 单矩阵外壳、离线优先的本地存储、可选的 PocketBase 同步，以及 GSD MCP 服务器。

v11 包含哪些内容

一个响应式的四象限矩阵，支持拖放移动。
快速捕获、完整任务编辑、搜索、键盘导航，以及可选的内置智能视图。
截止日期、标签、依赖选择，以及循环依赖预防。
归档、仪表盘/回顾分析、同步历史、设置和引导。
本地 IndexedDB 持久化、JSON 导入/导出、离线 PWA 支持，以及用户可控的更新提示。
可选的多设备 PocketBase 同步，支持 Google、Apple 或 GitHub OAuth 以及实时服务器发送事件。
一个单独安装的 MCP 服务器，包含 19 个任务、分析和诊断工具，包括经过验证且支持试运行的写入操作。
浅色和深色 Inkwell“GSD Editorial”主题，以 WCAG AA 作为无障碍底线。

已退役的 v7/v8 界面，如选择模式批量操作、快速设置面板和智能视图固定快捷方式，不属于 v11 外壳的一部分。

隐私与数据保管

仅本地模式是默认设置。任务存储在浏览器的 IndexedDB 中，核心产品不需要后端。清除浏览器数据可能会抹除本地任务，因此请定期导出备份。

云同步明确为可选功能。启用后，任务数据会发送到配置的 PocketBase 服务器；托管配置使用 https://api.vinny.io。自托管说明和静态加密钩子位于 docker/ 下。有关确切的信任和令牌存储姿态，请参阅 SECURITY.md。

使用矩阵

艾森豪威尔矩阵按紧急性和重要性对工作进行分类：

立即执行 — 紧急且重要。
安排 — 重要但不紧急。
委派 — 紧急但不重要。
舍弃 — 既不紧急也不重要。

使用快速捕获字段或按 n 来开始一个任务。使用 Shift+N 打开完整编辑器，/ 进行搜索，? 查看帮助，Option+1 到 Option+4（非 Mac 键盘上为 Alt）来聚焦某个象限。应用内帮助抽屉是快捷键的权威记录。

本地开发

要求：Bun 1.3.14、Node.js 22.22.2+（或 24.15+ 或 26+），以及当前版本的浏览器。bun run 在 Node 上执行包脚本，因此测试、lint 和构建都在你安装的 Node 上运行。

bun install
bun dev

打开 http://localhost:3000。全新的浏览器配置文件会从 /about 开始；使用 Open App 行动号召进入矩阵。本地任务 CRUD 不需要 PocketBase。

规范检查

bun run test
bun run test -- --coverage
bun typecheck
bun lint
bun run quality:shape
bun run license:check
bun audit --audit-level=high
bun run build
bun run test:e2e

使用 bun run test，而不是 bun test；后者会调用 Bun 的内置运行器，而不是 Vitest。Playwright 覆盖 Chromium、Firefox 和 WebKit。可选的已认证 PocketBase 测试装置通过以下命令运行：

bun run test:system:pocketbase

架构

Next.js 16 App Router 静态导出；应用程序为客户端渲染。
React 19、TypeScript、Tailwind CSS 和 Violet Frost Inkwell 令牌。
使用 Dexie/IndexedDB 存储本地数据，使用 PocketBase 进行可选的云同步。
使用 Vitest 进行单元/集成覆盖，使用 Playwright 进行浏览器覆盖。
Bun 工作区，包括 packages/mcp-server/。

从 ARCHITECTURE.md、docs/security-trust-boundaries.md 以及 docs/adr/ 中的架构决策开始。

部署

bun run build 在 out/ 中创建静态导出。
bun run deploy 运行生产部署脚本。生产环境 (gsd.vinny.dev) 是唯一的部署目标；开发部署已于 2026-09-11 停用。
docker/Dockerfile 构建自托管的 Caddy 和 PocketBase 镜像。
cloudfront/response-headers-policy.json 及相关脚本管理生产响应头。

上传制品并不能证明 CDN 或正在运行的容器会提供该制品。请单独验证已部署的 URL。

发布文档检查清单

在更改发布版本或宣布某项功能之前：

将 README 版本与 package.json 进行对比。
在当前 shell 中验证每一项功能声明，而不仅仅是在保留的数据模型或归档的 ADR 中验证。
运行上述规范检查以及生产静态构建。
当发布更改了其声明时，更新 GitHub 发布说明、SECURITY.md 以及信任边界图。
将源代码、测试、构建制品、部署和实时运行时视为彼此独立的证据状态。

贡献与安全

在做出更改之前，请阅读 CONTRIBUTING.md。请通过 SECURITY.md 中的私密流程报告漏洞，而不是公开 issue。

许可证

MIT