DSH 新手第一天:先跑通,再装这五个插件

DSH 的全称是 DeepSeek Harness，它是一个插件化的 Agent 运行时，官方理念叫「一切皆插件」。

这句话的分量在于：模型适配器、工具注册表、会话日志，连 Agent 循环本身统统都是插件，没有一个模块是焊死的特权核心。想换模型、换工具、换交互方式，都不需要动内核。

对新手真正有价值的只有一句：会话管理、流式输出、工具调度、Web 界面全都开箱即用。你不用先写一个 Agent，再自己拼记忆、拼工具调用、拼状态管理——这些它已经做完了。

于是你的精力只需花在三件事上：接一个模型、写一份说明书、装几个插件。做完这三件，它就从聊天框变成了替你干活的搭档。

DSH 是 Node 生态里的工具，装之前先确认本机有 Node.js 与 npm，然后全局安装：

装完直接起服务，起服务只需要一条命令。dsh web 是 dsh --profile web 的硬编码别名，它会拉起一棵 Cordis 插件树，在本地监听端口，再把前端页面回传给你：

命令行不再刷日志，浏览器打开 http://127.0.0.1:3080 能看到界面，这一步就算真正跑通了。首次启动会在 ~/.dsh/profiles/web/ 下生成 profile 目录，cordis.patch.yml、package.json 这些核心文件都在里面——先别急着改它们，记住位置就够了。

界面出来后先做一件事：把模型配好。DSH 默认接 DeepSeek，你也可以在设置的「模型」页，或者用环境变量（比如 DEEPSEEK_BASE_URL）换成自己的接口。

这里有个新手常踩的坑：默认的文本模型看不到图片。如果你要做读图、看图、图像处理这类任务，得再装视觉类插件，别对着模型质问它为什么「看不见」。

判断跑通的标准很简单：跟它说一句话它答得上来，让它读一个文件它读得到。这两件事成立，再往下走。

DSH 有四种部署方式，它们解决的不是同一个问题，别一上来就选最难的那个。

dsh web：一条命令起服务，本地监听 127.0.0.1:3080，零额外配置。它是新手第一天最省事的选择，缺点也很清楚——依赖你这台电脑开着。

本地服务：DSH 用 Profile（配置档）+ Bundle（npm 包）+ Patch（补丁）+ Plugin（插件）四层模型，靠「空根 + 补丁叠加」动态组装 Agent。这条路可定制性最高，代价是你要先啃下这套概念。

桌面端（Desktop）：图形界面、不用命令行，由社区维护，内容创作者用它最省心——装好点开就能用，不用记命令。

云端部署：跑在云服务器上，最大的好处是合上电脑 Agent 还在跑，适合长任务和远程协作。代价也最大：要配云服务器和内网穿透（比如 Cloudflare 隧道），还得在 ~/.dsh/profiles/web/cordis.patch.yml 里把域名加进 trustedHosts 白名单；配合 dsh-bridge，手机扫码就能接入微信、飞书、QQ、Telegram。另外它有公网暴露风险，必须做好双密码、防暴力封禁这类安全认证。

结论不复杂：先用 `dsh web` 或桌面端跑通，熟悉之后再决定要不要深挖或者上云。

新手最容易混的就是这三个词，其实它们管的是三件不同的事。

插件（Plugin）：决定一种能力怎么进运行时、在哪个作用域生效、什么时候退出。把 DSH 想成操作系统，插件就是应用商店里的应用，dsh plugin 命令就是那个包管理器。

技能（Skill）：告诉模型这类任务该怎么做——怎么拆步、什么时候调用哪些工具、怎样算验收通过、哪些判断仍然留给人。它是可选指令而非会话事件，完整正文按需加载，不会占满每一轮上下文。

MCP：解决外部系统怎么标准化接进来，把远端的工具、资源注册给 Agent 使用。

还有一个不能漏的角色是配置文件，比如 AGENTS.md：它是给 Agent 看的说明书，讲清项目概述、架构、目录和常用命令。设计原则是目录索引而非百科全书——控制在百来行，拆成多个专注文档串起来，而不是写成一个巨大的说明书。

它们会同时出现在一个任务里：一份「发周报」的技能，可能既要调用文档类 MCP，又要跑本地脚本，而这一切靠插件装进运行时。一句话记住：技能管方法，MCP 管外部，插件管安装分发。

所有插件都走同一条安装命令，<包名> 换成具体插件：

不想全局安装也行：npx --yes @deepseek-ai/dsh plugin --profile web add <包名> 一样能装。下面这五个是我建议新手第一天装齐的组合。

① dsh-market（插件市场）。社区插件已经涨到数千个，它解决的是「从哪里找靠谱插件」：把插件说明、GitHub 地址、安装命令集中展示，你不用再一个个去 GitHub 上翻。

② DSH-better-sidebar（侧边栏）。主流 Agent 的第一位置是对话框，第二个位置就是侧边栏。装完之后能直接看到目录里有什么、支持 `@文件` 拖进对话、右侧还会列出这次对话涉及的文件，找文件不必一页页往回翻：

③ dsh-im（IM 机器人接入）。以 dsh-bridge 为例，它内置独立的「IM 机器人」控制面板，填 AppID 与 Token 就能启用：微信扫码直连、QQ 官方机器人、飞书走 WebSocket 长连接免公网、Telegram 用官方 Bot API 且支持按钮确认。最实用的一点是产物自动回传——任务生成了文件或图片，会自动打包推到聊天窗口，手机上直接看结果：

④ dsh-cost-meter（成本计量）。它在侧边栏显示每个模型账户当日的 token 消耗和账户余额，还能按模型、按会话看明细。这东西的价值在于：API 按输入输出分别计费，输出通常比输入贵两三倍，看着数字涨，你才知道该在哪里收手。

⑤ dsh-automation（定时任务）。支持用 Cron 定时真实执行，日报、每日新闻、每日研报、定时内容产出都能排上。定时任务配合公众号技能，就能做到每天自动产出内容。

装完这套，DSH 才算从「一个对话框」变成能干活的 AI 工作台：知道去哪找插件、有文件管理、能远程遥控、看得见成本、还能定时自己干活。

技能最容易被误解成「一个 npm 包」，其实它更接近一份可执行的岗位说明书：这项工作怎么拆步、何时调用哪些工具、怎样验收、哪些判断仍然留给人。

它真正的价值有两点。一是按需加载，技能是可选指令，不占满每一轮上下文，需要时才读进来；二是经验打包——下次遇到同类任务，不必再从零解释一遍要求。

举个我自己每天在用的例子：公众号运营最耗时间的从来不是写作，而是排版、传图、上传后台、配封面这些重复动作。一条成熟的链路是三个技能分工：写稿技能负责搜资料、整理结构，排版技能负责把 Markdown 转成公众号 HTML 并套主题，发布技能负责把文章推进草稿箱。配套要准备公众号后台的 AppID、AppSecret，并把调用接口的出口 IP 加进白名单。

注意最后那一步的措辞：推进草稿箱，而不是替你群发。这条链路的完整形态是「写稿 → 排版 → 推草稿 → 人工审核」，前面 80% 交给自动化，最后 20% 的发布决定权始终留在人手里。

不能。DSH 目前仍在 preview 阶段，插件装多了很容易冲突崩溃，这是新手第二天最常见的翻车现场。

稳妥的做法有三条。第一，只装社区持续维护、被筛选过的插件，别看见一个就装一个。第二，装之前让它替你审一遍源码——拿不准时就把这句话丢给 DSH：「帮我确认这个插件地址，检查它是不是真的 DSH 插件、源码有没有问题」。第三，把自动化当成半自动：前面 80% 自动化，最后 20% 人工把关，这条比例在内容、代码、运营场景里都成立。

第一天还有几件事可以不做：不必急着深挖本地服务的四层模型，不必现在就去配云服务器和内网穿透，更不必把插件市场逛成一个收藏夹。先把一条链路跑通，比装满一屏插件有用得多。

DSH 不一定适合所有人，但如果你确实需要它，希望这篇能帮你把第一天用对。

让天下没有难用的AI。

#DSH入门# #AI工作台# #插件化Agent# #dsh-web#