silencieuxzero/Better_Deepseek_Harness ↗★ 4
better-deepseek-harness
更好的 DeepSeek Harness:支持直接从 Web UI 设置页面安装和管理技能与插件。
AI 分析
核心用途是简化 DSH 的插件与技能管理。适合不希望频繁使用命令行、想在 Web 界面中直观配置和热加载插件的用户。提供一键安装脚本,支持配置校验。
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:silencieuxzero/Better_Deepseek_Harness说明文档
阅读完整 README ↗部署配置(ext-center 行的 config 块)
部署可调的行为全部收敛在 cordis.patch.yml 中 ext-center 行的 config: 块,用 schemastery 校验:每个字段自带默认值与合法范围,非法值会让插件加载失败并给出明确报错(宁可响亮失败,不静默漂移)。安全不变量(请求体 2 MiB、技能 URL 下载 1 MiB、插件 tgz 下载 64 MiB、文件编辑器 1 MiB、终端单次写入 4096 字符、git 单批路径 500 条、归档删除单批 500 条、输入优化单次文本 100 KiB)保持固定、不可配置。
- insert:
- id: ext-center
name: better-deepseek-harness
config:
pluginRoot: "" # 插件安装根;留空 = profile 共享模块根 node_modules
tree:
maxEntries: 2000 # 单目录最多返回条目数
ignores: [".git", ".svn", ".hg", "node_modules", ".dsh", "dist",
".next", ".cache", ".turbo", "coverage", "__pycache__",
".DS_Store"]
terminal:
maxSessions: 8 # 终端并发上限(1-64)
bufferLimit: 262144 # 每个终端的输出环形缓冲(字节)
git:
timeoutMs: 60000 # 单条 git 命令超时(毫秒)
diffLimit: 524288 # 单文件 diff 载荷上限(字节,超出截断)
logMax: 30 # 提交历史条数
mcp:
maxServers: 16 # 面板管理的 MCP 服务器上限
vision:
maxImagesCap: 8 # 单次请求转述图片的部署上限(设置页的 1-N 以此为界)
maxTokens: 1024 # 单次转述输出的默认 token 上限(设置页可覆盖,64-8192)
toolRepair:
enabled: true # tools/execute 参数修复总开关
descriptionFill: "Execute tool" # description 缺失时的中性占位文案
client:
terminalPollMs: 300 # 浏览器终端输出轮询间隔
terminalListPollMs: 2000 # 浏览器终端列表轮询间隔
gitPollMs: 5000 # 浏览器 git 状态轮询间隔
mcpPollMs: 3000 # 浏览器 MCP 列表轮询间隔
rescue:
enabled: true # 急救模式总开关(默认开)
settleMs: 12000 # 启动窗口:启动后多久无异常才算启动成功(3000-120000)
以上全部字段均可省略(省略即取默认值);config: 块本身也可省略。改完后配置监听器热生效(config 属于 ext-center 行的元数据,同样由监听器重放)。Web UI 通过 /ext/api/state 的 limits 块读取这些上限,界面文案(「前 2000 项」「上限 8 个」等)与轮询节奏随之自动跟随。
使用
- 打开 Web UI → 设置(齿轮)→ 更好的 DeepSeek Harness
- 「技能」页:填写名称(小写 kebab-case)与内容 / URL / 路径,点安装;列表项可卸载
- 「插件」页:选择来源并填写 npm 包名 / tarball URL / 本机目录 / Git 仓库地址,点安装;已安装插件可启用、停用、卸载
- 「设置」页:修改本插件的偏好(保存到 settings.yaml 的
ext-center节) - 「Tavily」页:填写 API Key 并打开「启用搜索」,会话中模型需要实时信息时会自动搜索并引用来源
- 「GitHub」页:公开仓库无需配置即可用;需要更高速率或访问私有仓库时填写 Token 并打开「启用 GitHub 工具」,会话中模型可查询仓库元数据、列目录、读文件、搜索仓库、查看发布
- 「通知」页(Windows):按需开关「提问时通知」与「流程结束时通知」——模型等你输入、或一次流程结束时会弹出系统 Toast 提醒
- 会话页:在输入框右下角(发送按钮与上下文按钮之间)点击星星图标「优化输入」,当前模型会把输入优化后回填到输入框
- 侧栏底部:点击「归档」查看已归档对话,勾选后点击「删除」批量永久删除(需二次确认;仍在运行 / 加载中的会话会自动跳过并提示)
- 急救模式:Harness 启动失败后自动进入——启动成功后弹出对话框列出被禁用的第三方插件,多选后「启用所选并重新加载」,或「全部恢复」/「保持禁用」;也可在「插件」页手动点击「进入急救模式」
安全:所有变更类接口以及会暴露本机路径/输出的读取端点(
/ext/api/state、文件树、终端输出、Git 读取、MCP 列表)默认只允许本机(回环地址)调用;如需局域网管理,在「设置」页打开allowLan。另外注意:Git 源安装本身等于运行仓库里的代码——安装/加载插件以及自动构建(npm install会执行该仓库声明的 npm 生命周期脚本)都会执行其内容,请只安装你信任的仓库。