前言¶
DeepSeek Harness（DSH）把擴展能力做成插件，社區目錄是獨立站點，並非官方應用商店。日常和智能體對話時，輸入不一定只靠鍵盤：長提示詞、常用模板、本地文檔、口述內容，都需要更順的輸入路徑。
dsh-better-input 是面向 DSH Web UI 的輸入增強插件，由 DIAG5 維護，採用 MIT 許可證。下面介紹它能做什麼、如何安裝，以及幾種典型用法。
這是什麼¶
dsh-better-input 提供語音輸入、AI 潤色、提示詞優化、提示詞模板、本地文件輸入和文件轉 Markdown 等能力。
它可以複用 DSH 已配置的模型，部分功能無需額外 API Key；提示詞模板保存在本地，不經服務器。倉庫地址是：
https://github.com/DIAG5/dsh-better-input
核心功能¶
語音輸入¶
點擊麥克風按鈕後，可以邊說邊轉寫，識別出的文字會即時流式進入輸入框。
語音識別在瀏覽器本地完成，使用 Web Speech API，無需 API Key，也沒有服務器往返。Firefox/Safari 不支持時，麥克風按鈕會自動禁用。單次錄音上限可自定義爲 1–600 秒。
AI 潤色¶
AI 潤色用於語音識別後的自動清理，包括去口頭禪、修同音錯字、補標點，並把口語列舉轉成編號列表。
該功能複用 DSH 已配置的模型，無需額外 Key。潤色進行中如果手動修改草稿，結果不會覆蓋編輯；失敗時會保留原文。
提示詞優化¶
提示詞優化用於把已經寫好的提示詞整理得更精準。
在輸入框裏寫好提示詞後，點擊輸入框右上角的優化圖標，會彈出原文與優化結果的對比頁面。確認滿意後可以採用，也可以取消並保留原文。該功能複用 DSH 已配置的模型，無需額外 Key。
提示詞模板¶
常用提示詞可以存成模板，之後在輸入框鍵入 / 搜索並一鍵插入正文。
模板保存在宿主本地：
~/.dsh/better-input/templates.json
模板數據不經服務器，也不上傳。最多 200 個模板，正文上限 8000 字。
文件輸入與文件轉 Markdown¶
dsh-better-input 支持把本地文件帶進輸入框。
純文本文件可以直接發送。文檔類文件可以先轉換，再以 @文件名 的形式插入爲引用芯片。支持的文檔格式包括 PDF、DOCX、XLSX、PPTX、HTML、EPUB、CSV、JSON、XML 等。發送時，文件引用會展開成轉換後的 Markdown 正文。
OCR 視覺識別¶
README 的使用說明中提到 OCR 視覺識別：針對沒有文本層的掃描 PDF、圖片型 PDF 或圖片型 PPT，可以逐頁或抽圖交給視覺模型轉爲 Markdown。
需要說明的是，已實現能力清單中未單列該項，因此建議在實際啓用前以倉庫當前說明爲準。
更新檢查¶
設置頁底部提供“關於與更新”入口，可一鍵檢測 npm 最新版。如果發現新版本，會給出更新命令。
DSH 不會在進入時自動更新第三方插件，需要手動執行更新命令。
可視化設置¶
設置頁可配置識別語言、錄音時長、語音潤色開關、模型、自定義提示詞等內容。
如果希望使用滑塊式推理強度調節，README 提到可以安裝：
@HanaAyane/dsh-reasoning-effort
安裝與啓用¶
前置條件¶
安裝前確認環境滿足：
- DeepSeek Harness
>= 0.1.0-rc.8 - Node.js
^22.19.0 || >=24.0.0 - Chrome/Edge 瀏覽器
有全局 dsh CLI¶
如果已經安裝全局 dsh CLI，可使用：
dsh plugin --profile web add dsh-better-input
沒有全局 dsh CLI¶
如果沒有全局 CLI，或不希望寫入全局環境，可使用 npx 臨時拉取：
npx -y @deepseek-ai/dsh plugin --profile web add dsh-better-input
備選安裝方式¶
根據倉庫資料，備選安裝方式還包括：
- 從源碼安裝
- 在 agent preset 的
cordis.yml中添加 insert 配置
安裝後刷新 Web UI，輸入框右側會出現麥克風圖標。
典型用法¶
1. 語音輸入¶
- 打開任意對話。
- 點擊輸入框右側的麥克風按鈕。
- 開始說話，識別文字會即時流入輸入框。
- 再次點擊按鈕或點擊停止，結束錄音。
- 檢查、修改後發送。
2. AI 潤色¶
- 進入設置 → BetterInput。
- 打開 AI 潤色。
- 選擇一個 DSH 裏已配置的模型。
- 語音識別後，系統按已配置能力進行清理。
3. 提示詞優化¶
- 在輸入框裏寫好提示詞。
- 點擊輸入框右上角的優化圖標。
- 查看原文與優化結果對比。
- 選擇採用優化結果，或取消並保留原文。
4. 提示詞模板¶
- 進入設置 → BetterInput → 提示詞模板。
- 點擊新建模板。
- 保存模板後，回到輸入框。
- 鍵入
/搜索模板。 - 選中候選項，模板正文插入輸入框。
5. 添加文件與轉 Markdown¶
- 點擊輸入框右上角的添加文件按鈕。
- 選擇本地文件。
- 純文本文件可直接輸入
@選入併發送。 - 文檔類文件先點擊開始轉換。
- 在輸入框中鍵入
@，選擇該文件。 - 發送時，文件引用會自動展開爲 Markdown 正文。
6. OCR 視覺識別¶
- 進入設置 → BetterInput。
- 選擇一個支持圖片輸入的 OCR 視覺模型。
- 添加
.pdf或.pptx文件。 - 點擊開始轉換。
- 按提示選擇是否使用 OCR。
如果未配置 OCR 模型，使用 OCR 時只會收到引導去設置頁的提示，不會報紅錯。若所選模型明確聲明不支持圖片輸入，會提前提示更換，避免無效結果。
7. 檢查更新¶
- 進入設置 → BetterInput → 關於與更新。
- 點擊檢查更新。
- 如果發現有新版本，查看給出的更新命令。
- 根據當前安裝方式，使用全局
dshCLI 或 npx 方式執行更新命令。
適用場景與注意¶
適合在 DSH Web UI 中頻繁輸入提示詞、語音輸入口述內容，或需要把本地文檔餵給智能體的人。
需要注意：
- 語音輸入依賴瀏覽器能力，Firefox/Safari 不支持時按鈕會自動禁用。
- 提示詞模板保存在本地，不經服務器。
- DSH 不會自動更新第三方插件，需要手動執行更新命令。
- DSH rc.8 起已原生支持圖片輸入；README 也說明不再提供圖片相關的插件功能。
- OCR 視覺識別在 README 使用說明中出現，但已實現能力清單未單列，使用前請覈對倉庫當前說明。
- 插件會隨 DSH 客戶端運行，實際權限取決於啓動 dsh 的環境；安裝前應檢查源碼與許可證。
- 許可證爲 MIT。
鏈接¶
GitHub：
https://github.com/DIAG5/dsh-better-input
社區目錄頁：本次資料未確認目錄頁 URL，本文不提供該鏈接；如需查看，請以 DSH 社區目錄實際頁面爲準。
