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

⚠️ dsh CLI 安装方式以官方文档为准,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-meterdsh-cost-meter,在会话界面实时看到本轮 token 费用和账户余额,适合经常用 DeepSeek 编程的用户。

场景 2:打造沉浸式 TUI 开发环境

deepseek-harness-tuidsh-TUI 把 DeepSeek Harness 跑在全屏终端,像使用 Claude Code 一样,适合 Linux 服务器党。

场景 3:学术/文档写作流

dsh-at-file 实现 @ 文件引用,dsh-annotation 做选中批注,配合侧边栏插件组成完整的写作辅助环境。

场景 4:团队共享插件配置

通过 profile bundle 方式把一组插件打包,团队成员一条命令同步开发环境。


坑与注意

  1. 插件兼容性:DSH 仍处于活跃开发阶段,插件依赖的 API 可能随版本变化,部分插件可能在新版 DSH 上失效。安装前看一下插件的更新时间。

  2. 插件维护者状态:大部分插件是个人维护,更新不稳定。列表共 204 个插件,实际活跃维护的比例未知,选用前建议看一下对应仓库的 commit 频率。

  3. dsh plugin add 命令格式:本文使用 DSH 官方文档的通用描述,实际参数可能需要 dsh plugin --profile web add xxx 或其他格式,请务必先运行 dsh plugin --help 确认

  4. 安全风险:安装第三方插件等于给 Agent 扩展了工具权限,选择不知名插件前建议看一下源码,特别是需要读写文件或网络请求的插件。

  5. 官方插件目录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 命令格式标注 ⚠️ 以官方输出为准,未做实机核验。