DeepSeek Harness 插件：dsh-wsl-registry（從 WSL 只讀訪問 Windows 註冊表）

前言¶

DeepSeek Harness (DSH) 採用插件化架構，通過擴展功能來適應不同的運行環境。當 DSH 進程運行在 WSL（Windows Subsystem for Linux）環境中時，它往往需要讀取 Windows 系統底層的配置信息。直接暴露註冊表訪問接口存在安全風險，且在 WSL 環境下直接操作 Windows 註冊表較爲繁瑣。dsh-wsl-registry 插件解決了這個問題，它作爲中間層，將 Windows 註冊表訪問限制爲只讀，並只允許訪問指定的安全區域。

插件定位¶

dsh-wsl-registry 是一個 DeepSeek Harness 插件。其核心功能是在 WSL 環境中提供對 Windows 註冊表的只讀訪問權限，但通過嚴格的允許列表機制，僅允許讀取特定前綴的鍵值。

核心功能¶

該插件主要包含以下安全與訪問控制特性：

• 只讀訪問：插件僅提供讀取操作，不允許修改註冊表數據。
• 訪問白名單：訪問被嚴格限制在以下鍵前綴內：
  • HKLM:\SOFTWARE
  • HKLM:\SYSTEM\CurrentControlSet\Services
  • HKCU:\SOFTWARE
  • HKLM:\HARDWARE
• 安全攔截：攔截位於 Run 或 RunOnce 段下的鍵。無論路徑如何嵌套，只要路徑段包含 Run 或 RunOnce 即被拒絕。
• 長度限制：讀取到的註冊表值會被截斷，最大長度限制爲 400 個字符。

安裝與啓用¶

在支持 DSH 的環境中，使用以下命令將插件安裝到當前配置文件中：

dsh plugin --profile web add github:173787247/dsh-wsl-registry

安裝後，插件即可在 DSH 的 Web UI 或腳本中使用。

典型用法¶

安裝完成後，可以在 DSH 的命令行或配置中使用 win_reg 命令。以下是幾個示例：

讀取整個鍵下的信息：

win_reg path='HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion'

讀取特定鍵下的特定值：

win_reg path='HKLM:\SOFTWARE\...' name=ProductName

適用場景與注意¶

• 運行環境：該插件僅適用於在 Windows 系統上安裝並運行的 WSL 環境中。DSH 進程必須運行在 WSL 內部。
• 依賴版本：確保 DeepSeek Harness 版本不低於 0.1.2。
• 插件版本：當前使用的是插件 0.1.0 版本。
• 權限與安全：插件以 DSH 當前的進程權限運行。在使用前，建議檢查源碼以確保符合安全規範。

結語¶

dsh-wsl-registry 插件爲在 WSL 中運行的 DSH 提供了安全、受控的 Windows 註冊表訪問能力。通過限制只讀權限和訪問範圍，它可以在不增加系統風險的前提下，幫助開發者獲取必要的系統配置信息。

• 插件目錄頁
• GitHub 倉庫