前言¶

在 DeepSeek Harness（DSH）裏跑 Agent 時，聯網問題往往不在代碼本身：Windows 系統代理、WSL 環境變量、TUN/VPN 虛擬網卡、DNS 緩存，任意一層異常都會讓請求超時或走錯出口。手動逐項排查既費時，也不容易把「DSH 進程實際走的路徑」說清楚。

下面介紹社區插件 dsh-network-settings（維護者 kanneiren）。它在 DSH 設置界面內完成網絡鏈路可視化、分層探測與受控修復，並把結果整理成 Agent 可讀的 Markdown 報告，適合需要穩定訪問 DeepSeek 等目標的開發者。

這是什麼¶

dsh-network-settings 是 DSH 的聯網工具類插件，面向 Windows 原生、WSL 發行版與 macOS 三種運行模型，提供網絡狀態展示、鏈路診斷與安全修復。插件以當前 DSH 進程權限運行；所有檢測默認只讀，只有用戶明確確認後纔會修改配置。

• 目錄頁：SkillHub - dsh-network-settings
• 源碼：github.com/kanneiren/dsh-network-settings
• 許可證：MIT

核心功能¶

運行模型與鏈路圖¶

插件自動識別 DSH 當前運行在 Windows 原生、WSL 還是 macOS。界面會展示 DSH 進程的真實網絡路徑、DNS 側支和第一個失敗點；若路徑經過 TUN/VPN 虛擬網卡，會自動補出物理出口與真實網關。

WSL 場景下的典型鏈路爲：DSH → 發行版 → WSL NAT → Windows Host → 代理 TUN → 物理網卡 → 網關 → 目標。Windows 原生場景則在虛擬網卡後同樣接出物理出口。

探測與報告¶

支持兩種檢測模式：

1. 單次檢測：採集當前配置，對選定目標做探測，並繪製 DSH 鏈路圖。
2. 穩定性檢測：對 TCP/HTTP 做重複採樣。

默認探測目標爲 DeepSeek，可隨時切換。每層探測與整次檢測均有超時上限，網絡故障時不會長時間無響應。

「複製網絡報告」會生成適合 Agent 使用的 Markdown：固定英文小節標題與 report-version、TL;DR 摘要先行，並附帶機器可讀的診斷碼與分層探測延遲。

網絡配置與配置漂移¶

「網絡配置」按來源分組，每個配置項可溯源，主要包括：

• Windows 代理：WinINet / WinHTTP 狀態，以及三個作用域的代理環境變量（含大小寫變體）。
• DSH 進程環境：運行時模型、出口方式（直連或經代理及地址）、代理端口監聽進程實測、進程級代理變量。
• WSL：發行版環境變量、網絡模式（NAT / mirrored）、/etc/wsl.conf 與 .wslconfig。
• 高級網絡：DNS 緩存、接口路由、Hosts、系統急救操作。

若配置存在差異但網絡仍正常，插件只提示「配置漂移」，不發出警告。

推薦修復與安全流程¶

「推薦修復」僅在高置信度診斷能映射到常用低風險操作時出現，例如清理代理殘餘環境變量、關閉系統代理、刷新 DNS 緩存。需要管理員權限或高風險的項保留在手動目錄，不會自動推薦。

持久化修改遵循固定流程：快照 → 預覽 → 確認 → 應用 → 重新檢測 → 可回滾。報告與快照在寫入本地前會自動脫敏；插件無遙測。

界面使用 DSH 原生組件與 --dsw-* token，不建立獨立主題。

安裝與啓用¶

環境要求（來自 README）：

• DSH：@deepseek-ai/dsh >= 0.1.0-rc.6（實測 0.1.0-rc.7 – 0.1.1-rc.2，Web profile）
• Node.js：>= 22.19.0（package.json engines 字段）
• 平臺：Windows 10/11 + WSL；macOS（CI 已驗證，真機驗收待做）

從 npm 倉庫安裝（推薦，自帶預構建產物）：

dsh plugin --profile web add dsh-network-settings

再次執行同一條命令即可更新到最新版。若剛發佈的版本被 pnpm 的 minimumReleaseAge 策略暫緩，可指定版本號安裝，或稍後重試：

dsh plugin --profile web add dsh-network-settings@<版本號>

安裝完成後，打開 DSH 設置 → 插件 → 網絡 即可使用。

若需從 GitHub 直接安裝，官方備選命令爲：

dsh plugin --profile web add github:kanneiren/dsh-network-settings

此方式需在安裝現場執行 prepare 構建腳本。若報 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED，按報錯提示將完整 allowBuilds 鍵寫入 %UserProfile%\.dsh\profiles\<profile>\pnpm-workspace.yaml 後重試。npm 倉庫安裝無此步驟。

安裝前建議瀏覽源碼倉庫與 MIT 許可證，確認符合你的安全與合規要求。

典型用法¶

打開插件頁面時，默認只顯示緩存摘要，不主動執行探測。常用操作如下：

打開頁面         → 只顯示緩存摘要，不執行探測
[單次檢測]       → 採集 + 當前目標探測 + DSH 鏈路圖
[穩定性檢測]     → TCP/HTTP 重複採樣
[複製網絡報告]   → 生成 Agent 可用的 Markdown 報告

遇到複雜問題時，可將複製的網絡報告交給 Agent 或對照倉庫文檔進一步排查：

適用場景與注意¶

適合誰：

• 在 Windows 或 WSL 上使用 DSH Web profile，需要確認 Agent 實際出站路徑的開發者。
• 懷疑係統代理、WSL 網絡模式或 DNS 緩存導致 DeepSeek 訪問異常，希望有分層探測與可回滾修復的場景。
• 需要把網絡狀態整理成結構化 Markdown，便於與 Agent 協作排查的情況。

使用時注意：

• 插件以當前 DSH 進程權限運行；修復類操作會改動本機網絡相關配置，執行前務必閱讀預覽與風險提示。
• macOS 支持已在 CI 驗證，真機驗收尚待完善，生產環境使用前建議自行驗證。
• DSH 生態遵循「一切皆插件」理念；SkillHub 爲社區獨立目錄，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-network-settings 把 DSH 場景下常見的代理、WSL 與虛擬網卡問題收斂到同一設置頁：先看鏈路，再分層探測，必要時按快照流程做低風險修復，並把結果導出給 Agent。若你正在爲 DSH 聯網不穩定發愁，可以從目錄頁或 GitHub 安裝試用。

• 目錄頁：https://www.skillhub.cn/plugins/kanneiren/dsh-network-settings
• GitHub：https://github.com/kanneiren/dsh-network-settings