dsh-web-qa-preset:面向 DSH 的只讀網頁問答預設

前言

在 DeepSeek Harness(DSH)裏,默認的智能體會掛載 Shell、寫入文件等能力,適合改代碼、跑命令。若你只想就時事、政策、產品價格或公開資料問問題,並希望回答帶來源、且不把會話變成「可操作本機」的代理,需要一個邊界清晰的問答預設。社區插件 dsh-web-qa-preset 即爲此提供一套可安裝的 agent preset bundle:搜索優先、引用來源、本地只讀上下文,並在每次回答末尾給出可執行的下一步建議。

這是什麼

dsh-web-qa-preset 由維護者 xiaoxiaosrm 發佈,分類屬於 DSH 社區目錄中的「聯網工具」。它在 DSH 中註冊預設 id 爲 web-qa、界面名稱爲 網頁問答 的 bundle:回答問題時優先查證網絡事實,可只讀查看工作區與指定路徑下的本地文件,不掛載 Shell,並通過 guard 拒絕 write/edit。許可證爲 MIT,當前 package 版本爲 0.1.0。

核心能力

搜索優先與引用

對新聞、價格、政策、產品規格、人物或公司動態、可覈驗數據,或用戶明確要求「去搜一下」時,預設會在作答前通過 web_search 檢索,並在回答中引用相關 URL。需要打開具體頁面時使用 web_fetch。若 DSH 未配置可用的搜索提供方,web_search 會返回結構化錯誤,預設會引導模型說明無法覈實,而不是虛構來源。

本地只讀上下文

可使用 read、read_image、glob、grep 讀取工作區文件、DSH 配置與日誌、或用戶指定的路徑,均限於只讀。對 .credentials.yaml、.env、私鑰等敏感文件的直接讀取會被拒絕。

硬邊界:無 Shell、無寫入

預設不掛載 Shell;雖官方 tool-fs 可能在工具目錄裏列出 write/edit,本 bundle 內的 guard 會拒絕這些調用。也不掛載終端、skill、子代理、計劃模式、待辦或文件投遞類工具。guard 僅作用於該預設作用域,其他會話與其他預設不受影響。

下一步建議

每次回答末尾包含簡短的 下一步建議 小節,通常 1~3 條、按優先級排列的具體建議。

交付形態

純 ESM,通過 dsh.bundle.patch(cordis.patch.yml)注入預設,無需 prepare 或構建步驟。

環境與依賴

  • DSH desktop 0.2.2-rc.1(README 標註爲已測試),或支持內聯 @deepseek-ai/dsh-agent-preset registry 的構建。
  • 運行包內測試需要 Node.js >= 20。
  • 需要在本機 DSH profile 中配置可用的 web 搜索與抓取提供方;bundle 本身不會替你切換或配置 provider。

安裝與啓用

從 GitHub 安裝

在終端執行(命令來自項目 README):

dsh plugin --profile desktop add github:xiaoxiaosrm/dsh-web-qa-preset

從本地目錄安裝

若你已有該倉庫的本地副本,可將路徑替換爲實際目錄:

dsh plugin --profile desktop add ./dsh-web-qa-preset

或在 DSH 會話內通過內置插件管理器安裝 bundle(target 改爲你機器上的路徑):

plugin_manager { action: "install_bundle", target: "D:\\path\\to\\dsh-web-qa-preset" }

安裝後若當前 DSH 構建要求重載,請重啓或重載 DSH;新建會話,在預設選擇器中選 網頁問答。

注意: 若 profile 裏已存在同 id web-qa 的預設聲明,需先移除舊聲明再安裝,避免衝突。

配置搜索提供方

預設僅使用 DSH 的 web_search / web_fetch。請在 profile 的 cordis.patch.yml(或等價配置)中配置可用 provider。README 推薦官方 DeepSeek Search API 與 Fetch API 示例:

- id: web
  name: "@deepseek-ai/dsh-web"
  config:
    searchProvider: deepseek-search-api
    fetchProvider: deepseek-fetch-api

上述方式依賴 DEEPSEEK_API_KEY。也可通過 dsh-search-picker 等選用 Tavily、Exa 等自有提供方,並設置 web.searchProvider / web.fetchProvider。

典型用法

經過上面的安裝與(必要時)搜索配置,可按以下步驟使用:

  1. 新建會話,選擇 網頁問答 預設。
  2. 提出問題;預設會判斷是否需要實時搜索,在不確定時也可能主動搜索。
  3. 若問題與本地代碼或文檔相關,會在只讀前提下讀取相關文件。
  4. 閱讀回答正文與來源鏈接,並參考文末 下一步建議。

工具面概覽(用途以 README 爲準):

Tool Purpose
web_search 檢索公開網頁來源
web_fetch 讀取指定公開頁面
read 讀取文本文件
read_image 讀取支持的圖片
glob 按模式查找文件
grep 在文件內容中搜索

適用場景與侷限

適合: 需要聯網查證且不希望會話具備改文件、跑命令能力的用戶;希望回答帶 URL 引用、並附帶簡短行動建議的問答場景;在只讀前提下結合本地倉庫或配置做說明性查詢。

不適合: 通用編碼代理、自動化運維、安裝依賴或修改工程——README 明確這是 Q&A preset,不能編輯文件、執行命令、安裝包或改系統。本地讀取仍受 DSH 文件系統後端與沙箱權限約束;搜索行爲由外部 provider 決定,須自行配置。搜索觸發由預設 prompt 引導,並非每條消息強制搜索。

安全與權限: 插件以當前 DSH 進程權限運行;安裝前建議查看倉庫源碼與 MIT 許可證。勿將本地密鑰或私密文件內容通過模型發往外部網站;預設 prompt 亦要求模型避免此類行爲。

鏈接

社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;DSH 生態秉承「一切皆插件」,本 bundle 是其中一種只讀網頁問答預設的可選組件。

羽毛球分组比赛记分
小程序二维码

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

小夜