diff --git a/README.md b/README.md index a8ca2c08..ae82e64a 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # 🐳 DeepSeek TUI -> **This terminal-native coding agent is built around DeepSeek V4's 1M-token context window and prefix cache capability. It is distributed as a single binary and requires no Node.js or Python runtime. It also includes an MCP client, a sandbox, and a durable task queue out of the box.** +> **Terminal-native coding agent built for DeepSeek V4: 1M-token context, thinking-mode streaming, and prefix-cache aware. Ships as self-contained Rust binaries — MCP client, sandbox, and durable task queue included.** [简体中文 README](README.zh-CN.md) @@ -20,7 +20,11 @@ npm install -g deepseek-tui cargo install deepseek-tui-cli --locked # `deepseek` (entry point) cargo install deepseek-tui --locked # `deepseek-tui` (TUI binary) -# 3. Direct download — no Node, no toolchain. +# 3. Homebrew — macOS package manager. +brew tap Hmbown/deepseek-tui +brew install deepseek-tui + +# 4. Direct download — no Node, no toolchain. # https://github.com/Hmbown/DeepSeek-TUI/releases # Prebuilt for Linux x64/ARM64, macOS x64/ARM64, Windows x64. ``` @@ -149,7 +153,7 @@ Works on any Tier-1 Rust target — including musl, riscv64, FreeBSD, and older git clone https://github.com/Hmbown/DeepSeek-TUI.git cd DeepSeek-TUI -cargo install --path crates/cli --locked # requires Rust 1.85+; provides `deepseek` +cargo install --path crates/cli --locked # requires Rust 1.88+; provides `deepseek` cargo install --path crates/tui --locked # provides `deepseek-tui` ``` @@ -227,7 +231,6 @@ deepseek mcp-server # run dispatcher MCP stdio serv | `Ctrl+S` | Stash current draft (`/stash list`, `/stash pop` to recover) | | `@path` | Attach file/directory context in composer | | `↑` (at composer start) | Select attachment row for removal | -| `Alt+↑` | Edit last queued message | Full shortcut catalog: [docs/KEYBINDINGS.md](docs/KEYBINDINGS.md). @@ -318,6 +321,7 @@ Commands: `/skills` (list), `/skill ` (activate), `/skill new` (scaffold), | [SUBAGENTS.md](docs/SUBAGENTS.md) | Sub-agent role taxonomy and lifecycle | | [KEYBINDINGS.md](docs/KEYBINDINGS.md) | Full shortcut catalog | | [RELEASE_RUNBOOK.md](docs/RELEASE_RUNBOOK.md) | Release process | +| [LOCALIZATION.md](docs/LOCALIZATION.md) | UI locale matrix & switching | | [OPERATIONS_RUNBOOK.md](docs/OPERATIONS_RUNBOOK.md) | Ops & recovery | Full Changelog: [CHANGELOG.md](CHANGELOG.md). @@ -343,6 +347,8 @@ This project ships with help from a growing community of contributors: - **[woyxiang](https://github.com/woyxiang)** — Windows Scoop install docs (#696) - **[wangfeng](mailto:wangfengcsu@qq.com)** — Pricing/discount info update (#692) - **[zichen0116](https://github.com/zichen0116)** — CODE_OF_CONDUCT.md (#686) +- **[dfwqdyl-ui](https://github.com/dfwqdyl-ui)** — model ID case-sensitivity compatibility report (#729) +- **[Oliver-ZPLiu](https://github.com/Oliver-ZPLiu)** — stale `working...` state bug report with detailed reproduction and fix (#738) - **Hafeez Pizofreude** — SSRF protection in `fetch_url` and Star History chart - **Unic (YuniqueUnic)** — Schema-driven config UI (TUI + web) - **Jason** — SSRF security hardening diff --git a/README.zh-CN.md b/README.zh-CN.md index 475c9093..b041be8b 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,13 +1,13 @@ # DeepSeek TUI -> **面向 [DeepSeek V4](https://platform.deepseek.com) 模型的终端原生编程智能体，支持 100 万 token 上下文、思考模式推理流和完整工具调用。单一二进制，无需 Node/Python 运行时——开箱即带 MCP 客户端、沙箱和持久化任务队列。** +> **面向 [DeepSeek V4](https://platform.deepseek.com) 的终端原生编程智能体：100 万 token 上下文、思考模式流式推理、前缀缓存感知。自包含 Rust 二进制发布——开箱即带 MCP 客户端、沙箱和持久化任务队列。** [English README](README.md) ## 安装 -`deepseek` 是单一 Rust 二进制——**运行时不依赖 Node.js 或 Python**。 -下面三种方式装出来的是同一个二进制，按你已有的工具链选一个即可： +`deepseek` 是自包含 Rust 二进制——**运行时不依赖 Node.js 或 Python**。 +下面几种方式装出来的是同一套二进制，按你已有的工具链选一个即可： ```bash # 1. npm —— 已装 Node 的最方便方式。npm 包只是一个下载器， @@ -19,7 +19,11 @@ npm install -g deepseek-tui cargo install deepseek-tui-cli --locked # `deepseek` 入口 cargo install deepseek-tui --locked # `deepseek-tui` TUI 二进制 -# 3. 直接下载 —— 无需任何工具链。 +# 3. Homebrew —— macOS 包管理器。 +brew tap Hmbown/deepseek-tui +brew install deepseek-tui + +# 4. 直接下载 —— 无需任何工具链。 # https://github.com/Hmbown/DeepSeek-TUI/releases # 覆盖 Linux x64/ARM64、macOS x64/ARM64、Windows x64 ``` @@ -74,6 +78,7 @@ DeepSeek TUI 是一个完全运行在终端里的编程智能体。它让 DeepSe ```bash npm install -g deepseek-tui +deepseek --version deepseek ``` @@ -143,7 +148,7 @@ scoop install deepseek-tui git clone https://github.com/Hmbown/DeepSeek-TUI.git cd DeepSeek-TUI -cargo install --path crates/cli --locked # 需要 Rust 1.85+；提供 `deepseek` +cargo install --path crates/cli --locked # 需要 Rust 1.88+；提供 `deepseek` cargo install --path crates/tui --locked # 提供 `deepseek-tui` ``` @@ -198,6 +203,8 @@ deepseek setup --tools --plugins # 创建本地工具和插件目 deepseek models # 列出可用 API 模型 deepseek sessions # 列出已保存会话 deepseek resume --last # 恢复最近会话 +deepseek resume # 按 UUID 恢复指定会话 +deepseek fork # 在指定轮次分叉会话 deepseek serve --http # HTTP/SSE API 服务 deepseek pr # 获取 PR 并预填审查提示 deepseek mcp list # 列出已配置 MCP 服务器 @@ -219,7 +226,6 @@ deepseek mcp-server # 启动 dispatcher MCP stdio 服 | `Ctrl+S` | 暂存当前草稿（`/stash list`、`/stash pop` 恢复） | | `@path` | 在输入框中附加文件或目录上下文 | | `↑`（在输入框开头） | 选择附件行进行移除 | -| `Alt+↑` | 编辑最后一条排队消息 | 完整快捷键目录：[docs/KEYBINDINGS.md](docs/KEYBINDINGS.md)。 @@ -333,6 +339,7 @@ description: 当 DeepSeek 需要遵循我的自定义工作流时使用这个技 | [SUBAGENTS.md](docs/SUBAGENTS.md) | 子智能体角色分类与生命周期 | | [KEYBINDINGS.md](docs/KEYBINDINGS.md) | 完整快捷键目录 | | [RELEASE_RUNBOOK.md](docs/RELEASE_RUNBOOK.md) | 发布流程 | +| [LOCALIZATION.md](docs/LOCALIZATION.md) | UI 语言矩阵与切换 | | [OPERATIONS_RUNBOOK.md](docs/OPERATIONS_RUNBOOK.md) | 运维和恢复 | 完整更新历史：[CHANGELOG.md](CHANGELOG.md)。 @@ -358,6 +365,8 @@ description: 当 DeepSeek 需要遵循我的自定义工作流时使用这个技 - **[woyxiang](https://github.com/woyxiang)** — Windows Scoop 安装文档 (#696) - **[wangfeng](mailto:wangfengcsu@qq.com)** — 价格/折扣信息更新 (#692) - **[zichen0116](https://github.com/zichen0116)** — CODE_OF_CONDUCT.md (#686) +- **[dfwqdyl-ui](https://github.com/dfwqdyl-ui)** — 模型 ID 大小写兼容性报告 (#729) +- **[Oliver-ZPLiu](https://github.com/Oliver-ZPLiu)** — `working...` 卡死状态 Bug 报告，含详细复现步骤和修复建议 (#738) - **Hafeez Pizofreude** — `fetch_url` 的 SSRF 保护和 Star History 图表 - **Unic (YuniqueUnic)** — 基于 schema 的配置 UI（TUI + web） - **Jason** — SSRF 安全加固