夜雨聆风学习资料网

ARTICLE · 1367252

DeepSeek Harness 插件Top20推荐

DeepSeek Harness 插件Top20推荐

上次那篇《DeepSeek Harness 5个必装插件(2026年11月最新)》写完那 5 个插件之后,反响挺大,留言炸了。

是真的有人在追问:

“还有吗?”

“能不能按场景给个清单,我想照着装。”

还有个读者留言说得很扎心:“看了你那篇,我装了 4 个,结果感觉没变,是不是我不会用?”

这句话我反复看了几遍。

因为它说对了一件事——DSH 的插件不是“功能开关”,是“工作模式的切换器”。你装完 dsh-context,它不会替你把上下文理顺;你装完 billion-context,它也不会自动帮你省 token。它只是把一件原本需要你自己手动干、或者根本干不了的事,交给 agent 去干。

明白了这一层,插件才有意义。

所以这一篇我干了三件事:

  1. 把全网最火的插件扒了一遍(去 GitHub、npm、三个插件市场、官方仓库的 discussions 交叉核对)
  2. 筛出 15 个新增的(加上之前那篇的 5 个,正好 20)
  3. 每一个都写清楚:它解决什么问题、怎么装、装完第一件事做什么、以及——什么时候你根本不该装它

最后这一条,是我这次想重点加的东西。

因为插件装多了反而不妙。 每个插件都会往系统提示词里塞自己的工具描述,工具一多,模型选错工具的概率就上去,token 也烧得更快。我这次会明确标出哪些是“闭眼装”、哪些是“看情况”、哪些是“少数人用得上”。


先说数据:这次我到底怎么排名

上次那篇我说过,DSH 现在有 16000+ 个插件。这次我又跑了一遍几个社区目录,最新的口径是:

  • dshmarket.com:10778 个社区插件(只收 GitHub dsh-plugin 话题下、真正声明了 dsh.bundle 的那一批)
  • dshmarketplace.dev:16000+ 条
  • awesome-dsh-plugin 人工精选:50 个
  • harnesscatalog.com / dshplugin.app / dshbazaar.io / dshplugins.cc:各自一份独立索引

数据量已经不是重点了。重点是热门榜的排序逻辑不一样:

  • dshmarket.com 的“Most installed”是按 npm 近 30 天下载量排的
  • dshmarketplace.dev 的“Top”是按 star 数排的
  • harnesscatalog.com 是按 star + 更新时间排的

这三份榜单的头部不完全重合。这就是我这次要写 20 个而不是 10 个的原因——每一份榜单漏掉的东西,恰好是另一个人群需要的。


顺便回顾:上一篇那 5 个

上次那篇详细讲过的,这里用一张表带过,细节去翻那篇《DeepSeek Harness 5个必装插件(2026年11月最新)》。

#
插件
一句话
装完第一件事
1
dshmarket
(dshmarket)
把插件市场塞进 DSH 设置页
重启后开 Plugins → Plugin Market
2
@liustack/modlens
给纯文本模型装上眼睛(OCR + 版面 + 实体)
模型选择器里选 (modlens vision)
3
@linxin666/dsh-web-ui-all
界面从毛坯房变工作台(含右侧工作台)
处理 ERR_PNPM_IGNORED_BUILDS
4
dsh-web-search-pro
20 个平台定向搜索,B站/小红书/知乎能扒
browser 也要一起装
5
@deepseek-harness-tui/dsh-tui
把交互搬回终端,像 Claude Code
全局装完直接 dsh-tui

这 5 个是地基。 下面 15 个是墙。

但有个前提我还是得再强调一遍,因为它决定了这篇文章能不能帮到你:

装插件前的三条规矩

一、先装 pnpm。

npm install -g pnpm

在你敲第一条插件安装命令之前。 不然你会看到一堆看不懂的报错。

二、插件装在 profile 里,不同 profile 互不相通。

dsh plugin --profile web add <包名>

你给 web 装的,不会出现在 dsh-tui 里,也不会出现在 DSH Desktop 里(Desktop 有自己的 desktop profile)。给 Desktop 装插件,得从 Desktop 内置的插件页面里装。

三、插件是第三方代码,权限跟你本人一样大。

DSH 的工具审批沙箱不覆盖插件代码本身。装之前我会做三件事,你可以照抄:

  1. 看 package.json 里有没有 postinstall 脚本
  2. 敏感项目把 sandbox 调到 read-only 或 workspace-write
  3. 重要插件锁 commit:github:owner/repo#<sha>
“

另外一条很多人不知道的:--profile web 的 HMR 是关的,所以**装完插件大部分需要重启 dsh web**,只改前端的那部分硬刷新浏览器就行。

还有一个坑:pnpm 11 默认开了 minimumReleaseAge(新包要等 24 小时才能被解析成依赖)。这会导致你写 @latest 装出来的是旧版。能用具体版本号就写具体版本号。


第一组:上下文三兄弟(省 token / 看清楚 / 记住)

这一组是我认为每个 DSH 用户最终都会需要的。它们解决的是同一个问题的三个侧面:你的上下文窗口太小、太乱、还是记不住。

6. billion-context —— 会话压缩,当前下载榜第一

包名:billion-context(还有旧名 billion-context-dsh)仓库:github.com/ranxianglei/billion-context(旧仓库 Tyan66666/billion-context-dsh 已停止维护)装机量:dshmarket 下载榜第一,npm 近 30 天 **317 万+**,Star 约 7.1k分类:会话与消息

它到底在干嘛

一句话:让模型自己决定什么时候压缩、压缩哪一段,而不是等到爆窗口才被动截断。

DSH 内置的自动压缩逻辑是“到了 80% 触发,用摘要替换一段范围”。这个逻辑的问题在于——它是无差别的。它不问你“这段重不重要”,它只知道“我快装不下了”。

billion-context 走的是完全相反的路。

它注册成 DSH 的 CompactionEngine 后端,给模型发四个工具:

工具
作用
compress
用模型自己写的高保真摘要替换一段 seq 范围。摘要要保留文件路径、关键决策、报错信息
decompress
把压缩掉的原文原样恢复回来(只读)
search_context
在压缩块的摘要和原文里模糊检索(词干化 + CJK bigram + 字符 n-gram)
acp_status
看上下文分解(tool/text/summaries 各占多少)、压缩块账本、可压缩范围

最关键的一点:压缩不是删除。

DSH 的每次模型请求都从一个 append-only 的会话日志(surface)派生。compress 落地的是持久化的 surfaceOp: { op: 'replace' }——模型写的摘要成为 checkpoint 节点,原文仍然留在日志里。

所以你随时可以:

  • 想起第 30 轮当时说过什么 → decompress 拉回来
  • 记得某个关键词但想不起在哪 → search_context 搜
  • 重启 DSH,压缩账本照样从日志重建(不写旁车文件)

这一点我觉得是这个插件真正牛的地方。很多“省上下文”的方案是删掉了就找不回来,这个是压缩了还能还原。

还有个设计我得单独夸一下

它对“什么不能压”想得很细。README 里有一整节在讲这个:

  • 最新的用户提问(活动问题)→ 硬保护,手动压缩覆盖它会被直接拒绝,并告诉你哪一段可以重切
  • AGENTS.md 这类注入文件 → 永远不提供为可压缩范围。为什么?因为宿主会反复重注入同一份文件,你压掉它,它马上又贴回来,变成“压缩→重注→压缩”的死循环
  • Skill 目录(<available_skills>)→ 同样硬保护,理由还不一样:它的重发判定基于目录 digest,感知不到“可见副本已被折叠”,压掉后永不重发,模型永久失去 skill 发现能力
  • 图片/文件块 → 用持久元数据生成确定性占位符([image image/png shot.png 800x600 4.2KB]),不然截图会话里最后一条提问可能被整段压掉

能想到这些的作者,是真的踩过坑。

安装

dsh plugin --profile web add billion-context

装完必须重启 dsh web,然后开一个新会话。

装完它会自动做两件事(bundle 补丁干的):

  1. 禁用宿主自带的 compaction-basic(避免同一 realm 里两个压缩后端冲突)
  2. 把 ACP 引擎挂到 host 平面,对 standard / code / minimal / cordis / 自定义预设全部生效

装完第一件事

开一个新会话,跟它说:

调用 acp_status 看看当前上下文构成

你会看到类似这样的输出:

CONTEXT BREAKDOWN  tool      12,340 tokens (38%)  text       8,120 tokens (25%)  summaries  1,200 tokens ( 4%)  ...Compressed blocks: 0Checkpoint seqs: (none)

然后你可以让它做个“体检”——我实测过的问法:

帮我分析一下当前上下文里哪些内容可以压缩、哪些不该动,给个结论

它的回答通常是这样的:

“

可压缩内容只有 1 千多个 Token,离触发门槛差了三十多倍,而且大部分开销是系统提示和工具定义这些固定成本,压缩了也省不下来。现在不建议压缩。

看到“不建议压缩”别觉得它没干活。 这恰恰是它跟“无脑压缩”最大的区别——它在帮你省 token 的同时,没有损失任何信息。

几个要注意的

窗口分母别配错。 配置项 modelContextLimit 省略时会自动探测模型真实窗口,失败回退 128000。如果你手动配小(比如百万窗口的模型写成 128K),使用率会虚高,nudge 过频。

默认参数偏保守。 过限 nudge 线在 70%,紧急 nudge 在 85%,都刻意低于宿主 80% 的自动压缩线——保证提醒先到。你可以在 /acp-prune config 里热调。

同一个 realm 不要挂两个压缩后端。 冲突对象是 ctx.compaction。

这是测试版。 README 明确标注“请勿用于生产环境”,破坏性变更是预期行为。

谁该装

该装:经常跟 agent 连续对话好几小时、或者一个项目能跑一整天的。

不用装:你的会话从来没超过 20 轮。装它只会增加 prompt 长度。


7. dsh-context —— 把上下文窗口“摊开”给你看

包名:dsh-context仓库:github.com/bowenliang123/dsh-context装机量:46.6 万次(30 天),Star 约 5.0k分类:用量与计费(它把自己归在这一类)License:Apache-2.0

“

这个插件被 DeepSeek Harness 官方团队成员 @tianyicui 和 @turtle1999 在 X 上推荐并加星。这个分量,比什么“周下载第一”都实在。

它和 billion-context 是什么关系

互补,不重叠。 这个必须先说清楚,否则你会觉得装了两个功能一样的东西。

  • billion-context 管“动手”——它去压缩、恢复、检索
  • dsh-context 管“看”——它只统计、只展示,一个字节都不改

它回答的是那个所有人都遇到过但说不清的问题:“我的 token 到底花在哪了?”

五个入口

入口
位置
回答什么问题
上下文洞察页
侧边栏一级面板(和 Plugins、Automation tasks 并列)
我这周/这月用了多少、哪些会话最费钱
Context 标签页
打开任意会话 → 点 Context
这个会话的上下文怎么构成的、怎么演变的
Fleet 标签页
同上
当前 agent、它的父级、每个子 agent 的实时状态
Context 面板
右侧边栏(可选)
聊天旁边直接看,同步显示 Agent 网络
/context 命令
输入框敲 /context
不离开对话区,弹窗看当前构成 + 上下文浏览器

Context 标签页里到底有什么

📊 Context Stats — 轮次、步骤、用户输入、实时工具调用,以及按 models.dev 价格表估算的成本。鼠标悬停 ? 能看到每百万 token 单价。只有 DeepSeek 区分高峰/非高峰:挂牌价是谷时价,高峰时段按 2 倍计费。

🧱 Token Stats — 这是最有用的一张卡。总量拆成:

系统提示词 | 工具定义 | 用户消息 | 注入上下文 | 技能注入 | 工具调用 | 推理 | 回答

工具调用会进一步拆成“提示词中重放的部分”+“输出中生成的部分”,加上工具返回的结果。技能注入单独成一类——这点很关键,因为隐蔽技能的上下文占用如果混在“注入上下文”里,你根本看不出来。

⏱️ Timing Stats — 活跃时间在模型调用、工具运行、开销之间怎么分布。

🧱 Current Context — 此刻窗口里到底是什么。六种颜色的堆叠条,以模型完整窗口为基准:

系统提示词 ████ | 工具定义 ███ | 用户消息 █ | 注入上下文 ██ | 助手回复 █ | 工具结果 ████                 ↑ 灰色轨道 = 自动压缩预留空间 + 请求预留输出窗口

对话开始退化的时候,看这里就知道是哪一块吃掉了预算。

📈 Context Trend — 每次模型请求一根堆叠柱。粒度比“按消息”更细,你能逐轮看窗口怎么长起来的。

底下还有三行通俗摘要(这点设计很讨喜):

  • User — 开启该轮的消息
  • In — 新加入的内容(通常是先前的工具结果)
  • Response — 回复和/或调用的工具

点击某行就能在 Context 浏览器里打开对应消息。

✂ 标记事件 — 压缩和清理事件会标在发生时对应的柱上。柱子明显掉一截,你就知道那一刻发生了什么。

还能切 Total / Delta 视图。Delta 模式下,增长堆叠在基线上方,压缩则向下延伸——压缩幅度一眼可见。

🧭 Context Browser — 选「当前」或任意保留的步骤,展开看这次请求由什么组成。七类可折叠,每项都能再展开看实际内容——系统提示词原文、每个工具的 JSON schema、消息文本、推理内容、工具参数和输出。

每行工具定义都带来源标签:tool-* 表示一方软件包,dsh-* 表示功能软件包,mcp: 表示代理,或者直接显示 tools.register() 实时监控到的确切插件名。可以按大小/名称排序。

⚡ Context Events — 每次注入、压缩、剪枝、模型切换、计划模式切换都记一条,带来源(指令文件/插件 ID/技能名称)、Token 净变化量(压缩事件会显示回收量)、轮次/步骤、时间。

这卡片的用处是回答“窗口为什么突然变了”,而不是只看到结果。

📁 File Activity — 按 Read / Written / Searched / Images 分类统计,带路径搜索框。每个 edit/write 计入估算的 +新增/−删除 行数。

所有模式都计入——原生工具、Minimal 预设的 str_replace_editor、PTC run_code 里的嵌套调用,都汇总。

🖥️ 命令执行 — 每次 Shell 和代码执行的状态、墙钟耗时、程序分布。

安装

dsh plugin --profile web add dsh-context

装完刷新页面就行,不用重启(这个插件的 README 明确写了“无需构建,也无需重启”)。

但要注意兼容声明:

>=0.2.0-rc.2 || >=0.2.1-rc.2 || >=0.2.2-rc.1

装完第一件事

随便打开一个跑了几轮的会话,点 Context 标签页。

然后做一件我强烈建议你做的事——去看“工具定义”那一栏的 Top 5。

你会发现一个让你后背发凉的事实:很多时候你 token 不是被对话内容吃掉的,是被工具定义吃掉的。

每个插件注册的工具都要往系统提示词里塞自己的 JSON schema。工具越多,schema 越长。装 10 个插件的系统提示词能顶好几千 token,而且你每轮对话都在为它付钱。

这就是“别装太多”最具体的解释。

谁该装

该装:几乎所有人。这个插件不改变任何行为,纯展示,零风险。

而且我建议它是这篇 20 个里最应该先装的一个之一——因为它能帮你判断后面 14 个到底该装哪些。


8. OpenViking —— 让 agent 跨会话记住你是谁

包名:@openviking/dsh-memory-plugin仓库:github.com/volcengine/OpenViking(字节跳动火山引擎)Star:31.1k(OpenViking 主仓库)装机量:Hub 热门榜排名第一;分类:记忆

它解决的是什么

你有没有过这种体验:

“

上周跟 agent 聊过一个项目,它当时理解了“我们这个服务用 pnpm monorepo,测试跑 vitest 不要用 jest”。今天开新会话,你还得再说一遍。

OpenViking 就是干这个的。

它不是一个“记忆插件”,它是一个长期记忆系统(self-evolving context database),DSH 这边只是它的一个适配器。真正干活的是 OpenViking 服务端。

四个概念

概念
干什么的
Profile
会话开始时注入的用户画像块——你是谁、你的偏好、你的项目背景
Recall
模型步骤带新用户输入时,用输入文本做语义检索,把结果作为持久消息追加到同一步骤
Capture
从 DSH 事件流捕获 user / assistant(可选工具结果)消息,跳过注入的上下文
Commit
待同步 token 超阈值时 commit,归档全部已捕获消息

这里有个设计我要专门讲,因为它很聪明

为什么召回结果不进系统提示词,而是作为“持久用户消息”注入?

README 给了答案:DSH 有些 preset 的 persona 声明了 complete: true(官方的 minimal preset 就是)。这类 preset 会在组装完成后恢复 persona 作为唯一的提示词段,静默丢弃所有其他贡献。

也就是说——如果你把记忆注入系统提示词,在 minimal 预设下它会无声无息地消失,连报错都没有。

OpenViking 选择走 agent/pre-step 瀑布流注入成带来源标记的用户消息。这样做有三个好处:

  1. 注入会随会话重放(不是一次性)
  2. 注入对压缩可见(压缩引擎知道它的存在)
  3. **永远不会到达 request/header**(不污染请求头)

这个坑,我敢说 90% 的 DSH 用户都不知道。

装它有个前提:得先有 OpenViking 服务

这是很多人装完发现不工作的原因。光装插件没用,你得有一个在跑的 OpenViking server。

最简单的是本地模式:

# 纯本地模式:http://127.0.0.1:1933,无鉴权,这步可以跳过

或者用统一安装器(它会处理服务安装 + 插件安装):

curl -fsSL https://openviking.ai/install | bash

手动装的话:

dsh plugin --profile web add @openviking/dsh-memory-plugindsh --profile web --dump-config    # 应该能看到 openviking-memory-runtime
“

Node.js 要求 ^22.19.0 或 >=24。

配置

写在 profile 的 cordis.patch.yml 里:

-id:openviking-memory-runtimeconfig:endpoint:http://127.0.0.1:1933recallMaxTokens:2000scoreThreshold:0.35captureToolResults:trueskipSubagentSessions:truecommitTokenThreshold:20000

几个值得调的:

  • recallMaxTokens: 2000 — 每次召回的 token 预算。这是你控制“记忆会不会变啰嗦”的旋钮
  • scoreThreshold: 0.35 — 相关性门槛,调高更保守
  • skipSubagentSessions: true — 排除子 agent 会话。子 agent 的对话通常不值得长期记住
  • captureToolResults: true — 默认捕获工具结果。服务端据此把 skill 读取关联回所用的 Experience。设 false 就只检索不关联

装完第一件事

开一个会话,问一句你几天前跟它聊过的事。

会话开头应该能看到一条 OpenViking 上下文注入,模型应该具备 mcp__openviking__* 工具。

顺便说一句——它还附带三个共享技能:openviking-memory(何时该检索/写入)、openviking-skills(怎么查找、使用、创建、迁移存放在 OpenViking 里的技能)、ov-experience-memory(执行类任务前检索并应用以往任务的 Experience)。新版本还加了第四个 openviking-rule-search。

一个重要的使用建议

OpenViking 官方文档里有句话,我觉得比插件本身还值得记:

“

Recall should be treated as evidence supplied to the model, not as an instruction that overrides the repository.

召回的记忆是“证据”,不是“命令”。

所以正确的用法是:

  • 让 agent 说出“哪条召回的约束影响了这次改动”
  • 把这条约束跟当前的代码、测试、任务需求对照
  • 过时的或无关的记忆就忽略掉,别为了“保持一致性”硬留着它
  • 仓库已经变了,就把更正后的决定写回去

记忆系统最大的坑不是记不住,是记住了错的还当真。

谁该装

该装:你长期在同一个项目里用 DSH,需要它记住项目约定、你的偏好、之前定过的技术选型。

不用装:你每次都是一次性问答,或者你的项目之间毫无关联。


第二组:浏览器与联网(让 agent 能出去办事)

9. dsh-browser —— 让 AI 接管你正在用的 Chrome

包名:这个要特别小心仓库:github.com/omdsh-dev/dsh-browser(这是最正统的那个)

“

官方 README 写得很直白:“本项目目前没有发布 npm 包,不要用 npm install dsh-browser 来装它”——npm 上不带 scope 的 dsh-browser 包属于另一个完全无关的项目。装错了你都不知道自己装了什么。

我建议直接用 omdsh-dev/dsh-browser 这个,它是 README 里描述最完整、工具最全、也是被 dsh-market 收录的那个。

为什么不用无头浏览器

Playwright MCP、Puppeteer MCP、browser-use 这类方案都会启动一个自己下载的全新浏览器实例。结果就是:

接管真实浏览器
MCP 无头方案
登录态 / Cookie
✅ 全部继承
❌ 每次全新 profile
扫码登录 / 验证码
基本不遇到
经常卡在登录墙
可见性
屏幕上实时可见
无头运行
磁盘
复用现有 Chrome,零新增
额外下载数百 MB

“我就想让它用我自己那个已经登录的 B 站账号查个东西”——这就只有接管真实浏览器能干。

工具集

能力
工具
说明
读页面
browser_snapshot
结构化文本:标题/URL/正文/编号交互清单/表单字段(敏感值掩码);delta: true 只返回变化
点击
browser_click
按编号或选择器点,支持鼠标键和修饰键
输入
browser_type
React/Vue 受控组件兼容,replace 先清空
按键
browser_press
单键或组合键;action: down/up 可跨调用按住
滚动
browser_scroll
视口或指定 iframe
剪贴板
browser_clipboard
写入系统剪贴板 / 粘贴
上传文件
browser_upload
挂到 input[type=file](Chrome)
导航
browser_navigate
 / browser_back / browser_forward / browser_reload
受控标签页内导航,登录态保留
标签页
browser_list_tabs
 / browser_follow_tab / browser_close_tab
稳定 ID 管理
读区域
browser_get_text
懒加载内容 / 局部文本
等稳定
browser_wait
页面加载与渲染稳定检测

整条设计是“纯文本”的:页面转成结构化文本 + 编号控件清单,模型按编号定位。面向模型的流水线里不传截图。 所以它对纯文本的 DeepSeek 模型特别友好。

安全模型(这部分我建议你认真看)

它做了这些防护:

  • 密码和支付卡字段始终显示为 ••••,字段值不会离开页面
  • 桥路径在 /api 信任栅栏之外,自带 bearer token 认证
  • 特权网关方法(settings.*/credentials.*/host.open*)对非回环来源一律拒绝
  • 网页文字会标记为不可信输入
  • 读取模式三档:自动共享(默认)/ 每次询问 / 关闭
  • 点击、输入、按键、导航、历史跳转、刷新默认失败关闭,必须由你批准
  • 可以只信任单个 origin(侧栏关闭或 Service Worker 重启即清空)
  • 用户手动切页后,后续操作会暂停,侧栏询问你“继续原页面还是跟随新页面”,扩展绝不静默改绑
  • 助手开始工作时绑定当时的活动标签页

最后一条我觉得特别体贴。 很多浏览器自动化工具会在你不注意的时候把 AI 派到你正在看的页面上乱点。这个设计是“你随时能插手”。

安装

这个插件不是一个 npm 包,而是一个独立的 pnpm workspace,包含两样东西:

  • packages/browser/bridge-browser/ — 给 DSH 用的桥插件
  • extensions/dsh-browser/ — Chrome MV3 扩展

所以它不能只用 dsh plugin add 装。README 给的路径是:

cd ~/.dsh/dsh-browser && pnpm start

或者从源码 checkout,在仓库根目录 pnpm start。

支持的公开运行时版本是:npx @deepseek-ai/dsh@0.2.1-rc.5 web

装完打开任意 http/https 页面,点工具栏的鲸鱼图标,等侧栏显示“Connected”。

“

Chrome 本地使用零配置。 Firefox 需要本地 bridge token。chrome://、Chrome 网上应用店这类受保护页面,模型能读标签页元数据、能做浏览器级导航,但不能检查或操作受保护页面的 DOM。

我必须说的风险提示

这个插件的权限是所有插件里最大的:

  • 它能读你所有已登录页面的内容
  • 它能点击、输入(虽然默认要你批准,但批准一次之后就顺手了)
  • 页面读到的文字会发送给你选的那个模型——如果你用的是云端模型,你的页面内容就出机器了

所以我的建议是:

  1. 首测用小号。 专门注册一个测试账号,别用你的主账号。
  2. 读取模式设成“每次询问”,用几天再决定要不要放松。
  3. 不要让它碰任何涉及公司机密的页面。
  4. 先在 disposable 的环境里跑通“读一个页面 → 提取信息 → 关闭”这条最小链路。

谁该装

该装:需要处理“必须登录才能看”的东西——内部后台、需要登录的知识库、已登录的社区。

不用装:只是要爬公开网页。那用 modsearch(下面第 12 个)或者 dsh-web-search-pro 就行。


10. modsearch —— 免费、免 key、免注册的联网搜索

包名:@liustack/modsearch(注意有 @ scope)仓库:github.com/liustack/modsearchStar:约 196(仓库新,但周下载 10.2k)周下载:约 10 万+

“

这个插件和上一篇的 dsh-web-search-pro 是同一作者 liustack 的两个作品,但定位完全不同。我上次提到了它,这次详细说。

它和 dsh-web-search-pro 的区别

上一篇我说过一句话,这里再强调一次:

“

modsearch —— 最强、最省事、免 key。适合“我就想让它查个东西”。

具体差在哪:

modsearchdsh-web-search-pro
需要 key
完全不要
部分要
平台覆盖
通用网页 + X(Twitter)
20 个平台
,含 B站/小红书/知乎/微博/豆瓣/贴吧/抖音/快手
深度
通用搜索 + 结构化证据
平台定向抓取
附加能力
read_page
 带焦点读单页
web_snapshot
 页面快照落盘、web_history 持久查询历史、web_rule userscript 风格提取规则
适合
“查个东西”
“扒中文社区”

引擎链:这是它最牛的地方

modsearch 不是“一个搜索引擎”,是一条会自动故障转移的引擎链:

引擎
能做什么
免费额度
怎么开
Firecrawl
(默认)
网页搜索 + 单页抓取
免注册每月 1,000 credits
无需任何操作,装完即用
Keenable
网页搜索
免注册每小时 1,000 次(按 IP)
无需任何操作
You.com
网页搜索
免注册每天 100 次(按 IP)
无需任何操作
Antigravity CLI
网页搜索 + 单页抓取
免费,需浏览器登录
装 agy 并登录
Tavily
网页搜索
每月 1,000 credits,不绑卡
modsearch config set tavily.apiKey ...
Exa
网页搜索
$10/月循环额度(约 1,400 次)
modsearch config set exa.apiKey ...
Grok BuildX(Twitter)搜索
随 SuperGrok / X Premium
装 grok 并登录
local
单页抓取
内置,零安装
无需任何操作

一个通道失败或额度耗尽,自动切下一个。 同一引擎还能配多个逗号分隔的 key,鉴权/限流/配额失败时先轮换 key,再往链上走。

它是原生插件,不是 Skill

这点很关键。在 DSH 里它不是靠提示词触发的 skill,而是原生 bundle 接入。

bundle 干三件事:

  1. 把 modsearch 引擎链注册为 web_search 的 provider,并把接缝指过来(searchProvider: modsearch) → DSH 原生的 web_search 工具直接跑在 modsearch 上,Web UI 的引用卡片也保留
  2. 注册 x_search —— 覆盖 DSH 没有接缝的那个语料(X/Twitter)
  3. 注册 read_page —— 带焦点读单个 URL(摘要、提取内容、链接、不确定性提示)

第 1 点意味着:你的提示词一个字都不用改。 模型继续用 web_search,但背后换成了 modsearch。

安全上的两个设计

SSRF 防护:modsearch默认屏蔽私有网络目标,且工具不暴露任何 override。DSH 自带的 web_fetch 因为 SSRF 原因被禁用了,modsearch 的 fetch 是替代品。

云路由提示:公开 URL 默认走 Firecrawl 的免 key 云浏览器(能读 JS 渲染的页面),结果里会带一个警告说明走了云路由。想强制本地:modsearch config set firecrawl.keylessFetch false。

安装

版本号要写死(理由我开头讲过了):

npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.12

查当前版本:

npm view @liustack/modsearch version

装完重启 DSH,然后确认:

npx -y @deepseek-ai/dsh plugin --profile web list

体检

npx @deepseek-ai/dsh doctor

这个体检不花额度、不发网络请求。 装完先跑一次。

谁该装

该装:绝大多数人。如果你只想装一个联网插件,装这个。

不用装:你要扒的是 B站/小红书/知乎/微博这些中文平台——那是 dsh-web-search-pro 的活。


第三组:干活的手(定时 / 协作 / 审查 / 防护)

11. scheduled-tasks —— 让 agent 到点自己干活

包名:dsh-scheduled-tasks(crazy-L118)/ dsh-schedule-tasks(uluckystar)/ dsh-polling(cnyac)分类:工作流与自动化

“

⚠️ 先纠正一个概念:这是社区插件,不是官方插件。

实际上 DSH 官方有一个 @deepseek-ai/dsh-schedule,但它是宿主级 Schedule 服务,作用是“到点往对话里投递一条提醒”,不是“到点让 agent 干活”。这两个东西差别很大。

先把三个概念分清楚

官方 @deepseek-ai/dsh-schedule
dsh-scheduled-tasksdsh-polling
干什么
投递提醒
到对话
触发 shell 命令 / 通知
拉起一个真实的 agent 会话
执行任务
模型参与吗
不参与(就是发条消息)
不参与
参与
例子
“每天 23:00 提醒我查天气”
“每天 04:17 跑 refresh_data.py”
“每天 9 点检查待处理文件夹,有新稿件就润色归档”

“定时拉资讯、定时跑单元测试、定时汇总日志、定时生成公素材”——这些都需要模型参与,所以对应的是 dsh-polling 这一类。

dsh-polling:模型参与

包名:dsh-polling仓库:github.com/cnyac/dsh-polling

它的模型是“任务 = 一个真实会话”:

  • 任务自动出现在侧边栏的“轮询”工作区
  • 执行过程和结果就是对话记录,随时可以打开指挥
  • 对话里直接说“每天上午 9 点检查某文件夹,有新稿件就润色归档”,模型通过 polling_create 工具注册
  • 调度:执行日期(每天/工作日/周末/自定义周几)× 频率(每 N 分钟/每小时)× 时间段,内部存标准 cron,UI 实时预览下次执行
  • 每任务可配:模型/供应商、IANA 时区、目标描述、任务步骤
  • 5 个模型工具(polling_create/list/edit/delete/trigger)任何 preset 会话可见

工程细节做得挺到位:

  • 执行中到点自动跳过(防重入,不堆积)
  • 重启补跑最近一次到期
  • 任务会话被归档后,下次触发自动新建会话继续跑
  • 会话标题固定为任务名,不被自动生成覆盖
dsh plugin --profile web add dsh-polling

dsh-scheduled-tasks:更轻

包名:dsh-scheduled-tasks仓库:github.com/crazy-L118/dsh-scheduled-tasks

四种重复方式:单次 / 每天 / 每周 / 固定间隔(最小 5 分钟)。任务保存在 ~/.dsh/scheduled-tasks.json,不上传任何数据。

有个细节我觉得做得对:错峰补跑——DSH 关闭期间错过的任务不会在重启后立刻陈旧补跑(超过 6 小时的错过直接跳过并记录)。

dsh plugin --profile web add dsh-scheduled-tasks

装完**重启 dsh web**,侧边栏会出现“定时任务”入口。

dsh-schedule-tasks:MyDSH 版

仓库:github.com/uluckystar/dsh-schedule-tasks

支持五段 cron、Shell 或通知动作、侧边栏管理、手动触发、执行日志。每个任务有执行锁,避免重叠;重启后重新计算下次执行时间,不补跑错过的任务。

持久化在 $DSH_HOME/storages/schedule_tasks.json,用临时文件 + 原子替换,避免跨文件系统 EXDEV。文件权限 0600。

“

⚠️ Shell 命令在宿主权限下运行。 这个插件适合把明确、可重复的流程交出去,任务应由受信任的维护者管理。

谁该装

该装:你有一堆重复性劳动(拉资讯、跑测试、汇总日志、生成素材)。

不用装:DSH 不能 7×24 小时开着——官方 Schedule 的限制说得很直白:“The Host must be running”。你合上笔记本,任务就不跑了。


12. dsh-agent-teams —— 把子代理派发固化成团队工作流

包名:@nanmicoder/dsh-agent-teams仓库:github.com/NanmiCoder/dsh-agent-teamsStar:2.87k(Fork 243)分类:工作流与自动化

它做了什么

让当前会话成为队长:创建可续聊的子 Agent、把目标拆成有依赖的任务、通过直达消息协调成员工作。

能力
说明
队长式委派
当前会话负责建队、分角色、汇总结果
可续聊成员
成员是可持续唤醒的 DSH 子 Agent,能继续执行聚焦的后续轮次
带依赖的任务
任务有明确状态;依赖未完成时不能领取
自动续领与安全接管
成员空闲自动领下一个就绪任务;转派撤销旧 attempt;冷恢复重试遗留任务;迟到结果无法覆盖
成员直达消息
通过持久化邮箱直接联系队友或队长,不需要队长中转
实时活动面板
Web UI 用分段进度、可折叠成员树、可交互 DAG 展示实时工作
质量门禁
默认任务顺序:需求 → 实现 → 验证 → 审查 → 集成,失败后自动修复/复审
先计划再执行
正常 /agent-teams 会先 stage 一个未生成的名册和 DAG 给你审阅。只有点了 “Approve & Run” 才开始调度

“先计划再执行”这个设计我很喜欢。 它把“多代理”从“按了回车就开跑”变成了“先看一眼计划再决定”。这在 agent 工具里是少数派做法。

质量门禁的默认流水线

需求 → 实现 → 验证 → 审查 → 集成 ↓        ↓       ↓      ↓失败 → 自动修复 → 复审 → 恢复团队需要显式 resume

README 里也老实说了:“范围控制是完成时审计,不是 host 写入拦截”——也就是说它不会真的拦住 agent 越界写文件,只会在完成时审计。这一点说得很诚实。

安装(版本组合要照抄)

npm install --global @deepseek-ai/dshdsh --versiondsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.29

推荐组合是 DeepSeek Harness 0.2.1-rc.2 + AgentTeams 0.1.29。

作者给了一张兼容矩阵,这是我看过的 DSH 插件里最认真的一份:

使用场景
DSH
插件
推荐0.2.1-rc.20.1.29
预览宿主
0.2.2-rc.1, 0.2.1-rc.3
0.1.29
上一推荐 RC
0.2.1-rc.1, 0.2.0-rc.2, 0.1.7-rc.2
0.1.29
保留旧 RC
0.1.5-rc.1 ~ 0.2.1-rc.3
0.1.29
保留旧 Alpha
0.1.2-alpha.2 ~ 0.1.2-alpha.5
0.1.29

装完必须停止并重启该 profile 的 Harness 进程,然后刷新浏览器。

也可以从 GitHub 默认分支装(不等 npm 发版):

dsh plugin --profile web add github:NanmiCoder/dsh-agent-teams

Desktop 端:应用侧栏「插件 → 添加插件」,粘贴 https://github.com/NanmiCoder/dsh-agent-teams。

补充一点

“

多代理会成倍消耗 Token 和权限弹窗,偶尔用的人不值得装。

展开说三点:

  1. Token 是几倍不是几成。 一个主 agent + 3 个子 agent = 4 份上下文。子 agent 还要各自读文件、跑工具。
  2. 权限弹窗会变多倍。 3 个子 agent 各自要审批,你一个人点。
  3. 状态存储是文件级的——~/.agent-teams/ 下,同一团队并发编辑不做协调。别开两个 DSH 进程跑同一个团队。

判断标准很简单:你一周会用到多代理超过 3 次吗? 不到,就别装。


13. cc-safety-net —— 给 AI 装一根硬刹车

包名:cc-safety-net仓库:github.com/kenryu42/cc-safety-netAuthor:kenryu42 / J LiewLicense:MIT近 30 天 npm 下载:16.3 万+分类:开发与运维

它解决的是什么

一句话:在工具调用真正执行之前,拦下那些会毁掉你东西的操作。

具体拦什么:

  • 破坏性 Git 命令:git reset --hard、git push --force
  • 危险的文件系统操作:针对危险目标的 rm -rf
  • 敏感文件访问:SSH 私钥、.env、~/.aws、各类 coding CLI 的凭据目录

它的核心技术点:解析语义,不看字符串

它解析的是命令实际要做什么,不是表面字符串。

所以:

bash -c "git reset --hard"# 拦python -c "...git reset --hard..."# 拦git --no-pager reset --hard     # 拦

包装命令、调换参数顺序,都绕不过去。 这是它和那些用正则匹配命令文本的方案的根本区别。

三档预设

Standard / Strict / Paranoid,可以在 GUI 里逐条开关规则,不用手写配置。

还有官方规则包:Terraform、AWS、gcloud、Azure。也支持自定义 JSON 规则。

团队策略共享:把策略目录(.cc-safety-net/)提交进 git,克隆仓库或云端会话就获得同一套规则。这个设计我很喜欢——安全策略应该是代码的一部分,不该是某个人的本地设置。

安装(这条命令和别的不一样)

npx -y cc-safety-net@latest install --deepseek-harness

它作为 profile 插件 bundle 加载,不是 hook 进程。

安装前有一步:先打开一次 DSH 桌面应用,然后退出。 因为桌面应用的插件只能在应用关闭时改动。

装完验证:

npx cc-safety-net doctor

成功会报 Added cc-safety-net to the DeepSeek Harness Desktop and web profiles.

“

一次安装覆盖两个 profile:web 和 desktop(后者仅在已存在时)。acp、headless、sdk、sdk-minimal 以及之后新建的 profile 都不受保护,要自己加:

dsh plugin --profile <name> add cc-safety-net

一个很妙的设计:未声明的 shell 工具会被提示

插件可以给 agent 添加自带的 shell 工具(比如 dsh-ops 的 ops_bash)。**在你声明它之前,cc-safety-net 从不读它的 command**——所以 ops_bash 执行 git reset --hard 不会有任何拦截。

那怎么办?

它的做法是:在该工具第一次执行非空 command 时,在返回结果里附一条提示给 agent,要求 agent:

  1. 根据工具描述或插件源码,查明它在哪里执行命令
  2. 声明它:npx -y cc-safety-net rule tool add <工具名>
  3. 用 rule tool list 确认声明生效,而不是执行破坏性命令来验证
  4. 无论如何都把查明的情况告诉用户

这个设计我觉得非常聪明。 它没有粗暴地“拦截一切未知工具”(那会让插件全废),也没有放任漏洞,而是让 agent 自己去把工具登记进来。

它的覆盖边界(我必须说清楚)

  • 其他 profile 不覆盖(只有 web 和 desktop)
  • bundle 加载失败时,DSH 只打印警告,该 profile 就在没有保护的情况下运行(doctor 读的是磁盘上的 manifest,不是运行中的宿主,所以它可能仍然报告“已配置”)
  • PTC 模式下的 run_code:跑的是模型写的 TypeScript,能直接调 Node.js API。只有这些代码发起的工具调用会到达 guard,它通过 node:fs 做的写入不受任何决策
  • **terminal_send**:需要手动开启的终端工具会把文本直接写进持久 shell,不经分析
  • Windows 桌面应用路径未经测试

还有一点必须讲清楚:它不是沙箱。 不隔离进程、不改文件权限、不监控网络出口。它的价值是可配置、可共享的策略层,不是隔离。

谁该装

该装:几乎所有用 AI 写代码的人。 这是我认为这篇 20 个里性价比最高的一个——安装成本几乎为零,收益是“AI 抽风删库”这件事的概率显著下降。

第一遍测试请在 disposable 的仓库副本里做,Git 状态干净。 用一个无害命令验证它不误伤,用一个真的危险命令验证它会拦。


14. dsh-code-review —— 自动做代码静态审查

包名:dsh-code-review(有坑,见下)/ @yangzhe1991/dsh-code-review / @dsh-plugin/dsh-code-review / dsh-tool-code-review

“

⚠️ dsh-code-review 这个名字在 npm 上已被占用(v0.1.2,是别人的东西)。npm i dsh-code-review 装到的不是你想要的那个。

而且“代码审查”在 DSH 生态里有至少 5 个不同实现,功能差别很大。

我把它拆成三类给你:

三类“代码审查”插件

类型
代表
干什么
A. 智能审查内核Nicholas023/dsh-code-review
三个固定视角评审:安全与脱敏、找 bug、冗余与无关代码
B. diff 审查 UI@yangzhe1991/dsh-code-review
、@dsh-plugin/dsh-code-review
把对话里的 diff 变成双列 Code Review 页面
C. 工具型扫描器dsh-tool-code-review
多维度扫描 + SARIF 输出

A 类:Nicholas023/dsh-code-review —— 我觉得设计最漂亮

它的三个关键设计:

1. 进程外,不受会话约束。

DSH 插件(薄壳)  ├─ code_review 工具 / /review 命令   → 写任务卡、拉起内核  ├─ code_review_status 工具           → 读任务卡、呈现结果  └─ 设置面板                          → 配置(端点在面板里填)           │           ▼  任务簿(一任务一 JSON,原子写)自研内核(独立 Node 进程,单例)  ├─ git 取 diff / 筛文件  ├─ 规模分档 → 主 agent + 子 agent  ├─ PTC:模型写程序调用只读工具  └─ Markdown + JSON 双报告           │           ▼run_code 子进程(模型代码在这里跑)  ├─ sdk.read / sdk.glob / sdk.grep(只读)  ├─ 路径围栏 + 结果预算  └─ 硬超时 + 内存上限

评审在独立进程里跑,DSH 会话关闭、插件重载都不影响它。 任务卡是唯一的共享状态,插件崩了内核还在跑。

2. PTC 模式省 token。

模型不逐个调工具,而是写一段程序在沙箱里执行,工具结果不进模型上下文,只有程序返回值回来。

对比传统多轮工具调用:上下文开销从“每轮重发历史”变成“一次往返”。仓库里有 npm run bench 可以本地估算量级差异。

3. 评审绝不改代码。

内核只暴露 read / glob / grep 三个只读工具,没有写、没有 shell。代码在独立子进程执行,死循环被硬超时杀掉。

它的安全边界(写得很规矩)

项
约束
写操作
内核无写工具,模型无法修改仓库
路径逃逸
拒绝绝对路径、..、符号链接逃逸;只放行仓库内普通文件
敏感文件
内容不送审,但在报告里逐一点名(不允许静默排除)
报告脱敏
写入前统一脱敏,密钥/Bearer/连接串密码 → [REDACTED]
凭据
只存引用名,明文 key 只在内存中用于请求
执行隔离
独立子进程,硬超时 + 内存上限

“敏感文件在报告里逐一点名,不允许静默排除” —— 这个细节很专业。很多工具遇到敏感文件就悄悄跳过,你就永远不知道它漏审了什么。

安装(这个包 npm 上没有)

npm installnpm run build

然后把整个包目录放进 profile 的 node_modules/ 下,重启 DSH,在「插件」页启用。

或者从 GitHub Release 下 tar.gz 装。从 0.1.x 升级不支持(0.2.0 是重写版,引擎和配置真源都换了),要卸载重装。

配置

唯一真源是 DSH 的 profile,插件不写自有配置文件——所以不会出现“插件配置和宿主配置对不上”。

端点和凭据必须在设置里显式填写:

字段
说明
review.endpoint
模型端点,如 https://api.deepseek.com
review.model
模型标识,如 deepseek-flash
review.credentialRef凭据引用名
(DSH 凭据库里的名字,或同名环境变量)。只能字母数字下划线,不能含短横线。填名字,不填明文 key
“

红线:端点或凭据缺失时,评审会在发出任何请求之前失败并提示去配置,绝不隐式调用任何默认端点。

使用

用 code_review 审查 D:/projects/my-repo 的未提交改动

或 /review。发起后立即返回任务 id,用 code_review_status 查进度。报告落在 ~/dsh-code-review-reports/<仓库名>/,同时产出 .md 与 .json。

B 类:@yangzhe1991/dsh-code-review —— diff 审查 UI

如果你要的是“在浏览器里双列看 diff + 行内评论 + 一键 AI 审查”,那看这个:

dsh plugin --profile web add @yangzhe1991/dsh-code-review

功能:

  • 双列并排(左旧右新),行号齐全,GitHub split review 风格
  • 行内字符级高亮——同一行只改几个字符时,精确高亮那几个字符
  • hunk 感知——每个 @@ 头保留,多文件拆成独立段,带状态徽章(修改/新增/删除/重命名/二进制)
  • 行内评论——悬停行号点击提评论,攒齐一次性提交,自动写入 DSH 对话框发给 agent
  • 一键 AI 审查——主 agent 起一个全新干净上下文的 sub agent(禁止 fork)当独立审查员,用 send_message 对每条分歧往返讨论直到双方一致,一致认为必须改的无需审批直接改,改完再复查 + 跑构建/测试
  • 本地 .diff / .patch 路径自动变成可点击按钮
“

AI 审查的实现很巧:浏览器端没有创建 sub agent 的官方 API,所以它通过驱动主 agent 来实现——diff 暂存成临时文件(0600 权限,24 小时过期清理),指令保持简短,大 diff 不进主对话上下文。

C 类:dsh-tool-code-review —— 工具型扫描器

如果你要的是“接 CI”,看这个。六个维度:

维度
检查项
bugs
越界、空指针、async 错误处理、竞态、资源泄漏
security
SQL 注入、XSS、命令注入、硬编码密钥、路径遍历
style
命名不一致、死代码、过度复杂、缺少错误消息
performance
N+1 查询、热路径大分配、缺分页、同步 I/O 阻塞
tests
新代码无测试、边界未覆盖、flaky 模式
docs
API 变更无文档、配置变更未说明、Breaking change 无迁移指南

输出 SARIF 格式,兼容 GitHub Code Scanning。

谁该装

该装 B 类:你日常用 DSH 写代码,想在浏览器里舒服地看 diff 并跟 agent 对账。

该装 C 类:你要接 CI 流水线。

A 类:概念最好,但安装门槛最高(要自己 build)。


第四组:看得见、摸得着(视觉 / 图 / 设计 / 远程)

15. archify —— 从代码库自动生成交互式架构图

包名:@tt-a1i/archify-dsh仓库:github.com/tt-a1i/archify(integrations/deepseek-harness)Star:约 14.8k(archify 主仓库)分类:文档与渲染

它解决什么

“这个项目到底怎么组织的?”

新人接手一个仓库最大的成本,就是理解结构。archify 让你直接问:

“

“帮我画出这个仓库的架构图” “这个请求从入口到落库经过哪些环节?画时序图” “数据是怎么流动的?画数据流图”

它支持五种图:架构图、工作流图、时序图、数据流图、生命周期图。

技术上有什么值得说的

强类型 JSON 中间表示(IR)+ 原子化布局校验。

意思是:图不是模型“随手画”的,是先过一道结构化的校验门禁。校验失败时输出机器可读的报告,带诊断详情和修复控制项。

校验通过才渲染,所以不会出现“生成了一张乱七八糟的图”。

还有两个我觉得很实用的能力:

  • 路径追踪——点一个节点,看它往下游走了哪些路径
  • 上下游影响范围探索——改这个组件,会影响哪些东西

后者对做架构评审和 PR 审查特别有用。

还能导出

  • 完整图表 PNG
  • 路径分享卡片
  • 动态演示

无外部运行时依赖——产出一个独立的 HTML 文件,双击就能开,发给别人也能看。

它对“可验证”的执念

我看了它的实际分析报告,印象最深的是它对证据的处理:

“

每个组件/参与者/断言都绑定 path:line,行号在写入前用 sed -n “${l}p” 逐条核对过。

它做的是“有出处的架构图”,不是“看起来很像的架构图”。 每个方框都能点回源码。

这一点对 AI 生成的图来说太重要了,因为 AI 最擅长的就是画得很像但全是编的。

安装

注意它的版本约束很严:

“

目前发布的 npm 包是 v1.0.0。它打包了 Archify Skill 3.0.1,支持精确的 @deepseek-ai/dsh@0.1.2-rc.1、Node.js ^22.19.0 || >=24.0.0。1.0 适配器契约覆盖的就是这个精确的 DSH 宿主版本,它不会让宿主变稳定,也不保证兼容其他 DSH 版本。

从源码装的话:

pnpm --filter @archify/dsh-runtime buildpnpm -C packages/dsh-runtime pack --pack-destinationdsh plugin --profile open-design add /archify-dsh-runtime-0.1.0.tgz

它有什么限制(我查到了,说出来比较负责)

  • DSH 社区集成依赖 Node.js ^22.19.0 或 >=24.0.0
  • 在 DSH 环境中操作 Shell 文件需要指定工作区确切路径,不支持 Web 产物虚拟路径
  • 不包含通用所见即所得编辑器,也没有自动 Mermaid 语法解析
  • 部署归属检查在缺少作者、区域等元数据时会严格报错失败

谁该装

该装:你要理解一个陌生的大仓库;你要做架构评审;你要给非技术的同事讲清楚系统怎么转。

不用装:你只改两三个文件的边角项目,画图的时间比干活的还多。


16. dsh-vision-router —— 免费识图通道

包名:dsh-vision-router仓库:github.com/ysr666/dsh-vision-routerStar:约 1.26k(Fork 61)周下载:约 26.4kLicense:MIT分类:视觉与多模态

它和 modlens 的区别

上一篇我说过 modlens 是“给纯文本模型装眼睛”,返回带版面、实体、关系的三层结构化证据。

dsh-vision-router 走的是另一条路:它不换模型,它给你一个“开关”。

装完之后,输入框旁边多一个 👁 Vision 按钮。点一下,当前这轮就带上视觉能力,不用去模型选择器里切 (modlens vision)。

对新手来说,这比 modlens 友好太多。

十四个工具

除了常规的图像问答,它提供的是像素级的工具:

工具
干什么
图像问答
问图里的任何东西
Grounding
定位——“那个红色的按钮在图的哪个位置”,返回坐标
Crop
裁切
Pixel diff
像素对比——两张图差在哪
Colors
取色
OCR
文字识别
SVG trace
描成矢量
Cutout
抠图
Screenshot
截图

Pixel diff 和 Grounding 这两个是 modlens 没有的。

Pixel diff 特别有用——你改了 UI 之后想知道到底变了什么,用它比用眼睛靠谱。 Grounding 也好,“帮我点那个第三行的小图标”这种需求,现在可以精确表达了。

安装

npx @deepseek-ai/dsh plugin --profile web add dsh-vision-router

Desktop 用户把 --profile web 换成 --profile desktop,然后重载插件或重启应用。

“

⚠️ 一个必须说的数据外传问题:

README 里有个 CAUTION 框,我原样翻译:

“默认情况下数据会离开你的机器。” 当使用云端视觉模型时,Vision Router 会把图片(或派生裁剪)、视觉提示词和相关请求元数据发送给那个服务商。

全新安装时启用了一个匿名的 OVHcloud 视觉回退,所以“免费”和“无需 key”并不等于“离线”。

机密、受监管或分级材料,不要走云端链路。

一个大坑:v3.2.0 的兼容性

v3.2.0 stable release 要求:DSH >=0.2.1-rc.5 <0.3.0-0 和 Node.js >=24.9.0。DSH 0.1.x / 0.2.0 和 Node 22 不再被支持。

而且:已有 profile 不会自动升级。

官方给的安全做法是:

# 先跑只读的升级预检npx @deepseek-ai/dsh doctor --upgrade-preflight

然后单独验证 legacy Session 数据、自定义 profile 覆盖层和回滚路径。

还在 v3.1.5 的可以先不升。

它和 modlens 到底装哪个

我给你一个决策表:

你的情况
装哪个
新手,第一次用
dsh-vision-router
(开关直观,零配置)
要 OCR + 版面 + 实体关系
modlens
要像素级操作(对比、定位、取色)
dsh-vision-router
要接本地已有的 Codex/Codex CLI/Claude Code 登录态
modlens
两者都不冲突
可以都装
,但先用 dsh-vision-router

17. open-design —— 让 agent 直接产出设计文件

包名:open-design / @open-design/dsh-runtime仓库:github.com/nexu-io/open-designStar:98.5k–106.7k(不同目录口径不同,awesome-dsh-plugin 记 98.5k,harnesscatalog 记 106.7k)License:Apache-2.0分类:Skill / 设计

先纠正一个定位

“

⚠️ open-design 严格说不是 DSH profile 插件,是一个独立的本地优先桌面应用。 它通过官方 dsh CLI 把 DSH 当作一等原生运行时启动。

它能产出什么

六大类产物,一个 Studio 工作区全覆盖:

产物
说明
原型
Web / 桌面 / 移动端单页 HTML 工件,在沙箱 iframe 里预览
演示稿
杂志版式 Web PPT、周报、路演
移动应用
iPhone 15 Pro / Pixel 外框应用原型
图片
—
文档
PM 规范、OKR 记分卡、故障应急手册、财务摘要、HR 入职手册
动态图形
HyperFrames,HTML → MP4 动效

导出格式:HTML(单文件内联)、PDF(浏览器打印,Deck 感知)、PPTX(Agent 驱动的技能)、ZIP(归档)、Markdown、MP4。

设计模板库

15 套 Deck 模板 × 36 个主题,加上一堆原型模板:

web-prototype / sausa-landing / dashboard / mobile-app / mobile-onboarding / social-carousel / email-marketing / magazine-poster / motion-frames / sprite-animation / pm-spec / team-okrs / eng-runbook / finance-report / hr-onboarding / guizang-ppt / html-ppt-* / hyperframes / critique / tweaks

按 scenario 分组:design / marketing / operation / engineering / product / finance / hr / sale / personal。

内置 151 套设计系统。

DESIGN.md —— 这个设计很值得学

它把“品牌视觉语言”提炼成一个文件(DESIGN.md),然后把它当作每份生成产物的契约。

流程是:

  1. PM 提一份 brief
  2. 锁方向——没品牌就选 5 个策展方向之一;有品牌就丢一张截图或一个 URL 进去,agent 去连 GitHub,把它整理成一份可复用的 DESIGN.md
  3. Agent 产出第一份交付物(模板 + DESIGN.md 绑定)
  4. 交付给工程——产物是真实的 HTML/CSS,可以直接丢进 Cursor/Codex/Claude Code 继续当代码写
  5. OpenDesign 越用越聪明——你的截图、字体、配色、确认过的产物会累积成下次的默认值

“截图或 URL → DESIGN.md”这一步,是它和普通“生成一个好看的页面”最大的区别。

安装

# 先装官方 dsh CLInpm install -g @deepseek-ai/dsh# 然后在 OpenDesign 里选它,或者跑:od agent setup deepseek-harness

DSH 接入时它会:发现你的 dsh、读它的模型和推理档位、对缺失的凭据/profile 设置/未测试的 Harness 版本给出具体指引。

0.19.1 之后,Harness 会作为 agent 在 OpenDesign 里跑起来——流式输出思考、文本、工具调用、结果和用量,后续轮次能恢复同一个 Harness 会话。

“

注意:OpenDesign 只安装/修复它自己的连接 profile,不替换也不升级你的 Harness。

它还支持另外 20 多个 CLI agent(Claude Code / Codex / Cursor / Copilot / OpenCode / Kimi CLI / Trae / Cline / Kiro / …)走 MCP。

谁该装

该装:你要做封面、海报、原型、演示稿、或者任何“要交付给别人看的图”。

不用装:你只写代码,不碰设计。它是个独立应用,装了也是另开一个窗口。


18. dsh-skills-manager —— Skills 的总管

包名:@michengai/dsh-skills-manager仓库:github.com/MichengAI/dsh-skills-managerStar:约 74–93License:Apache-2.0当前版本:1.2.26

它解决什么

先说清楚 DSH 的 Skills 是什么。

Skill 就是一堆 SKILL.md 文件(带 frontmatter 的 Markdown),告诉 agent “这类任务该怎么做”。它们可以放在:

  • 全局用户目录
  • 项目目录
  • 或者……你电脑上另外 20 个工具的目录里

问题来了:如果你同时用 DSH、Claude Code、Cursor、Copilot、Google Antigravity、Windsurf、Qoder、Trae……你的 Skills 散在十几个地方。

dsh-skills-manager 就是来收编它们的。

它到底能干什么

能力
说明
统一多视图管理
全局 Skills / 项目 Skills / 发现 / 回收站,四个标签页,实时搜索、状态筛选、可折叠来源分组
广生态支持
覆盖 20+ 个工具和 CLI 环境:DSH、Shared Agent、Codex、Claude Code、Copilot、Cursor、Google Antigravity、Windsurf、Qoder、Trae 等,且不改动第三方文件
分类与拖拽
在来源里建分类文件夹,拖拽(⋮⋮ 把手)排序整理,批量分配,一键开关整个分类。分类元数据单独保存,不移动文件
公共市场与仓库
内置“发现”中心,浏览 ClawHub 热门技能,或搜 skills.sh 目录;也可以订阅公共 GitHub 仓库,带增量 diff 检查和备份
创建与导入
创建技能,或导入 ZIP / 文件夹 / SKILL.md,直接进全局用户目录或已注册的工作区
宽阅读体验
760px 响应式详情弹窗,等宽语法样式,垂直缩放,一键“复制正文”
回收站与安全回滚软删除
保护技能不丢,可完整恢复,保留来源和更新历史
自定义来源文件夹
把外部 agent 来源指向另一个目录,不移动任何文件。DSH 和 Shared Agent 保持宿主配置

安装

dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=https://registry.npmjs.org/

装完重启 DSH,刷新页面,去 设置 → Skills。

兼容声明:

插件 1.2.26 测试于 DSH 0.2.0-rc.1 ~ 0.2.1-rc.3宿主兼容:完整 0.2.x 线(>=0.2.0-rc.1 <0.3.0-0)

如果你还在用 0.1.x 宿主,装 1.1.23,不要装 @latest。 版本门禁会直接拒绝。

装完第一件事

去“发现”标签页逛一下 ClawHub 热门技能。

这个生态现在涨得很快——你会发现有些技能根本不是你写的,是别人写好、你直接拿来用的。装一个“技术写作”技能或“公众号排版”技能,比自己每次重新写提示词划算得多。

谁该装

该装:你用多个 AI 工具,或者你已经攒了不少 Skills 但管不过来。

不用装:你只装了两三个技能,且都在 DSH 里躺着。这时候管理器是负担。


19. dsh-pocket —— 把 DSH 装进你口袋

包名:dsh-pocket仓库:github.com/shaobeichen/dsh-pocketStar:约 276月下载:约 12.3kLicense:GPL-2.0当前版本:2.12.0

它解决什么

你不在电脑前,但也想用电脑上的 DSH。

具体场景:

  • 下班路上,agent 在电脑上跑任务,你想掏出手机看看它干到哪了
  • 出门在外突然想让电脑上的 agent 查点资料,但你没有远程桌面、没有 SSH
  • 电脑在办公室,人在外面,想随时发个任务、看输出、点审批

两种连接方式

📶 局域网扫码:装好即用。设置 → 手机访问 → 打开就有局域网二维码,手机连同一 WiFi 扫码即开。

自动识别本机局域网 IP(WSL 环境自动取 Windows 物理网卡 IP)。

🌐 公网扫码:点“开启公网访问” → cloudflared 隧道 → 出公网二维码,4G/任何网络都能访问。

几个做得好的细节

特性
说明
访问密码
公网默认 8 位随机密码,每次开启公网自动换新,旧链接立即作废。局域网有独立的默认密码(默认开启,可一键关掉)
自定义密码
公网/局域网都能设 8–64 位固定密码(英文字母或数字)
会话保持
手机输一次密码后长期免输(绑定电脑上的 dsh web 进程)。dsh web 重启/更新后需重新输入一次
实时同步
流式输出走 WebSocket 全透传——电脑上在输出,手机上同步在滚,可双向操作。内置心跳保活(防路由器 NAT/省电静默断链),断线自动重连
移动端适配
窄屏自动变抽屉布局(移植 dsh-web-mobile,MIT):侧栏抽屉、会话全宽、状态栏安全区、触控优化
传输压缩
大 JSON 响应自动 gzip/brotli(长会话 17MB → ~1MB,brotli 质量 6)
隧道自动恢复
DSH 重启后自动重新拉起之前开着的公网隧道
公网固定域名
可选“命名隧道”模式:填 Cloudflare Tunnel Token + 自己的域名,公网地址固定不变(重启不再变)

安装

dsh plugin --profile web add dsh-pocket -w

-w 不能省——这是 pnpm 9 对 workspace 根的限制,不加会报 ERR_PNPM_ADDING_TO_ROOT。

装完**必须重启 dsh web**。

安全(这一段我必须完整讲)

“

DSH 能执行你电脑上的代码。

  • 局域网二维码/URL 配上独立 8 位密码才是钥匙(默认开启,可关)。请勿把局域网二维码、URL 或密码发给别人
  • 开启公网访问前必须阅读并勾选免责声明(每次开启都会弹框,服务端强制校验,无法绕过):公网 = 把能执行代码的 DSH 暴露到互联网
  • 公网判定是 fail closed:除本机(loopback)和局域网私网地址外,一切陌生域名(包括你自建隧道/反向代理指向本机端口的固定域名)一律按公网处理、强制公网密码——不存在“换域名绕过密码”的口子
  • 登录限速:同一 IP 连续输错 5 次锁定 60 秒;全局失败超阈值时短暂全锁(防换 IP 分布式扫描)
  • 公网 URL 由 cloudflared 随机分配,每次重启会变化(旧链接自动失效,相当于天然轮换);命名隧道固定域名模式下地址不变、密码不自动轮换

还有一个我特别想表扬的设计:CLI 模式也有密码。

README 里写明这是 issue #90 修复的结果——修复前 CLI 直跑 dsh-pocket是无认证的。现在默认随机生成 8 位密码,打印在终端并内嵌进二维码(扫码体验不变),手动敲地址时需要填写。

“

--no-auth 可以关,但不推荐——那等于把能执行代码的 DSH 裸暴露给任何能连上该端口的人。

几个常见问题

现象
原因与解决
装完界面没变化
必须重启 dsh web
listen EADDRINUSE :3081
旧进程占着端口:lsof -ti :3081 | xargs kill -9(Windows 用 netstat -ano 找 LISTENING 的 PID)
想换端口
在 $DSH_HOME/dsh-pocket/settings.json 写 “proxyPort”: 3082
更新到 1.x
^0.x
 范围不自动升 1.x:dsh plugin --profile web update dsh-pocket --latest -w
Linux 装不上 cloudflared
手动装好,在 settings.json 加 “cloudflaredPath”: “/path/to/cloudflared”

谁该装

该装:你经常让 agent 跑长任务,然后想随时用手机看一眼进度。

不用装:你的任务都是几分钟就完,或者你本来就有 SSH/远程桌面。


20. dsh-usage —— 本地用量仪表盘

包名:dsh-usage仓库: github.com/Aisland-SJL/dsh-usage分类:用量与计费

“

⚠️ 这个包名有多个人在用,装之前看清楚:

  • Aisland-SJL/dsh-usage — 常驻侧边栏停靠面板(常驻侧边栏、余额、调用热力图、分模型统计),有 7 个可拖拽排序的小组件

Aisland-SJL 版的 7 个组件

组件
内容
💳 Balance
大数字在左,available / topped-up / granted 在右,provider 可切换
📊 Today
今日 token + 输入/输出/缓存读分解
📈 This month
本月同样分解
🎯 Cache hit
今日和全时缓存命中率
↔️ Channel share
DSH 渠道 vs Claude Code 渠道的占比条
📜 Usage log
最近 14 天每日列表,点击可下钻到分模型明细
🔥 Activity heatmap
28 天 × 6 档点阵(日期横排,0–24h 纵排)

它的常驻面板长什么样

侧边栏底部一个可折叠的停靠面板:

  • 🟢 Balance — 健康时绿色,耗尽时红色
  • 📊 Today / Month / Cache hit — 一眼能看的 token 统计
  • ⚙️ 齿轮打开详情面板,↻ 刷新即时重查
  • 🧲 镜像你的 pin 设置 —— 你的每一次改动立刻生效

侧边栏折叠时,整个停靠面板收成一个小小的余额胶囊。 这个细节做得很舒服。

自定义能力

每个组件都能:pin、折叠、隐藏、拖拽排序(有虚线占位符和滑动动画)。主题色、背景、不透明度可调,存在 localStorage。

三个我觉得做得对的地方

1. 三个 loopback-only GET 端点。 非 GET 请求返回 405,非 loopback 调用者返回 403。上游强制 HTTPS + DNS pinning。Claude Code 日志只聚合数字,消息正文永远不出机器。

2. “Channel share” 这个组件。 它读 ~/.claude/projects 的增量 JSONL,聚合出 Claude Code 渠道的 token。如果你同时在用 Claude Code 和 DSH,你能一眼看出两边谁烧得多。 这个需求很真实。

3. 后台刷新。 启动时刷新一次,然后每 5 分钟刷新余额、DSH token、Claude Code 聚合。

装完第一件事

去把价格表配了。

不管哪个版本的 dsh-usage,不配价格就只能显示 token 数,显示不出钱。 价格表在设置面板里可编辑并持久化到 pricing.json。

DeepSeek 的价格是分峰谷的:

  • 工作日高峰:北京时间 9:00–12:00、14:00–18:00
  • 2026-08-23 起,周末全天按空闲价计费
  • 2026-09-10 12:00 起适用 V4.1-Flash 后的峰谷价(deepseek-flash 空闲档:缓存命中 0.02 / 输入 1 / 输出 4 CNY,峰时翻倍)

峰谷这个设计我觉得很聪明——它直接告诉你“什么时候跑最便宜”。很多人不知道这个,插件帮你把省钱的窗口摆到眼前。

它和 dsh-cost-meter 怎么选

上次那篇我提过 dsh-cost-meter。这两个是同类:

  • dsh-usage(Aisland 版) — 常驻停靠面板,7 个可拖拽组件,含 Channel share,纯本地、无上传
  • dsh-cost-meter — 按会话和按天的花费、预算、官方余额、历史看板
  • dsh-all-usage — 最重的一个:多维分析、按工作区分组、增量同步、43 个品牌图标、可审计的数据维护

我的建议:先装一个轻的(dsh-usage),用一周觉得不够再换重的。

谁该装

该装:你用 DeepSeek 官方 API 且对花钱敏感。看余额和每日消耗这件事,应该成为习惯。

不用装:你用的是包月订阅(比如 Codex/Claude 订阅接进来),或者你不介意看账单。


最后:把这 20 个收成一张表

先回顾那 5 个:

#
插件
解决什么
装完第一件事
1
dshmarket
找到其他所有插件
重启后开 Plugins → Plugin Market
2
@liustack/modlens
纯文本模型看不见
模型选择器选 (modlens vision)
3
@linxin666/dsh-web-ui-all
界面是毛坯房
处理 ERR_PNPM_IGNORED_BUILDS
4
dsh-web-search-pro
查不了最新资料
browser 也要一起装
5
@deepseek-harness-tui/dsh-tui
想在终端干活
全局装完直接 dsh-tui

新增 15 个:

#
插件
解决什么
装完第一件事
建议
6
billion-context
上下文被撑爆
开新会话调 acp_status
长任务才装
7
dsh-context
不知道 token 花哪了
打开任意会话点 Context
闭眼装
8
@openviking/dsh-memory-plugin
跨会话失忆
问一句几天前聊过的事
长期项目必装
9
dsh-browser
接管真实 Chrome
首测用小号
小心,能用但风险高
10
@liustack/modsearch
免费联网搜索
跑 doctor 体检
闭眼装
11
dsh-polling / dsh-scheduled-tasks
到点自动干活
建一个每天的任务
重复劳动多才装
12
@nanmicoder/dsh-agent-teams
多代理协作
先看 DAG 计划再批准
一周用 3 次以上才装
13
cc-safety-net
AI 抽风删库
disposable 仓库里测一次
写代码必装,第一个装
14
dsh-code-review
代码没人审
/review
 一次
写代码必装,按需求选变体
15
archify
看不懂项目结构
画一张架构图
写代码必装,大仓库更值
16
dsh-vision-router
免费识图
输入框点 👁 Vision
写代码必装,新手友好
17
open-design
做不出能交付的设计
丢个截图生成 DESIGN.md
做图才装
18
@michengai/dsh-skills-manager
Skills 散落各处
去发现页逛 ClawHub
多工具用户装
19
dsh-pocket
出门要用电脑上的 DSH
扫局域网码
跑长任务才装
20
dsh-usage
不知道花了多少钱
配好价格表
用官方 API 必装

按身份选:给你几套组合

如果你刚开始用 DSH(第一周)

“

dshmarket + dsh-web-ui-all + dsh-context + modsearch

先把界面搞顺、把上下文搞懂、把联网搞通。别一上来折腾。

dsh-context 尤其重要——它会让你之后所有的插件决策都有依据。

如果你日常要写代码

“

上面那套地基 + cc-safety-net + dsh-code-review + archify + dsh-vision-router

安全 → 审查 → 理解 → 调 bug,写代码的完整闭环。

cc-safety-net 必须是第一个装的——AI 抽风删库这件事,我见过不止一次。

如果你本来就用 Claude Code / Codex CLI 那套

“

dshmarket + dsh-TUI + modsearch + dsh-context + dsh-usage

终端手感 + 能查最新资料 + 看得懂 token + 看得住余额。

如果你完全不想碰命令行

“

别装插件了,去下 DSH Desktop。双击就有,插件从它内置页面装。

如果你要扒中文平台(B站/小红书/V2EX/知乎/微博)

“

dsh-web-search-pro。这是它唯一不可替代的地方。

如果你要做设计/封面/PPT

“

open-design + dsh-vision-router(生成后要核对视觉细节时)

如果你要跨会话记住项目上下文

“

OpenViking(@openviking/dsh-memory-plugin)。字节的 volcengine,31k star,是目前最正规的长期记忆方案。

如果你要在外面用电脑上的 DSH

“

dsh-pocket。但公网访问想清楚再开。


几个我必须说的实战提醒

装插件的顺序有讲究。

我一般是:先 dshmarket(有了市场,剩下的事都能在里面点),再按需求一个个装。一次性敲五条命令装五个插件,出了问题你分不清是谁的锅。

装完先验证再继续。

dsh plugin --profile web list --depth 0dsh --dump-config

list 看你装了什么,--dump-config 看组合后的完整配置树。这两个命令是排查一切插件问题的第一站。

“宿主已挂载但 UI 不显示”是个典型症状。 按顺序查:① 装完重启 dsh web 了吗;② npm 版和仓库版是不是同时装了(两个来源并存没有额外收益,建议只留一个);③ profile 的 pnpm-workspace.yaml 是不是需要 nodeLinker: hoisted。

nodeLinker:hoisted

别装太多。

插件只在启用时注册自己的工具和页面,卸掉一个,它注册的一切自动撤销、不留残余。但“按需”的意思是 3–5 个,不是 30 个。

工具一多,模型选错工具的概率会上升,token 也烧得更快。这在 dsh-context 的“工具定义”那一栏看得很清楚——很多插件装上以后,光它们自己的 schema 就吃掉你几千 token 每轮。

版本锁死。

DSH 还是 developer preview,官方自己都警告会有 breaking change。modlens、modsearch、dsh-agent-teams、dsh-vision-router 这几个跟版本绑得特别紧的,一定要锁版本号。

安全最后再说一遍。

装插件 = 让第三方代码在你的机器上跑,权限跟你本人一样大。优先装市场里标“精选”、star 高的;敏感任务把 sandbox 调到 read-only 或 workspace-write;风险操作交给审批流程拦。

永远不要把 API key 提交进插件仓库。

而今天这篇里,有两个插件的权限明显超出日常: dsh-browser(能读你所有已登录页面)、dsh-pocket 的公网模式(把能执行代码的 DSH 暴露到互联网)。这两个我用了“小号首测”和“fail closed”这种级别的提示,就是因为它们的爆炸半径真的大。


写在最后

回头看这一轮,DSH 生态的变化速度依然有点吓人。

我写第一篇 DeepSeek Harness 文章的时候,插件生态还是“一千多个”。第二篇是 16000+。这次我去数 dshmarket.com,它是 10778;dshmarketplace.dev 是 16000+。

插件数量爆炸的时候,最稀缺的不是插件,是判断力。

所以这篇我花了比“介绍功能”更多篇幅在讲三件事:

  1. 每个插件的爆炸半径(它能碰到你的什么)
  2. 它的坑(同名包、版本绑定、卸载了会怎样)
  3. 谁不该装它

装一两个解决 80% 问题的插件,比装二十个互相打架的插件强得多。

如果你按上面的清单装完,还是觉得“哪里不对”,大概率不是插件的问题,而是模型和预设的问题——DSH 默认的 Minimal 预设阉割掉了联网搜索、任务规划、Skills、子 Agent 和上下文压缩。换成 Standard,或者试试 dsh-web-ui 里的梁神模式,体验会完全不一样。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料