ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

DeepSeek Harness桌面版实测,插件与底层机制一次性讲透

DeepSeek Harness桌面版实测,插件与底层机制一次性讲透 文章目录01、先把工位换一换02、DSH 插件推荐①、DSH-better-sidebar②、dsh-TUI③、DeepSeek Harness 插件库03、桌面版和 WebUI 到底差在哪04、Everything is a Plugin05、插件是怎么长进 DSH 的06、记忆这件小事07、endingP.S. 目前国内还是很缺AI人才的希望更多人能真正加入到AI行业共同促进行业进步增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 传送门http://blog.csdn.net/jiangjunshow教程通俗易懂高中生都能看懂还有各种段子风趣幽默从深度学习基础原理到各领域实战应用都有讲解我22年的AI积累全在里面了。注意教程仅限真正想入门AI的朋友否则看看零散的博文就够了。01、先把工位换一换大家好呀今天聊点新鲜的。从网上看到了 DeepSeek Harness 桌面版的安装地址顺手就装上了。结果装上的那一刻它吭哧吭哧就自动升级到了 v0.1.7-rc.2这积极性比我当年给电脑装系统还着急。以后再也不用在 Chrome 里开 WebUI 了。以前终端里跑起来、浏览器里再打开这套流程仪式感拉满效率却约等于零——像极了先烧水再泡茶水开了茶凉了。它现在还支持登录。以后会不会有云端版本哪天能移动端、桌面端、云端三端同步不用在本地干活的人就有福了。顺便聊聊我的 AI 员工。编程主力还是 Codex GPT-6 Astra画图剪视频也归它管文本主力是 Claude Code Opus 5.5三号员工就是 DeepSeek Harness DeepSeek V4.1 Flash。我个人偏爱 DeepSeek性价比高不用买 Token plan用多少算多少速度还贼快。三号员工干着二号员工的活拿着临时工的工资这性价比老板看了都想给它涨薪。02、DSH 插件推荐①、DSH-better-sidebar这插件给 DSH 加侧边栏、底边栏、分栏、可浮动栏等一堆 UI 定制能力属于给其他插件打底座的插件。GitHub 上 3.8k 星这关注度比不少开源项目都体面。安装方法也简单直接跟 DSH 说一句帮我安装 dsh-better-sidebar 插件地址https://github.com/omdsh-dev/DSH-better-sidebar有意思的来了官方安装方法只支持 WebUI 版本但 DeepSeek V4.1 Flash 显然有桌面版安装的能力自己就搞定了。这 AI比我还会走捷径。为什么官方方法走不通因为运行中的是桌面应用属于 desktop profile而命令行里dsh plugin --profile desktop会被源码硬拒绝。所以我按应用内部 PluginManager 的同一套机制来pnpm add bundle 协调注册。具体四步先备份 profile 配置到 /tmp/dsh-install-backup/再在 pnpm-workspace.yaml 里加入 minimumReleaseAgeExclude: [dsh-better-sidebar]官方 install.sh 的幂等步骤防止 24h 新版本被拦然后在 ~/.dsh/profiles/desktop 执行 pnpm add dsh-better-sidebarlatest最后在 package.json 的 dsh.profile.bundles 里追加一行。装完打开设置就能看到插件躺在列表里。装完还能在右侧重新开一个窗口左侧窗口的上下文会自动注入。喜欢开多窗口工作的小伙伴可以试试一边改代码一边问问题互不耽误。②、dsh-TUI内测期就一直跟着版本打磨的终端界面补的是官方缺的那块 TUI。喜欢键盘、SSH、远程、不想开浏览器的小伙伴这个比一堆皮肤有用多了。装上之后像素鲸鱼顶栏、实时工作状态行、思考流式展开、终端图片预览Sixel / Kitty、双击 Esc 时间回溯、蓝白上下文进度条 TPS 仪表全都有了。一只像素鲸鱼在终端里游这设计程序员看了走不动道。GitHub 上 3.7k 星还被 DSH 官方公众号收录过上过日榜 #7。npm install -g deepseek-ai/dsh deepseek-harness-tui/dsh-tui或者更省事直接跟 DSH 说帮我安装这个dshtui.com/有意思的是DSH 装之前会先自己核查一遍域名解析到 fake-IP、npm 包真实存在、没有 postinstall 钩子、METADATA 正常全部通过才动手。这安全洁癖比我看合同还认真。③、DeepSeek Harness 插件库还想试更多的话可以逛逛 deepseek-harness-plugin.com/zh-CN/收录了不少插件。但插件真不用装太多够用就行太花里胡哨就偏离 Agent 的本质了。装插件这事像逛超市进去只想买瓶酱油出来购物车已经能开超市了。随着模型能力提升一部分 Skills、MCP、插件能力都会被吃掉。尤其 Memory 这块我认为官方的做法一定就是最优解千万别装什么第三方的 Memory 插件。03、桌面版和 WebUI 到底差在哪装完桌面版我第一反应是好奇DeepSeek 是不是专门为桌面端重写了一套界面把源码拉到本地翻了翻 apps/desktop 目录发现没有重写。桌面版用 Electron 打包主窗口加载的就是完整的 WebUI 页面。启动时Electron 以 Node 模式拉起一个子进程子进程里跑的是 dsh web 背后那套本地服务只是端口从 3080 换成了 19387。窗口里发出的请求都转给这个本地服务处理。也就是说Agent 还是那个 Agent界面也还是那个界面只是原来终端里执行 pnpm dsh web 浏览器打开链接这两步现在由桌面版替我们做了。那桌面版多了什么最明显的是自动更新。网页没办法替自己换掉本地的程序桌面版可以。更新模块用的是 electron-updater通道固定为 nightly允许安装预发布版本。每 10 分钟检查一次时间上加了一点随机抖动检查失败就退到一小时一次。有新版本也不会自动下载要你点了才下。外壳、Agent 运行时和 pnpm 作为一个签过名的整体一起更新。this.updater.autoDownload false this.updater.autoInstallOnAppQuit false this.updater.channel nightly this.updater.allowPrerelease true // Selecting a channel can enable downgrade in electron-updater. this.updater.allowDowngrade false每 10 分钟查一次更新还带随机抖动出场时间永远成谜像极了怕被粉丝蹲点的明星。关掉窗口后任务会继续跑真要退出时如果还有任务没跑完桌面版会弹窗提醒。长任务丢给它窗口一关就可以去干别的——这敬业程度比不少打工人靠谱。运行环境也省心。桌面版自带 Python带 numpy、pandas 和处理 Word、PPT、Excel 的库、Node 和 pnpm还默认注册了 Office 相关的 Skills。让它做个表格、改个 PPT不用先在本机装一堆依赖像极了自带锅铲下馆子。还有一点平时感觉不到但我觉得挺讲究。WebUI 其实就是一个本地 HTTP 服务只监听 127.0.0.1每次启动生成一个随机 token 放在链接里。浏览器第一次访问时拿 token 换一个 HttpOnly 的 cookie之后每个请求还要校验 Host 和 Origin防止别的网站借我们的浏览器去调用本地 Agent。桌面版把凭证挂在自己的主窗口上页面拿不到文件系统、shell 和底层 IPC。这安全设计比我家的门锁还讲究。再说登录。桌面版登录用的是 DeepSeek 开放平台的账号走标准的 OAuth PKCE 流程点登录会打开系统浏览器授权授权完成后由本地回调接收。登录令牌存在 ~/.dsh/.credentials.yaml文件权限是 0600只有当前用户能读还没接入系统钥匙串。这保密级别比我的日记本还高。登录之后模型列表里多了一套账号模型推理直接扣账号余额和 API Key 那套入口是分开的。rc.2 还专门修了一个问题额度提醒会跟着当前任务的计费方式走用 API Key 的小伙伴不会被提示去给登录账号充值。细节控狂喜。04、Everything is a Plugin回到插件。前面装 better-sidebar 的时候提过官方安装方法只支持 WebUI原因就在源码里function rejectElectronProfile(program: Command, profile: string): void { if (profile.toLowerCase() desktop) { program.error(error: profile desktop is managed exclusively by the Electron application) } }名叫 desktop 的 profile 只归 Electron 应用管命令行不许碰。这排他性比正宫还正宫。要看懂这段检查得先知道 DSH 的插件是什么。DeepSeek Harness 仓库的简介只有一句话Everything is a Plugin一切皆插件。这在源码里是字面意思——Agent loop、工具注册表、会话日志、上下文压缩、Sub-agent 都是插件连 Skills 的加载和 MCP 客户端也是两个普通插件。万物皆可盘我见过万物皆可插还是头一回。DSH 的插件建立在 Cordis 这个框架上。一个插件就是一个导出 apply(ctx) 函数的模块用 inject 声明自己依赖哪些服务。better-sidebar 的服务端部分就声明了 webServer、sessions、webRuntime、tools 这四个依赖DSH 把这些服务准备好之后才会加载它。发布的时候插件要打成一个 npm 包官方叫 bundle。package.json 里有一个 dsh 字段指向一个 cordis.patch.yml 文件文件里写着要往插件列表里加哪几行。DSH 启动时先加载基础 bundle再依次叠加各个 bundle 自带的 patch、profile 目录里的 patch最后是用户目录下的 patch。插件装在 profile 里。profile 就是一套独立的配置目录WebUI 用 ~/.dsh/profiles/web桌面版用 ~/.dsh/profiles/desktop。两边的会话、设置和登录凭证是共享的但插件不共享。有一件事大家一定要知道DSH 的插件没有沙箱。插件的服务端代码直接跑在 Agent 宿主进程里在工作区沙箱之外权限和 DSH 本身一样。桌面版上宿主和所有插件共用同一个 Electron Node 进程插件的页面部分和应用在同一个页面里运行没有 iframe 隔离。官方 SAFETY.md 专门提醒过不要装来路不明的插件。一句话看懂插件、Skill、MCP 三者的区别插件SkillMCP形式npm 包JS 代码SKILL.md 说明文件外部进程或 HTTP 服务安装命令行、插件页、插件管理工具放进 skills 目录自动热加载在 cordis.patch.yml 里加一行配置权限和宿主相同只是注入的提示词沙箱外的可执行程序默认一个都不开05、插件是怎么长进 DSH 的以 better-sidebar 为例。服务端在 DSH 的 Web 服务上注册了一组 HTTP 接口和两个 WebSocket一个推送 Agent 打开文件的事件一个监听文件变化还给模型加了一个可选的 sidebar_open 工具Agent 可以主动把文件在侧边栏里打开。页面把按钮和卡片挂进 DSH 预留的界面插槽比如会话头部的工具栏和设置页。前面说右侧窗口会自动注入左侧的上下文对应的是它的 Side Chat 功能。点击的那一刻插件会新建一个子会话把父会话截至这一刻的完整事件日志复制过去。由于复制的是完整事件日志所以子会话拿到的上下文和父会话完全一致。与其猜你要什么不如把家底整个搬过去。dsh-TUI 和 DSH 之间没有走 HTTP 或 WebSocket它本身就是跑在 DSH 进程里的一组插件。第一次运行 dsh-tui 时启动器会执行 dsh plugin --profile dsh-tui add …建一个名叫 dsh-tui 的 profile 把自己装进去然后用这个 profile 启动 DSH。它的 patch 文件替换了基础 bundle 里的几行包括系统提示词、DeepSeek 模型适配和 Agent loop再挂上用户提问、用户审批和它自己的界面插件。界面用 React 写渲染器是 fork 过来的 Ink最后输出在终端上。自己建个 profile 装自己这操作像极了我先雇我自己。06、记忆这件小事DSH 官方目前没有单独的长期记忆工具。跨会话能带过去的主要是指令文件~/.dsh/AGENTS.md 加上项目里的 AGENTS.md、CLAUDE.md会在第一次请求时作为一条用户消息注入总预算 65536 字节。单个会话之内靠的是存在 ~/.dsh/sessions 下的 JSONL 会话日志和上下文压缩快满了自动压缩也能手动 /compact。想借用另一个会话的内容可以在 WebUI 里 那个会话把它的只读快照带进来。源码里其实有一个会话搜索工具session_search但目前没有在任何内置预设里启用。有刀不用等于没刀。至于 MCP 记忆配置mcp-memory、Memorix、Engram默认全部关闭。官方的态度很明确第三方记忆服务启用前先自己核验来源和权限。07、ending说说我最真实的感受。桌面版的界面和 WebUI 几乎一样。自动更新、关窗口不打断任务、自带 Office 运行环境这几样 WebUI 给不了。桌面版补上的是一个 Agent 常驻在本机需要的那些能力。期待官方正式发布更新。我们下期见。P.S. 目前国内还是很缺AI人才的希望更多人能真正加入到AI行业共同促进行业进步增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 传送门http://blog.csdn.net/jiangjunshow教程通俗易懂高中生都能看懂还有各种段子风趣幽默从深度学习基础原理到各领域实战应用都有讲解我22年的AI积累全在里面了。注意教程仅限真正想入门AI的朋友否则看看零散的博文就够了。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进