DeepSeek Harness|从下载安装到实际使用(教你养大肥鱼)

hello大家好，我是荒木。DeepSeek Harness 已经发布一段时间了。最近我也花了些时间认真研究了一下，想把自己的使用心得整理出来，和大家聊聊。

这篇文章主要想和大家讨论的是：已经有 Codex、Claude Code 这些工具了，DSH 有什么不一样？处理同一件事，它会更顺手，还是需要多花时间配置？如果以前只用过聊天版 DeepSeek，又该从哪里开始？

一般来说，比较这类工具，我会先看这么几个具体问题：能不能读对我们提供的材料，调用工具时是否顺畅，出错后能不能继续完成任务，以及最后交出的东西能不能用。插件再多、模式再多，也需要放进实际任务里才知道自己需不需要。

本文就从安装、模型和工作区开始，再说四种模式、权限、常用指令和 15 个插件。后面也会聊课程助手、桌宠，以及大家说的“养大肥鱼”。你可以先挑眼前用得上的部分跟着试。

话不多说，我们开始吧。

DSH 是一个开源的智能体框架。普通使用者可以先把它理解成能调用工具、处理文件的 AI 工作台。

你选的模型负责理解需求、判断下一步；DSH 把读文件、改文件、执行命令等工具交给模型，再把过程和结果展示出来。

举个例子：你想从一个文件夹里的会议记录提取待办，在聊天窗口里，往往得先上传材料，再把结果复制回来。使用 DSH 时，你可以选中这个文件夹，让它读取记录，另存一份待办清单。

文件多、操作重复时，这样会比较方便。如果只是偶尔问问题、润色一小段话，继续用熟悉的聊天工具也够用。

和 Claude Code、Codex 放在一起看，DSH 值得关注的是可替换的插件架构。模型适配、工具、会话和 Agent 循环等都被做成插件；它能接不同提供商的模型。具备对应配置和本机工具时，还能通过实验性插件把独立任务交给本机 Codex 或 Claude CLI。

这不代表接上任意模型都能得到同样的效果。模型是否支持工具调用、接入协议是否合适、插件是否兼容，都会影响结果。第一次先配通一个模型，再考虑换。

比较容易用起来的，有下面几类任务：

• 整理材料：从课程笔记、会议记录、读书摘抄里提取重点，生成清单。

• 处理办公文件：生成或修改 Word、Excel、PPT 等文件，具体操作取决于当前技能和环境。

• 查资料：搜索网页、阅读材料，整理带来源的结论。

• 写代码、做小工具：读项目、修改程序、执行测试，或搭一个自己用的简单页面。

• 批量和定时处理：按规则处理多份文件，配置好调度后再定期运行。

不过，“生成了文件”和“已经能拿去交差”之间，还隔着检查。演示稿要看页面，表格要查公式，资料汇总要回到来源核对。原生图表、复杂排版等要求，也要明确提出并实际打开验证。

装在本地，不等于资料只在本地处理。 使用在线模型时，任务需要的材料可能会发送给模型服务商。练习先用公开资料或没有隐私内容的副本。

DSH 目前仍属于开发者预览软件。官方安全说明提醒，沙箱、权限和审批可以降低风险，不能保证隔离，也不能保证文件不受损。重要材料要备份，条件允许时在专门的测试环境中运行。

它也不是“软件开源，所以所有任务免费”。在线模型调用、搜索、抓取，以及一些插件接入的服务，都可能产生费用。

图片能力要看具体模型。图片输入以所选模型的能力列表为准：例如，当前 DeepSeek 官方列表中的 Flash 支持图像理解，Pro 则标为不支持。还要检查接入配置，不能笼统地说“DSH 都看不了图”。

从官网进入下载页：

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

官网提供 macOS Apple 芯片版和 Windows 64 位版安装包。先确认电脑符合要求，再下载安装。

Windows 按安装向导操作；Mac 按安装包提示放进应用程序目录。安装位置按自己的磁盘空间安排，不需要为了照抄教程特意换到某个盘。

遇到普通的应用来源提示，按官方说明处理。出现网站不安全、证书异常等错误，则先检查下载来源。

安装满足当前项目要求的 Node.js，然后运行官方 README 给出的命令：

终端会给出浏览器访问地址，默认通常是：

这里的“网页版”是浏览器连接你启动的 DSH 服务。服务运行在本机时，关闭相关进程后，页面和依赖它的任务就可能无法继续。别把它理解成一个电脑关了也会一直替你工作的云端网站。

不想处理 Node.js 和终端报错，就先用桌面版，两条路线不用都走。

API 可以简单理解为软件调用模型的入口。API Key 就是调用时使用的密钥，关系到你的额度和账单，不要发在评论区，也别截进教程图里。

如果安装后的界面提供账号登录，按提示操作；如果使用自己的 API Key，就在“设置 → 模型”里配置。第一次先用一家熟悉的服务，把连接跑通，别同时添加好几个提供商。

密钥保存成功，还不算配置完成。 官方文档特别说明，凭据检测不会验证密钥是否有效，也不会测试连接。最后还是要选中模型，发一句“请用一句话回复，确认连接正常”，看它能否正常回答。

报错时先读提示：密钥不对就检查密钥，余额不足就看账单，连接失败再检查网络或接口地址。先别急着换插件。

在电脑上新建“DSH练习”，复制三份简短的课程笔记进去。第一次建议用 TXT 纯文本，减少文件格式带来的干扰。

然后在 DSH 里添加并选中这个文件夹。这个文件夹就是工作区，也就是这次任务主要读写文件的地方。官方 Web UI 指南明确写了：没有选中工作区，输入框不能使用。

不要把整个桌面、文稿目录都选进去。先用副本练习，原文件留在别处。

登录和跨设备同步是不同的功能，不能把登录当成自动备份。换电脑前，分别确认会话、工作区文件和插件配置怎么迁移，不要默认“登录后全部都会回来”。

左侧主要找会话、工作区和插件；中间看对话和任务过程；文件、终端、浏览器或预览面板，则根据版本和已启用功能显示。

想知道它为什么做错，可以展开工具调用或“轨迹”，检查读了哪个文件、有没有报错、是不是只处理了一部分。只看最后一句“已完成”，看不出这些问题。

先用标准模式，权限选“仅可查看”。发下面这段，确认它读对材料：

看它列出的名字是不是你放进去的那三份，概括有没有对上内容。

如果它说“没有找到”，先检查工作区选对了没有，再检查文件是不是确实复制进去了。不要马上让它“去整台电脑找找”。

材料核对无误后，把权限调整到允许工作区内修改，再发：

文件名后面的“.md”是一种文本格式。这次用它，是因为打开方便，也便于检查。你可以用文本编辑器查看，不需要额外装一套办公软件。

如果想先看方案，也可以在当前版本的“/”菜单里找计划功能；没有找到时，直接写“先说明准备怎么做，等我确认后再修改”。不过，这句话不能代替软件本身的权限设置。

打开生成的文件，至少检查这几件事：

• 三份材料有没有都用到，还是只整理了其中一份。

• 随机挑几条结论，能不能在它标注的原笔记里找到依据。

• 原来写“没弄懂”的地方，有没有被它整理成“已经掌握”。

• 原文件是否还在，新文件是否保存在你选的文件夹里。

发现问题，就指出具体位置。例如：“第二份笔记说我还没理解缓存，你却把它列入已掌握，请检查类似错误并修改清单。”这比“再优化一下”更容易得到可用的修改。

如果你最后需要 Word 或 Excel，再明确告诉它文件格式，并确认当前环境具备相应能力。文件能生成、能打开、内容正确，这三件事要分别检查。

模式影响它怎样完成任务，权限决定哪些操作能执行，斜杠指令提供计划、换模型等快捷入口。它们不是一回事。

四种模式，按任务来选

标准模式：先用它。读材料、改文件、查资料这类日常任务，可以从这里开始。

PTC 模式：让模型通过程序组合工具调用。例如，一批文件要做相似处理，可以把多个步骤串起来，减少模型来回安排动作的次数。

极简模式：工具组合更精简，适合了解终端和文件操作的人，或用于对照测试。名字里的“极简”，不等于最适合零基础用户。

创造模式：用来改造 DSH 本身，比如创建插件、调整工具和工作方式。普通文件整理用不到，想做自己的插件时再研究。

PTC 会不会更省钱？小任务未必。通过程序安排工具调用，本身也有开销；只有几份笔记时，没必要为了用上 PTC 特意切换。

工具调用少，不等于实际账单低。比较时要尽量使用相同材料、模型和输出要求，同时看正确性、耗时和费用。

模式能否在会话中切换，请看实际版本。有些版本或组合会限制切换；遇到不能改的情况，先保存任务摘要再新建会话。换模型，也不一定同时改变执行模式。

四档权限，不用一开始就开最大

仅可查看：适合先检查材料、讨论方案，需要保存文件时再调整。

工作区内修改：允许在指定范围内处理文件。触碰其他资源时，是否需要审批还要看当前策略。

完全权限：开放范围更大，但不能理解成任何操作都无需确认，更不能保证模型不会误改材料。

自动授权审查：由模型参与判断操作是否应该放行，部分版本作为实验性能力提供。能减少一些手动确认，也可能误判，并产生额外用量。

日常可以先只读核对材料，再放开所需写入权限。提示词里的“不要删除”能表达要求，真正的访问限制仍要在软件里设置。工作区也不能被当成绝对安全的隔离区。

八条指令，知道用途就够了

输入“/”查看当前会话的菜单。不同版本、模式和插件组合可能显示不同项目，以下是这篇指南涉及的八项：

• /plan：进入计划流程，先看准备读什么、改什么，再决定是否执行。

• /permission：查看或调整权限，省去反复找设置入口。

• /compact：压缩较早的上下文，压缩后仍要核对目标和重要约束。

• /file：在提供该入口的版本中添加文件，也可以用实际界面的附件入口。

• /model：切换模型，注意能力、价格和上下文容量的变化。

• /goal：设置持续推进的目标，但仍受权限、轮次、额度和阻塞条件限制。

• /feedback：提交反馈，附上版本、错误信息和复现步骤会更有帮助。

• /export：导出会话记录，具体格式以界面为准。导出聊天记录不等于备份整个工作区。

先找到计划、权限和模型入口就够了。聊得长了再用压缩，要留档时再导出，不需要背口诀。

菜单里的 Word、PPT、Excel 也可能是技能入口，不是所有以“/”开头的选项都是同一类功能。打开菜单和实际让模型执行任务，也不能混成一句“指令都不收费”。涉及模型处理时，要看实际用量。

这 15 项不用全部安装。先有一个明确需求，再挑对应工具，后面出问题也容易排查。

安装前先核对兼容版本。插件数量和星数不能替你判断是否适合当前任务。

常见的三种安装入口

第一种，在“插件 → 添加插件”中，按项目说明填写包名、GitHub 地址或支持的本地路径。

第二种，把项目地址交给 DSH，让它先读文档，检查版本和权限，再交一份安装方案：

第三种，通过插件市场查找和安装。能搜到，不代表市场替你完成了安全和兼容性验证；也有项目需要走发布包安装路线。

官方功能也先看一遍。搜索、终端、子智能体等可能已提供；团队协作、自动授权审查、自动化等则要看安装包和开关。不要为了已有入口，再重复装一套工具。

先看清用量和上下文

1．dsh-cost-meter：查看会话、模型费用和 token 用量，也提供预算、余额等相关展示。想弄明白“钱花在哪了”，可以从它开始。最终扣费以服务商账单为准。

https://github.com/Han-1413141/dsh-cost-meter

2．dsh-context：查看上下文组成、变化和压缩情况。对话越聊越长时，可以借它看看哪些内容占了空间，但它不会保证模型永远记得住。

https://github.com/bowenliang123/dsh-context

3．dsh-market：查找、安装 DSH 插件的入口。把它当成找工具的地方，不必把推荐列表装满。

https://github.com/2BingLing/dsh-market

缺哪项能力，再补哪项

4．ModLens：为纯文本模型提供视觉桥接，把图片中的文字、布局等转成结构化信息。已经使用合适的视觉模型时，不必默认再加一层，还要看它会调用什么识图服务。

https://github.com/liustack/modlens

5．dsh-image-gen：把生图、改图接进 DSH 对话。安装插件和具备可用的图像生成服务是两回事，要看清所需接口、密钥和费用。

https://github.com/shanliuling/dsh-image-gen

6．dsh-agent-teams：让多个 Agent 分工、并行处理，再汇总结果。适合可以拆成独立部分的工作，简单任务未必需要组队，多开成员也会增加用量。

https://github.com/NanmiCoder/dsh-agent-teams

如果当前版本已提供官方团队功能，也可以先看是否够用。任务可以说成“一个整理材料，一个核查来源，最后由主 Agent 合并”，同时约定文件归属，避免同时改同一份文件。

7．dsh-memory-evolve：保存跨会话的长期信息，例如项目约定、偏好和进度。需要同步时还要单独配置；记住了错误结论，也要能找到并修改。

https://github.com/csyangwen/dsh-memory-evolve

8．dsh-rewind：回退对话，并按其追踪和备份范围还原文件。这个仓库对应的安装包名是 dsh-rewind-plugin，不要直接安装 npm 上同名的 dsh-rewind。回退前看受影响文件清单，不能拿它替代完整备份。

https://github.com/SiriLee/dsh-rewind

9．dsh-chat-import：把其他 AI 编程工具的历史会话导入 DSH。先检查支持的来源和格式；导入记录，不等于原软件、插件和文件环境一并搬过来。

https://github.com/Nwflower/dsh-chat-import

手机访问和界面调整

10．dsh-pocket：电脑运行 DSH Web 服务，手机通过局域网或配置好的公网入口访问。电脑上的服务仍要运行，访问链接和密码不要公开分享。

https://github.com/shaobeichen/dsh-pocket

11．dsh-im：在即时通讯平台里向 DSH 提交任务、接收结果。各平台条件不同，不能把“支持某平台”理解成装完就自动登录所有账号。接群聊前，先确认谁有权触发任务。

https://github.com/xmanrui/dsh-im

12．dsh-web：一组 Web 界面扩展。可以按当前版本查找会话管理、任务组织等能力，不用把整套扩展都装上。

https://github.com/zhu1090093659/dsh-web

桌宠和“养鱼”相关

13．dsh-pet：在桌面显示动画宠物，支持调整大小、位置和素材。有角色在动，不等于已经具备聊天、记忆和自主操作能力，这些需要另外配置。

https://github.com/PC2005-cloud/dsh-pet

14．dsh-bili-scroll：读取 B 站内容和字幕，筛选视频、整理日报。先检查字幕能否读取、平台交互如何配置，不要默认它已经看过完整视频画面。

https://github.com/c1overzz/dsh-bili-scroll

15．dsh-bili-humanism：围绕 B 站内容整理私人手账和可修订记忆。项目当前没有提供评论接口；历史、收藏、点赞、投币等有各自开关和限制。桌面版安装还有专门步骤，并非保证粘贴仓库地址就能装好。

https://github.com/InariNGT-Ofiicial/dsh-bili-humanism

每装完一个，先做个小任务确认能用，再继续。升级后失效，先查兼容说明和发布记录，不要靠反复点“允许”碰运气。

接下来可以试一个“课程助手”：读取指定课程，整理知识笔记，已有学科更新旧笔记，新学科新建一份，再配一个能启动、停止和看结果的页面。

这个方向可以做，但先把内容读取跑通，再加自动化。从浏览器拿到链接、拿到字幕、看到画面，是三种不同能力。有的课程没有可用字幕，有的涉及登录或访问限制，不能只凭标题就写“完整课程总结”。

新建“课程助手”工作区，选一段你有权使用的课程，或者准备一份课程字幕文本。

先检查现有工具是否能读取课程内容、保存笔记、识别已经处理的课程。需要跨会话保留信息时再加记忆能力，缺什么补什么，不必重复安装。

先用标准模式也可以。涉及大量相似步骤时，再试 PTC，比结果和费用。通过计划入口发需求：

拿不到字幕时，可以先导入自己已有的授权文本。确认能生成有依据的笔记，再解决浏览器读取，不要让几个没跑通的环节一起开始。

手动结果没问题后，再补充：

开始把间隔设宽一些，观察一两次，确认切换课程、跨学科归档和停止按钮都正常。还要检查重启后会不会重复处理、失败会不会反复扣费、关掉页面后任务是否仍在运行。

最后可以加桌面快捷方式，方便打开页面。但快捷方式不等于程序已脱离 DSH 独立运行。如果要做独立应用，还得确认打包、运行环境和启动方式。

完成后，分别保存会话记录和工作区文件，以后迁移时两样都可能用得上。

“大肥鱼”是社区里对 DeepSeek 拟人角色的称呼，常见形象带有蓝鲸元素。所谓养鱼，大致是给它配上人设、长期记忆、桌面形象和聊天入口，让交流能接着上次继续。

分开看就没那么神秘：桌宠负责显示，模型负责回应，记忆保存信息，平台连接收发消息。它们不一定由同一个插件完成。

桌面陪伴、QQ 聊天和跨平台记忆

想先看到角色出现在桌面，可以从 dsh-pet 的素材和显示功能开始。想让它主动聊天、记得前情，再检查相关服务有没有连通。

QQ 方向，常见方案包括 AstrBot 和 NapCat。涉及消息平台、账号和机器人接入，需要单独配置，不是 DSH 点一个开关就完成。系统和版本不同，步骤也不宜混用，先照项目文档测试自己的小号。

如果想让角色在 QQ、B 站和桌面接着上次的话聊，就要让几个入口共用人设和记忆。先确认各入口读写哪份数据、是否同步，以及怎样删掉错误信息。仅仅给它们取相同的名字，不会自动共享记忆。

“会淡忘”“会成长”要看具体实现。长期记忆和上下文积累，也不等于模型参数已经被你训练或微调。

替你刷 B 站、看抖音，或者做直播角色

刷 B 站可以从“读内容、写一份私人日报”开始。说明想看什么、不看什么、一次处理多少，并保留视频链接。字幕总结和画面判断分开写。

抖音、直播也需要组合不同能力：内容读取、角色、声音、消息入口和直播软件要分别连通。可以先测试一段内容能否读取，再检查角色和声音输出，最后连接直播软件。

只是想玩陪伴聊天，就没必要同时开放发评论、动态和投稿等权限。

“鱼灾”背后，是自动互聊和公开发布的问题

多个机器人如果把彼此的消息都当成新任务，就可能不断接话。公开区域被自动留言占满，主人的调用费用也会跟着增加。

网上流传的评论占比和个人月账单，缺少完整口径时不适合拿来做自己的使用预算。限制触发对象、频率和停止条件，比拿别人的低价账单估算自己的开销更有用。

初次尝试，用小号，把结果送到自己指定的私人入口。不要把电脑文件、凭据写进平台消息；接群聊时，限定能派任务的人。能关闭的公开发布接口先关闭，预算和停止按钮也要能找到。

1．输入框是灰的

先看工作区是否选中，再看模型是否可选、服务是否仍在运行，不要一上来重装。

2．模型配了，还是报错

保存凭据不等于连接测试。按错误提示查密钥、余额、接口地址和网络。贴日志求助时遮住密钥。

3．找不到文件，或者只整理了一部分

让它先报文件名、读取范围和失败项。扫描版 PDF、受保护文件、格式不支持，都可能影响读取。没读到材料时，不要继续要求写“全面总结”。

4．聊久了忘要求，或者重复干活

先整理任务摘要，再考虑 /compact。关键约定可以单独存成文件，新会话明确要求读取。记忆插件写进去的内容也要检查。

5．模式选错，或开了权限仍要确认

检查版本能否切模式，不支持时保存摘要再开新会话。审批取决于具体动作和策略，完全权限也不能理解成永远不询问。

6．升级后插件不能用

核对 DSH 和插件版本、安装包名。先停用有问题的插件，保留错误信息，再按文档处理。相同名字的仓库和 npm 包未必是同一个项目。

7．账单比预期高

模型处理的不只是你刚输入的那句话，还可能包括旧对话、材料和工具结果。多 Agent、重试、轮询都会增加用量。DeepSeek 官方 API 的搜索、抓取另行计费，空闲与高峰价格也有区别，按实际价格页和账单核对。

即使让同一个模型通过不同工具完成相同任务，也不能只看一次账单就做长期排名。版本、缓存、重试和输出完整度不同，都可能影响费用。

8．自动化停不下来，群里谁说话都能触发

先停止调度或对应连接，再查触发条件、账号白名单、去重和重试上限。提示词里说“别乱回”，不能替代连接层的限制。

停下后查看任务状态，确认没有后台进程或其他入口继续触发。工作区、会话和配置分别备份，不依赖“下次登录就自动回来”。

• 安装入口：DeepSeek Harness 官网，核对系统和芯片要求。

• 命令行启动：npx @deepseek-ai/dsh web，Node.js 要符合当前要求。

• 首次配置：模型能正常回复，工作区路径正确。

• 初次任务：标准模式，先只读核对，保存时再放开所需写入权限。

• 批量处理：可以比较 PTC，同时看正确性和实际费用。

• 计划与权限：在当前“/”菜单查 /plan、/permission，不只靠提示词约束。

• 长对话：整理摘要，必要时 /compact，重要约定单独保存。

• 插件：15 项按需选，核对版本、安装包名和访问范围。

• 回退插件：上文回退插件对应的包名是 dsh-rewind-plugin。

• 课程助手：先验证内容读取，再加分类、去重、页面和定时运行。

• 养鱼：显示、聊天、记忆、平台连接分开配置；小号、私人结果、限制触发范围。

• 费用：看服务商账单，限制频率和重试，定时任务要能停止。

• 留档：会话记录、工作区和必要配置分别保存，不公开打包明文密钥。

以上就是本期的内容，感谢大家看到这里。

非常欢迎用过DeepSeek Harness或者是准备上手的朋友，如果觉得好用的插件，或者遇到过什么问题？欢迎在评论区一起聊聊，也给准备上手的朋友一些参考。

后面我会继续分享 AI 工具的使用心得和实用教程。感兴趣的话，欢迎关注，我们下期见。