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. 不确定某个操作会不会外发时,先问一句”这个数据会到哪里去”
—
装完不会用不是你的问题,是没人写中间那段。这篇如果帮你少踩两个坑,它就到地方了。