ADHD Progress Hub 旨在为 coding agents（如 Cursor、Codex、Claude Code 等）提供一个自托管的“真相源”，用于追踪半途而废的计划、迁移和设置。它灵感来自 claude-adhd，项目本身与工具无关，通过 MCP over Streamable HTTP（可选本地 stdio 传输）和 REST 接口暴露能力，并可选集成 OpenClaw 通知及本地对话记录索引器（仅生成摘要）。
主要用途与能力：
- 管理 Threads（工作项）：分为 open / blocked / done / dismissed 状态。
- 维护 Progress wiki：在 data/wiki/projects/<slug>/PROGRESS.md 中记录进度。
- 重叠检查：判断是否即将重复已完成一半的工作。
- 提醒：支持 once / session / daily / random 频率。
- OpenClaw 桥接（可选）：在离开 IDE 时提供聊天提醒和记忆同步。
使用方式与部署： 推荐使用 Docker Compose 与已发布镜像进行持久化服务器安装。也支持使用 uv 从源码运行、本地 MCP over stdio 模式（仅使用 MCP 工具，不启动 REST API、仪表板或后台调度器）。已发布镜像位于 ghcr.io/uniskela/adhd-hub:latest 或指定 X.Y.Z 标签。仓库自带 Compose 文件可构建当前检出。 MCP 端点：持久/共享传输使用 http://<host>:8787/mcp；本地子进程传输使用 adhd-hub mcp-stdio。REST 文档在 http://<host>:8787/docs，UI 在 http://<host>:8787/ui/。
适用场景： 在 Proxmox 迁移、homelab 设置或重构等工作中跨多个客户端（Cursor Cloud、Dev LXC、Windows 等）延续任务，避免遗忘半完成的对话。适合希望集中管理分散的 coding agent 进度的开发者。
限制与注意事项：
- 默认存储为 SQLite + markdown wiki，数据位于 data/ 目录。
- 需设置认证令牌（bearer token），/ui/ 支持独立仪表板密码；浏览器会话使用 12 小时 HttpOnly SameSite=Strict cookie，CLI/MCP 使用 bearer 认证。
- 远程访问需通过反向代理或隧道，并配置 HTTPS；建议仅绑定 127.0.0.1 或 Tailscale，不要公开暴露。
- 环境变量更改需重启，Web UI 更改立即生效。
- 详细安装指南、环境变量参考、OpenClaw 设置、forge 同步等请参阅官方文档。
