Workhorse 是一个本地优先、隐私安全的个人 AI Assistant 工作台。
它不仅仅是一个聊天界面，更是一个集成了 LLM 调度、MCP 工具扩展、自动化任务 (Agent Tasks) 和 定时任务 (Cron Jobs) 的全能效率中心。
- 本地优先 (Local-First)：数据存储在本地 SQLite，配置与敏感信息不出本地环境。
- 模块化扩展 (Modular)：通过 MCP (Model Context Protocol) 协议接入任何外部工具。
- 自动化流水线 (Automation)：支持 Agent 级任务编排与定时调度，解放生产力。
- 开发者友好 (Developer First)：基于 Node.js 全栈，易于二次开发与私有化部署。
- 全能对话：流式输出、现代 Markdown 渲染、代码高亮、数学公式 (LaTeX)、图片预览与重采样。
- 全新视觉 (v2.0+)：深度优化 Dashboard，采用 Glassmorphism (玻璃拟态) 设计风格，极致的视觉密度。
- 端点聚合：支持 OpenAI Compatible、OpenAI、Gemini、OpenRouter 等多种主流模型网关。
- MCP 生态：内置 MCP Marketplace，支持对话式发现并安装 Stdio/SSE 工具，内置
shell_execute安全执行沙箱。 - Agent 引擎：ReAct 循环驱动，支持多步推理、工具决策、长上下文压缩与 Token 预算管理。
- 自动化任务：
- Agent Tasks：预设场景化 Prompt 与工具组合，一键运行。
- Cron Jobs：强大的定时调度系统，支持任务运行历史回溯。
- 频道集成：内置钉钉 (DingTalk) 等 Webhook 支持，可通过命令触发本地任务。
Workhorse 采用现代桌面应用架构，结合了 Web 技术的灵活性与本地系统的强大能力：
graph TD
UI[React 18 + AntD 5] -- HTTP/SSE --> Gateway[Express Gateway]
Tauri[Tauri 2 Shell] -- Spawn --> Sidecar[Node.js Sidecar]
subgraph "Node.js Sidecar Runtime"
Gateway -- Auth/Router --> App[Express App]
App -- Agent Logic --> Engine[Agent Engine]
Engine -- Plugin --> MCP[MCP Manager]
Engine -- Storage --> DB[(SQLite)]
Engine -- Scheduler --> Cron[Cron Runner]
MCP -- Stdio/SSE --> MCPServers[External MCP Servers]
MCP -- Native --> Shell[Built-in Shell Tool]
end
Engine -- OpenAI Protocol --> LLM[Cloud LLMs / Local LLMs]
.
├── server.js # Node sidecar 全量入口
├── server/ # 后端逻辑内核
│ ├── models/ # 核心引擎 (Agent, MCP, Database)
│ ├── routes/ # API 接口路由 (Chat, Skills, Tasks, Cron)
│ └── utils/ # 工具类 (Context Budget, Tokenizer, Prompt Builder)
├── src/ # 前端 React 源码
├── src-tauri/ # Tauri 壳配置与跨平台构建
├── docs/ # 深度设计文档与规格说明
├── data/ # 默认数据存储位置 (~/.workhorse)
└── tests/ # 自动化测试用例 (Vitest)
- Node.js >= 20
- npm >= 10
- Rust (仅在需要打包或修改桌面壳逻辑时)
npm install默认会同时启动前端 Vite 服务、API 网关服务以及 Tauri 桌面壳（推荐）：
npm run dev:tauri如果您只需在浏览器中调试 Web 端：
npm run dev- 前端入口:
http://127.0.0.1:12620 - 网关入口:
http://127.0.0.1:12621
# 构建前端产物
npm run build:frontend
# 构建桌面可执行程序 (macOS 下产出 .app)
npm run build:tauri如果通过 GitHub Releases 下载未签名的 .dmg，拖到 /Applications 后，macOS 仍可能因为 com.apple.quarantine 拦截启动。
最省事的安装方式是用仓库自带脚本自动完成挂载、复制和解除 quarantine：
./scripts/install-macos-app.sh ~/Downloads/workhorse_2.0.1_aarch64.dmg也支持直接传下载链接：
./scripts/install-macos-app.sh https://github.com/TimothyZhang023/workhorse/releases/download/<tag>/workhorse_2.0.1_aarch64.dmg脚本默认安装到 /Applications，必要时会自动使用 sudo。如果你想安装到当前用户目录，也可以传第二个参数：
./scripts/install-macos-app.sh ~/Downloads/workhorse_2.0.1_aarch64.dmg "$HOME/Applications"如果你不想用脚本，也可以手动执行：
xattr -rd com.apple.quarantine /Applications/workhorse.app补充说明：
- 当前 GitHub release workflow 在没有 Apple 签名 secrets 时仍会正常构建 unsigned macOS 包。
- 如果后续补上
Developer ID证书和 notarization 相关 secrets，现有 workflow 会自动切换到签名/公证发布。 - unsigned 包更适合熟悉开发环境的用户，不适合作为面向普通 macOS 用户的“开箱即用”安装体验。
Workhorse 自带完整的可视化配置界面，但也支持通过环境变量进行高级微调：
| 变量 | 默认值 | 说明 |
|---|---|---|
PORT |
12621 |
本地后端 API 端口 |
DB_PATH |
~/.workhorse/chat.db |
SQLite 数据库存放路径 |
WORKHORSE_WORKSPACE_ROOT |
~/.workhorse |
Shell 工具默认的工作根目录 |
GLOBAL_SYSTEM_PROMPT_MD |
空 | 全局系统提示词默认值 |
| 变量 | 默认值 | 说明 |
|---|---|---|
VITE_API_BASE_URL |
空 | 覆盖桌面端默认后端地址 (仅开发环境使用) |
- 单机模式：当前实现默认是单机桌面模式，所有请求自动注入本地用户
local。 - Sidecar 依赖：打包时需确保
src-tauri/sidecar/存在预编译的 sidecar 二进制。 - 网络访问：生产桌面版前端请求默认走
http://127.0.0.1:12621。