deepseek-mini

按一下，DeepSeek 就在眼前。

deepseek-mini 将 DeepSeek 官方网页版变成一个可以用全局快捷键唤起的 macOS 小窗。写作、读文档、写代码时，按一下快捷键，在窄输入条里提问；回答在下方展开，再按一下就收起，继续手头的工作。

使用你的 DeepSeek 网页账号，支持深度思考、联网搜索与文件上传入口，无需 API Key。

A keyboard-first macOS mini window for DeepSeek. Toggle it from anywhere, ask in a compact composer, and read replies in an expandable card. Uses your official web account with DeepThink, web search, and file attachments. No API key required.

查看回答卡片与首次设置

截图来自独立离线演示；示例回复用于展示界面，不是真实 AI 回答。

为什么做这个小窗

一个问题不应该打断整段工作。deepseek-mini 把常用的提问入口留在快捷键后面：不必寻找浏览器标签页，也不必始终占用一整块屏幕。需要完整的会话、登录或网页功能时，可以随时打开程序内的官方网页窗口。

已有功能

功能	使用方式
全局唤起 / 隐藏	默认 Command + Space；可自定义组合
窄输入条	平时只显示输入区和常用按钮，收到回复后展开回答卡片
深度思考	在输入条直接切换，状态与官网同步
联网搜索	对应当前官网的「智能搜索」选项
粘贴图片	在输入框按 ⌘ V；显示缩略图后输入问题，交由官网分析
使用与退出说明	点击右上角 ?，查看安装、启动、隐藏、图片粘贴与退出说明
明确退出入口	使用说明和设置页均提供「退出应用」按钮；菜单栏显示 DS
删除待发送附件	点击图片缩略图或文件旁的 ×，同步从官网移除，保留问题文字
多轮对话	同一对话按轮保留问题和回答，向上查看时保持滚动位置
添加文件	点击加号，选择文件交给官网上传和解析
官网回复同步	持续同步网页已渲染的回答，支持复制与完整官网查看
菜单栏常驻	关闭窗口即隐藏；快捷键或菜单栏均可找回
本地登录会话	首次在官网窗口登录，后续复用本机保存的会话
拖动与缩放	拖动顶部小横线或回答标题栏；在边缘或四角调整宽度与回答区域高度
位置与尺寸记忆	隐藏、重新唤起及重启后保留；显示器变化时自动移回可见区域
字号调整	设置中选择 12–24 px，输入与回答同步调整，自动保存
登录 Mac 时启动	可在设置中开启，默认关闭

下载与使用

从 GitHub Releases 下载 0.04。

首版提供 Apple Silicon（M 系列 Mac） 的应用包。Intel Mac 暂未提供预构建下载，可在对应机器上从源码构建。

1. 解压下载包，将 deepseek-mini.app 拖入「应用程序」文件夹，打开应用。
2. 首次启动点击「打开官网」，在程序自己的 DeepSeek 官方网页登录账号。
3. 返回设置窗口，选择唤起快捷键，点击「完成设置」。
4. 按快捷键打开输入条，输入问题并按 Enter；使用 Shift + Enter 换行。
5. 拖动顶部的小横线移动窗口；回答展开后拖动边缘或四角调整阅读区域。位置、宽度与展开高度会自动记住。
6. 点击右上角设置按钮，用「显示字号」滑块调整大小，立即预览并自动保存。
7. 按同一个快捷键或 Esc 收起小窗，对话继续留在后台。

快捷键冲突： Command + Space 通常用于 Spotlight。程序会检查快捷键注册是否成功；如果已被占用，可使用设置中的系统快捷键入口调整 Spotlight，或选择 Option + Space / 自定义组合。程序不会自动改动系统快捷键。

退出应用： 点击小窗右上角 ? →「退出应用」，或设置页底部的「退出应用」。也可以点击顶部菜单栏的 DS →「退出 deepseek-mini」。关闭小窗的 × 或按 Esc 只会隐藏；真正退出后快捷键不会响应，需要重新启动应用。

分发状态： 0.04 是早期公开版本，下载包尚未经过 Apple Developer 签名和公证。遇到 macOS 的开发者身份提示时，请确认下载来源为本仓库；也可以使用下面的源码运行方式。

图片粘贴

复制截图或图片的内容，在小窗输入框按 ⌘ V；直接粘贴即可读取剪贴板图片。小窗显示缩略图后，图片已交给官网上传，等待解析完成，再输入问题并发送。普通文字粘贴保持不变。当前剪贴板图片限制为 20 MB，更大的文件请使用加号上传。

如果从「预览」复制出来的是文字，请切换图像选择工具；也可以使用 Control + Command + Shift + 4 将截图直接复制到剪贴板。图片理解、文字识别能力及可用额度以 DeepSeek 官网为准。点击图片缩略图右上角或文件旁的 × 可以取消待发送附件；确认官网移除后，小窗同步更新。点右上角「新对话」可以清空当前小窗内容并开始新对话。

启动与关闭

先把 .app 拖进 Finder 的「应用程序」。首次从那里双击启动，完成网页登录和快捷键设置。此后使用快捷键显示 / 隐藏，或菜单栏 DS 打开小窗。应用内右上角 ? 提供这些说明与真正的退出按钮。

安装后也可以在终端启动：

open -a deepseek-mini

找不到退出入口时，关闭本应用主进程：

pkill -TERM -x deepseek-mini

从源码使用 npm start 启动时，在对应终端按 Control + C 结束。

从早期版本升级

应用统一命名为 deepseek-mini。先从菜单栏退出旧版，再打开新版，避免旧版继续占用快捷键。新版沿用相同的本机数据目录，保留已有网页登录会话、快捷键与开机启动设置；不需要删除或迁移账号数据。

0.02 改为点击官网发送按钮，并等待最多 8 秒确认接收，解决后台窗口回车无响应及 0.4 秒确认过早的问题。若官网仍在解析文件或网络未就绪，输入内容会保留，提示查看完整官网；程序不会自动重复发送。

从源码运行

需要 macOS、Node.js 22.12 或更新版本，以及能连接 npm、Electron 下载源和 DeepSeek 的网络。

git clone https://github.com/Wfssll/deepseek-mini.git
cd deepseek-mini
npm ci
npm start

若你的 npm 配置禁止安装脚本，导致 Electron 可执行文件未下载，请执行：

node node_modules/electron/install.js

不登录账号，只预览界面：

npm run demo

演示模式加载独立的本地测试网页，使用固定回复，不会连接 DeepSeek，不会生成真实 AI 回答，也不使用正常模式的账号会话。

构建与验证

npm run check          # JavaScript 语法检查
npm test               # 自动化检查
npm run smoke          # 启动真实桌面窗口，测试离线交互
npm run build          # 构建当前 Mac 架构的 .app
npm run release:zip    # 生成下载 ZIP 和 SHA-256 校验文件

应用输出至 dist/deepseek-mini-darwin-<架构>/deepseek-mini.app。界面截图和桌面测试结果输出至 test-output/。

对外版本号为 0.04，对应 Git 标签 v0.04；内部 npm/macOS 版本使用等价的语义版本 0.0.4。

工作方式与隐私

应用在隔离的浏览器窗口中加载 https://chat.deepseek.com/。小窗操作官网自身的输入框和按钮，再同步网页上已经渲染的回复；不需要 API Key，不调用 DeepSeek 私有接口，不提供独立 AI 服务。

• 登录由 DeepSeek 官方网页处理，会话保存在本机的应用数据目录。
• 官网窗口没有 Node.js 权限，也没有小窗的本地操作桥；同步的回答 HTML 使用 DOMPurify 清理。
• 选择上传文件后，文件交由 DeepSeek 官方网页处理，适用 DeepSeek 的服务和隐私规则。
• 项目不会将登录会话、文件或聊天记录上传到 GitHub。
• 开发模式数据存放于 .runtime/profile/。打包应用沿用 ~/Library/Application Support/DeepSeek Mini/，保证早期原型升级后仍可保留账号与设置；该历史目录名不影响应用名称。
• 本地会话是浏览器数据，不承诺额外加密。发布源码时请始终排除运行数据目录。

当前边界

0.04 已通过 23 项自动化检查与 Electron 桌面回归，覆盖图片粘贴、附件删除、删除后不再发送、草稿保留、多轮问答和滚动位置，以及窗口尺寸和字号记忆。本机已使用已有登录在真实 DeepSeek 网页上验证图片附件删除和连续问答。

文件上传和解析、长时间后台运行、不同 macOS 版本及 Intel Mac 仍需要更多使用反馈。网页功能和使用额度由你的 DeepSeek 账号决定；官网改版可能需要更新适配器。登录过期、安全验证或访问受限时，请打开完整官网窗口处理。

项目结构

src/main.js          窗口、菜单栏、快捷键、会话及可信 IPC
src/adapter.js       DeepSeek 网页 DOM 适配器
src/core.js          设置存取、快捷键与官方地址检查
src/preload.js       小窗的最小权限桥
src/ui/              窄输入条、回答卡片、首次设置
scripts/             语法检查、图标、macOS 打包与发布归档
test/                自动化测试与离线演示网页

反馈与贡献

欢迎通过 Issues 提交问题与想法，或通过 Pull Request 参与改进。反馈问题时，请说明 macOS 版本、机器架构、复现步骤与预期行为；截图前请隐藏账号和私人聊天内容。

许可证与声明

MIT License。这是独立的非官方开源项目，与 DeepSeek 无隶属或背书关系。DeepSeek 名称属于其权利持有人；请遵守官方服务的使用规则。

开发版预览

调试当前源码并沿用已安装应用的登录与设置：先退出安装版，再运行 npm run preview。安装版与开发版不要同时运行，以免争用快捷键或会话目录。