前言¶

在 DSH 裏寫提示詞，常見卡點不是「想不清楚要什麼」，而是草稿缺上下文、缺輸出形態、缺邊界，模型一次接不住。自己反覆潤色又佔時間。QBuddy 是 DSH 桌面端插件：在輸入框右側提供一個按鈕，讀當前草稿，發起一次獨立的模型補全，把結果清洗後寫回輸入框（或等你點「應用」再覆蓋）。它不參與對話——增強不進歷史、不產生輪次，也不會改掉你正在聊天用的會話模型。

這是什麼¶

QBuddy（包名 dsh-qbuddy-prompt-enhance）由社區維護者 dhdkfkfkf 發佈，分類爲客戶端插件。當前版本 0.6.6，許可證 MIT。目錄頁：skillhub.cn/plugins/dhdkfkfkf/dsh-qbuddy-prompt-enhance；源碼與說明：GitHub 倉庫。

核心功能¶

下面介紹 README 中已寫明、且與實現一致的能力。

輸入框旁的按鈕與狀態¶

• 輸入框爲空（含只有空白）時，按鈕不渲染；有內容時出現，清空後又隱藏，不佔位。
• 左段：單擊開始增強；運行中顯示已用秒數（滿 1 秒才顯示，到超時預算的 80% 轉警告色，默認 30 秒即第 24 秒），再點一次取消，草稿不動。
• 右段：打開菜單，切換預設、提示詞模型、思考強度。
• 結果返回時：草稿未變則直接寫回；增強途中你改過字則變爲「應用」，由你決定是否覆蓋；草稿已清空則丟棄結果。失敗時懸浮提示給出原因，再按一次用同一份草稿重試。

預設與模型¶

• 四檔內置預設（從保守到激進）：Qoder（qoder）、WorkBuddy 潤色（workbuddy-polish）、QBuddy 默認（qbuddy）、WorkBuddy 擴寫（workbuddy-expand）。內置檔只讀；要改文案需新建自定義預設。
• 自定義預設：數量不限，每項含 system / user 模板；user 必須含 {{draft}}，保存後立即出現在菜單。
• 三樣快切：預設、增強用的 provider/model、思考強度均在菜單中修改，寫入插件配置，隻影響這一次增強調用，不動會話模型。

配置頁¶

入口：插件詳情頁 → QBuddy 配置。可設 provider/model、思考強度（模型支持時）、超時（0.1–600 秒）、自定義預設的增刪改。保存後輸入框菜單自動重拉，無需重啓。

安裝與啓用¶

桌面端的 desktop Profile 由 Electron 應用託管，不能用 dsh plugin add 安裝，否則會報 profile "desktop" is managed exclusively by the Electron application。

桌面版（Desktop）¶

1. 界面安裝（推薦）：設置 → 插件 → 安裝，選擇下載好的 .tgz 或填包名，啓用後完全退出並重開 DSH（含托盤圖標）。
2. AI 會話安裝：在支持 plugin_manager 的會話裏執行 install_bundle，target 傳解包後含 package.json 的目錄絕對路徑（不能直接傳 .tgz）。
3. 本地目錄鏈接（改代碼用）：插件頁選本地源碼目錄，以 link: 鏈入 profile，改完重啓 DSH 生效。

Web 版 / 命令行（CLI）¶

Web 版不受 Electron 託管，可用 dsh plugin（參數轉給 profile 目錄裏的 pnpm）。本插件暫未發佈到 npm；從 GitHub 裝源碼示例：

dsh plugin --profile web add github:dhdkfkfkf/dsh-qbuddy-prompt-enhance

其他來源（資料原文）：

# 本地 tgz（離線）
dsh plugin --profile web add file:/絕對路徑/包.tgz

# 本地目錄（link，改代碼即生效）
dsh plugin --profile web add ./插件目錄

從 GitHub 裝源碼時，若包需編譯且 pnpm 攔截 prepare，需按報錯在 profile 的 pnpm-workspace.yaml 里加 allowBuilds；本插件爲純 JS、無構建步驟，一般無需此步。

從舊版升級（0.6.6 起）¶

Loader 入口 id 從 prompt-enhance-v2 改爲 dsh-qbuddy-prompt-enhance。升級前請刪掉 profile cordis.patch.yml 裏 id: prompt-enhance-v2 條目，避免同一插件加載兩次。

典型用法¶

1. 在 DSH 輸入框裏寫下草稿（按鈕出現後可見）。
2. 需要時在按鈕右側菜單選擇預設、增強模型或思考強度。
3. 點左段開始增強；若運行過久可再點取消。
4. 若中途改過字，左段會顯示「應用」，確認後再覆蓋當前草稿。
5. 需要長期策略或自定義 preset 時，打開 QBuddy 配置 一次性配好。

內置四檔含義（菜單與配置頁順序一致）：

配置項概要¶

cordis.patch.yml 入口 id 爲 dsh-qbuddy-prompt-enhance。常用鍵包括：enabled（默認 true）、preset（默認 qbuddy）、customPresets、provider / model（留空則跟隨默認模型）、reasoningEffort、timeoutMs（默認 30000，允許 100–600000）。帶 volatile 的字段在 Loader 中就地更新，切檔、切模型不必重掛載整條插件。

適用場景與注意¶

適合誰：經常在 DSH 裏寫長提示、希望少手工補結構、又希望增強與正式對話分離的開發者。

權限與安全：插件以當前 DSH 進程權限運行；安裝前應自行查看源碼與 MIT 許可證。增強路由僅接受本機同源請求，請求體上限 256 KB；草稿在 system 中視爲不可信數據；日誌不記錄草稿正文。插件不讀附件、剪貼板、選區或歷史消息，只發一次補全、不調用工具。

已知限制（資料原文）：僅整體替換純文本草稿，無選區替換；非流式；依賴宿主 LLM 服務（無服務時路由 501）；輸入框收進活動面板時工具條隱藏，按鈕不可見；預設與模板存於 profile，不跨設備同步。

結尾¶

QBuddy 把「把草稿寫成模型能接住的形狀」收成輸入框旁的一鍵操作：四檔內置預設、任意自定義預設，以及增強專用的模型與思考強度快切，且不污染對話歷史與會話模型。需要安裝包、配置細節與設計說明時，請以倉庫 README 爲準。

• 社區目錄：https://www.skillhub.cn/plugins/dhdkfkfkf/dsh-qbuddy-prompt-enhance
• GitHub：https://github.com/dhdkfkfkf/dsh-qbuddy-prompt-enhance