notatestuser/ds4-control

DS4 Control – macOS 菜单栏 UI，用于 DeepSeek V4 模型（通过 ds4 服务器）

这是什么 – 一个原生 Swift 菜单栏应用程序，可让你运行、监控并交互本地 ds4‑server 进程，该进程提供 DeepSeek V4（Pro 和 Flash 版本）。该应用不自行执行推理；它仅管理外部服务器、下载模型文件，并提供快速启动聊天或编码代理的快捷方式。

为何重要 – 在 Mac 上运行 100GB 以上的 LLM 需要仔细处理 RAM、GPU 绑定内存限制和进程监督。DS4 Control 自动完成这些任务，显示实时资源使用情况，并防止你启动超出机器 Metal 绑定内存预算的模型。

---

核心功能

功能	你将获得
服务器生命周期	启动/停止 ds4‑server 二进制文件，监控其 stderr 输出中的 listening on http://… 行，轮询 /v1/models 健康状态，并优雅关闭。
模型选择器	选择 V4 Pro (0813) 或 V4 Flash (0731)。UI 会检查你的 RAM 和 Metal 绑定限制，并禁用无法容纳的选项。
内置下载器	并行、可恢复的 GGUF 模型文件下载，带有实时进度条。无需外部工具。
资源小部件	菜单栏弹出窗口中的迷你仪表盘，显示统一内存、GPU、CPU 和电源/ANE 使用情况，每 2 秒刷新一次。
一键代理	启动聊天窗口、Claude Code 或 Pi（本地“代理式编码”工具）的按钮，这些工具与运行中的模型通信。
100 万令牌上下文	可配置至一百万令牌（Pro 默认；Flash 在小内存上使用较低默认值）。
启动集成	可选择在 macOS 启动时自动启动服务器。
安全门控	如果所需 Metal 绑定内存将超出限制，应用会显示所需的 sysctl iogpu.wired_limit_mb=… 命令和帮助对话框。

---

适合谁使用

• Mac‑silicon 高性能用户：拥有 96 GiB 或以上 RAM，希望在本地运行 DeepSeek V4 的用户。
• 开发者：需要快速启动本地 LLM 以获取编码辅助（Claude Code、Pi）而无需手动编写命令行脚本的用户。
• 研究人员：希望实验不同推理努力级别（Standard、Instant、Max Think）并观察实时系统影响的用户。

---

安装（快速）

brew install --cask ds4-control   # Homebrew Cask 提供签名的 .dmg

或从 GitHub 发布页面下载最新签名的 .dmg，或通过 Homebrew Cask URL 安装。

---

从源码构建（贡献者）

1. 获取包含上游 ds4 服务器的子模块：

   git submodule update --init --recursive
   

2. 打补丁并编译服务器（THINK_MAX 功能所需）：

   bash scripts/apply-ds4-patches.sh
   make -C external/ds4 -j ds4-server
   

3. 使用构建好的服务器运行应用：

   DS4_DIR="$PWD/external/ds4" swift run
   

4. 要创建可分发的包：

   bash build.sh   # 使用你的 Apple 开发证书签名，或回退到 ad-hoc
   

---

内部工作原理

• SupervisorService – Swift Process 包装器，启动 ds4‑server，解析其就绪行，轮询健康端点，并处理优雅终止。
• MetricsManager – 每 2 秒通过 Mach、IOKit 和私有 IOReport API 采样 CPU、内存、GPU 和电源使用情况，为 UI 小部件提供数据。
• Feasibility – 计算所选模型是否适合 RAM 和 Metal 绑定内存限制，推导出安全的默认上下文大小，并在需要时向用户提供所需的 sysctl 命令。
• 所有重逻辑（可行性计算、可恢复分块下载器、状态机）均为纯 Swift 实现，并由单元测试覆盖。

---

许可证

MIT – 请参阅仓库中的 LICENSE 文件。

---

总结 – DS4 Control 是一个精炼、签名的 macOS 工具，消除了本地运行 DeepSeek V4 所需的手动配置，让你通过单击即可启动模型、监控系统健康状况，并启动聊天或编码代理。