HanzhiOvO/deepseek-harness-shell

README 摘要

DeepSeek Harness Shell（macOS 原生版） 一个把 DeepSeek Harness （官方 @deepseek-ai/dsh ）包装成 macOS 桌面应用的 原生轻量化 SwiftUI 壳 。 它不重新实现 Agent / Session / Tool / Sandbox / Cordis，只负责让内核更好用： - 自动检测并配置环境 ：没有 dsh 时自动通过 npm 安装；没有 Node.js 时自动走 Homebrew 或引导下载。 - ChatGPT 桌面应用式体验 ：侧边栏 + 主工作区 + 工具栏状态胶囊 + 设置场景 + 快捷键。 - 应用级图形界面 ：插件中心、运行日志、环境与设置都是原生窗口，不塞在网页里。 - 本地历史会话读取与同步 ：侧边栏直接列出 $DSH HOME/sessions 下的历史会话，显示标题、工作区与时间，只读不改；回到前台自动刷新。 - 三种插件安装方式 ：输入 GitHub 仓库地址、上传 ZIP 压缩包、选择本地文件夹（另附 npm 包名方式）。 - 低资源消耗 ：不用 Electron / Chromium，应用本体约 1.6 MB ；空闲无定时器；服务停止即释放内存。 内核仍是官方 @deepseek-ai/dsh 。目前 DeepSeek Harness 处于 developer preview，接口可能变化。 架构 和 Electron 版的关键区别 维度 本原生壳 典型 Electron 壳 运行时 SwiftUI/AppKit + 系统 WKWebView 捆绑 Chromium + Node 应用体积 1.6 MB（zip 0.4 MB） 常 100 MB 空闲进程 关闭窗口即退出，无驻留 常有主/渲染/GPU 多个进程 GPU 仅绘制可见内容，支持 App Nap Chromium 合成器常驻 数据 复用系统全局 dsh，不复制依赖 常把 dsh 打进 asar 功能 1. 环境自动检测与配置 启动时按以下顺序探测，并把结果显示在侧边栏和「环境与设置」： 检测结果 处理 已有 dsh 直接显示版本并启动 只有 dsh 缺失 自动 执行 npm install --global @deepseek-ai/dsh （优先当前 npm 前缀，不可写时退回 /.local ，无需 sudo） 没有 Node.js，但有 Homebrew 提供一键 brew install node 两者都没有 引导打开 nodejs.org 下载页，安装后点击重新检测 没有 pnpm 安装插件前自动准备：优先 Corepack，并在应用目录生成 pnpm shim；失败时 npm i -g pnpm 已安装的 dsh 也可作为临时回退：只有 npm 时，启动服务会使用 npm exec --p…

分类