前言¶
在 DeepSeek Harness(DSH)裏推進主線——寫論文段落、改代碼、和 Agent 對齊方案——時,常會卡在一個術語上。若在主會話裏當場追問定義,session log 會堆滿名詞解釋,翻記錄時很難找回剛纔那段「正經事」;另開會話或開瀏覽器查,又要重複交代上下文或離開工作流。
dsh-aside(社區目錄名 zenmokandouhenshuai/dsh-aside)提供「旁問」浮卡:就地提問、就地看答案,答案不進主對話的 session log,也不進入後續 prompt,主線上下文不因此變長。下面介紹它的定位、能力、安裝方式與使用注意。
這是什麼¶
dsh-aside 是 DSH 的 bundle 插件(Host 與 Client 在同一包內),維護者爲 zenmokandouhenshuai,在 SkillHub 目錄中歸類爲 客戶端。包名 @local/dsh-aside(package.json 版本 0.3.0,許可證 MIT)。一句話定位:給 Harness 的旁問卡片——問不會的專業術語,答案留在浮卡與本地存檔,不寫進主會話。
核心功能¶
調用方式¶
- 輸入框右側出現
? 問按鈕,或按Alt+Q呼出浮卡。 - 可先選中一段文字再點按鈕:選中內容作爲上下文一起發送,問法自動預填爲「什麼是 XXX?」。
- 浮卡內:
Enter提交問題,Shift+Enter換行,Esc關閉。 - 長答案在卡片內滾動,避免把輸入框和領域設置頂出視野。
與主線的關係¶
旁問走獨立路徑:問答 不寫入 session log,因此 不進入主對話的 prompt。設計意圖是避免爲一句名詞解釋在每次請求裏重複計費、污染主線上下文。旁問與主線 不能「升格」爲正式一問,也沒有回到當時對話位置的錨點(存檔僅保留選中文字與 session id)。
存檔與側欄¶
每條問答自動存檔。側欄提供 「旁問存檔」 整頁:本地搜索、按天分組、複製、刪除。數據在 ~/.dsh/dsh-aside/asides.json(純文本 JSON,可讀可編輯可備份)。卸載插件 不刪除 該目錄下的數據。
路由與領域¶
回答使用的模型路由是可切換的 偏好,保存在 ~/.dsh/dsh-aside/config.json,例如:
{
"mode": "dp",
"provider": "dp",
"model": "deepseek-v4.1-flash-1017",
"domain": "電池材料"
}
mode: "dp":走你在cordis.patch.yml裏配置的路由(中轉或自建網關等)。mode: "auto":跟隨應用默認模型(agent-default-model,通常爲官方賬號)。
卡片頂部與存檔頁頂部均可點選切換,即時生效、無需重啓。首次啓動若配置文件不存在,插件會按內置 dp 路由寫一份,之後以文件爲準。
領域前提:卡片頂部可設置「我在做電池材料」一類說明,寫入 domain 字段並進入提問的 system prompt,解釋優先按該領域;未設置時按最常見含義解釋,並在跨領域歧義明顯時用一句話點出。回車保存、Esc 取消。
回答通過 Host 側的 ctx.llm.stream() 調用 profile 自帶路由,計費與主對話同源,無需另行配置 API key。
安裝與啓用¶
需要以 profile 方式 啓動 DeepSeek Harness。安裝任選其一(路徑均爲 本倉庫在本機的絕對路徑,勿使用未在文檔中出現的 github:owner/repo 簡寫)。
方式一(推薦):讓 Agent 安裝,調用 plugin_manager 的 install_bundle:
target: <這個倉庫的絕對路徑>
方式二,命令行:
dsh plugin --profile <你的 profile> add <這個倉庫的絕對路徑>
裝完後 必須重啓一次 DSH:Host 半模塊在啓動時裝載,不重啓則改動不生效。若改包名,需同步修改 package.json 的 name 與 cordis.patch.yml 的 name,否則 profile 可能解析不到。
插件以當前 DSH 進程權限運行,安裝前請自行審閱源碼與 MIT 許可證。
典型用法¶
- 主線對話中遇到不熟悉的術語,按
Alt+Q或點? 問。 - 可選:選中含該術語的句子再打開,自動帶上上下文並預填「什麼是 XXX?」。
- 在浮卡中編輯問題後
Enter提交,在浮卡內閱讀答案;歷史問題留在卡片下方。 - 需要長期查閱時,打開側欄 「旁問存檔」 搜索、複製或刪除記錄。
- 若中轉額度用盡,在卡片或存檔頁頂部將路由切到
auto;若術語含義隨學科變化大,在 領域 一行設置前提後回車保存。
適用場景與限制¶
適合:長時間在同一 DSH 會話裏寫材料或寫代碼,頻繁遇到術語卡點,又不想污染主對話或反覆爲解釋付 prompt 成本的開發者與研究者。
README 載明的限制(安裝前應知):
| 項 | 說明 |
|---|---|
| 響應方式 | 非流式,短定義約 2~4 秒(文檔實測約 2.4 秒) |
| 與主線 | 無錨點回跳、不能插回主線 |
| 環境 | 僅在 Windows + desktop profile 上驗證過;代碼未寫死平臺,其他環境無實測記錄 |
Host 側在應用 Origin 下注冊 /dsh-aside/list、/dsh-aside/ask 等 JSON 路由,與頁面共用登錄態;Client 側佔用輸入框右側按鈕、浮層、側欄入口與存檔頁等 slot,樣式使用 --dsw-alias-* 主題 token。
結尾¶
dsh-aside 用浮卡與本地存檔承接術語旁問,把名詞解釋從主 session log 裏拆開,適合在 Harness 裏保持主線緊湊、又可隨時查詞的場景。目錄與源碼:
- 社區目錄:https://www.skillhub.cn/plugins/zenmokandouhenshuai/dsh-aside
- GitHub:https://github.com/zenmokandouhenshuai/dsh-aside
DSH 生態強調「一切皆插件」;SkillHub 爲社區獨立站點,與 DeepSeek / 幻方無官方從屬關係。