awesome-dsh-plugin/awesome-dsh-plugin · 上手攻略
- 仓库:awesome-dsh-plugin/awesome-dsh-plugin
- 链接:https://github.com/awesome-dsh-plugin/awesome-dsh-plugin
- 分类:AI Agent 生态
- 作者:Tom
- 更新:2026-08-14
这是什么
awesome-dsh-plugin 是 DeepSeek Harness(DSH)社区插件精选列表,目前收录 204 个插件,全部可通过 dsh plugin add 一键安装。
DeepSeek Harness(dsh)是 DeepSeek 开源的 Coding Agent 框架,同时提供 Web UI 和 headless 两种运行形态。它的核心设计哲学是「一切皆插件」——模型、工具、沙箱、会话存储、UI、乃至 Agent Loop 本身都是插件。这意味着你可以替换官方 Agent 的任意核心部件,或者组装出完全不同的新工具。
本列表就是这套插件生态的入口,收录 UI 增强、记忆管理、工具扩展、工作流自动化、通知集成、模型接入、开发调试等九大类别。
解决什么问题
如果你已经在用 DeepSeek Harness,默认能力是够用的,但以下场景会很快遇到瓶颈:
- 想自定义会话界面、换主题、加侧边栏,但不知道怎么装
- 需要 cost meter、balance tracker 来监控 API 消耗
- 想要 MCP 工具、TUI 终端界面、或 @file 代码引用功能
- 社区有哪些插件、哪个靠谱,完全没有头绪
这个列表就是答案——经过社区筛选的插件目录,有安装命令,有功能描述,省去满 GitHub 搜索的时间。
快速安装
前置条件
需要先安装 Node.js(建议 v18+):
node --version # 确认已有 node
安装 dsh(如果还没有)
npm install -g deepseek-harness
# 或
npx deepseek-harness --version
⚠️
dshCLI 安装方式以官方文档为准,npm 包名可能有变化,建议先查 https://github.com/deepseek-ai/deepseek-harness 确认。
安装插件(两种方式)
方式一:通过 dsh-find-plugin 插件搜索(推荐)
# 先装搜索插件
dsh plugin --profile web add dsh-find-plugin
# 然后直接问 agent 找插件,例如:
# "帮我找一下有哪些 cost meter 相关的插件"
方式二:直接通过插件名安装
dsh plugin add <plugin-name>
# 例如
dsh plugin add dsh-tianshu-tui
dsh plugin add dsh-balance-meter
⚠️ 安装命令语法基于 DSH 官方文档说明,实际
dsh plugin add参数格式请以dsh plugin --help输出为准,DSH 版本不同可能存在差异。
核心用法
插件目录速查
按类别找插件:
| 类别 | 代表插件 | 功能 |
|---|---|---|
| UI 增强 | dsh-tianshu-tui, dsh-visualize, dsh-genui | 终端 UI / 对话内生成式卡片 / 交互组件 |
| 会话与消息 | dsh-at-file, dsh-annotation, dsh-navbar | @文件引用 / 批注 / 节点导航 |
| 记忆 | (各插件通过工具扩展记忆能力) | — |
| 工具与能力 | dsh-spotlight, dsh-diff-viewer | 命令面板 / diff 查看器 |
| 工作流自动化 | dsh-task-status, dsh-sticky-note | 任务状态栏 / 便签 |
| 通知与集成 | dsh-balance-meter, dsh-cost-meter | 余额监控 / API 费用统计 |
| 模型与账号 | dsh-openpencil, DSH-better-sidebar | 设计预览 / 侧边栏工作台 |
常用命令
# 列出已安装插件
dsh plugin list
# 更新插件
dsh plugin update <plugin-name>
# 卸载插件
dsh plugin remove <plugin-name>
# 查看帮助
dsh plugin --help
典型适用场景
场景 1:监控 DeepSeek API 消耗
安装 dsh-balance-meter 或 dsh-cost-meter,在会话界面实时看到本轮 token 费用和账户余额,适合经常用 DeepSeek 编程的用户。
场景 2:打造沉浸式 TUI 开发环境
用 deepseek-harness-tui 或 dsh-TUI 把 DeepSeek Harness 跑在全屏终端,像使用 Claude Code 一样,适合 Linux 服务器党。
场景 3:学术/文档写作流
用 dsh-at-file 实现 @ 文件引用,dsh-annotation 做选中批注,配合侧边栏插件组成完整的写作辅助环境。
场景 4:团队共享插件配置
通过 profile bundle 方式把一组插件打包,团队成员一条命令同步开发环境。
坑与注意
-
插件兼容性:DSH 仍处于活跃开发阶段,插件依赖的 API 可能随版本变化,部分插件可能在新版 DSH 上失效。安装前看一下插件的更新时间。
-
插件维护者状态:大部分插件是个人维护,更新不稳定。列表共 204 个插件,实际活跃维护的比例未知,选用前建议看一下对应仓库的 commit 频率。
-
dsh plugin add命令格式:本文使用 DSH 官方文档的通用描述,实际参数可能需要dsh plugin --profile web add xxx或其他格式,请务必先运行dsh plugin --help确认。 -
安全风险:安装第三方插件等于给 Agent 扩展了工具权限,选择不知名插件前建议看一下源码,特别是需要读写文件或网络请求的插件。
-
官方插件目录:
dsh-builtin-toggles插件提供官方内置插件目录和审核安全 UI 建议优先从这里找,降低安装来历不明插件的风险。
与同类对比
| 项目 | awesome-dsh-plugin | Claude Code 生态 | OpenAI Agents SDK |
|---|---|---|---|
| 定位 | DSH 插件精选目录 | 官方 CLI + 社区扩展 | 官方 Agent 框架 |
| 插件数量 | 204 个(持续增加) | 少量官方扩展 | 少量工具集成 |
| 安装方式 | dsh plugin add |
各自独立安装 | SDK 内置 |
| UI/TUI | 多种 TUI 插件可选 | 社区非官方 | 无内置 |
| 适用人群 | DeepSeek 重度用户 | Claude Code 用户 | OpenAI API 用户 |
如果你的主力模型是 DeepSeek,DSH 生态是目前最完整的方案;如果你用 Claude Code 或 OpenAI 的生态,各自的官方 CLI 是更稳的选择。
一句话结论
DeepSeek Harness 用户必收藏——204 个插件覆盖 UI、监控、开发流,按需安装,大幅提升 Coding Agent 使用体验。
来源:GitHub README(英文 + 中文)、awesome-dsh-plugin.com 页面、D SH 官方概览页(deepseek.com/harness)、W32 lessons 写作指引(数字核验 / 双轨 / 风险边界)。dsh plugin add 命令格式标注 ⚠️ 以官方输出为准,未做实机核验。