3 条 pnpm 命令跑通 DeepChat多模型 AI Agent 客户端部署最短路径【免费下载链接】deepchatDeepChat - A smart assistant that connects powerful AI to your personal world项目地址: https://gitcode.com/GitHub_Trending/dee/deepchatDeepChat 是开源的本地 AI Agent 桌面客户端接上任意 OpenAI / Gemini / Anthropic 格式兼容的模型 API或本地 Ollama聊天时就能调用 MCP 工具、跑长任务还能把会话接到 Telegram、飞书里远程控制。客户端基于 Electron 加 VueWindows、macOS、Linux 三平台通用。这篇只讲一件事怎么从空目录到窗口跑起来以及跑通之后最值得懂的三个能力和三个高频坑。环境速查Node 和 pnpm 版本比你想的严格仓库的 engines 字段把要求写死了别拿系统里现成的旧 Node 直接上项要求说明Node.js≥24.18.0 且 25用 nvm / fnm 固定到 24.xpnpm≥10.34.5 且 11npm / yarn 会被 preinstall 脚本直接拦下Git任意新版clone 用网上一些旧教程写 Node 20 就够了那是旧版本的要求以仓库现在的 engines 为准。版本不对的症状通常在 pnpm install 阶段才暴露原生模块编译报错、electron 下载失败、postinstall 卡住——先把版本对齐能省一大圈弯路。从 0 到跑通clone 之后只有 3 条命令git clone https://gitcode.com/GitHub_Trending/dee/deepchat cd deepchat pnpm installpnpm install 会通过 postinstall 自动下载 electron、处理原生依赖这一步最久耐心等。依赖装好后安装 DeepChat Agent 执行工具所需的运行时组件uv Python 工具链、node、rtk 等然后启动pnpm run installRuntime pnpm run devdev 带热重载改完代码保存即刷新不用重启窗口。需要调试主进程时把 dev 换成 pnpm run dev:inspect 会额外打开 9229 调试端口。窗口起来、左侧出现会话列表就算跑通了。第一次进 设置 → 模型服务商填入 API key 或指向本地 Ollama才能真正开始对话。两个平台相关的提醒Windows 下如果 pnpm install 报 EPERM 或符号链接错误打开系统设置里的开发者模式或用管理员终端即可如果你要往仓库提交代码再补一条 pnpm run hooks:install 装上提交规范钩子。想自己打包安装包的build:win / build:mac / build:linux 系列脚本仓库里都有纯开发用不到。核心能力挑三个讲透多模型统一入口云和本地混着用任何 OpenAI / Gemini / Anthropic 格式兼容的服务商都能加进列表——DeepSeek、Moonshot、Grok、OpenRouter 等内置了几十个不在列表里的填 Base URL 加 key 手动加。本地 Ollama 是一等公民模型下载、启动、管理都在应用里完成不用碰终端。多窗口多标签并行切换模型不打断进行中的会话。MCP 工具接入外加三种工具模式MCP模型上下文协议是给模型递工具的标准方式。DeepChat 支持 stdio、SSE、StreamableHTTP 传输也内置了一组 inMemory 工具代码执行、网页检索、文件操作部分 MCP 服务支持点 DeepLink 一键安装不用手写配置。输入框旁边的 高级配置 面板里藏着一个实验能力——工具模式共三档Agent Mode默认档把启用的工具逐个交给模型最直观Code Mode文件、计划等能力收敛到一个代码编排入口run_code给模型的工具面更小但要求 full_access 权限Minimal Mode内置文件工具精简到 exec 和 str_replace_editor其余已启用能力原样保留。 日常用 Agent Mode 就够切模式不会丢已有配置。Code Mode 的边界和限制细节在 docs/features/experimental-tool-modes/spec.md 里写得最细。Agent 会真的动手执行命令DeepChat Agent 自带 exec 命令执行工具。设置 → 通用设置 里有专门的命令 Shell页macOS / Linux 可选 Auto跟随系统默认 Zsh、BashWindows 会列出 PowerShell、Command Prompt、Git Bash、WSL 等可选解释器没装好的会直接标注未安装。选中的 Shell 信息会写进工具描述模型知道自己在什么环境里执行配置下次回复生效。高频卡点速解pnpm install 报 EPERM 或符号链接失败怎么办九成是 Windows 的符号链接权限。打开 设置 → 开发者选项 里的开发者模式重试不行就换管理员终端。macOS 和 Linux 没有这个坑。installRuntime 提示 No module named distutils 怎么办系统 Python 较新、移除了 distutils 导致。装回 setuptools 再重跑一次 installRuntime 即可pip install setuptoolsLinux 下 pnpm run dev 窗口起不来部分桌面环境里 Electron 沙箱会拦启动。仓库预置了对应命令 pnpm run dev:linux自动加 no-sandbox 开关一般直接可用。跑通之后建议接着读 docs/guides/getting-started.md 里的推荐阅读顺序——主进程模块路由和各功能入口都在里面想从手机接管会话去 设置 → 远程 配 Telegram / 飞书即可更多功能文档从 docs/README.md 的目录找。【免费下载链接】deepchatDeepChat - A smart assistant that connects powerful AI to your personal world项目地址: https://gitcode.com/GitHub_Trending/dee/deepchat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考