proferai

Profer 是一款本地优先（local-first）的通用 AI Agent 桌面应用，基于 Claude Agent SDK 和 Pi Agent 双运行时构建。它旨在将简单问题交给 Chat，复杂任务交给 Agent，并在强大的本地 AI Agent 能力之上叠加团队协作层。 **核心特性** - **通用 Agent**：基于 `@anthropic-ai/claude-agent-sdk`，支持任务图拆解、子任务依赖编排、流式输出和计划确认，可在 Claude / Pi 双运行时之间切换。 - **协作子 Agent**：将复杂任务并行拆分给多个真实子会话独立推进，完成后汇总结果，全程可见可追踪。 - **定时任务自动化**：支持持久化调度（interval / daily / weekly / monthly），具备运行历史、失败保护和结果复盘功能，适合日报周报、自动检查等无人值守场景。 - **移动端远程接入**：通过本地 HTTP/WS 远程接入电脑端，移动端支持 Chat、设置同步和断线重连（客户端在独立仓库 Profer-pocket，基于 Capacitor Android）。 - **团队工作区**：邀请制团队（Owner / Admin / Member / Viewer 角色权限），支持 Skills 共享市场、文件云端同步和品牌定制。 - **多模型 Chat**：支持多供应商对话、附件解析（PDF / Office / 图片）、Markdown / Mermaid / KaTeX / 代码高亮、并排对比和上下文管理。 - **Skills & MCP**：每个工作区可独立配置 Skills 与 MCP Server，全屏技能视图支持搜索、启用、更新、导入、卸载与团队发布。 - **远程机器人**：支持飞书 / Lark / 钉钉 / 微信桥接，可通过手机或群聊触发本机 Agent 工作流。 - **桌面体验**：自动更新、全局快捷键、快速任务窗口、流式语音输入（豆包）、亮色 / 暗色 / 多款精修主题。 **支持的模型渠道** 支持 Anthropic、DeepSeek、Kimi API、Kimi Coding Plan、OpenAI、Google、智谱 AI、MiniMax、豆包、通义千问以及自定义端点（OpenAI 兼容）。其中 Anthropic 和 Anthropic 兼容渠道支持 Agent 功能，OpenAI、Google 和自定义端点仅支持 Chat。 **技术栈** - 运行时：Bun - 桌面框架：Electron 43 - 前端：React 18 + TypeScript + Jotai - 样式：Tailwind CSS + Radix UI - 富文本 / 图表：TipTap · Beautiful Mermaid · KaTeX · Shiki - 构建：Vite + esbuild + electron-builder - Agent SDK：`@anthropic-ai/claude-agent-sdk@0.3.201`（Claude）+ `@earendil-works/pi-agent@0.82.1`（Pi）双运行时 - 移动端：Capacitor（Android） - 团队后端：Hono + better-sqlite3 + JWT **快速开始** 从 GitHub Releases 下载最新版本，提供 macOS Apple Silicon / Intel 与 Windows 安装包。首次配置需完成环境检查（依赖 Git、Node.js / Bun 及可用 Shell），然后在设置中添加 AI 渠道并选择默认渠道、模型和工作区。团队协作功能需部署轻量级后端服务（Hono + SQLite），可一键部署到任意 Linux 服务器。 **本地开发** Bun workspace monorepo，包含 packages（shared、core、project-core、session-core、ui）、apps（electron、cli）和 server 目录。使用 `bun install` 安装依赖，`bun run dev` 启动开发模式，`bun run typecheck` 进行类型检查，`bun test` 运行测试。 **贡献** 欢迎提交 PR，需遵循项目规范：使用 Bun、状态管理使用 Jotai、TypeScript 禁用 `any`、新增 IPC 时同步修改相关类型和桥接代码。 **许可证** Profer 基于 Proma 开发，社区版采用 AGPL-3.0 协议。