前言¶

DSH 的扩展方式强调插件化，社区可以通过插件给 dsh web 增加页面能力。dsh-kit 是面向 DeepSeek Harness（dsh）的页面能力套件插件，主要给当前会话工作区提供文件树、源代码管理、终端、后台任务、技能管理和手机访问等停靠面板，并把免费多源网页搜索并入 web_search 使用链路。

如果你日常在 dsh web 里操作工作区文件、查看 git 改动、跑后台任务，并且希望网页搜索使用免费多源链路，可以关注这个插件。

这是什么¶

• 插件名：dsh-kit
• 维护者：zhouzhencheng07
• 许可证：MIT
• 定位：为 dsh web 提供可开关的页面能力，围绕当前会话工作区提供停靠面板，并合并 dsh-free-search v0.2.0 中的免费多源网页搜索能力
• 环境要求：Node.js ≥ 22

核心功能¶

终端¶

终端坞用于在当前会话工作区中打开底部终端，支持多标签终端，后台 shell 可继续运行。

终端快捷键：

Ctrl+/

文件树¶

文件树用于浏览当前工作区文件，并支持新建、重命名、删除、预览、编辑和 diff，Markdown 文件支持代码复制。

文件树快捷键：

Ctrl+,

文件删除在 Windows 上会移入回收站，并有二次确认，降低误删风险。

源代码管理¶

源代码管理用于在 dsh web 中查看 git 状态，并进行暂存、提交、放弃、diff、原文视图和仓库初始化等操作。

源代码管理快捷键：

Ctrl+Alt+.

后台任务¶

后台任务用于查看当前会话运行中的任务，读取增量输出，并终止任务。

技能管理¶

技能管理用于枚举工作区级、用户级和技能池中的技能，并支持复制、移动、删除、禁用/启用和优先级显示。

手机访问¶

手机访问通过令牌网关生成链接和二维码，扫码后可用浏览器访问 dsh web，支持局域网和远程链接。

手机访问链接默认生成带令牌的访问地址；远程链接只保留复制按钮，不展示地址与二维码。

手机访问网关默认每次启动都是关闭的。如果希望重启后保留开启状态，需要勾选：

重启后保留开启

需要特别注意的是，手机访问令牌等同于本机完整权限，应仅限本人使用。

网页搜索¶

网页搜索提供免 key 多源 free-search 链路，支持 Tavily、Bing、Sogou 等故障转移。

在设置卡中开启：

网页搜索

开启后，web_search 走免费引擎链；关闭后，web_search 走官方默认渠道。该开关变更需要重启后生效。

搜索结果条数可以设置为 1-8，默认值为 5，保存后即时生效。

安装与启用¶

1、安装 dsh-kit：

dsh plugin --profile web add "github:zhouzhencheng07/dsh-kit"

2、安装完成后，重启 dsh web 使插件生效。

如果是本地开发安装，可以把路径替换成本地检出目录：

dsh plugin --profile web add "file:/path/to/dsh-kit"

典型用法¶

1、启用网页搜索

在设置卡中打开：

网页搜索

然后重启 dsh web。开启后，web_search 会走免费多源链路；关闭后，会回到官方默认渠道。

2、调整搜索结果条数

在设置卡中调整：

搜索结果条数

可设范围为 1-8，默认值为 5，保存后即时生效。

3、使用停靠面板

可以通过快捷键打开对应面板：

Ctrl+/
Ctrl+,
Ctrl+Alt+.

终端用于执行 shell 命令；文件树用于浏览和编辑当前工作区文件；源代码管理用于查看 git 状态并提交改动；后台任务用于查看当前会话运行中的任务、读取增量输出和终止任务。

4、通过手机访问

打开手机访问页后，生成带令牌的链接和二维码。使用手机浏览器扫码后，可以访问 dsh web。

远程链接只保留复制按钮。若希望重启后保留开启状态，可以勾选：

重启后保留开启

适用场景与注意¶

dsh-kit 适合需要在 dsh web 中围绕当前会话工作区操作文件、查看 git 状态、执行终端命令、管理后台任务，并希望使用免费多源网页搜索的用户。

使用前建议注意以下几点：

• dsh-kit 作为 dsh 插件运行，会受当前 dsh 进程权限影响；安装前建议检查源码和 MIT 许可证。
• webserver 仅 loopback 可达；多数宿主端点会做同源、路径或白名单校验。
• 手机访问令牌等同于本机完整权限，仅限本人使用。
• 网页搜索开关变更需要重启后生效；搜索结果条数保存后即时生效。
• dsh-free-search 仓库停留在 v0.2.0，不再单独演进；相关能力已并入 dsh-kit。
• 插件线索或目录页中可能出现 zhouzhencheng07/dsh-free-search，而包名和安装命令显示为 dsh-kit。社区目录是独立站点，不是官方应用商店。

参考链接¶

目录页（插件线索）：

https://www.skillhub.cn/plugins/zhouzhencheng07/dsh-free-search

GitHub：

https://github.com/zhouzhencheng07/dsh-free-search