WispTerm

DeepSeek 优先的 Agent 会话

在 WispTerm 里完成 Agent 工作

打开一个原生 AI Agent 标签，让它读取终端上下文、运行本地 PowerShell 或 cmd 工具、配合 WSL/SSH 会话、加载本地 Skills，并把工具确认留在终端 UI 内。

配置 DeepSeek Agent 工具

理解终端现场的 AI

WispTerm 把 Agent 工作留在你已经打开的 Shell 状态旁边。它不需要额外的浏览器工作区，就能理解标签、分屏、本地命令、WSL 和 SSH 会话。

DeepSeek V4 Profile

默认 Profile 面向 OpenAI 兼容的 Chat Completions，Base URL 为 https://api.deepseek.com，模型为 deepseek-v4-pro。需要更轻快时可使用 deepseek-v4-flash。

理解终端的工具

Agent 工具可以列出可见终端 surface，选择目标标签或面板，运行本地命令，并向当前 REPL、WSL 或 SSH 上下文输入内容。

带确认的执行

当权限为 confirm 时，工具请求会先显示在 WispTerm 中再执行。只有在可信任务和可信工作区中，才建议切到 full。

可恢复的对话

Agent 会话会持久化保存。可以在命令面板中用 Select Agent History 恢复，也可以在 AI 标签的左侧栏查看历史。

Markdown 导出

运行 Export AI Chat Markdown 可保存完整对话；运行 Export AI Chat Markdown Clean 会只保存用户输入和最后结果，不包含 thinking 或工具细节。WispTerm 会弹出保存对话框，并复制保存路径。

配置 DeepSeek V4

按 CtrlShiftT 打开会话启动器，选择 AI Agent，然后填写 AI Profile。如果还没有 Profile，WispTerm 会在首次启动 Agent 前先打开配置表单。

推荐 Agent Profile

Profile nameDeepSeek
Base URLhttps://api.deepseek.com
API key你的 DeepSeek API Key；如果设置了 DEEPSEEK_API_KEY，可以留空
Modeldeepseek-v4-pro
Protocolchat_completions；OpenAI Responses API Provider 使用 responses
Thinkingenabled
Effort重度编码 Agent 建议 max；WispTerm 内置默认值是 high
Streamfalse
Agenttrue

环境变量 API Key

当 Profile 的 Base URL 指向 DeepSeek，并且 Profile 内没有保存 API Key 时，WispTerm 会从进程环境中读取 DEEPSEEK_API_KEY。

# Windows（PowerShell）
$env:DEEPSEEK_API_KEY = "sk-your-deepseek-api-key"
# 持久保存：
[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY","sk-your-deepseek-api-key","User")

# macOS / Linux（Shell）
export DEEPSEEK_API_KEY="sk-your-deepseek-api-key"
# 持久保存：将上面一行加入 ~/.zshrc 或 ~/.bashrc

DeepSeek V4 模型提供 1M 上下文，并通过 thinking 与 reasoning_effort 支持思考模式。Chat Completions 仍是默认协议；Responses Profile 会使用 instructions、input 和 Responses 风格函数工具。

Agent 工具与边界

Agent 可以辅助本地工作，同时不会混淆它正在控制哪个终端。WispTerm 要求写入类工具先明确选择目标 terminal surface。

本地命令

Shell 命令会尽量作为隐藏的后台子进程运行，因此执行工具时不会弹出额外控制台窗口。Windows 上使用 powershell_exec，macOS/Linux 上使用 shell_exec。

WSL 与 SSH 路由

Agent 可以检查可见终端 surface，用 ssh_profile_save 保存 WispTerm SSH profile，并把写入路由到选中的 WSL 或 SSH 会话，而不是只依赖当前焦点猜测。

明确选择终端

工具调用会使用 terminal_list 返回的 surface ID。写入前，Agent 会通过 terminal_select 明确目标。

权限模式

日常使用建议保持 ai-agent-permission = confirm。只有在你信任任务和当前工作区时，再使用 full。

# AI Chat Agent 工具
ai-agent-enabled            = true
ai-agent-permission         = confirm   # confirm | full
ai-agent-command-timeout-ms = 60000
ai-agent-output-limit       = 16384

Skills 与快速入口

Skills 可以把可复用指令放在终端旁边。它们会被加载到下一次请求，并作为可重放上下文保存进聊天历史。

Skill 搜索位置

WispTerm 会在平台配置目录（Windows：%APPDATA%\wispterm，macOS：~/Library/Application Support/wispterm）的 skills/ 和 plugins/skills/ 子目录，以及可执行文件同级和当前工作目录下发现 SKILL.md。

加载 Skill

在 AI Agent 标签中输入 $skill-name your request，即可为下一次请求加载指定 Skill，不需要改全局配置。

Slash Commands

/skills 列出已发现 Skills，/commands 列出本地 AI 命令，/reload-skills 让后续 Skill 调用从磁盘重新读取。

命令面板入口

按 CtrlShiftP 后运行 New Agent 可直接新开 Agent；运行 Select Agent History 可恢复历史会话，也可以从当前 AI 标签导出 Markdown 记录。

故障排查

Missing API key

启动 WispTerm 前设置 DEEPSEEK_API_KEY，或把 API Key 保存到 AI Profile。

认证或余额错误

遇到 401 时检查 API Key 和 Base URL。遇到付费相关错误时，检查 DeepSeek 开放平台余额。

工具没有执行

确认 Profile 的 Agent 字段是 true，并在权限为 confirm 时确认工具卡片。

模型别名

请使用当前 DeepSeek V4 模型 ID，例如 deepseek-v4-pro 或 deepseek-v4-flash，不要继续依赖旧别名。

参考：DeepSeek 模型详情 与 DeepSeek 思考模式。