数据分析人工智能AI 应用AI Agent桌面应用CLIMCP 服务AI 技能【免费下载链接】ChatLabLocal-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具项目地址https://gitcode.com/ChatLab/ChatLab点击查看免费下载ChatLab 是本地优先的 AI 聊天记录分析工具其内置 AI 分析功能需要先接入一个可用的在线大模型服务。本文以 DeepSeek 为例完整讲解从平台注册、充值、创建 API Key到在 ChatLab 内添加模型配置、验证并开始使用的全过程并结合仓库源码说明配置背后的校验逻辑、内置模型目录与扩展方式。读完本文你将能独立完成任意在线模型OpenAI、Anthropic、Gemini、通义千问等在 ChatLab 中的接入与日常用量管理。一、开始之前ChatLab 的 AI 配置入口ChatLab 的所有 AI 相关设置集中在「设置」面板中由 AISettingsTab.vue 承载左侧锚点导航依次包含模型配置、默认模型、语义索引、聊天偏好、提示词设置、预处理、会话管理、导出设置等多个分区。本文涉及的「模型配置」即其中第一个分区对应 AIModelConfigTab.vue 所在目录后续的「语义索引」「默认模型」等能力都依赖此处配置好的模型连接。从源码结构看ChatLab 的 AI 连接配置统一由 Desktop 主进程的 apps/desktop/main/ai/llm/index.ts 提供运行时支撑配置持久化归属openchatlab/node-runtime因此 Desktop、CLI 与 CLI Web 共享同一套配置与行为。也就是说在桌面端配置好模型后其他入口如 CLI 查询、Web 版也能复用同一份 AI 配置。二、第 1 步注册 DeepSeek 开放平台并登录要使用 DeepSeek 的模型首先需要一个 DeepSeek 开放平台账号访问 DeepSeek 官网在首页选择「API 开放平台」对应原文档中的「API Platform」入口完成注册并登录登录后进入开放平台控制台。说明DeepSeek 同时提供免费网页对话Chat与付费 API 两种能力。ChatLab 的内置 AI 分析走的是 API 通道因此必须使用开放平台账号而不是网页版账号。三、第 2 步为 API 账户充值API 调用按 token 计费需要账户内有可用余额在控制台左侧菜单选择「充值」Recharge选择充值方式在线支付或对公汇款与金额完成支付。建议首次充值从较小金额开始——单次聊天记录分析消耗的 token 量有限小额充值即可使用相当长的时间。充值完成后余额会显示在平台的「用量信息」页中。四、第 3 步创建并复制 API KeyAPI Key 是 ChatLab 调用 DeepSeek 接口的凭证在控制台左侧菜单选择「API Keys」点击「创建 API key」Create API key可输入任意标题例如chatlab便于识别创建完成后立即复制该 Key——出于安全考虑多数平台只在创建时完整展示一次请妥善保存。从仓库内置目录 provider-registry.ts 可以看到DeepSeek 的官方控制台地址为https://platform.deepseek.com/api_keys这正是创建 API Key 的入口同时仓库为该 Provider 内置了默认 Base URLhttps://api.deepseek.com/v1说明 ChatLab 默认按 OpenAI 兼容的/v1层级请求 DeepSeek 接口。四、第 4 步在 ChatLab 中添加模型配置这是核心的一步完成 Key 与模型的对接打开 ChatLab点击右下角的「设置」进入「模型配置」分区点击「添加新配置」Add New Configuration在弹出的配置窗口中将上一步复制的 API Key 粘贴到 API Keys 输入框中点击「验证」Verify确认 Key 可用验证通过后点击右下角的「添加」Add配置即保存并生效随后即可使用 AI 功能。4.1 配置表单背后的字段与规则添加配置的交互逻辑集中在 useAIConfigForm.ts从源码可以提取出完整字段语义字段说明备注连接模式preset官方预设/openai-compat第三方兼容/local本地服务切换模式会自动调整 Base URL 与模型来源服务商provider官方预设服务商 ID如deepseek、openai、gemini对应内置 Provider 目录API Key平台生成的密钥本地模式无需 Key保存为sk-no-key-required模型model内置模型目录中的模型 ID或自定义模型选择后展示对应 contextWindowBase URL接口地址预设模式下自动填充服务商默认地址API 格式openai-completions/anthropic-messages/google-generative-ai/openai-responses默认openai-completionsGemini、Anthropic 预设模式下自动切换4.2 验证机制与 Base URL 校验规则点击「验证」时前端会调用useLLMService().validateApiKey()最终落到主进程的 validateApiKey向模型服务商发起一次真实请求以确认 Key 与地址可用。验证通过后才能保存即使验证失败界面也会弹出确认框允许「仍然保存」confirmSaveAnyway分支。值得注意的是 Base URL 校验非常严格。在 validateProviderBaseUrl 中DeepSeekBase URL 必须以/v1结尾且不能包含/chat/completions提示「请填写到 /v1 层级」通义千问同样要求以/v1结尾且使用 DashScope 域名时必须包含/compatible-mode/前端 resolvedApiUrl 还会自动补全/v1前缀与/chat/completions路径后缀最终拼出完整请求地址。这些规则的目的是避免用户把「接口文档示例中的完整 URL」直接粘贴进 Base URL 而导致二次拼接错误。4.3 预设、第三方兼容与本地服务三种模式配置弹窗支持三种连接模式见 connectionModeItems官方预设服务preset选择内置服务商后自动带出默认 Base URL、内置模型列表与对应 API 格式只需填写 API Key第三方兼容服务openai-compat手动填写 Base URL、API 格式与模型可「获取远程模型列表」并一键添加对应fetchRemoteModels流程本地服务local指向本地推理服务例如 Ollama 默认地址http://localhost:11434无需 API Key适用于完全离线的场景。这也与内置目录中 OPENAI_COMPATIBLE 的定义一致——其默认地址即为http://localhost:11434/v1支持自定义模型。五、第 5 步查看余额与用量配置完成后可在 DeepSeek 开放平台左侧的「用量信息」中随时查看账户剩余余额与本月消费月度用量统计图表API 请求次数与 Token 消耗明细。通过定期核对余额与 Token 消耗可以合理规划充值节奏避免 AI 分析功能因余额不足而中断。六、内置模型目录开箱即用的服务商与模型ChatLab 内置了丰富的服务商与模型目录二者分别定义在 provider-registry.ts 与 model-catalog.ts配置弹窗中的模型下拉即由这两个目录驱动通过llmStore.getModelsByProviderId()读取并过滤掉仅用于 embedding/ranking 的模型。内置服务商包括OpenAI、Anthropic、Gemini、DeepSeek、通义千问Qwen、智谱 GLM、Kimi、豆包、硅基流动SiliconFlow、Groq、OpenRouter、xAI、MiniMax以及通用的 OpenAI Compatible。每个服务商均声明了官网、控制台地址、默认 Base URL、认证方式api-key与支持的模型 ID 列表且全部enabledByDefault: true——即无需额外启用填入 Key 即可使用。以 DeepSeek 为例其内置模型为deepseek-v4-pro旗舰、1M 上下文、thinking 与非 thinking 双模式与deepseek-v4-flash快速模型、同样 1M 上下文两者均标注recommendedFor: [chat]能力包含chat、reasoning、function_calling。每个模型定义还携带contextWindow上下文窗口、capabilities能力标签chat / reasoning / vision / function_calling / embedding、statusstable / preview等元数据配置界面会据此展示上下文窗口并过滤不适用的模型。若内置模型不满足需求还可通过「添加自定义模型」手动登记模型 ID 与上下文窗口对应 confirmAddModel或使用「获取远程模型」从服务商接口自动拉取。七、其他模型配置思路与注意事项原文档指出「本文以 DeepSeek 为例其他模型请自行搜索其配置方法」。结合源码其他模型的接入思路完全一致仅需注意以下几点差异OpenAI / Anthropic / Gemini 等官方服务在预设模式下选择对应服务商Base URL 与 API 格式自动切换如 Anthropic 自动使用anthropic-messages格式Gemini 使用google-generative-ai格式只需粘贴各自平台的 API Key通义千问QwenBase URL 必须填写 DashScope 兼容模式地址https://dashscope.aliyuncs.com/compatible-mode/v1层级否则校验会报错OpenRouter / 硅基流动等聚合平台一个 Key 可访问多家模型直接在预设模式中选择对应服务商即可完全本地部署选择「本地服务」模式指向 Ollama 等本地推理服务的 OpenAI 兼容地址可做到无网络、无 Key 使用。八、常见问题排查验证失败提示 Base URL 错误检查是否把完整接口路径含/chat/completions填入了 Base URL正确层级应为https://api.deepseek.com/v1。验证通过但保存被拦截ChatLab 会在保存前再次校验若仍坚持保存可在失败确认框中选择「仍然保存」但后续调用可能报错。模型列表中找不到想要的模型确认服务商已选对若为最新发布的模型可使用「获取远程模型列表」自动拉取并添加到目录。多端配置不同步Desktop、CLI、CLI Web 共享~/.chatlab/ai下的同一份 AI 配置见 apps/desktop/main/ai/llm/index.ts 顶部注释因此在一端配置后无需重复配置。忘记 API KeyDeepSeek 平台通常只展示一次完整 Key若遗失需在「API Keys」中删除重建。结语在 ChatLab 中启用内置 AI 分析本质上是「平台侧获取凭证 软件内登记配置」两步以 DeepSeek 为例依次完成注册、充值、创建 API Key再到 ChatLab 设置中粘贴 Key、验证、添加即可。仓库源码进一步揭示了背后的设计——统一的内置服务商/模型目录、严格的 Base URL 层级校验、三种连接模式与远程模型拉取能力让用户既可以开箱即用地接入主流云服务也可以无缝对接本地推理引擎。掌握这一流程后其余服务商的接入只是「换一个平台、贴一个 Key」的重复操作。赞分享数据分析人工智能AI 应用AI Agent桌面应用CLIMCP 服务AI 技能【免费下载链接】ChatLabLocal-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具项目地址https://gitcode.com/ChatLab/ChatLab点击查看免费下载相关推荐Vector datadog_agent 源实战Datadog Agent 日志、指标、追踪接入与避坑指南Vector datadog_agent 源实战Datadog Agent 日志、指标、追踪接入与避坑指南 你正在用 Datadog Agent 收日志和指标可观测性数据工程数据集成日志分析ToMemo 接入 DeepSeek API 完整指南在 iOS 键盘扩展中配置并调用 DeepSeek 大模型ToMemo 接入 DeepSeek API 完整指南在 iOS 键盘扩展中配置并调用 DeepSeek 大模型 导读 ToMemo 是一款面向 iOS /文档UOS AI 接入 DeepSeek 大模型Deepin 系统 AI 助手的两种模型配置方式详解UOS AI 接入 DeepSeek 大模型Deepin 系统 AI 助手的两种模型配置方式详解 本文基于 awesome deepseek integrat文档上一篇Hoppscotch API测试报告生成指南创建详细测试结果分析的终极方法下一篇TDengine License CenterCLS部署与授权实战指南离线/在线许可、配额槽位与 TSDB/IDMP 接入创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考