前言¶
DeepSeek Harness（DSH）桌面版與 Web 端共用一部分應用基礎設施。組裝 system-prompt 時，會繼承 app:web-surface、harness:source 等段落：窗口可能被描述成「Web GUI」，ASAR 虛擬路徑可能被寫成「磁盤上的檢出目錄」。模型若按 Web 瀏覽器或本地源碼樹去理解環境，容易在診斷、刷新界面、更新路徑等問題上做出不符合 Electron 桌面實際行爲的判斷。
dsh-desktop-context 是社區維護的 host-only 插件（維護者 lc69282940，MIT 許可證）。它通過 DSH 支持的 system-prompt/assemble 瀑布流，在真實的桌面 system-prompt 組裝過程裏替換已知的固定模板，而不是僅在對話裏追加一句提醒。當前發佈版本 0.1.0，在 Windows Desktop DSH 0.2.0-rc.2 上做過隔離集成驗證；運行時要求 Node 24+。插件無 UI、無 HTTP 端點、不修改應用歸檔或替換核心服務。
這是什麼¶
| 項 | 說明 |
|---|---|
| 名稱 | dsh-desktop-context |
| 倉庫 | lc69282940/dsh-desktop-context |
| 目錄頁 | SkillHub 插件頁 |
| 分類 | 客戶端 |
| 定位 | 糾正桌面端繼承的 Web 環境說明，保留工具、運行時策略、模型變量、人設及其他無關段落 |
激活條件：僅當真實進程入口識別爲 dsh-desktop-host 時生效；僅有名爲 desktop 的 profile 或單獨設置 DSH_WEB_URL 不足以證明是桌面宿主。純 Web/CLI 進程不受影響。若後續 waterfall 中存在完整的 deliberate complete prompt，仍以該完整 prompt 爲準，插件不會強行注入額外說明。
核心功能¶
下面介紹插件在替換模板後，向模型補充的環境語義（可編輯源文見倉庫內 prompts/desktop-surface.md；宿主路徑與傳輸相關事實在運行時推導，而非複製開發者機器上的路徑）。
-
界面與傳輸
「本應用/頁面/GUI」在桌面場景下通常指現有 Electron 窗口，而非 Edge/Chrome 標籤頁；loopback 傳輸 URL 不應被理解爲「請打開瀏覽器」。 -
ASAR 與鏡像
ASAR 內成員是虛擬路徑；解壓鏡像不保證與當前打包一致，編輯鏡像也不會改變已打包的應用代碼。 -
刷新與任務
刷新 renderer 可能中斷 agent/job；需要持久化狀態並在空閒點再重啓，修復過程中不宜刷新。 -
更新路徑區分
Profile 調和、下發的客戶端包、源碼構建、宿主模塊緩存是不同更新路徑，不宜混爲一談。 -
證據優先
優先依據真實原生窗口、配置、日誌與當前契約，而非假設或理想化 DOM 測試。 -
Trajectory 相關
診斷缺失 Trajectory 標籤前，應先查看 code-work-view 偏好，避免誤判爲缺插件。
插件不會替換未知未來模板或與已驗證模板字面不一致的同名自定義文本；也不保證模型一定遵循所供說明——它只修正供給的內容，不控制模型行爲。
安裝與啓用¶
安裝前請等待當前任務結束。插件以當前 DSH 進程權限運行，安裝前應自行查閱源碼與 MIT 許可證。
方式一：桌面應用內
在已安裝的 Desktop 應用 → Plugins → Add plugin，填寫 dsh-desktop-context-0.1.0.tgz 的絕對路徑（必要時也可指向解壓後的包目錄）。本地包文件請放在穩定路徑，profile 可能以文件依賴形式保留該路徑。
方式二：桌面自帶的 dsh 命令
通過原生菜單的命令管理啓用 Desktop 安裝包自帶的 dsh 後，在 PowerShell 中執行（路徑替換爲你的 tgz 絕對路徑）：
dsh plugin --profile desktop add "<absolute-path-to-dsh-desktop-context-0.1.0.tgz>"
說明：與 Electron 無關、單獨 npm 安裝的 dsh 可能無法管理 desktop 保留 profile，應使用捆綁命令或原生插件管理器，而不是另起 Web/Vite 服務。安裝無需編譯或 lifecycle 腳本；支持的安裝器會同時啓用 bundle 與對應 host 行。
啓用後，修正會參與之後正常的 prompt 組裝（含普通新會話與子會話）；已發送的歷史 prompt 不會重寫。若宿主需要重啓才能加載插件，請在空閒點操作——插件本身不會替你 reload 或 restart。
本地開發若包名相同，在空閒點備份舊文件並卸載舊副本後再裝歸檔，不要同時掛載兩份。
診斷與卸載¶
默認診斷目錄爲 $DSH_HOME/diagnostics/dsh-desktop-context/；未顯式設置 DSH home 時使用用戶目錄下的 .dsh。已安裝包可爲只讀。
events.jsonl：追加僅含元數據的激活/組裝記錄，對未變化的組裝狀態去重；無按文件總量輪轉，可在空閒點自行清理舊診斷。last-assembly.json：報告消毒後的模板狀態與指紋元數據，不含 prompt 正文或私有路徑。
可通過環境變量指定完整文件路徑：
DSH_DESKTOP_CONTEXT_DIAGNOSTICSDSH_DESKTOP_CONTEXT_EVIDENCE
組裝事件只說明 hook 曾運行；agentContextPresent 僅表示提供了 agent 字段，不能證明已發起 provider 請求或已持久化 system 消息，且 complete prompt 仍可能覆蓋後續結果。需要區分時請獨立驗證最終輸出。
卸載：在 Desktop 插件管理中移除，或執行：
dsh plugin --profile desktop remove dsh-desktop-context
卸載會移除 hook，後續步驟恢復官方默認的 prompt 組裝；不刪除會話，也不回滾已保存的 profile 設置（插件本身也不修改這些設置）。若未來官方構建已修正同類文案，升級 DSH 後應重新評估是否仍需本插件。
適用場景與注意¶
適合誰
- 在 Windows Desktop DSH 0.2.0-rc.2 上使用智能體，希望 system-prompt 中的環境描述與 Electron 桌面一致，減少「按 Web 瀏覽器或本地源碼樹理解環境」帶來的誤判。
- 需要可審計的組裝側修正（含診斷 JSONL），而不是依賴對話裏的口頭糾正。
範圍與非目標
- 跨平臺路徑解析有單元測試；未對 macOS/Linux 桌面做原生驗收聲明。
- peer 依賴
@deepseek-ai/cordis、@deepseek-ai/dsh-system-prompt、@deepseek-ai/dsh-web-app在 package 中爲 optional，精確 DSH 版本範圍需隨未來發布重新驗證。 - 0.1.0 發佈說明：在隔離集成測試中針對 Windows Desktop 0.2.0-rc.2 驗證，未在本輪發布中重裝到 live 桌面環境。
DSH 生態強調「一切皆插件」；SkillHub 爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-desktop-context 在桌面宿主真實的 system-prompt 組裝鏈路上，替換繼承自 Web 面的已知模板，把 Electron 窗口、ASAR 虛擬路徑、刷新風險與更新路徑等事實寫進供給模型的環境說明。若你正在桌面 DSH 上調試 agent 行爲且懷疑環境段落誤導模型，可在空閒點按上文路徑安裝 0.1.0 包，並用診斷目錄或環境變量覈對 hook 是否參與組裝。
- 目錄頁：https://www.skillhub.cn/plugins/lc69282940/dsh-desktop-context
- GitHub：https://github.com/lc69282940/dsh-desktop-context
