Aalis.

外观

plugin-llm-deepseek — DeepSeek LLM 服务 ​

包名: @aalis/plugin-llm-deepseek
源码: packages/plugin-llm-deepseek/src/index.ts

概述 ​

DeepSeek API 的 LLM 提供者：为每个可用模型实现一个 LLMModel（@aalis/api-llm）并注册为 llm 服务条目，支持流式输出、工具调用和思考模式。

插件声明 ​

typescript
export const name = '@aalis/plugin-llm-deepseek';
export const displayName = 'DeepSeek';
export const subsystem = 'llm';
export const provides = ['llm'];
export const reusable = true;
// 不导出 inject：无服务依赖

配置 ​

字段类型默认值说明
apiKeystring必填API Key：DeepSeek API 密钥（secret）。缺失时 apply 直接抛错，插件转 error 态——启动不中断，但本插件不提供任何模型
baseUrlstring'https://api.deepseek.com'API 地址：API 端点完整前缀（官方无版本段）；插件只在其后拼 /chat/completions 与 /models
customModelstextarea''自定义模型：手动添加的模型名称（每行一个或逗号分隔）。用于补充自动发现列表中未出现的模型。与自动发现重复时会提示去重。
modelCapabilitiestextarea''单模型能力覆盖：按行指定某个模型的能力集。有该模型的表项时覆盖插件启发式推断，与 adapter 默认能力仍取并集。 格式：<modelId>: <cap1>,<cap2>,...，每行一条。如：deepseek-chat: chat,tool_calling,streaming
providerCapabilitiesstring''适配器默认能力（逗号分隔）：为本适配器下所有模型额外补充的能力。最终某模型的能力 = 此处能力 ∪ 模型级别能力。例：chat,tool_calling,streaming
timeoutnumber120请求超时 (秒)：LLM 请求超时时间（秒）。思考模式下建议 180-300 秒。0 = 不限制。
temperaturenumber0.7温度：0-2，越高越随机
maxTokensnumber8192最大 Token：单次回复最大生成 token 数
contextLengthnumber131072上下文长度：模型上下文窗口大小
strictToolCallsbooleanfalseStrict 工具调用：启用后所有工具调用将使用 strict 模式，模型输出严格遵循 JSON Schema（参考 api-docs.deepseek.com）
forceJsonOutputbooleanfalse强制 JSON 输出：启用后所有最终回复请求将携带 response_format: {type:"json_object"}，配合角色卡 outputFormat 使用可提升格式遵循率。工具调用阶段不受影响（工具响应走 tool_calls 字段）。需确保 system prompt 中含有 json 字样（启用 outputFormat 的角色卡会自动满足此条件）。
thinkingModeselect'auto'思考模式：控制深度思考。auto 模式下，仅 thinking-capable 模型（v4 / reasoner 等）默认启用思考。enabled/disabled 会覆盖所有模型。
reasoningEffortselect'auto'推理强度：思考模式下的推理强度（v4 模型）。「自动」不发送参数，API 会为普通请求选 high、为 Agent 复杂场景选 max，推荐。

特性 ​

  • 思考模式: 由 thinkingMode 按模型决定——auto 下仅能力集含 thinking 的模型启用，enabled / disabled 覆盖所有模型；请求自带 think 时以其为准。启用时请求体附加 thinking: { type: 'enabled' }，reasoningEffort 非 auto 时同时发送 reasoning_effort；关闭时显式发送 thinking: { type: 'disabled' }。思考内容在非流式响应中通过 reasoningContent 返回，在流式响应中通过 reasoningDelta 逐段返回
  • Strict 工具调用: 启用 strictToolCalls 后，每个工具定义的 function 字段带上 strict: true；关闭时沿用各工具自身声明的 strict
  • SSE 流式解析: chatStream() 解析 SSE 事件流，累积 tool_calls delta
  • 模型发现: 启动时 fetchRemoteModelIds() 请求 /models 获取远端模型列表，与 customModels 合并后为每个模型注册一个独立的 llm 服务条目