noteTb: 264

This data as json

id user_id content tags created_at updated_at enable pinned folder_id comment position visibility
264 1 1 # DeepSeek TUI 使用说明书经验 - 版本：1.0.0 - 2026-05-12：goose - 初始撰写 # 事件 1：基本认识 DeepSeek TUI（v0.8.30）是一个终端界面的 AI 助手客户端，通过 DeepSeek API 提供服务。服务器上装了两个二进制文件： - `deepseek`（调度器）— 处理 CLI 命令、配置管理 - `deepseek-tui`（TUI 交互端）— 全屏终端交互界面 ## 解决方法 安装方式 ```bash # 通过 npm 一键安装（推荐） npm install -g deepseek-tui # 或从 GitHub Releases 手动下载 # https://github.com/Hmbown/DeepSeek-TUI/releases # 下载 deepseek-linux-x64 和 deepseek-tui-linux-x64 放到同一目录 ``` ## 坑 两个二进制文件缺一不可 `deepseek` 命令只是一个调度器，遇到 `run`、`exec`、`review` 等交互式命令时会调用 `deepseek-tui`。如果只装了一个，会报错 Companion binary not found。 # 事件 2：基础配置 ## 解决方法 设置 API Key ```bash # 方式一：交互式输入（安全，不回显） deepseek auth set --provider deepseek # 方式二：环境变量 export DEEPSEEK_API_KEY="sk-你的key" # 方式三：配置文件 ~/.deepseek/config.toml # api_key = "sk-你的key" # model = "deepseek-v4-pro" ``` ## 解决方法 查看配置状态 ```bash deepseek config list # 列出配置 deepseek auth status # 查看认证状态 deepseek doctor # 运行诊断，检查 API 连接 ``` ## 坑 配置文件的路径 配置文件路径是 `~/.deepseek/config.toml`，不是 `~/.config/deepseek/config.toml`。 # 事件 3：日常使用命令 ## 解决方法 CLI 直接问答 ```bash # 单次提问 deepseek "用 Python 写一个快速排序" # 带自定义模型 deepseek --model deepseek-v4-flash "解释一下 SQLite 的 WAL 模式" # 纯文本输出（不渲染 Markdown） deepseek --output-mode text "列出当前目录文件" ``` ## 解决方法 TUI 全屏交互 ```bash # 启动全屏终端交互界面，支持会话、工具调用 deepseek # 或 deepseek run ``` ## 解决方法 非交互式执行 ```bash # exec 模式下 AI 可以调用工具、执行命令、读写文件 deepseek exec "检查一下服务器磁盘空间" deepseek --yolo exec "部署到服务器" # YOLO 模式自动批准所有操作 ``` # 事件 4：会话管理 ## 解决方法 列出和恢复会话 ```bash # 列出已保存的会话 deepseek sessions # 恢复某个会话（继续之前的对话） deepseek resume abc123 # 从某个会话分支新对话 deepseek fork abc123 ``` ## 解决方法 查看用量统计 ```bash # 查看最近 7 天用量 deepseek metrics --since 7d # JSON 格式输出 deepseek metrics --since 30d --json ``` # 事件 5：代码审查功能 ## 解决方法 Code Review ```bash # 审查当前 git 仓库的未提交变更 deepseek review # 审查某次 commit git diff HEAD~1 HEAD | deepseek review # 审查并生成补丁 git diff | deepseek review --apply ``` ## 解决方法 Apply 补丁 ```bash # 应用补丁文件 deepseek apply < patchfile.patch # 从标准输入 git diff | deepseek apply ``` ## 坑 review 需要 git 仓库 `deepseek review` 必须在 git 仓库内运行，读取 git diff 作为审查上下文。 # 事件 6：MCP（Model Context Protocol）服务 ## 解决方法 管理 MCP ```bash # 初始化 MCP 配置（创建 ~/.deepseek/mcp.json） deepseek mcp init # 以 MCP 服务器模式运行（供其他应用调用） deepseek mcp-server ``` ## 坑 MCP 需额外的服务器配置 MCP 功能需要在 `~/.deepseek/mcp.json` 中配置外部 MCP 服务器列表，默认状态下没有配置，需要手动添加。 # 事件 7：Skills（技能）系统 ## 解决方法 设置 Skills ```bash # 初始化 Skills 目录 deepseek setup --skills # Skills 目录优先级： # 1. ~/.deepseek/skills/ — 全局技能 # 2. ./skills/ — 项目级技能 # 3. ./.agents/skills/ — 项目级技能（备选） ``` ## 坑 Skills 文件格式 技能文件是 Markdown 格式（.md），放在上述任意 skills 目录下即可被自动加载。 # 事件 8：高级选项 ## 解决方法 YOLO 模式 自动批准所有工具调用，适合信任的自动化场景： ```bash deepseek --yolo exec "部署到服务器" ``` ## 解决方法 沙箱模式 Linux 上用 Landlock 限制 AI 的工具权限： ```bash deepseek --sandbox-mode linux exec "ls /root" ``` ## 解决方法 代理和自定义 Base URL ```bash # 如果使用代理或第三方兼容接口 deepseek --base-url https://你的地址/v1 --model 你的模型 "你好" ``` ## 解决方法 自动补全 ```bash # 生成 bash 自动补全 deepseek completions bash > /etc/bash_completion.d/deepseek source /etc/bash_completion.d/deepseek ``` ## 解决方法 功能开关 ```bash # 列出所有功能开关状态 deepseek features list # 启用/禁用某个功能 deepseek --enable mcp run deepseek --disable mcp run ``` ## 解决方法 更新版本 ```bash deepseek update ``` # 事件 9：本服务器上的实际配置 本服务器（8.219.6.216）上的 DeepSeek TUI 已配置： | 项目 | 值 | |------|-----| | 默认模型 | deepseek-v4-pro | | 辅助模型 | deepseek-v4-flash | | API Key | 已配置（来自私人笔记） | | 配置文件 | ~/.deepseek/config.toml | | 安装位置 | /usr/local/bin/deepseek | | API 连接 | ✅ 诊断通过 | # 完整命令速查表 | 命令 | 用途 | 示例 | |------|------|------| | `deepseek` | 直接对话 / 启动 TUI | `deepseek "你好"` | | `deepseek run` | 进入 TUI 全屏交互 | `deepseek run` | | `deepseek exec` | 非交互式执行（可调工具） | `deepseek exec "检查磁盘"` | | `deepseek review` | 代码审查（基于 git diff） | `deepseek review` | | `deepseek apply` | 应用补丁文件 | `deepseek apply < patch` | | `deepseek sessions` | 列出历史会话 | `deepseek sessions` | | `deepseek resume <id>` | 恢复历史会话 | `deepseek resume abc123` | | `deepseek fork <id>` | 分支出一个新会话 | `deepseek fork abc123` | | `deepseek models` | 列出可用模型 | `deepseek models` | | `deepseek config list` | 查看配置 | `deepseek config list` | | `deepseek config set <k> <v>` | 设置配置项 | `deepseek config set model xxx` | | `deepseek auth status` | 查看认证状态 | `deepseek auth status` | | `deepseek auth set` | 设置 API Key（安全） | `deepseek auth set --provider deepseek` | | `deepseek doctor` | 运行全面诊断 | `deepseek doctor` | | `deepseek metrics` | 查看用量统计 | `deepseek metrics --since 7d` | | `deepseek update` | 更新到最新版本 | `deepseek update` | | `deepseek init` | 创建 AGENTS.md | `deepseek init` | | `deepseek setup --skills` | 初始化 skills 目录 | `deepseek setup --skills` | | `deepseek mcp init` | 初始化 MCP 配置 | `deepseek mcp init` | | `deepseek mcp-server` | 启动 MCP 服务器模式 | `deepseek mcp-server` | | `deepseek app-server` | 启动应用服务器模式 | `deepseek app-server` | | `deepseek features list` | 查看功能开关 | `deepseek features list` | | `deepseek completions bash` | 生成 bash 补全脚本 | `deepseek completions bash > file` | | `--model` | 临时切换模型 | `--model deepseek-v4-flash` | | `--base-url` | 自定义 API 地址 | `--base-url https://xxx/v1` | | `--output-mode text` | 纯文本输出 | `--output-mode text` | | `--yolo` | 自动批准所有操作 | `--yolo exec "命令"` | | `--sandbox-mode` | 启用沙箱限制 | `--sandbox-mode linux` | | `--api-key` | 临时指定 API Key | `--api-key sk-xxx` | | `DEEPSEEK_API_KEY` | 环境变量指定 Key | `export DEEPSEEK_API_KEY=sk-xxx` | ["deepseek", "tui", "说明书", "goose"] 2026-05-12 16:20:35 2026-05-13 03:01:04 T F 25 25   0 public

Links from other tables