前言¶
DeepSeek Harness(DSH)的生態理念是“一切皆插件”。在使用智能體開發或交互時,經常會遇到需要臨時詢問模型、計算數值或查看代碼片段,但又不想污染當前會話歷史、不消耗上下文窗口的情況。dsh-btw 插件提供了類似 Claude Code 中 /btw 的行爲,在 DSH 中實現一次性的、不計入會話記憶的問答。
插件介紹¶
dsh-btw 是一個全局命令插件,它註冊了 /btw 命令。該命令發起一次獨立的一次性模型請求,答案會以持久化的命令節點渲染在會話流中,但不會寫入任何會話消息(不產生 user 消息、assistant 消息或會話事件),因此不影響後續輪次的記憶。
- 類別:客戶端
- 許可證:MIT
- 維護者:clclyzybzjsq
核心功能¶
- 全局生效:在 profile 下任何 agent preset / 模式 / 會話都可用,無需在每個 preset 中單獨配置。
- detached 即時清空:觸發即清空 composer,不排隊。主代理繁忙時也可隨時觸發,命令行走管線而非消息隊列。
- 沿用當前模型:優先複用當前會話最近一次請求的 provider/model 路由,其次纔是 agent 自身的配置;兩者都沒有時會返回明確錯誤。
- 只讀上下文拼接:自動攜帶最近最多 40 條用戶/助手消息(合計上限 32000 字符)作爲只讀背景,使提問可以引用會話內容。
- 零運行時依賴:構建產物爲純 ESM,不 import 任何運行時包,不會隨 harness 產生依賴版本漂移。
- 可取消:把 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