在 WSL 環境中進行 Windows 應用開發或系統調試時,日誌通常存儲在 Windows 事件日誌中。以往要查看這些日誌,往往需要配置 Windows 的權限或通過特定的跨平臺工具調用。DeepSeek Harness 的插件化設計旨在解決這類具體問題。下面介紹 dsh-wsl-eventlog 插件,它允許 DeepSeek Harness 直接在 WSL 內部讀取最近的 Windows 事件日誌條目。
插件定位¶
dsh-wsl-eventlog 是一個 DeepSeek Harness 插件,由用戶 173787247 維護。它屬於 dsh-wsl-kit 套件的一部分。該插件解決的核心問題是:當智能體或進程運行在 WSL 環境中時,如何直接查詢 Windows 系統日誌,並支持按日誌類型(如 Application、System)和嚴重級別進行過濾。
安裝與啓用¶
安裝命令如下,將插件添加到當前配置中:
dsh plugin --profile web add github:173787247/dsh-wsl-eventlog
安裝完成後,插件會隨 DSH 啓動並加載。
核心功能¶
插件主要提供以下能力:
- 日誌讀取:根據指定的日誌名稱和最小級別讀取最近的日誌條目。
- 級別映射:
- 1: Critical(關鍵)
- 2: Error(錯誤)
- 3: Warning(警告)
- 4: Information(信息)
- 消息截斷:返回的日誌消息內容會被截斷至 300 個字符。
典型用法¶
調用插件命令時,可以通過參數控制讀取範圍。
- 默認讀取:
讀取系統日誌,包含錯誤和關鍵級別,共 20 條記錄。
win_eventlog
- 指定參數讀取:
讀取應用程序日誌,包含警告及以上級別,共 50 條記錄。
win_eventlog log=Application level=3 count=50
適用場景與注意¶
- 運行環境:必須在安裝了 WSL 的 Windows 系統上運行,且 DeepSeek Harness 進程必須位於 WSL 內部。
- 權限與安全:插件以當前 DSH 進程的權限執行,需確保用戶對目標日誌源有讀取權限。
- 許可證:插件許可證爲 MIT,使用時請遵守相關條款。在安裝前,建議查看源碼以確保符合你的安全策略。
結語¶
通過這個插件,在 WSL 環境中排查 Windows 系統問題變得更加直接。更多詳情可查閱 社區目錄 或 GitHub 倉庫。