dsh-btw:DeepSeek Harness 全局 /btw 命令插件

前言

DeepSeek Harness(DSH)的生态理念是“一切皆插件”。在使用智能体开发或交互时,经常会遇到需要临时询问模型、计算数值或查看代码片段,但又不想污染当前会话历史、不消耗上下文窗口的情况。dsh-btw 插件提供了类似 Claude Code 中 /btw 的行为,在 DSH 中实现一次性的、不计入会话记忆的问答。

插件介绍

dsh-btw 是一个全局命令插件,它注册了 /btw 命令。该命令发起一次独立的一次性模型请求,答案会以持久化的命令节点渲染在会话流中,但不会写入任何会话消息(不产生 user 消息、assistant 消息或会话事件),因此不影响后续轮次的记忆。

  • 类别:客户端
  • 许可证:MIT
  • 维护者:clclyzybzjsq

核心功能

  1. 全局生效:在 profile 下任何 agent preset / 模式 / 会话都可用,无需在每个 preset 中单独配置。
  2. detached 即时清空:触发即清空 composer,不排队。主代理繁忙时也可随时触发,命令行走管线而非消息队列。
  3. 沿用当前模型:优先复用当前会话最近一次请求的 provider/model 路由,其次才是 agent 自身的配置;两者都没有时会返回明确错误。
  4. 只读上下文拼接:自动携带最近最多 40 条用户/助手消息(合计上限 32000 字符)作为只读背景,使提问可以引用会话内容。
  5. 零运行时依赖:构建产物为纯 ESM,不 import 任何运行时包,不会随 harness 产生依赖版本漂移。
  6. 可取消:把 UI 请求的 AbortSignal 转发给底层 stream,支持中断操作。

安装与启用

前置条件:已安装 dsh CLI 并存在目标 profile(默认 GUI profile 名为 web)。

从 GitHub 安装:

dsh plugin --profile web add github:clclyzybzjsq/dsh-btw

注意:Git 安装会取源码而非构建产物,因此 pnpm 会运行包的 prepare 脚本。如果使用 pnpm >= 10,首次 add 可能会失败。此时需将包 key 复制进 profile 的 pnpm-workspace.yaml:

allowBuilds:
  dsh-btw: true

然后重新执行 add。建议固定 commit 以保证安全。

典型用法

命令在输入框触发后立即清空输入并转入后台执行:

  • /btw 这个函数是做什么的?
  • /btw 帮我算一下 0x2F & 0x0F 等于几

适用场景与注意

  • 版本兼容性:该插件只保证适用于 DeepSeek Harness 官方仓库的 v0.1.1 基线版本(tag dsh-v0.1.1;本地开发基线为 dsh-v0.1.1-rc.2)。不保证在官方仓库更高版本(v0.1.2 及以后)上正常工作,升级 harness 前请先验证。
  • 权限与安全:该插件以当前 dsh 进程权限运行。在安装前应检查源码与许可证,确保信任。
  • 依赖管理:pnpm >= 10 默认拒绝运行 git 依赖的 prepare,需按上述说明在 pnpm-workspace.yaml 中放行。

总结

dsh-btw 插件通过 detached 模式的命令定义,解决了在 DSH 中进行临时问答而不污染会话记忆的痛点。它复用当前模型路由,零依赖,适合需要快速获取答案且不希望增加上下文负担的场景。

  • GitHub 仓库:https://github.com/clclyzybzjsq/dsh-btw
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜