内容
# AI Dock
AI Dock 是一款适用于 Linux 的自然语言桌面代理，它可以将对话式、多步骤的请求转换为本地验证的 MCP 操作。它结合了始终置顶的 GTK 接口、云计划桥接、可选的 Ollama 聊天、持久上下文、确定性的快速路由，以及 17 类系统、桌面、研究、开发和知识工具。
> OpenAI Build Week 2026 提交版本。公共存储库不包含浏览器配置文件、cookie、聊天导出、保险库内容、凭证或机器特定配置。
### 产品导览
| MCP 代理 | 多 AI 流 |
|---|---|
|  |  |
| 控制中心 | 本地 Qwen |
|---|---|
|  |  |
## 为什么存在
桌面自动化通常迫使人们在脆弱的宏和具有过多、 opaque 权限的代理之间做出选择。AI Dock 将理解与执行分开：一个有能力的计划器提出结构化的操作，而本地运行时在工具触摸计算机之前验证模式、明确意图、权限、风险和可观察的结果。
## 亮点
- 自然命令、后续引用、容错实体解析和多命令请求中每个子句的强制覆盖。
- 180 多个可发现的 MCP 工具，涵盖桌面、文件、软件包、开发、研究、文档、媒体、数据、监控、知识和自动化。
- 云规划与本地执行；不受信任的模型输出永远不会直接成为 shell 命令。
- 崩溃安全的操作日志、恢复支持、幂等性检查、有界恢复、撤销记录和确定性世界状态验证。
- Hyprland 工作区感知窗口打开、聚焦、移动、关闭和正常配置文件 Brave 重用。
- 可选的连接大脑 Obsidian 保险库和本地全文知识索引。
- 在清除可见聊天时，不删除长期记忆的持久对话引用。
- 非破坏性的 54 检查回归套件。
## 架构
```text
自然语言请求
|
v
意图合约 + 持久话语状态
|
v
云计划器 / 确定性快速路由
|
v
模式、权限、风险和意图验证
|
v
MCP 能力发现 -> 本地工具执行
|
v
观察效果验证 -> 恢复 / 完成报告
```
参见 [ARCHITECTURE.md](ARCHITECTURE.md) 以获取信任边界和组件映射。
## 支持的平台
演示构建目标为 **CachyOS/Arch Linux、Hyprland、Wayland、Python 3.11+、GTK 4 和 WebKitGTK 6**。许多非桌面 MCP 服务器是可移植的，但桌面/窗口层目前依赖于 Hyprland。
## 快速开始
```bash
git clone https://github.com/Yogesh20256/ai-dock-build-week.git
cd ai-dock-build-week
./install.sh
./ai-dock
```
安装程序创建本地 `.venv`，安装 Playwright，写入可移植的 MCP 配置到 `~/.config/ai-dock/mcp_servers.json`，并安装用户桌面条目。它不会导入浏览器数据或在不备份的情况下覆盖现有配置。
有用的可选软件包包括 `ollama`、`brave`、`obsidian`、`ffmpeg`、`tesseract`、`wl-clipboard`、`imagemagick`、`pandoc`、`libreoffice`、`gh` 和 `uv`。
## 测试
```bash
python power_suite_tests.py
```
该套件检查语法、MCP 发现、自然语言路由、云计划验证、污染 JSON 恢复、多子句合约、任务恢复、机密编辑、世界状态验证、软件身份解析、研究、知识、媒体、监控和系统感知。测试避免破坏性桌面操作。
## 安全性和隐私
- 凭证从任务日志中编辑。
- 变异操作使用结构化的允许列表工具；不会执行任意模型生成的 shell。
- 敏感操作需要确认，明确高风险操作使用确切的确认令牌。
- 文件工具仅限于当前主目录和可选的 `/mnt/shared`。
- 删除路由使用桌面回收站。
- 屏幕访问是可选的，仅在视觉操作需要时捕获。
- 网站桥接使用用户自己建立的会话。不会捆绑凭证。
在启用系统、软件包、浏览器或屏幕控制功能之前，请阅读 [SECURITY.md](SECURITY.md)。
## Build Week 贡献
AI Dock 在活动之前作为早期个人弹出窗口存在。在提交期间，它被有意义地扩展为一个经过验证的代理运行时，具有自适应云规划、MCP 能力发现、多子句意图合约、崩溃安全执行、恢复、世界状态检查、正常配置文件浏览器重用、可移植打包和可重复的电源套件。参见 [BUILD_WEEK.md](BUILD_WEEK.md) 以获取日期范围和 Codex 协作叙事。
## 评委测试
评委可以在不连接个人帐户的情况下评估项目：
1. 在 Hyprland/Wayland 测试帐户上运行 `./install.sh`。
2. 运行 `python power_suite_tests.py` 进行非破坏性后端演示。
3. 启动 `./ai-dock`，打开 MCP 并尝试 `/help`、`show system resources`、`open w2` 或在一次性测试目录内进行文件操作。
4. 保持 **确认风险** 启用。云网站计划器是可选的；确定性和本地验证路径在不登录第三方网站的情况下仍然可测试。
## 许可证
MIT。参见 [LICENSE](LICENSE)。
