DSH 从安装到日用

DSH 从安装到日用

装完不会用,是最常见的浪费。

我见过太多这样的情况:软件装上了,插件也点了安装,然后就没有然后了。问题不在软件,在于”装好”和”每天用”之间那段没人写的东西——该装哪几个、装完怎么确认没白装、出了事怎么退回去。

这篇把这段路走一遍。写的是实际操作,不是功能列表。

一、下载并安装

下载只有一个入口:

https://www.deepseek.com/harness/

进页面按你的系统选:Windows 选 64 位安装包;macOS 选 Apple 芯片那版(要求 macOS 13 以上)。拿到的是 EXE 或 DMG,双击,一路下一步,装完在开始菜单里。默认装在 C:Users<你的用户名>AppDataLocalProgramsDeepSeek Harness,不用改。

只从这个页面下。 搜索的时候会碰到 dshdesktop.com、dshdesktop.cn 这类站点,名字长得非常像,有些介绍文章还把它们的地址写成”官网”。装错一个来路不明的安装包,后面所有排查都白做——这是第一步就该拦住的坑。

它自带 Node,你不需要另外装。 这一点最容易搞混:命令行版本的 dsh 要先自己装 Node,桌面版把这些打包进去了。所以看到”需要 Node 24″之类的说法,那是命令行版的要求,跟你没关系。

第一次打开会做两件事

创建配置目录 C:Users<你的用户名>.dsh,然后让你登录。

.dsh 这个目录装着全部家当:profiles 是配置,skills 是 skill,sessions 是聊天记录,dsh-runtimes 是它自己的运行时。后面所有”装不上””打不开”的问题,八成都能在这个目录里找到线索。 先记住它在哪,比记任何命令都有用。

选稳定版,别选每夜版

DSH 有两条更新通道,设置里能切:

通道 版本节奏 适合谁
stable 慢,跳得少 办公、长期用(推荐)
nightly 每夜构建 追新功能、愿意自己排查

日常办公一定选 stable。 每夜版的版本号一天一个,插件作者适配跟不上,装插件时会频繁撞上”版本不兼容”——那不是插件坏了,是宿主跑得太快。如果默认给的是 nightly,第一件事就切回 stable。

二、先分清三层东西

迷迷糊糊的根源,是把三样东西混为一谈。

层 是什么 坏了会怎样
宿主 DSH 本体(一个桌面程序) 整个软件打不开
插件 挂在宿主上的功能包,从 npm 装 那个功能消失,可能连带打不开
skill 一段写给模型看的说明书(Markdown) 只是少了套做法,不影响启动

三层的关系是:宿主按清单加载插件,插件提供工具,skill 告诉模型什么时候用哪个工具。

分清这三层有个直接好处:出问题时能立刻判断该修哪一层。skill 写错了顶多效果差,插件坏了可能整个软件起不来,宿主坏了什么都别谈。

三、装之前,三件事先确认

第一,版本对得上。 在对话框里问它”你是什么版本”,或者看 设置 → 关于。插件和宿主的版本是有绑定的,差太远会提示不兼容。这时候不是你操作错了,是版本没对上。

第二,磁盘留 3 GB。 插件本体不大,但办公类插件要下载运行时组件,空间不够会卡在中间。

第三,有一个 Chromium 内核浏览器。 Windows 自带的 Edge 就算。有些功能(导出 PDF、检查版式有没有溢出)要借用浏览器内核,没有它那几项用不了,别的照常。

四、装插件:一个一个点

在 DSH 图形界面的插件市场里装。核心五个,按重要程度分三档:

档位 插件 一句话作用 什么时候装
P0 dsh-univer-office 办公主战场:Excel / Word / PPT 都在对话里改 第一天
P0 @liustack/modlens 给模型装上眼睛:粘贴图片就能读出文字 第一天
P1 @liustack/modsearch 联网搜索,免 API Key 第二天
P1 dsh-task-board 侧边栏任务看板,可设定时提醒 第二天
P2 dsh-whale-widget 右下角余额挂件,看得见花了多少 第三天

P0 这两个是地基,跑通这台电脑就能干活了。P1、P2 随时可以加,装不上也不影响手上在做的事。

一次只装一个。 DSH 是全有全无启动——任何一个插件加载失败,整个软件就打不开。所以装一个、重启、确认能用,再装下一个。多花五分钟,省一次排查。

为什么不给一个”双击全装”的脚本?我写过。它依赖两样在别人的电脑上不保证存在的东西:写死的运行时路径,和特定版本的 pnpm 参数。失败的时候提示语还指向不准,反而更难查。手工点五个,二十秒的事,出错点少,出错也看得见。

五、装完没生效?先查这两个地方

用插件市场装,下面两条你不会遇到——它们是配置被手工改过之后才会出现的问题。写在这里,是因为这两种失败的特征都是”没有任何报错”,不知道的话能查很久。

细节一:配置文件不能带 BOM

DSH 读配置文件用的是 JSON.parse(readFileSync(path, "utf8"))。Node 在解析前不会剥离 BOM。

而 Windows 上不少编辑器(包括某些 PowerShell 写法)保存 UTF-8 时默认加 BOM。一旦加上,JSON.parse 直接抛异常——软件起不来,界面上不会有任何提示。

现象就是双击没反应。遇到这种情况,先把配置文件用十六进制看一眼开头是不是 EF BB BF。

细节二:只写进 dependencies 等于没装

DSH 的加载逻辑是:按 dsh.profile.bundles 数组的顺序,依次套用每个插件带来的改动。

所以一个新插件要真正生效,必须同时出现在两个地方:

  • dependencies 里——声明”我要装这个包”
  • dsh.profile.bundles 里——声明”启动时要加载这个包”

只写前者,包文件会老老实实下载到磁盘上,但永远不会被加载。你不会收到任何报错,只会觉得”我明明装了,怎么没反应”。

顺带一条:新插件要追加到数组末尾,不能插到开头。顺序对加载结果有影响。

六、装完怎么确认

别急着看功能,先确认”装对了”。

一看数量。 插件列表里应该有对应的条目,一个不少。二看加载。 完全退出 DSH(不是关窗口,是退进程)再重新打开。插件只在启动时加载。三看功能。 每个插件找一个最小动作试一下:办公插件打开一个表格,读图插件粘一张截图,搜索插件搜一个词。

三步都过,才算装完。

七、出问题怎么办

DSH 是全有全无启动:任何一个插件加载失败,整个软件就打不开。所以出事是常态,不用慌。

现象 先试什么
双击没反应 查配置文件开头有没有 BOM
提示版本不兼容 核对宿主版本,装对应的插件版本
装完功能没出现 查 dsh.profile.bundles 里有没有登记
装到一半卡住不动 关掉重来一次;还卡就换网络(校园网、公司网常限制 npm 源)
装上后打不开 把最近装的那个插件移出清单,先让软件能起来

最后一条是救援原则:让软件先能开机,再逐个加回来。一次只加一个,加一个重启一次——这不是谨慎,是因为全有全无的启动方式不给你第二次机会。

八、每天怎么用:三条习惯

装对只是及格线,真正决定有没有用的是习惯。

习惯一:能写成 skill 的,不要每次重说。 同一套要求说第三遍,就把它写成 skill。写一段 Markdown 放在合适的位置,以后一句话触发。能力的增长靠积累,不靠记性。

习惯二:让它把过程写成文档。 一次任务做完,让它把步骤、判断依据、踩到的坑写成文档。文档是下次的起点,也是在验证”这次真的想清楚了”。

习惯三:文件给它路径,别给它描述。 “帮我改一下那个表”会得到一堆来回;”按 D:data成绩.xlsx 排名”通常一次就过。

九、一条红线

个人敏感信息不要发到任何联网的服务。

身份证号、家庭住址、银行卡、完整的成绩排名——这些一旦发出去就收不回来。不是技术限制问题,是法律问题。

具体到操作上,三条规矩够用:

1. 需要处理这类数据时,先脱敏(换编号、删列),再交给工具2. 聊天记录、导出文件不要放在同步盘里3. 不确定某个操作会不会外发时,先问一句”这个数据会到哪里去”

—

装完不会用不是你的问题,是没人写中间那段。这篇如果帮你少踩两个坑,它就到地方了。

滚动至顶部