silencieuxzero/Better_Deepseek_Harness

Plugin插件 Native原生 ⭐ 2 GPL-3.0 Clients & Launchers客户端与启动器

更好的Deepseek Harness,对webui和deepseek harness进行了一些功能扩展

Project Overview项目介绍

This is a DSH-native plugin built exclusively for the DeepSeek Harness Web UI. It adds a centralized management interface to DSH that handles skills, third-party plugins, custom MCP servers, and a range of utility tools. Skills can be installed from three different sources: pasted Markdown, a remote URL, or a local file path. Plugins can be installed from four sources, including npm packages, tarball URLs, local directories, and Git repositories. Git-based installations that lack pre-built artifacts will automatically run npm install and the build step if Node.js is available on your machine. All configuration changes take effect immediately without requiring a full restart of DSH.

The plugin bundles multiple pre-configured useful tools, including automatic image transcription to text, Tavily web search, GitHub repository access, and native Windows notifications for agent prompts and completed workflows. It also adds extra quality-of-life features: a sidebar file tree for browsing project files, archived conversation management, input optimization, and a rescue mode for broken DSH starts. By default, all API endpoints are restricted to localhost access for security, and you can enable LAN access from the settings panel if needed. All tools can be toggled on or off from the settings page, and any tool errors are handled gracefully so they never block normal agent responses.

If you run into common issues during installation or use, the plugin has built-in mitigations for most frequent problems. For example, transient permission errors on Windows when staging new plugins are retried automatically up to five times. Configuration race conditions from rapid successive changes can be fixed with a single restart of dsh web, and invalid configuration values can be cleared by removing the config block to reset to defaults. Most other issues have clear troubleshooting steps outlined in the project README, and the plugin is released under the open source GPL-3.0 license.

这是专为 DeepSeek Harness Web UI 开发的原生插件,它为 DSH 添加了集中管理面板,可统一管理技能、第三方插件、自定义 MCP 服务器和各类实用工具。技能支持 Markdown 粘贴、URL 下载、本地路径三种安装来源,插件支持四种来源,所有配置变更都热生效,无需重启 DSH。

它内置了多个常用工具配置,包括图片自动转文字、Tavily 网络搜索、GitHub 仓库访问、Windows 系统通知等功能,还增加了侧边栏文件树浏览、归档对话管理、输入优化、启动急救模式等实用功能。所有工具都支持开关控制,出错后自动优雅降级,不会阻塞正常回答流程。

插件默认只允许本机访问所有接口,如需局域网管理可在设置中开启权限。从 Git 源安装插件时,若没有构建产物会自动执行 npm install 和构建,遇到小问题如权限占用也内置了重试机制,大部分故障都可以通过简单操作修复,许可证为 GPL-3.0。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add git+https://github.com/silencieuxzero/Better_Deepseek_Harness.git

把 silencieuxzero/Better_Deepseek_Harness 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

better-deepseek-harness(更好的 DeepSeek Harness)

项目名致敬 Minecraft 模组名(?),更好的下界/末地/进度/砧板/FPS/地牢/村庄/经验修补/F3/树叶/动物动作/PVP/HUD/生存/战斗/延迟显示/附魔/图腾/掉落物/钠视频设置按钮……

为 DeepSeek Harness Web UI 编写的插件:在「设置 → 更好的 DeepSeek Harness」中直接安装、卸载、启用/停用 技能(Skills) 与 插件(Plugins),并把插件的自身偏好接入原生设置体系(settings.yaml 的 ext-center 节)。

目录

想了解内部实现、参与开发与贡献?见 CONTRIBUTING.md(架构、目录结构、开发与测试流程)。

功能

点击展开功能列表

插件与技能管理

技能管理

  • 列出已安装技能(名称 / 描述 / 适用场景 / 路径)
  • 三种安装来源:
    • 粘贴 Markdown(含 --- frontmatter,必须有 name 与 description)
    • 从 URL 下载 Markdown 文件
    • 本机文件或目录路径(目录需含 SKILL.md)
  • 安装位置:~/.dsh/skills(技能文件系统提供方实时发现,无需重启)

插件管理

  • 列出通过本插件安装的插件(版本 / 来源 / 配置行数 / 启用状态)
  • 四种来源:npm 包名(走 npm registry)、.tgz 包 URL(内置 tar 解包,无需外部工具)、本机目录、Git 仓库
  • Git 源若未提交构建产物(lib/ 不存在),安装时自动 npm install + npm run build 补构建(需要本机有 npm;失败会给出明确报错,改用 npm / tarball 源即可)
  • 安装后写入 profile 的 cordis.patch.yml,由启动时的 HMR 配置监听器热生效,无需重启;带客户端界面的插件在刷新页面后出现
  • 启用 / 停用 / 卸载(同样热生效)
  • 只读展示当前加载器条目(id / 状态 / 是否启用)

设置与偏好(设置页)

原生设置项(settings.yaml 的 ext-center 节)

设置项 说明
allowLan 是否允许局域网通过 /ext/api 访问(读写都包含:变更类接口以及文件树/终端输出/Git 读取/MCP 列表等回环端点;默认仅本机回环)
skillRoot 技能安装根目录(留空 = ~/.dsh/skills)
customSkillDirs 额外技能目录,每行一个;其中的技能通过本插件注册的 provider 提供给所有会话
treeRoot 侧栏文件树根目录(留空 = 最近注册的工作区,其次进程工作目录)

MCP 服务器:设置页「MCP」页签

  • 添加自定义 MCP 服务器(stdio 本地命令 / streamable-http 远程 URL,支持参数、环境变量、工作目录、请求头、调用超时)
  • 每个服务器写为 cordis.patch.yml 中的一行 @deepseek-ai/dsh-mcp-client 条目(id ext-center.mcp.<名称>),由配置监听器热生效
  • 列表实时显示加载器状态(运行中 / 失败 / 已停用),支持启用 / 停用 / 移除
  • 服务器工具以 mcp__<名称>__<工具名> 提供给模型;手写的外部 MCP 行只读展示

图片转述:设置页「图片转述」配置

  • 启用后,含图片的模型请求在进入文本模型前,先由用户指定的视觉模型(提供方 / 模型 / 提示词 / 单次上限 1-8,部署上限可配置)通过 llm/stream 瀑布包装转述成文字——仅替换本次请求中的图片块,会话记录原图不受影响;转述失败自动降级为占位文本(已安装且激活 dsh-web-ui 的 dsh-tool-describe-image 时本功能自动让位,见「dsh-web-ui 兼容」)
  • 提供方下拉来自已注册的 LLM 路由(/ext/api/state 的 llmProviders),也可选择「自定义路由」并填写 OpenAI 兼容的 chat/completions API URL
  • 自定义路由支持配置 API Key(设置页密码输入框,仅写入不回显,留空保存保持原值);转述请求携带 Authorization: Bearer <key> 头,/ext/api/state 只返回 apiKeyConfigured 布尔、不回传密钥本身
  • 「转述输出上限(tokens)」可在设置页调整(64-8192,留空使用部署默认 vision.maxTokens,推理模型可适当调大)
  • 启用开关会解除宿主 api-gateway 的图片准入限制:宿主按当前模型的 inputModalities 拒绝不支持图片的模型(报 MODEL_DOES_NOT_SUPPORT_IMAGES);开关开启时插件把当前模型宣告为支持图片输入(包装 llm.resolveModelInfo,仅追加 image 模态);关闭时不做任何改动,保持宿主原生校验行为

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-quick-prompts 下一个 Next dsh-usage-balance →