back
loading skill details...
基于DeepSeek官方API的中文对话助手，支持通用对话、代码生成、基础推理及错误处理，适合个人开发者低成本集成。
---
slug: deepseek-assistant-free
name: deepseek-assistant-free
version: 1.0.0
displayName: DeepSeek助手(免费版)
summary: 基于DeepSeek API的中文对话助手，支持通用对话、代码生成与基础推理能力。
license: Proprietary
edition: free
description: DeepSeek 助手免费版是一个基于 DeepSeek 官方 API 的中文对话辅助工具，帮助开发者以极低成本接入大模型对话、代码生成与基础推理能力。核心能力：提供三种模型选择指引（通用对话、代码生成、深度推理）、单轮与短多轮对话模板、基础错误处理与重试策略、Token
用量预估参考。Use when 需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于需要100%确定性的关键决策。
tags:
- AI对话
- 集成工具
- API接入
- 免费版
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: L3
pricing_model: per_use
suggested_price: 29.9
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# DeepSeek 助手（免费版）
## 概述
DeepSeek 以极高的性价比提供中文优化的对话、代码与推理能力，是个人开发者与小型项目接入大模型的理想选择。本助手将 API 调用流程整理为结构化指南，帮助你在 5 分钟内完成首次对话调用。
免费版覆盖**日常使用最高频的场景**：模型选择、单轮对话、代码生成、基础错误处理。
## 核心能力
### 能力一：模型选择指引
DeepSeek 提供三种主力模型，各有侧重：
| 模型 | 定位 | 适用场景 | 相对成本 |
|---|---|----|----|
| deepseek-chat | 通用对话 | 问答、写作、翻译 | 低 |
| deepseek-coder | 代码专用 | 代码生成、补全、解释 | 低 |
| deepseek-reasoner | 深度推理 | 数学、逻辑、复杂分析 | 中 |
**输入**: 用户提供能力一：模型选择指引所需的指令和必要参数。
**处理**: 解析能力一：模型选择指引的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力一：模型选择指引的响应数据,包含状态码、结果和日志。
### 能力二：对话请求模板
提供可直接复用的 HTTP 请求与脚本模板，支持单轮对话与短上下文多轮对话。
**输入**: 用户提供能力二：对话请求模板所需的指令和必要参数。
**处理**: 解析能力二：对话请求模板的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力二：对话请求模板的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作
### 核心功能执行
用`input_params`参数进行配置。
**输入**: 用户提供核心功能执行所需的指令和必要参数。
**处理**: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回核心功能执行的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：API、的中文对话助手、支持通用对话、代码生成与基础推、理能力、助手免费版是一个、的中文对话辅助工、帮助开发者以极低、成本接入大模型对、核心能力、提供三种模型选择、单轮与短多轮对话、基础错误处理与重、试策略、Token、用量预估参考、Use、when、模型调用、智能对话、Agent、LLM、应用时使用、不适用于需要、确定性的关键决策等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。
## 错误处理
覆盖 API 限流、密钥无效、请求超时、响应格式异常等常见错误的处理策略。
**输入**: 用户提供错误处理所需的指令和必要参数。
**处理**: 解析错误处理的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回错误处理的响应数据,包含状态码、结果和日志。
### 能力四：Token 成本预估
提供输入/输出 Token 计费参考，帮助预估调用成本。
**输入**: 用户提供能力四：Token 成本预估所需的指令和必要参数。
**处理**: 解析能力四：Token 成本预估的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力四：Token 成本预估的响应数据,包含状态码、结果和日志。
### 错误场景2
检查`error_code`并按照处理方式进行排查。
### 错误场景3
## 使用场景
### 场景一：个人项目接入 AI 对话
独立开发者在个人博客或工具中加入 AI 问答功能，使用 deepseek-chat 模型以极低成本提供服务。
### 场景二：代码辅助
开发者使用 deepseek-coder 模型生成函数、解释代码、查找 Bug，提升编码效率。
### 场景三：学习大模型 API
初学者通过本助手的模板与示例，快速理解大模型 API 的请求结构与响应格式。
## 快速开始
### 第一步：配置 API Key
## 输入格式
| 参数名 | 类型 | 必填 | 说明 |
|:-----|:-----|:-----|:-----|
| input | string | 是 | DeepSeek助手(免费版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
```bash
# 设置环境变量（切勿硬编码到代码中）
export DEEPSEEK_API_KEY=sk-your-key-here
```
### 第二步：发送首次对话
```bash
# 使用 curl 快速测试
curl https://api.deepseek.com/v1/chat/completions \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好，请用一句话介绍你自己"}]
}'
```
### 第三步：使用脚本模板
```javascript
// chat.js - 最小可用脚本
const apiKey = process.env.DEEPSEEK_API_KEY;
// ...
async function chat(message) {
const resp = await fetch('https://api.deepseek.com/v1/chat/completions', {
method: 'POST',
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'deepseek-chat',
messages: [{ role: 'user', content: message }]
})
});
// ...
if (!resp.ok) {
throw new Error(`API 错误: ${resp.status} ${resp.statusText}`);
}
// ...
const data = await resp.json();
return data.choices[0].message.content;
}
// ...
// 命令行调用
chat(process.argv[2]).then(console.log).catch(console.error);
```
#
## 示例
### 多轮对话模板
```javascript
// 维护对话历史
const messages = [
{ role: 'system', content: '你是一个专业的编程助手' },
{ role: 'user', content: '什么是闭包？' }
];
// ...
// 后续追加 assistant 回复和新的 user 消息
// messages.push({ role: 'assistant', content: reply });
// messages.push({ role: 'user', content: '给个JavaScript示例' });
```
### 模型切换
```javascript
// 代码场景使用 coder 模型
const codeModel = 'deepseek-coder';
// ...
// 复杂推理使用 reasoner 模型
const reasonModel = 'deepseek-reasoner';
```
## 最佳实践
### 实践一：密钥通过环境变量管理
永远不要将 API Key 写入代码或提交到版本库，统一通过环境变量注入。
### 实践二：设置合理超时
网络请求应设置超时（建议 30-60 秒），避免长时间挂起。
### 实践三：错误分类处理
| 错误类型 | HTTP 状态码 | 处理策略 |
|---:|---:|---:|
| 密钥无效 | 401 | 检查环境变量配置 |
| 请求格式错误 | 400 | 检查 JSON 结构与字段名 |
| 限流 | 429 | 等待后重试，指数退避 |
| 服务端错误 | 5xx | 重试 2-3 次，仍失败则降级 |
### 实践四：按场景选模型
通用对话用 chat、代码用 coder、复杂推理用 reasoner，避免"一刀切"用最贵模型。
### 实践五：控制上下文长度
多轮对话的历史消息会持续消耗 Token，超出窗口后截断早期消息或做摘要压缩。
## 常见问题
### Q1：API Key 在哪里获取？
访问 DeepSeek 官方平台注册账号，在控制台的 API 管理页面创建密钥。密钥以 `sk-` 开头。
### Q2：调用费用大概是多少？
DeepSeek 定价极低，输入约 0.27 元/百万 Token，输出约 1.10 元/百万 Token。一次普通对话（约 500 Token）成本不到 0.001 元。
### Q3：中文效果好不好？
DeepSeek 对中文理解优秀，特别适合中文问答、写作与翻译场景，在中文基准测试中表现处于第一梯队。
### Q4：出现 429 限流怎么办？
免费额度或并发过高会触发限流。处理方式：降低请求频率、实现指数退避重试、升级到付费额度。
### Q5：reasoner 模型为什么响应慢？
deepseek-reasoner 会执行多步推理链，生成时间显著长于 chat 模型。仅在对推理深度有要求时使用。
## 依赖说明
### 运行环境
- **Agent 平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux
- **运行时**: Node.js 18+ 或 Python 3.8+ 或任意支持 HTTP 的环境
### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:---:|:---:|:---:|:---:|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| DeepSeek API Key | 凭据 | 必需 | DeepSeek 官方平台注册获取 |
| Node.js / Python | 运行时 | 可选 | 官方网站下载 |
| curl | 工具 | 可选 | 系统自带或安装 |
### API Key 配置
- **DeepSeek API Key**: 通过环境变量 `DEEPSEEK_API_KEY` 注入
- **禁止**: 在代码、脚本、SKILL.md 中硬编码 API Key
- **推荐**: 使用 `.env` 文件管理密钥并加入 `.gitignore`
### 可用性分类
- **分类**: MD+EXEC（纯Markdown指令，核心功能需要exec执行HTTP请求）
- **说明**: 基于Markdown的AI Skill，通过自然语言指令驱动Agent调用 DeepSeek API 完成对话任务
## 已知限制
本免费体验版限制以下高级功能：
- 流式响应（SSE）处理（仅专业版提供）
- 函数调用 / 工具调用能力（仅专业版提供）
- 批量请求与并发管理（仅专业版提供）
- 多级缓存与成本优化策略（仅专业版提供）
- 自定义系统提示词模板库（仅专业版提供）
- 用量统计与预算控制面板（仅专业版提供）
解锁全部功能请使用专业版：deepseek-assistant-pro
## 输出格式
```json
{
"success": true,
"data": {
"result": "DeepSeek助手(免费版)处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "deepseek assistant"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
```
don't have the plugin yet? install it then click "run inline in claude" again.