DeepSeek Harness (DSH) 生態強調通過插件擴展能力。在開發與調試過程中，智能體需要查看日誌來定位問題，但直接讀取全部日誌會超出上下文窗口限制。dsh-loglens 旨在解決這一問題，它爲 Harness 提供了一套有界、光標感知的日誌檢查工具，並在 Web 界面中渲染緊湊的日誌快照。
插件定位¶
dsh-loglens 是一個 DeepSeek Harness 插件，由 Monicaxixi 維護。它不充當通用的日誌查看器，而是爲模型提供一組工具，用於讀取、解析和重置日誌光標。
核心能力¶
該插件通過四個面向模型的原生工具實現核心功能：
- 有界窗口與源管理：支持文件源和配置的 Shell 命令。文件讀取基於字節偏移和 inode 檢查；命令輸出在內存中限制大小。模型接收配置好的源 ID，而非任意命令或路徑。
- 數據處理：支持解析有界窗口、歸一化日誌嚴重性、分組重複條目、生成問題指紋。
- 狀態管理：使用光標跟蹤增量讀取進度，狀態以原子方式存儲在
.dsh/.loglens/state.json中。 - 工具列表：
logs_list：列出配置源和當前光標狀態。logs_read：讀取有界窗口，返回歸一化、指紋化的緊湊快照。logs_raw：根據事件 ID 或指紋查找，獲取緩存的原始事件。logs_reset_cursor：重置特定源的光標，重新開始增量讀取。
安裝與啓用¶
安裝插件到指定的 Harness 配置文件：
dsh plugin --profile headless add github:Monicaxixi/dsh-loglens
dsh plugin --profile web add github:Monicaxixi/dsh-loglens
安裝完成後需要重啓對應的配置文件。在被檢查的項目根目錄添加 .dsh/logs.yml 文件。插件不會在配置源之前讀取日誌。
使用注意¶
- 數據限制：輸出、緩存和返回的事件均爲有界，防止上下文溢出。
- 依賴：主機包沒有額外的運行時依賴；瀏覽器包聲明 React 爲 peer dependency。
- 安全性：命令以 Harness 進程權限運行。不要在命令行參數或
.dsh/logs.yml中放入密鑰。如果配置文件包含私有路徑或憑證，不要提交到版本控制。 - 指紋設置：指紋識別功能會替換時間戳、UUID 等易變字段，在敏感日誌上啓用前請審查相關設置。
