ThinkInAIXYZ/deepchat

DeepChat – 开源本地优先的AI代理桌面客户端

是什么 – DeepChat 是一个跨平台桌面应用程序（Windows、macOS、Linux），可让您在本地运行基于LLM的代理。它集成了功能完整的聊天UI和“Tape”系统，记录每一次请求、工具调用和结果，使会话可以暂停、恢复、检查或稍后回放。该客户端可与任何遵循 OpenAI/Gemini/Anthropic API 格式的LLM（如 OpenAI、Gemini、Grok 等云服务）通信，或 通过 Ollama 与本地托管的模型连接。

为何重要 – 大多数AI聊天工具只是薄薄的网页封装，关闭窗口后上下文即丢失，数据存储在云端，或需要同时管理多个独立的应用程序来处理工具、插件和远程机器人。DeepChat 将所有内容保留在您的设备上，为您提供一个统一的管理入口：

• 代理与技能 – 可从文件夹、ZIP 或 URL 安装并启用的可重用“技能”（任务特定指令包），可按对话启用。
• ACP 集成 – 可接入任何 Agent Client Protocol（ACP）兼容的代理（代码助手、任务机器人），并像普通模型一样使用。
• MCP 支持 – 完整支持 Model Context Protocol（MCP）的资源、提示、工具和流传输，内置 Node.js 工具链用于自定义服务。
• 远程控制 – 可将桌面会话绑定至 Telegram、Discord、Feishu/Lark、QQBot 或 WeChat iLink，从而在消息工具中发送命令（/start、/stop、/model 等），而繁重的工作仍保留在您的 PC 上。
• Tape 与 Trace – 结构化、可恢复的完整交互日志，可在“Trace”视图中查看，包括令牌使用量、提供者元数据和工具调用的精确顺序。

主要功能概览

类别	亮点
本地优先UI	多窗口、多标签、Markdown + 代码块渲染（CodeMirror）、图像/Mermaid 支持、工件预览、重试/分叉对话。
模型管理	一处配置数十个云服务提供商（OpenAI、Gemini、Anthropic、DeepSeek 等）和本地 Ollama 模型；无需终端即可下载、启动、停止模型。
技能系统	支持安装/导入/导出技能；内置代码审查、文档处理、PDF/PowerPoint、前端设计、数据表工作、生成艺术等技能包。
ACP 代理	可将任意 ACP 兼容代理作为可选“模型”加载；UI 显示结构化计划、工具调用和终端输出。
远程机器人	支持 Telegram、Discord、Feishu/Lark、QQBot、WeChat iLink 控制——绑定会话、切换模型、回答待处理提示、远程打开桌面UI。
搜索扩展	集成 BoSearch / Brave Search API；可模拟 Google、Bing、Baidu、Sogou 或任何自定义引擎，用于LLM驱动的网络查询。
MCP 工具	支持资源/提示/工具，可流式传输的 HTTP、SSE、stdio、内存内服务，一键 DeepLink 安装自定义服务。
隐私与安全	本地加密存储，可选网络代理，屏幕投影隐藏，代码混淆钩子。
商业就绪	Apache-2.0 许可证，UI 与后端清晰分离，易于嵌入或扩展用于商业产品。

典型使用场景

• 软件开发助手 – 加载“代码审查”技能，附加 ACP 编码代理，让模型编辑、Lint 并提交代码，同时保留完整的变更记录。
• 文档与数据处理 – 启用 PDF 技能，让代理读取、总结或从大文档中提取表格，结果以 Markdown 表格或 XLSX 工件形式渲染。
• 团队级机器人 – 将 DeepChat 会话暴露给 Discord 频道；团队成员可在聊天中请求代理运行脚本、获取数据或生成报告，无需离开聊天。
• 研究与网络增强型问答 – 启用内置搜索扩展；模型可决定何时查询 Google/Bing，检索片段并直接在对话中引用。
• 仅本地机密工作 – 在本地运行 Ollama 模型，将所有提示和输出保留在设备上，同时享受与云服务代理相同的 UI 功能。

快速入门

1. 下载 – 从 Releases 页面获取最新安装包（Windows .exe、macOS .dmg、Linux .AppImage 或 .deb）。
2. 配置模型 – 打开 设置 → 模型提供者，添加 OpenAI、Gemini 等的 API 密钥，或启用 Ollama 并选择本地安装的模型。
3. 添加技能（可选） – 在 设置 → 技能 中点击 安装，指向包含技能包的文件夹/ZIP/URL。
4. 开始对话 – 点击 新建聊天，选择模型或 ACP 代理，开始输入。使用工具栏可附加文件、触发搜索或实时切换技能。
5. 远程控制 – 在 设置 → 远程 中启用消息渠道，按屏幕提示完成配对，然后在该消息工具中输入 /help 查看可用命令。

开发与贡献

• 代码库为 Electron + React 前端，搭配实现 Tape、MCP 和 ACP 层的 Node.js 后端。
• 运行 npm install 后执行 npm run dev 以在开发模式下启动应用。
• 使用 npm run build 构建安装包（提供跨平台脚本）。
• 欢迎通过拉取请求贡献代码；请参阅 CONTRIBUTING.md 了解风格指南及如何添加新技能或 ACP 代理。

许可证 – Apache License 2.0（允许个人和商业使用）。

---

DeepChat 致力于成为现代 LLM 代理的“瑞士军刀”式桌面客户端，为高级用户提供可恢复、可扩展、注重隐私的环境，无需在多个工具间来回切换。