DeepSeek Harness 安装教程：要什么配置、大肥鱼人设插件怎么装（2026）

DeepSeek Harness 安装教程：要什么配置、大肥鱼人设插件怎么装

先把三个最常见的检索词一次答掉。

配置要多大？ 用官方 npm 包跑（npx @deepseek-ai/dsh web），硬性条件只有一条：Node ≥ 24.9.0（仓库 package.json 的 engines 字段，2026-11-09 核对）。模型通过 API key 由云端推理，普通桌面机够了，没有显卡要求。

安装要几下？ 这一条命令，浏览器会自动打开 http://127.0.0.1:3080，再在 Settings → Models 里填 DeepSeek API key，就完成全部初始化（官方 Web UI 指南，2026-11-09 核对）。

大肥鱼插件怎么装？ 「大肥鱼」是 DSH 社区的鲸鱼娘人设 IP，围绕它有一族人设、表情包、桌宠、QQ 机器人插件。装社区人设插件最省事的路线是复制预设文件加合并补丁，Web 端三步，下文第五节展开。

一、它是什么

DeepSeek Harness（命令行叫 dsh）是 DeepSeek AI 在 GitHub 上开源的 agent 底座，架构口号是「Everything is a Plugin」，底层基于 Cordis 组合式框架，MIT 协议（官方仓库，2026-11-09 核对）。开源时间不长，Star 已到 27.7 万、Fork 3.4 万，仓库四天前还在更新——热度和迭代速度都在「周更破坏兼容性」的量级上。

两条对你的使用方式有直接影响的官方提示，放在最前面：

• 这是 developer preview。README 原话是「会破坏兼容性（THEY WILL BE BREAKING CHANGES）」。插件和自定义补丁要记下你装时的版本号（写作时是 0.2.2-rc.1），出问题先怀疑版本变化。
• 官方要求先读 SAFETY.md 再运行。dsh 的 agent 能读你的文件、执行命令，权限策略没配好之前，别把重要目录设为 workspace。

二、要什么配置：三档分开看

「要多大配置」取决于你打算怎么用，三档结论完全不同。

第三档值得多一句：dsh 是 agent 底座，模型既可以配 API key 也可以配自定义 OpenAI 兼容端点（官方 providers 指南）。所以「显卡不足」不会拦你用 dsh——它只决定你必须用 API。真想本地推理 V4 的，8 张 24GB 消费卡才勉强放权重，多数人的正确答案是接入云端 API，按 token 计费的模式见Token 包月与按量对比。

三、安装：五分钟流程

官方 README 的最短路径，五个动作（README，2026-11-09 核对）：

# 1. 装 Node.js，版本 ≥ 24.9.0（node -v 可查）
# 2. 在你想当工作区的目录里执行：
npx @deepseek-ai/dsh web
# 3. 浏览器自动打开 http://127.0.0.1:3080
# 4. Settings → Models 里填 DeepSeek API key（platform.deepseek.com 申请），保存即生效，不用重启
# 5. 回到首页点「Choose workspace」，把刚才那个目录加进来选中

三处容易迷路的地方：

• workspace 不选，会话输入框不出现。这是新手反馈里最常见的「装完不知道下一步」——dsh 用启动它的目录当默认文件系统位置，但 Web 界面上要先手动加一次 workspace。
• SSH 到服务器上跑时，浏览器不会自动弹开，命令只打印 URL，地址转发交给你的 SSH 客户端决定（官方说明）。本机跑才走第 3 步的体验。
• --no-open 可以只起服务不开浏览器；端口冲突时从 arguments 里换 --port。

装成之后先发一句官方建议的测试任务（「Summarize this repository…」），能看到它读文件、列计划，说明链路通了。

四、哪个入口：npm、桌面版还是源码

三入口的差别（均为核对过的官方/项目说明）：

一个重要细节：npm 方式启动的 CLI 拒绝插件管理请求（dsh plugin 子命令只在 Desktop 自带的运行时下可用）。所以从 npx 走的插件安装，实际用的是「文件 + 配置补丁」路线——这正好是大肥鱼人设插件的官方装法，见下一节。

五、装大肥鱼：Web 端三步

「大肥鱼」是 DSH 社区造出来的鲸鱼娘形象，社区里顺着它长出了一整族插件（第四节的表）。人设类插件以 dsh-whale-musume-persona（社区开源，MIT）说明走上手最完整的路径，装完后新会话默认就是「傲娇但很甜、思考过程强制中文」的鲸鱼娘，编码能力不受影响。

它 README 里最值钱的一段是为什么直接改 persona 不生效：DSH Web 的每个会话挂在 agent preset（默认 standard「标准模式」）上，preset 自带的 persona 行会遮蔽部署级的 persona 配置。所以只把人设写进部署 persona，Web 上什么都不会发生。正确做法是把人设写成新 preset（default: whale）。三步（对应插件 README 的安装节，2026-11-09 核对）：

# 1. 复制预设目录到用户预设根：
mkdir -p ~/.dsh/.agent-presets && \
cp -r agent-presets/whale ~/.dsh/.agent-presets/whale

# 2. 把仓库里的 cordis.patch.yml 合并进你的 web profile：
#    ~/.dsh/profiles/web/cordis.patch.yml
#    把以 - id: 开头的 system-prompt 与 agent-presets 两个段追加到文件末尾，原内容保留

# 3. 重启 dsh web

第 3 步之前有个偷懒选项：预设发现是实时的，不重启也能在新建会话时手动选「鲸鱼娘模式」，只是 default: whale（新会话默认人设）要重启才生效。已存在的会话保持创建时的预设，改了也不会变。

TUI 和 headless 模式不走 preset，合并 system-prompt 一个条目就生效。卸载就是反着删：删预设目录、移除补丁条目、重启。

六、大肥鱼插件族：一鲸带全家

人设装完，这个形象在 DSH 生态里还能长出这些用途（全部社区开源项目，星数来自 GitHub 仓库页，2026-11-09 核对）：

找插件的正确姿势是 GitHub 的 dsh-plugin 主题标签和 awesome-dsh-plugin 精选清单（23.9k 星）。装之前照人设插件的做法先读一遍 README。官方 SAFETY.md 明确写了：项目能执行模型生成的代码、加载第三方插件、访问文件与凭据，「不要把它当唯一的安全控制」。

它给的使用红线四条，都值得装社区插件前过一遍：最小权限运行；优先放在一次性虚拟机或容器里；备份它能碰到的文件；运行前把插件配置和拟执行的命令人工过一遍。别信插件 README 只写到安装那一节。

七、高频问题

安装命令卡住/很慢。 两个已知原因：Node 版本低于 24.9.0 时 npx 可能拉旧版兼容包装出问题；网络到 npm 源慢。先 node -v，再考虑换 registry 镜像。

填了 API key 没反应。 看两处：key 是 platform.deepseek.com 的（不是其他站）；模型路由保存后即时生效，但已开的会话不换模型，新开会话再试。

想在服务器 24 小时跑。 Web UI 支持反代部署，官方有 public-deployments 指南。VPS 按 比价页 选 2核2G 档即可，dsh 本体不是性能瓶颈。

升级破坏了我的插件。 preview 阶段无解，官方明说了兼容性破坏。应对：记版本、改动前把 ~/.dsh 和 profile 目录备一份、破坏后按插件 README 重装而不是猜。

延伸阅读：DeepSeek V4 显存需求 · Token 包月还是按量 · 平台插件清单与 DSH 插件商店

本站部分链接为联盟推广链接。dsh 相关事实以官方仓库与文档为准，核对日期 2026-11-09；大肥鱼相关插件均为社区开源项目，与 DeepSeek 官方无隶属关系。