内容
="center">
# 专注默认私密的专注系统，帮助将有意义的计划转化为完成的工作。**
[简体README.zh-CN.md) · [安装快安装) · [商](docs/AI_PROVIDERS.md) · [本地 MCP](docs/MCP.md [远程 MCP](docs/REMOTE_MCP.md)
</div>
专注屏幕，带有活动计时器、每日统计数据和docs/assets/focuswith-overview.jpg)
专注助手将模糊的目标、项目、任务和专注的会话。它保持核心循环简单：件事，开始， 分心时返回，完成，然后决定接下来做什么。
Telegram 和 AI 密钥即可运行。核心是一个自托管的 Web 应用程序；可选的适配器 AI 伴侣、M、Telegram 按钮、iPhone 快捷方式事件、Android 使用器伴侣和本地 macOS 浮动计时器。
面随中文浏览器任何时候在简体中文和英文之间切换。选择仅在该浏览器中存储。
> **公开预览：** 专注助手目前是一个单一所有者的 `0.x` 项目。在升级前请备份数据，并在批准 AI 工具操作之前查看它们。
## 为什么选择专注助手
- **默认私密。** 本地安装绑定到 `127.0.0.1`；公共 MCP 是可选的，并受 OAuth 保护。
- **计划变成你可以做的事情。** 组织方向 → 项目 → 任务，或粘贴由 AI 聊天生成的 Markdown 计划。
- **循环不会在计时器处停止。** 专注助手记录会话，合并同一任务上的重复工作，将未完成的工作向前推进，并建议下一步行动。
- **AI 是可选的，不是所有者。** 单独使用应用程序，添加提供商，或通过 MCP 连接现有的 Claude/Codex 兼容客户端。
- **分心提醒有上下文。** 手机事件可以链接到活动会话，具有宽限期、惩罚次数、提醒和用户定义的后果。
## 功能
方向、项目、可行任务项目分配。
- 简体中文和英文界面，自动浏览器和持久语言切换。
-计划导入，带有持续时间解析和休息识别。
- 番茄工作法、深度专注、自由专注和计时会话，自定义持续时间。
- 暂停、恢复、完成、取消、完成和放弃流程。
- 每日和每周统计；重复的会话合并为一个活动总数。
- 可编辑的监控应用策略、宽限期、惩罚次数和后果池。
- 浏览器通知和可选的 Telegram 交付，带有操作按钮。
- iPhone 快捷方式事件摄取和每日应用使用情况摘要。
- Android 使用事件同步，持久计时器通知和可选的浮动胶囊。
- 使用 OpenAI 响应、Anthropic 或 OpenAI 兼容 API 的内置伴侣，包括兼容的本地端点。
- 用于 Claude Desktop/Code、Codex 和其他本地客户端的七种注释 MCP 工具。
- 可选的 OAuth 保护的远程 MCP，用于 Claude.ai 和兼容的 ChatGPT 工作区，具有自动清理 VPS HTTPS 部署。
- 使用命令行工具构建的本地 macOS 浮动计时器；不需要完整的 Xcode。
- 本地安装程序和 Docker Compose 部署。
## 最快安装
将此存储库交给编码代理，并要求它安装专注助手。确切的提示和安全合同在 [docs/A.md](docs/AI_INSTALL.md) 和 [AGENTS.md](AGENTS.md) 中。
手动安装需要 Python 3.11 或更新版本：
```bash
./scripts/install.sh
./scripts/focus start
```
打开 `http://127.0.0.1:8765`。在本地主机上，浏览器连接时无需复制生成的 API 令牌。
有用
```bash
./scripts/focus status
./scripts/focus doctor
./scripts/focus logs
/focus stop
```
选 AI 和 MCP
侣，编辑忽略的 `.env` 文件并重启专注助手。完整的提供商配方docs/AI_PROVIDERS.md](docs/AI_PRO.md) 中。
```dotenv
FOCUS_AI_PROVIDERropic
FOCUS_AI_API_KEY=your-provider-keyOCUS_AI_MODEL=your-model-name
```
对于 DeepSeek、GLM、本地模型或其他兼容服务：
```dotenv
FOCUS_AI_PROVIDER=openai-compatible
FOCUS_AI_API_KEY-provider-key
FOCUS_AI_MODEL=your-model-name
_AI_BASE_URL=https.example/v1
```
提供保留在服务器上，发送到浏览器 JavaScript使用现有的 AI 客户端 [docs/MCP.md/MCP.md) 中连接服务器。Claude.ai 和符合条件的 ChatGPT 工作区docs/REMOTE_MCP.md/REMOTE_MCP.md身份验证远程 MCP。远程 HTTPS、OAuth 发现、动态客户端注册、S256、旋转刷新令牌、严格的回调允许列表和撤销默认禁用。
## 可
- macOS 浮器：`./macos/FocusFloat/install.sh`
- iPhone 快捷方式：[docs/IPHONE_SHORTCUTS.md](docs/IPHONE_SHORTCUTS.md)
- Android 伴侣：[docs/ANDROID.md](docs/ANDROID.md)
- 签名 Android 下载：[GitHub Releases](https://github.com/sayhi2e10414-cocus-with/releases)
- `.env` 中设置 `FOCUS_TELEGRAM_BOT_TOKEN` 和 `FOCUS_TELEGRAM_CHAT_ID`，然后重启。
Telegram 是一个交付适配器，而不是 Focus 会话的所有者。计时器完成和分心事件由专注助手创建，然后传递给浏览器和任何启用的通道。
## Docker 和远程 MCP
本地 Docker 部署：
```bash
./scripts/setup
docker compose up -d --build
```
Compose 默认到 `127.0.0.1:8765`，并将数据库存储在命名卷中。
对于专用公共主机.ai 连接器在干净的 Docker VPS 上：
./scripts/deploy_remote.sh --domain focus.example.com
```
脚本拒绝替换端口 80/443 上现有的服务。有关条件、现有代理模式、Claude 连接步骤、密码轮撤销命令，请参见 [REMOTE_MCP.md](REMOTE_MCP.md)。
- 默认服务器绑定到.0.0.1`。
- 单独的随机令牌保护主 API 和电话事件端- 运行时数据、`.env`、日志、生成的被 Git 忽略。
- API/提供商令牌不嵌入 JavaScript、文档、MCP 配置或 macOS。
- 远程 MCP 无法仅使用其 OAuth 配置的一半 远程 MCP盐的所有者密码哈希的回调允许列表、PKCE、范围界定的绑定持有者令牌、轮换和撤销。
-持有者令牌、刷新令牌、授权代码票据和 CSRF 神器仅存储为哈希。
专注助手暴露在 localhost 之外之前，请阅读 [SE](SECURITY.md)。
```bash
python3.12 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
.venv/bin/pytest -qmacos/FocusFloat/build.sh
```
服务器 API 在运行时记录在 `/docs` 中。在 [MIT License](LICENSE) 下欢迎贡献；请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 致谢
由 [@sayhi2e10414-cpu](https://github.com/sayhi2e10414-cpu) 创建，与 Openx 共同构建。
