前言¶

DeepSeek Harness (DSH) 在 0.1.7 版本中引入了 loopback 檢查，將設置頁面的持久化限制在 127.0.0.1、localhost 或 ::1。當 DSH Web 後接反向代理（如 Nginx）並通過域名訪問時，頁面會被歸類爲非特權，設置會靜默降級爲內存模式，導致設置頁提示不可用。

什麼是 dsh-plugin-loopback-trust¶

這是一個由 6mt 維護的客戶端插件，用於在反向代理環境下恢復 DSH Web 的 Host 持久化設置。它通過將頁面連接標記爲 host-owning，使得設置頁在非 loopback 域名下依然可用。

核心功能¶

• 標記 Host 所有權：將頁面連接標記爲 host-owning，保持設置頁的 Host 持久化。
• 優先級運行：位於 boot prefetch tier，在客戶端插件之前運行。
• 輕量級實現：零依賴，無主機端代碼，純客戶端 JavaScript 實現。
• 版本兼容：支持 dsh >=0.1.7 <0.3。

安裝與啓用¶

1. 執行安裝命令：

    dsh plugin --profile web add 6mt/dsh-plugin-loopback-trust

2. 重啓 dsh web（新 bundle 必須啓動）。
3. 在瀏覽器中硬刷新頁面。

啓用後，通過域名訪問 Settings -> Models，設置應可正常加載。

適用場景與注意¶

• 適用場景：DSH Web 部署在反向代理後，需要通過域名訪問並保存 Host 持久化設置。
• 信任聲明：這是一個信任聲明，需確保反向代理有預期的訪問控制。
• 安全邊界：不觸及服務器端的 /api Host fence，不包含遙測或數據泄露。

結語¶

該插件完全由客戶端 JavaScript 實現，無外部依賴。相關資源可在 GitHub 或 社區目錄 查看。